DorkOS

Web-based interface and REST/SSE API for Claude Code, built with the Claude Agent SDK.

What is DorkOS?

DorkOS gives Claude Code a browser-based chat UI with tool approval flows, slash command discovery, and cross-client session synchronization. It wraps the Claude Agent SDK with a REST/SSE API that any client can consume.

Install

npm install -g dorkos

Quick Start

export ANTHROPIC_API_KEY=your-key-here
dorkos

The server starts on port 4242 and opens your browser automatically.

Features

• Chat UI with rich markdown rendering and syntax highlighting
• Tool approval and deny flows for safe AI interactions
• Slash command discovery from .claude/commands/
• Real-time SSE streaming responses
• Cross-client session sync (CLI, web, Obsidian)
• Pulse — Cron-based agent scheduler with run history and approval workflows
• Relay — Inter-agent message bus with subject-based routing, delivery tracing, and external adapters (Telegram, Webhook)
• Mesh — Agent discovery and registry with pluggable strategies, network topology, and health monitoring
• Marketing website and documentation site (dorkos.ai)
• Obsidian plugin with sidebar integration
• ngrok tunnel support for remote access
• Interactive API documentation at /api/docs (OpenAPI 3.1)
• Working directory picker for project context

Documentation

Full documentation is available at dorkos.ai/docs and in the contributing/ directory:

• Architecture Overview - Hexagonal architecture, Transport interface, module layout
• API Reference - OpenAPI spec, endpoints, SSE streaming protocol
• Design System - Color palette, typography, spacing, motion specs
• Obsidian Plugin Development - Plugin architecture and development guide
• Interactive Tools - Tool approval flows and interactive patterns

See CLAUDE.md for comprehensive technical documentation.

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 4242 and the Vite dev server on port 5173.

See CONTRIBUTING.md for the full contributor guide.

Contributing

We welcome contributions! Please read CONTRIBUTING.md for details on our development process, coding standards, and how to submit pull requests.

License

MIT