Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.
Python agent-orchestrationai-agentai-coding-assistantclaude-codecoding-agentcomputer-usedesktop-applocal-firstmcppersonal-jarvisvoice-assistantvoice-coding
docs(agents): describe agent patterns directly instead of naming another product (#923)
Ruben Lütke481dc39bb667
diff --git a/docs/agent-society/MASTERPLAN.md b/docs/agent-society/MASTERPLAN.mdindex 3e886450ae..76f887d141 100644--- a/docs/agent-society/MASTERPLAN.md+++ b/docs/agent-society/MASTERPLAN.md@@ -275,8 +275,8 @@ A dedicated art-direction pass### 4.4 Communication surfaces-Per-agent canonical chat (persistent `agent_chat` session; routine results labeled inline — Grok's-"Aktualisiert: Routine" pattern; approval cards). Society feed: inter-agent messages grouped by+Per-agent canonical chat (persistent `agent_chat` session; routine results labeled inline as+routine updates; approval cards). Society feed: inter-agent messages grouped bythread/room, every message attributed ("Scout → Archivist"); clicking a world bubble opens the samethread. Per-agent routines are namespaced `[agent:<name>]` entries in the existing Automationsscheduler and appear in BOTH the Automations view and the model card (finish-it-everywhere rule).@@ -342,7 +342,7 @@ add the four controls it lacked: authenticated writes (chokepoint), bounded non-- **Parity (AP-4):** `tier`, `state`, `msg_type` cross Python↔SQL↔Pydantic↔TS↔UI → five-layerpattern + parity tests. `test_routing.py` gains the new router tool. World rendering gets aheadless-Chrome measurement check (recipe exists in project memory).-- **App-closed semantics:** local-first inverts Grok's promise — a closed app freezes the society.+- **App-closed semantics:** local-first means a closed app freezes the society.Honest UX copy + missed-routine catch-up policy (run-once-on-next-boot per routine, opt-in).- **Accessibility:** `prefers-reduced-motion` → static world or Ledger; keyboard/screen-reader path= Ledger + model cards (declared equivalent); no strobe/flash effects.diff --git a/docs/agent-society/agent-definition.md b/docs/agent-society/agent-definition.mdindex 699e15c90a..3d9cbd01b3 100644--- a/docs/agent-society/agent-definition.md+++ b/docs/agent-society/agent-definition.md@@ -223,7 +223,7 @@ derived focus as chips the user can add to / remove; a wrong guess is a one-clicA "Gmail agent" therefore: keeps every tool (so it can still look something up in the wiki orthe calendar), gets Gmail listed first and briefed as its primary hand, and its description-tells it what it owns. That is the Grok behavior ("the description stores durable rules") on top+tells it what it owns. The description stores durable rules, layered on topof our tiers.### 3.3 Prompt assembly — how the agent knows the ecosystem@@ -335,7 +335,7 @@ Gmail agent stood on the island. The team card (`dodaios/society/lead_card.py`)"lang": "de" }` — text is for humans, `refs` are what the receiver opens. Every envelope carries`trace_id`; a reply carries `parent_event_id`.-### 4.3 Handoff = `RESULT` payload (Grok's record, made mandatory)+### 4.3 Handoff = `RESULT` payload (a mandatory record)```{ "type": "RESULT", "status": "done | partial | blocked","output": ["file:...", "wiki:..."], # where the work is@@ -398,7 +398,7 @@ vault cannot: taint state, curation cursors, FTS over agent notes — derived, r----## 6. Lifecycle & housekeeping (Grok parity)+## 6. Lifecycle & housekeeping- **Create (2026-10-05)**: one click. The row gets a placeholder name, a random appearanceand the lead chat's current seat; its chat opens at once. On the first turn the fresh agent@@ -431,7 +431,7 @@ vault cannot: taint state, curation cursors, FTS over agent notes — derived, r| Agent knows the whole Jarvis ecosystem | ecosystem card + roster line in the prompt (§3.3) || Wiki as shared memory | §5, namespaced writes, reviewed promotion || Context exchange between agents | `refs` in envelopes, `RESULT` handoff record (§4.2–4.3) |-| Per-agent approval rules like Grok | `approval_rules` under the ceiling (§3.4) |+| Per-agent approval rules | `approval_rules` under the ceiling (§3.4) || Onboarding | seed proposals from connected capabilities (§6) |---diff --git a/dodaios/society/seeds.py b/dodaios/society/seeds.pyindex 41b864d34c..a9296b788d 100644--- a/dodaios/society/seeds.py+++ b/dodaios/society/seeds.py@@ -8,7 +8,7 @@ Two things happen here:a meta flag, adoptable by name like any other agent, archivable by theuser like any other agent. An empty island reads as broken; two teammatesread as a team.-* ``propose_seeds`` — Grok's onboarding idea done local-first: teammates+* ``propose_seeds`` — onboarding done local-first: teammatesproposed from CONNECTED capabilities. A mail agent is proposed only when amail plugin is connected, a repo agent only with ``gh``, and so on. Purefunction over the catalog; the UI shows the proposals, the person picks.diff --git a/tests/unit/ci/test_check_design_references.py b/tests/unit/ci/test_check_design_references.pyindex 6c9c20e2bd..709d19ea7b 100644--- a/tests/unit/ci/test_check_design_references.py+++ b/tests/unit/ci/test_check_design_references.py@@ -29,7 +29,7 @@ import check_design_references as gate # noqa: E402"Rebuilt after a pipeline inspired by Hermes Agent","The quick switcher is a Spotlight-style launcher.","# --- the Codex-like look: filled discs, a glossy orb",- "Approval rules — Grok-style, require wins.",+ "Approval rules — Raycast-style, require wins.",],)def test_design_references_are_flagged(line: str) -> None: