mai-cli 0.1.0

AI tooling package manager - Manage skills, commands, and MCP connectors for AI agents (Qwen, Claude, etc.)
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
84
85
86

# mai

**AI Tooling Package Manager** — Manage skills, commands, and MCP connectors for AI agents.

## Quick Start

```bash
# Build
cargo build --release
cp target/release/mai ~/.local/bin/

# Switch AI tool
mai use qwen

# Install packs
mai install aif
mai install mcp/postgres

# List packs
mai list
```

## Commands

| Command | Description |
|---------|-------------|
| `mai use <tool>` | Switch active AI tool |
| `mai install <pack>` | Install pack (skill/command/mcp) |
| `mai list` | List installed packs |
| `mai remove <pack>` | Remove pack |
| `mai update <pack>` | Update pack |
| `mai project init` | Create `mai.toml` |
| `mai project sync` | Generate `mai.lock` |
| `mai completions` | Shell completions |

**Pack format**: `[type/]name[@version]`  
Example: `skill/aif@1.0.0`, `mcp/postgres`, `latest`

## Configuration

### Directories

```
~/.config/mai/          # Config (config.toml)
~/.local/share/mai/     # Pack storage
~/.cache/mai/           # Cache
```

### Project Files

**mai.toml** — Project manifest:
```toml
[project]
name = "my-ai-project"

[dependencies]
dependencies = [
  { name = "aif", type = "skill", version = "^1.0.0" },
  { name = "postgres", type = "mcp", version = "latest" },
]
```

**mai.lock** — Pinned versions (auto-generated).

## Development

```bash
cargo build
cargo test
cargo clippy -- -D warnings
```

Logging: `LOG_LEVEL=debug cargo run -- list`

## Documentation

| Guide | Description |
|-------|-------------|
| [Getting Started](docs/getting-started.md) | Quick start tutorial |
| [CLI Reference](docs/cli-reference.md) | Complete command docs |
| [Project Config](docs/project-config.md) | `mai.toml` and `mai.lock` |
| [Versioning](docs/versioning.md) | Semver and version ranges |

## License

MIT