Skip to main content

Installation

The Targon CLI is a standalone Rust binary for managing workloads, volumes, SSH keys, and projects from the terminal. It is no longer shipped with the Python SDK.

Build from source

git clone https://github.com/manifold-inc/targon-sdk.git
cd targon-sdk/cli
cargo build --release

The binary is produced at target/release/targon. Add it to your PATH, or copy it somewhere convenient:

cp target/release/targon ~/.local/bin/targon

Verify the install:

targon --version
targon --help

Global options

These flags apply to every command:

FlagDescription
--profile <NAME>Configuration profile to use (default: default)
--base-url <URL>Override the API base URL for this invocation
--jsonEmit machine-readable JSON instead of formatted tables

Configuration

The CLI stores configuration under ~/.targon/:

  • config.toml — active profile and per-profile base URLs
  • credentials-<profile> — stored API key for each profile (mode 600 on Unix)

You can also set TARGON_API_KEY in the environment. When present, it takes precedence over the stored key.

See targon auth login to store credentials interactively.