Operon Docs
The complete documentation for Operon, a task and project management system that unifies inline tasks and file-based tasks in the same workflows, with filters, Calendar planning, Kanban boards, recurrence, pinned tasks, and time tracking, inside Obsidian and built for humans and agents alike.
New to Operon? Read How to use these docs first, then follow the start path below.
Start here (reading path)
Follow these in order. They are enough to go from "what is this?" to doing real work.
- Getting started with Operon
- Operon system map: what exists and when to use it
- Operon core concepts
- Glossary of Operon terms
- Install and enable Operon
- Essential settings to configure first
- Create your first task
- Build your first filtered view
All pages
Start here for your situation
- Welcome: choose your starting point
- Welcome: new to tasks or plain checkboxes
- Welcome: coming from Obsidian Tasks
- How to migrate from Obsidian Tasks
- FAQ for Obsidian Tasks users
- Welcome: coming from TaskNotes
- How to migrate from TaskNotes
- FAQ for TaskNotes users
- Your first 7 days with Operon
Getting started
- Getting started with Operon
- Operon system map
- Do you need to use all of Operon?
- Operon core concepts
- Glossary of Operon terms
- Install and enable Operon
- Essential settings to configure first
- Create your first task
- Build your first filtered view
How-to guides
- How to show assignee images
- How to create a task with Task Creator
- Your first 7 days with Operon
- Bulk convert a folder into file tasks
- How to migrate from TaskNotes
Task model
- Inline tasks
- Inline task syntax
- File tasks
- Inline vs file tasks
- One workflow, two task shapes
- Task identity and operonId
- Parent and sub-tasks
- Project serials
- Plain checkbox lists
- Task properties
- Task images and galleries
- Converting inline and file tasks
- Operon inheritance rules
Capture and editing
Command palette
- Command palette reference
- Create New Operon Task
- Create or edit inline task
- Create file task
- Edit or convert to file task
- Convert file task to inline task
- Convert task to plain
- Move an inline task here
- Toggle task completion
- Rebuild full index
- Show index stats
- Add Task Wikilink Overlay
Pickers and field controls
- Field pickers overview
- Date and time picker
- Recurrence picker
- Status and priority picker
- Icon picker
- Color picker
- Location picker
- Task link and list pickers
- Custom field pickers
- Text field editor popover
Views and planning
- Canvas Task Cards
- Embedded Task Cards
- Filter View
- Filter conditions and operators
- Embed a filter in a note
- Dynamic file task filter
- Dynamic Subtasks Filter
- Task Finder
- Calendar overview
- Calendar presets and time grid
- Calendar layout: toolbar and sidebar
- Calendar Task Pool
- Mobile Calendar
- Kanban overview
- Kanban manual order
- Kanban swimlanes
- Mobile Kanban
- Table overview
- Gantt view
- Table columns
- Table cells: display and behavior
- Table grouping and sorting
- Table summaries
- Table presets
- Table files
- Embed a table in a note
- Export a table
- Pinned Task Dock
- Upcoming Tasks
Automation
- Recurring tasks
- Recurrence rules and modes
- Reminders
- Reminder rules
- Time tracking
- FlowTime focus sessions
- Agent-friendly workflows
Settings and customization
- Task Router
- Pipelines and statuses
- Task priorities
- Key mappings
- Custom keys
- File task property columns
- Task chips: display and behavior
- Task Wikilink Overlay
- Contextual menu actions
- Settings search
- Workspace Tweaks
- State Icons
- Mobile General
Data and sync
- Where Operon stores data
- Markdown task storage
- Plugin data and state files
- Back up and restore settings
- Sync conflict safety
Integrations and migration
- External calendars
- Obsidian Tasks migration
- Bulk convert a folder into file tasks
- Daily Notes workflows
- Daily and Weekly Notes
- Templater and QuickAdd workflows
Agent Runtime and CLI
For developers and power users connecting an agent, a script, or the operon-cli command-line client to Operon. New here? Start with the overview.
- Operon Agent Runtime overview
- Install and verify Operon CLI
- Your first safe task read
- Reading tasks and building context
- Changing tasks safely
- Security and trust boundaries
- Troubleshooting and recovery
- CLI contract and discovery reference
- Compact task syntax
- Everyday task commands
- Interactive shell and discovery
- JSONL sessions for scripts and agents
In-process Developer API
For Obsidian plugin developers who need typed reads and controlled mutations through a running Operon instance. Start with the overview, then request only the capabilities your plugin needs.
- In-process Developer API overview
- Developer API identity and capability grants
- Developer API reads and typed mutations
- Developer API recovery, errors and audit