RePortal

Jump between repos. Open in your editor. Stay in sync across machines.

---

RePortal is a single-binary CLI that keeps a registry of your dev repos and lets you fuzzy-jump between them, open them in your editor, and clone missing repos on a new machine.

Install

All methods install both reportal and rep (short alias) binaries.

Cargo (all platforms)

cargo install reportal

Homebrew (macOS / Linux)

brew tap CheckPickerUpper/tap
brew install reportal

Scoop (Windows)

scoop bucket add reportal https://github.com/CheckPickerUpper/scoop-reportal
scoop install reportal

Winget (Windows)

winget install CheckPickerUpper.RePortal

Shell installer (macOS / Linux)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/CheckPickerUpper/reportal/releases/latest/download/reportal-installer.sh | sh

PowerShell installer (Windows)

powershell -ExecutionPolicy Bypass -c "irm https://github.com/CheckPickerUpper/reportal/releases/latest/download/reportal-installer.ps1 | iex"

From source

git clone https://github.com/CheckPickerUpper/reportal.git
cd reportal
cargo install --path .

Quick start

# Set up config + shell shortcuts (rj, ro)
rep init

# Register a local repo
rep add ~/dev/my-project

# Clone and register from a URL
rep add https://github.com/org/repo.git

# List all registered repos
rep list

# Jump to a repo (cd)
rj

# Open a repo in your editor
ro

Commands

Command	Alias	What it does
rep init		Creates config and installs shell integration (safe to re-run on updates)
rep list	rep l	Shows all repos with path, description, tags, and whether it exists on disk
rep list --tag work		Filters repos by tag
rep jump	rep j	Fuzzy-select a repo, prints the path (used by rj shell function)
rep jump my-api	rep j my-api	Jump directly to a repo by alias (also matches aliases field)
rep jump --title "Debug"		Override the terminal tab title for this session
rep open	rep o	Fuzzy-select a repo, opens it in your editor
rep open my-api	rep o my-api	Opens a repo directly by alias
rep open --editor code		Override the default editor
rep open --title "Debug"		Override the terminal tab title for this session
rep color		Emit tab title + background color for current directory (for shell hooks)
rep color --repo my-api		Emit tab title + background color for a specific repo
rep status	rep s	Show git status (branch, dirty, upstream, last commit) across all repos
rep status --tag work		Filter status by tag
rep sync		Pull latest changes across all repos (skips dirty repos)
rep sync --tag work		Pull only repos with this tag
rep edit my-api	rep e my-api	Interactively edit a repo's description, tags, title, and color
rep add ~/dev/foo	rep a ~/dev/foo	Register a local repo (auto-detects git remote, suggests alias)
rep add https://github.com/org/repo.git		Clone a repo and register it (asks where to place it)
rep remove my-api	rep rm my-api	Unregister a repo (does not delete files)
rep ai		Fuzzy-select a repo and launch the default AI coding CLI in it
rep web	rep w	Fuzzy-select a repo and open its remote URL in the browser
rep web my-api	rep w my-api	Open a repo's remote directly by alias
rep ai my-api		Launch default AI tool directly in a repo by alias
rep ai --tool codex		Launch a specific AI tool (overrides default)
rep ai my-api --tool codex		Specific repo + specific tool
rep run	rep r	Fuzzy-select a repo and a configured command, then run it
rep run my-api	rep r my-api	Skip repo selection, fuzzy-select a command to run
rep run --cmd test		Skip command selection, fuzzy-select a repo to run "test" in
rep run my-api --cmd test		Run "test" directly in my-api (no fuzzy menus)
rep doctor		Diagnose config, shell integration, and repo path issues

Shell integration

rep init writes a standalone integration script to ~/.reportal/integration.ps1 (or .sh) and adds a single source line to your shell profile. The profile line never changes between versions; updating the binary is all you need.

Shortcut	What it does
rj	Fuzzy-select a repo and cd into it
rj my-api	Jump directly to a repo by alias
ro	Fuzzy-select a repo and open it in your editor
ro my-api	Open a repo directly by alias
rw	Fuzzy-select a repo and open it in the browser
rw my-api	Open a repo's remote directly by alias
rr	Fuzzy-select a repo and run a configured command in it
rr my-api	Skip repo selection, fuzzy-select a command

Supports PowerShell, Bash, Zsh. Detected and installed during rep init. Re-run rep init after major version updates to regenerate the integration file.

Config

Lives at ~/.reportal/config.toml:

