Development

Weave is a Bun workspace managed with Turborepo. The CLI lives in packages/cli and is written in TypeScript with Effect.

Install dependencies

bun install

Run the CLI

bun packages/cli/src/index.ts --help

Run the docs

Start the Fumadocs site locally:

bun run --cwd apps/docs dev

Open http://localhost:3000.

Validate changes

Run the repository's required checks:

bun run fix
bun run lint
bunx turbo check-types
bunx turbo test

Build all packages and applications:

bunx turbo build

The regular CLI test suite uses Vitest and does not start real VMs. The opt-in TTL integration test requires a host with working virtualization:

bun run --cwd packages/cli test:integration