Skip to main content

CLI

The CLI is the primary interface for working with Acolyte.

Commands

  • acolyte: start interactive chat
  • acolyte init [provider]: initialize provider API key
  • acolyte login: authenticate with the cloud
  • acolyte logout: remove cloud credentials
  • 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.

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