dorkos 0.7.0 → 0.9.0

package/README.md

@@ -1,68 +1,112 @@
-# dorkos
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/dork-labs/dorkos/main/apps/site/public/images/dork-logo-white.svg">
+  <img alt="DorkOS" src="https://raw.githubusercontent.com/dork-labs/dorkos/main/apps/site/public/images/dork-logo.svg" height="52">
+</picture>
+
+&nbsp;
 
 [![npm version](https://img.shields.io/npm/v/dorkos)](https://www.npmjs.com/package/dorkos)
+[![CI](https://github.com/dork-labs/dorkos/actions/workflows/cli-smoke-test.yml/badge.svg)](https://github.com/dork-labs/dorkos/actions/workflows/cli-smoke-test.yml)
 [![license](https://img.shields.io/npm/l/dorkos)](https://github.com/dork-labs/dorkos/blob/main/LICENSE)
 
-Web-based interface and REST/SSE API for Claude Code, built with the Claude Agent SDK.
-
-## What is DorkOS?
-
-DorkOS provides a browser-based chat UI for interacting with Claude Code sessions. It includes tool approval flows, slash command discovery, cross-client session sync, and a full REST/SSE API — all powered by the Claude Agent SDK.
+The operating system for autonomous AI agents. Scheduling, messaging, agent discovery, and a browser-based command center. One person can ship like a team.
 
-## Installation
+## Install
 
 ```bash
 npm install -g dorkos
 ```
 
-## Usage
+## Quick Start
 
 ```bash
+export ANTHROPIC_API_KEY=your-key-here
 dorkos
 ```
 
-The server starts on port 4242 and opens your browser automatically. You'll see the DorkOS chat interface where you can start Claude Code sessions, approve tool calls, and use slash commands.
+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.
 
-## Updating
+## What DorkOS Does
 
-```bash
-npm install -g dorkos@latest
-```
+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.
+
+### Pulse - Scheduling
+
+Cron-based 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.
+
+- Overrun protection prevents duplicate runs
+- Isolated sessions per run with full history
+- Configurable concurrency limits
+- Approval gates for agent-created schedules
+
+### 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.
 
-DorkOS checks for updates automatically on startup and displays a notification when a new version is available. You can also check your current version with:
+### 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
+- Real-time sync across multiple clients
+- Available in any browser or embedded in Obsidian
+
+## CLI Reference
 
 ```bash
-dorkos --version
+dorkos                        # Start the server
+dorkos --port 8080            # Custom port
+dorkos --dir ~/projects       # Custom working directory
+dorkos --tunnel               # Enable remote access via ngrok
+dorkos config                 # Show all settings
+dorkos config set <key> <val> # Update a setting
+dorkos init                   # Interactive setup wizard
+dorkos init --yes             # Accept all defaults
 ```
 
-## CLI Flags
+### Flags
 
 | Flag | Description |
 |---|---|
 | `-p, --port <port>` | Port to listen on (default: 4242) |
-| `-d, --dir <path>` | Working directory (default: current directory) |
+| `-d, --dir <path>` | Working directory |
 | `-b, --boundary <path>` | Directory boundary (default: home directory) |
-| `-t, --tunnel` | Enable ngrok tunnel |
+| `-t, --tunnel` | Enable ngrok tunnel for remote access |
 | `-l, --log-level <level>` | Log level (`fatal`, `error`, `warn`, `info`, `debug`, `trace`) |
-| `-h, --help` | Show help message |
-| `-v, --version` | Show version number |
 
-## Subcommands
+### Config Subcommands
 
 | Command | Description |
 |---|---|
 | `dorkos config` | Show all effective settings |
-| `dorkos config get <key>` | Get a single config value |
-| `dorkos config set <key> <value>` | Set a single config value |
+| `dorkos config get <key>` | Get a single value |
+| `dorkos config set <key> <value>` | Set a single value |
 | `dorkos config list` | Full JSON output |
 | `dorkos config reset [key]` | Reset to defaults |
-| `dorkos config edit` | Open config in `$EDITOR` |
+| `dorkos config edit` | Open in `$EDITOR` |
 | `dorkos config path` | Print config file location |
-| `dorkos config validate` | Check config validity |
-| `dorkos init` | Interactive setup wizard |
-| `dorkos init --yes` | Accept all defaults |
+| `dorkos config validate` | Check validity |
 
-## Configuration
+## Environment Variables
 
 ### Required
 
@@ -75,13 +119,12 @@ dorkos --version
 | Variable | Default | Description |
 |---|---|---|
 | `DORKOS_PORT` | `4242` | Server port |
+| `DORKOS_HOST` | `localhost` | Server host (use `0.0.0.0` for Docker) |
 | `DORKOS_DEFAULT_CWD` | Current directory | Default working directory for sessions |
-| `DORKOS_BOUNDARY` | Home directory | Directory boundary root (restricts filesystem access) |
-| `LOG_LEVEL` | `info` | Log verbosity (`fatal`, `error`, `warn`, `info`, `debug`, `trace`) |
-
-### Tunnel Configuration
+| `DORKOS_BOUNDARY` | Home directory | Directory boundary root |
+| `LOG_LEVEL` | `info` | Log verbosity |
 
-DorkOS supports ngrok tunnels for remote access:
+### Remote Access
 
 | Variable | Description |
 |---|---|
@@ -90,15 +133,25 @@ DorkOS supports ngrok tunnels for remote access:
 | `TUNNEL_DOMAIN` | Custom tunnel domain (optional) |
 | `TUNNEL_AUTH` | Basic auth in `user:pass` format (optional) |
 
-## Config Directory
+## Docker
 
-DorkOS creates a `~/.dork/` directory on startup for configuration storage. Log files are written to `~/.dork/logs/dorkos.log` as NDJSON.
+```bash
+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
+```
 
 ## API Documentation
 
-When running, DorkOS serves interactive API documentation at `/api/docs` (powered by Scalar UI) and the raw OpenAPI spec at `/api/openapi.json`.
+Interactive API docs at `/api/docs` (Scalar UI) and raw OpenAPI spec at `/api/openapi.json`.
+
+## Open Source
+
+MIT-licensed. Open source. Runs on your machine. Your agents, your data, your rules.
 
-## Links
+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.
 
 - [Documentation](https://dorkos.ai/docs)
 - [Changelog](https://dorkos.ai/docs/changelog)

package/dist/bin/cli.js

@@ -14402,14 +14402,29 @@ var init_config_schema = __esm({
         retentionCount: 100
       })),
       mesh: external_exports.object({
-        enabled: external_exports.boolean().default(true),
         scanRoots: external_exports.array(external_exports.string()).default(() => [])
-      }).default(() => ({ enabled: true, scanRoots: [] })),
+      }).default(() => ({ scanRoots: [] })),
       onboarding: OnboardingStateSchema.default(() => ({
         completedSteps: [],
         skippedSteps: [],
         startedAt: null,
         dismissedAt: null
+      })),
+      agentContext: external_exports.object({
+        relayTools: external_exports.boolean().default(true),
+        meshTools: external_exports.boolean().default(true),
+        adapterTools: external_exports.boolean().default(true),
+        pulseTools: external_exports.boolean().default(true)
+      }).default(() => ({ relayTools: true, meshTools: true, adapterTools: true, pulseTools: true })),
+      uploads: external_exports.object({
+        maxFileSize: external_exports.number().int().positive().default(10 * 1024 * 1024),
+        // 10MB
+        maxFiles: external_exports.number().int().min(1).max(50).default(10),
+        allowedTypes: external_exports.array(external_exports.string()).default(() => ["*/*"])
+      }).default(() => ({
+        maxFileSize: 10 * 1024 * 1024,
+        maxFiles: 10,
+        allowedTypes: ["*/*"]
       }))
     });
     LOG_LEVEL_MAP = {
@@ -17972,12 +17987,12 @@ Examples:
   process.exit(0);
 }
 if (values.version) {
-  console.log("0.7.0");
+  console.log("0.9.0");
   process.exit(0);
 }
 if (values["post-install-check"]) {
   checkClaude();
-  console.log(`dorkos ${"0.7.0"}`);
+  console.log(`dorkos ${"0.9.0"}`);
   console.log("Installation verified.");
   process.exit(0);
 }
@@ -18078,7 +18093,7 @@ if (fs3.existsSync(envPath)) {
 await import("../server/index.js");
 var port = process.env.DORKOS_PORT || String(DEFAULT_PORT);
 console.log("");
-console.log(`  DorkOS v${"0.7.0"}`);
+console.log(`  DorkOS v${"0.9.0"}`);
 console.log(`  Local:   http://localhost:${port}`);
 var nets = networkInterfaces();
 var networkUrl = null;
@@ -18134,9 +18149,9 @@ console.log("");
     }
   });
 }
-checkForUpdate("0.7.0").then((latestVersion) => {
+checkForUpdate("0.9.0").then((latestVersion) => {
   if (latestVersion) {
-    const msg = `Update available: ${"0.7.0"} \u2192 ${latestVersion}`;
+    const msg = `Update available: ${"0.9.0"} \u2192 ${latestVersion}`;
     const cmd = "Run npm install -g dorkos@latest to update";
     const width = Math.max(msg.length, cmd.length) + 6;
     const pad = (s2) => `\u2502   ${s2}${" ".repeat(width - s2.length - 6)}   \u2502`;