io.github.cocaxcode/ai-context-inspector
Scan, export, and import your AI ecosystem. Discover MCP servers, skills, and memories.
Ask AI about io.github.cocaxcode/ai-context-inspector
Powered by Claude Β· Grounded in docs
I know everything about io.github.cocaxcode/ai-context-inspector. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
@cocaxcode/ai-context-inspector
One command. Every AI config in your project. Instantly.
CLI + MCP server Β· 19 tools detected Β· Export/Import across 7 targets
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 directory
npx -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 tools
npx -y @cocaxcode/ai-context-inspector@latest --introspect
# Output raw JSON instead of HTML
npx -y @cocaxcode/ai-context-inspector@latest --json
All CLI flags
| Flag | Description | Default |
|---|---|---|
--dir <path> | Directory to scan | . (current) |
--user | Include user-level configs (~/) | false |
--introspect | Connect to MCP servers and list tools | false |
--timeout <ms> | Introspection timeout per server | 10000 |
--json | Output JSON instead of HTML | false |
--mcp | Run as MCP server (stdio transport) | false |
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"]
}
}
}
Cursor / Windsurf / VS Code / Codex CLI
Cursor / Windsurf β add to .cursor/mcp.json or equivalent:
{
"mcpServers": {
"ai-context-inspector": {
"command": "npx",
"args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
}
}
}
VS Code β add to .vscode/mcp.json:
{
"servers": {
"ai-context-inspector": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
}
}
}
Codex CLI:
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
| Tool | Context Files | What's Found |
|---|---|---|
| Claude Code | CLAUDE.md, .claude/, .mcp.json | Instructions, MCP config, skills, agents, memory |
| Cursor | .cursorrules, .cursor/rules/, .cursorignore | Rules, ignore patterns |
| Windsurf | .windsurfrules, .windsurf/rules/ | Codeium/Windsurf rules |
| GitHub Copilot | .github/copilot-instructions.md, .github/agents/ | Instructions, custom agents |
| Gemini CLI | GEMINI.md, .gemini/, .geminiignore | Config, rules |
| OpenAI Codex | AGENTS.md, AGENT.md, .codex/ | Agent instructions |
| OpenCode | OPENCODE.md, .opencode/, opencode.json | CLI config |
| Aider | .aider.conf.yml, .aiderignore | Config, model settings |
| Cline | .clinerules, .clineignore | Rules (file or directory) |
| Roo Code | .roo/rules/, .roorules, .rooignore | Rules |
| Continue.dev | .continuerules, .continue/config.yaml | Rules, config |
| Amazon Q | .amazonq/rules/ | Developer rules |
| Augment | .augment/rules/, .augment-guidelines | Code rules |
| Replit | .replit.md | Agent instructions |
| Firebase Studio | .idx/airules.md | AI rules |
| VS Code | .vscode/mcp.json | MCP configuration |
| Tabnine | .tabnine.yaml | AI config |
| Sourcegraph | .sourcegraph/ | Cody config |
| Universal | CONVENTIONS.md | Multi-tool conventions |
Tip: Pass
--userto 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 fromnpx 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@latest
npx -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.json
npx -y @cocaxcode/ai-context-inspector@latest export
# Export only MCP and context configs, redact secrets
npx -y @cocaxcode/ai-context-inspector@latest export --only mcp,context --secrets none
Export flags
| Flag | Description | Default |
|---|---|---|
--dir <path> | Directory to export | . |
--output <path> | Output directory | .aci/ |
--include-user | Include user-level configs | false |
--only <categories> | Filter: mcp,skills,agents,memories,context | all |
--secrets <mode> | none (redact) or all (include) | interactive |
Import
# Import into a Cursor project
npx -y @cocaxcode/ai-context-inspector@latest import --target cursor
# Auto-detect tool, skip confirmation, overwrite existing
npx -y @cocaxcode/ai-context-inspector@latest import --yes --force
Import flags
| Flag | Description | Default |
|---|---|---|
[file] | Path to bundle JSON | auto-detect .aci/bundle.json |
--dir <path> | Target directory | . |
--target <tool> | Target tool (see table) | auto-detect |
--scope <scope> | project or user | per-resource |
--force | Overwrite existing resources | false |
--yes | Skip confirmation prompt | false |
--only <categories> | Filter: mcp,skills,agents,memories,context | all |
--secrets <mode> | none or all | interactive |
Supported Import Targets
| Target | MCP Config | Context File | Rules Dir | Skills | Agents |
|---|---|---|---|---|---|
claude | .mcp.json | CLAUDE.md | -- | .claude/skills/ | .claude/agents/ |
cursor | .cursor/mcp.json | .cursorrules | .cursor/rules/ | -- | -- |
windsurf | .mcp.json | .windsurfrules | .windsurf/rules/ | -- | -- |
copilot | .vscode/mcp.json | .github/copilot-instructions.md | .github/instructions/ | -- | .github/agents/ |
gemini | .gemini/settings.json | GEMINI.md | .gemini/rules/ | -- | -- |
codex | .mcp.json | AGENTS.md | .codex/rules/ | -- | -- |
opencode | opencode.json | OPENCODE.md | .opencode/rules/ | -- | -- |
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
directory | string | No | Path to scan (default: cwd) |
include_user | boolean | No | Include user-level configs |
introspect | boolean | No | Live-connect to MCP servers |
timeout | number | No | Introspection timeout (ms) |
introspect_mcp
Connect to a specific MCP server and list its tools, resources, and prompts.
| Parameter | Type | Required | Description |
|---|---|---|---|
command | string | Yes* | Command to launch the server |
args | string[] | No | Arguments for the command |
env | object | No | Environment variables |
url | string | Yes* | URL for HTTP/SSE servers |
transport | string | No | stdio (default) or http |
timeout | number | No | Connection timeout (ms) |
*Either command (stdio) or url (http) is required.
generate_report
Generate a standalone HTML dashboard from scan results.
| Parameter | Type | Required | Description |
|---|---|---|---|
directory | string | No | Path to scan |
include_user | boolean | No | Include user-level configs |
introspect | boolean | No | Introspect MCP servers |
timeout | number | No | Introspection timeout (ms) |
export_ecosystem
Export the complete AI ecosystem to a portable .aci/bundle.json.
| Parameter | Type | Required | Description |
|---|---|---|---|
dir | string | No | Directory to scan (default: cwd) |
include_user | boolean | No | Include user-level configs |
only | string[] | No | Categories: mcp, skills, agents, memories, context |
secrets | string | No | "none" (default), "all", or ["VAR1", "VAR2"] |
import_ecosystem
Import a bundle into a project, adapting configuration to the target tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
file | string | No | Path to bundle (auto-detects .aci/bundle.json) |
dir | string | No | Target directory (default: cwd) |
target | string | No | Target tool (auto-detects): claude, cursor, windsurf, copilot, gemini, codex, opencode |
scope | string | No | project or user |
force | boolean | No | Overwrite existing resources |
confirm | boolean | No | Execute import (default: false = dry-run) |
only | string[] | No | Categories to import |
secrets | string | No | "none", "all", ["VAR1"], or {"VAR1": "value"} |
Warning:
import_ecosystemdefaults to dry-run mode (confirm: false). Setconfirm: trueto 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
