Up and running in about a minute大约一分钟就能跑起来
Dollar is a Windows desktop pet that watches your AI coding agents while they work. It's local-first: nothing leaves your machine except the OpenAI calls you explicitly choose to make. This page covers how to install it, which agents it supports, the controls you'll use every day, and exactly where everything lives on disk.Dollar 是一只 Windows 桌宠,在你的 AI 编码助手干活时全程盯着。它本地优先:除了你主动发起的 OpenAI 调用,没有任何数据离开你的电脑。本页讲清楚怎么安装、支持哪些 Agent、每天会用到的快捷操作,以及所有文件到底存在硬盘的哪里。
Three steps三步搞定
No config files to hand-edit. Get it, let it wire itself in, then start coding as usual.无需手动编辑配置文件。装好、让它自己接入,然后照常写代码就行。
Get it on Steam在 Steam 上获取
A one-time purchase on Steam — no subscription, no credits to top up. Install and launch; the pet appears on your desktop. Windows-only for now.在 Steam 上一次性买断 —— 没有订阅,也不用充值额度。安装后启动,桌宠就出现在桌面上。目前仅支持 Windows。
It wires itself in它自动接入
On first run it installs a hook into ~/.claude/settings.json and your ~/.codex/ config, so it can see commands before they run. The local bridge listens on 127.0.0.1:3721.首次运行时,它会把一个 hook 写入 ~/.claude/settings.json 和你的 ~/.codex/ 配置,这样它能在命令执行前先看到。本地桥接监听 127.0.0.1:3721。
Start Claude Code or Codex启动 Claude Code 或 Codex
Open a terminal and run your agent as you normally would. The pet reacts in real time — sniffing commands, flagging risk tiers, and tallying estimated cost as the work happens.打开终端,照常运行你的 Agent。桌宠会实时响应 —— 嗅探命令、标注风险等级,并在干活的同时累计预估成本。
What Dollar watchesDollar 盯着谁
Two agents today, both wired in automatically. More may be added later.目前支持两个 Agent,都会自动接入。以后可能会加入更多。
Claude CodeClaude Code
Hook installed into ~/.claude/settings.json. Commands are screened by the firewall; cost is estimated per model from local session logs.hook 写入 ~/.claude/settings.json。命令交由防火墙审查;成本按模型从本地会话日志中预估。
CodexCodex
Hook installed into ~/.codex/. Same firewall screening; cost is estimated. (OpenAI usage, where measured, is read exactly; agent pricing is editable per model.)hook 写入 ~/.codex/。同样的防火墙审查;成本为预估值。(OpenAI 用量在可测量处按实际读取;各模型定价可自行编辑。)
The controls you'll use daily每天都会用到的操作
Approve or reject from anywhere, pick how cautious the pet should be, and teach it your own rules.在任何窗口里放行或拦截,设定桌宠的谨慎程度,并教会它你自己的规则。
Global approve / reject全局放行 / 拦截
When a command waits for confirmation, press F8 to approve or F9 to reject — from any window, without alt-tabbing back. If you don't respond, the request times out after about 60 seconds rather than running on its own.当某条命令等待确认时,按 F8 放行、F9 拦截 —— 在任何窗口里都行,不用切回去。如果你不响应,请求会在约 60 秒后超时,而不会自行执行。
Three policy modes三种策略模式
Careful holds more for confirmation, Standard is the balanced default, and Full-auto lets routine work flow while still holding the riskiest commands. Switch any time.Careful 会更多地等你确认,Standard 是均衡的默认档,Full-auto 让日常操作顺畅通过、同时仍对最危险的命令踩刹车。随时切换。
Your own keyword rules自定义关键词规则
Add custom danger keywords to always hold a command, or safe keywords to let your trusted ones flow. Your project, your rules.添加自定义危险关键词以始终拦下某类命令,或添加安全关键词让你信任的命令顺畅通过。你的项目,你定规则。
Risk preview风险预览
Paste any command to see which tier it lands in before you ever run it. A quick guide to how the firewall reasons:粘贴任意命令,在真正运行之前就能看到它落在哪个等级。下面是防火墙判断逻辑的速览:
Read-only and routine: ls, cat, git status, npm test / build with no redirection.只读与日常:ls、cat、git status、不含重定向的 npm test / build。
Changes state but usually fine: installs and commits like npm i or git commit.会改动状态但通常没问题:安装与提交,如 npm i 或 git commit。
Sensitive or destructive: touching .env / .ssh / id_rsa, git push --force, reset --hard, docker push, npm publish, curl | sh, sudo, or a DB migration.敏感或破坏性:触碰 .env / .ssh / id_rsa,git push --force、reset --hard、docker push、npm publish、curl | sh、sudo,或数据库迁移。
All local, on your machine全在本地,就在你的电脑上
No cloud account, no remote database. Here's exactly what sits where — so you can inspect, back up, or delete any of it yourself.没有云账户,也没有远程数据库。下面是每样东西的确切位置 —— 你可以自行查看、备份或删除。
Snapshots & checkpoints快照与检查点
Stored in ~/.codex/pets as plain file copies plus a git stash checkpoint. They power per-task rollback via the Task Time Machine — a safety net, not a replacement for Git.存放在 ~/.codex/pets,是普通的文件副本外加一个 git stash 检查点。它们为「任务时光机」的按任务回滚提供支撑 —— 是一张安全网,而不是 Git 的替代品。
Cost data成本数据
Read from your local agent logs, read-only. OpenAI usage is measured exactly where available; Claude and Codex spend is estimated per model. Export to CSV / PDF / JSON any time.从你本地的 Agent 日志中只读读取。OpenAI 用量在可得处按实际计量;Claude 与 Codex 的花费按模型预估。随时可导出为 CSV / PDF / JSON。
The local bridge本地桥接
A small service on 127.0.0.1:3721 — loopback only, never exposed to the network. It's how the hook talks to the pet, all on your own machine.一个运行在 127.0.0.1:3721 的小服务 —— 仅本地回环,不对外暴露到网络。hook 正是通过它与桌宠通信,全程都在你自己的电脑上。