<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.pyUse 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