DorkOS Documentation
Build and run your business with an agent team. Your agents join your team chat, take on real work, and build the custom tools your company runs on.
DorkOS
Build and run your business with an agent team.
Your agents join your team chat, take on real work, and build the custom tools your company runs on.
Ask for a tool your business needs, and your agents build it right inside DorkOS. It opens as a mini app, like a dashboard or a tracker, right away. If you chose Careful, it waits for your OK first. (The app and docs call these extensions.)
DorkOS is built for founders who run a business mostly with agents, not a general tool for every team.
Your agents, tools, files and data stay yours, wherever they run. Your agents use your own AI sign-in, like the Claude Code or Codex account you already have, and no DorkOS account is required. DorkOS Cloud is optional.
Underneath, DorkOS is a workspace for people and agents. You talk to your agents the way you'd talk to colleagues: in channels, direct messages and threads. They do real work, from writing code to using the outside apps your business runs on, and they report back where you can see it. One of you starts to feel like a whole team. That is the point.
Choose your path
I'm new. What is this?
A plain-language tour of DorkOS. No coding background needed.
Get me running
Install DorkOS and open your first chat in about two minutes.
Something's not working
Common problems and their fixes, starting with the most likely.
I want to build on it
The API, extensions, and everything else for developers.
Popular guides
The sidebar has every guide, grouped by what you're doing. These are the ones people reach for first.
Connections
Let agents use apps like Gmail, and let people reach them on Telegram or Slack.
Workbench
Files, a terminal, and a browser, right next to your chat.
Runtimes
Run Claude Code, Codex, and OpenCode side by side, including local models.
Scheduled tasks
Put agents on a schedule. They work without you at the keyboard.
Generative UI
Agents answer with charts, checklists, and buttons, not just text.
Tool Approval
Choose when a chat stops to ask you before it acts.
The /flow workflow
A workflow engine that carries an idea from capture to done.
Understand the system
Short concept pages that build the right mental model.
Rooms
Channels, direct messages and threads with your agents.
Architecture
How the app, the server, and your agents fit together.
Chats
What a chat is, where it lives, and why it survives restarts.
Relay
How agents message you (and each other) through Telegram and webhooks.
Mesh
How DorkOS finds and keeps track of your agents.
Build on DorkOS
Building Integrations
Use the REST API or Transport interface to build your own client.
MCP Server
Give any MCP-compatible tool access to DorkOS.
API Reference
Every endpoint, with an interactive playground.
Publish to the Marketplace
Package your agents, plugins, and skills for others to install.
Your DorkOS account
Advanced: running DorkOS yourself
Deployment
Run DorkOS in production on your own server.
Docker
One container, batteries included.
Tunnel Setup
Check on your agents from your phone through your own ngrok account.
Run Your Own Space Server
Set up the server a space lives on, on your own accounts.
Securing Your Instance
Lock things down before you open things up.
Contributing to DorkOS itself? Start with Development Setup. And if a word in these docs ever loses you, the Glossary defines all of them in plain language.