agent-project-launchpad

Agent Project Launchpad

Pick up your work with Codex, Claude Code, or GitHub Copilot CLI.

A keyboard-first terminal picker for your agent projects. See what you were working on, when you last touched it, and where you left off. Switch agents with shared project notes and recent conversation context carried along.

Type claude, codex, or gh copilot as usual. Pick a project and press Enter to continue. Your existing conversations appear automatically, including projects you worked on with another agent. The preview shows who you last used; “Continue with” shows who will pick up the work.

The actual picker renderer with fictional demo projects.

Install and enable

Requires macOS or Linux, Python 3.10+, and an installed agent.

pipx install agent-project-launchpad
agent-launchpad setup

Open a new Terminal and start your agent as usual:

claude       # Open the picker with Claude Code selected
codex        # Open it with Codex selected
gh copilot   # Open it with GitHub Copilot selected

“New conversation” is selected first: press Enter for a fresh session in your current directory. Use ↑/↓ and Enter to resume a saved project. Press n to start fresh from anywhere in the list. Resume prompts include the project's name and saved summary when available.

setup enables the picker for your normal commands in bash/zsh and backs up the startup file it changes. You only need to run it once. Check the installation with agent-launchpad check-shell.

Need pipx or prefer a virtual environment? See the installation guide.

Try the demo

agent-launchpad demo

This runs the real picker with fictional projects. It launches no agents, makes no model requests, and leaves your existing sessions alone.

Everyday controls

Projects start Active automatically. New conversation activity reopens completed work. Opening an agent and leaving without a new request keeps the project’s name, last agent, date, and completion status. Archiving keeps the original history and can be undone.

What carries over?

Each project has shared notes for decisions, progress, and next steps. Before continuing, the launcher refreshes recent conversation excerpts and source references for the selected agent to read. Full conversations stay in their original agents. Context excerpts are bounded; important gaps still need review.

Data stays on your Mac or Linux machine until an agent reads it as model context. Summaries use your existing agent account and normal usage. Nothing runs in the background. Details and privacy.

Uninstall

Run agent-launchpad uninstall to remove shell integration (with a backup). Open a new Terminal, then remove the package with pipx uninstall agent-project-launchpad. For a pip/venv install, run python -m pip uninstall agent-project-launchpad in that environment instead. Saved launcher notes and native agent histories are kept.

Use --dry-run to preview, or --shell bash / --shell zsh to choose a shell. If you set up both shells, uninstall their integration before removing the package. uninstall-shell remains available for removing only shell integration.

User guide · Troubleshooting · Contributing · Architecture · MIT license