CLI Commands

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.

• CLI: fed and city

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.
• If --lang is not passed, the CLI first uses the last language selected in the interactive menu, then falls back to DC_CLI_LANG, LC_ALL, LC_MESSAGES, and LANG.
• 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