etz

etz is a CLI for managing multi-repo workspaces where the parent folder is not a git repo and each direct child folder is an independent git repo.

It creates coordinated git worktrees under:

• parent/.etz/workspaces/<workspace>/<repo>

Commands

• etz init
• etz add <workspace> --branch <branch> [--no-copy-root]
• etz list
• etz refresh [--check] [--json]
• etz status [workspace] [--changed] [--summary] [--json]
• etz commit [workspace] -m "msg" [--all] [--dry-run] [--json]
• etz push [workspace] [--dry-run] [--json]
• etz remove <workspace> [--force]
• etz prune
• etz doctor [--fix] [--json]

Behavior Highlights

• Repo discovery is direct children only.
• Missing branch on add is auto-created from each repo's detected default branch.
• refresh re-discovers direct-child repos and updates the manifest lock file.
• refresh --check reports drift and exits non-zero without mutating files.
• add copies non-repo files/directories from the parent root into the workspace root by default.
• Use --no-copy-root to disable that copy behavior.
• Optional .etzcopy and .etzignore patterns let you include/exclude root files copied into a workspace.
• add and remove are fail-fast and attempt rollback on partial failures.
• If you run etz from inside .etz/workspaces/<workspace>/..., status, commit, and push infer the workspace automatically.
• status includes per-repo staged/unstaged/untracked counts.
• status --changed filters to changed repos; status --summary prints condensed totals.
• commit works across repos in one workspace:
  • default: commits only repos with staged changes
  • smart fallback: if nothing is staged but tracked files changed, it auto-stages tracked changes (git add -u) and commits
  • --all: stages all tracked + untracked changes (git add -A) first
  • --dry-run: shows what would be committed and what would be auto-staged, without changing any repo
  • on failure in later repos, previously created commits from this run are rolled back with git reset --soft HEAD~1
• push pushes repos that are ahead of upstream; --dry-run previews push candidates.
• doctor --fix can prune stale workspace state entries and attempt branch realignment where safe.
• State is persisted in:
  • .etz/config.toml
  • .etz/manifest.lock.toml
  • .etz/state.toml

Installation

See INSTALLATION.md for all install options (Cargo, Homebrew, binaries, source build).

Quick Start

# inside parent folder that contains git child repos
etz init
etz add feat-auth --branch feat-auth
etz status feat-auth

# after making/staging changes
etz commit feat-auth -m "feat: implement auth flow"

# cleanup
etz remove feat-auth