Kaja

Documentation

Installing Kaja, connecting apps, keeping credentials in variables, writing scripts and pointing an agent at it are all documented on the website.

Installation	The Mac App Store build, or one docker run with your protos and kaja.json mounted
Apps	Connect gRPC, OpenAPI, Twirp and MCP apps, and what each type's block takes
Variables	Named values your scripts and your app configuration both read, with secrets kept out of the file
Scripts	TypeScript with a typed import for every app you connected, drawing on the canvas
Agents	Point your agent at Kaja's MCP server, and watch every run it makes

Development

Needs Go and Bun; the scripts offer to install them via Homebrew.

• Server: scripts/server (add --editable to edit the workspace from the UI)
• Desktop: scripts/desktop
• iOS: scripts/ios for the simulator, scripts/ios device for an iPhone (needs full Xcode)
• Docker: scripts/docker
• Test: (cd ui && bun test) and (cd server && go test ./... -tags development)

Releases

Every push to main uploads a macOS and iOS build to TestFlight. To ship, run the release workflow from GitHub Actions:

1. open with patch, minor or major opens a version bump PR. Merge it.
2. ship tags the release and publishes it on GitHub. Run it when a TestFlight build goes to the App Store.