repo-mapify

A command-line tool that generates a repomap of your codebase, designed specifically for enhancing AI-assisted development workflows where context limits are important.

⚠️ Beta Status: This tool is currently in beta. While functional, you may encounter bugs or incomplete features.

Installation

There are two ways to install repo-mapify:

1. Download Pre-built Binary (Recommended)

Pre-built binary releases for Ubuntu and macOS are available on our releases page.

2. Build from Source

For instructions on building from source, see our Development Guide.

Usage

Basic usage:

repo-mapify > repomap.txt

Scan specific paths:

repo-mapify path/to/scan1 path/to/scan2

For large repositories, you can run it from any subfolder to scan just that portion:

cd path/to/subfolder
repo-mapify

Options

-f, --filetype   Filter by file type (rb, js, vue, go, rs, yaml)
-v, --verbose     Verbosity level (0=minimal, 1=normal, 2=detailed) [default: 1]
-h, --help                 Print help

Supported Languages

Ruby

Methods, class methods, modules

JavaScript

Functions, arrow functions, classes, object methods

Vue.js

Methods, computed properties, components

Go

Functions, methods, interfaces

Rust

Functions, implementations, traits

Yaml

Definitions, values, templates

Bug Hunting with Claude

To effectively use repo-mapify with Claude for debugging:

  1. Copy the repository map and contents of your bug report into your Claude chat session
  2. Ask Claude which files from the repomap it needs to see to identify the bug
    • This helps focus the investigation on relevant code
    • Keeps the chat context focused and efficient
  3. Add the identified files to the Claude chat and ask it to:
    • Identify the root cause of the bug
    • Provide a solution with proper code changes

Development

For development instructions, including how to build from source and create releases, see our Development Guide.

License

MIT License