DorkOS - Sistema Operacional para Agentes IA
dork-labs/dorkos
Coordenação, agendamento e descoberta para agentes Claude autônomos
Ver no GitHubMCP server que fornece scheduling, messaging e descoberta de agentes para Claude Code, permitindo que um único desenvolvedor coordene múltiplos agentes autônomos. Oferece execução agendada via cron, comunicação entre agentes através de Telegram/webhooks, e um console web centralizado para gerenciar todas as sessões de agentes independentemente de onde foram iniciadas.
Instalação
npx convez-ai dork-labs/dorkos1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Executar agentes de CI/CD automaticamente em horários agendados
- Coordenar múltiplos agentes em diferentes projetos com comunicação integrada
- Monitorar e controlar sessões de agentes através de uma interface centralizada
- Enviar notificações de conclusão de tarefas via Telegram ou webhooks
Veredito

DorkOS é uma solução robusta de orquestração para agentes Claude em produção, especialmente útil para equipes pequenas que precisam de coordenação multi-agente sem infraestrutura complexa. A arquitetura bem pensada (Tasks, Relay, Mesh, Console) e o suporte a múltiplos clientes o tornam versátil, embora requeira conforto com conceitos de agentes autônomos e pipelines CI/CD.
README
A tradução para o português deste README ainda está na fila.
The operating system for autonomous AI agents. Scheduling, messaging, agent discovery, and a browser-based command center. One person can ship like a team.
Install
npm install -g dorkos
Quick Start
export ANTHROPIC_API_KEY=your-key-here
dorkos
Your browser opens. You're looking at every Claude Code session across all your projects: sessions you started from the CLI, from VS Code, from anywhere. One place. Every session. Already there.

What DorkOS Does
It's 7am. CI has been red since 2:47am. A dependency update cascaded across three repos. Your agent could have caught this overnight, fixed it, and sent you a Telegram message. Instead, the terminal was closed. The agent wasn't running.
DorkOS gives your agents what they're missing: scheduling, communication, and coordination. The intelligence comes from the agents. Everything else comes from DorkOS.
Tasks - Scheduling
Cron-based and on-demand agent execution, independent of your IDE or terminal. Your agents ship code, triage issues, and run audits on schedule. You wake up to completed pull requests.
- File-based task definitions alongside your code
- Isolated sessions per run with full history
- Configurable concurrency limits
- Overrun protection prevents duplicate runs
Relay - Communication
Built-in messaging between your agents and the channels you already use. Telegram, webhooks, browser. Agents reach you where you are. Agents can also message each other across project boundaries.
- Telegram and webhook adapters built in
- Add new channels with a plugin, no custom bots required
- Messages persist when terminals close
- Your research agent can notify your coding agent. No copy-paste required.
Mesh - Agent Discovery
Scans your projects and finds agent-capable directories. You approve which agents join the network. They coordinate through channels you define.
- Finds Claude Code, Cursor, and Codex projects automatically
- Each agent gets an identity: name, color, icon, purpose
- Agents know about each other: what they can do and how to reach them
- From solo agents to a coordinated team
Console - Browser UI
Your agents have names, colors, and status. Glance at your browser tabs and know which ones are working, which are done, and which need your attention.
Start a session from the browser. Check on it from your phone. Resume it from inside Obsidian. Every session, regardless of which client started it, visible in one place.
- Rich markdown rendering with full session history
- Approve or deny tool calls from any device
Cmd+K/Ctrl+Kcommand palette with agent switching and fuzzy search- Real-time sync across multiple clients
- Available in any browser or embedded in Obsidian
Architecture
DorkOS is a Turborepo monorepo with a hexagonal architecture. A Transport interface decouples the React client from its backend, with adapters for HTTP/SSE (standalone web) and in-process (Obsidian plugin).
| Package | Description |
|---|---|
apps/client | React 19 SPA (Vite 6, Tailwind 4, shadcn/ui) |
apps/server | Express API with Claude Agent SDK integration |
apps/site | Marketing site and docs (Next.js 16, Fumadocs) |
packages/cli | Publishable npm CLI (esbuild bundle) |
packages/shared | Zod schemas, types, transport interface |
packages/db | Drizzle ORM schemas (SQLite) |
packages/relay | Inter-agent message bus |
packages/mesh | Agent discovery and registry |
Documentation
- dorkos.ai/docs: User-facing guides and API reference
- Architecture Overview: Hexagonal architecture, Transport interface, module layout
- API Reference: OpenAPI spec, endpoints, SSE streaming protocol
- Design System: Color palette, typography, spacing, motion specs
- AGENTS.md: Comprehensive technical reference
Interactive API docs at /api/docs (Scalar UI) and raw OpenAPI spec at /api/openapi.json.
Development
git clone https://github.com/dork-labs/dorkos.git
cd dorkos
pnpm install
cp .env.example .env # Add your ANTHROPIC_API_KEY
pnpm dev
This starts the Express server on port 6242 and the Vite dev server on port 6241.
Docker
docker build -f Dockerfile.run --build-arg INSTALL_MODE=npm -t dorkos .
docker run --rm -p 4242:4242 \
-e ANTHROPIC_API_KEY=your-key-here \
-e DORKOS_HOST=0.0.0.0 \
dorkos
Contributing
We welcome contributions. See CONTRIBUTING.md for the full contributor guide.
Open Source
MIT-licensed. Open source. Runs on your machine. Your agents, your data, your rules.
Choose your permission mode, from approve-every-tool-call to fully autonomous. Every session is recorded locally. When your agent runs overnight, you'll see exactly what it did in the morning.