Install

Installing has two steps. First you put the Besydr program on your machine. Then you connect it to each coding agent you use. A coding agent that Besydr is connected to is called a client.

No release has been published yet. The download host dl.besydr.com has no files yet, so the commands below install nothing until the first release is out.

Install the program

Linux and macOS:

curl -fsSL https://dl.besydr.com/install.sh | sh

Windows, in PowerShell 5.1 or later:

irm https://dl.besydr.com/install.ps1 | iex

The script downloads the archive for your platform, compares its SHA-256 checksum with the release manifest, and copies the program into one folder. It needs no administrator rights. You can read the scripts before you run them: install.sh and install.ps1. Check the result with besydr --version.

Windows supports octomind only. The install and uninstall commands below exist on Linux and macOS only. Folders, environment variables and the steps of the script are in the install documentation.

Connect a client

Besydr runs as one shared server per user, started in the background by the first client that needs it. If no server can be reached, the client carries on as if Besydr were not installed.

octomind

Octomind lists Besydr as a plugin in its default configuration and downloads it on first use. You run no command. Besydr is free with octomind and every feature works there.

Claude Code

besydr install claude

This adds ten hooks to ~/.claude/settings.json. A hook is a command that the client runs at a fixed point of its work. Open a new Claude Code session afterwards. Add --print to see the file that would be written without writing it, and use besydr uninstall claude to remove the hooks.

Codex

besydr install codex

This adds nine hooks to ~/.codex/hooks.json. Codex ignores a hook until you have reviewed and trusted it: start Codex and open /hooks to review the new entries. Until you do, Codex runs as if Besydr were not installed. Remove them with besydr uninstall codex.

OpenCode

besydr install opencode

This writes the plugin file ~/.config/opencode/plugins/besydr.js. Restart OpenCode afterwards. The plugin targets the OpenCode 1.x plugin interface and has not been checked against OpenCode 2. Remove it with besydr uninstall opencode.

pi

besydr install pi

This writes the extension file ~/.pi/agent/extensions/besydr.js. Start pi again or run /reload. Like every pi extension, it runs inside the pi process with your permissions. Remove it with besydr uninstall pi.

What install changes

For Claude Code and Codex, install keeps your other settings and hooks, and copies the file to <file>.besydr-backup before the first change. For OpenCode and pi it writes one file and refuses to touch a file of that name that is not its own. Running install twice changes nothing. The entries hold the path of the program that ran install, so run it again after you move the program. A hook never blocks the client: on any failure it prints nothing and the client goes on.

Only octomind has been run with Besydr in live sessions so far. The other four connections are covered by automated tests against each client’s documented formats. See what each client supports.

Choose the models

Besydr makes its own model calls and uses two models. The model in the [model] table of its config file writes text, such as the checklist. The decision model in [decision] answers short questions about a text and writes nothing. Both default to octohub:auto, the OctoHub model gateway that octomind uses.

If you are logged in to octomind, Besydr finds octomind’s stored key and you set nothing. Otherwise set OCTOHUB_API_KEY, either in the environment or in the key file next to the config file. To use your own provider, change the model names in the config and set that provider’s key variable. Run besydr config to see the file path and which key variables are set; it never prints a key. The providers and their variables are in the configuration documentation.

Activate a licence

With octomind you need no licence. With another client the program runs for a trial of 14 days, counted from the first time such a client connects. After that it needs a personal or team licence. The licence arrives by email as a file named besydr.licence. Install it by giving the file:

besydr licence install besydr.licence

The program checks the signature on your machine and never calls home. Run besydr licence to see the standing. After the trial without a valid licence, Besydr stops supervising and adding lessons for that client; lessons already stored stay on your machine. A team licence can be bought and installed now, but the team server it is meant for is not built yet. If the email does not arrive, look in your spam folder, then write to hello@besydr.com from the address you used at checkout. More in the licence documentation.