mars-agents 0.1.20

Agent package manager for .agents/ directories

mars

A package manager for AI agent profiles and skills. Install agents and skills from git sources into Claude Code, Cursor, Codex, OpenCode — any tool that reads from a config directory.

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

mars.toml + mars.lock (committed)
.mars-src/              ← your own agents/skills (committed, editable)
    ↓ mars sync
  .mars/                ← canonical store, gitignored (rebuilt from sources)
    ↓ copy to each target
  .agents/, .claude/, .cursor/ (your tools read from here)

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.

Use mars adopt to bring an existing unmanaged file into .mars-src/ in one step.

Docs

• Configuration — mars.toml reference, filters, model aliases, merge precedence
• CLI Reference — every command with flags and examples
• Sync Pipeline — how resolve → plan → apply works
• Conflicts — collision handling and resolution
• Local Development — overrides, local paths, submodules
• Smoke Testing — manual end-to-end checks for parser, discovery, and sync changes
• Troubleshooting — mars doctor, mars repair

License

MIT