another / coding agent 会话迁移工具coding agent session migration
换个 agent，接着聊。another 把对话文字写进目标 agent 的原生存储，用它自己的命令打开。来源会话保持原样。 Take the conversation with you. another writes your messages into the next agent’s native store and opens them with its own command. Your source session stays untouched.
v0.20.1 · macOS / Linux / Windows · amd64 / arm64 · MIT 开源 v0.20.1 · macOS / Linux / Windows · amd64 / arm64 · MIT licensed
Homebrew 6 使用此命令。旧版请跳过 brew trust，直接运行 brew install nxxxsooo/tap/another。For Homebrew 6. On older versions, skip brew trust and run brew install nxxxsooo/tap/another.
运行 another，在一个列表里找到各家 agent 的会话。选好去向，写入、校验，再用目标 agent 继续。Run another to find your agents’ sessions in one list. Choose a destination, write and verify the conversation, then continue in that agent.
按目标 agent 自己的格式写进去，用它自己的命令打开：codex resume、claude --resume。不是把一大段文字粘进一个新对话。It is written in the target agent's own format and opens with that agent's own command — codex resume, claude --resume. Not a wall of text pasted into a new chat.
每次搬完都把写进去的东西重新读出来对一遍，对不上就只删掉这次新建的。原来那边的会话全程一个字都不动。After each move it loads the result back and compares it. If it does not match, it deletes only what this move created. The original session is never touched.
搜索、预览、改名、归档、删除、换目录、搬到别的 agent，都在这个列表里做完。默认只看当前 Git 项目，按 f 看全部，按 g 按日期或 worktree 分组，按 ? 看完整键表。Search, preview, rename, archive, delete, relocate, move to another agent — all without leaving the list. It starts on the current Git project, f shows everything, g bands the list by date or by worktree, and ? opens the full keymap.
Pi、OpenCode、Claude Code、Codex、Antigravity、Qwen Code 进入每次发布的回归检查。CodeM 保留兼容适配并在 setup 中提供；Cursor、CommandCode、Hermes 的适配仍在，已有配置照常可用，但 setup 不再向新用户提供。OpenCode V1 历史和 V2 会话现在共用一个入口，按会话实际存储调用原生操作；旧的 opencode2／o2 别名继续可用。Pi, OpenCode, Claude Code, Codex, Antigravity, and Qwen Code enter every release regression pass. CodeM remains a compatibility adapter offered in setup; Cursor, CommandCode, and Hermes keep their adapters for existing configurations, but setup no longer offers them to new users. OpenCode V1 history and V2 sessions now share one entry, with operations routed to the actual native store; existing opencode2 and o2 aliases still work.
| Agent | 标记Tag | 原生恢复命令Native resume | 重命名Rename | 归档Archive | 迁目录Relocate | 删除Delete |
|---|---|---|---|---|---|---|
| Pi | PI | pi --session <file> | ✓ | — | ✓ | ✓ |
| Codex | CDX | codex resume <id> | ✓ | ✓ | — | ✓ |
| Claude Code | CLA | claude --resume <id> | ✓ | — | — | ✓ |
| OpenCode | OPC | opencode --session <id> | ✓ | V1 | V2 | ✓ |
| Qwen Code | QWN | qwen --resume <id> | ✓ | ✓ | — | ✓ |
| Antigravity | AGY | agy --conversation <id> | ✓ | — | — | ✓ |
| Cursor | CUR | cursor-agent --resume <id> | — | — | — | ✓ |
| CommandCode | CMD | commandcode --resume <id> | — | — | — | ✓ |
| CodeM | CDM | codem --resume <id> | ✓ | ✓ | — | ✓ |
| Hermes | HRM | hermes --resume <id> | — | ✓ | — | ✓ |
绿色标记的是每次都测的六个。— 表示这个 agent 本身就没有这个操作：改名、归档、删除都是直接改它自己的数据，another 不会另存一份刷新就没的假状态来充数。第一次 setup 也不会因为你机器上装了什么就替你勾上，索引哪些 agent 由你自己选。The green tags are the six that get tested every time. A dash means the agent itself has no such operation: rename, archive, and delete change that agent's own data, and another will not fake one with a marker that vanishes on refresh. First-run setup never ticks agents for you just because the binary is on your machine — you pick what gets indexed.
搬得过去：按顺序排好的你和 AI 的对话文字、目标格式支持的时间、项目目录、标题，还有一个用来去重和校验的标记。搬不过去：各家自己的推理签名、工具调用和结果、图片、系统记录。这些东西在别家没有对应的形式，硬凑只会凑出假的。Comes along: your messages and the assistant's, in order; timestamps the target format supports; the project directory; the title; and a marker used to deduplicate and verify. Does not: provider-specific reasoning signatures, tool calls and their results, images, and system records. Nothing on the other side matches them, and faking it would just produce something untrue.
d 会先把 provider、标题、项目和完整会话 ID 摆出来，光标默认停在取消；能确认正在跑的会话删不掉。d first shows the provider, title, project, and full session ID, with Cancel selected. Sessions it can positively identify as running are protected.u 原样写回去：ID、路径、修改时间都不变。OpenCode 2 的删除是它服务端做的，写回去只会多出一个新 ID 的副本，所以那边没有撤销，弹窗会先告诉你现在是哪一种。A Pi or Claude Code session is a single file, so another keeps those exact bytes and u puts them back: same ID, same path, same mtime. OpenCode 2 deletes on its own server, and pushing the conversation back would only create a copy under a new ID, so there is no undo there — the dialog tells you which case you are in before you commit.0700，配置和 SQLite 索引文件 0600；索引放在 ~/.cache/another/，重新扫描时跳过没变过的会话。The config directory is 0700; the config and SQLite index files are 0600. The index lives in ~/.cache/another/ and skips sessions that have not changed on a re-scan.在 setup 里指定一个装好的 agent，按 r 就让它在后台起个标题：中文 MMDD｜类型｜主题，英文 MMDD｜Type｜Topic。日期取索引里的创建时间换算成东八区，不让模型猜。格式不对、回得太慢、直接失败的，一律扔掉，不覆盖你已经敲进去的字。Point setup at an agent you already have installed, press r, and it asks that agent for one title in the background: MMDD｜类型｜主题 in Chinese, MMDD｜Type｜Topic in English. The date comes from the indexed creation time converted to Asia/Shanghai — the model never guesses it. Anything that comes back in the wrong shape, too late, or not at all gets thrown away without touching what you typed.
x 挑几条，r 一起改名。确认页只列会变的那几行，锁住的、失败的、没变的折成一个数字；真正写进去时一行行读回来对。Tick a few with x, rename them together with r. The review page only lists rows that would actually change; frozen, failed, and unchanged ones fold into a count, and each row is read back as it's applied.pi --list-models、agy models、opencode models）；不能列的直接让你手输，并说明为什么。If an agent can list its models, another asks it (pi --list-models, agy models, opencode models). If it can't, you type the model in, and it tells you why.another-titler-* 临时目录认出它们，挡在自己的索引外，只清自己的索引，不删人家的文件。A few CLIs record a session for every background run. another spots them by the prompt's fixed first line and the another-titler-* throwaway directory and keeps them out of its own index — its index only, nobody's files get deleted.another integrations install opencode 更新已装插件；已有标题不追改。插件只写 plugins/another-title-policy/。On OpenCode 2.0.4, the title plugin adds the creation date before the first title is saved, instead of waiting for a rename event. After upgrading another, run another integrations install opencode to refresh the plugin; existing titles stay unchanged. It only writes plugins/another-title-policy/.~/.pi/agent/extensions/another-title-policy/，在 agent_end 时回头喊 another 来起名。它自己不接模型，所以规则只有一份；你改过标题的会话会跳过。An extension ships inside the binary the same way, installs into ~/.pi/agent/extensions/another-title-policy/, and calls another back on agent_end. It talks to no model of its own, so the rule exists once, and a session you titled yourself is skipped.SessionEnd hook 在会话结束后调 another rename --auto，在后台按同一套规则起名；你自己改过标题的会跳过。这个 hook 要你自己写进 ~/.claude/settings.json，another 不替你改配置。A SessionEnd hook calls another rename --auto once the session is over and names it in the background under the same rule; sessions you titled yourself are skipped. You add that hook to ~/.claude/settings.json yourself — another doesn't edit your config.支持 macOS、Linux 和 Windows（amd64 / arm64）。Windows 使用顶部的 PowerShell 安装命令。首次运行进入 setup，手动选择要索引的 agent。Windows 实机已验证 setup、索引、预览和 Codex 交接，其他 agent 的 Windows 原生交接仍待实测。Runs on macOS, Linux, and Windows (amd64 and arm64). Use the PowerShell install tab for Windows. First-run setup asks you to choose which agents to index. Windows VM checks cover setup, indexing, preview, and Codex handoff; native Windows handoff for other agents remains unverified.
v0.20.1 让切换视图时列表保持不动：按 g 在不分组、按日期、按目录之间切换，任何一列都不移动；按 t 也不再改变顶栏宽度，没有时间窗时显示「全部时间」。v0.20.0 把常用键挪到单个字母（r 重命名、d 删除、s 刷新，原来的 Ctrl 组合键仍可用），/ 支持 path:目录，手机宽度的终端里每行把宽度让给标题。运行 another update 升级。v0.20.1 keeps the list still while you change the view: g switches between ungrouped, by date, and by directory without moving a single column, and t no longer reshapes the header, which now says all time when no window is set. v0.20.0 put the everyday keys on single letters (r rename, d delete, s refresh; the Ctrl keys still work), added path:folder to /, and gave phone-width terminals rows that show the title. Run another update to upgrade.
Homebrew 6 要先信任第三方 tap 才肯装。旧版 Homebrew 不认识 brew trust，第一行跳过就行。Homebrew 6 won't touch a third-party tap until you trust it. Older Homebrew doesn't know brew trust — just skip the first line.
a → another，已有同名命令、函数或 alias 就跳过。脚本安装时添加，Homebrew 在首次交互运行时添加，重开 shell 生效。开发版 make install 添加 a-dev 和 adev。Adds a → another only when the name is free. Existing commands, functions, and aliases win. Scripts add it during installation; Homebrew adds it on the first interactive launch. Open a new shell afterwards. Development installs add a-dev and adev.a 始终归档当前会话，u 撤销最近一次归档或可恢复的删除，Esc 关闭撤销提示，q 退出。Inside the TUI, a always archives the current session. u undoes the latest archive or reversible delete, Esc dismisses the offer, and q quits.go install github.com/nxxxsooo/another/cmd/another@latest，需要 Go 1.24 或更高版本。 — requires Go 1.24 or newer.checksums.txt 校验，再把二进制放进 PATH。Grab the matching archive from Releases (ZIP on Windows), verify it against checksums.txt, and put the binary on your PATH.brew upgrade another，或者直接 another update，它会走你当初装它的那条路。装好的二进制不会自己跟着仓库变。, or just another update, which follows whatever installed it. An installed binary never updates itself behind your back.全程在你自己机器上跑，读的是各家 agent 自己的存储。MIT 协议，代码都在 GitHub 上。It all runs on your machine, reading each agent's own store. MIT licensed, code's on GitHub.
