whatcode-ai

Monorepo that provides a one-script setup to start opencode — and optionally expose it over HTTPS via Tailscale — so you can connect to it from anywhere (e.g. a private iOS app).

Packages

Package	Description
@whatcode-ai/sdk	Core SDK + whatcode CLI
@whatcode-ai/example	Minimal usage example

Quick start

As a CLI

npx @whatcode-ai/sdk
# or with Tailscale
npx @whatcode-ai/sdk --tailscale

As a package

npm install @whatcode-ai/sdk

import { createWhatcodeServer } from '@whatcode-ai/sdk';

await createWhatcodeServer({
  tailscale: true, // optional — exposes opencode over HTTPS on your tailnet
});

How it works

1. opencode — starts the opencode server on 0.0.0.0:4096 (skipped if already running).
2. Tailscale (optional) — runs tailscale serve --bg 4096 to proxy the server over HTTPS on your tailnet, then prints the URL to use in your app.

Requirements

• Node.js 20+
• opencode installed
• Tailscale installed and authenticated (only if using --tailscale)

Development

git clone https://github.com/Pnlvfx/whatcode-ai.git
cd whatcode-ai
yarn install
yarn build

License

MIT