Skip to main content

CLI

The Acolyte CLI provides interactive chat, one-shot runs, session and memory management, configuration, tracing, direct tools, and server control.

Commands

  • acolyte: start interactive chat
  • acolyte auth [provider]: authenticate a provider (API key or subscription); --key, --subscription, --logout
  • acolyte login: authenticate with the cloud (feature-flagged: features.cloudSync)
  • acolyte logout: remove cloud credentials (feature-flagged: features.cloudSync)
  • acolyte resume [id]: continue a previous session
  • acolyte run "<prompt>": one-shot execution
  • acolyte run --file <path> "<prompt>": one-shot with file context
  • acolyte history: list sessions
  • acolyte start|stop|restart|ps: manage server lifecycle
  • acolyte status: show server status
  • acolyte memory list|add: manage memory
  • acolyte config list|set|unset: manage configuration
  • acolyte skill <name> [prompt]: run a prompt with an active skill
  • acolyte logs: view server logs
  • acolyte tool <tool-id> [args...]: run a tool directly
  • acolyte trace list|task <id>: inspect server lifecycle traces
  • acolyte update: update to latest version

Run acolyte <command> help for detailed usage.

All list commands support --json for machine-readable output.

Local models

See Configuration for OpenAI-compatible model setup.

Provider auth

Authenticate providers with an API key or, where supported, a subscription. This is separate from acolyte login, which authenticates the cloud sync service.

acolyte auth                         # status for every provider
acolyte auth openai                  # interactive: key or subscription
acolyte auth openai --key            # store OPENAI_API_KEY
acolyte auth openai --subscription   # browser OAuth (port 1455)
acolyte auth vercel --key            # store AI_GATEWAY_API_KEY
acolyte auth openai --logout         # remove stored key and subscription for openai
acolyte auth openai --logout --key   # remove only the stored API key
acolyte auth openai --logout --subscription # remove only the subscription

See Configuration for how a subscription interacts with an API key.

Memory commands

Manage saved memory notes scoped to user or project.

acolyte memory list [all|user|project]
acolyte memory list --json
acolyte memory add --user "<text>"
acolyte memory add --project "<text>"

Config commands

Read and write runtime configuration at user or project level.

acolyte config list [--project]
acolyte config list --json
acolyte config set <key> <value>
acolyte config set --project <key> <value>
acolyte config unset <key>

See Configuration for available keys.

Logs commands

Tail and filter the daemon server log.

acolyte logs                              # tail latest lines
acolyte logs -n 100                       # tail N lines
acolyte logs --level warn                 # filter by level
acolyte logs --session <id>               # filter by session
acolyte logs --since 5m                   # lines from last N minutes
acolyte logs --level error --since 1h     # combine filters
acolyte logs --json                       # JSON-lines output

Trace commands

Inspect lifecycle execution traces stored in SQLite.

acolyte trace                    # list recent tasks
acolyte trace list               # same as above
acolyte trace task <id>          # inspect a task's lifecycle trace
acolyte trace task <id> --json   # output as JSON lines
acolyte trace --lines 100        # show last 100 tasks