CLI Commands

CLI docs are organized by command pages and command groups.

Command docs directory

• Open the Commands section and pick a command or group directly.
• Both fixed commands and dynamically registered commands are listed there.

Primary command groups

• Fixed root commands:
  • city init
  • city start
  • city stop
  • city restart
  • city update
  • city status
• Fixed module commands:
  • city console
  • city agent
  • city agent create
  • city agent list
  • city agent chat
  • city config
  • city model
  • city env
  • city service
  • city plugin
• Dynamic action commands:
  • city chat
  • city task
  • city memory
  • city skill
  • city web
  • city asr
  • city tts

Runtime model (short)

• city start: start city runtime only
• city start --console / city start -a: start city runtime and Console together
• city console start: start Console only, after city runtime is already running
• city stop: stop Console, then stop city runtime and managed agents
• city restart: restart city runtime, restore managed agents, then restart Console
• city update: update the currently installed global Downcity CLI package
• city agent: open the interactive agent manager in a TTY
• city agent create: initialize project runtime files
• city agent list: inspect registered agents, or use --running for active ones only
• city agent start: start project agent daemon
• city agent stop: stop project agent daemon
• city agent chat: chat with an agent in interactive mode or send one-shot messages with --message
• city console: manage the Console module itself
• city service ...: inspect the static service catalog, or use advanced targeted service control
• city plugin ...: inspect the static plugin catalog, or use advanced local plugin action execution
• city chat/task/memory ...: normal agent-facing service runtime commands
• city web/skill/asr/tts ...: normal agent-facing plugin commands
• city web ...: operate the built-in web plugin
• city asr ...: operate the built-in ASR plugin
• city tts ...: operate the built-in TTS plugin
• city model: open the interactive global model manager in a TTY
• city model ...: manage model config for runtime and automation

Always up to date

Use local help for latest flags:

city --help
city <command> --help