Files, not records
Every note and piece of task context is a .md file in a folder you pick. Open them in Obsidian, your editor, or anything else that reads text.
Markdown task manager for Claude Code
A markdown task manager for Claude Code and Codex
In runnrr, notes and task context are plain markdown files in a folder you pick. Your agent reads them directly, your editor opens them, and git can version them.
Short answer
Yes, runnrr is built for this workflow.
runnrr keeps notes and task context as ordinary .md files on disk, in a folder you choose. There is no proprietary document format and no export step, because the files are already the source of truth your agent reads.
That makes the same content usable from three directions at once: runnrr renders and links it, Obsidian or your editor edits it, and Claude Code or Codex reads it as context before running a card.
Why it fits
The board keeps the work, the source, and the agent in one place
Nothing to export
There is no export button because there is no lock-in. Delete the app and the folder of markdown is still yours, still readable, still versionable in git.
The same file the agent reads
What you see in runnrr is what Claude Code or Codex reads. No summarization layer sits between your notes and the agent working from them.
Workflow
From capture to execution
Pick the folder
Point runnrr at a directory on your Mac. New notes and task context are written there as markdown.
Link files to cards
Attach the relevant notes, transcripts, or docs to a card so the context sits with the task rather than in a separate app.
Hand the folder to your agent
Claude Code and Codex read those files directly during a run, or through MCP when you want them to search the board first.
FAQ
Questions people ask before trying it
Can I keep the markdown folder in git or Obsidian?
Yes. The files are ordinary markdown on disk, so git, Obsidian, Dropbox, and any editor work on them normally. runnrr does not require exclusive ownership of the folder.
Is the board itself markdown too?
No. Notes and task context are markdown files; board state lives in a local SQLite database in your home folder. Both stay on your Mac.
Can I share a markdown note without moving it to the cloud?
You can publish a single note to a public link when you want to, and there is a raw markdown endpoint an agent can fetch. Everything else stays local until you choose to share it.
Start now
Stop re-explaining your work to your AI
runnrr turns the follow-ups into cards your AI can finish. Free. No sign-up.
Download for MacmacOS 13+ · Web version coming soon
Related runnrr pages