osori

Osori（韩语"獾"之意）是一款专为AI Agent设计的本地项目注册表与上下文加载工具，旨在解决开发者在多项目间频繁切换时的上下文丢失与路径查找痛点。该工具通过维护本地JSON注册表（默认位于~/.openclaw/osori.json），实现项目的智能索引、快速切换与状态聚合，显著提升开发效率。

核心用法围绕项目生命周期管理展开。用户可通过自然语言触发（如"work on X"或"X 프로젝트 작업하자"）实现项目切换，系统自动执行注册表模糊匹配、Spotlight（macOS）或find（Linux）深度搜索，加载项目上下文包括Git状态、当前分支、近期提交记录及GitHub Issues列表。支持批量扫描目录自动注册项目、标签与语言筛选、项目状态批量检查等功能，形成完整的本地项目管理闭环。

显著优点体现在本地化优先架构与跨平台兼容性。不同于依赖云端的解决方案，Osori完全基于本地文件系统运作，无网络延迟与隐私泄露风险；自动检测平台能力，macOS用户享受Spotlight极速索引，Linux用户无缝切换至find回退方案。严格的代码规范（set -euo pipefail）、Python处理JSON避免Shell注入、以及完善的安全测试用例，确保工具健壮性。GitHub CLI集成提供Issue追踪能力，实现代码与任务管理的一体化。

潜在局限性需用户权衡。作为T3来源的个人开发者项目，虽经安全认证，但长期维护与社区支持弱于企业级工具；注册表为本地单用户文件，不支持团队协作与云端同步；功能依赖python3、git及gh CLI预装，在精简环境中可能需额外配置。

该工具特别适合多技术栈并行的全栈开发者、频繁切换上下文的顾问型工程师，以及注重隐私的本地优先工作流拥护者。使用风险主要包括：系统工具依赖缺失导致功能降级、注册表文件损坏或误删导致项目索引丢失（建议定期备份）、以及macOS Spotlight索引延迟可能影响的搜索准确性。总体而言，Osori以极简的本地优先哲学，为开发者提供了安全、高效的项目导航体验。