kolu

கோலு — the Navaratri tradition of arranging figures on tiered steps.

Seamless parallel development across repos and branches — switch context in one click. Optimized for AI-assisted workflows.

Important

Work in progress. See the implementation plan.

Development

Requires Nix with flakes enabled.

nix develop     # enter devshell
just dev        # run server + client with hot reload
just test       # e2e tests (full nix build)
just test-dev   # e2e tests against running dev server (faster)

Production

nix build       # build server + client
nix run         # serve on 0.0.0.0:7681
nix run -- --host 127.0.0.1 --port 8080  # custom bind

CI

• Nix build: Vira on self-hosted NixOS runners (x86_64-linux, aarch64-darwin)
• E2E tests: local via just ci — runs Playwright and posts signoff/e2e commit status to GitHub

just ci         # run e2e + post signoff (requires clean worktree)
just test       # run e2e only, no signoff

Merging to master requires all three signoffs: signoff/vira/x86_64-linux, signoff/vira/aarch64-darwin, signoff/e2e.

Architecture

pnpm workspace with three packages:

• common/ — oRPC contract + Zod schemas (shared types between server and client)
• server/ — Hono + node-pty with oRPC over WebSocket
• client/ — SolidJS + ghostty-web terminal

Stack: Hono → oRPC (WebSocket) → PTY → ghostty-web canvas. Styling via Tailwind CSS v4.