omni-cache — Claude Code skill: LLM response cache management
Skill for viewing LLM cache statistics, clearing entries, configuring TTL policies, and controlling semantic-similarity caching thresholds. Use it to optimize cache performance and monitor cache state.
npx skills add cheaper-inference/OmniRoute --skill omni-cache -a claude-codeWhat omni-cache does
omni-cache provides REST API endpoints to manage your LLM response cache. Query detailed statistics across all cache layers, clear individual entries or flush the entire cache, and tune TTL policies and semantic similarity thresholds to fit your workflow.
The skill exposes endpoints like /api/cache for basic stats, /api/cache/stats for detailed information, and /api/cache/entries and /api/cache/reasoning to manage specific cache types. All requests require Bearer token authentication; for local development, you can disable key checks with REQUIRE_API_KEY=false.
Built on OmniRoute, omni-cache integrates with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.
What it helps with
- monitor cache usage and memory footprint in real time
- clear stale cached responses when they become outdated
- set different TTL policies for different data types
- adjust semantic similarity thresholds for cache matching
Example prompts for the agent
- Show me cache statistics and how much memory is being used
- Clear all cached model responses
- Get detailed stats for every cache layer
How to install omni-cache
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-cache -a claude-code2Manually: put the files in place
~/.claude/skills/omni-cache/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/omni-cache/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-cache -a codex2Manually: put the files in place
.agents/skills/omni-cache/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-cache -a cursor2Manually: put the files in place
.cursor/skills/omni-cache/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute omni-cache2Manually: put the files in place
.github/skills/omni-cache/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-cache -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/omni-cacheManually: put the files in place
.devin/skills/omni-cache/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-cache -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set34
The whole set →Similar
Questions about omni-cache
How do I install omni-cache in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill omni-cache -a claude-code in your terminal. After installation, the skill is available at ~/.claude/skills/omni-cache/SKILL.md.
What does omni-cache do?
It manages your LLM response cache: displays usage statistics, clears entries, configures TTL policies, and adjusts semantic similarity thresholds to optimize performance.
Is authentication required?
Yes, all requests require a Bearer token obtained via POST /api/auth/login. For local development, set REQUIRE_API_KEY=false to disable the check.
Source text
SKILL.md · MIT
--- name: omni-cache description: Manage the LLM response cache. View cache statistics, clear entries, configure TTL policies, and control semantic-similarity caching thresholds. --- <!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten --> ## Overview Manage the LLM response cache. View cache statistics, clear entries, configure TTL policies, and control semantic-similarity caching thresholds. ## Authentication All requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development. ## Endpoints ### GET /api/cache Get cache statistics ```bash curl http://localhost:20128/api/cache \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### DELETE /api/cache Clear all caches ```bash curl -X DELETE http://localhost:20128/api/cache \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### GET /api/cache/stats Get detailed cache statistics Returns detailed statistics for all cache layers. ```bash curl http://localhost:20128/api/cache/stats \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### DELETE /api/cache/stats Clear cache statistics ```bash curl -X DELETE http://localhost:20128/api/cache/stats \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### GET /api/cache/entries GET cache › entries ```bash curl http://localhost:20128/api/cache/entries \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### DELETE /api/cache/entries DELETE cache › entries ```bash curl -X DELETE http://localhost:20128/api/cache/entries \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### GET /api/cache/reasoning GET cache › reasoning ```bash curl http://localhost:20128/api/cache/reasoning \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### DELETE /api/cache/reasoning DELETE cache › reasoning ```bash curl -X DELETE http://localhost:20128/api/cache/reasoning \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ## Payloads See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.
© cheaper-inference · MIT · cheaper-inference/OmniRoute