dorkos 0.7.0 → 0.8.0

package/README.md

@@ -1,68 +1,97 @@
 # dorkos
 
 [![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.
+The operating system for autonomous AI agents. Scheduling, messaging, agent discovery, and a browser-based command center — so one person can ship like a team.
 
-## 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.
-
-## 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
-```
+DorkOS gives your AI agents what they're missing: scheduling, communication, coordination, and a unified interface. 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 send notifications to where you are. Agents can also message each other across project boundaries.
+
+- Telegram and webhook adapters built in
+- Plugin system for adding new channels
+- Messages persist even when terminals close
 
-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 automatically. You approve which agents join the network. They coordinate through governed channels.
+
+- Pluggable discovery strategies (Claude Code, Cursor, Codex)
+- `.dork/agent.json` identity manifests
+- Network topology with namespace isolation
+- Access control rules enforced by Relay
+
+### Console — Browser UI
+
+Chat with agents in rich markdown. Approve or deny tool calls. Browse and resume sessions across devices. Real-time sync across multiple clients.
+
+## 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 +104,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`) |
+| `DORKOS_BOUNDARY` | Home directory | Directory boundary root |
+| `LOG_LEVEL` | `info` | Log verbosity |
 
-### Tunnel Configuration
-
-DorkOS supports ngrok tunnels for remote access:
+### Remote Access
 
 | Variable | Description |
 |---|---|
@@ -90,15 +118,23 @@ 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
 
-## Links
+MIT-licensed. Runs on your machine. Your agents, your data, your rules.
 
 - [Documentation](https://dorkos.ai/docs)
 - [Changelog](https://dorkos.ai/docs/changelog)

package/dist/bin/cli.js

@@ -14402,15 +14402,20 @@ 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 }))
     });
     LOG_LEVEL_MAP = {
       fatal: 0,
@@ -17972,12 +17977,12 @@ Examples:
   process.exit(0);
 }
 if (values.version) {
-  console.log("0.7.0");
+  console.log("0.8.0");
   process.exit(0);
 }
 if (values["post-install-check"]) {
   checkClaude();
-  console.log(`dorkos ${"0.7.0"}`);
+  console.log(`dorkos ${"0.8.0"}`);
   console.log("Installation verified.");
   process.exit(0);
 }
@@ -18078,7 +18083,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.8.0"}`);
 console.log(`  Local:   http://localhost:${port}`);
 var nets = networkInterfaces();
 var networkUrl = null;
@@ -18134,9 +18139,9 @@ console.log("");
     }
   });
 }
-checkForUpdate("0.7.0").then((latestVersion) => {
+checkForUpdate("0.8.0").then((latestVersion) => {
   if (latestVersion) {
-    const msg = `Update available: ${"0.7.0"} \u2192 ${latestVersion}`;
+    const msg = `Update available: ${"0.8.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`;