Repoprompt

parcadei/repoprompt

Use RepoPrompt CLI for token-efficient codebase exploration

1k tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

3880

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/parcadei/Continuous-Claude-v3 --skill repoprompt

The instruction itself

20 sections, as written by the author

RepoPrompt Skill

When to Use

Explore codebase structure (tree, codemaps)
Search code with context lines
Get code signatures without full file content (token-efficient)
Read file slices (specific line ranges)
Build context for tasks

Token Optimization

RepoPrompt is more token-efficient than raw file reads:

structure → signatures only (not full content)
read --start-line --limit → slices instead of full files
search --context-lines → relevant matches with context

CLI Usage

# If installed to PATH (Settings → MCP Server → Install CLI to PATH)
rp-cli -e 'command'

# Or use the alias (configure in your shell)
repoprompt_cli -e 'command'

Commands Reference

File Tree

# Full tree
rp-cli -e 'tree'

# Folders only
rp-cli -e 'tree --mode folders'

# Selected files only
rp-cli -e 'tree --mode selected'

Code Structure (Codemaps) - TOKEN EFFICIENT

# Structure of specific paths
rp-cli -e 'structure src/auth/'

# Structure of selected files
rp-cli -e 'structure --scope selected'

# Limit results
rp-cli -e 'structure src/ --max-results 10'

Search

# Basic search
rp-cli -e 'search "pattern"'

# With context lines
rp-cli -e 'search "error" --context-lines 3'

# Filter by extension
rp-cli -e 'search "TODO" --extensions .ts,.tsx'

# Limit results
rp-cli -e 'search "function" --max-results 20'

Read Files - TOKEN EFFICIENT

# Full file
rp-cli -e 'read path/to/file.ts'

# Line range (slice)
rp-cli -e 'read path/to/file.ts --start-line 50 --limit 30'

# Last N lines (tail)
rp-cli -e 'read path/to/file.ts --start-line -20'

Selection Management

# Add files to selection
rp-cli -e 'select add src/auth/'

# Set selection (replace)
rp-cli -e 'select set src/api/ src/types/'

# Clear selection
rp-cli -e 'select clear'

# View current selection
rp-cli -e 'select get'

Workspace Context

# Get full context
rp-cli -e 'context'

# Specific includes
rp-cli -e 'context --include prompt,selection,tree'

Chain Commands

# Multiple operations
rp-cli -e 'select set src/auth/ && structure --scope selected && context'

Workspaces

# List workspaces
rp-cli -e 'workspace list'

# List tabs
rp-cli -e 'workspace tabs'

# Switch workspace
rp-cli -e 'workspace switch "ProjectName"'

AI Chat (uses RepoPrompt's models)

# Send to chat
rp-cli -e 'chat "How does the auth system work?"'

# Plan mode
rp-cli -e 'chat "Design a new feature" --mode plan'

Context Builder (AI-powered file selection)

# Auto-select relevant files for a task
rp-cli -e 'builder "implement user authentication"'

Workflow Shorthand Flags

# Quick operations without -e syntax
rp-cli --workspace MyProject --select-set src/ --export-context ~/out.md
rp-cli --chat "How does auth work?"
rp-cli --builder "implement user authentication"

Script Files (.rp)

For repeatable workflows, save commands to a script:

# daily-export.rp
workspace switch Frontend
select set src/components/
context --all > ~/exports/frontend.md

Run with:

rp-cli --exec-file ~/scripts/daily-export.rp

CLI Flags

| Flag | Purpose |

|------|---------|

| -e 'cmd' | Execute command(s) |

| -w <id> | Target window ID |

| -q | Quiet mode |

| -d <cmd> | Detailed help for command |

| --wait-for-server 5 | Wait for connection (scripts) |

Async Operations (tmux)

For long-running operations like builder, use the async script:

# Start context builder async
uv run python -m runtime.harness scripts/repoprompt_async.py \
    --action start --task "understand the auth system"

# With workspace switch
uv run python -m runtime.harness scripts/repoprompt_async.py \
    --action start --workspace "MyProject" --task "explore API patterns"

# Check status
uv run python -m runtime.harness scripts/repoprompt_async.py --action status

# Get result when done
uv run python -m runtime.harness scripts/repoprompt_async.py --action result

# Kill if needed
uv run python -m runtime.harness scripts/repoprompt_async.py --action kill

Note

Requires RepoPrompt app running with MCP Server enabled.

How to use it

Copy the folder

Take parcadei/repoprompt from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.