Reference / CLI

CLI reference

parley is the front-end over the host and its use cases. Offline commands run in-process; serve boots the full host.

The CLI is a focused subset for setup and headless operation — the web console is the full surface. Use the CLI when there's no browser (a remote box, a deploy script) or to script setup.

From a source checkout, invoke it as dotnet run --project src/AgentParley.Cli -- <command>. A published build exposes the same commands as parley <command>. Every command accepts --home <path> to target a specific instance.

Commands

Command	What it does
`serve [--port]`	Run the host — API, web console, and agents. Ctrl+C to stop.
`init`	Create the home skeleton, config, and admin/read tokens.
`doctor`	Run health checks (config, vault, database, model connectivity).
`agent create <name> --model <m> [--desc]`	Create an agent.
`agent list`	List agents with model and status.
`agent rm <name>`	Delete an agent.
`secret set <name>`	Store a vault secret (hidden prompt).
`secret list`	List secret names (never values).
`secret rm <name>`	Remove a secret.
`plugin list`	List installed/discovered plugins and load order.
`token rotate [--read]`	Mint a new admin (or read) token.
`version`	Print the version.
`help`	Show usage, including plugin-contributed commands.

Common flows

bash

# first run
parley init
parley serve

# manage agents
parley agent create scout --model claude-sonnet --desc "Investigates"
parley agent list

# secrets & tokens
parley secret set telegram-token
parley token rotate --read

# target a second instance
PARLEY_HOME=~/parley-demo parley serve --port 8421

Plugin-contributed commands

Plugins can register their own CLI commands (via ctx.Cli). Any unrecognized command is matched against them, and they appear under plugin commands in parley help.

← Previous

Channels