io.github.cocaxcode/ai-context-inspector

Scan, export, and import your AI ecosystem. Discover MCP servers, skills, and memories.
Open source Open in the app JSON README (API)
About

Scan, export, and import your AI ecosystem. Discover MCP servers, skills, and memories.
Details

Kind: MCP servers
Topic: No topic detected
Publisher: cocaxcode
Origin: official
Category: ferramentas
Transport: local
Version: 0.4.9
Stars: 1
Last push: 2026-03-29T23:42:24Z
Repository state: ativo
Language: TypeScript
License: MIT
Added: 2026-08-29 03:02:35
Updated: 2026-08-29 03:02:35
Origin id: io.github.cocaxcode/ai-context-inspector
README

<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 &middot; 19 tools detected &middot; 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> &middot;
  <a href="#mcp-server-setup">MCP Server</a> &middot;
  <a href="#what-it-detects">What It Detects</a> &middot;
  <a href="#features">Features</a> &middot;
  <a href="#mcp-tool-reference">Tool Reference</a> &middot;
  <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.**

---

## Quick Start

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

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

```bash
# 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>

---

## MCP Server Setup

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

### Claude Code

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

### Claude Desktop

Add to `claude_desktop_config.json`:

```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:

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

**VS Code** — add to `.vscode/mcp.json`:

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

**Codex CLI:**

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

</details>

Or add directly to any `.mcp.json`:

```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 `--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

```bash
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

```bash
# 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

```bash
# 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>

### 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_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](./LICENSE) · Built by [cocaxcode](https://github.com/cocaxcode)
io.github.cocaxcode/ai-context-inspector

About

Details

README

More
