Skip to main content
plugin CX Codex

codebase-recon — Claude Code plugin: Git history analysis

The codebase-recon plugin reads a repository’s Git history to map the project before you inspect its code. Use it to spot risky files, knowledge concentration, and shifts in team activity.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codebase-recon@awesome-codex-plugins
Open on GitHub

What codebase-recon does

The plugin first gauges repository size, then examines seven areas in parallel: frequently changed files, bug fixes, knowledge concentration, team momentum, emergency fixes and reverts, recently added files, and active contributors. It cross-checks change hotspots against files that attract bug fixes to flag areas of higher risk.

The report includes recommendations based on its findings. It needs git and a repository with commit history; without that history, there is nothing to analyze. Run /codebase-recon when you’re orienting yourself in an unfamiliar codebase.

What it helps with

  • find files that change frequently
  • spot files that attract repeated bug fixes
  • see whether project knowledge is concentrated among contributors
  • check development momentum and emergency-fix activity
  • identify higher-risk files from Git history

Example prompts for the agent

  • Analyze this repository’s Git history and flag higher-risk files: /codebase-recon.
  • Before I inspect the code, show how the project has changed and who is active: /codebase-recon.
  • Check where project knowledge is concentrated and how often emergency fixes happen: /codebase-recon.

How to install codebase-recon

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codebase-recon@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about codebase-recon

How do I install codebase-recon in Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install codebase-recon@awesome-codex-plugins. Open the plugin browser with /plugin.

What does codebase-recon do?

It examines Git history across seven areas, compares change hotspots with files that draw bug fixes, and reports findings with recommendations.

What does codebase-recon need to run?

It requires git and a repository with commit history.

Source text

codebase-recon-skill · MIT
# codebase-recon-skill

A coding agent skill that analyzes git history to understand a codebase before reading any code. Reveals project health, risk areas, team structure, and development momentum.

Inspired by ["The Git Commands I Run Before Reading Any Code"](https://piechowski.io/post/git-commands-before-reading-code/) by [Ally Piechowski](https://github.com/grepsedawk).

## Installation

### Via skills.sh (works with 20+ coding agents)

```sh
npx skills add yujiachen-y/codebase-recon-skill
```

Works with Claude Code, Cline, Cursor, GitHub Copilot, Gemini CLI, and any agent supporting the [Agent Skills Specification](https://agentskills.io/specification).

### Via Claude Code plugin system

```
/plugin marketplace add yujiachen-y/codebase-recon-skill
```

Then install the plugin from the marketplace browser via `/plugin`.

### Via Codex plugin system

```sh
codex plugin marketplace add yujiachen-y/codebase-recon-skill
```

Then run `/plugins` in Codex, choose the `Codebase Recon` marketplace, and install `codebase-recon`.

## Usage

In your coding agent, invoke:

```
/codebase-recon
```

The skill will:
1. **Probe** the repo to determine its scale (small / medium / large)
2. **Analyze** 7 dimensions in parallel: code hotspots, bus factor, bug magnets, team momentum, firefighting frequency, recently added files, and active contributors
3. **Cross-reference** hotspots with bug magnets to identify high-risk files
4. **Report** findings with actionable recommendations

## What You'll Learn

| Dimension | Question Answered |
|-----------|-------------------|
| Code Hotspots | Which files change the most? |
| Bug Magnets | Which files attract the most bug fixes? |
| High-Risk Files | Which files are both hot AND buggy? |
| Bus Factor | Who knows what? Is knowledge concentrated? |
| Team Momentum | Is development accelerating, stable, or declining? |
| Firefighting | How often are there emergency fixes and reverts? |
| Recently Added | Where is active development happening? |

## Requirements

- `git` (any version)
- A git repository with commit history

## Attribution

This skill is inspired by ["The Git Commands I Run Before Reading Any Code"](https://piechowski.io/post/git-commands-before-reading-code/) by [Ally Piechowski](https://github.com/grepsedawk). The original article describes 5 git commands for codebase reconnaissance. This skill extends the concept with auto-scaling, cross-referencing, and actionable recommendations.

## License

[MIT](LICENSE)

© Jiachen Yu · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Git and GitHub →

From the same set391

The whole set →
codex-auto-resume codex-auto-resume monitors Codex usage limits on Windows, waits for the reset time, and automatically resumes the exact same conversation via codex queue. Built for overnight tasks. CX Codex ★ 1,596repo stars codex-agents-workflow codex-agents-workflow is a Claude Code plugin for building and running reusable agent workflows. It supports workflow setup with configurable roles and providers, plus recoverable runs. CX Codex ★ 1,596repo stars ateam ateam turns Claude into a six-role team: researcher, PM, architect, dev, QA and reviewer, joined into a configurable pipeline. CX Codex ★ 1,596repo stars codetruss The codetruss plugin for Claude Code and Codex sets agent file boundaries, runs local analyzers on code changes, and creates signed review receipts. CX Codex ★ 1,596repo stars clueless clueless is a plugin for Claude Code that makes the agent act as if nobody will review its work. It puts irreversible steps first and includes one check when you can't judge the result yourself. CX Codex ★ 1,596repo stars click click runs incremental test verification for Claude Code and Codex. Skips untouched checks, reruns affected code, and returns one-line receipts instead of full logs. CX Codex ★ 1,596repo stars clean-room clean-room separates authorized source analysis from clean implementation work. Use it to create behavioral specifications without carrying source material into destination code. CX Codex ★ 1,596repo stars claudemon claudemon turns your Claude agents into pixel creatures you can watch work in your files, with a one-click .io brawler called Clawland for breaks. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open