Skip to main content
rule CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/rules/peek.en.md
Open on GitHub

What 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.py to 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.md

The paths frontmatter field limits the files

Step 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

Similar IDE rules

All IDE rules for Agent setup: memory, context, orchestration →

From the same set14

The whole set →
_head.en _head.en is a Claude Code rule that exposes CLI scripts from {{TOOLS}} for shell execution. Their first run installs dependencies. CX Codex +1 ★ 262repo stars websearch.en websearch.en is a Claude Code rule directing the agent to search the web using a local websearch.py script. It triggers on queries about versions, news, dates, and prices. CX Codex +1 ★ 262repo stars watchvid.en watchvid.en is a Claude Code rule that processes video links through a script and an index of materials to read. It activates when the agent receives a video link. CX Codex +1 ★ 262repo stars dsh-cc-compat.en dsh-cc-compat.en is a Claude Code rule that keeps DSH role switches, tool names, and Stop conversion aligned across sessions. CX Codex +1 ★ 262repo stars codemap-inject.en codemap-inject.en is a Claude Code rule that injects codebase maps into subagent prompts matching map keywords. The subagent reads the map first and lists new symbols to append upon completion. CX Codex +1 ★ 262repo stars choice-ask-guard.en choice-ask-guard.en is a Claude Code rule that checks agent questions against decisions already made and leaves open choices to the user. CX Codex +1 ★ 262repo stars param-source-guard.en The param-source-guard.en rule for Claude Code requires every new numeric parameter in code to include a source comment. It tracks limits, thresholds, and windows to ensure they trace back to user input, specs, or measurements. CX Codex +1 ★ 262repo stars wiki-context.en wiki-context.en is a Claude Code rule that reads relevant wiki hints and lesson entries during a terminal session. CX Codex +1 ★ 262repo stars

Project sponsors

Companies that keep this analytics open