Skip to content

jaemk/mind

Repository files navigation

mind

docs release crates.io

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 directories (default ~/.claude).

mind meld jaemk/mind

asciicast

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, Codex CLI, Antigravity, 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):

curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/jaemk/mind/main/resources/install.sh | sh

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 x86_64 Linux. 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 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

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, Codex CLI, Antigravity) or project directories (Windsurf reads skills from <project>/.windsurf/skills/). See configuration for details.

The documentation is the full reference: the command reference, configuration, install hooks, authoring a source, and troubleshooting. The 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.

About

A package manager for agent tooling: meld git repos of skills, agents, rules, and tools into Claude Code, Gemini, and Codex

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages