claude-toolbox

claude-toolbox

claude-toolbox is a collection of "tools" for all your Claude Code workflows — pre-configured MCP servers, skills, sub-agents, commands, hooks, statuslines with themes, and more - everything you need for AI-powered development workflows, used and battle-tested daily on many of my own projects.

<img width="3440" height="521" alt="image" src="https://github.com/user-attachments/assets/27ef7269-0153-47c0-b07d-ed6a9504a176" />

About

This is a template repository and plugin system that gives you a ready-to-use Claude Code development environment. It ships with MCP servers, a kk plugin (skills, commands, hooks), themed statuslines — all configured and wired together.

The repo serves dual purposes:

1. Template repository — create new repos from this template to get project-specific configuration (settings, instructions, Serena config, statusline, sync infrastructure)
2. Plugin marketplace — install the kk plugin via the Claude Code plugin system to get skills, commands, and hooks

[!NOTE] We focus on collaborative development. Claude Code settings are split between two project-scoped files:

• .claude/settings.json — upstream-managed defaults, synced to all downstream repos (permissions baseline, env vars, model, plugins, statusline)
• .claude/settings.local.json — per-repo overrides, never synced (hooks, MCP server enables, additional permissions, personal preferences)

"Don't ask again" permission grants land in settings.local.json automatically.

What's Included

MCP Servers

Three servers, configured at user-level (~/.claude.json) to keep API keys out of the repo:

Server	Purpose
Context7	Up-to-date library documentation and code examples
Serena	Semantic code analysis via LSP — symbol navigation, reference tracking, targeted reads
Pal	Multi-model AI integration — chat, debugging, code review, planning, security audit
Capy	Persistent knowledge base — cross-session project memory with FTS5 search

Knowledge Base

The kk plugin's skills are knowledge-aware via Capy. Skills search for relevant context before executing (architecture decisions, review findings, language idioms) and index valuable learnings after producing output. Knowledge persists across sessions per-project using an FTS5 full-text search index.

Installation: brew install serpro69/tap/capy then run capy setup in your project directory.

[!NOTE] Capy is optional. All skills work fully without it — search steps return nothing and index steps are skipped. The bootstrap script sets up capy automatically if the binary is on PATH.

kk Plugin (klaude-plugin/)

The kk plugin contains all development workflow functionality — 9 skills, 4 commands, and hooks — distributed via the Claude Code plugin system. Skills are invoked as /skill-name, commands as /kk:dir:command.

Includes: analysis-process, implementation-process, testing-process, documentation-process, development-guidelines, solid-code-review, implementation-review, merge-docs, cove (Chain-of-Verification). Plus commands for CoVe, implementation review, Task Master migration, and sync workflow updates. See the plugin README for full details.

Other Configuration

• Permission allowlist/denylist (.claude/settings.json) — baseline permissions: auto-approves safe bash commands and WebSearch while blocking dangerous patterns. Per-repo MCP tool permissions go in settings.local.json.
• Status line (.claude/scripts/statusline_enhanced.sh) — rich statusline with model, context %, git branch, session duration, thinking mode, and rate limits. Themes: set CLAUDE_STATUSLINE_THEME to darcula, nord, or catppuccin, and CLAUDE_STATUSLINE_MODE to dark (default) or light to match your terminal background
• Serena config (.serena/project.yml) — language detection, gitignore integration, encoding settings

Template Infrastructure