mind-cli 0.31.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
74
75
76
77
78
79

# Tooling example

Requires mind >= 0.7. (`min-mind-version`: an older binary warns and asks before melding the source.)

A source that ships a shared `tool`, a shared `resource`, and a skill that
references both through path-reference tokens.

## What it shows

- The `tool` item kind: `tools/detect/` is a store-only installable. `learn`
  copies it into the store but links it into no agent home; other items reach it
  by reference. Its `TOOL.md` supplies a `description` and `bin`.
- `{{tools:detect}}` expands to the tool's entrypoint (its resolved `bin`,
  `detect.sh`).
- `{{path:tool:detect}}` expands to the tool's store directory, for a
  non-entrypoint file (`{{path:tool:detect}}/lib.sh`).
- The `resource` item kind: `resources/markers.json` is a store-only data file.
  `{{resources:markers.json}}` expands to its store path. Convention discovery
  offers it because the skill references it.
- `{{self}}` expands to an item's own store directory, so the `scan` skill
  addresses its bundled `resources/notes.md` without hardcoding its installed name.
- Path tokens are dependencies: `mind learn scan` installs `detect` and
  `markers.json` with the skill.

The tokens expand at install (like `{{ns:}}`) to a path under
`~/.mind/store`, so a reference stays correct under a namespace prefix and with
several agent homes configured.

## Layout

```
tools/detect/TOOL.md            description + bin: detect.sh
tools/detect/detect.sh          the entrypoint ({{tools:detect}})
tools/detect/lib.sh             a non-entrypoint file ({{path:tool:detect}}/lib.sh)
resources/markers.json          a shared data file ({{resources:markers.json}})
skills/scan/SKILL.md            references {{tools:detect}}, {{path:tool:detect}},
                                {{resources:markers.json}}, {{self}}
skills/scan/resources/notes.md  bundled, addressed as {{self}}/resources/notes.md
mind.toml                       [source] metadata only (convention scanning stays on)
```

## Try it

```
cp -r examples/tooling /tmp/tooling-demo
cd /tmp/tooling-demo && git init -q && git add -A && git commit -qm init
mind meld /tmp/tooling-demo

# The skill's path tokens are dependencies, so learning it installs the tool
# and the resource too (after showing the dependency tree).
mind learn scan --yes
cat ~/.mind/store/skill/scan/SKILL.md     # {{tools:detect}} -> ~/.mind/store/tool/detect/detect.sh

# The tool and resource are store-only: in the store, linked into no agent home.
mind recall detect
ls ~/.mind/store/resource/                # markers.json
ls ~/.claude/tools/ 2>/dev/null           # no entry for detect; tools are store-only (TOOL-3)

# Search installed items.
mind probe --no-tui detect

# Teardown (inverse order).
mind forget scan
mind forget detect
mind forget resource:markers.json
mind unmeld tooling-demo
rm -rf /tmp/tooling-demo
```

## See also

- `../../spec/tooling.md` - normative spec for the `tool` kind and path-reference tokens
  (TOOL-1..7 store-only behavior, TOOL-10..16 path tokens).
- `../../spec/resources.md` - the `resource` kind and `{{resources:name}}`.

## Verified

`tests/cli.rs::example_tooling_expands_path_tokens` melds this directory and
asserts the token expansion, so the example stays correct as the code changes.