# mind
[](https://github.com/jaemk/mind/actions/workflows/ci.yml)
[](https://jaemk.github.io/mind/)
[](https://github.com/jaemk/mind/releases/latest)
[](https://crates.io/crates/mind-cli)
Skills, agents, and rules get copy-pasted between repos and machines, drift
silently against their source, and have no install/upgrade/uninstall story.
`mind` is a package manager for agent tooling, modeled on Homebrew: it melds
a git repo of skills, agents, rules, commands, workflows, and tools and links
its items into your agent homes (lobes; default `~/.claude`).
```
mind meld jaemk/mind
```
This melds the mind repo itself: it offers the `hello-mind` example skill and
registers two curated skill libraries
([anthropics/skills](https://github.com/anthropics/skills) and
[ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills))
as browsable sources. Nothing installs without a prompt; `mind unmeld` drops
any of the three.
[](https://asciinema.org/a/qcAxP5PD7H6cuLTE)
Each installed item is tracked and checked for drift from its source, install /
upgrade / uninstall are transactional, and linking works across Claude Code,
Gemini CLI (Antigravity rides the same home), Codex CLI, and Devin (formerly
Windsurf), not just `~/.claude`.
Full documentation: https://jaemk.github.io/mind/
## Install
`mind` shells out to `git` to clone and sync sources, so `git` must be on your
`PATH`. The methods below install the `mind` binary itself, not git.
Linux and macOS (install script):
```
The script verifies the download against the published `SHA256SUMS` asset before
extracting.
Homebrew (macOS and Linux):
```
brew tap jaemk/mind https://github.com/jaemk/mind
brew trust jaemk/mind
brew install mind
```
Bottles are provided for macOS and Linux, each on x86_64 and aarch64.
Linux and macOS with the Rust toolchain:
```
cargo install --locked mind-cli
```
mind targets Linux and macOS; on Windows, run it under WSL. See the
[install guide](https://jaemk.github.io/mind/guide/install.html) for version
pinning, target-dir overrides, and platform details.
## Quickstart
```
mind meld owner/repo # clone and prompt to install items
mind recall # list what's installed
mind unmeld owner/repo # drop the source and uninstall what it installed
```
A source can declare install hooks (shell commands run at install); mind shows
each command and asks before running it. `mind review <repo>` reports a repo's
hooks and risky references before melding. See the
[install hooks guide](https://jaemk.github.io/mind/guide/install-hooks.html).
`meld` presents available items and prompts to install. To register without
installing and choose items individually:
```
mind meld owner/repo --register-only # register only, skip install prompt
mind probe # browse available items (interactive)
mind learn <item> # install a specific item
```
A pasted skill URL installs just that skill, managed like any source, and a
`blob` URL to a single agent/rule/command file works the same way:
```
mind learn https://github.com/owner/repo/tree/main/skills/foo
mind learn https://github.com/owner/repo/blob/main/agents/reviewer.md
```
A repo whose `marketplace.json` lists only some of its skills can be melded
with extra scan roots composed in:
```
mind meld owner/repo --add-root community --add-root experimental
```
Lobes (install targets) can be global agent homes (Claude Code, Gemini CLI
(shared with Antigravity), Codex CLI, Devin CLI) or project directories (Devin
Desktop reads skills from `<project>/.devin/skills/`). See
[configuration](https://jaemk.github.io/mind/guide/lobes.html)
for details.
The [documentation](https://jaemk.github.io/mind/) is the full reference: the
[command reference](https://jaemk.github.io/mind/guide/commands.html),
[configuration](https://jaemk.github.io/mind/guide/configuration.html),
[install hooks](https://jaemk.github.io/mind/guide/install-hooks.html),
[authoring a source](https://jaemk.github.io/mind/guide/authoring.html), and
[troubleshooting](https://jaemk.github.io/mind/guide/troubleshooting.html). The
[spec/](https://github.com/jaemk/mind/tree/main/spec) directory is the normative
behavioral spec.
## Uninstall
Remove installed items and sources first if you want a clean lobe
(`mind unmeld <source>` per source, or `mind forget <item>` per item), then
remove the binary by the method that installed it:
```
brew uninstall mind # Homebrew
cargo uninstall mind-cli # cargo
rm ~/.local/bin/mind # install script (default location)
```
`mind`'s own state lives in `~/.mind` (store, clones, config); remove that
directory last. Items were linked into your lobes as symlinks into the store,
so unmeld/forget before deleting `~/.mind` or those links dangle
(`mind introspect` reports them).
## Develop
```
cargo test
```
Releases are tag-driven: pushing `v*` builds per-platform binaries, creates the
GitHub Release, and regenerates `Formula/mind.rb`.