rohansx

Workz — Development skill for Claude Code

Development community

The environment engine for agent worktrees - zero-config dep sync + port/DB/compose isolation.

How to install Workz

This entry records only its repository, not the path inside it, so there is no exact command to give. Open rohansx/workz and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Workz does

The environment engine for agent worktrees - zero-config dep sync + port/DB/compose isolation.

Alternatives in Development

  • Microsandbox — Open-source self-hosted MicroVM sandboxes with sub-200ms startup, hardware-level isolation via libkrun 5k ★
  • Octo Doctor — Environment diagnostics — check providers, auth, config, hooks, scheduler, and more 2.8k ★
  • Dotenv Vault — Sync environment variables across machines for consistent Claude Code behavior 1.2k ★

README

workz — the environment engine for agent worktrees

CI rust license size

Your agent creates the worktree — workz makes it run.
Dependencies linked, .env copied, a unique port range, its own database and compose project. Zero config.

workz-explainer-under5MB


Why

Claude Code, Cursor, and Codex all create git worktrees for parallel work now. But a fresh worktree is inert:

git worktree add ../feature-x feature/x && cd ../feature-x
# .env? gone.   node_modules? gone — reinstall and wait.
# dev-server port? same as every other worktree.   database? shared.

Every one of those tools ships a *worktree-create hook* and tells you to write the setup command yourself. **workz is that command** — and it's the only tool that also gives each worktree its own ports, database, and compose project.

Quickstart

# 1. install
cargo install workz          # or: brew install rohansx/tap/workz

# 2. in your repo — guided setup (detects your stack, writes .workz.toml)
workz init

# 3. spin up an isolated worktree that's ready to run
workz start feature/checkout --isolated

That's it: `node_modules` symlinked, `.env` copied, `PORT=3000-3009`, `DB_NAME` and `COMPOSE_PROJECT_NAME` set — you're dropped into a worktree you