List Documentation

Display all cached documentation from ~/.claude/docs including versions, sizes, update times, and associated skills.

Current Context

• Current working directory: !pwd

Your Task

When the user invokes this command, follow these steps:

1. Parse Arguments: The user provided: $ARGUMENTS
   • --project: Show only docs relevant to current project's package.json dependencies
   • --verbose: Show detailed information including page counts, sources, and full metadata
   • If no arguments: show default view (all cached docs)

1.5. INSTALL DEPENDENCIES: If ~/.claude/plugins/cache/doc-fetcher/node_modules doesn't exist then execute cd ~/.claude/plugins/cache/doc-fetcher && npm install after installation change the directory back to the project workspace root.

2. Run List Command:

   • Execute: node ~/.claude/plugins/cache/doc-fetcher/scripts/list-docs.js $ARGUMENTS
   • The script will scan ~/.claude/docs and display:
     • Library names and versions
     • Number of pages cached
     • Storage sizes
     • Last update times
     • Associated skills (if any)
   • Capture and display the output

3. Present Results:

   • Show the formatted output from the list command
   • If using --project flag:
     • Highlight which dependencies are cached and current
     • Identify missing or outdated documentation
     • Suggest fetch/update commands for missing/outdated docs
   • If using --verbose flag:
     • Show detailed metadata (source URLs, frameworks, page counts, local paths)

4. Provide Suggestions:

   • If docs are outdated: Suggest /update-docs [library]
   • If docs are missing for project dependencies: Suggest /fetch-docs [library]
   • If old versions exist: Mention cleanup options

5. Error Handling:

   • If cache directory doesn't exist: Inform user no docs are cached yet, suggest fetching docs
   • If cache directory is empty: Suggest using /fetch-docs to start caching documentation
   • If package.json not found (when using --project): Inform user and fall back to showing all cached docs
   • If script not found: Verify the doc-fetcher plugin is installed

Important Notes

• The script runs from the plugin directory: ~/.claude/plugins/cache/doc-fetcher/
• Documentation is cached globally in ~/.claude/docs and shared across all projects
• The list command is fast (reads index files only, doesn't scan page content)
• The cache directory is configured in doc-fetcher-config.json and defaults to ~/.claude/docs
• Use --project to see which of your current project's dependencies have cached documentation
• Use --verbose for complete details including source URLs and local paths