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.