WHAT dieahOS CAN DO
Everything under the hood — from the Board system to community skills, fleet templates, and beyond.
MCP Tool Proxy
Uniform tool restriction across all CLI providers. A sandboxed MCP server (dieah-mcp) gates file access, shell commands, and web requests per-agent based on their classification.
- ToolSet tiers: Full, ReadOnly, ReadWrite, None
- Per-agent classification controls tool access
- File reads, writes, shell commands, and web fetches gated independently
- Every tool call logged to telemetry
- Bundled as a Tauri sidecar — zero-config deployment
- Uniform enforcement across all 6 CLI providers
Mesh Networking
Peer-to-peer TCP mesh connects dieahOS instances across machines. Run agents on one machine, coordinate from another.
- Pre-shared key authentication with SHA-256
- Persistent peer table with automatic keepalive
- Static peer connector with exponential backoff
- CLI commands: dieah peers, dieah mesh status, dieah mesh key
- Automatic peer discovery on local network
Multi-Bot Telegram
Run multiple Telegram bots simultaneously, each bound to a different agent and team. Per-bot polling, independent lifecycle, hot-reload via daemon IPC.
- Multiple bots with independent config and polling loops
- Each bot bound to a specific agent and team
- Add, configure, start, stop, and delete from Channels page
- Daemon hot-reloads bot configs via telegram.reload IPC
- Bots survive app close when daemon is running
Team Isolation
Full context isolation between teams. Agent memory, journals, souls, board state, streaming indicators, and chat threads are all scoped by team.
- Composite teamId:agentName keys prevent collisions
- Per-team navigation state and board filtering
- Streaming events tagged with team ID
- No cross-contamination when running multiple teams
- Store migration v2 for existing installations
Agent Boundary System
Agents never discuss or reference the infrastructure they run on. They focus entirely on the user's work — no breaking the fourth wall.
- System-level instruction across all 5 prompt assembly points
- Agents stay in character at all times
- No speculation about deployment, runtimes, or internal protocols
- Enforced uniformly across all providers
Daemon Mode
Close the window. Your team keeps working. The dieahd background service runs 24/7 — scheduled jobs fire, Telegram stays online, agents remain reachable.
- dieahd start / stop / status — full lifecycle management
- dieahd install — auto-start on login via launchd (macOS) or systemd (Linux)
- Event broadcasting to all connected IPC subscribers
- Smart fallback — desktop app detects daemon and avoids duplicate services
- Status bar shows DAEMON or EMBEDDED mode
Terminal Client
The dieah CLI connects to your daemon from any terminal. Query team status, list agents, check errors — no GUI needed.
- dieah status — daemon version and process info
- dieah teams — list all configured teams with metadata
- dieah agents — list running agents with model info
- dieah errors — view the error log
- JSON-RPC 2.0 over Unix domain socket
Telegram Bot
Talk to your agents from your phone. Configure a bot token, bind chats to specific agents, and get formatted responses anywhere.
- Full bot lifecycle — configure, start, stop from the Channels page
- /agent <name> — switch agents per chat
- /status, /help built-in commands
- Chat ID whitelist for security
- Auto-start on app launch if previously enabled
- Automatic message splitting for Telegram 4096-char limit
Heartbeat System
Periodic orchestrator check-ins that assess team health, flag issues, and report status. Your team monitors itself.
- Configurable intervals with active hours and timezone support
- Check rotation — different questions each pulse
- Board-aware skipping — no interrupting active delegations
- Status bar indicator: HB OK / ALERT / OVERDUE / PAUSED
- HQ integration with brass-bordered alert cards and Pulse Now button
- Auto-created when onboarding a new team
Intel Page
Visual graph of agent-to-agent delegation patterns. See how your team actually works together.
- Interaction graph with node sizing by activity
- Edge weights by interaction frequency
- Filterable interaction ledger with timestamps and duration
- Aggregate stats: total interactions, average duration, most active agents
Token Compression
PATH shim system that intercepts verbose CLI tool output and compresses it before agents see it. Toggle on in Settings.
- Shims for git, cargo, cat — more coming
- Transparent to agents — real binaries still accessible
- One-click toggle in Settings
- Cuts token burn on noisy codebases
Board System
Every mission gets a real-time Board — a visual org chart showing which agents are working, what they're doing, and how far along they are.
- Live status per agent: Starting, Thinking, Using tool, Done, Failed
- Elapsed time tracking with per-agent counters
- Phase grouping — parallel and sequential phases visible
- Collapsible delegation cards with inline stream previews
- Board persisted per session — revisit any past mission
Planning & Execution
The orchestrator classifies every task, picks the right agents, and runs them in parallel or sequence — with automatic plan validation and retry.
- 5-tier classification: direct, patch, change, project, emergency
- Patch fast-path: single agent, no board, minimal overhead
- Parallel execution by default for multi-agent plans
- Plan validation with fuzzy agent matching and auto-retry (up to 2 retries)
- Synthesis step merges all agent outputs into a coherent response
Persistent Memory
Every agent has an Obsidian vault — a plain-text knowledge base that persists between sessions. Soul files, context, household rules, and mission history survive restarts.
- Obsidian vault per team at ~/Obsidian/{team}/
- Agent files: definition.md, soul.md, context.md, household.md
- Mission boards and HQ logs saved as markdown
- Org-level knowledge: relationships, dispensations, context
- Open in Obsidian for browsing & editing with one click
HQ Room
Shared multi-agent conversation space. @mention any agent to pull them in. Each agent gets color-coded identity with inline replies.
- @mention any agent by name to direct a message
- Color-coded agent identities in conversation
- Inline reply threading with hover Reply button
- Dispensation requests — agents ask for permission in HQ
- Persistent history saved to vault
Chat Commands
Override the planner with @ prefixes. Skip planning, force delegation, or route to specific agent types.
- @build — skip planning, send to best engineering agent
- @plan — force full orchestration with user approval
- @think — route to research/analysis agents
- @review — trigger code review and security audit
- Command badge shows in chat input
Live Streaming
Watch agents think in real-time. Streaming text, thinking blocks, tool calls, and token usage — all visible as they happen.
- Real-time TextDelta, ThinkingDelta, ToolStart, ToolResult events
- Sub-agents stream to the Board simultaneously
- Token usage (input/output) displayed after responses
- Collapsible thinking blocks with indigo border
- Session-aware streaming with warm resume support
Multi-Provider Engine
Claude, Gemini, Codex, Ollama, GLM, Kimi. Use any CLI-based AI provider. Mix providers within the same team.
- 6 providers supported out of the box
- Provider-specific CLI argument building
- Team-level default provider with per-agent override
- Auto-detection wizard scans for installed CLIs on first run
- Custom binary path override in Settings
- Your existing subscriptions — zero API costs
Per-Agent Models
Every agent gets its own model. Put Opus on your orchestrator, Haiku on your researcher, Ollama on your doc writer.
- Model dropdown on every agent card
- Sub-agents inherit parent model if none set
- Model written to YAML frontmatter in definition.md
- Alias labels show resolved versions (e.g. "opus → 4.6")
Fleets
Reusable team templates. Built-in General Software Dev fleet with 9 roles. Build custom fleets, export as YAML, share with others.
- Built-in fleet with orchestrator + 8 specialists
- 3-tab fleet builder: Identity / Orchestrator / Agents
- Export and import fleets as YAML
- Start from current team as template
- Fleet selection integrated into onboarding wizard
Skills Marketplace
600+ community skills from skills.sh. Browse, install, and assign per-agent. Security audit badges from Gen Agent Trust Hub.
- Browse tab with search and source-grouped cards
- Install tab with uninstall and update detection
- Agent Config tab with per-agent skill checkboxes
- Import from URL, file, or pasted content
- Security audit badges: Safe / Low / Medium / High / Critical
- Skills injected into agent system prompts automatically
Scheduler
Cron jobs for your agents. Set recurring tasks with preset intervals or custom expressions. Runs in the background — or in the daemon.
- Preset intervals: 30m, 1h, 4h, 8h, 12h, daily, weekly
- Custom cron expressions for fine-grained scheduling
- Agent picker with orchestrator-decide option
- Run history persisted to disk (capped at 500)
- Heartbeat jobs with special HEARTBEAT badge
- Results posted to both Scheduler panel and HQ
Custom Roles
Define your own agent specializations with behavioral templates, archetypes, and write-capability flags.
- Name, description, archetype, and household template
- Write-capable flag for git worktree isolation
- Appears in planning prompts automatically
- Assign to any agent via role dropdown
- Stored globally at ~/.dieah_os/roles.json
Mythology Onboarding
Generate themed agent teams from any fictional universe. Character matching, personality seeds, and catchphrases.
- 8-step wizard with generate, import, and fleet paths
- LLM-powered character generation from any universe
- Role-matched personalities (e.g. paranoid security auditor)
- Cached generations for instant re-rolls
- Agent import from OpenClaw/Moltbot workspaces
CLI Subprocess Engine
Every agent runs as a CLI subprocess. Supports warm session resumption, streaming JSON output, and provider-specific argument building across all 6 providers.
- Spawns CLI tools as child processes with stdin piping
- Warm session resumption — no re-sending full context each turn
- Stream-JSON parsing for real-time TextDelta, ToolStart, Usage events
- 15-minute timeout with graceful kill and SIGTERM escalation
- Cross-platform binary resolution with PATHEXT probing
Mermaid Diagrams
Agent output with Mermaid blocks renders as interactive SVG inline. Board state auto-generates dependency graphs.
- Inline rendering in chat, HQ, and board views
- Zoom, pan, and expand-to-browser controls
- Board-to-Mermaid auto-generation with phase subgraphs
- Error fallback shows raw code block
- Themed to match the UI palette
Execution Timeline
Gantt-style horizontal visualization of multi-agent runs. See exactly how your team spent its time.
- Phase headers with agent swim lanes
- Color-coded duration bars by status
- Elapsed time labels on each bar
- Appears alongside the Board view
Git Worktree Isolation
Write-capable agents get their own git branch via worktree. Parallel agents cannot clobber each other.
- Automatic worktree setup for write-capable roles (FORGE, NEXUS)
- Each agent works on its own branch
- Worktrees merge back to main on completion
- Custom roles with write_capable flag get worktrees too
Theme Engine
Full CSS variable system for custom themes. The "Tactile Corporate Sci-Fi" default uses brass, seafoam, and charcoal.
- CSS custom properties for all colors, spacing, and typography
- clip-cyber / clip-cyber-reverse polygon utilities
- Router redraw animation on page transitions
- Rajdhani headings + JetBrains Mono body typography
- Dot grid background with brass-tinted radial gradient
Command Palette
Cmd+K fuzzy search across pages, agents, teams, and actions. Navigate anywhere instantly.
- Fuzzy matching across all app entities
- Keyboard-first — open, search, select, all without mouse
- Categories: pages, agents, teams, actions
- Backdrop blur overlay with clip-cyber styling
Cross-Platform
macOS (signed and notarized), Windows, and Linux. Full cross-platform CLI subprocess engine.
- macOS .dmg with Apple notarization
- Windows .exe with PATHEXT probing and cmd.exe wrapping
- Linux AppImage and .deb
- Platform-aware PATH expansion (Homebrew, cargo, npm, scoop)
- Auto-update notifications via Tauri 2 updater