ez

Agent-first version control. Stacked PRs, worktree isolation, zero friction.

ez makes version control invisible for AI coding agents. Four commands cover the entire development lifecycle. Multiple agents work on the same repo without stepping on each other.

Install

pip install ez-stack
ez setup --yes
ez init

The 4 Commands

ez create feat/auth              # Start: worktree + branch + cd
ez push -am "feat: add auth"     # Ship: stage + commit + push + PR
ez sync --autostash              # Sync: pull trunk, clean merged, restack
ez delete feat/auth --yes        # Done: remove worktree + branch

That's it. No git add, no git commit, no gh pr create, no cd.

Why ez?

For agents: Each ez create gives the agent an isolated worktree. Multiple agents work in parallel on the same repo without merge conflicts. Structured JSON output, mutation receipts, and exit codes let agents verify every operation.

For humans: Stacked PRs become effortless. Auto-restacking, auto-cleanup of merged branches, and a dashboard that shows everything at a glance.

Dashboard

ez list

     BRANCH                         PR       CI     AGE    PORT    STATUS
--------------------------------------------------------------------------------
     main (trunk)                   -        -      2m     -       -
  *  feat/auth                      #42      ✓      5m     14832   clean
     feat/api                       #43      ⏳     15m    11247   2M 1U
     feat/ui                        -        -      1h     16503   no worktree

Shows all local branches with PR status, CI pass/fail, time since last commit, deterministic dev port per worktree, and working tree state. Branches not tracked by ez still appear and are labeled not tracked. ez list --json for machine output.

Multi-Agent Workflow

# Agent 1 (terminal 1)
ez create feat/auth --from main
# ... works in .worktrees/feat-auth ...
ez push -am "feat: auth system"

# Agent 2 (terminal 2, same repo)
ez create feat/api --from main
# ... works in .worktrees/feat-api ...
ez push -am "feat: API routes"

# No conflicts. Each agent has its own worktree.

Stacked PRs

# Build a stack of dependent changes
ez create feat/auth-types
ez commit -m "add auth types"

ez create feat/auth-api          # stacks on auth-types
ez commit -m "add auth API"

ez submit                        # pushes all, creates PRs with correct bases

# After the first PR merges:
ez sync                          # cleans up, restacks remaining branches

Scope Guard

Keep an agent focused on the files a branch is supposed to touch:

ez create feat/auth --scope 'src/auth/**' --scope 'tests/auth/**'
ez scope show
ez scope add 'benches/auth/**'
ez scope set --mode strict 'src/auth/**' 'tests/auth/**'

With scope configured, ez commit and ez push -am check the staged file set before mutating git state. In warn mode they print drift and continue. In strict mode they stop.

Worktree Hooks

Create .ez/hooks/post-create/default.md to give agents setup instructions:

# Worktree Setup
1. `npm install`
2. `cp .env.example .env`
3. Start dev server on port $EZ_PORT

Hooks are markdown instructions, not scripts. ez prints them, the agent follows them. Use --hook <name> for project-specific hooks, or --hook alone to list available hooks.

All Commands

Flagship

Command	Description
`ez create <name>`	Create worktree + branch (default). `--from main` for independent work. `--no-worktree` for branch only.
`ez list`	Dashboard for all local branches: PRs, CI, age, ports, and working tree state. `--json` for machine output.
`ez delete [name]`	Delete branch + worktree. Auto-detects worktrees and best-effort stops listeners on the branch dev port. `--yes` for agents.
`ez push`	Push + create/update PR. `-am "msg"` to stage+commit+push in one step. `--no-pr` skips PR updates, `--pr` overrides `no_pr` config.

Committing

Command	Description
`ez commit -m "msg"`	Commit the current staged set + restack children
`ez commit -am "msg"`	Stage tracked files + commit
`ez commit -m "msg" -- path1 path2`	Stage specific files + commit
`ez commit --if-changed`	No-op if nothing staged
`ez amend`	Amend last commit + restack

Intended workflow:

Focused commit: ez commit -m "msg" -- path1 path2
Bulk update: ez commit -am "msg"
Partial hunks: git add -p then ez commit -m "msg"

Scope

Command	Description
`ez scope show`	Show the current branch's configured scope
`ez scope add <pattern...>`	Append patterns to the current branch's scope
`ez scope set <pattern...>`	Replace the current branch's scope
`ez scope clear`	Remove scope configuration from the current branch

Syncing

Command	Description
`ez sync`	Fetch trunk, clean merged branches, restack
`ez sync --autostash`	Stash before sync, restore after
`ez sync --dry-run`	Preview what sync would do
`ez restack`	Fetch trunk, refresh it locally, and rebase stale branches onto their latest parent tips

Navigation

Command	Description
`ez switch <name>`	Switch to branch (cd's to worktree if applicable)
`ez switch <pr-number>`	Switch by PR number
`ez up` / `ez down`	Navigate the stack
`ez top` / `ez bottom`	Jump to stack endpoints

Inspection

Command	Description
`ez log`	Visual stack tree with PR status
`ez log --json`	Stack as JSON
`ez status`	Branch info + working tree state
`ez status --json`	Branch info as JSON
`ez diff`	Diff vs parent (what the PR reviewer sees)
`ez diff --stat`	Diffstat summary
`ez diff --name-only`	Changed file names
`ez parent`	Print parent branch name to stdout

PRs

Command	Description
`ez submit`	Push entire stack + create/update all PRs
`ez pr-link`	Print PR URL to stdout
`ez pr-edit --title "..." --body "..."`	Edit PR metadata
`ez draft` / `ez ready`	Toggle PR draft status
`ez merge`	Merge bottom PR via GitHub
`ez merge --yes`	Merge non-interactively for agents/scripts
`ez merge --stack --yes`	Merge the current linear stack bottom-to-top

Setup

Command	Description
`ez init --yes`	Initialize ez and accept recommended non-interactive defaults
`ez setup --yes`	Configure shell integration
`ez config list/get/set`	View or update repo settings such as `default_from`, `draft`, `no_pr`, and `rerere`
`ez skill install`	Install the ez-workflow skill for AI agents
`ez update`	Update to latest version

Agent Integration

Install the skill so agents auto-discover ez:

ez skill install

This writes the canonical skill to .agents/skills/ez-workflow/SKILL.md, then creates compatibility symlinks for agent-specific skill roots such as .claude/skills/ez-workflow and .codex/skills/ez-workflow.

See SKILL.md for the full agent workflow, and reference.md for the complete command reference.

How It Works

Worktrees give each agent an isolated copy of the repo with its own branch
Stack metadata in .git/ez/stack.json tracks branch parents and PR numbers
Auto-restacking via git rebase --onto keeps children up to date when parents change
Mutation receipts (JSON on stderr) let agents verify every operation
Progressive help — ez, ez <cmd>, ez <cmd> --help each give more detail

Prerequisites

git 2.38+
gh (GitHub CLI), authenticated via gh auth login
Python 3.8+ (for pip install) or download binaries from Releases

License

MIT. See LICENSE for details.

Development Status
- 4 - Beta
Environment
- Console
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Operating System
- MacOS
- POSIX :: Linux
Programming Language
- Rust
Topic
- Software Development :: Version Control :: Git

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ez_stack-0.2.29-py3-none-manylinux_2_17_x86_64.whl (850.9 kB view details)

Uploaded Jul 28, 2026 Python 3manylinux: glibc 2.17+ x86-64

ez_stack-0.2.29-py3-none-manylinux_2_17_aarch64.whl (791.8 kB view details)

Uploaded Jul 28, 2026 Python 3manylinux: glibc 2.17+ ARM64

ez_stack-0.2.29-py3-none-macosx_11_0_arm64.whl (764.5 kB view details)

Uploaded Jul 28, 2026 Python 3macOS 11.0+ ARM64

ez_stack-0.2.29-py3-none-macosx_10_12_x86_64.whl (815.9 kB view details)

Uploaded Jul 28, 2026 Python 3macOS 10.12+ x86-64

File details

Details for the file ez_stack-0.2.29-py3-none-manylinux_2_17_x86_64.whl.

File metadata

Download URL: ez_stack-0.2.29-py3-none-manylinux_2_17_x86_64.whl
Upload date: Jul 28, 2026
Size: 850.9 kB
Tags: Python 3, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for ez_stack-0.2.29-py3-none-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`7f738851264b8fbe3f19e792ac1c777f0a9d974ea13ab4279966c3deb0d51a25`
MD5	`3beda27d57af9658b83a9dbbdbfd6bf5`
BLAKE2b-256	`08ac8180e0fef949aaadbab9ff072e14e8d8280c39d23d96b40b9468962dc5d8`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ez_stack-0.2.29-py3-none-manylinux_2_17_x86_64.whl:

Publisher: python-wheel.yml on rohoswagger/ez-stack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ez_stack-0.2.29-py3-none-manylinux_2_17_x86_64.whl
- Subject digest: 7f738851264b8fbe3f19e792ac1c777f0a9d974ea13ab4279966c3deb0d51a25
- Sigstore transparency entry: 2274848205
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: rohoswagger/ez-stack@62d3954c4d336f2c42701e31a39bb396fbe3a3de
- Branch / Tag: refs/tags/v0.2.29
- Owner: https://github.com/rohoswagger
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-wheel.yml@62d3954c4d336f2c42701e31a39bb396fbe3a3de
- Trigger Event: push

File details

Details for the file ez_stack-0.2.29-py3-none-manylinux_2_17_aarch64.whl.

File metadata

Download URL: ez_stack-0.2.29-py3-none-manylinux_2_17_aarch64.whl
Upload date: Jul 28, 2026
Size: 791.8 kB
Tags: Python 3, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for ez_stack-0.2.29-py3-none-manylinux_2_17_aarch64.whl
Algorithm	Hash digest
SHA256	`28a139a65bba5bf3a703da6cadab5b0b4d3b6bb3aef73da9cc1308a8100eba15`
MD5	`6f2887a79f4b36516395b68965565409`
BLAKE2b-256	`60e9c72160c2ae83b042a9e72be35493f4bf6abb697c96f46a9a3a085b924ffe`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ez_stack-0.2.29-py3-none-manylinux_2_17_aarch64.whl:

Publisher: python-wheel.yml on rohoswagger/ez-stack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ez_stack-0.2.29-py3-none-manylinux_2_17_aarch64.whl
- Subject digest: 28a139a65bba5bf3a703da6cadab5b0b4d3b6bb3aef73da9cc1308a8100eba15
- Sigstore transparency entry: 2274847949
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: rohoswagger/ez-stack@62d3954c4d336f2c42701e31a39bb396fbe3a3de
- Branch / Tag: refs/tags/v0.2.29
- Owner: https://github.com/rohoswagger
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-wheel.yml@62d3954c4d336f2c42701e31a39bb396fbe3a3de
- Trigger Event: push

File details

Details for the file ez_stack-0.2.29-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: ez_stack-0.2.29-py3-none-macosx_11_0_arm64.whl
Upload date: Jul 28, 2026
Size: 764.5 kB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for ez_stack-0.2.29-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`8aa5101d5e1c80e64ae7600df6ae70a20abce46f247fa3aa1c440030b32bcdf7`
MD5	`5086356f9e93e73d79ff94fd0b882fc8`
BLAKE2b-256	`4d864e1b19562a0ff6cdf4434c62a461d5314070d8b47dd1a2b3e4e464b6f076`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ez_stack-0.2.29-py3-none-macosx_11_0_arm64.whl:

Publisher: python-wheel.yml on rohoswagger/ez-stack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ez_stack-0.2.29-py3-none-macosx_11_0_arm64.whl
- Subject digest: 8aa5101d5e1c80e64ae7600df6ae70a20abce46f247fa3aa1c440030b32bcdf7
- Sigstore transparency entry: 2274848958
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: rohoswagger/ez-stack@62d3954c4d336f2c42701e31a39bb396fbe3a3de
- Branch / Tag: refs/tags/v0.2.29
- Owner: https://github.com/rohoswagger
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-wheel.yml@62d3954c4d336f2c42701e31a39bb396fbe3a3de
- Trigger Event: push

File details

Details for the file ez_stack-0.2.29-py3-none-macosx_10_12_x86_64.whl.

File metadata

Download URL: ez_stack-0.2.29-py3-none-macosx_10_12_x86_64.whl
Upload date: Jul 28, 2026
Size: 815.9 kB
Tags: Python 3, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for ez_stack-0.2.29-py3-none-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`0a3e74b71ab8e20a6391cbc18f47ec72d2252188b9a358cceb75abddeb898d1f`
MD5	`735c9d3db92980cfbe6b4ee0dbd5eb87`
BLAKE2b-256	`7760a92de3712aae33030bb3871c317843467dd13214c786d5188b0c4cf3f58a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ez_stack-0.2.29-py3-none-macosx_10_12_x86_64.whl:

Publisher: python-wheel.yml on rohoswagger/ez-stack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ez_stack-0.2.29-py3-none-macosx_10_12_x86_64.whl
- Subject digest: 0a3e74b71ab8e20a6391cbc18f47ec72d2252188b9a358cceb75abddeb898d1f
- Sigstore transparency entry: 2274848590
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: rohoswagger/ez-stack@62d3954c4d336f2c42701e31a39bb396fbe3a3de
- Branch / Tag: refs/tags/v0.2.29
- Owner: https://github.com/rohoswagger
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-wheel.yml@62d3954c4d336f2c42701e31a39bb396fbe3a3de
- Trigger Event: push

Release history Release notifications | RSS feed

0.3.4

Aug 12, 2026

0.3.3

Aug 11, 2026

0.3.2

Aug 6, 2026

0.3.1

Aug 3, 2026

0.3.0

Aug 1, 2026

This release

0.2.29

Jul 28, 2026

0.2.28

Jun 23, 2026

0.2.27

May 21, 2026

0.2.24

May 13, 2026

0.2.23

May 9, 2026

0.2.22

Apr 11, 2026

0.2.21

Apr 10, 2026

0.2.20

Apr 6, 2026

0.2.19

Apr 4, 2026

0.2.18

Apr 3, 2026

0.2.17

Apr 2, 2026

0.2.16

Apr 1, 2026

0.2.15

Mar 31, 2026

0.2.14

Mar 31, 2026

0.2.13

Mar 31, 2026

0.2.12

Mar 31, 2026

0.2.11

Mar 31, 2026

ez-stack 0.2.29

ez

Install

The 4 Commands

Why ez?

Dashboard

Multi-Agent Workflow

Stacked PRs

Scope Guard

Worktree Hooks

All Commands

Flagship

Committing

Scope

Syncing

Navigation

Inspection

PRs

Setup

Agent Integration

How It Works

Prerequisites

License

Project links

Key dates

1 maintainer

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed