Skip to main content

Overview

The Re:infer Command Line Interface, re, is a unified tool that provides a consistent interface for interacting with all parts of Re:infer from a terminal.

re simplifies managing Re:infer resources, such as sources and datasets, as well as importing or exporting communications data. Additionally, re maintains multiple contexts, making it easy to switch between multiple authentication tokens for different users, service accounts or Re:infer endpoints.

The Re:infer CLI is open source and developed on GitHub.

Features

  • Create, get, update and delete operations for all the different Re:infer resources. This includes sources, datasets, comments, buckets, triggers and more.
  • Context management for multiple API tokens and Re:infer endpoints.
  • Easily upload new verbatims to a source.
  • Download verbatims from a set of sources and datasets together with the human applied annotations. Useful for backups, migrating data or for applying some transformations to the data.
  • Basic shell autocompletion for zsh and bash, colorized terminal output, progress bars and more

Installation

Binary

Statically linked binaries with no dependencies are provided for all major platforms

From Source

To build from source, you need a recent version of the Rust toolchain installed. To install using cargo

cargo install --locked reinfer-cli

Ensure you have the cargo bin directory in your path (typically ~/.cargo/bin).

Alternatively, you can always clone the repository and build it with cargo build.

Help

The Re:infer CLI ships with a lot of command documentation that is accessible with the --help or -h flag.

$ re --help
$ re <command> --help
$ re <command> <subcommand> --help

We encourgage you to use read the included documentation as it's extensive and always up to date.

$ re --help

reinfer-cli 0.11.0
re is the command line interface to reinfer clusters

USAGE:
re [FLAGS] [OPTIONS] <SUBCOMMAND>

FLAGS:
-h, --help Prints help information
-V, --version Prints version information
-v, --verbose Enable more verbose logging

OPTIONS:
-k, --accept-invalid-certificates <accept-invalid-certificates>
--config-file <config>
Path to the configuration file. Typically defaults to ~/.config/reinfer on Linux

-c, --context <context>
Specify what context to use. Overrides the current context, if any

--endpoint <endpoint>
Specify what endpoint to use. Overrides the one from the current context, if any

-o, --output <output>
Output format. One of: json, table [default: table]

--proxy <proxy>
URL for an HTTP proxy that will be used for all requests if specified

--token <token>
Specify what API token to use. Overrides the one from the current context, if any


SUBCOMMANDS:
completion Output shell completion code for the specified shell (bash or zsh)
config Manage reinfer authentication and endpoint contexts
create Create new resources
delete Delete a resource
get Display resources and export comments to the local filesystem
help Prints this message or the help of the given subcommand(s)
update Update existing resources

Troubleshooting

To troubleshoot issues with the Re:infer CLI, the following may be useful

  • Make sure the latest version of re is installed. Get the installed version by running re --version or re -V
  • The --verbose flag prints debugging messages, which may narrow down the issue.
  • Connection issues may be due to improperly configured proxy settings. See Using a Proxy to configure request proxying.
  • The Re:infer CLI configuration directory is system specific, e.g. ~/.config/reinfer on Linux or macOS and %AppData%/reinfer on Windows. It can safely be deleted and the CLI will repopulate it, but all configuration (including user sessions) will be lost.

If there is anything you feel we can do to improve it or if you encounter any bugs or unexpected behaviour, please let us know at support@reinfer.io.