来自 · TORCHSTELLAR

从第一个项目
到整个工作区。
用同一套命令。

创建多项目工作区，统一运行开发、构建和测试。通过 Dashboard 管理项目、变量与开发服务，让人和 AI 使用同一套项目约定。

开始使用查看 GitHub

$curl -fsSL https://1cli.dev/install.sh | bash

开始方式

三种开始方式。

直接运行 one create 创建工作区，或先用 one templates 查看可用模板；也可以向 AI 描述目标，由它通过 One CLI 完成创建。

方式一

直接运行 one create

先创建空工作区。输入 one create，按提示填写目录；之后用 one add 添加应用、服务或共享库。

创建工作区

$ one create

不需要先记参数

按提示填写目标目录

创建后再用 one add 继续添加项目

查看 one create

方式二

运行 one templates

在终端查看当前版本内置的应用、服务和共享库模板，再通过 one add 添加所需项目。

查看可用模板

$ one templates

终端查看模板清单

了解模板类型与用途

通过 one add 添加所需项目

查看模板命令

方式三

交给 AI 执行

把目标和 One CLI 命令交给 Codex、Claude Code、Cursor 等 AI 编程工具；已有工作区先阅读 README 和 one.manifest.toml。

给 agent 的一句话

请使用 One CLI 创建 media-stack 工作区，添加一个 Expo 移动应用，再通过 one dev 启动它。

直接描述要做什么

AI 使用 One CLI 创建工作区或追加模板

通过 one run 准备依赖并运行任务

查看 AI 指南

常用命令

从创建项目，到日常开发。

创建和添加项目时按提示选择，日常开发用 one run 执行任务。脚本和 AI 可以通过明确参数与 JSON 输出完成操作。

one create one add one run one env one serve one help

one create

一条命令，
先把项目搭起来。

one create 可以直接运行并填写目标目录，也可以指定目录名，创建空工作区后再用 one add 添加项目。

交互创建直接输入 one create，会引导你填写目标目录。

添加项目运行 one templates 查看模板，再通过 one add 添加所需项目。

自动化模式CI 或 AI 使用 --yes 和 -o json，方便确认输出和错误。

查看 one create 查看模板指南one-cli/create

$one create

>打开创建向导

·填写目标目录

·生成工作区目录、AGENTS.md 和 mise 任务配置

one add

项目已经有了，
也能继续加。

one add 在已有 One 工作区里添加项目。你可以直接输入 one add 进入交互式选择，也可以在脚本里写明模板名和项目名。

交互添加直接输入 one add，会让你选择模板和项目名。

自动化模式脚本或 AI 可使用 one add nextjs-app --name web --yes。

同步默认值按模板生成项目代码，并登记本地开发命令。

查看 one addone-cli/add

$one add

>确认当前目录属于 One 项目

·打开模板和项目名选择器

·写入新目录并登记到项目清单

one run

不同项目，
同一套运行方式。

one run 列出工作区任务，通过 mise 执行开发、构建和测试。用 -p 选择项目，One 会按需准备工具和依赖。

发现任务运行 one run 查看可用任务，再选择要执行的操作。

日常开发one dev -p web 启动项目；one build -p web 构建项目。

查看日志多任务支持树形日志界面，可搜索、滚动和切换任务。

查看任务管理one-cli/run

$one dev -p web

>解析项目任务与依赖关系

·准备工具、依赖和已绑定的项目变量

·启动开发服务并显示原始日志

one env

变量集中管理，
运行时按需注入。

通过 one login 在浏览器登录 Infisical，再用 one env 管理项目变量。新工作区可先直接运行，需要托管变量时再绑定。

浏览器登录登录会话保存在系统钥匙串，使用 one whoami 查看状态。

项目变量首次保存变量时初始化工作区绑定，按环境与项目目录组织变量。

共享凭据在 Dashboard 配置共享凭据，通过 one exec --global 显式注入。

查看环境变量one-cli/env

$one env set API_URL -p web

>先通过 one login 登录

·在终端隐藏输入变量值

·运行项目时从 Infisical 拉取并注入变量

one serve

项目和开发服务，
在浏览器里管理。

one serve 打开本机 Dashboard，浏览工作区、添加项目、管理环境变量和共享凭据，也能启动开发服务并查看控制台。

项目管理查看项目配置、选择模板添加项目，审阅 Manifest 修改后保存。

开发服务启动、停止或重启服务，查看原始日志与本机访问入口。

账号与变量在设置中登录 Infisical，按环境和目录管理变量。

查看 Dashboardone-cli/serve

$one serve

>在本机浏览器中打开 Dashboard

·管理工作区、项目与共享凭据

·运行开发服务并查看控制台

one help

让 AI 助手，
找到正确的命令。

使用 one help --all 查看完整命令目录，再通过子命令的 --help 获取参数说明。AI 可以结合 README 和 one.manifest.toml 里的项目事实选择操作。

完整目录列出当前版本支持的全部命令。

参数说明使用子命令的 --help 确认参数和用法。

结构化结果执行时使用 -o json，根据 error.code 处理失败。

查看命令参考one-cli/help

$one help --all

>查看当前版本支持的命令

·确认子命令参数

·结合项目说明选择操作

AGENT-READY WORKSPACE

让 agent 先读事实，再动项目。

One CLI 不是另一个聊天入口。它把 manifest、项目配置和结构化错误组织成一套工程契约，让 Codex、Claude Code、Cursor 这类 AI 编程工具能先确认项目事实，再选择命令、修改代码和处理失败。

命令帮助说明怎么操作

agent 通过 `one help --all` 和子命令的 `--help` 确认当前版本支持的命令、参数和用法，再执行工作区操作。

one help --all

Manifest 记录项目事实

`one.manifest.toml` 记录工作区身份、项目路径、工具链和 Infisical 绑定。agent 先读这份事实，再决定进入哪个子项目、调用哪个命令。

one.manifest.toml

项目说明由团队维护

one create 按当前 CLI 语言生成 AGENTS.md。之后由团队维护，添加项目不会覆盖已有内容。

AGENTS.md

错误给出下一步

命令支持 JSON 输出，错误包含 `code`、`context` 和 `remediation[]`。agent 不需要解析自由文本，可以按结构化信息选择恢复动作。

error.remediation[]

可读的错误与恢复建议

命令没跑通，不用自己猜。

创建、添加和运行项目遇到问题时，One CLI 会保留具体原因，并为常见错误提供恢复建议。人和 AI 可以根据相同的信息继续处理。

创建项目

目录不对或目标已存在，会告诉你怎么继续

添加项目

模板、名称、位置不对，会给出修复命令

运行任务

缺少配置或工具，会提示先补什么

接给 AI

同样结果可以输出 JSON，方便工具处理

>one add react-spa --name web --yes

未检测到 One CLI 项目，请在项目根目录执行。
  - 当前目录缺少 one.manifest.toml；
    请先创建工作区，或 cd 到已有工作区：
    one create <dir>

结构化错误包含错误码和上下文；提供恢复建议时，脚本和 AI 可读取 remediation 字段。

把项目放在一起，把开发跑起来。

从一个空工作区开始，按需添加项目，用相同的命令完成每天的开发。

开始使用 GitHub

从第一个项目到整个工作区。用同一套命令。