codebase-ripper

Generate and execute safe shell commands to explore codebases in parallel.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Graffioh/dotfiles --skill codebase-ripper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-ripper
Source: https://github.com/Graffioh/dotfiles/tree/main/pi/agent/skills/codebase-ripper
Command: npx skills add https://github.com/Graffioh/dotfiles --skill codebase-ripper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables rapid, iterative exploration of a codebase by generating and executing a large suite of safe shell commands to build a comprehensive context, reducing manual inspection time.

Core Features & Use Cases

  • Iterative command discovery: Generates broad command sets per iteration to map project structure, dependencies, and patterns.
  • Parallel execution & extraction: Runs vetted commands in parallel and extracts relevant context for downstream analysis.
  • Pre-coding context for safety: Ideal before writing code, before adding tests, or when exploring unfamiliar repositories, across languages.

Quick Start

Run the codebase ripper against a project with a task such as "Map the authentication flow" using the tool's run script: ~/.pi/agent/skills/codebase-ripper/run.sh "Map the authentication flow" -d /path/to/project

Frequently Asked Questions about codebase-ripper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I quickly map an unfamiliar codebase before writing new features?

Automating codebase exploration involves generating and executing a broad set of safe shell commands to collect contextual signals. It maps project structure and dependencies across iterative passes, reducing manual inspection time when onboarding to unfamiliar repositories.

Does automated codebase exploration work for auditing patterns across different languages?

Automated codebase exploration works across languages by enforcing a strict allowlist of safe commands. It runs vetted tasks in parallel to extract relevant context, making it ideal for auditing patterns before implementing features or tests in diverse repositories.

Can I limit shell command execution during codebase exploration to control token usage?

You can limit shell command execution during codebase exploration by configuring max-iterations and token-budget parameters. These settings control iterative passes, ensuring the extraction of structured context remains within your defined processing limits.

What is the best way to gather pre-coding context safely without breaking the repository?

The best way to gather pre-coding context safely is by using an automated tool that enforces a strict allowlist of shell commands. This ensures only vetted, safe commands run in parallel to extract context without risking repository integrity.

How do I run parallel commands to extract context from a specific project directory?

To run parallel commands for context extraction, execute the tool's run script with your target project directory path. The script generates a broad command set, executing vetted tasks in parallel to map the codebase structure efficiently.