Clear Cursor Docs Cache Command

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

When to Use

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

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 cursor-docs cache is located at:

${CLAUDE_PLUGIN_ROOT}/skills/cursor-docs/.cache/

Or via installed path:

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

Step 3: Check Cache Status

List the cache files:

File	Purpose
inverted_index.json	Search index
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:** Cursor 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-cursor-docs-index` after clearing.

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

Step 5: Clear Cache

Use the clear_cache.py script to clear:

python "${CLAUDE_PLUGIN_ROOT}/skills/cursor-docs/scripts/maintenance/clear_cache.py"

Step 6: Report Success

## Cache Cleared

Successfully cleared Cursor documentation search cache.

**Cleared:**
- inverted_index.json
- cache_version.json

**Next steps:**
- Search index will rebuild automatically on next search
- Or run `/rebuild-cursor-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 "cursor-ecosystem plugin not found."