# 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, and tools and links its items into your agent
homes (lobes; default `~/.claude`).
```
mind meld jaemk/mind
```
[](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 Windsurf (as a
project lobe), 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 Apple Silicon macOS (install script):
```
The script verifies the download against the published `SHA256SUMS` asset before
extracting.
Homebrew (Apple Silicon macOS and Linux):
```
brew tap jaemk/mind https://github.com/jaemk/mind
brew trust jaemk/mind
brew install mind
```
Bottles are provided for Apple Silicon macOS (arm64) and Linux (x86_64 and
aarch64). Intel macOS is not covered; use `cargo install mind-cli` instead.
Linux and macOS with the Rust toolchain:
```
cargo install 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
```
`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:
```
mind learn https://github.com/owner/repo/tree/main/skills/foo
```
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) or project directories (Windsurf reads
skills from `<project>/.windsurf/skills/`). See
[configuration](https://jaemk.github.io/mind/guide/configuration.html#cross-harness-lobes)
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.
## Develop
```
cargo test
```
Releases are tag-driven: pushing `v*` builds per-platform binaries, creates the
GitHub Release, and regenerates `Formula/mind.rb`.