Install

On macOS or Linux, from the latest release:

curl -fsSL https://monk3ys.dev/install | sh

The script picks the build for your operating system and processor, checks the published checksum, and installs into ~/.local/bin. Set INSTALL_DIRECTORY to put it elsewhere. It is short, and reading it first is a fine habit.

With Homebrew, which then upgrades it along with everything else:

brew install eastriverlee/tap/monkeys

Tap it once and the bare name works from then on:

brew tap eastriverlee/tap
brew install monkeys

From source, with Swift 6.1 or later, on macOS 13 or later or on Linux:

git clone https://github.com/eastriverlee/monkeys
cd monkeys
make install

On Linux, monkeys reaches the keyring through secret-tool: install libsecret-tools on Debian and Ubuntu, libsecret on Fedora and Arch.

For a coding agent

The binary is the whole tool, and an agent that can run a shell can already use it. The skill at plugins/monkeys/skills/monkeys/SKILL.md is what makes it reach for monkeys on its own instead of asking you to paste a key. plugins/monkeys is an Agent Plugins package, and the repository is a marketplace for it in the two clients that have one.

Claude Code

claude plugin marketplace add eastriverlee/monkeys
claude plugin install monkeys@eastriverlee

/monkeys:install then fetches the binary, and a session that starts without one says so.

Codex

codex plugin marketplace add eastriverlee/monkeys
codex plugin add monkeys@eastriverlee

The binary is installed separately, from the section above.

Anything else

Copy plugins/monkeys/skills/monkeys/SKILL.md into whatever directory your agent reads skills from; https://monk3ys.dev/skill serves that one file.

The skill restates a few invocations so an agent knows them before it runs anything. make check holds that copy to the binary, failing when the skill names a command monkeys help does not list.