Home

Welcome to OkBot. It is a desktop Personal Agent with three layers: desktop client, personal gateway, and runtime computers. One client can switch among many gateways; one gateway can host many runtime computers. Keep the gateway deployed and running for continuous service; send work across registered runtime machines. Data lives under ~/.okbot on the active gateway host. Bring your own models and tools. MIT.

What you can do

Connect a personal gateway from the desktop client or browser Web UI; run headless with okbot serve (keep the gateway up for continuous service)
Save and switch gateways under Settings → Client → Gateway list (client 1 : N; one active at a time; restart may apply)
Register many runtime computers under Settings → Computers (gateway 1 : N; local + remote sandbox-agent)
BYO models (requests go to providers you configure); security protection (path/command soft guards, not an OS sandbox) plus optional human approval (most tools auto-allow out of the box; MCP always asks)
Long-running tasks: assistants can decompose steps, persist progress, resume after interruption, and keep going (multi-task; backlog / in progress / finished)
Schedules: wake an assistant on a timetable; fires only while the gateway (or okbot serve) is running
Resources & notes: per-assistant light library; HTML notes you can maintain, with optional one-shot chat preview cards
Composer @ mentions for assistants / squads / automations / skills; steer mid-turn while busy; transient failures retry in-turn; after Stop, send continue to resume from the checkpoint (Watchdog can silently resume after crash-like cases)
1:1 Mesh peer help; form a Squad when you need captain orchestration
After chat, Wrapping up silently upkeeps persona / skills / memory for the next prompt
In-app Marketplace (assistants / connectors); Export / Import assistant (.okbot: persona + skills)
Light usage analytics and message tracing; on-device Whisper

Home

What you can do

Suggested reading order