Installation
Verboo Code can be installed in two ways: via npm (recommended) or from source with Bun.
Option A: npm (recommended)
Requires Node.js 18+.
bash
npm install -g @verboo/codeAfter installation, start the CLI in your project directory:
bash
verbooVerify the installed version:
bash
verboo --versionThe post-install script automatically downloads the
ripgrepbinary needed for the Grep tool.
Option B: Build from source
Requires Bun 1.3.11+. Install Bun at bun.sh.
bash
git clone https://github.com/verbeux/verboo
cd verboo
bun install
bun run build
node dist/cli.mjsFor development with hot-reload:
bash
bun run devUseful scripts during development
| Command | Description |
|---|---|
bun run build |
Compiles to dist/cli.mjs |
bun run smoke |
Quick sanity check (build + --version) |
bun run doctor:runtime |
Validates provider and environment |
bun run doctor:runtime:json |
Diagnostics in JSON |
bun run typecheck |
TypeScript type checking |
bun run test |
Runs unit tests |
bun run test:coverage |
Test coverage (LCOV) |
Option C: Run directly with Bun (without build)
bash
bun run devUseful for experimenting with changes without the build step.
Android
Refer to the Android installation guide at ANDROID_INSTALL.md in the official repository.
Post-installation
Verify installation
bash
verboo --version
# verboo-code 0.7.26Environment diagnostics
bash
verboo --doctorOr when compiling from source:
bash
bun run doctor:runtimeExpected output:
✓ Node.js runtime: OK
✓ ripgrep binary: OK
✓ Provider config: requires setupFirst use
On first run, configure the environment variables to connect to the Verboo endpoint (see Verboo Endpoint).
Updating
bash
npm update -g @verboo/codeUninstalling
bash
npm uninstall -g @verboo/codeSystem requirements
| Requirement | Minimum version |
|---|---|
| Node.js | 18+ |
| Bun (source only) | 1.3.11+ |
| Operating system | macOS, Linux, Windows (WSL) |