Skip to content
ROBOTWORLD / CODEWAIFU

CodeWaifu

贴心的 Coding 桌面精灵

住在你桌面上的贴心 Coding 精灵:coding agent 的开始、完成、待授权,她都及时通报,该开口时开口,不该打扰时安静陪伴。她的 Pro 工作台,把你所有的 coding 终端、ssh 与本地 shell 收进同一棵树;崩溃、睡眠、系统重启之后,她再把工作从磁盘与 herdr 接回去,不必重新解释一遍。

崩溃后 agent 继续跑重启后自动接回意图账本 fsync 落盘
概念渲染:悬浮的绿色全息终端之间,她陪着你今夜还在跑的每一个任务。
概念渲染:悬浮的绿色全息终端之间,她陪着你今夜还在跑的每一个任务。
Pro 工作台:左边一棵树是全部 agent 终端,中间是选中任务的现场,右边是注意力队列;她就站在终端旁待命。
Pro 工作台:左边一棵树是全部 agent 终端,中间是选中任务的现场,右边是注意力队列;她就站在终端旁待命。

桌面上的精灵

贴心的助理,开口的那种

她懂得什么时候说话、什么时候安静:Codex 与 Claude Code 的会话事件到达时,实时变成她的声音与气泡;什么都没有发生时,她就站在你的壁纸上陪你。离线 Matcha-TTS 中英混排,口型逐帧跟着音频走;舞台可拖拽、可液态玻璃、可彻底透明。

离线 Matcha-TTS口型逐帧同步透明舞台
透明舞台:她站在你的壁纸上,状态条悬浮在脚边。
透明舞台:她站在你的壁纸上,状态条悬浮在脚边。

互相召唤

舞台与 Pro,随叫随到

顶栏的「召唤」让她在两个窗口之间来回:舞台上她站在壁纸上陪你,Pro 里她站在终端旁待命。一次点击,随叫随到,会话不断线。

舞台站在壁纸上
召唤
Pro 工作台站在终端旁

Pro 工作台

三件绝佳的工具

Pro 坐在 herdr 之上:终端比窗口、睡眠、崩溃都活得久,关掉 Bench 什么都不死;会话真的死了也有恢复计划,resume 提示词可以直接执行。

01

绝佳的 coding 终端

所有 agent 的终端收进一棵树:谁在等你、谁在跑、谁跑完了。注意力队列三键决断,滚轮翻回 herdr 里的历史。

herdr 常驻终端scrollback 滚轮会话恢复
02

绝佳的 ssh 工具

pin 过的机器、~/.ssh/config 别名、或粘进来的一整行 ssh 命令:免密探测与 ssh-copy-id 的答案是一句话;机器可编辑、可删除、可恢复。

免密探测~/.ssh/configcodewaifu pro ssh
03

绝佳的本地 shell

在任意任务目录一键开 shell,面板不必非装一个 agent;会话活着,比 Bench 关窗更久。

一键开 shell关窗不杀会话codewaifu pro term

不停机的驾驶台

崩溃、重启、三天后回来,工作都还在

Pro 的终端不由窗口持有:herdr 握着每一个 PTY,意图账本把目标、决定与下一步 fsync 进磁盘,工作台只是这两者在屏幕上的投影。中断因此被拆成三档,每一档都有明确的接法。

关窗 · 崩溃 · 睡眠

agent 一个都不死

关掉 Bench、kill -9 应用、合上盖子,pane 里的 agent 都还在跑。重新打开,树、注意力队列与账本从磁盘和 herdr 重新派生,不会多开一个重复的 pane。

herdr 持有 PTYGUI 可丢弃不重复开 pane
系统重启

开机自己接回去

重启之后没有任何东西会去启动 herdr,CodeWaifu 就自己以 server 形态把它拉起来;等第一帧快照对齐,再一次性执行恢复计划——重建 worktree、用记下的 session id 以 resume 重启 agent。上限内的任务无人值守,其余在恢复页等一次点击。

autoStartHerdrautoResumeOnBootresume <id>
会话真的没了

意图还在,零重新解释

没有可 resume 的会话 id 时,判定诚实地落在 lost;但账本记得目标、做过的决定、下一步、分支与 head、工作目录,把它们拼成一段 re-prompt 直接发出去。换另一个模型接手,用的也是同一段话。

fsync 意图账本re-prompt跨 agent 交接

$ codewaifu pro recovery

2 tasks need recovery

1.  resumable  fix the flaky payment test  pay-fix-0912
    resume codex 9c1ab21f
    agent     codex resume 9c1ab21f
2.  lost       migrate the ledger to pg    ledger-mig
    no agent session id was ever captured
    workspace ~/dev/robotworld
    agent     codex
    prompt    Resuming a task whose previous agent session is gone. Goal: migrate the ledger to pg; Next action: replay...

the Bench window applies a plan (recovery tab)

开机第一句由她说出口:「工作台回来了:1 个可以直接恢复,1 个只剩意图」。恢复页里每一行都先写判定与步骤,执行前看得见她要做什么。

绝佳是她的能力,体贴是你的待遇。

安装

一行命令装好

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/flowinginthewind700/codewaifu/main/scripts/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/flowinginthewind700/codewaifu/main/scripts/install.ps1 | iex

安装脚本下载最新 release,把 hooks 写进 Codex 与 Claude Code,并顺带装好 herdr(Pro 驱动的那个终端运行时)。macOS / Windows / Linux 全平台;Codex 装完运行一次 /hooks 并信任 CodeWaifu 即可,Claude Code 无需任何操作。

MIT 开源,由 RobotWorld 的 AI Agent 开发与维护。