Mars

Mars

[](https://opensource.org/licenses/MIT) [](https://www.npmjs.com/package/@dean0x/mars) [](https://github.com/dean0x/mars/actions/workflows/ci.yml) [](https://dean0x.github.io/x/mars/)

Manage multiple Git repositories as one workspace.

Tag-based filtering, parallel operations, zero dependencies.

Why Mars?

Coding agents can take features end-to-end in one repo — but most real engineering spans many. Mars creates a workspace where all repos live under one tree, so agents inherit shared config and developers get coordinated operations across the stack.

• Workspace-level agent config — config at the workspace root is inherited by every repo automatically
• Coordinated branches — mars branch feature-x --tag backend across all relevant repos
• Tag-based filtering — target subsets of repos (--tag frontend, --tag backend)
• Zero dependencies — pure bash 3.2+, works on macOS out of the box

Quick Install

npm install -g @dean0x/mars

See [all installation methods](#installation) for Homebrew, curl, and manual options.

Quick Start

mkdir my-project && cd my-project
mars init

mars add https://github.com/dean0x/mars-example-frontend.git --tags frontend,web
mars add https://github.com/dean0x/mars-example-backend.git --tags backend,api
mars add https://github.com/dean0x/mars-example-shared.git --tags shared

mars clone
mars status

Commands

Command	Description
mars init	Initialize a new workspace
mars add [--tags t1,t2]	Add a repository to config
mars clone [--tag TAG]	Clone configured rep