eveningworks/saunaos
A hobby x86-64 operating system written from scratch in C and assembly: a ring-3 desktop, its own journaling filesystem, networking, USB and sound. Built with Claude Code.
ARCHETYPE
Pragmatist
A balanced, no-drama setup: some rules, some tools, nothing extreme.
Copy this rig
# review before running: this installs third-party code
$ npx degit eveningworks/saunaos/.claude ./rig-saunaos # inspect, then merge into .claude/ MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.
$ npx degit eveningworks/saunaos/.claude/skills/network-egress-disclosure .claude/skills/network-egress-disclosure $ npx degit eveningworks/saunaos/.claude/skills/saunaos-feature-workflow .claude/skills/saunaos-feature-workflow
$ curl -fsSL --create-dirs -o .claude/agents/saunaos-build.md https://raw.githubusercontent.com/eveningworks/saunaos/main/.claude/agents/saunaos-build.md $ curl -fsSL --create-dirs -o .claude/agents/saunaos-docsweep.md https://raw.githubusercontent.com/eveningworks/saunaos/main/.claude/agents/saunaos-docsweep.md $ curl -fsSL --create-dirs -o .claude/agents/saunaos-search.md https://raw.githubusercontent.com/eveningworks/saunaos/main/.claude/agents/saunaos-search.md $ curl -fsSL --create-dirs -o .claude/agents/saunaos-tests.md https://raw.githubusercontent.com/eveningworks/saunaos/main/.claude/agents/saunaos-tests.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write|MultiEdit|NotebookEdit|Bash",
"hooks": [
{
"type": "command",
"command": "python3 \"${CLAUDE_PROJECT_DIR:-.}/tools/lib/tree_lock.py\" hook"
}
]
}
]
}
} Skills (2)
Subagents (4)
| saunaos-build model: opus | A big multi-file SaunaOS build track, the one job the economy rule hands to an agent. Opus, all tools. Invoke with isolation "worktree"; the brief gives branch, base SHA, the exact list, and where and |
| saunaos-docsweep model: sonnet | The end-of-work docs sweep for SaunaOS -- given a change (commit range or summary), find what in docs/ and the CLAUDE.md files it made stale and return exact proposed edits. Read-only; does not edit o |
| saunaos-search model: haiku | Find where a behaviour lives in SaunaOS and return file:line with the few lines that answer. Read-only, Haiku, cheap to start. Use for "where/how does X work" before reading code yourself, or to locat |
| saunaos-tests model: sonnet | Run named SaunaOS tests (a tools/tests/*/*_test.py, gui_regress.py, make test, preflight) and report pass/fail with the failing log sections in full. No source edits. Sonnet. The brief must name the t |
Hooks (1)
| event | matcher | runs |
|---|---|---|
| PreToolUse | Edit|Write|MultiEdit|NotebookEdit|Bash | python3 "${CLAUDE_PROJECT_DIR:-.}/tools/lib/tree_lock.py" hook |
Permissions
deny (0)
—
ask (0)
—
allow (23)
Bash(ping *)
Bash(graft ask *)
Bash(graft grep *)
Bash(graft skeleton *)
Bash(graft callers *)
Bash(graft map)
Bash(ruff check *)
Bash(nm *)
Bash(lsusb *)
Bash(lsusb)
Bash(size *)
Bash(systemctl --user status *)
Bash(systemctl --user is-active *)
Bash(readelf *)
Bash(objdump *)
Bash(addr2line *)
Bash(lspci *)
Bash(lspci)
Bash(xxd *)
Bash(ffprobe *)
Bash(shellcheck *)
Bash(graft *)
Bash(trail *)
Similar rigs
eveningworks/toy-os
A hobby x86-64 operating system written from scratch in C and assembly: a ring-3 desktop, its own journaling filesystem, networking, USB and sound. Built with Claude Code.
Pragmatist 10.7k tok · · Q20
anomalyco/opencode
The open source coding agent.
Pragmatist 14.3k tok · · Q8
DietrichGebert/ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Pragmatist 1.6k tok · · Q0
Shubhamsaboo/awesome-llm-apps
100+ AI Agents, Agent Skills and RAG Apps - Free and Open Source.
Pragmatist 4.2k tok · · Q18