██╗ ██╗█████╗ ██╗ ██╗ ███████╗█████╗ ██████╗███████╗██████╗ ██║ ██║██╔══██╗██║ ██║ ██╔════╝██╔══██╗██╔════╝██╔════╝██╔══██╗ ██║ █╗ ██║███████║██║ ██║ █████╗ ███████║██║ █████╗ ██████╔╝ ██║███╗██║██╔══██║██║ ██║ ██╔══╝ ██╔══██║██║ ██╔══╝ ██╔══██╗ ╚███╔███╔╝██║ ██║███████╗███████╗██║ ██║ ██║╚██████╗███████╗██║ ██║ ╚══╝╚══╝ ╚═╝ ╚═╝╚══════╝╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝╚══════╝╚═╝ ╚═╝ 一个针对 Claude Code、Cursor CLI、Kiro CLI 和 Codex 的终端会话管理器 — 查看您曾经开始的每一个 AI 编码会话，然后通过全屏浏览器或直接从命令行为它们命名、标记、分组、搜索、恢复或删除。为何 Claude Code 将每个对话存储为标题为“无”的 JSONL 文件在 ~/.claude/projects/ 下，按您所在的目录进行键值存储。Kiro CLI 在一个扁平的 ~/.kiro/sessions/cli/ 文件夹中做着相似的事情，Cursor CLI 则将每个聊天存储在 ~/.cursor/chats/ 下的 hash 命名目录中，而 Codex 按日期将其推出文件存储在 ~/.codex/sessions/ 下。几周后，您会拥有数十份跨四个代理的记录，而这些记录难以区分，也没有办法找到您需要的那一份。wallfacer 对它们进行了索引 — 只读，它从不接触代理的文件 — 并将您的标题、标签和项目保存在其自己本地的 SQLite 数据库中。 特性 一览无遗 — 每个会话，从每个目录和每个代理，按最近性排序 组织 — 重命名会话，为其打标签，将其分组到项目中 搜索 — 根据标题、首个提示、目录、项目和标签进行搜索 启动与恢复 — 从任何地方开始新的会话或跳回旧会话 多代理 — Claude Code、Cursor CLI、Kiro CLI 和 Codex 并列；在开始会话时选择代理，之后进行筛选 安全删除 — rm 移动到垃圾箱；仅 --purge 是永久的 TUI 和 CLI — 为人类提供的全屏浏览器，使用子命令 + --json 用于脚本 可扩展 — 代理是可插拔适配器；开放源码在规划中 安装 在 macOS 或 Linux 上使用 Homebrew: brew tap pradipta/wallfacer https://github.com/pradipta/wallfacer brew install pradipta/wallfacer/wallfacer 该公式存储在此库中，而不是单独的 homebrew-wallfacer tap，这也是 tap 的 URL 需要明确列出的唯一原因。之后，brew upgrade wallfacer 按照常规操作即可。或者使用 Go: go install github.com/pradipta/wallfacer@latest 需要 Go 1.22+。预构建的二进制文件在发布页面中；从源代码构建的相关内容在开发指南中说明。 使用的两种方式 wallfacer 是一个具有两个前端的二进制文件，取决于您是否传递子命令： 您输入 您获得 wallfacer TUI — 一个全屏、交互式的会话浏览器。在这里开始。 wallfacer <command> CLI — 一次性子命令，用于脚本和肌肉记忆。它们不是单独的工具，也没有需要切换的内容：两个都读取和写入相同的 SQLite 索引，因此您在浏览器中标记的会话可以立即通过 wallfacer list --tag 找到，反之亦然。 TUI 能做的任何事情，子命令也能做到。(如果 stdout 不是终端 — wallfacer | less，或在脚本内部 — bare 命令打印帮助而非打开浏览器。） 快速开始 打开浏览器并从那里工作： wallfacer 或者从 Shell 控制它： wallfacer new ~ /work/api --title "修复不稳定的身份验证测试" wallfacer resume "修复不稳定的身份验证测试" # 按标题或 ID 前缀 wallfacer search auth wallfacer list --project api --json # 用于脚本 TUI — wallfacer Bare wallfacer 打开一个全屏会话浏览器：左侧是列表，右侧是显示 wallfacer show 打印的详细面板。每一行显示其项目、标签、目录、年龄和代理 — 与 wallfacer list 打印的元数据相同。在 ~100 列时，详细面板会让位于列表，列表占满整个宽度。 关键操作 ↑/↓ j/k 移动 / 模糊过滤标题、项目、目录、标签和代理名称 P / T / A 循环项目 / 标签 / 代理过滤器（再次回到未过滤） x 清除项目、标签和代理过滤器 tab 显示或隐藏详细面板 enter 恢复 — 终端交给代理；退出后浏览器返回 n 新会话（询问代理，然后是目录、标题、项目、标签） r / t / p 重命名 / 编辑标签 / 设置项目 d 删除 → 垃圾箱，需确认 ? / q 帮助 / 退出 代理步骤先开始，且为单行选择器：←/→或数字选择，enter 继续，esc 取消。Claude Code 默认选中，若仅注册了一个适配器，则整个步骤将被跳过。 CLI — wallfacer <command> 每个子命令都是一次性：运行、打印并退出。与浏览器相同的索引。 命令 功能 wallfacer (没有子命令) 打开交互式浏览器 wallfacer new [dir] [--agent A] [--title T] [--project P] [--tag t] 在目录中开始一个新会话 wallfacer resume <ref> 在其原始目录中重新打开会话 wallfacer list [--project P] [--tag T] [--agent A] [--json] 列出会话，从最新开始；--agent 接受一个号码