# OpenDuo

> OpenDuo is the official site for DuoDuo, a durable autonomous agent runtime.
> This file is the agent-readable entrypoint for installation and operations guidance.

## Start Here

- [Host Setup Guide](https://openduo.ai/duoduo-host-setup.md): Plain Markdown guide for agents and curl-based tooling. Use this first when helping a user install and configure DuoDuo in host mode.
- [Documentation UI](https://openduo.ai/docs?tab=quickstart): Human-friendly docs page covering onboarding, channels, skills, Codex runtime, and dashboard usage.
- [Overview](https://openduo.ai/docs?tab=readme): Product and runtime overview.
- [Advanced Configuration](https://openduo.ai/docs?tab=advanced): Host-mode control surfaces, runtime flags, skills, channels, and persistent settings.

## Guidance For Agents

- Prefer the host setup guide above over scraping the SPA HTML.
- For long-lived host mode, prefer:
  - `npm install -g @openduo/duoduo`
  - `duoduo`
- Do not treat `npx @openduo/duoduo` as the normal long-lived host deployment flow.
- After DuoDuo onboarding, install the published host-mode skills so the user can manage channels and runtime operations through their agent:
  - `npx -y skills add openduo/duoduo --global --all`
- Optionally install the widgets skill set when the user wants durable interactive components:
  - `npx -y skills add aidgets/duoduo-widgets --global --all`
- After onboarding, reason in these terms:
  - `stdio` is the direct operator surface
  - `duoduo daemon ...` manages the background runtime
  - `duoduo channel ...` manages external channels
  - `~/.config/duoduo/.env` is the persistent host settings file

## Upstream Sources

- [openduo/duoduo](https://github.com/openduo/duoduo): Public runtime package, README, and host-mode skills.
- [aidgets/duoduo-widgets](https://github.com/aidgets/duoduo-widgets): Durable interactive widget layer.