v0.2.0-beta — first open-source release

First public release of Twiko as an open-source project.

Twiko gives every bot a real computer — a browser it signs into, a terminal it runs commands in,
files it keeps, and memory that outlives the conversation. Everything runs on infrastructure you
control: your model keys, your machine, your data.

Highlights

Peer bots and subagents. A bot can now spawn peer bots, each with its own thread and computer,
or short-lived in-thread subagents for work that does not need to persist.

Run bots on your own Mac. Electron first-run offers Docker (default) or this Mac. The Mac option
runs the bot shell as you, with working directories under your home folder. It is owner-only and is
refused unless SANDBOX_PROVIDER is docker, so E2B and test fakes cannot enable it.

Sign in with a subscription you already pay for. Model access through ChatGPT Plus/Pro, GitHub
Copilot, and SuperGrok / X Premium via Pi device-code OAuth, alongside plain API keys. Claude Pro is
not included yet — Pi's Claude login uses a localhost callback that does not work from the web app.

Routines in plain language. Scheduled work is described the way you would say it, not as raw
cron expressions.

Mobile. Point the app at your own self-hosted API origin, use a native iOS inbox, and take
control of a bot's live desktop from your phone.

Plugin control. Connected Composio plugins can now be revoked.

Removed

The unused Grant folder picker in the desktop app. Bots never received a host folder through it.

Getting started

You need Node.js 22.19+, pnpm 9, and Docker Desktop.

git clone https://github.com/ezocomp118-source/twiko.git
cd twiko
cp .env.example .env

Set BETTER_AUTH_SECRET and ENCRYPTION_KEY to independent, long random values, then:

docker compose --env-file .env -f infra/compose/docker-compose.yml up postgres -d
pnpm install
pnpm db:generate
pnpm db:migrate
pnpm sandbox:build
pnpm dev

Full instructions are in the README and the
self-hosting guide.

Notes

Twiko is in beta. Interfaces and data shapes may still change between releases. Questions, ideas, and
bug reports are welcome in
Discussions and
Issues.