[settings]
default_editor = "cursor"
default_clone_root = "~/dev"
path_on_select = "show"           # "show" or "hide" — print path after jump/open
path_display_format = "absolute"  # "absolute" or "relative"

[repos.my-api]
path = "~/dev/my-project/api"
description = "Backend API"
tags = ["work", "backend"]
remote = "git@github.com:org/api.git"
title = "API"              # custom terminal tab title (defaults to alias)
color = "#1a1a2e"          # terminal background color on jump (hex)

[repos.website]
path = "~/dev/personal/site"
description = "Personal website"
tags = ["personal", "frontend"]

Setting	Values	Default	What it controls
default_editor	Any command	cursor	Editor for rep open
default_clone_root	Any path	~/dev	Where rep add <url> clones to
path_on_select	show, hide	show	Print path after picking a repo in jump/open
path_display_format	absolute, relative	absolute	Full path or relative to current directory
default_ai_tool	Any tool name	claude	Which AI CLI rep ai launches by default

Per-repo fields

Field	Required	Default	What it controls
path	yes	—	Filesystem path to the repo (supports ~)
description	no	""	Shown in fuzzy finder and rep list
tags	no	[]	Filter repos with --tag
remote	no	""	Git remote URL for cloning on other machines
aliases	no	[]	Alternative names for direct jump (e.g. rj ninja instead of rj nro)
title	no	repo alias	Terminal tab title on jump/open
color	no	reset to default	Terminal tab color (#RRGGBB) on jump/open

AI tools

Configure which AI coding CLIs are available for rep ai:

[ai_tools.claude]
command = "claude"
args = []

[ai_tools.codex]
command = "codex"
args = []

[ai_tools.aider]
command = "aider"
args = []

Field	Required	Default	What it controls
command	yes	—	The executable to run
args	no	[]	Extra arguments passed on every launch

New configs created via rep init ship with claude, codex, and aider pre-registered.

Commands

Define reusable commands that can be run in any repo via rep run:

[commands]
test  = { command = "cargo test",          description = "Run tests" }
serve = { command = "npm run dev",         description = "Start dev server" }
build = { command = "cargo build --release", description = "Production build" }

Field	Required	Default	What it controls
command	yes	—	The shell command to execute
description	no	""	Shown in the fuzzy picker alongside the command name

Per-repo commands go under [repos.<alias>.commands] and can override global commands with the same name, or add repo-specific ones:

[repos.my-api.commands]
serve   = { command = "python manage.py runserver", description = "Start Django dev server" }
migrate = { command = "python manage.py migrate",   description = "Run database migrations" }

Terminal personalization

When you jump to or open a repo, RePortal automatically sets:

1. Tab title — uses the title config field, falling back to the repo alias
2. Tab color — uses the color config field; repos without a color reset to the terminal default

The --title flag on jump/open lets you override the tab title for a single session without changing config.

Shell hook for new terminals

Terminals opened directly into a repo (e.g. VS Code integrated terminal) won't go through rj, so they won't get the color/title automatically. Add rep color to your prompt to fix that:

PowerShell:

function prompt { rep color 2>$null; "PS> " }

Bash / Zsh:

PROMPT_COMMAND='rep color 2>/dev/null'

rep color matches your current directory against registered repos (longest prefix wins) and emits the right sequences.

Roadmap

• Config parsing
• init, list, jump, open, add, remove
• Shell integration auto-install (rj, ro)
• Clone from URL with sibling/child placement
• Auto-detect git remote on add
• Colored output with themed fuzzy finder (repo color swatches in rep list, aliases in fuzzy finder)
• rep short alias
• Configurable path display (absolute/relative, show/hide)
• Per-repo terminal tab title and background color (OSC 2 / OSC 11)
• color command for shell prompt hooks
• status — git status across all repos
• sync — pull latest across repos
• doctor — diagnose config, shell integration, and repo path issues
• ai — launch AI coding CLIs (Claude Code, Codex, aider) in any repo with configurable defaults
• web — open a repo's remote URL in the browser (converts SSH remotes to HTTPS)
• run — run configured commands in repos with fuzzy selection and per-repo overrides
• edit UX overhaul — fuzzy-select what to edit (repos, AI tools, global settings), field menu
• dashboard — rich overview with branches, dirty state, last commit
• clone --all — clone missing repos from config (machine sync)
• Shell completions
• Publish to crates.io

Contributing

PRs welcome. Open an issue first for anything bigger than a typo fix.

License

MIT