Verboo

Installation

Verboo Code can be installed in two ways: via npm (recommended) or from source with Bun.

Requires Node.js 18+.

bash
npm install -g @verboo/code

After installation, start the CLI in your project directory:

bash
verboo

Verify the installed version:

bash
verboo --version

The post-install script automatically downloads the ripgrep binary 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.mjs

For development with hot-reload:

bash
bun run dev

Useful 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 dev

Useful 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.26

Environment diagnostics

bash
verboo --doctor

Or when compiling from source:

bash
bun run doctor:runtime

Expected output:

✓ Node.js runtime: OK
✓ ripgrep binary: OK
✓ Provider config: requires setup

First use

On first run, configure the environment variables to connect to the Verboo endpoint (see Verboo Endpoint).

Updating

bash
npm update -g @verboo/code

Uninstalling

bash
npm uninstall -g @verboo/code

System requirements

Requirement Minimum version
Node.js 18+
Bun (source only) 1.3.11+
Operating system macOS, Linux, Windows (WSL)