Install

Bishop is an npm package that needs Node 24 or newer.

npm install -g @agentdeploymentco/bishop

That puts bishop on your PATH. Bishop treats the directory it runs from as its own home, and as the agent unless --agent points elsewhere, so run it from the agent's directory. The container image is the other way to run it, and Linux and systemd covers a host without Docker.

Requirements

• Node 24 or newer. Bishop imports node:sqlite.
• A directory the agent works in, meaning claude or codex runs there and does something useful. Bishop manages no model credentials: each harness authenticates however its own CLI does in that directory.
• At least one interface, each with its own setup requirements:
  • Slack: the slack CLI, logged in with slack auth login, and permission to install an app in your workspace. Without the CLI, you can set the app up by hand.
  • Email: a Google Workspace account, a Google Cloud project, and a Workspace user for the agent.
  • Microsoft Teams: the Teams Developer CLI, logged in with teams login, unless an administrator creates the app for you, plus a way for Teams to reach this host over HTTPS. Reading or sending a file in a Teams channel also needs the Azure CLI.

From source

The published package is minified and carries no source maps. If you work on Bishop, and so can read its repository, build it instead:

git clone https://github.com/Agent-Deployment-Co/bishop.git
cd bishop
npm install
npm run build
npm link          # optional, puts `bishop` on your PATH

Without npm link, run it as node /path/to/bishop/dist/cli.js.

Upgrading

Install the new version and restart. Upgrading covers database migrations and how to roll one back.