▶ Open the live dashboard
·
View full-size screenshot
claude-toolkit
Portable Claude Code context, skills, and guard rails. Drop the claude-toolkit/ folder onto any machine, run install.sh in a project, and that project gets the same disciplined setup: a tiny always-loaded CLAUDE.md, a lazy-loaded CONTEXT.md, sane permissions, and a curated set of user-scope skills.
Current version: see claude-toolkit/VERSION.
Quick start (any project)
# 1. Clone the toolkit somewhere stable (one-time)
git clone <this-repo> ~/Documents/claude-toolkit
# 2. Bootstrap a project
cd /path/to/your/project
bash ~/Documents/claude-toolkit/claude-toolkit/install.sh
# Note: auto mode is enabled by default (requires Team/Enterprise/API plan).
# Disable: remove "defaultMode":"auto" from .claude/settings.local.json
# 3. Fill in the placeholders the installer flagged
grep -nE '<[A-Z_]+>' .claude/CLAUDE.md .claude/CONTEXT.md
# 4. (Optional) Let Claude bootstrap project memory by scanning the repo
# Open Claude Code in the project and say: "run auto-memory"
That's it. Claude Code will pick up .claude/CLAUDE.md on the next session and the user-scope skills are now available in every project.
Re-running the installer
bash ~/Documents/claude-toolkit/claude-toolkit/install.sh # safe: skips files that already exist
bash ~/Documents/claude-toolkit/claude-toolkit/install.sh --update # overwrite generic skills with newer toolkit copies (templates left alone)
bash ~/Documents/claude-toolkit/claude-toolkit/install.sh --force # also overwrite project templates (DESTRUCTIVE — backs nothing up)
The default mode is idempotent: safe to re-run any time.
Layout
claude-toolkit/
├── README.md this file
├── claude-toolkit/
│ ├── VERSION toolkit version (stamped into ~/.claude/skills/.claude-toolkit-version on install)
│ ├── install.sh bootstrap script (idempotent; --update / --force)
│ ├── .claude-plugin/
│ │ ├── plugin.json Claude Code plugin manifest (for /plugin install)
│ │ └── marketplace.json marketplace entry pointing back at this repo
│ ├── agents/ project-scope subagents installed to .claude/agents/
│ │ ├── code-reviewer.md strict diff review (sonnet, read-only)
│ │ ├── security-auditor.md OWASP-style security pass on diff (sonnet, read-only)
│ │ ├── test-runner.md detects + runs project's test command (sonnet)
│ │ ├── simplifier.md flags dead code, single-use abstractions (sonnet, read-only)
│ │ ├── adversary.md steelman the opposite of the proposed change (opus)
│ │ ├── doc-writer.md updates docs to match a code change (sonnet, docs-only)
│ │ ├── fact-checker.md verifies individual claims (paths, symbols, numbers, signatures) against the repo (sonnet, read-only)
│ │ └── flow-auditor.md verifies the *reasoning chain* between claims (catches unsupported leaps) (opus, read-only)
│ ├── templates/
│ │ ├── CLAUDE.md.template always-loaded project onboarding (≤150 lines target)
│ │ ├── CONTEXT.md.template lazy-loaded heavier background
│ │ ├── settings.local.json.template permissions + deny list + hooks + statusline
│ │ ├── statusline.sh toolkit statusline: branch | dirty | model | cost (ccusage)
│ │ ├── gitignore-snippet.txt lines appended to a project .gitignore
│ │ ├── hooks/ deterministic guardrails (29 events at code.claude.com/docs/en/hooks)
│ │ │ ├── block-dangerous-bash.sh PreToolUse(Bash): block force-push, rm -rf /, fork bombs, etc.
│ │ │ ├── format-on-write.sh PostToolUse(Edit|Write): run ruff/prettier/rustfmt etc.
│ │ │ ├── session-briefing.sh SessionStart: inject git briefing
│ │ │ ├── pre-compact-briefing.sh PreCompact: snapshot session state
│ │ │ └── post-compact-restore.sh PostCompact: re-inject snapshot
│ │ ├── devcontainer/ sandboxed VS Code devcontainer for bypass-mode work
│ │ │ ├── devcontainer.json Ubuntu 24.04 + Claude Code, no Docker socket / SSH mounts
│ │ │ └── post-create.sh installs ruff/prettier/shfmt/ccusage
│ │ └── github-workflows/ drop into .github/workflows/
