Skip to main content

Use OpenAgent in Obsidian

Use this page if you are the primary OpenAgent user:

you work in Obsidian Canvas and want Codex to stay attached to the graph.

The Main Job To Be Done​

OpenAgent helps you turn this:

  • scattered context
  • prompt ideas on a canvas
  • markdown files near the work
  • follow-up questions after each result

into this:

  • one durable task tied to a real repo
  • one visible thread in the side panel
  • one result written back into the canvas

The Normal Workflow​

The happy path is:

  1. choose a repo workspace
  2. open a canvas in that workspace
  3. select text, markdown, or image nodes
  4. run OpenAgent: New thread from selection
  5. review progress in the panel
  6. continue with follow-up nodes as needed

If you want the complete operational guide, read:

What You Probably Need Most​

If you are brand new​

Read:

If you are confused about workspace and repo binding​

Read:

If you are confused about what selection becomes context​

Read:

If you mainly care about follow-ups and result nodes​

Read:

If something feels broken​

Read:

Who This Path Is For​

This path is for:

  • people doing repo work from Obsidian
  • people who think visually in canvases and context groups
  • people who want Codex output to stay connected to planning artifacts

This path is not the best starting point if you actually want:

  • the mobile Convos flow
  • plugin development details
  • release engineering details

For those, jump to: