Clear Claude Docs Cache Command

Clear the docs-management search cache (inverted index). This forces the index to rebuild on the next documentation search.

When to Use

• After manually editing index.yaml
• When search results seem stale or incorrect
• After a git pull with documentation changes
• To free up disk space (~1.8 MB)

Arguments

• No arguments: Show what will be cleared and ask for confirmation
• --force: Skip confirmation and clear immediately

Step 1: Parse Arguments

Check if --force flag is present in $ARGUMENTS.

force_mode = "--force" in arguments (case-insensitive)

Step 2: Locate Cache Directory

The docs-management cache is located at:

~/.claude/plugins/cache/<marketplace>/claude-ecosystem/<version>/skills/docs-management/.cache/

Detection approach:

1. Find the installed claude-ecosystem plugin path from ~/.claude/plugins/installed_plugins.json
2. Navigate to skills/docs-management/.cache/

# Get the install path from installed_plugins.json
# Look for claude-ecosystem@* entry and extract installPath

Step 3: Check Cache Status

List the cache files and their sizes:

File	Purpose
inverted_index.json	Search index (~1.8 MB)
cache_version.json	Hash-based validity tracking

If cache directory doesn't exist or is empty, report: "Cache already clear. Nothing to do."

Step 4: Confirmation (unless --force)

If NOT force_mode, present the cache clear plan:

## Cache Clear Plan

**Target:** Claude Code documentation search index

| File | Size |
| --- | --- |
| inverted_index.json | X.X MB |
| cache_version.json | 512 bytes |

**Total:** X.X MB

> **Note:** The search index will rebuild automatically on the next documentation search.
> For immediate rebuild, run `/rebuild-claude-docs-index` after clearing.

**Proceed?** Reply "yes" to continue, or use `--force` to skip this confirmation.

Wait for user confirmation. If user does not confirm, abort with: "Cache clear cancelled."

Step 5: Clear Cache

Use the cache_manager.py script to clear the inverted index:

python "<install_path>/skills/docs-management/scripts/utils/cache_manager.py" --clear

Or manually delete the cache files:

rm -f "<cache_dir>/inverted_index.json"
rm -f "<cache_dir>/cache_version.json"

Step 6: Report Success

## Cache Cleared

Successfully cleared Claude Code documentation search cache.

**Cleared:**
- inverted_index.json (X.X MB)
- cache_version.json

**Next steps:**
- Search index will rebuild automatically on next search
- Or run `/rebuild-claude-docs-index` to rebuild immediately

Error Handling

• Cache not found: Report "Cache already clear or plugin not installed."
• Permission denied: Report "Permission denied. Try running with elevated privileges."
• Plugin not installed: Report "claude-ecosystem plugin not found. Install with /plugin install claude-ecosystem@<marketplace>"

Cross-Platform Notes

• Use forward slashes in paths for consistency
• Windows: ~ resolves to %USERPROFILE%
• The cache_manager.py script handles platform differences internally