Introducing
amplifier-workspace
One command to a ready-to-work Amplifier environment.
Repos cloned, templates in place, terminal arranged.
Active — v0.1.0 microsoft/amplifier-workspace · MIT License · April 2026
The Problem
The setup ritual
Working across multiple Amplifier repos means repeating the same steps every time you start a new task:
# Every. Single. Time. $ mkdir ~/dev/fix-auth $ cd ~/dev/fix-auth $ git clone https://github.com/microsoft/amplifier.git $ git clone https://github.com/microsoft/amplifier-core.git $ git clone https://github.com/microsoft/amplifier-foundation.git $ vim AGENTS.md # write from memory... $ mkdir .amplifier $ vim .amplifier/settings.yaml # what was the format again? $ git init $ amplifier # finally
The Solution
One command
Create a workspace. Run the same command again to resume it.
$ amplifier-workspace ~/dev/fix-auth Creating workspace: fix-auth Initialising git repo... Adding submodule: amplifier Adding submodule: amplifier-core Adding submodule: amplifier-foundation Writing AGENTS.md Writing .amplifier/settings.yaml Launching Amplifier...
All setup from Slide 2 — replaced by a single invocation.
What Gets Created
A task-scoped workspace
~/dev/fix-auth/ ├── .git/ local repo ├── .amplifier/ │ └── settings.yaml bundle config ├── AGENTS.md agent context ├── amplifier/ git submodule ├── amplifier-core/ git submodule └── amplifier-foundation/ git submodule
📁

Workspace root

A local-only git repo for task-lifetime commits and reverts. Throwaway when you're done.

🔗

Submodule repos

Real GitHub repos added as git submodules. Commits and pushes persist upstream.

Lifecycle
Ephemeral by design
Workspaces are task-scoped and throwaway. Spin up per task, destroy when done.
# Create or resume $ amplifier-workspace ~/dev/fix-auth # Kill tmux session, keep files $ amplifier-workspace -k ~/dev/fix-auth # Destroy everything (prompts for confirmation) $ amplifier-workspace -d ~/dev/fix-auth # Fresh start (destroy + recreate) $ amplifier-workspace -f ~/dev/fix-auth
Architecture
Two tiers
Start simple. Opt into session management when you want it.
Tier 1 — Default

Workspace Only

  • Creates workspace directory
  • Clones repos as submodules
  • Writes AGENTS.md + settings.yaml
  • Launches Amplifier directly
  • No extra dependencies
Tier 2 — Opt-in

Session Manager

  • Everything in Tier 1
  • tmux session with named windows
  • Amplifier window with resume detection
  • Two-pane shell window
  • Optional: lazygit, yazi windows
# ~/.config/amplifier-workspace/config.toml [tmux] enabled = true [tmux.windows] amplifier = "" # always present shell = "" # two-pane shell git = "lazygit" # remove to disable files = "yazi" # remove to disable
First Run
Interactive setup wizard
Four steps. Writes config once. Every invocation after that just works.
Step 1 of 4: Default repos 1. https://github.com/microsoft/amplifier.git 2. https://github.com/microsoft/amplifier-core.git 3. https://github.com/microsoft/amplifier-foundation.git Keep these defaults? [Y/n]: Y Step 2 of 4: Amplifier bundle Amplifier bundle name [amplifier-dev]: amplifier-dev Step 3 of 4: AGENTS.md template [1] Built-in (default) [2] Custom file path Choice [1]: 1 Step 4 of 4: Session manager (optional) Enable tmux session manager? [y/N]: N Configuration written to ~/.config/amplifier-workspace/config.toml
Maintenance
Self-maintaining

Config-aware doctor

$ amplifier-workspace doctor amplifier-workspace doctor ======================================== ✓ Python version 3.12.3 ✓ amplifier-workspace 0.1.0 (git) ✓ git in PATH ✓ amplifier in PATH ✓ config file ✓ default_repos 3 repo(s) tmux (enabled) ✓ tmux 3.4 ✓ 4 windows configured ✓ lazygit found ✗ yazi not found install: brew install yazi or remove: config remove tmux.windows.files 1 issue(s) found

Self-update + config CLI

# Upgrade (detects install source) $ amplifier-workspace upgrade $ amplifier-workspace upgrade --check $ amplifier-workspace upgrade --force # Full config management $ amplifier-workspace config list $ amplifier-workspace config get tmux.enabled $ amplifier-workspace config set tmux.enabled true $ amplifier-workspace config add workspace.default_repos URL $ amplifier-workspace config remove workspace.default_repos URL $ amplifier-workspace config reset
Doctor only checks what you use. tmux disabled? Those checks are skipped entirely.
Missing tool? Shows install command and how to remove the check.
Under the Hood
Built to be invisible
0
runtime dependencies
stdlib-only Python 3.11+
246
tests passing
in 0.14 seconds
10
modules
~1,995 lines of source
🧱

Minimal surface area

cli, config, doctor, git, install, tmux, upgrade, wizard, workspace — each module does one thing.

🔍

Test coverage

~3,089 lines of tests for ~1,995 lines of source. 1.55:1 test-to-source ratio.

📜

MIT Licensed

Open source under the Microsoft org. microsoft/amplifier-workspace

Sources & Methodology
How this deck was built

Research commands

  • python -m pytest tests/ --tb=no -q — 246 passed in 0.14s
  • cat pyproject.toml — version, dependencies, Python requirement
  • git log --all --oneline | wc -l — 127 commits
  • git shortlog -sn --all — contributor breakdown
  • wc -l src/**/*.py tests/*.py — line counts
  • cat LICENSE — MIT, Microsoft Corporation
  • Source code review of all 10 modules

Key data points

  • Test count: 246 (from pytest, corrected from brief's 243)
  • Dependencies: dependencies = [] in pyproject.toml
  • Source: 1,995 lines / Tests: 3,089 lines / Total: 5,084 lines
  • Primary author: Brian Krabach (126 of 127 commits)
  • Feature status: Active (v0.1.0)
Data as of: April 1, 2026 · All metrics from local repo inspection
Get Started
Try it now
# Install $ uv tool install git+https://github.com/microsoft/amplifier-workspace # Create your first workspace $ amplifier-workspace ~/dev/my-task # Check your setup $ amplifier-workspace doctor
View on GitHub → Requires Python 3.11+ · Zero runtime dependencies · MIT License