mars-agents 0.1.14

Agent package manager for .agents/ directories
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# 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](https://github.com/meridian-flow/mars-agents/releases) |

## Quick Start

```bash
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

```bash
# 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:

```bash
mars models list
mars models resolve opus
```

```toml
# 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](docs/configuration.md) — `mars.toml` reference, filters, model aliases, merge precedence
- [CLI Reference](docs/commands.md) — every command with flags and examples
- [Sync Pipeline](docs/sync-pipeline.md) — how resolve → plan → apply works
- [Conflicts](docs/conflicts.md) — collision handling and resolution
- [Local Development](docs/local-development.md) — overrides, local paths, submodules
- [Smoke Testing](docs/smoke-testing.md) — manual end-to-end checks for parser, discovery, and sync changes
- [Troubleshooting](docs/troubleshooting.md) — `mars doctor`, `mars repair`

## License

MIT