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?
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
rysweet