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.
Published packages can declare requires-mars and requires-meridian under
[package]. Mars automatically falls back to the newest compatible package
release; see the mars.toml reference.
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
Metadata
1 maintainer
Release files for mars-agents 0.14.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mars_agents-0.14.1.tar.gz | 789.7 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| mars_agents-0.14.1-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| mars_agents-0.14.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| mars_agents-0.14.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| mars_agents-0.14.1-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| mars_agents-0.14.1-py3-none-macosx_10_12_x86_64.whl | Python 3 | none | macOS 10.12+ x86-64 | Details |
Total release size: 18.9 MB
Release files / mars_agents-0.14.1.tar.gz
| Download URL | mars_agents-0.14.1.tar.gz |
|---|---|
| Size | 789.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
077219352b2bd17eba18eab27bb099ab75012835d0501a2663e1eedfa1267e2b
|
|
BLAKE2b-256 checksum How to use checksums |
b0144d6860e2d29955f1e5501f8cfa3a9f54cf55d6f899f5be44e95aabd96b42
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / mars_agents-0.14.1-py3-none-win_amd64.whl
| Download URL | mars_agents-0.14.1-py3-none-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
b1a501d59dd44ba2d2906580200f18a7ccfb4c20a0c7674543d03d2b079e7c05
|
|
BLAKE2b-256 checksum How to use checksums |
146c48fbba5116365998058939aaf9812cab42eea8bdd6bf49a73eb208155347
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / mars_agents-0.14.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | mars_agents-0.14.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
d61ebf18b797216135bb301aa244850abc65dbb3ee10035954bf6412e7486d6e
|
|
BLAKE2b-256 checksum How to use checksums |
196666011bc851ed09332d99b8372c5ca80fc60fa45e60a6c56827e79648270b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / mars_agents-0.14.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | mars_agents-0.14.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.5 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
75bd2daac4d85b6597ca04d7f718228c4f3c779c908f1507982991fdc1ff6efc
|
|
BLAKE2b-256 checksum How to use checksums |
ad048fa6b111c704e5f2f22d214d845758a3e372596b71e733159ccab81570b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / mars_agents-0.14.1-py3-none-macosx_11_0_arm64.whl
| Download URL | mars_agents-0.14.1-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.5 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2093dffe9ae9a58413cb0ccf53eb23977eecb9e46063a1dedeb9184f1af831b5
|
|
BLAKE2b-256 checksum How to use checksums |
c7128a5534c7884f2fe30df9b7b90665b2ce994730e1cd535fe8760aa1fb8f3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / mars_agents-0.14.1-py3-none-macosx_10_12_x86_64.whl
| Download URL | mars_agents-0.14.1-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
f5847f5001640c4344752affa0548f6ae6d6bfb4b277c9ad6586c2b3230a815d
|
|
BLAKE2b-256 checksum How to use checksums |
3120c48ce7555e7dbfa84dd61e969b1367b2426515c14cb5b6809f948388acf9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency log
