Example sources
The examples/ directory in the
repo holds runnable sources, each a small but valid mind source with its own
README.md and a test that melds it so it cannot rot. This page maps each use
case, consumer and maintainer, to the example that demonstrates it.
Every example is a directory inside the mind repo, not its own git repo, so
clone the repo, copy the example out, and init a repo before melding (each
README shows the exact commands):
git clone --depth 1 https://github.com/jaemk/mind /tmp/mind-repo
cp -r /tmp/mind-repo/examples/<name> /tmp/<name>-demo
cd /tmp/<name>-demo && git init -q && git add -A && git commit -qm init
mind meld /tmp/<name>-demo
mind probe
Example catalog
| Example | Shows | Key spec |
|---|---|---|
| starter | Convention discovery: a repo with no mind.toml, items found by skills/<n>/SKILL.md, agents/<n>.md, rules/<n>.md, commands/<n>.md, workflows/<n>.js | discovery.md |
| hello | The repo-root mind.toml’s [source].roots scanning examples/hello; what mind meld jaemk/mind offers | discovery.md |
| tooling | The tool and resource kinds plus path tokens {{self}}, {{tools:name}}, {{resources:name}}, {{path:ref}} | tooling.md, resources.md |
| hooks | Source [[hooks]]: build/install tooling at meld, tear down at unmeld, with the disclosure prompt | install-hooks.md |
| explicit | Authoritative [[items]] inventory: export control, custom path/link, per-item install/uninstall hooks | discovery.md |
| monorepo | [source].roots: convention discovery rooted at per-package subtrees | discovery.md |
| discover | [discover] kind globs with per-kind include/exclude lists, for layouts roots cannot express | discovery.md |
| namespacing | A prefix plus {{ns:name}} reference tokens that survive a rename | namespacing.md |
| super-source | [discover].sources: a curated registry that melds other repos, optionally namespaced or auto-installed, plus mind curate reconciling it after the list changes | discovery.md, curate.md |
| marketplace-plugin | A Claude .claude-plugin/plugin.json: skills, agents, commands, and workflows mapped to items, unsupported components reported, a workflows component-path override ignored | marketplace.md |
| marketplace-catalog | A Claude .claude-plugin/marketplace.json: a catalog of in-repo plugins, each a namespaced sub-source | marketplace.md |
| marketplace-curator | A repo that is both a Claude marketplace and a mind curator: [discover].sources composes with the plugin manifest instead of suppressing it | marketplace.md |
| policy | An enterprise managed policy: trusted-source allowlist, require-pinned, lobe lock | policy.md |
| drift | Item drift end to end: recall/introspect flag an out-of-date item, upgrade re-links it | lifecycle.md |
| multi-lobe | Linking one item into more than one agent home (lobe) via config lobes | storage.md |
| absorb | Claiming an unmanaged lobe item into a version-controlled source with absorb | absorb.md |
Which example for which task
| task | example | guide |
|---|---|---|
| install from a plain repo | starter | Find and install items |
| resolve a name collision | namespacing | Fix name collisions |
| follow a curated list | super-source | Follow a curated collection |
| meld a Claude plugin or marketplace | marketplace-plugin, marketplace-catalog | Claude plugins and marketplaces |
| link into more than one agent home | multi-lobe | Use more than one agent |
| see drift and upgrade | drift | Keep everything up to date |
| adopt a hand-placed item | absorb | Adopt items you placed by hand |
| run under a managed policy | policy | Managed policy |
| export only some files | explicit | The mind.toml file |
| lay out a monorepo | monorepo, discover | The mind.toml file |
| share a script between skills | tooling | Share helper scripts |
| share a data file between skills | tooling | Share data files |
| build tooling at meld | hooks | Run setup with hooks |
| curate other repos | super-source, marketplace-curator | Curate other repos |