osori

What This Skill Does

Osori (오소리) is a powerful, high-performance local project registry and context loader designed for AI agents. Serving as the "file system brain" for your OpenClaw setup, it streamlines how your agent identifies, tracks, and navigates software development projects. It maintains a registry of your local repositories, supports versioning, auto-migration, and provides a robust command suite for project discovery and management. Whether you are switching between microservices or auditing deep legacy codebases, Osori provides the bridge between abstract agent instructions and actual local file paths.

Installation

To integrate Osori into your agent, use the OpenClaw hub CLI. Execute the following command in your terminal: clawhub install openclaw/skills/skills/oozoofrog/osori

Ensure your system meets the prerequisites:

• macOS: mdfind (built-in), python3, git, and gh CLI installed.
• Linux: find (for directory scanning), python3, git, and gh CLI.
• Entire (optional): Install the entire CLI if you require specific integration features like status tracking and rewind points.

Use Cases

Osori is designed for developers who juggle multiple projects across various directory structures. It excels at:

1. Context Switching: Quickly finding a specific repository across fragmented disk roots.
2. Project Maintenance: Using the /doctor command to verify registry health, identify orphaned paths, and fix configuration inconsistencies.
3. Quick Status Audits: Checking the latest commit status, pending PRs, or issue counts directly via Telegram without opening an IDE.
4. Entire Integration: Managing specific Entire agent strategies or rewind points in local development environments.

Example Prompts

1. "Osori, please list all projects currently registered in my 'work' root directory."
2. "Switch to the 'auth-service' project and load the context for me."
3. "Run a doctor check on my registry to ensure all project paths are still valid and fix any issues found."

Tips & Limitations

• Safety First: Always utilize the --dry-run flag with the /doctor command before applying fixes to ensure you understand what Osori intends to modify.
• Root Scoping: If you have many projects with overlapping names, always specify the --root flag to ensure the agent targets the correct directory.
• Performance: Osori uses local indexing methods (Spotlight or find); ensure your project root directories are correctly indexed for optimal performance. While it is safe for general directory operations, be cautious when using the /root-remove command with the --force flag, as it will purge tracking information for those projects.