Skip to main content

CLI Overview


This section details Neosync CLI and all of its available commands.

➜  ~ neosync
Terminal UI that interfaces with the Neosync system.

neosync [command]

Available Commands:
completion Generate the autocompletion script for the specified shell
help Help about any command
jobs Parent command for jobs
login Login to Neosync
sync One off sync job to local resource
version Print the client version information
whoami Find out who you are

--api-key string Neosync API Key. Takes precedence over $NEOSYNC_API_KEY
--config string config file (default is $HOME/.neosync-cli.yaml)
-h, --help help for neosync
-v, --version version for neosync

Use "neosync [command] --help" for more information about a command.

Environment Variables

There are a few global environment variables that are available on every request.


Neosync API Key. Used if logging in via a system api key.


The url of the Neosync API to direct the request to.

Full list

For a full list of environment variables and flags available, see the specific command you are running. Otherwise, there is a top-level list of all environment variables spread across all commands available here.


CLI metadata is appended to the outgoing gRPC context to provide tracking and metadata to the API. This lets the API know which version the CLI is using when it invokes commands to better track CLI usage over time.

The following metadata is added to all CLI context:

  • Git Version
  • Git Commit
  • OS Platform