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 integration test requires a host with working virtualization and network access:

bun run --cwd packages/cli test:integration

It creates a Node.js VM, scaffolds and starts a Vite application on guest port 5173, verifies the application through parent port 3005, then confirms that the VM stops when its TTL expires.