exec

virtual-monorepo:exec

Run a shell command in every worktree of a branch-based workspace. Useful for cross-repo git status, build, lint, or any per-repo task.

This is the general-purpose exec primitive that backs virtual-monorepo:test — virtual-monorepo:test picks the per-repo command and virtual-monorepo:exec-style logic runs it. Keep virtual-monorepo:exec for ad-hoc commands; reach for virtual-monorepo:test when the user means "run the test suites".

When to use

• "run npm test in every repo of JIRA-123"
• "show git status across the workspace"
• "exec make lint in the ABC-42 worktrees"
• Any time the user wants to fan a command out across all repos in a workspace.

Inputs

• <branch> (required, positional): the workspace key.
• -- (separator, required): everything after -- is the command to run.
• --root=… / --repos=… / --workspace-dir=… / --worktree-root=… — same as virtual-monorepo:init.

What it does

For each repo:

1. cd <worktree_root>/<branch>/<repo>.
2. Print a header === <repo> ===.
3. Run the command via bash -c.
4. Print a footer with the exit code.

Runs sequentially. Continues through all repos even if one fails, then exits non-zero if any failed. Output is interleaved with headers so the user can see which repo produced what.

How to invoke

bash "$CLAUDE_PROJECT_DIR/skills/exec/exec.sh" <branch> [flags…] -- <command>

Examples

bash skills/exec/exec.sh JIRA-123 -- git status -s
bash skills/exec/exec.sh JIRA-123 -- make test
bash skills/exec/exec.sh JIRA-123 --root=https://… -- 'echo "hi from $(basename $PWD)"'

Notes

• The command runs through bash -c "$CMD", so shell features (pipes, variables, quoting) work — but quote carefully on the caller side.
• $PWD inside the command is the worktree directory.