CLI

Downcity provides two CLI binaries:

downcity (alias city) — manages local agents, global config, and City state.
downfed — manages Federation deployment, City entities, and service resources.

Both share the same global flags (--verbose, --quiet, --lang) and help system.

Local storage

downcity stores local City state, encrypted credentials, environment variables, channel accounts, and registered Agent project paths in ~/.downcity/downcity.db.
downfed stores Federation admin profiles, admin keys, Cloudflare account selection, and CLI preferences in ~/.downcity/federation.db.
Agent runtime status is resolved from each project daemon's local meta/pid files under <project>/.downcity/.debug/.

downcity is the local management CLI. It handles agent lifecycle, plugins, environment variables, tokens, and Federation connections.

Command	Description
`downcity init`	Initialize City global state (`~/.downcity/downcity.db`)
`downcity update`	Update the downcity CLI to the latest version
`downcity env`	Manage platform environment variables
`downcity config`	Manage City configuration
`downcity token`	Manage API tokens
`downcity federation`	Manage Federation connections

Command	Description
`downcity agent create [path]`	Create and initialize an Agent project
`downcity agent list`	List registered Agent projects
`downcity agent start [path]`	Start an Agent (background or foreground)
`downcity agent stop [path]`	Stop the background Agent daemon
`downcity agent restart [path]`	Restart the background Agent daemon
`downcity agent status [path]`	Show background Agent daemon status
`downcity agent doctor [path]`	Diagnose daemon state files
`downcity agent chat`	Chat with an Agent in the terminal
`downcity agent history`	Manage Agent conversation history

Command	Description
`downcity plugins`	Manage plugins (interactive or list actions)
`downcity plugins schedule`	Manage plugin scheduling

Command	Description
`downcity chat`	Manage chat plugin resources (interactive)
`downcity chat auth`	Manage chat authorization

downfed is the Federation management CLI. It handles deployment, project scaffolding, and admin operations.

Command	Description
`downfed`	Open the interactive Federation management interface
`downfed manage`	Open the admin management interface
`downfed server manage`	Enter the admin workspace for a Federation
`downfed server add`	Add a deployed Federation URL
`downfed query <method> <path>`	Query the active Federation HTTP API
`downfed create [dir]`	Scaffold a new Federation project
`downfed deploy [source]`	Deploy a Federation project

Continue with: