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

Development Status
- 3 - Alpha
License
- OSI Approved :: MIT License
Programming Language
- Rust
Topic
- Software Development :: Build Tools

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mars_agents-0.12.1.tar.gz (749.8 kB view details)

Uploaded Jul 28, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mars_agents-0.12.1-py3-none-win_amd64.whl (3.6 MB view details)

Uploaded Jul 28, 2026 Python 3Windows x86-64

mars_agents-0.12.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.6 MB view details)

Uploaded Jul 28, 2026 Python 3manylinux: glibc 2.17+ x86-64

mars_agents-0.12.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (3.4 MB view details)

Uploaded Jul 28, 2026 Python 3manylinux: glibc 2.17+ ARM64

mars_agents-0.12.1-py3-none-macosx_11_0_arm64.whl (3.3 MB view details)

Uploaded Jul 28, 2026 Python 3macOS 11.0+ ARM64

mars_agents-0.12.1-py3-none-macosx_10_12_x86_64.whl (3.5 MB view details)

Uploaded Jul 28, 2026 Python 3macOS 10.12+ x86-64

File details

Details for the file mars_agents-0.12.1.tar.gz.

File metadata

Download URL: mars_agents-0.12.1.tar.gz
Upload date: Jul 28, 2026
Size: 749.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for mars_agents-0.12.1.tar.gz
Algorithm	Hash digest
SHA256	`9cf7d14d47e71dc17b50ddc53c2eda5fcf61a684a9b2fb8c08ff40beebfb4501`
MD5	`19e60bd6b9db4b42f8781e0fad551c6b`
BLAKE2b-256	`5666d5bd9a2dd580453f20da5a9e7a4babc04112d280ba53cb9a3f4664bd5a90`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mars_agents-0.12.1.tar.gz:

Publisher: release.yml on haowjy/mars-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mars_agents-0.12.1.tar.gz
- Subject digest: 9cf7d14d47e71dc17b50ddc53c2eda5fcf61a684a9b2fb8c08ff40beebfb4501
- Sigstore transparency entry: 2274205052
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: haowjy/mars-agents@f3b1783862f52ae17d72d56c931d47d705c1375b
- Branch / Tag: refs/tags/v0.12.1
- Owner: https://github.com/haowjy
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f3b1783862f52ae17d72d56c931d47d705c1375b
- Trigger Event: push

File details

Details for the file mars_agents-0.12.1-py3-none-win_amd64.whl.

File metadata

Download URL: mars_agents-0.12.1-py3-none-win_amd64.whl
Upload date: Jul 28, 2026
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

Hashes for mars_agents-0.12.1-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`72d17867820dbd558c807fbafa378cc6697aeca77861d1bdf07c805f083c010b`
MD5	`44ba042f9f41a24920bccf655d907c88`
BLAKE2b-256	`fc94ff6ebf7b33069d3f70ee1f6c70783c078fa9b69e971f360952e812376d23`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mars_agents-0.12.1-py3-none-win_amd64.whl:

Publisher: release.yml on haowjy/mars-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mars_agents-0.12.1-py3-none-win_amd64.whl
- Subject digest: 72d17867820dbd558c807fbafa378cc6697aeca77861d1bdf07c805f083c010b
- Sigstore transparency entry: 2274205184
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: haowjy/mars-agents@f3b1783862f52ae17d72d56c931d47d705c1375b
- Branch / Tag: refs/tags/v0.12.1
- Owner: https://github.com/haowjy
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f3b1783862f52ae17d72d56c931d47d705c1375b
- Trigger Event: push

File details

Details for the file mars_agents-0.12.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: mars_agents-0.12.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 28, 2026
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

Hashes for mars_agents-0.12.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`955cfff9cfc8c94b85fc6550cf2027855c419d69af40ecc69faacdeeca355a71`
MD5	`c85a9fe054ce31531b7a8435a3e498e1`
BLAKE2b-256	`592364a75d747835232035e21f0b539ea87ae9f832ec0f17265bb1f2a339f1da`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mars_agents-0.12.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on haowjy/mars-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mars_agents-0.12.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: 955cfff9cfc8c94b85fc6550cf2027855c419d69af40ecc69faacdeeca355a71
- Sigstore transparency entry: 2274205115
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: haowjy/mars-agents@f3b1783862f52ae17d72d56c931d47d705c1375b
- Branch / Tag: refs/tags/v0.12.1
- Owner: https://github.com/haowjy
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f3b1783862f52ae17d72d56c931d47d705c1375b
- Trigger Event: push

File details

Details for the file mars_agents-0.12.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: mars_agents-0.12.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jul 28, 2026
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

Hashes for mars_agents-0.12.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`58752993cec628e8b05f42f9f3fe8ab6c00f06dcdf184c9c858f30e60fb7c331`
MD5	`0b360398d3cf9eb492c75152a67de86f`
BLAKE2b-256	`1a63aca2aadebbbe2c86c849394f42221cf8942a8b54daf1cb05487550d3b0a0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mars_agents-0.12.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on haowjy/mars-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mars_agents-0.12.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: 58752993cec628e8b05f42f9f3fe8ab6c00f06dcdf184c9c858f30e60fb7c331
- Sigstore transparency entry: 2274205387
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: haowjy/mars-agents@f3b1783862f52ae17d72d56c931d47d705c1375b
- Branch / Tag: refs/tags/v0.12.1
- Owner: https://github.com/haowjy
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f3b1783862f52ae17d72d56c931d47d705c1375b
- Trigger Event: push

File details

Details for the file mars_agents-0.12.1-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: mars_agents-0.12.1-py3-none-macosx_11_0_arm64.whl
Upload date: Jul 28, 2026
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

Hashes for mars_agents-0.12.1-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`ce6a4faac17e15705d2cd5ae93e45c781d496a64d472ed6ea24c7309e325b742`
MD5	`4036045c69d2a0c64acf198c3f54e610`
BLAKE2b-256	`2ad5ebf1754d480f492470adc766de65205564facadf0d7c25b37eefe451c765`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mars_agents-0.12.1-py3-none-macosx_11_0_arm64.whl:

Publisher: release.yml on haowjy/mars-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mars_agents-0.12.1-py3-none-macosx_11_0_arm64.whl
- Subject digest: ce6a4faac17e15705d2cd5ae93e45c781d496a64d472ed6ea24c7309e325b742
- Sigstore transparency entry: 2274205318
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: haowjy/mars-agents@f3b1783862f52ae17d72d56c931d47d705c1375b
- Branch / Tag: refs/tags/v0.12.1
- Owner: https://github.com/haowjy
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f3b1783862f52ae17d72d56c931d47d705c1375b
- Trigger Event: push

File details

Details for the file mars_agents-0.12.1-py3-none-macosx_10_12_x86_64.whl.

File metadata

Download URL: mars_agents-0.12.1-py3-none-macosx_10_12_x86_64.whl
Upload date: Jul 28, 2026
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

Hashes for mars_agents-0.12.1-py3-none-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`96c0cb25ec415332271df1f959fe10c53e48292779a8eab6f49a435d64d00200`
MD5	`72d8b94a5a74bae7c5bed0de6f9fc29f`
BLAKE2b-256	`07bb5ae54babb51704eeed5d29d02b2c9d14fa6075dfc056a95001bafdf8a85b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mars_agents-0.12.1-py3-none-macosx_10_12_x86_64.whl:

Publisher: release.yml on haowjy/mars-agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mars_agents-0.12.1-py3-none-macosx_10_12_x86_64.whl
- Subject digest: 96c0cb25ec415332271df1f959fe10c53e48292779a8eab6f49a435d64d00200
- Sigstore transparency entry: 2274205254
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: haowjy/mars-agents@f3b1783862f52ae17d72d56c931d47d705c1375b
- Branch / Tag: refs/tags/v0.12.1
- Owner: https://github.com/haowjy
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f3b1783862f52ae17d72d56c931d47d705c1375b
- Trigger Event: push