The Official Command Line Client

This module lives inside the main Arcane repo. To build the CLI locally:

• go install getarcane.dev/cli/v3@latest

CLI versions are tagged as cli/vX.Y.Z in the main repo. Use module tags to pin a specific release:

• go install getarcane.dev/cli/v3@cli/vX.Y.Z

The CLI stores config in ~/.config/arcanecli.yml.

Create a starter config file (all supported keys):

• arcane config init
• arcane config backup (moves current config to ~/.config/arcanecli.yml.bak)

Set the Arcane server URL:

• arcane config set server-url http://localhost:3552

• arcane auth login

• arcane config set api-key arc_xxxxxxxxxxxxx

• --output text|json for output mode (--json is an alias for --output json)
• --agent <id> to limit one command to a single agent
• --yes to auto-confirm destructive prompts
• --no-color to disable ANSI color output
• --request-timeout <duration> to override HTTP timeout per command

• arcane completion bash|zsh|fish|powershell to generate shell completions
• arcane doctor to run local CLI diagnostics

Set global and per-resource list limits in config:

pagination:
  default:
    limit: 25
  resources:
    containers:
      limit: 50
    images:
      limit: 100
    volumes:
      limit: 40
    networks:
      limit: 40

CLI precedence is:

1. --limit
2. pagination.resources.<resource>.limit
3. pagination.default.limit
4. command built-in default

You can configure limits with:

• arcane config set default-limit 25
• arcane config set pagination.resources.containers.limit 50 pagination.resources.images.limit 100

Legacy flag syntax remains supported:

• arcane config set --default-limit 25
• arcane config set --resource-limit containers=50 --resource-limit images=100