~ / rigs / eveningworks / saunaos

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.

↗ GitHub ★ 1 NOASSERTION updated 2d ago project Claude Code
field: unknown workflow: Git & commitsTesting & TDDDocs
stack: CPython
share on X
ARCHETYPE
Pragmatist
A balanced, no-drama setup: some rules, some tools, nothing extreme.
CONTEXT TAX · EVERY TURN
~12.0k tokens
Heavy · median rig: 2.3k · breakdown
GUARDRAILS
2/5
Pre-tool screening hook · No YOLO mode · details
Quality 20/100 Guardrails v2

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)

eventmatcherruns
PreToolUseEdit|Write|MultiEdit|NotebookEdit|Bashpython3 "${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

copied ✓