用途：fcode CLI 用于本地开发、测试 Factorial Code 流程，并与 Factorial Code Cloud 同步；平台模型参见 fcode-core-concepts。
安装与首次克隆：pnpm install -g @factorialco/fcode-cli，然后 fcode clone <workspace-slug>，会在 <workspace-slug>/ 目录下拉云端工作区；--skipSkillsSetup 可跳过安装 agent skills。可复制 App 的 Development 标签中“How to build locally”给出的 clone 命令；slug 是编码令牌而非 App UUID。fcode team:clone 可一次拉取开发团队拥有的全部 App。
常用流程：在已克隆工作区中，fcode pull 先同步最新；编辑本地文件；仅当新建流程、模块、依赖或变量时运行 fcode add；改了 dependencies/package.json 或 requirements.txt 时运行 fcode dependencies:install；fcode run <process-slug> 本地执行测试；fcode push 部署到云端。
主要命令：fcode run <process-slug> --parameters <filepath | json> 本地执行流程，使用 variables.env / variables.local.env，显示日志、结果和错误，--locale 按本地 i18n 文件解析 fcode.i18n。fcode http 启动本地 HTTP 服务器（--port 默认 3000），复刻云端 webhook 环境并提供表单 schema，--auth-user / --auth-password 用 Basic Auth 保护服务器。fcode status 报告本地与云端差异，另有 processes:status 等按资源变体；--showInherited 显示继承资源。fcode diff [<slug>] 显示 git 风格统一 diff，本地与云端不同时退出码为 1。fcode remote:add <workspace-slug> 将已克隆目录重指向另一云端工作区。
团队与发布：fcode team:clone / team:pull / team:status 跨 App 操作；没有 team:push，代码在单个工作区内推送，App 的 README 和列表用 fcode app:push 上传。fcode settings:pull / push / status 单独同步 settings.json；settings:versions:* 与 settings:aliases:* 提供命令式版本发布与别名切换。
限制与注意事项：新建资源后必须先 fcode add，否则 run 会报 "Local process not found"；fcode push 只更新当前未版本化代码，固定到 stable 别名的消费者仍运行已发布版本。--force 会覆盖另一端，本地与云端分叉时 push/pull 会失败，须先用 fcode diff 确认并获用户明确同意。不要编辑继承资源（variables.inherited.env、i18n/<locale>.inherited.yaml 及继承的流程/模块），它们由父工作区所有、pull 时重新生成、永不推送。敏感变量值不会打印，显示为 <sensitive value hidden>。settings.json 中编辑 versions / aliases 会在 push 时触发发布或删除，除非明确要求否则不要改动。其余细节（如名称、metadata.json 完整字段等）资料未完整提供。