NicholasFlemmer/styx-app
Styx is where everything converges: every repo you work in, the AI coding agents building in them, and every login they need to ship. Switch between all of it from one window. And like the river it's named after, nothing crosses over withou
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
CONTEXT TAX · EVERY TURN
up to ~17.5k tokens
Claude Code loads MCP tools on demand, so the real cost is usually lower.
Context hog · median rig: 2.3k · breakdown
GUARDRAILS
5/5
Blocks destructive commands · Protects secrets · Pre-tool screening hook · No YOLO mode · Sandbox or ask-first rules · details
Quality 66/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code $ claude mcp add context7 -- npx -y @upstash/context7-mcp $ claude mcp add playwright -- npx -y @playwright/mcp@latest --headless --viewport-size 1280,800 $ claude mcp add sqlite -- npx -y mcp-sqlite ${CLAUDE_PROJECT_DIR}/.dev/styx.db $ npx degit NicholasFlemmer/styx-app/.claude ./rig-styx-app # 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.
$ claude mcp add context7 -- npx -y @upstash/context7-mcp $ claude mcp add playwright -- npx -y @playwright/mcp@latest --headless --viewport-size 1280,800 $ claude mcp add sqlite -- npx -y mcp-sqlite ${CLAUDE_PROJECT_DIR}/.dev/styx.db
$ npx degit NicholasFlemmer/styx-app/.claude/skills/db-migration .claude/skills/db-migration $ npx degit NicholasFlemmer/styx-app/.claude/skills/ipc-command .claude/skills/ipc-command $ npx degit NicholasFlemmer/styx-app/.claude/skills/port-screen .claude/skills/port-screen $ npx degit NicholasFlemmer/styx-app/.claude/skills/provider-adapter .claude/skills/provider-adapter $ npx degit NicholasFlemmer/styx-app/.claude/skills/release .claude/skills/release $ npx degit NicholasFlemmer/styx-app/.claude/skills/run-app .claude/skills/run-app $ npx degit NicholasFlemmer/styx-app/.claude/skills/spec-lookup .claude/skills/spec-lookup $ npx degit NicholasFlemmer/styx-app/.claude/skills/state-machine-change .claude/skills/state-machine-change $ npx degit NicholasFlemmer/styx-app/.claude/skills/ui-component .claude/skills/ui-component $ npx degit NicholasFlemmer/styx-app/.claude/skills/visual-diff .claude/skills/visual-diff
$ curl -fsSL --create-dirs -o .claude/agents/a11y-reviewer.md https://raw.githubusercontent.com/NicholasFlemmer/styx-app/main/.claude/agents/a11y-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/design-fidelity-reviewer.md https://raw.githubusercontent.com/NicholasFlemmer/styx-app/main/.claude/agents/design-fidelity-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/electron-native-debugger.md https://raw.githubusercontent.com/NicholasFlemmer/styx-app/main/.claude/agents/electron-native-debugger.md $ curl -fsSL --create-dirs -o .claude/agents/security-reviewer.md https://raw.githubusercontent.com/NicholasFlemmer/styx-app/main/.claude/agents/security-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/state-machine-auditor.md https://raw.githubusercontent.com/NicholasFlemmer/styx-app/main/.claude/agents/state-machine-auditor.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"permissions": {
"deny": [
"Bash(rm -rf:*)",
"Bash(rm -fr:*)",
"Bash(git push --force:*)",
"Bash(git push -f:*)",
"Bash(git reset --hard:*)",
"Bash(git clean:*)",
"Bash(sudo:*)",
"Read(./.env)",
"Read(./.env.*)",
"Read(./**/.env)",
"Read(./**/.env.*)",
"Read(./**/*.pem)",
"Read(./**/*.key)",
"Read(./**/*.p12)",
"Read(~/.ssh/**)",
"Read(~/.aws/**)",
"Read(~/.config/gcloud/**)",
"Read(~/.netrc)",
"Edit(./.env)",
"Edit(./.env.*)",
"Edit(./**/.env)",
"Edit(./**/.env.*)",
"Edit(./**/*.pem)",
"Edit(./**/*.key)",
"Edit(./.planning/STATE.md)",
"Edit(./design/handoff/**)",
"Edit(./apps/desktop/e2e/visual/__baseline__/**)",
"Write(./design/handoff/**)",
"Write(./apps/desktop/e2e/visual/__baseline__/**)"
],
"ask": [
"Bash(git push:*)",
"Bash(git rebase:*)",
"Bash(git checkout:*)",
"Bash(git switch:*)",
"Bash(pnpm package:*)",
"Bash(pnpm publish:*)",
"Bash(npx electron-builder:*)"
]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-git-secrets.sh\""
}
]
},
{
"matcher": "Edit|Write|MultiEdit",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-secret-paths.sh\""
}
]
}
]
}
} MCP servers (3)
| server | source | est. tokens |
|---|---|---|
| Context7 | npm | 1.2k |
| Playwright MCP · "playwright" | npm | 7.5k |
| mcp-sqlite · "sqlite" | npm | 2.5k |
Skills (10)
db-migrationipc-commandport-screenprovider-adapterreleaserun-appspec-lookupstate-machine-changeui-componentvisual-diff
Subagents (5)
| a11y-reviewer model: inherit | Reviews keyboard, focus, ARIA, and reduced-motion behaviour against spec §6 and §9 for a screen, overlay, or component. Use before closing any UI phase. |
| design-fidelity-reviewer model: inherit | Read-only review of a screen or component against design/handoff/Styx.dc.html, styx-tokens.css and spec §8/§10. Use after porting a screen or adding a UI component, before marking it done. |
| electron-native-debugger model: inherit | Diagnoses Electron main/preload/native-module problems - better-sqlite3 and node-pty ABI mismatches, electron-vite config, contextBridge errors, packaging/asar issues, notarization failures. Use when |
| security-reviewer model: inherit | Read-only audit of secrets handling, keychain use, broker protocol, grant scoping, MFA gating, audit append-only guarantee, and IPC surface. Use after touching packages/broker, packages/cli, main serv |
| state-machine-auditor model: inherit | Verifies the session and grant state machines in packages/core against spec §1, checks exhaustiveness, invalid transitions, effects, and test coverage. Use after any change under packages/core/src/mac |
Hooks (7)
| event | matcher | runs |
|---|---|---|
| PreToolUse | Bash | "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-git-secrets.sh" |
| PreToolUse | Edit|Write|MultiEdit | "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-secret-paths.sh" |
| PostToolUse | Edit|Write|MultiEdit | "${CLAUDE_PROJECT_DIR}/.claude/hooks/post-edit-format.sh" |
| PostToolUse | Edit|Write|MultiEdit | "${CLAUDE_PROJECT_DIR}/.claude/hooks/check-design-css.sh" |
| PostToolUse | Edit|Write|MultiEdit | "${CLAUDE_PROJECT_DIR}/.claude/hooks/story-reminder.sh" |
| Stop | * | "${CLAUDE_PROJECT_DIR}/.claude/hooks/stop-typecheck.sh" |
| SessionStart | startup|resume|clear | "${CLAUDE_PROJECT_DIR}/.claude/hooks/session-context.sh" |
Permissions
deny (29)
Bash(rm -rf:*)
Bash(rm -fr:*)
Bash(git push --force:*)
Bash(git push -f:*)
Bash(git reset --hard:*)
Bash(git clean:*)
Bash(sudo:*)
Read(./.env)
Read(./.env.*)
Read(./**/.env)
Read(./**/.env.*)
Read(./**/*.pem)
Read(./**/*.key)
Read(./**/*.p12)
Read(~/.ssh/**)
Read(~/.aws/**)
Read(~/.config/gcloud/**)
Read(~/.netrc)
Edit(./.env)
Edit(./.env.*)
Edit(./**/.env)
Edit(./**/.env.*)
Edit(./**/*.pem)
Edit(./**/*.key)
Edit(./.planning/STATE.md)
Edit(./design/handoff/**)
Edit(./apps/desktop/e2e/visual/__baseline__/**)
Write(./design/handoff/**)
Write(./apps/desktop/e2e/visual/__baseline__/**)
ask (7)
Bash(git push:*)
Bash(git rebase:*)
Bash(git checkout:*)
Bash(git switch:*)
Bash(pnpm package:*)
Bash(pnpm publish:*)
Bash(npx electron-builder:*)
allow (44)
Bash(pnpm:*)
Bash(npx vitest:*)
Bash(npx playwright:*)
Bash(npx tsc:*)
Bash(npx eslint:*)
Bash(npx prettier:*)
Bash(npx drizzle-kit:*)
Bash(node:*)
Bash(git status:*)
Bash(git diff:*)
Bash(git log:*)
Bash(git show:*)
Bash(git branch:*)
Bash(git worktree list:*)
Bash(git add:*)
Bash(git commit:*)
Bash(git stash:*)
Bash(git mv:*)
Bash(gh pr:*)
Bash(gh issue:*)
Bash(sed:*)
Bash(grep:*)
Bash(awk:*)
Bash(head:*)
Bash(tail:*)
Bash(ls:*)
Bash(find:*)
Bash(cat:*)
Bash(wc:*)
Bash(sqlite3:*)
Bash(lsof:*)
Bash(ps:*)
Bash(mkdir:*)
WebFetch(domain:www.electronjs.org)
WebFetch(domain:electron-vite.org)
WebFetch(domain:orm.drizzle.team)
WebFetch(domain:microsoft.github.io)
WebFetch(domain:xtermjs.org)
WebFetch(domain:playwright.dev)
WebFetch(domain:code.claude.com)
WebFetch(domain:storybook.js.org)
mcp__context7__*
mcp__playwright__*
mcp__sqlite__*
Similar rigs
codeverbojan/claude-code-kickstart
Production-grade agentic workflow template for Claude Code. 4-layer architecture, task playbooks, session memory, sub-agents, one-click install.
Orchestrator 10.2k tok · · Q15
PageAI-Pro/vibe-coding-starter
Create great UIs with AI, see the full tutorial
Pragmatist 12.5k tok · · Q0
croffasia/cc-blueprint-toolkit
🏗️ Claude Code Plugin for smart blueprint-driven development
Pragmatist 8.7k tok · · Q0
Pepetka/dotfiles
Personal dotfiles for macOS, Linux, and WSL. Zsh with Oh My Zsh and Powerlevel10k, tmux with popups and powerline status, plus synced TokyoNight theme switching across terminal, tmux, and Neovim.
Pragmatist 8.9k tok · · Q0