CLI

Downcity 安装包提供两个独立工具：

city（别名 downcity）是本机 City 容器，管理 Agent、Plugin、环境变量和 Federation 连接。
fed（别名 downfed）是 Federation Server Manager；TUI 管理已注册 Server，fed web 启动本地 Web 控制面，项目命令读取当前目录的 federation.json。

City 数据模型

Agent 是全局实体，agent_id 是唯一身份，Workspace 路径只是可变绑定。Agent、Plugin Binding 与 Token 保存在 ~/.downcity/downcity.db；Global Env 保存在 ~/.downcity/.env，Workspace Env 保存在项目 .env；daemon 文件位于 ~/.downcity/runtimes/<agent_id>/。

Plugin 制品全局安装到 ~/.downcity/plugins/。Plugin 配置不属于 Agent SDK 的运行时 Plugin 对象，而是按 agent_id + plugin_name 保存在 Agent Plugin Binding 中。

City 命令

命令	说明
`city agent`	管理全局 Agent
`city plugin`	管理 Plugin 制品、Binding、配置与 Action
`city env`	管理 City 注入的环境变量
`city federation`	管理 Federation 连接

city init、city update 和 city config 不再提供。全局更新使用 npm i -g downcity@latest。

所有操作单个 Agent 的命令都以 agent_id 为目标。TTY 中省略 ID 时打开全局 Agent 选择器；非交互环境会返回 Agent ID is required，不会根据当前目录推断。

平台支持

CLI 架构天然跨平台。macOS 与 Linux 是稳定支持目标；Windows Adapter 当前为 preview。

继续阅读：CLI 命令。