Installation
Requirements
Section titled “Requirements”- Bun 1.4.4 or newer (the runtime and installer). The one-line installer installs Bun when absent; upgrade an existing older installation first.
- The
ompCLI with usable provider credentials and a default model configured: runompto configure it, oromp loginfor an OAuth provider. An interactive first run with no fleet config checks this setup; missing setup warns but does not prevent the fleet from starting. Prompts need a usable model and credentials.
Install
Section titled “Install”# One-liner (bun-only; installs bun >= 1.4.4 if missing):curl -fsSL https://raw.githubusercontent.com/nibblebot/omp-web/main/scripts/install.sh | shThe installer downloads the latest release tarball, verifies its sha256 against the release manifest, and installs it into a pinned project dir (~/.omp-web/install/) with a ~/.bun/bin/omp-web symlink by default (or $BUN_INSTALL/bin/omp-web). Put that bin directory on PATH. Then omp-web update keeps it current.
Verify
Section titled “Verify”omp-web --versionRun omp-web in a terminal to start the fleet and open the UI in your browser (elsewhere, open its printed URL). Register a repository in the UI, start or select a session, and send a prompt. Local sessions use your ordinary SDK credentials.
Self-update
Section titled “Self-update”omp-web update # install the latest release if neweromp-web update --check # check for an update without installingomp-web update --version x.y.z # select a specific newer releaseomp-web update --force --version x.y.z # reinstall or downgrade to a specific release--version selects a release for this invocation, not a durable pin; a future bare update still checks the latest release. After updating, stop the running control plane (Ctrl+C) and start it again. Running sessions survive that restart on the code they started with; omp-web stop all ends them so the next attach or prompt starts them on the new release.
Manual install
Section titled “Manual install”Install from this repo (build → pack → install):
git clone https://github.com/nibblebot/omp-web.git && cd omp-webbun installbun run install:omp-web # build → pack → install into ~/.omp-web/install/omp-web --version # verify: prints <version>