Codevisor DocsInstallation
Install Codevisor Server and its command-line tools on macOS or Linux.
Installer behavior
curl -fsSL https://www.codevisor.dev/install.sh | shEach run resolves the latest stable version from the same release feed used by the server updater. If the feed cannot be fetched or does not contain a valid stable version, installation stops with an error. The installer does not fall back to an older release.
To install a specific release, set CODEVISOR_VERSION on the shell running the installer:
curl -fsSL https://www.codevisor.dev/install.sh | CODEVISOR_VERSION=0.1.99 shOn Linux, the installer downloads the matching linux-x64 or linux-arm64 archive, verifies its
SHA-256 checksum when sha256sum is available, and links codevisor, codevisor-server, and
codevisor-terminal-proxy into a bin directory.
On an Apple silicon Mac, the installer copies the Codevisor app into /Applications and links the same CLI
commands from the bundled server runtime into ~/.local/bin (override with CODEVISOR_BIN_DIR).
The Homebrew cask links them into Homebrew's bin directory, and the app also repairs the
~/.local/bin links on launch — so a plain DMG drag-install gets the CLI the first time the app
opens. If ~/.local/bin is not on your PATH, add it in your shell profile:
export PATH="$HOME/.local/bin:$PATH"The Codevisor app is not available for Intel Macs. On an Intel Mac, the installer explains this and
asks whether to install the standalone darwin-x64 server instead. When you confirm, it installs
and links the server the same way as on Linux, then runs codevisor setup to sign it into your
Codevisor account. macOS has no systemd, so the server runs as a background process that you start
with codevisor start, including after a reboot. It appears in the Codevisor app on your other
machines once signed in. Set CODEVISOR_INSTALL_SERVER=1
to skip the confirmation, for example when no terminal is attached. Homebrew users can instead run
brew install 851-labs/tap/codevisor-server.
| Variable | Purpose | Default |
|---|---|---|
CODEVISOR_VERSION | Install a specific release | Latest stable |
CODEVISOR_INSTALL_DIR | Runtime installation directory | ~/.codevisor/server or /opt/codevisor |
CODEVISOR_BIN_DIR | Command symlink directory | ~/.local/bin (/usr/local/bin as root, Linux) |
CODEVISOR_PORT | Listening port | 49361 |
CODEVISOR_DATA_DIR | Server database and data dir | ~/.codevisor/data |
CODEVISOR_NO_SERVICE=1 | Skip systemd setup | systemd enabled when available |
CODEVISOR_NO_SETUP=1 | Skip signing in during installation | setup runs when a terminal is available |
CODEVISOR_INSTALL_SERVER=1 | Install the server on an Intel Mac without asking | asks for confirmation |
Without systemd
curl -fsSL https://www.codevisor.dev/install.sh | CODEVISOR_NO_SERVICE=1 sh
codevisor startcodevisor start runs a detached background process when no systemd unit exists. Use
codevisor stop, codevisor restart, codevisor status, and codevisor logs --follow to manage it.
Run codevisor setup after the first start to sign the machine into your Codevisor account.
To use another supervisor, run the foreground command and give the service user a persistent home directory:
codevisor-server serve --host 0.0.0.0 --port 49361 --auth tokenUser service persistence
A systemd user service normally stops after its user logs out. Enable lingering if this machine should remain available:
sudo loginctl enable-linger "$USER"