pilot-shell  by maxritter

AI code development powered by spec-driven workflows and TDD

Created 4 months ago
1,419 stars

Top 28.2% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a professional, containerized development environment for Claude Code (CC), enabling spec-driven workflows, TDD enforcement, persistent memory, and semantic code search. It targets developers seeking a structured and robust approach to building with AI assistants, offering systematic shipping and enhanced code quality through automated hooks and modular rules.

How It Works

Claude CodePro operates within a Dev Container, ensuring consistent tooling and isolation. Its core is a Spec-Driven Development (SDD) workflow managed via slash commands (/plan, /implement, /verify). It leverages a Modular Rules System that loads .md files as project memory, supporting both standard best practices and custom project-specific logic. Enhanced context capabilities include cross-session persistent memory (Claude Mem), local vector store semantic search (Claude Context), real-time web search (Tavily), and AI-powered code context retrieval (Ref). Intelligent hooks automate quality checks, linting, and enforce TDD before code edits.

Quick Start & Requirements

  • Primary Install: Execute curl -fsSL https://raw.githubusercontent.com/maxritter/claude-codepro/v3.2.11/install.sh | bash in your project, then reopen the project in the Dev Container.
  • Prerequisites: Docker Desktop or OrbStack (macOS), VS Code, Cursor, Windsurf, or Antigravity IDE with the Dev Containers extension.
  • Setup: Installation occurs automatically within the isolated Dev Container environment, configuring global tools like Python, qlty, Claude Code, and dotenvx.
  • Links: Website: https://claude-code.pro

Highlighted Details

  • Spec-Driven Workflow: Utilizes commands like /setup, /plan, /implement, and /verify to structure development tasks.
  • TDD Enforcement: A pre-edit hook warns developers if they attempt to modify code without passing tests.
  • Modular Rules System: Automatically loads project memory from .claude/rules/*.md files, allowing for custom, path-specific rules.
  • Persistent Memory & Semantic Search: Integrates multiple AI services for cross-session memory retention and efficient, token-aware code retrieval.
  • Quality Hooks: Post-edit hooks automate code formatting and linting (e.g., ruff, mypy, basedpyright).

Maintenance & Community

The project integrates heavily with numerous other open-source tools and services, including qlty, claude-mem, claude-context, tavily-ai, ruff, and uv, suggesting active maintenance through its dependencies. No direct community links (Discord, Slack) are provided in the README.

Licensing & Compatibility

  • License: AGPL-3.0.
  • Compatibility: The AGPL-3.0 license is a strong copyleft license. Use in commercial or closed-source projects requires careful consideration, as derived works typically must also be licensed under AGPL-3.0.

Limitations & Caveats

The environment strictly requires a Dev Container setup, necessitating Docker or OrbStack. Some IDEs (Cursor, Windsurf, Antigravity) require manual re-execution of the install script post-container start. The AGPL-3.0 license imposes significant obligations regarding source code availability for distributed modifications.

Health Check
Last Commit

18 hours ago

Responsiveness

Inactive

Pull Requests (30d)
34
Issues (30d)
18
Star History
1,034 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.