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

# Tooling example

Requires mind >= 0.7. (`min-mind-version` is advisory: parsed and recorded, not yet enforced as a version gate.)

A source that ships a shared `tool` and a skill that references it 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`).
- `{{self}}` expands to an item's own store directory, so the `scan` skill
  addresses its bundled `resources/notes.md` without hardcoding its installed name.

All three 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)
skills/scan/SKILL.md            references {{tools:detect}}, {{path:tool:detect}}, {{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

# A path-token reference is not an install dependency (only {{ns:}} is), so learn
# the tool alongside the skill. The tokens then expand to store paths.
mind learn detect
mind learn scan
cat ~/.mind/store/skill/scan/SKILL.md     # {{tools:detect}} -> ~/.mind/store/tool/detect/detect.sh

# The tool is store-only: it is in the store but not linked into any agent home.
mind recall detect
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 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).

## 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.