mars
A package manager for AI agent profiles and skills. Install agents and skills from git sources into Claude Code, Codex, OpenCode, Cursor, and other agent harness config directories.
Target Status
Mars materializes harness-native artifacts for multiple targets:
| Target | Status | Notes |
|---|---|---|
.claude |
First-class | Claude Code agents, skills, MCP, hooks, and settings surfaces. |
.codex |
First-class | Codex project instruction and agent-facing surfaces. |
.opencode |
First-class | OpenCode agent and permission surfaces. |
.cursor |
Experimental | Cursor CLI/config support exists, but semantics can change as Cursor's agent surface evolves. |
.pi |
Future first-class | Meridian-owned Pi flavor and extension surface; under active design/development. |
Install
| Method | Command |
|---|---|
| Cargo | cargo install mars-agents |
| pip / uv | uv tool install mars-agents or pip install mars-agents |
| npm | npm install -g @meridian-flow/mars-agents |
| Prebuilt binaries | GitHub Releases |
Quick Start
mars init
mars add meridian-flow/meridian-dev-workflow
mars link .claude
mars link .codex
Your agents and skills are now installed and available in both Claude Code and Codex. Update them with mars upgrade, check for drift with mars doctor.
Adding Sources
# From GitHub
mars add meridian-flow/meridian-base
mars add acme/security-agents --only-agents
# From a local directory
mars add ../my-team-agents
# Pin a version
mars add meridian-flow/meridian-base@^1.0
Model Aliases
Packages can distribute model routing — short names that resolve to concrete models across harnesses:
mars models list
mars models resolve opus
# In mars.toml — override any alias
[models.opus]
harness = "claude"
provider = "Anthropic"
match = ["*opus*"]
How It Works
flowchart TD
sources["mars.toml + mars.lock<br/><i>committed</i>"]
local[".mars-src/<br/><i>your own agents, skills, MCP, hooks</i>"]
git["git sources<br/><i>resolved from mars.toml</i>"]
canonical[".mars/<br/><i>canonical store, gitignored</i>"]
agents["agents/ + skills/"]
mcp["mcp servers"]
hooks["lifecycle hooks"]
claude[".claude/"]
codex[".codex/"]
cursor[".cursor/"]
opencode[".opencode/"]
sources --> |mars sync| canonical
local --> canonical
git --> canonical
canonical --- agents
canonical --- mcp
canonical --- hooks
canonical --> |mars link| claude
canonical --> |mars link| codex
canonical --> |mars link| cursor
canonical --> |mars link| opencode
Mars resolves the full dependency graph before touching any files. Writes are atomic. The lock file tracks what mars manages so it never touches your files. Each linked target gets harness-native artifacts — agents, skills, MCP servers, and hooks compiled to match what that tool expects.
Use mars adopt to bring an existing unmanaged file into .mars-src/ in one step.
Docs
- Config —
mars.toml, agent profiles, compilation, MCP/hooks - CLI — every command with flags and examples
- Internals — sync pipeline, lock file, conflicts
- Dev — local development, troubleshooting, smoke testing
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mars_agents-0.12.0.tar.gz.
File metadata
- Download URL: mars_agents-0.12.0.tar.gz
- Upload date:
- Size: 749.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6c025bb4f4a080e7ce4094b5196c52d5f5457bc57a588c00fc959dd88369974e
|
|
| MD5 |
79a2c66e11c8c5ad9c8b1c03191c4e15
|
|
| BLAKE2b-256 |
dfb4eb3f50ac9cfb5c24f3f0187bb012776aa847401f5a8ae23f69baef0013c1
|
Provenance
The following attestation bundles were made for mars_agents-0.12.0.tar.gz:
Publisher:
release.yml on haowjy/mars-agents
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mars_agents-0.12.0.tar.gz -
Subject digest:
6c025bb4f4a080e7ce4094b5196c52d5f5457bc57a588c00fc959dd88369974e - Sigstore transparency entry: 2253674788
- Sigstore integration time:
-
Permalink:
haowjy/mars-agents@6735338c4d87e04abd5029be8c026025970efa67 -
Branch / Tag:
refs/tags/v0.12.0 - Owner: https://github.com/haowjy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6735338c4d87e04abd5029be8c026025970efa67 -
Trigger Event:
push
-
Statement type:
File details
Details for the file mars_agents-0.12.0-py3-none-win_amd64.whl.
File metadata
- Download URL: mars_agents-0.12.0-py3-none-win_amd64.whl
- Upload date:
- Size: 3.6 MB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
443c7106e375cf5950dbf4610b68bb1921e449f62f560603e5fd1a616d1ed7aa
|
|
| MD5 |
6b6b68524d1a15b0179fc6c7dbbf8212
|
|
| BLAKE2b-256 |
0cf1711286a86ce19a27bbd96c240b2a161957b210afe0a1be092ba4d762447f
|
Provenance
The following attestation bundles were made for mars_agents-0.12.0-py3-none-win_amd64.whl:
Publisher:
release.yml on haowjy/mars-agents
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mars_agents-0.12.0-py3-none-win_amd64.whl -
Subject digest:
443c7106e375cf5950dbf4610b68bb1921e449f62f560603e5fd1a616d1ed7aa - Sigstore transparency entry: 2253675041
- Sigstore integration time:
-
Permalink:
haowjy/mars-agents@6735338c4d87e04abd5029be8c026025970efa67 -
Branch / Tag:
refs/tags/v0.12.0 - Owner: https://github.com/haowjy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6735338c4d87e04abd5029be8c026025970efa67 -
Trigger Event:
push
-
Statement type:
File details
Details for the file mars_agents-0.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: mars_agents-0.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 3.6 MB
- 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8318677d9ac95711f39dea6b8953a856bdc36598906675353fd98d7568891601
|
|
| MD5 |
aeb1a9964eab412c795ec1c55e888947
|
|
| BLAKE2b-256 |
78351ea88a00d847050cd8e05fc8b1cca72c6d908a9a200ae936fd1a6581c1e3
|
Provenance
The following attestation bundles were made for mars_agents-0.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:
Publisher:
release.yml on haowjy/mars-agents
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mars_agents-0.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl -
Subject digest:
8318677d9ac95711f39dea6b8953a856bdc36598906675353fd98d7568891601 - Sigstore transparency entry: 2253675869
- Sigstore integration time:
-
Permalink:
haowjy/mars-agents@6735338c4d87e04abd5029be8c026025970efa67 -
Branch / Tag:
refs/tags/v0.12.0 - Owner: https://github.com/haowjy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6735338c4d87e04abd5029be8c026025970efa67 -
Trigger Event:
push
-
Statement type:
File details
Details for the file mars_agents-0.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: mars_agents-0.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 3.4 MB
- 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
85e697ad161b5b27120ca0f2eaa6903089db1a9f185de85a75481cee1c18ae3e
|
|
| MD5 |
53b604350c2d0b7905603a1435bc76f2
|
|
| BLAKE2b-256 |
d31363242016ae80f4605862e5cb6e89e0a17230078ec86fc6c4c2de79d7aeb8
|
Provenance
The following attestation bundles were made for mars_agents-0.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:
Publisher:
release.yml on haowjy/mars-agents
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mars_agents-0.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl -
Subject digest:
85e697ad161b5b27120ca0f2eaa6903089db1a9f185de85a75481cee1c18ae3e - Sigstore transparency entry: 2253675235
- Sigstore integration time:
-
Permalink:
haowjy/mars-agents@6735338c4d87e04abd5029be8c026025970efa67 -
Branch / Tag:
refs/tags/v0.12.0 - Owner: https://github.com/haowjy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6735338c4d87e04abd5029be8c026025970efa67 -
Trigger Event:
push
-
Statement type:
File details
Details for the file mars_agents-0.12.0-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: mars_agents-0.12.0-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 3.3 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f33a44b72a09526cfd2d225a12211118c53c1c62d7a91e4d15e3d87c95c19e02
|
|
| MD5 |
8b7ce6cf14e0f1cec04fa9fb455ad2e4
|
|
| BLAKE2b-256 |
9fa173abf64e091f90b9635fd6d08664a593a7078bd4cc3d9b7f6732c5b0c6fd
|
Provenance
The following attestation bundles were made for mars_agents-0.12.0-py3-none-macosx_11_0_arm64.whl:
Publisher:
release.yml on haowjy/mars-agents
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mars_agents-0.12.0-py3-none-macosx_11_0_arm64.whl -
Subject digest:
f33a44b72a09526cfd2d225a12211118c53c1c62d7a91e4d15e3d87c95c19e02 - Sigstore transparency entry: 2253675671
- Sigstore integration time:
-
Permalink:
haowjy/mars-agents@6735338c4d87e04abd5029be8c026025970efa67 -
Branch / Tag:
refs/tags/v0.12.0 - Owner: https://github.com/haowjy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6735338c4d87e04abd5029be8c026025970efa67 -
Trigger Event:
push
-
Statement type:
File details
Details for the file mars_agents-0.12.0-py3-none-macosx_10_12_x86_64.whl.
File metadata
- Download URL: mars_agents-0.12.0-py3-none-macosx_10_12_x86_64.whl
- Upload date:
- Size: 3.5 MB
- 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
17d9bd7b5a9b2f7661316943094506cb6628ce112e1fd441a89c9d53b10c9ddd
|
|
| MD5 |
12fd9f7d70f965ac3ba154375debd827
|
|
| BLAKE2b-256 |
ee6a775cb89acb8854f9de09ba669d17edf097852fb2a50b5a8922fcb7f6eced
|
Provenance
The following attestation bundles were made for mars_agents-0.12.0-py3-none-macosx_10_12_x86_64.whl:
Publisher:
release.yml on haowjy/mars-agents
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mars_agents-0.12.0-py3-none-macosx_10_12_x86_64.whl -
Subject digest:
17d9bd7b5a9b2f7661316943094506cb6628ce112e1fd441a89c9d53b10c9ddd - Sigstore transparency entry: 2253675469
- Sigstore integration time:
-
Permalink:
haowjy/mars-agents@6735338c4d87e04abd5029be8c026025970efa67 -
Branch / Tag:
refs/tags/v0.12.0 - Owner: https://github.com/haowjy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6735338c4d87e04abd5029be8c026025970efa67 -
Trigger Event:
push
-
Statement type:
