Cruxy Code 是一个 CLI：cruxy 打开一次交互式会话，cruxy run 完成一项任务。它可以在任何终端中运行，包括你编辑器里的那个。
即将推出VS Code 和 JetBrains 插件，以及一个独立编辑器。
产品Cruxy Code测试版
在终端中做软件工程。
Cruxy Code 读取你的代码库，编辑文件，运行你的测试和命令，并打开拉取请求。默认情况下，它在每次编辑和命令前先询问。以 CLI 形式上线，所有套餐均可用。
~/web · Cruxy Code
$cruxy run "fix the failing tests in the auth module"
cruxy › fix the failing tests in the auth module
! cruxy wants to run tests: pnpm test (destructive)
$ pnpm test
in /home/dev/web
[y] once · [a] always allow test runs of exactly `pnpm test` this session · [t] reject & instruct · [n] no: a
✗ tests failed · 2 of 42 failed · 3.1s · pnpm test
✗ signs a session token src/auth/session.test.ts:18
expected "ok"
received undefined
✗ rejects an expired token src/auth/session.test.ts:41
why (inferred) TOKEN_SECRET is not set in the test environment
✓ read_file 8ms src/test/setup.ts
? cruxy wants to edit: src/test/setup.ts (mutate)
Update(src/test/setup.ts) +1
1 process.env.NODE_ENV = "test";
2 + process.env.TOKEN_SECRET = "test-secret";
[y] once · [a] always allow changes under test/ this session · [t] reject & instruct · [n] no: y
✓ edit_file 11ms src/test/setup.ts
✓ tests passed · 42 tests · 2.9s · pnpm test
The test setup now sets TOKEN_SECRET. All 42 tests pass.
usage · kavi ↑ 12.5k ↓ 530 0.0141 USD · total ↑ 12.5k ↓ 530 0.0141 USD
$▌
界面预览。CLI 输出是真实的；模型回复仅为示意。
安装
三条命令。 Node.js 20 或更高版本，以及一个 Cruxy 账户。
- 在 cruxy.ai 创建账户。任何套餐都行，Free 也可以。
- 运行 cruxy login，并在浏览器中批准登录。之后的用量计入你套餐的用量限额。
- 或者把应用中的 API 密钥设为 CRUXY_API_KEY；密钥上的用量按 token 计量。没有凭据时的第一次交互式运行会引导你完成设置。
- 想不安装就试试，运行 npx @cruxy/cli run 并加上你的任务。
终端
$npm i -g @cruxy/cli$cruxy login$cruxy run "explain this codebase"今天
Cruxy Code 今天能做什么。 以及即将推出什么，直白地说。
它会列出、读取、glob 和 grep 你的文件，用在你机器上建立的索引搜索代码库，并在每次会话加载你项目的 CRUXY.md 或 AGENTS.md。
默认的 Manual 在每次编辑和命令前先询问。Plan 先提出一份计划供你批准。Auto-approve 和 full-auto 让可逆操作直接运行，但在不可逆操作前仍会询问。用 /mode 或 Shift+Tab 切换。
即将推出带逐行审查的 pair 模式。
cruxy pr 在新分支上写一个约定式提交，推送它并打开一个 GitHub 拉取请求，全部只需一次批准，并且绝不向 main 或 master 提交。
即将推出触发你的部署流水线。
它通过文件工具和你的 shell 工作，所以不绑定任何语言或框架。可选的语言服务器覆盖 TypeScript、JavaScript、Python、Go 和 Rust。
它运行你的测试命令，读取失败并持续修复，连续四次运行失败后停止。失败输出会针对 Vitest 和 Jest 进行解析。
即将推出生成测试，以及在拉取请求前审查 diff。
它跨会话记住事实：项目记忆在 .cruxy/memory 中，用 cruxy memory trust 信任后即可调用；个人记忆在 ~/.cruxy/memory 中。
一个补丁可以在整个仓库中原子地创建、更新和删除文件，只需一次批准。
即将推出更改后自动运行你的 linter 和格式化工具。
每次编辑都会在你批准前显示它的 diff。cruxy rollback 把目录树恢复到任意一轮之前，/undo-last 撤销最近一轮。
即将推出逐个代码块（hunk）批准。
每次运行结束时都会显示它的 token 用量和费用。/usage、cruxy usage 和 cruxy limits 显示更多。
在终端中
规划它，批准它，撤销它。
先规划
选择它询问的程度：/mode plan 会在任何操作运行之前先提出一份计划。
~/web
界面预览。CLI 输出是真实的；模型回复仅为示意。
批准每处更改
你始终掌控：Cruxy Code 提议，你来批准。
~/web
界面预览。CLI 输出是真实的；模型回复仅为示意。
撤销一次运行
改变主意了？/undo-last 把文件恢复到上一次运行之前。
~/web
界面预览。CLI 输出是真实的；模型回复仅为示意。
工作原理
规划。编写。交付。
- 01
描述要做的工作
运行 cruxy 开始一次会话，或用 cruxy run 加一项任务：一个功能、一次重构、一个 bug 修复。它读取代码库，并理出要做的更改。
- 02
边做边批准
默认情况下，它把每次编辑显示为 diff，每条命令也在运行前先显示，然后等你。在 plan 模式下你先批准计划；auto 模式让可逆操作直接运行。
- 03
打开拉取请求
cruxy pr 在新分支上提交、推送，并在一次批准后打开 GitHub 拉取请求。即将推出：在你授权该步骤后进行部署。
模型
三种规格，按请求路由。 想固定时就固定一个。
默认情况下 Cruxy Code 发送 auto，Cruxy API 按每个请求的大小和复杂度挑选一个规格。用 /model 为当前会话固定一个模型，在 .cruxy/config.json 中为一个项目固定，或通过 CRUXY_MODEL 环境变量固定。
比较模型Auto默认按请求的大小挑选模型：简短的提示交给 Mira，冗长或大量使用工具的交给 Kavi，其余交给 Vaani。视情况而定
Fast · Mira快速回答和日常工作，延迟目标为 400ms。64KBalanced · Vaani在真实工作负载下依然可靠的更深推理。默认选项。128KDeep · Kavi长文档、困难的推理和大量使用工具的工作。256K适合谁
独自或团队。 业余项目或生产环境。
独立开发者和创始人
业余项目、周末的构建和枯燥的重构，有一个默认在改动任何东西之前先询问的智能体。
公司里的工程师
作为一个补丁的多文件重构、测试修复和迁移，在任何文件改动之前 diff 就在你眼前。
工程团队
通过提交到仓库的 CRUXY.md 共享约定，让每次会话都从同样的规则开始，并为任何不熟悉的仓库提供导览。
每个套餐
Free、Core、Advanced、Pro 和 Enterprise。Cruxy Code 不受套餐限制。
cruxy login
从 CLI 登录后，用量计入你套餐的用量限额。
API 密钥
来自 cruxy.ai 的密钥按 token 计量，采用 API 费率。
常见问题
值得了解。
它用只读工具（list、read、glob、grep，以及在你机器上建立的搜索索引）读取它需要的文件，这些读取不需要批准。编辑和命令需要。没有任何东西被整体上传：它读取的内容作为对话的一部分发送到 Cruxy API。