夜雨聆风学习资料网

ARTICLE · 1148151

装了一堆 AI 编程工具后,我的会话“散落一地“——用 kshell 把它们管起来

装了一堆 AI 编程工具后,我的会话“散落一地“——用 kshell 把它们管起来

告别AI会话混乱:开源工具kshell统一管理所有编程Agent会话

你有没有过这样的经历:上周让 Claude Code 改的那个 bug,改到一半有事走开了,今天想接着聊,却完全想不起来是哪个会话;又或者同时用着 Claude Code、Codex、Cursor、Gemini CLI,每换一个工具就要换一套命令、找一遍会话入口……

如果你也装了不止一个 AI 编程助手,这篇文章讲的痛点你大概率都经历过。这里分享一个开源小工具 kshell——它不替代任何 AI 编程工具,只做一件事:把你机器上所有 agent 工具、工作区和会话,统一管起来。

一、AI 编程时代的新痛点

先说说 AI Agent 重度用户的日常开发困境,几乎人人中招。

痛点 1:会话散落在各个角落,想找找不到

每款 AI 编程工具都会将会话记录存储在独立目录:有的在 .claude、有的在 .codex、有的在 .gemini……一旦安装多款工具,所有会话历史会分散在不同位置。

想要找回某一段特定场景的对话,只能逐个打开工具、调用对应 resume 命令、翻阅独立会话列表,极其耗费时间和精力。

痛点 2:恢复会话的操作链路冗长

即便记得对应工具,恢复一次会话的流程也十分繁琐:

  1. 打开终端,cd 切换到对应项目目录;

  2. 输入对应工具的专属恢复命令;

  3. 通过标题、时间筛选目标会话;

  4. 回车确认,完成会话恢复。

日常多项目、多工具切换开发时,这套重复操作会大幅拉高上下文切换成本,严重消耗专注力。

痛点 3:多窗口杂乱,开发状态割裂

常规开发场景中,往往需要同时开启 Agent 终端、Git 终端、代码编辑器、文件管理器等多个窗口。AI 编程会话同时关联代码、终端、对话三类信息,频繁切换窗口极易丢失开发进度和对话上下文。

痛点 4:远程开发环境会话管理割裂

远程服务器的代码和本地工具无法互通,需要频繁 SSH 连接、切换终端操作。服务器端的 AI Agent 会话长期处于无人管理的状态,无法快速回溯、接续开发。

二、kshell 核心解题思路:发现 → 选择 → 交付

kshell 是一款跨平台轻量级开源 Agent 工作台,支持 Windows、macOS、Linux 全系统。它的核心运行逻辑分为三步:发现 → 选择 → 交付。

该工具最大的设计亮点:不重新实现任何工具的对话协议、不迁移、不篡改原生会话数据。各 AI 工具的会话记录仍由工具自身管理,kshell 仅负责扫描、汇总、展示会话信息,恢复会话时直接调用原生 CLI 指令,彻底规避数据丢失、同步出错的风险。

1. 统一入口,全景查看所有 Agent 资产

打开 kshell 桌面端,首页展示项目网格视图,每个项目对应独立卡片,清晰展示项目会话数量、所用 AI 工具类型、最后活跃时间。无需逐个工具查询,一眼掌握本机所有 AI 开发项目和会话状态,彻底告别翻找式查找。

2. 一键恢复会话,杜绝开发“失忆”

点击对应项目卡片,左侧会展示该工作区下所有工具的全部会话列表,支持关键词搜索、精准筛选。选中目标会话即可一键恢复,工具自动调用对应原生 CLI 恢复指令,精准接续历史对话,无需手动输入命令、切换目录。

3. 三栏一体化布局,一屏搞定全流程开发

工作区采用经典三栏布局,整合所有开发能力,无需多窗口切换:

  • 左栏:全部会话列表 + 新建会话入口;

  • 中栏:Agent 对话、终端页签、文件与会话实时预览;

  • 右栏:带 Git 脏标记的文件树(支持预览、编辑、保存)+ 远程 SSH 管理面板。

细节优化拉满:页签切换不会销毁终端、聊天会话状态,随时切换随时接续;支持 Ctrl+K 快速跳转工作区、Ctrl+F 精准搜索,大幅提升多项目并行开发效率。

4. 纯终端 TUI 版本,键盘党专属效率工具

针对终端爱好者、服务器无桌面场景,kshell 内置全屏 TUI 终端版本,单文件零依赖、直接运行。支持 Tab 切换视图、/ 搜索过滤、n 新建会话、r 重新扫描,全键盘操作,适配远程服务器开发、极简终端开发场景。

5. 智能 SSH 管理,自动发现远程连接

kshell 具备智能 SSH 候选扫描能力,可自动遍历本地项目配置文件,挖掘远程连接信息:

  • 高置信度:读取 ~/.ssh/config 官方配置;

  • 中低置信度:识别 .env、Spring 配置、docker-compose、部署脚本、项目文档中的远程连接信息。

所有扫描候选需手动勾选确认后才会收录,私钥仅保存路径、不存储明文内容,兼顾便捷性与安全性,彻底告别手动查找 SSH 配置的繁琐。

6. 零代码适配新工具,生态高度开放

工具无需修改源码,仅通过配置文件 providers.yaml 即可自定义接入各类新型 AI 编程 CLI 工具,只需配置会话存储路径、文件格式、恢复命令即可完成适配。

目前已原生支持 Claude Code、Codex CLI、Cursor、CodeBuddy、Gemini CLI、OpenCode 等主流 AI 编程工具。

三、适配人群

kshell 轻量化、无侵入的设计,适配绝大多数 AI 编程开发者:

  • 多工具使用者:同时使用 2 款及以上 AI 编程助手,需要统一管理会话;

  • 多项目开发者:日常频繁切换多个开发工作区,追求高效上下文接续;

  • 终端爱好者:习惯纯键盘操作,偏爱轻量化 TUI 终端工具;

  • 远程开发从业者:长期维护多台服务器,需要统一管理远程 SSH 连接与 Agent 会话。

四、快速安装方式

项目支持全平台免配置安装,解压即用,无需复杂编译部署:

直接前往 GitHub Releases或 GitCode Releases,下载对应系统架构的桌面版压缩包即可。

桌面端内置自动更新功能,国内优先调用 GitCode 镜像源,GitHub 作为备用源,更新稳定快速。项目基于 MIT 开源协议,可自由使用、编译、二次开发。

写在最后

AI 编程工具的迭代升级大幅提升了开发效率,但工具越多,会话分散、切换繁琐、管理混乱的问题就越突出。

kshell 的定位十分克制且精准:不替代、不抢占各类 AI 工具的能力,只作为统一的管理入口,帮开发者理清散落的会话资产、降低上下文切换成本,让每一次 AI 编程开发都能快速回溯、无缝接续。

如果你也被 AI 会话混乱、开发切换繁琐的问题困扰,不妨试试这款轻量化工具。

项目开源地址:

  • GitHub:https://github.com/kaiys202212/kshell

  • GitCode:https://gitcode.com/abraveheart2023/kshell

相关学习资料