Spotlight
Menu
A little tool for your local world

Your worktree.
In the spotlight.

Preview any worktree in the
app you already have running.

Get Spotlight

macOS + Linux · Agent ready

ONE APP. ANY WORKTREE.

YOUR WORKTREES

fix/settingsConductor

YOUR MAIN CHECKOUT

localhost
Your local app
feature/paymentsLive preview

SAME SERVER. SAME LOCAL SETUP.

spotlight on

Worktree attached.

Try it. Click a worktree.

01 / One command in.
Git finds your worktree and main checkout.
02 / Your setup stays.
Keep your ignored files and local dependencies.
03 / One command out.
Restore your original files with spotlight off.

FITS YOUR FLOW

Your agent.
Your worktrees.

No integration to configure. Just Git.

WORKING IN T3 CODE

Open your worktree’s terminal.

Run this from the worktree, then test in your main checkout.

$ spotlight on

Main checkout detected. Preview attached.
OR ASK YOUR AGENT

“Spotlight this worktree.”

SMALL INSTALL. BIG DIFFERENCE.

Put it to work.

Install once. Spotlight from any worktree.

01 / LET YOUR AGENT DO IT

Install Spotlight from https://github.com/emilsundberg/spotlight. Follow the README to install the CLI and agent skill. Show me which checkout I’m in. Don’t start mirroring yet.

Includes the skill for Codex and Claude Code.

02 / OR USE YOUR TERMINAL
gh repo clone emilsundberg/spotlight ~/Code/spotlight
python3 ~/Code/spotlight/install.py

Git · Python 3.10+ · GitHub CLI · macOS or Linux

Private preview. A GitHub account with repository access is required.

After installing

spotlight on

Attach this worktree.

spotlight on feature-name

Switch to another worktree.

spotlight off

Restore the main checkout.

Edit in the worktree; test in the main checkout. Start with a clean main checkout. Add ~/.local/bin to PATH if prompted. New agent sessions can discover the installed skill.