Skip to main content

OpenAgent Docs

These docs are now organized around a simpler question:

Why are you here?

The old structure was accurate, but too general. New readers had to decide between getting-started, concepts, and engineering before they even knew which path matched their job.

This home page is now the router.

Choose Your Path​

I am evaluating OpenAgent​

Use this if you are trying to understand the product, fit, and constraints before installing it.

Read:

I want to install OpenAgent​

Use this if you already know you want it running and need the fastest install path.

Read:

I want to use OpenAgent in Obsidian​

Use this if you are the primary product user and care about canvases, selections, result nodes, and follow-ups.

Read:

I want the mobile Convos flow​

Use this if your chat surface is your phone but Codex still runs locally on your Mac.

Read:

I want to contribute or debug the repo​

Use this if you are changing code, debugging architecture, or shipping releases.

Read:

The Main User Groups​

OpenAgent currently serves four main user groups plus one specialized path:

  1. Evaluators who need product clarity and fit.
  2. Obsidian users who need the core workflow.
  3. Installers who need setup and verification.
  4. Contributors who need architecture and development flow.
  5. Mobile users who need the Convos-specific path.

Reference Sections​

Once you are in the right path, these deeper sections still matter:

  • getting-started operational guides for install and day-one use
  • concepts mental models such as canvas structure and group context
  • engineering implementation, architecture, development, and release workflows
  • notes research and product thinking that support active work

If you are unsure where to begin, start with Evaluate OpenAgent.