CLI Commands

Where Downcity command-line references live

Downcity docs explain the design model, runtime boundaries, and configuration semantics.

downcity / city hosts local Agents, manages local projects, and connects this machine to a Federation. Federation creation, deployment, and infrastructure operations belong to fed / downfed. For concrete flags, use the local command help from the installed CLI; the City SDK docs cover the SDK-side CLI boundary.

Local help

For exact flags, use local command help from the installed CLI. Product docs describe the supported command groups and common workflows.

Interactive TUI

Running city or downcity without a subcommand now opens the interactive TUI by default. The city side focuses on local Agents and Federation connection state; the fed side focuses on Federation management and deployment. In both CLIs, the left sidebar carries menu hierarchy with a breadcrumb at the top, while loading states, forms, tables, JSON, messages, and selection details render in the right section until you exit the TUI.

CLI language

city and downcity support both Chinese and English.

  • Use --lang zh or --lang en to switch the current command explicitly.
  • Resource commands and help resolve DC_CLI_LANG, LC_ALL, LC_MESSAGES and LANG without opening the configuration database. Other CLI flows can use the language saved in the interactive menu.
  • In interactive mode, both city and downcity can change the default language from their menus and persist that preference locally.

Examples:

downcity --lang en --help
city --lang zh
DC_CLI_LANG=zh downcity agent --help