Amics CLI
A standalone, provider-neutral executable for bounded remote GPU commands, durable runs, and compute.
The amics CLI is the primary interface for people, coding agents, and CI. It
ships as one executable and uses the credential saved by amics login or the
AMICS_API_KEY environment variable.
Install the current stable release with the official installer:
curl -fsSL https://downloads.amics.ai/cli/install.sh | sh
amics login
amics --helpThe installer selects the executable for the current OS and architecture,
verifies its release checksum, and replaces the destination atomically. macOS
releases are Developer ID signed and notarized. Use --version VERSION to pin
a release or --install-dir DIRECTORY to choose another destination.
Command map
| Goal | Command |
|---|---|
| Sign in | amics login |
| Validate the active credential | amics auth status |
| Revoke the active credential | amics auth logout |
| Diagnose local setup | amics doctor |
| Install shell completion | amics completion SHELL |
| Update the CLI | amics update |
| Install or update the agent skill | amics skill install |
| Inspect live GPU options | amics gpu options |
| Run a project command | amics run [OPTIONS] -- COMMAND |
| Start a bounded HTTP service | amics serve [OPTIONS] -- COMMAND |
| Open a service in a browser | amics services open SERVICE_ID |
| Inspect or stop a service | amics services get SERVICE_ID, amics services stop SERVICE_ID |
| List recent runs | amics runs list |
| Inspect a run | amics runs get RUN_ID |
| Read or follow logs | amics runs logs RUN_ID |
| Cancel a run | amics runs cancel RUN_ID |
| List reusable compute | amics compute list |
| Stop a compute resource | amics compute stop COMPUTE_ID |
| Upload a file to running compute | amics compute upload COMPUTE_ID LOCAL_FILE --to PATH |
Authentication order
The CLI uses the first available credential:
--api-key KEYAMICS_API_KEY- The credential saved by
amics login
Prefer AMICS_API_KEY or the saved credential. Command-line values can leak
through process listings, shell history, and CI logs; use --api-key only when
those arguments are private.
Global options may appear before the command or among its options. Arguments
after amics run -- always remain literal.
Use --control-url only for an explicitly configured Amics environment. Normal
clients use https://api.amics.ai.
Check or remove the CLI credential
amics auth status
amics auth logoutLogout revokes the active CLI key before deleting its saved copy. If the
control plane is unreachable, amics auth logout --local-only removes only the
local file; the remote key remains valid until separately revoked.
Run amics doctor for one setup report covering the executable, credential,
control plane, agent skill, and PATH.
Install and upgrade
Run amics update to download, verify, and atomically install the current
stable release. Rerun the installer with --version VERSION when a specific
release is required.
Supported release targets include macOS arm64/x64 and Linux arm64/x64 builds for standard glibc and x64 musl environments. Every versioned archive includes a checksum manifest; verify it before replacing the executable.