amplihack

amplihack

Development framework for Claude Code, GitHub Copilot CLI, and Microsoft Amplifier. Adds structured workflows, persistent memory, specialized agents, goal-seeking capabilities, autonomous execution, and continuous improvement for systematic software engineering.

📚 View Full Documentation

Requires: Python 3.11+, Node.js 18+, git, uv. macOS/Linux/WSL only.

# Quick start — uvx is uv's package runner (like npx for Python)
uvx --from git+https://github.com/rysweet/amplihack amplihack claude

---

New to amplihack? Start with Quick Start, then Core Concepts, then Configuration.

Want to contribute? Go to Development and CONTRIBUTING.md.

Already familiar? Check out Features and Documentation Navigator.

---

Table of Contents

• Why amplihack?
• Quick Start
• Core Concepts
• Feature Catalog
• Fleet Management
• Configuration
• Documentation Navigator
• Windows Support
• Development
• RustyClawd Integration
• License

Why amplihack?

The Problem: Claude Code and GitHub Copilot CLI are barebones development tools. They provide a chat interface and model access, but no engineering system for managing complexity, maintaining consistency, or shipping reliable code at scale.

The Solution: amplihack builds the engineering system around your coding agent:

• Structured workflows replace ad-hoc prompting (DEFAULT_WORKFLOW.md defines 22 systematic steps)
• Specialized agents handle architecture, building, testing, and review with defined responsibilities
• Persistent memory across sessions with knowledge graphs and discoveries
• Quality gates enforce philosophy compliance, test coverage, and code standards
• Self-improvement through reflection, pattern capture, and continuous learning

The Benefit: Systematic workflows and quality gates produce consistent, high-quality code.

Quick Start

Prerequisites

• Platform: macOS, Linux, or Windows via WSL. Native Windows has partial support.
• Runtime: Python 3.11+, Node.js 18+
• Tools: git, npm, uv (astral.sh/uv)
• Recommended: Rust/cargo (rustup.rs) — required for the Rust recipe runner
• Optional: GitHub CLI (gh), Azure CLI (az)

Detailed setup: docs/PREREQUISITES.md

Installation

Install the prerequisites above first, then choose an option below.

Option 1: Quick Start (requires uv and Python)

# Launch with Claude Code
uvx --from git+https://github.com/rysweet/amplihack amplihack claude

# Launch with Microsoft Amplifier
uvx --from git+https://github.com/rysweet/amplihack amplihack amplifier

# Launch with GitHub Copilot
uvx --from git+https://github.com/rysweet/amplihack amplihack copilot

This launches an interactive Claude Code session enhanced with amplihack's workflows, specialized agents, and development tools. You'll get a CLI prompt where you can describe tasks and the framework orchestrates their execution.

Rust CLI status

The main amplihack entrypoint is still Python-owned today, but the runtime is no longer purely Python-first:

• when an installed Rust CLI is available, the Python entrypoint now hands install, recipe, mode, and update through to that Rust binary
• when amplihack-hooks is installed, hook configuration now prefers the Rust hook engine automatically unless AMPLIHACK_HOOK_ENGINE=python is set

The fully isolated helper below is still the easiest way to exercise the Rust CLI end-to-end without touching your real ~/.claude state. On a fresh machine, it downloads the latest compatible published amplihack-rs release binary automatically.

# Single-command GitHub install for daily use
uvx --from git+https://github.com/rysweet/amplihack \
  amplihack-rust-trial \
  install

# The installer downloads the latest published Rust release, places it in
# ~/.local/bin, updates your shell profile PATH, and runs `amplihack install`
# automatically so the framework assets are ready immediately.

# Fully isolated fresh-machine flow
uvx --from git+https://github.com/rysweet/amplihack \
  amplihack-rust-trial \
  --trial-home ~/.amplihack-rust-e2e \
  copilot

# Try specific commands without touching your current amplihack install
uvx --from git+https://github.com/rysweet/amplihack amplihack-rust-trial recipe list
uvx --from git+https://github.com/rysweet/amplihack amplihack-rust-trial mode detect