amplihack

Development framework for popular coding agent systems (Claude Code, Github Copilot CLI, Microsoft Amplifier, codex) that provides structured dev workflows, memory, a package of useful skills and agents, goal-seeking agent generator, auto mode, self-improvement with reflection, and commands for getting the most out of agentic coding. Unlikely to work on Windows without WSL.

📚 View Full Documentation

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

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

Launch AMplihack with Github Copilot CLI
uvx --from git+https://github.com/rysweet/amplihack amplihack copilot

Try asking the amplihack-guide agent for help.

Table of Contents

• Quick Start
  • Prerequisites
  • Basic Usage
  • Create Alias for Easy Access
• Core Concepts
  • Workflow
  • Philosophy
• Configuration
  • Anthropic (Default)
  • Azure OpenAI
  • GitHub Copilot CLI
  • Custom Workflows
• Commands Reference
• Agents Reference
  • Core Agents
  • Specialized Agents
• Features
  • Workflow Orchestration by Default
  • Goal-Seeking Agent Generator
  • Profile Management
  • GitHub Pages Documentation Generation
  • Additional Features
  • Statusline
• Documentation
  • Getting Started
  • Features
  • Patterns
  • Configuration
  • Development
  • Methodology
  • Security
  • Core Principles
• Development
  • Contributing
  • Local Development
  • Testing
• License

Quick Start

Prerequisites

• MacOS, WSL, or Linux
• Python 3.2+, Node.js 18+, npm, git
• GitHub CLI (gh) for PR/issue management
• az cli for AzDO and Azure skills
• uv (astral.sh/uv)

For detailed installation instructions, see docs/PREREQUISITES.md.

You may find that its useful to use amplihack with azlin which makes it easy to start linux based agentic coding vms in the azure cloud.

Basic Usage

# Launch Claude Code with amplihack
amplihack launch

# With Azure OpenAI (requires azure.env configuration)
amplihack launch --with-proxy-config ./azure.env

# Work directly in a GitHub repository
amplihack launch --checkout-repo owner/repo

New to amplihack? After launching, try the interactive tutorial:

Task(subagent_type='guide', prompt='I am new to amplihack. Teach me the basics.')

The guide agent will walk you through workflows, prompting strategies, and hands-on exercises. Takes 60-90 minutes to complete.

Already familiar? Tell Claude Code to cd /path/to/my/project and provide your prompt. All prompts are automatically wrapped with /amplihack:ultrathink for workflow orchestration (use --no-ultrathink flag to opt-out for simple tasks).

Create Alias for Easy Access

Instead of typing the full uvx command, create an alias:

# Add to your ~/.bashrc or ~/.zshrc
alias amplihack='uvx --from git+https://github.com/rysweet/amplihack amplihack'

# Reload your shell
source ~/.bashrc  # or source ~/.zshrc

Now you can simply run:

amplihack launch
amplihack launch --with-proxy-config ./azure.env
amplihack launch --checkout-repo owner/repo

Core Concepts

Philosophy

• Simplicity - Start simple, add only justified complexity
• Modular - Self-contained modules with clear interfaces
• Test-driven - Tests before implementation
• Zero BS Principle - continually reinforcing zero tolerance of stubs, TODOs, faked apis or data, etc

Workflows

The system tries to direct all work to one of a few customizeable structured workflows which attempt to detect the user intent and guide the agent through a structured set of steps. The workflows try to put solid gaurdrails and multiagent points of view around the work. See the DEFAULT_WORKFLOW.md for an example.

Configuration

amplihack works with [Claude Code](https://claude.com/product/claude-code?utm_source=google&utm_medium=pa

...