Getting started

Twig is a Bun + Turborepo monorepo. The product surface is Expo React Native on Android only. For downloads, package id, and legal terms see the distribution page.

You need

• Bun 1.3+
• Android device or emulator
• Dev build of the app (Expo Go is dead here — see below)

Install

bun install

Run Android app

bun run dev:native

Twig needs expo-sqlite with sqlite-vec. That is a build-time flag. Expo Go cannot do it. You make a real development build:

cd apps/native
bunx expo prebuild --platform android
bunx expo run:android

Skip this and you get pain.

Run docs site

bun run dev:web
# → http://localhost:4000

Laptop companion (when present)

Companion TUI in apps/cli. Lends compute over USB. Does not steal agent homes:

bun run companion

Scripts

API keys

Twig does not ship models. Put key in app. OpenRouter = default easy path. Also OpenAI, Anthropic, Google. Keys live in secure storage on device. No key still means you can open files and reindex. Key only needed when you want the model to talk.