Osori（오소리）是一款专为AI智能体设计的本地项目注册管理与上下文加载工具，旨在简化开发者对多个代码项目的快速切换与管理流程。它通过维护一个集中化的项目注册表，支持以自然语言或Telegram命令的方式触发项目操作，显著提升多项目工作流中的效率与一致性。核心功能包括自动化的项目发现、基于Git和GitHub信息的状态检查、以及灵活的根目录管理，使其成为处理复杂开发环境的有力助手。该工具特别适用于需要频繁在不同项目间切换的AI编程助手集成场景，例如OpenClaw等Agent框架。 Osori v1.6.1版本引入了完整的Telegram斜杠命令支持，用户可以通过聊天界面直接执行项目管理操作，如列出项目、查找特定仓库、切换工作目录等。其底层采用JSON格式的注册表进行持久化存储，并内置了完善的版本控制与迁移机制，确保数据在升级过程中的安全性与兼容性。当项目路径未知时，系统会通过模糊匹配、Spotlight搜索（macOS）、预设路径扫描等多种方式智能定位目标项目，极大降低了手动输入路径的需求。此外，Osori还支持与Entire CLI的深度集成，实现对AI开发环境状态的统一管控。
核心功能特点
- 支持Telegram斜杠命令进行项目查询、切换和管理，提供直观的命令行式交互体验
- 具备自动项目发现机制，可通过名称模糊匹配、根目录路径扫描等方式定位未注册项目
- 内置注册表版本控制与自动迁移功能，保障数据安全并支持向后兼容
- 集成GitHub状态检查（PR/Issue计数）和Git分支信息展示，提供完整的项目指纹视图
- 支持别名与收藏夹功能，便于快速访问常用项目
- 提供全面的健康检查（doctor）命令，包含风险分级修复建议与预览模式
适用场景
Osori最适合那些同时维护多个代码仓库的开发者，尤其是在使用AI编程助手（如Claude Code）进行大规模编码任务时。想象一下，你正在并行处理公司内部的不同产品线——一个iOS应用、一个后端服务和一个数据分析脚本。传统方式下，每次切换都需要手动cd到对应目录，而Osori允许你直接在Telegram中输入`/switch ios-app`即可自动加载该项目的Git状态、最近提交和历史问题列表，让AI助手立即获得准确的上下文信息。这种无缝衔接的工作流特别适合远程协作或长时间专注单一项目的深度开发场景。 对于需要定期审计项目健康状况的团队而言，Osori的`/doctor`命令尤为实用。它能自动检测注册表异常（如损坏条目、重复记录或缺失字段），并按风险等级（低/中/高）提出修复方案。例如，在一次系统更新后可能出现部分项目路径失效的情况，此时运行`/doctor –fix –dry-run`可生成详细的修复计划而不实际修改数据；若确认无误，再执行完整修复。结合`/list-roots`和`/root-path-add`等功能，团队还能构建个性化的项目组织结构，将不同部门或类型的项目归类到不同的逻辑根目录下，实现更精细化的资源管理。