Skip to content

Template Setup

Use the GitHub template to create a new project with the full claude-toolbox configuration pre-wired.

Steps

  1. Create from template: Create a new project from this template using the Use this template button.

  2. Initialize the template — choose one method:

    Go to your new repo's Actions tab → Template Cleanup → Run workflow. Provide:

    • LANGUAGES (required) — programming languages, comma-separated (e.g., python, python,typescript)
    • Other inputs are optional with sensible defaults
    ./.github/scripts/template-cleanup.sh

    Interactive mode walks you through each option. Run with --help for all flags, or pass them directly:

    ./.github/scripts/template-cleanup.sh --languages python,typescript -y

  3. Clone your repo (if using Option A) and verify MCP servers:

    > /mcp
╭────────────────────────────────────────────────────────────────────╮
│ Manage MCP servers                                                 │
│                                                                    │
│ ❯ 1. context7                  ✔ connected · Enter to view details │
│   2. pal                       ✔ connected · Enter to view details │
╰────────────────────────────────────────────────────────────────────╯

    The kk plugin (skills, commands, hooks) is available via the claude-toolbox marketplace configured in .claude/settings.json.

  4. Finalize initialization:

    chmod +x .github/scripts/bootstrap.sh && ./.github/scripts/bootstrap.sh

    This installs the kk plugin, wires up the Capy knowledge base (if installed), and commits the configuration.

  5. Recommended: Run /config in Claude Code and disable Auto-compact. This prevents Claude from compacting context mid-task, which degrades quality significantly. See Recommended Settings for the full config.

  6. Try it out!

What You Get

  • .claude/ — settings, statusline, sync infrastructure
  • .codex/ — Codex-equivalent configuration
  • CLAUDE.md / AGENTS.md — project instructions
  • Template sync — pull future updates from upstream

Next Steps