amplifier-setup

Amplifier Setup (amp)

A transparent wrapper for Claude Code that automatically manages the Amplifier development environment.

✨ What's New (December 2025)

Complete workspace isolation with git worktrees! Each project now gets its own isolated environment:

• 🔒 Isolated Python environments - No more dependency conflicts between projects
• 🌳 Git worktree-based - Work on different branches per project independently
• 📁 Separate AI working directories - Each project has its own ai_working/ and .data/
• 🚀 New commands: amp workspace, amp new, amp update, amp uninstall
• 🔌 Claude Code plugins - Git workflow helpers (/pull, /submit-pr) with more coming

See full changelog →

---

Quick Start

One-Time Installation

Windows

Step 1: Install (PowerShell or Command Prompt)

irm https://raw.githubusercontent.com/kenotron-ms/amplifier-setup/main/install.ps1 | iex

Step 2: Reload your shell

• PowerShell: . $PROFILE
• CMD: Close and reopen Command Prompt

Step 3: Done!

Installation complete. Works in PowerShell, pwsh, and CMD.

---

Mac / Linux

Step 1: Install

curl -fsSL https://raw.githubusercontent.com/kenotron-ms/amplifier-setup/main/install.sh | bash

Step 2: Reload your shell

source ~/.${SHELL##*/}rc

Step 3: Done!

Installation complete. You only need to do this once.

---

Everyday Use

Every time you want to work with Claude Code + Amplifier:

cd ~/your-project
amp

That's it! Use amp exactly like you would use claude:

amp "implement feature X"
amp --model opus
amp --help

---

What is amp?

amp is a command that you use exactly like claude, but with all the amplifier complexity handled automatically behind the scenes.

The Problem

Setting up and maintaining the amplifier environment involves many manual steps:

• Cloning the amplifier repository
• Running make install after every clone/update
• Activating the virtual environment
• Providing workspace context to Claude Code
• Managing updates

This creates friction, especially for non-technical users.

The Solution

amp is a direct replacement for the claude command that:

• ✅ Installs amplifier automatically on first run
• ✅ Updates amplifier daily (when needed)
• ✅ Activates the virtual environment automatically
• ✅ Provides proper workspace context to Claude Code
• ✅ Passes through all claude arguments transparently

You just type amp instead of claude - that's it.

---

Detailed Installation

Prerequisites

The installer automatically installs all prerequisites:

Windows:

• Windows 10 1809+ or Windows 11 (for winget package manager)
• PowerShell or Command Prompt

Mac:

• Homebrew (installed automatically if missing)

Linux:

• Python 3.11+ (install manually: sudo apt install python3 or equivalent)
• Git (install manually: sudo apt install git or equivalent)

The installer automatically installs:

• ✅ Python 3.12 (if not present)
• ✅ Git (if not present - Windows/Mac only)
• ✅ uv (Python package manager)
• ✅ Claude Code (using native binary installer - no Node.js required)

Installation Options

Windows

PowerShell or Command Prompt:

irm https://raw.githubusercontent.com/kenotron-ms/amplifier-setup/main/install.ps1 | iex

Mac / Linux

Terminal:

curl -fsSL https://raw.githubusercontent.com/kenotron-ms/amplifier-setup/main/install.sh | bash

This will:

1. Download latest amp.sh and amp-workspace.sh to ~/.amp/
2. Add it to your ~/.bashrc and ~/.zshrc
3. Make it available immediately in your current shell

That's it! After installation completes, just type amp to get started.

Note: This installer is idempotent - run it anytime to get the latest version of amp scripts.

Note: The installer will tell you exactly what to run after it completes.

Usage

Basic Usage

Use amp exactly like you would use claude:

# Start Claude Code in current directory (creates workspace worktree if needed)
amp

# Run with a prompt
amp "implement feature X"

# Pass any claude arguments
amp --help
amp --model opus
amp "analyze this code" --add-dir ../other-project

Creating New Projects

# Initialize current directory as an Amplifier project
amp new

# Create a new project directory
amp new my-project

# Creates:
# - CLAUDE.md with Flow-Driven Development guidance
# - Git repository (if git is available)
# - Offers to create GitHub repo (if gh CLI is available)

Workspace Management

# List all workspace worktrees
amp workspace list

# Show info about current workspace
amp workspace info

# Remove a workspace worktree
amp workspace remove
amp workspace remove /path/to/project