# Codebase Navigator

> Rapidly understand any codebase: identify entry points, map architecture, find key patterns, summarize modules, trace data flow.

- **Type:** Skill
- **Install:** `agentstack add skill-jansenanalytics-claudex-codebase-navigator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [JansenAnalytics](https://agentstack.voostack.com/s/jansenanalytics)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [JansenAnalytics](https://github.com/JansenAnalytics)
- **Source:** https://github.com/JansenAnalytics/claudex/tree/main/skills/codebase-navigator

## Install

```sh
agentstack add skill-jansenanalytics-claudex-codebase-navigator
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# codebase-navigator

Rapidly understand any codebase: identify entry points, map architecture, find key patterns, summarize modules, trace data flow.

## When to Use

- Onboarding to a new project
- Understanding unfamiliar code
- Finding where functionality lives
- Mapping dependencies between modules
- Creating architectural overviews

## Scripts

### codebase-scan.sh

Quick codebase overview — detects languages, frameworks, entry points, file counts.

```bash
bash scripts/codebase-scan.sh /path/to/project
bash scripts/codebase-scan.sh .
```

**Output:** Markdown summary with languages, frameworks, entry points, directory structure, LOC counts.

### module-map.py

Build a module/import dependency map.

```bash
python3 scripts/module-map.py --dir src/
python3 scripts/module-map.py --dir src/ --format mermaid
python3 scripts/module-map.py --dir lib/ --format json
```

**Arguments:**

- `--dir ` — Directory to scan (default: `.`)
- `--format tree|mermaid|json` — Output format (default: tree)

Identifies: core modules (most imported), leaf modules, circular dependencies.

### trace-flow.sh

Trace a function/symbol through the codebase.

```bash
bash scripts/trace-flow.sh --symbol "handlePayment" --dir src/
bash scripts/trace-flow.sh --symbol "UserService" --depth 3
```

**Arguments:**

- `--symbol ` — Function/class/string to trace (required)
- `--dir ` — Directory to search (default: `.`)
- `--depth ` — Call chain depth (default: 2)

Uses `rg` (ripgrep) for fast searching.

## References

- `codebase-patterns.md` — Common project structures and how to identify them

## Requirements

- `rg` (ripgrep) — For fast code searching
- `python3` — For module-map.py

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [JansenAnalytics](https://github.com/JansenAnalytics)
- **Source:** [JansenAnalytics/claudex](https://github.com/JansenAnalytics/claudex)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jansenanalytics-claudex-codebase-navigator
- Seller: https://agentstack.voostack.com/s/jansenanalytics
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.