Ai Context Inspector

@cocaxcode/ai-context-inspector

One command. Every AI config in your project. Instantly.
CLI + MCP server · 19 tools detected · Export/Import across 7 targets

[npm version] [npm downloads] [License] [Node] [19 AI tools]

Quick Start · MCP Server · What It Detects · Features · Tool Reference · Architecture

The most comprehensive AI ecosystem scanner available. AI Context Inspector discovers every AI configuration file, MCP server, custom skill, agent, and persistent memory in your project — across 19 tools — and gives you the full picture in seconds. Export your entire AI setup and import it into any of 7 supported tools (Claude, Cursor, Windsurf, Copilot, Gemini, Codex, OpenCode) with automatic secret redaction. Zero config. Zero runtime dependencies beyond MCP SDK and Zod. Everything runs locally — your configs and credentials never leave your machine.

Quick Start

npx -y @cocaxcode/ai-context-inspector@latest

That's it. An HTML dashboard opens with everything your AI tools know about your project.

# Scan a specific directorynpx -y @cocaxcode/ai-context-inspector@latest --dir /path/to/project
# Include user-level configs (~/.claude, ~/.gemini, etc.)npx -y @cocaxcode/ai-context-inspector@latest --user
# Live-connect to each MCP server and list its toolsnpx -y @cocaxcode/ai-context-inspector@latest --introspect
# Output raw JSON instead of HTMLnpx -y @cocaxcode/ai-context-inspector@latest --json

MCP Server Setup

Run as an MCP server so your AI tools can inspect their own ecosystem.

Claude Code

claude mcp add --scope user ai-context-inspector -- npx -y @cocaxcode/ai-context-inspector@latest --mcp

Claude Desktop

Add to claude_desktop_config.json:

{  "mcpServers": {    "ai-context-inspector": {      "command": "npx",      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]    }  }}

{  "mcpServers": {    "ai-context-inspector": {      "command": "npx",      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]    }  }}

{  "servers": {    "ai-context-inspector": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]    }  }}

codex mcp add ai-context-inspector -- npx -y @cocaxcode/ai-context-inspector@latest --mcp

Or add directly to any .mcp.json:

{  "mcpServers": {    "ai-context-inspector": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]    }  }}

What It Detects

Tip: Pass --user to also scan user-level configs: ~/.claude/, ~/.gemini/, ~/.codex/, ~/.continue/, ~/.aider.conf.yml, ~/.augment/, ~/.github/agents/, ~/.codeium/, ~/.opencode/, ~/.tabnine/.

Beyond context files, the scanner also detects:

• MCP servers from .mcp.json, ~/.claude.json, .vscode/mcp.json, Claude Desktop config — with optional live introspection
• Custom skills in .claude/skills/ (including symlinks from npx skills add)
• Custom agents in .claude/agents/ with memory detection
• Persistent memories — Claude Memory, agent memory, engram, OpenSpec, ATL

Features

Scan

npx -y @cocaxcode/ai-context-inspector@latestnpx -y @cocaxcode/ai-context-inspector@latest --user --introspect

Generates a self-contained HTML dashboard with dark/light mode, search, collapsible sections, file previews, and color-coded tool badges. Pass --json for raw output.

Export

# Export your AI ecosystem to .aci/bundle.jsonnpx -y @cocaxcode/ai-context-inspector@latest export
# Export only MCP and context configs, redact secretsnpx -y @cocaxcode/ai-context-inspector@latest export --only mcp,context --secrets none

Import

# Import into a Cursor projectnpx -y @cocaxcode/ai-context-inspector@latest import --target cursor
# Auto-detect tool, skip confirmation, overwrite existingnpx -y @cocaxcode/ai-context-inspector@latest import --yes --force

Supported Import Targets

Note: Secrets handling has three modes: none (redact all — safe for sharing), all (include as-is), or interactive (prompt per variable, CLI default). Environment variables in MCP configs are detected automatically.

MCP Tool Reference

When running as an MCP server (--mcp), five tools are exposed:

scan

Discover the complete AI ecosystem in a project directory.

introspect_mcp

Connect to a specific MCP server and list its tools, resources, and prompts.

*Either command (stdio) or url (http) is required.

generate_report

Generate a standalone HTML dashboard from scan results.

export_ecosystem

Export the complete AI ecosystem to a portable .aci/bundle.json.

import_ecosystem

Import a bundle into a project, adapting configuration to the target tool.

Warning: import_ecosystem defaults to dry-run mode (confirm: false). Set confirm: true to actually write files.

Architecture

src/├── index.ts              # Entry: CLI vs MCP mode routing├── cli.ts                # CLI arg parsing + orchestration├── server.ts             # createServer() MCP factory├── scanner/              # 6 parallel scanners (Promise.all)│   ├── catalog.ts        # AI_FILE_CATALOG — 50+ entries, 19 tools│   ├── context-files.ts  # Scan .md, rules, configs│   ├── mcp-configs.ts    # Parse .mcp.json, ~/.claude.json, etc.│   ├── mcp-introspect.ts # Connect to servers, list tools/resources│   ├── skills.ts         # Skills + symlinks + frontmatter│   ├── agents.ts         # Agents + memory detection│   └── memories.ts       # engram, openspec, .atl, claude memory├── ecosystem/            # Export/import engine│   ├── export.ts         # Scan → bundle → .aci/bundle.json│   ├── import.ts         # Load → plan → execute│   ├── target-map.ts     # Path configs for 7 AI tools│   ├── detect-target.ts  # Auto-detect tool in project│   └── secrets.ts        # Env var detection + redaction├── report/               # HTML dashboard generator│   ├── generator.ts      # generateHtml(ScanResult) → string│   ├── sections.ts       # Section renderers│   ├── styles.ts         # CSS (dark/light)│   └── scripts.ts        # JS (collapse, search, preview)└── tools/                # 5 MCP tool handlers    ├── scan.ts    ├── introspect.ts    ├── report.ts    ├── export.ts    └── import.ts

Stack: TypeScript 5 (strict, ESM) / MCP SDK / Zod / tsup / Vitest

MIT · Built by cocaxcode