mind-cli 0.8.0

A manager for agent tooling (skills, agents, rules, tools) that melds arbitrary git repos and links items into your agent directories.
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

# Multi-lobe example

A lobe is a configured agent home (default `~/.claude`); when more than one is
configured, a single `learn` links the item into every one and `forget` removes
it from all of them.

## Layout

```
skills/recap/SKILL.md    skill, description in frontmatter
```

This is a minimal convention-discovered source: one skill, no `mind.toml`. The
point of the example is the lobe fan-out, not the inventory.

## Try it

This directory is part of the `mind` repo, not its own git repo, so copy it out
and init a repo before melding. The two lobes here are plain temp directories so
the demo does not touch your real `~/.claude`:

```
cp -r examples/multi-lobe /tmp/multi-lobe
cd /tmp/multi-lobe && git init -q && git add -A && git commit -qm init

# Point the default lobe at /tmp/lobe-a, then add /tmp/lobe-b as a second home.
mkdir -p /tmp/lobe-a /tmp/lobe-b
export CLAUDE_HOME=/tmp/lobe-a
mind config show                      # lobes = ["/tmp/lobe-a"]
mind config lobes add /tmp/lobe-b
mind config lobes list                # /tmp/lobe-a and /tmp/lobe-b

mind meld /tmp/multi-lobe
mind learn recap                      # links skills/recap into both lobes
```

Confirm the skill is symlinked into both homes, each pointing at the one store
copy:

```
ls -l /tmp/lobe-a/skills/recap        # -> .../store/skill/recap
ls -l /tmp/lobe-b/skills/recap        # -> .../store/skill/recap
```

`config target` is a visible alias for `config lobes`, so
`mind config target list` prints the same homes.

### Teardown

Undo the demo in reverse order. `forget` removes the skill from both lobes:

```
mind forget recap                     # drops skills/recap from both homes
mind config lobes remove /tmp/lobe-b
mind unmeld local/tmp/multi-lobe
rm -rf /tmp/multi-lobe /tmp/lobe-a /tmp/lobe-b
unset CLAUDE_HOME
```

## See also

`../../spec/storage.md` - STO-14 (the agent homes, "lobes", an item is linked
into: `$MIND_AGENT_HOMES`, else `lobes` in `config.toml`, else the claude root),
STO-15 (the default lobe written on first use).

`../../spec/lifecycle.md` - LIFE-40 (the store copy is linked into every
configured agent home; uninstall removes the recorded link in every home).

## Verified

`tests/cli.rs::example_multi_lobe_links_into_all_homes` configures two lobes,
melds this directory, and asserts `learn` links `recap` into both and `forget`
removes it from both, so the example stays correct as the code changes.