ruledeck
Open a browser-based markdown editor for your project's agent instruction file.
What it does
- Claude Code → edits
CLAUDE.md - Other agents (Cursor, Copilot, Codex, etc.) → edits
AGENTS.md
How to run
Find and run server.py from this skill's scripts/ directory:
python3 "$(dirname "$(readlink -f "$(find . -path '*/ruledeck/scripts/server.py' -type f 2>/dev/null | head -1)" 2>/dev/null || find . -path '*/ruledeck/scripts/server.py' -type f | head -1)")/server.py"
If the above is too complex, locate the script manually:
- Claude Code:
python3 .claude/skills/ruledeck/scripts/server.py - Other agents:
python3 .agents/skills/ruledeck/scripts/server.py
The browser opens automatically at http://localhost:8000.
Editor features
- Split view: left = editor, right = live markdown preview
- Save: click Save button or press Cmd+S / Ctrl+S
- Status bar shows saved / unsaved state
- Tab key inserts indentation
- Auto-creates template if file doesn't exist
Stopping the server
- Click "Stop" in the browser UI
- Or press Ctrl+C in terminal