Scalpel — Surgical AI for Your Codebase

12-dimension diagnostic. Adaptive surgical teams. Zero side effects.

Installation

# Claude Code
git clone https://github.com/anupmaster/scalpel.git ~/.claude/skills/scalpel

# Codex CLI
git clone https://github.com/anupmaster/scalpel.git ~/.agents/skills/scalpel

# Any project (pendrive style)
cd your-project && git clone https://github.com/anupmaster/scalpel.git .scalpel && .scalpel/install.sh

Usage

> Hi Scalpel, start work
> scalpel scan              # Diagnostic only, no changes
> scalpel skip recon        # Jump to task execution

Standalone Scanner (Zero AI)

./src/scanner.sh                # Pretty terminal output
./src/scanner.sh --json         # Machine-readable
./src/scanner.sh --score-only   # Just the number: "83"

What It Does

Diagnose — Scans 12 dimensions: stack, architecture, git forensics, database, auth, infrastructure, tests, security, integrations, agent ecosystem, code quality, performance
Consult — Delivers Codebase Vitals health score, asks targeted questions
Assemble — Designs a custom surgical team calibrated to YOUR project
Operate — Spawns parallel agents in isolated worktrees with file jurisdiction
Close — Delivery report, session memory saved, optional regression monitoring

Features

Standalone scanner — Pure bash, zero AI, zero tokens. Runs anywhere.
12-dimension diagnostic — Deeper than any linter. Reads git history, deleted files, abandoned branches.
Adaptive teams — Not templates. Teams shaped by YOUR project's needs.
File jurisdiction — Each agent owns specific files. Zero merge conflicts.
Agent scoring — Quality enforcement. Score < 50 = agent terminated.
Session memory — Remembers previous sessions. Gets smarter over time.
Pendrive architecture — Plug in, work, unplug. Zero trace.
7 agent adapters — Claude Code, Codex, Gemini, Cursor, Windsurf, Aider, OpenCode.
GitHub Action — Automated PR health checks.
Extensible config — Custom scan dimensions, team roles, scoring rules.

Permissions

Read-only during diagnostic. Write access only during surgical team operation. Never modifies your existing CLAUDE.md, agents, commands, or settings. Never commits itself to your git history. Uninstall leaves zero trace.

scalpel