Skip to content

Architecture: Bootstrap Scripts

Component: scripts/bootstrap/Type: Environment Configuration Tools: Bash, Node.js, SPT

Design

The bootstrap scripts define the "Software" layer of the development environment. They are primarily driven by the setup.sh script, which transforms a generic container into a specialized "AI-Augmented" workspace.

Core Capabilities

  1. Tooling Installation:
    • uv: Python package manager.
    • npm: Node.js packages (global).
    • claude-code, spt: AI assistants.
  2. MCP Integration:
    • Installs and registers Model Context Protocol servers (Playwright, Chrome DevTools).
    • Configures ~/.config/claude/mcp.json.
  3. Alias Injection:
    • Injects extensive shell aliases for workflow optimization (via config/aliases.sh and logic in setup.sh).
  4. Claude Context:
    • Deploys CLAUDE.md and agents/ directories to guide the AI assistant.

Initialization Flow

  1. Provisioning: infra spins up the container.
  2. Startup: Coder agent executes startup_script.
  3. Clone: User repo and dotfiles are cloned.
  4. Setup: scripts/bootstrap/setup.sh (or dotfiles scripts) are executed.
    • Installs global tools.
    • Configures MCP.
    • Sets up shell environment.

Released under the MIT License.