niksavis/terminal
Cross-platform terminal setup for WezTerm + WSL (zsh, tmux, starship) with reproducible CLI tooling and a live cheat sheet.
ARCHETYPE
YOLO Cowboy
Permissions? Never heard of 'em. Ships at the speed of `--dangerously-skip-permissions`.
GUARDRAILS
3/5
Blocks destructive commands · Protects secrets · Pre-tool screening hook · details
Quality 21/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code
$ npx degit niksavis/terminal/.claude ./rig-terminal # 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 niksavis/terminal/.agents/skills/best-practices-audit .claude/skills/best-practices-audit $ npx degit niksavis/terminal/.agents/skills/catalog-authoring .claude/skills/catalog-authoring $ npx degit niksavis/terminal/.agents/skills/cli-tools .claude/skills/cli-tools $ npx degit niksavis/terminal/.agents/skills/conventional-commits .claude/skills/conventional-commits $ npx degit niksavis/terminal/.agents/skills/council .claude/skills/council $ npx degit niksavis/terminal/.agents/skills/decompose-plan .claude/skills/decompose-plan $ npx degit niksavis/terminal/.agents/skills/falsify-first .claude/skills/falsify-first $ npx degit niksavis/terminal/.agents/skills/find-skills .claude/skills/find-skills $ npx degit niksavis/terminal/.agents/skills/harness-client .claude/skills/harness-client $ npx degit niksavis/terminal/.agents/skills/harness-loop .claude/skills/harness-loop $ npx degit niksavis/terminal/.agents/skills/hill-climb .claude/skills/hill-climb $ npx degit niksavis/terminal/.agents/skills/interface-facts .claude/skills/interface-facts $ npx degit niksavis/terminal/.agents/skills/no-comments .claude/skills/no-comments $ npx degit niksavis/terminal/.agents/skills/node .claude/skills/node $ npx degit niksavis/terminal/.agents/skills/plain-english .claude/skills/plain-english $ npx degit niksavis/terminal/.agents/skills/python .claude/skills/python $ npx degit niksavis/terminal/.agents/skills/release-process .claude/skills/release-process $ npx degit niksavis/terminal/.agents/skills/repair-in-place .claude/skills/repair-in-place $ npx degit niksavis/terminal/.agents/skills/retention-probe .claude/skills/retention-probe $ npx degit niksavis/terminal/.agents/skills/root-cause .claude/skills/root-cause $ npx degit niksavis/terminal/.agents/skills/session-finish .claude/skills/session-finish $ npx degit niksavis/terminal/.agents/skills/skill-creator .claude/skills/skill-creator $ npx degit niksavis/terminal/.agents/skills/swarm .claude/skills/swarm $ npx degit niksavis/terminal/.agents/skills/test-discipline .claude/skills/test-discipline $ npx degit niksavis/terminal/.agents/skills/tier-injection .claude/skills/tier-injection $ npx degit niksavis/terminal/.agents/skills/validate-as-consumer .claude/skills/validate-as-consumer $ npx degit niksavis/terminal/.agents/skills/work-tracker .claude/skills/work-tracker $ npx degit niksavis/terminal/.agents/skills/worktree-isolation .claude/skills/worktree-isolation $ npx degit niksavis/terminal/.agents/skills/wsl .claude/skills/wsl
$ curl -fsSL --create-dirs -o .claude/agents/architect.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/architect.md $ curl -fsSL --create-dirs -o .claude/agents/auditor.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/auditor.md $ curl -fsSL --create-dirs -o .claude/agents/curator.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/curator.md $ curl -fsSL --create-dirs -o .claude/agents/decider.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/decider.md $ curl -fsSL --create-dirs -o .claude/agents/decomposer.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/decomposer.md $ curl -fsSL --create-dirs -o .claude/agents/designer.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/designer.md $ curl -fsSL --create-dirs -o .claude/agents/implementer.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/implementer.md $ curl -fsSL --create-dirs -o .claude/agents/researcher.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/researcher.md $ curl -fsSL --create-dirs -o .claude/agents/retrospector.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/retrospector.md $ curl -fsSL --create-dirs -o .claude/agents/reviewer.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/tester.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/tester.md $ curl -fsSL --create-dirs -o .claude/agents/validator.md https://raw.githubusercontent.com/niksavis/terminal/main/.claude/agents/validator.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(rm -r -f*)",
"Bash(rm -f -r*)",
"Bash(git push --force*)",
"Bash(git push --force-with-lease*)",
"Bash(git push -f*)",
"Bash(git push*--force*)",
"Bash(git push*--no-verify*)",
"Bash(git push*--no-gpg-sign*)",
"Bash(git commit*--no-verify*)",
"Bash(git commit*--no-gpg-sign*)",
"Bash(git reset --hard*)",
"Bash(git clean*-f*)",
"Bash(git rebase*)",
"Bash(git filter-branch*)",
"Bash(git filter-repo*)",
"Read(.env)",
"Read(.env.*)",
"Read(**/.env)",
"Read(**/.env.*)",
"Read(**/.env.local)",
"Edit(.env)",
"Edit(.env.*)",
"Edit(**/.env)",
"Edit(**/.env.*)",
"Bash(git *push*--no-verify*)",
"Bash(git *push*--no-gpg-sign*)",
"Bash(git *commit*--no-verify*)",
"Bash(git *commit*--no-gpg-sign*)",
"Bash(git *-c core.hooksPath*)",
"Bash(git *-c core.hookspath*)",
"Bash(git *push*--force*)",
"Bash(git *push* -f*)",
"Bash(git *push*--delete*)",
"Bash(git *push* :**)",
"Bash(git *push* +:**)",
"Bash(gh release delete*)",
"Bash(gh repo delete*)",
"Bash(gh run delete*)",
"Bash(git *reset*--hard*)",
"Bash(git *clean*-f*)"
]
},
"hooks": {
"PreToolUse": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "uv run --no-project --no-python-downloads --python '>=3.14' python -X utf8 \"${CLAUDE_PROJECT_DIR}/.basicly/core/hooks/lefthook-runtime.py\" claude pretooluse"
}
]
}
]
}
} Skills (29)
best-practices-auditcatalog-authoringcli-toolsconventional-commitscouncildecompose-planfalsify-firstfind-skillsharness-clientharness-loophill-climbinterface-factsno-commentsnodeplain-englishpythonrelease-processrepair-in-placeretention-proberoot-causesession-finishskill-creatorswarmtest-disciplinetier-injectionvalidate-as-consumerwork-trackerworktree-isolationwsl
Subagents (12)
| architect | Surveys a whole codebase for structural decay and returns a remediation backlog ordered by dependency. Use at a release boundary, or when a measure that no ratchet sees has moved, such as module count |
| auditor | Audits a diff or a component for security weaknesses at trust boundaries. Use before you ship a change that touches input handling, credentials, subprocess calls or network calls. Returns severity-rat |
| curator | Binds every claim that a release makes to the evidence for it, and refuses each claim that has none. Invoked by the engine at SHIP, once verify and validate are green. Returns a `release-record` in wh |
| decider | Assigns an integrity level and a loop depth to a classified unit, and disposes the escalations that the engine routes to it. Invoked by the engine at CLASSIFY for L2 and above, and when an escalation |
| decomposer | Cuts a classified unit of work into children that can each be built, verified and demonstrated end to end. Invoked by the engine at DECOMPOSE, once `classification` and `change-shape` validate and the |
| designer | Draws mocks and judges the UI and UX of a terminal, web, desktop or mobile surface for the person who uses it. Use before a layout, a pane, a page, a screen or an interaction is built or changed, and |
| implementer | Builds one planned child to green, and in repair mode fixes the named defect in the same worktree without a new plan. Invoked by the engine at BUILD when the plan gate is green and downstream work in |
| researcher | Establishes a fact about an external interface or a claimed best practice from primary sources, not from recall. Use before you write code, a design note, a rule or a claim that depends on how a third |
| retrospector | Finds why a special-cause failure happened and names the control that would have refused it. Invoked when the gate-failure ledger fires a special-cause signal, which is a point beyond three sigma, or |
| reviewer | Reviews a change along one named lens and reports findings on that lens only. Invoked by the engine at VALIDATE once per lens beside the validator, and by a person on any diff or component. Name the l |
| tester | Runs the repository's documented test suite or a named subset and reports the outcome. Use after a code change when you need a pass or fail verdict without reading raw test output. Returns the counts |
| validator | Runs a verified change the way a consumer would, in the operational environment, against the requirement that asked for it. Invoked by the engine at VALIDATE, once `verification-evidence` is green. Re |
Hooks (3)
| event | matcher | runs |
|---|---|---|
| PreToolUse | * | uv run --no-project --no-python-downloads --python '>=3.14' python -X utf8 "${CLAUDE_PROJECT_DIR}/.basicly/core/hooks/lefthook-runtime.py" claude pretooluse |
| PostToolUse | * | uv run --no-project --no-python-downloads --python '>=3.14' python -X utf8 "${CLAUDE_PROJECT_DIR}/.basicly/core/hooks/lefthook-runtime.py" claude posttooluse |
| SessionStart | * | uv run --no-project --no-python-downloads --python '>=3.14' python -X utf8 "${CLAUDE_PROJECT_DIR}/.basicly/core/hooks/lefthook-runtime.py" claude sessionstart |
Permissions
deny (42)
Bash(rm -rf*)
Bash(rm -fr*)
Bash(rm -r -f*)
Bash(rm -f -r*)
Bash(git push --force*)
Bash(git push --force-with-lease*)
Bash(git push -f*)
Bash(git push*--force*)
Bash(git push*--no-verify*)
Bash(git push*--no-gpg-sign*)
Bash(git commit*--no-verify*)
Bash(git commit*--no-gpg-sign*)
Bash(git reset --hard*)
Bash(git clean*-f*)
Bash(git rebase*)
Bash(git filter-branch*)
Bash(git filter-repo*)
Read(.env)
Read(.env.*)
Read(**/.env)
Read(**/.env.*)
Read(**/.env.local)
Edit(.env)
Edit(.env.*)
Edit(**/.env)
Edit(**/.env.*)
Bash(git *push*--no-verify*)
Bash(git *push*--no-gpg-sign*)
Bash(git *commit*--no-verify*)
Bash(git *commit*--no-gpg-sign*)
Bash(git *-c core.hooksPath*)
Bash(git *-c core.hookspath*)
Bash(git *push*--force*)
Bash(git *push* -f*)
Bash(git *push*--delete*)
Bash(git *push* :**)
Bash(git *push* +:**)
Bash(gh release delete*)
Bash(gh repo delete*)
Bash(gh run delete*)
Bash(git *reset*--hard*)
Bash(git *clean*-f*)
ask (0)
—
allow (45)
Bash
Edit
Write
Read
Glob
Grep
WebSearch
WebFetch
Bash(git status *)
Bash(git rev-parse *)
Bash(git ls-files *)
Bash(git worktree list *)
Bash(git branch)
Bash(git branch --show-current)
Bash(basicly status *)
Bash(basicly tracker show *)
Bash(basicly tracker list *)
Bash(basicly tracker ready *)
Bash(basicly tracker stats *)
Bash(basicly check)
Bash(basicly skills-check *)
Bash(basicly styles-check *)
Bash(basicly agents-check)
Bash(basicly hooks-check)
Bash(basicly permissions-check)
Bash(basicly catalog lint)
Bash(basicly verify)
Bash(basicly verify --mode fast)
Bash(basicly verify --mode full)
Bash(basicly verify --mode staged)
Bash(git ls-remote origin)
Bash(git ls-remote --branches origin)
Bash(git ls-remote --tags origin)
Bash(gh run list *)
Bash(gh run view *)
Bash(gh release view *)
Bash(gh release list *)
Bash(gh workflow list *)
Bash(gh workflow view *)
Bash(basicly tracker write -- create *)
Bash(basicly tracker write -- update *)
Bash(basicly tracker write -- review *)
Bash(basicly tracker write -- confirm *)
Bash(basicly tracker write -- close *)
Bash(basicly tracker write -- comments add *)
Similar rigs
niksavis/handily
Claude Code mods that show your work items, tasks and sessions, for any tracker. Mods show and ask; they never enforce.
Fort Knox 6.3k tok · · Q36
niksavis/basicly
basicly writes the instruction files for Claude Code, Codex and Copilot from one catalog of rules, and adds git hooks that check every commit. It includes a tracker and a loop that builds each task in its own git worktree.
YOLO Cowboy 4.8k tok · · Q21
homeofe/improvements
Portable, LLM-agnostic framework for multi-model AI workflows: model routing, structured agent handoff (AAHP), and a phased agent pipeline. MIT.
Orchestrator 1.4k tok · · Q24
yourconscience/tackroom
Dotfiles for your AI agents: one ~/.agents repo for skills, MCP servers, hooks, agent roles, and memory — synced natively to Claude Code, Codex, OMP/Pi, OpenCode, Droid, and Hermes. Commit-pinned and audited externals.
Orchestrator 1.4k tok · · Q8