Project Maps List Command

List all projects with generated context maps.

Usage

/project-maps-list

Implementation

Step 1: Scan Maps Directory

List all subdirectories in the maps storage:

ls -d ~/.claude/project-maps/*/ 2>/dev/null

Each subdirectory represents a project hash.

Step 2: Load Summary for Each Project

For each project hash, load the summary.json to get project details:

const fs = require('fs').promises;
const path = require('path');
const MapLoader = require('./map-loader');

const mapsBaseDir = path.join(process.env.HOME, '.claude/project-maps');
const projectDirs = await fs.readdir(mapsBaseDir);

for (const hash of projectDirs) {
  if (hash === 'maps' || hash === 'schemas' || hash === 'temp') continue;

  try {
    const summaryPath = path.join(mapsBaseDir, hash, 'summary.json');
    const summary = await loadSummary(summaryPath);
    // Display project info
  } catch (error) {
    // Skip invalid projects
  }
}

Step 3: Display Projects List

Show all projects with their metadata:

Project Maps

Found {count} projects with generated maps:

1. {project_name}
   Path: {project_path}
   Hash: {project_hash}
   Files: {file_count}
   Generated: {timestamp}
   Staleness: {score}/100 ({level})
   Size: {total_size}

2. {project_name}
   Path: {project_path}
   Hash: {project_hash}
   Files: {file_count}
   Generated: {timestamp}
   Staleness: {score}/100 ({level})
   Size: {total_size}

Total storage: {total_storage_size}

Commands:
  • Load project: /project-maps-load
  • Refresh: /project-maps-refresh
  • Generate new: /project-maps-generate

Step 4: Highlight Stale Projects

Mark projects that need refresh:

⚠️  The following projects may need refresh:
  • {project_name} - Staleness: {score}/100
  • {project_name} - Staleness: {score}/100

Run: /project-maps-refresh to update

Error Handling

No maps found:

No project maps found

Storage location: ~/.claude/project-maps/

Generate maps for current project:
  /project-maps-generate

Corrupt project data:

⚠️  Found {count} projects, but {error_count} have corrupt data:
  • {hash} - Cannot read summary
  • {hash} - Missing metadata

Consider removing corrupt entries:
  rm -rf ~/.claude/project-maps/{hash}

Examples

# List all projects with maps
/project-maps-list

2.4 KiB Raw Blame History