English · 简体中文
Shared coding rules, project handoffs, and local chat history for Claude Code, Codex, and Cursor.
Requires Python 3.10–3.14, internet access, and a coding app installed and signed in. Get Python if needed.
Mac — Terminal:
python3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/zandy700/agent-workflow/main/bootstrap.py').read())"Windows — PowerShell:
py -3 -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/zandy700/agent-workflow/main/bootstrap.py').read())"On Windows, use python instead of py -3 if the launcher is unavailable. Already cloned the repo? Run python3 setup.py --install; omit --install to preview.
After installation:
- Start a new chat. Approve workflow hooks if prompted; in Codex, review
/hooks. Cursor loads the rules automatically through its session-start hook. - To view your notes, open
~/Obsidian Sync/ObsidianVaultas a vault in Obsidian. Obsidian is optional, and paid Sync is not required.
Rerun the command to update. Custom instructions, unrelated hooks, notes, and existing ICM folders are preserved; replaced files are backed up. Setup and recovery details
Windows: configuration is tested on macOS; a full installation on Windows remains unverified. This setup is for local coding apps.
| Part | What it does |
|---|---|
| Shared rules | Keep changes focused, require honest verification, and put independent tasks in new sessions. |
| Chat sync and handoffs | Save local transcripts to a Markdown vault and carry project state between chats. |
| ICM + icm-architect | Provide reusable workflows, design project structures, and map folders. |
| Graphify + MarkItDown | Map code and convert documents, using tools installed in an isolated Python environment. |
Tools run on demand. Project maps require approval. Ponytail and nightly sync are optional; see setup options.
| When | Ask the agent |
|---|---|
| Before closing a chat | “Write the handoff note for this repo.” |
| Continuing in a new chat | “Read the handoff note and continue.” |
| Looking up a decision | “Check the notes: why did we do X?” |
| Organizing a project | “/icm-architect map this repo.” |
A task that needs none of the current chat's context gets its own session, even in the same repo.
- Setup options, troubleshooting, and checks
- How it works · Using the notes
- Benchmark results and limits — no guaranteed token or cost savings.
- Pinned versions and download checksums
Built with ICM and icm-architect by RinDig, Graphify, MarkItDown, and claude-conversation-extractor. Optional: Obsidian and Ponytail.
MIT license. Upstream tools retain their own licenses.