Kijito Tools Claude/Codex 上下文自我管理工具集 Skill 技能

技能简介

kijito-tools 是一组为 Claude Code 与 Codex CLI 会话量身打造的"上下文自我管理"工具集。它由 KijitoAI 开源提供，既能跟踪会话自身的上下文窗口占用、也能在占用过高时回收上下文而不破坏当前任务；可选组件还支持会话启动时自动从记忆库"接上之前的上下文"，以及让一个 tmux pane 在武装后自动续接预加载工作。整套工具完全可选安装：上下文检查可独立使用、autonomy harness 按 pane 选择开启、技能只是打包过的便捷包装，背后所有步骤也能直接手动调用。

核心能力

• 实时上下文占用：myctx.sh / statusline-context.sh 通过会话 transcript 中的 API token 数计算实际占用并显示在 statusline 上，与 Claude Code 内置 /context 数据一致
• Session catch-up hook：session-catchup-hint.sh 在 SessionStart 触发，让每个新会话在开始任务前先把记忆与笔记拉回来
• Armed-pane autonomy：claude-armed.sh / arm-session.sh / session-autosend.sh 让被武装的 tmux pane 自我派发首条 prompt 并继续预加载工作，按 pane 维度独立武装
• Context recycling：在高占用时回收上下文但不丢失工作状态；与 Kijito 记忆后端配合时无缝衔接
• Standalone 模式：所有 catch-up 与 curation 步骤既可走 Kijito 后端，也可在不接入 Kijito 时手动运行
• 可选最小安装：组件按表格分级，使用者只需安装需要的部分即可

安装配置

pip install kijito-tools
kijito init    # 在 ~/.claude/ 部署 kijito 技能与脚本

零强依赖；可选 Kijito 记忆后端用于 catch-up 步骤，所有 catch-up 与 curation 操作在不接 Kijito 时也能直接通过 CLI 调用。脚本与技能会被部署到 ~/.claude/ 下，符合 Claude Code 的目录规范；武装 pane 需要 tmux。

使用步骤

1. pip install kijito-tools 后执行 kijito init，在 ~/.claude 下部署好技能、hook 脚本与默认配置。
2. 在 Claude Code / Codex 中打开一个新会话，SessionStart hook 会自动调用 catch-up 把上次记忆与笔记拉回当前会话。
3. 在 statusline 中实时看到当前上下文窗口的 token 占用百分比与 /context 数据一致。
4. 当占用达到回收阈值时，让 Agent 主动运行一次 context recycling，无需中断当前任务即可换出低层上下文保留工作状态。
5. 若希望某个 tmux pane 持续推进预加载任务，对该窗口运行 arm-session.sh 完成武装并启用 auto-pane。

适用场景

• 超长会话保持工作状态：用 context recycling 在不丢失当前任务进度的前提下换出低价值上下文，支撑多日/多迭代的 Agent 工作流
• 跨会话记忆接续：SessionStart hook 让每次开新会话都能"接上"之前的记忆与笔记，避免反复交代上下文
• 后台自主运行：armed-pane 让某个 tmux pane 自主推进预加载工作，研究员/工程师同时在另一个 pane 手动驱动
• 上下文可视化：在 statusline 上看真实占用，避免依赖模型自报的"上下文还很空"的错觉
• 多机一致部署：所有组件都是声明式的，可统一脚本化部署到团队的开发机

适用人群

适合重度使用 Claude Code / Codex 进行多日/多任务工作的 AI 应用开发者、独立研究员、数据科学家，以及任何希望"上下文管理变成可工程化流程"而非依赖 Agent 自觉的团队；Kijito 记忆后端的现有用户尤其受益。

工作原理

kijito-tools 把"会话上下文管理"分解为几个独立可选组件：上下文监控通过读取 Claude Code 会话 transcript 中的 API token 数（与内置 /context 数据一致）算出真实占用并写到 statusline；catch-up hook 在 SessionStart 通过 Kijito 记忆后端（API 简介、本地笔记、归档状态）拉回必要上下文；context recycling 在占用过高时把低层上下文换出但保留工作状态与记忆索引；armed-pane 借助 tmux pane 的独立性实现"一 pane 自主 + 一 pane 手动"的并行工作流。所有组件按需安装，运行时不与 Claude Code 内部状态冲突。

官方链接

• GitHub 仓库：https://github.com/KijitoAI/kijito-tools
• PyPI 包：https://pypi.org/project/kijito-tools/
• 记忆后端：https://kijito.ai
• 适用宿主：Claude Code、Codex CLI
• 许可证：开源（仓库 LICENSE 文件）