firstbitelabsllc/pilot-puppy

<img src="docs/public/shadow-cover.png" width="1280" alt="Shadow — Pick up where you left off."

Shadow

Pick up where you left off.

Keep the plan, who owns the work, and the next step on your computer. Open a new coding session and continue.

Watch the demo · Documentation · MIT license

Ask your coding agent to try it

Python 3.10+, Git, and Bash on macOS or Linux.

Open this repository in Claude Code and paste:

Show me how Shadow handles a failing check and finds the next task. Run the local example and explain the result.

Or open this repository in Codex and ask:

Run the local Shadow example, then show me how it handles a failing check and finds the next task. Explain what happened.

examples/demo.py creates a scratch repository with a failing greeting test. The script makes the demonstrated fix, Shadow reruns the check, and a fresh command finds the next task. It uses no model account and removes its temporary repository and board when it finishes.

Run it yourself

git clone https://github.com/firstbitelabsllc/shadow.git
cd shadow
python3 examples/demo.py

Use it with your project

Ask your coding agent to set up Shadow from the installation guide, then use the command-line reference below when you need the exact commands.

From the clone:

bash install.sh
export PATH="$HOME/.local/bin:$PATH"
shadow doctor