Skip to content

Two halves, and the order matters.

Install the Claude Code plugins first, then the CLIs. The plugin half is the one that gets dropped, and a fleet with the CLIs but no plugins looks installed while none of the slash commands, skills or MCP wiring exist.

In a hurry? Open Claude Code and saylet's Sothis this up

Before you start

  • Claude Code — the suite is built for it. The tools speak plain CLIs, so other MCP-capable agents work too, but every install path below goes through Claude Code's plugin system.
  • Git, and a repository to point the fleet at. Every store the suite writes lives inside that repo.
  • Bun — needed by Catryna Wikinelli, which ships as pure TypeScript rather than a per-platform binary. On Windows, install it before running the two plugin lines.
  • A Rust toolchain isnot required. Prebuilt, checksum-verified binaries ship for every platform — the only exception is PingMyBell, which has no signed release yet and is built from source.

1 · Plugins — do this first

One marketplace, three plugins. These commands are non-interactive, so you can also just ask Claude Code to run them for you.

$claude plugin marketplace add Davidb3l/Sirius-Forester
$claude plugin install sirius@sirius-forester
$claude plugin install hayvenhurst@sirius-forester
$claude plugin install catryna@sirius-forester

The same thing is available in the desktop app under + → Plugins → Add plugin, and in a terminal session as the /plugin dialog.

2 · The CLIs

With the sirius plugin installed, one shot installs every missing suite CLI through each tool's own verified installer, then re-checks the plugin half.

macOS · Linux · Git Bash, WSL or any POSIX shell on Windows

$"${CLAUDE_PLUGIN_ROOT}/scripts/install-sothis.sh"

Windows PowerShell

PS>& "$env:CLAUDE_PLUGIN_ROOT\scripts\install-sothis.ps1"

The same windows-x64 artifacts, the same checksum verification. Add -AddToPath to have it extend your PATH for you.

What gets verified

Both paths verify the .sha256 checksum before anything is unpacked. sirius additionally verifies its Sigstore bundle: a bad signature always aborts, and a missing bundle aborts too. The one soft case is a machine with neither cosign nor sigstore installed, where the installer warns and proceeds on TLS plus the checksum. Pass --require-signature (PowerShell: -RequireSignature) to make that fatal as well.

You can also run /sirius:install-suite inside Claude Code, or simply say "let's Sothis this up". Every route ends the same way — at sirius doctor.

3 · Verify

A half-done install should say so loudly rather than look finished. This is the check that makes it.

$sirius doctor

Reports every missing CLI, every missing plugin, and anything on the wrong version.

One tool at a time

Nothing here is all-or-nothing. Each tool installs on its own and is useful without the other four — take the code graph and skip the foreman, or take the board and nothing else.

  • Sirius Forestersirius

    early alpha · v0.1.0

    /sirius:install-binary

    Picks the tarball for your platform, verifies the checksum and the Sigstore bundle, and installs the binary.

  • Hayvenhursthayven

    pre-release · 0.x

    /hayvenhurst:install-binary

    Picks the right installer for your shell, verifies the sha256, and installs hayven plus its native indexer.

  • Catryna Wikinellicatryna

    MIT · plugin-distributed

    $claude plugin install catryna@sirius-forester

    Registers the MCP server, activates the agent skill, and adds the /catryna:viewer command.

  • PingMyBellpingmybell

    early alpha · macOS, from source

    $cargo build --release --workspace

    Clone the repo first. No signed release yet — this is the honest install path, and the README walks the rest.

  • Ametriteamt

    released · CLI + MCP

    $brew install Davidb3l/tap/amt

    Recent Homebrew refuses third-party taps until you trust them — run brew trust Davidb3l/tap if it asks.

  • Guignetguignet

    pre-1.0 · from source

    $bun install

    Clone the repo first — there is no published release yet. Needs Bun ≥ 1.3 and git. Windows: use WSL2, which gets the full POSIX treatment; native Windows is experimental and guignet doctor says so.

Troubleshooting

Three failures account for nearly every bad install. All three have a fix that takes one line.

claude plugin install fails with Permission denied (publickey)

Why. Plugins whose marketplace entry uses a git-subdir source are cloned over SSH. marketplace add falls back to HTTPS when SSH is unavailable; plugin install does not. On a machine with no GitHub SSH key — the normal state of a fresh Windows box — the clone has nothing to authenticate with.

Fix. Rewrite the SSH remote to HTTPS for that one command, through git's environment-variable config so nothing on disk changes.

Bash

$GIT_CONFIG_COUNT=1 \
$  GIT_CONFIG_KEY_0=url.https://github.com/.insteadOf \
$  [email protected]: \
$  claude plugin install hayvenhurst@sirius-forester

PowerShell

PS>$env:GIT_CONFIG_COUNT=1; $env:GIT_CONFIG_KEY_0='url.https://github.com/.insteadOf'; $env:GIT_CONFIG_VALUE_0='[email protected]:'
PS>claude plugin install hayvenhurst@sirius-forester

In PowerShell those variables live for the rest of the session — drop them again with Remove-Item Env:GIT_CONFIG_COUNT, Env:GIT_CONFIG_KEY_0, Env:GIT_CONFIG_VALUE_0 when you are done.

Installed, but sirius: command not found

Why. The binaries land in ~/.local/bin (%USERPROFILE%\.local\bin), a Unix convention that nothing on Windows adds to PATH. The installers never mutate your PATH behind your back.

macOS · Linux — in ~/.zshrc or ~/.bashrc

$export PATH="$HOME/.local/bin:$PATH"

Windows — run once, fixes every shell, editor and the desktop app

PS>[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path','User') + ';' + "$env:USERPROFILE\.local\bin", 'User')

PATH changes only reach new processes. Close and reopen your shells, your editor and Claude Code before you retest.

The installer refuses to run on your platform

Why. An old checkout. Earlier installers detected only Linux and Darwin from uname -s and bailed on the MINGW* / MSYS* / CYGWIN* values Git Bash reports. Current installers handle all of them.

Fix. Update the marketplace and reinstall the plugin, then run the installer again.

$claude plugin marketplace update sirius-forester

Still stuck? Every tool takes issues on its own repository — start fromthe tool list, or open one onthe suite repo.