peek.en — Claude Code rule: what it does, how to install
peek.en is a Claude Code rule that tracks teammates' progress. Running peek.py inspects bot activity and recent actions without searching through session logs.
Apache-2.0 ★ 262 updated 2026-11-17
.claude/rules/peek.en.mdWhat peek.en does
This rule directs the agent to execute peek.py via uv to track teammate progress. The standard run reports what each bot is doing and when it last took an action.
Checking a specific bot with peek.py <name> -n 20 outputs its last 20 steps. This reveals whether a teammate is busy or stuck without inspecting raw session logs.
The workflow depends on having uv installed and the peek.py script available in the tools path.
What it helps with
- check bot status and activity in multi-agent runs
- find the timestamp of a teammate's last action
- inspect the last 20 steps taken by a specific bot
- detect stuck agents without reading full session logs
Example prompts for the agent
- Run
peek.pyto check teammate progress - Check the last 20 steps of bot helper using
peek.py helper -n 20
How to install peek.en
Manually: put the files in place
.claude/rules/peek.en.mdThe paths frontmatter field limits the files
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.cursor/rules/peek.en.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.github/instructions/peek.en.instructions.mdThe applyTo field sets which files it applies to
Manually: put the files in place
.devin/rules/peek.en.mdManually: put the files in place
.clinerules/peek.en.mdStep by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use
Questions about peek.en
How to install peek.en in Claude Code?
Save the rule file to .claude/rules/peek.en.md.
What does peek.en do?
It guides the agent on checking activity and recent steps of other bots using the peek.py script.
What is required for peek.en to work?
It requires the uv package manager and the peek.py script in the tools folder.
Source text
peek.en.md · Apache-2.0
- Teammates' progress: `{{UV}} run -q --script {{TOOLS}}/peek.py` shows what each bot is doing and when it last acted; `… peek.py <name> -n 20` shows one bot's last 20 steps. Run it to see whether a teammate is busy or stuck instead of digging through their session logs.
© zuiho-kai · Apache-2.0 · zuiho-kai/bothouse