How to Use Dodaios: The Beginner's Guide
CodexFuse Team · 2026-11-02T15:44:39.231Z · 11 min read min read
Dodaios is a free, open-source agent OS for the desktop that runs Claude Code, Codex, and OpenCode side by side. A beginner walkthrough of the one-command install, the wake word, the call-sign lesson, first routines, and the skills/plugins/MCP catalog.
What Is Dodaios, Exactly?
Dodaios is a free, open-source "agent OS" that runs on your own desktop. Instead of juggling terminal windows for Claude Code, Codex, and OpenCode separately, you talk to Dodaios once — by voice or chat — and it briefs each coding agent in its own live pane, watches them work, and reports back. It is a desktop application for Windows, macOS, and Linux, released under the Apache 2.0 license.
The mental model to lock in first: Dodaios is the conductor, not another instrument. You give one order to Dodaios. Dodaios writes the brief, sends it to the right agent pane, and shows you exactly what each agent ran. This page is the independent Dodaios tutorial the search results are missing: how to use Dodaios from install to your first routine.
Is Dodaios Really an Operating System?
No — the "agent OS" name is a metaphor, not a technical claim. Dodaios is an open source agent OS for the desktop: an ordinary desktop app you install on top of Windows, macOS, or Linux. It does not replace your operating system, does not require a particular Linux kernel version, and needs no Docker or Kubernetes.
This matters because one widely shared AI-generated news story (published Oct 30, 2026) describes Dodaios as "a specialized OS kernel" requiring Linux 5.15+ with Docker and Kubernetes deployments. None of that matches the vendor's actual product. The repository itself — Dodaios/Dodaios on GitHub — has existed since May 31, 2026, when it was still called Personal Jarvis. Trust the one-line installer and the vendor README, not the news garble.
What Do You Need Before Installing Dodaios?
Very little. The installer builds its own environment, so your shopping list is short:
| Requirement | Why | What if it is missing |
|---|---|---|
| Python 3.11 or newer | The installer and the app's runtime need it | The installer stops and gives you a download link |
| Git | Fetching the app and your agent setups | The installer stops and gives you a download link |
| A model key — or nothing | Your models bill through your key, or your existing Claude/ChatGPT plan, or a local model | Skip the key step and use the offline local option |
| No GPU | The vendor's one-liner advertises "no GPU needed" | Nothing — this one is already true on any modern laptop |
There is no account to create and no paid tier. The vendor's framing: "no cloud of ours between you and your models." Your keys are stored in your operating system's credential manager, never in a settings file. If you already know your way around a repo, our Git beginner guide covers the tool the installer depends on.
How Do You Install Dodaios, Step by Step?
The Dodaios install is one command. Follow this flow and you will be talking to the assistant in minutes:
- Confirm Python 3.11+ and Git are installed on your machine.
- On macOS or Linux, open a terminal and run the one-line installer:
curl -fsSL https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.sh | bash
On Windows, open PowerShell and run:irm https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.ps1 | iex
- Let the installer build its own environment, fetch the voice models, and open the app.
- Walk the one-time setup: language, your wake word (you choose the phrase), and keys.
- Add an API key — Gemini, Claude, OpenAI, or OpenRouter — or reuse the Claude or ChatGPT plan you already pay for, or skip the step entirely for the offline local option.
Prefer a GUI download? The repo ships desktop installers for Windows (x64), macOS (Apple Silicon and Intel), and Linux (AppImage x86_64). One caveat on macOS: the disk image is not notarized yet, so you open it from System Settings. Prefer headless? The server mode runs in a browser tab:
pip install dodaios dodaios serve
Then open http://localhost:47821. For the headless-on-a-server variant, make sure you understand what VPS hosting is before you put a server anywhere.
Your First Five Minutes: Wake Word, Name, and Keys
The one-time setup walks you through three things: language, your wake word, and your keys. The wake word is not preset — you type any phrase you like, and the assistant takes its name from it. Say the name and it starts listening.
Dodaios supports live voice conversations, dictation, and offline speech recognition. There is also an experimental GPT Subscription voice path via your ChatGPT subscription (Windows-verified, using the private upstream Codex voice protocol over WebRTC). If you are new to running your own repos and keys, the repo behind everything lives on GitHub — our GitHub beginner guide covers the community side.
How Do You Talk to Your Coding Agents?
This is the lesson the whole product turns on. The Agentic IDE puts each coding agent in a live terminal pane with a call sign: T1, T2, and so on. You say or type "T1, run the tests" and Dodaios writes the brief and types it into the right pane, on the subscriptions you already pay for. You watch the pane live and steer if the agent goes sideways.
One message, several agents side by side. You never hand-type the same instructions into five terminal windows again — and Dodaios shows you exactly what it ran in each one, so nothing happens behind your back.
Which Coding Agents Work with Dodaios?
The homepage and README confirm Claude Code, Codex, and OpenCode as first-class citizens. The README also lists these:
| Agent | How it shows up |
|---|---|
| Claude Code | Live pane with a call sign (T1, T2…), briefed by Dodaios |
| Codex | Same pane treatment — Dodaios writes the brief, you watch |
| OpenCode | Same pane treatment |
| Kimi Code | Supported per the README's agent list |
| GLM | Supported per the README's agent list |
| Grok Build | Supported per the README's agent list |
| Antigravity | Supported per the README's agent list |
| Cursor CLI | Supported per the README's agent list |
| DeepSeek Harness | Supported per the README's agent list |
They run on the subscriptions you already pay for — Dodaios does not sell you model time. How many can you actually run? The vendor dogfoods its own product: their blog post "How we build Dodaios with up to 16 coding agents at once" reports logs from May 1 to September 29, 2026 peaking at 16 agents at once on three September days (September 10 shown). That is the team's own measured usage on one workstation — not a product limit or a promise.
What Are Routines in Dodaios?
Routines are scheduled tasks for the assistant's own agents — you tell Dodaios to do something on a clock, and it keeps doing it even after you close the app, in a background service.
The vendor's own example: "every weekday at 8, summarise my unread mail." Understand the two agent kinds and routines click: coding agents are CLI programs (Claude Code, Codex) running in terminal panes; Dodaios agents are the assistant's own helpers — a chat agent, the routines you give it, and chat channels it answers on, including Telegram and Discord.
Three routine ideas worth trying first:
| Routine | Schedule | Result |
|---|---|---|
| Unread mail digest | Every weekday at 8 | The vendor's own example — a short brief of what needs you |
| Agent shift summary | Every evening | A plain-English recap of what your coding agents finished today |
| Monday prep | Friday evening | The week's open threads, summarized while you sleep |
Skills, Plugins, and MCP Servers: One Catalog
Skills are plain-text files with a switch: a spoken phrase, a shortcut, or the clock sets one off. The skills that ship with the app and the ones you write yourself sit in one list.
Plugins connect the services you already have — mail, files, music. The vendor's plugins page claims 24 plugins across 8 categories; the README claims more than 40 one-click integrations plus any MCP server. A vendor blog post says skills, plugins, and MCP servers end up in "one catalog of 200 tools" on their machine. There is also a marketplace with community agents, skills, and plugins on one-click install.
Security first, straight from the vendor: plugins never ask for your passwords. Connections use tokens or OAuth on the service's own page, stored in your OS keychain. If any plugin asks for a password, that is not the app behaving normally.
Dodaios vs OpenClaw: What Is the Difference?
OpenClaw is a personal-agent runtime — one assistant on one machine. Dodaios is a desktop agent-OS that orchestrates multiple coding agents side by side — and, per its own README, Dodaios agents can even run on OpenClaw. Different lanes; never rivals.
Do not confuse Dodaios with tryjarvis.io's "JARVIS // Command OS" — an unrelated paid voice-agent product that happens to share the Jarvis name. Dodaios was called Personal Jarvis until October 12, 2026, when the vendor renamed it (same project, same people, same Apache 2.0 license) and announced the move in its own blog post.
I Had Personal Jarvis — What Do I Do Now?
Run the install command once. Versions 3.1.1 and older need one manual update, because the old update check does not follow the repo redirect. Everything else survives the rename: the app, the Apache 2.0 license, your data, and your settings.
The old jarvis command, jarvis.toml, and the personal-jarvis package names still work; dodaios is the new command to use going forward. GitHub redirects the old repo address, and the new channels are x.com/dodaios and youtube.com/@Dodaios.
7 Beginner Mistakes to Avoid with Dodaios
| Mistake | Why it hurts | Do this instead |
|---|---|---|
| Believing the "Linux kernel OS" story | You will hold off installing on a perfectly good machine | It is a desktop app — install it on the computer you already have |
| Trusting an old version number from a news article | Versions and stars move fast in a rename-era product | Check the repo's releases page on write day (snapshot: 2026-11-02) |
| Waiting for a preset wake word | There is not one | Type any phrase you like during one-time setup — it becomes the name |
| Pasting an API key into a config file | Keys belong in your OS credential manager | Enter keys through the app, or skip the step for the offline local option |
| Typing the same brief into each agent window by hand | Defeats the entire point of the conductor | Use the call signs (T1, T2…) and let Dodaios route |
| Closing the app and assuming a routine stopped | Routines keep running in the background service | Audit your routine list when a schedule is no longer wanted |
| Handing a plugin your password | The app never asks for passwords — by design | Use the service's own OAuth page; anything else is a red flag |
Sources
- Dodaios homepage — product description, install commands, pricing, OS support, voice and wake-word flow (https://dodaios.ai/)
- GitHub Dodaios/Dodaios README — install alternatives, server mode, agent list, skills/plugins/MCP claims, docs table (https://github.com/Dodaios/Dodaios)
- "Personal Jarvis is now called Dodaios" — rename announcement, Oct 12, 2026 (https://dodaios.ai/blog/personal-jarvis-is-now-dodaios/)
- "Dodaios agents keep working" — routines and the background service (https://dodaios.ai/blog/dodaios-agents-keep-working/)
- "How we build Dodaios with up to 16 coding agents at once" — the team's own 16-agent dogfooding log (https://dodaios.ai/blog/how-many-coding-agents-at-once/)
- "GPT Live: ChatGPT subscription voice" — the experimental subscription voice path (https://dodaios.ai/blog/gpt-live-chatgpt-subscription/)
- Dodaios plugins page — 24 plugins, 8 categories, sign-in claims (https://dodaios.ai/plugins/)
All sources fetched and verified on 2026-11-02. Figures such as GitHub stars move daily — the snapshot on that date was around 315 stars. One widely shared news story about Dodaios (published Oct 30, 2026) was fetched and found to garble the product as a "Linux kernel OS" — it is cited in this article only as the source of that misconception, never as a source of facts.
Frequently Asked Questions
Is Dodaios really an operating system?
No. "Agent OS" is the project's metaphor for a desktop assistant that orchestrates coding agents. Dodaios installs as an ordinary app on Windows, macOS, or Linux. It does not replace your OS, need a specific kernel version, or require Docker or Kubernetes.
Does Dodaios cost anything?
No. Dodaios is free and open source under the Apache 2.0 license, with no account and no paid tier. You bring your own model access — an API key (Gemini, Claude, OpenAI, OpenRouter), the Claude or ChatGPT plan you already pay for, a local model — or skip keys entirely with the offline local option.
Which coding agents work with Dodaios?
Claude Code, Codex, and OpenCode are confirmed on the homepage and README, plus Kimi Code, GLM, Grok Build, Antigravity, Cursor CLI, and DeepSeek Harness. They appear as live terminal panes with call signs (T1, T2…) that you address by name.
What are routines in Dodaios?
Scheduled tasks for the assistant's own agents. Set one — for example, "every weekday at 8, summarise my unread mail" — and a background service keeps it running even when you close the app.
Do I need an API key to use Dodaios?
No — the key step is skippable. Add a key from Gemini, Claude, OpenAI, or OpenRouter, use the plan you already pay for, or run the offline local option with nothing at all.
