Skip to main content
CLI Overview

Introduction

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

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

Usage:
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

Flags:
--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

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

NEOSYNC_API_URL

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.

Metadata

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