export-project — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited export-project (MCP Server) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<p align="center"> <h1 align="center">@cocaxcode/ai-context-inspector</h1> <p align="center"> <strong>One command. Every AI config in your project. Instantly.</strong><br/> CLI + MCP server · 19 tools detected · Export/Import across 7 targets </p> </p>
<p align="center"> <a href="https://www.npmjs.com/package/@cocaxcode/ai-context-inspector"><img src="https://img.shields.io/npm/v/@cocaxcode/ai-context-inspector.svg?style=flat-square&color=cb3837" alt="npm version" /></a> <a href="https://www.npmjs.com/package/@cocaxcode/ai-context-inspector"><img src="https://img.shields.io/npm/dm/@cocaxcode/ai-context-inspector.svg?style=flat-square" alt="npm downloads" /></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="License" /></a> <img src="https://img.shields.io/badge/node-%3E%3D20-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node" /> <img src="https://img.shields.io/badge/AI%20tools-19%20supported-blueviolet?style=flat-square" alt="19 AI tools" /> </p>
<p align="center"> <a href="#quick-start">Quick Start</a> · <a href="#mcp-server-setup">MCP Server</a> · <a href="#what-it-detects">What It Detects</a> · <a href="#features">Features</a> · <a href="#mcp-tool-reference">Tool Reference</a> · <a href="#architecture">Architecture</a> </p>
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.
npx -y @cocaxcode/ai-context-inspector@latestThat'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<details> <summary>All CLI flags</summary>
| 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 |
</details>
Run as an MCP server so your AI tools can inspect their own ecosystem.
claude mcp add --scope user ai-context-inspector -- npx -y @cocaxcode/ai-context-inspector@latest --mcpAdd to claude_desktop_config.json:
{
"mcpServers": {
"ai-context-inspector": {
"command": "npx",
"args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
}
}
}<details> <summary>Cursor / Windsurf / VS Code / Codex CLI</summary>
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</details>
Or add directly to any .mcp.json:
{
"mcpServers": {
"ai-context-inspector": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
}
}
}| 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.json, ~/.claude.json, .vscode/mcp.json, Claude Desktop config — with optional live introspection.claude/skills/ (including symlinks from npx skills add).claude/agents/ with memory detectionnpx -y @cocaxcode/ai-context-inspector@latest
npx -y @cocaxcode/ai-context-inspector@latest --user --introspectGenerates 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 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<details> <summary>Export flags</summary>
| 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 |
</details>
# 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<details> <summary>Import flags</summary>
| 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 |
</details>
| 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.
When running as an MCP server (--mcp), five tools are exposed:
scanDiscover 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_mcpConnect 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_reportGenerate 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_ecosystemExport 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_ecosystemImport 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.
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.tsStack: TypeScript 5 (strict, ESM) / MCP SDK / Zod / tsup / Vitest
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.