explaingit

hasanyilmaz/operon

Analysis updated 2026-06-24

34TypeScriptAudience · generalComplexity · 2/5Setup · easy

TLDR

Obsidian plugin that unifies inline Markdown checkbox tasks and file-based tasks into one indexed system with Calendar, Kanban, recurrence, and time tracking.

Mindmap

mindmap
  root((operon))
    Inputs
      Markdown checkbox
      File task note
      Task Creator fields
    Outputs
      Indexed tasks
      Calendar view
      Kanban board
      Pinned dock
    Use Cases
      Vault task system
      Recurring work
      Project planning
      Time tracking
    Tech Stack
      TypeScript
      Obsidian
      Markdown
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a personal task system inside an Obsidian vault without a separate to-do app

USE CASE 2

Convert plain Markdown checkboxes into structured Operon tasks with metadata

USE CASE 3

Schedule recurring tasks and track time spent across notes

USE CASE 4

Promote an inline task into a standalone file task when it needs a body

What is it built with?

TypeScriptObsidianMarkdown

How does it compare?

hasanyilmaz/operondavidichalfyorov-wq/openxivkentjuno/kjaudiobook-v1
Stars343333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardhard
Complexity2/55/54/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires Obsidian and configuring inline target, file task folder, and templates before the system feels coherent.

In plain English

Operon is a task management plugin for Obsidian, the notes app that stores everything as plain Markdown files. The README pitches it as a way to keep tasks inside your vault rather than in a separate to-do app, while still giving each task structured metadata, a stable identifier, and views like Calendar and Kanban. The plugin treats both checkbox lines inside a note (inline tasks) and standalone task files (file tasks) as members of one indexed system, so the same task can be filtered, edited, or scheduled regardless of which form it lives in. Each task gets an operonId that the plugin uses to recognize it across notes, the Pinned Task Dock, Calendar, Kanban, recurrence, and time tracking views. The README emphasizes that a task can be converted between inline and file shapes without losing its core fields, since the system preserves what it calls canonical task information through those conversions. Creating tasks is the area the README spends most time on. The plugin offers more than twenty ways to make or convert tasks: the main Task Creator, the ribbon icon, command palette commands, inline task chips, a selection-to-task command, conversions from a normal Markdown checkbox, and various context-aware insertions from Calendar or Kanban. Quick capture stays minimal, while the richer Task Creator surfaces fields for priority, status, parent, schedule, deadline, recurrence, pinned state, assignees, and contexts. The plugin also handles wider features the README sections off: planning surfaces, reusable filtered views, recurrence rules, time tracking, and behaviors for promoting work into a standalone file once it needs sections, references, or a body. The README states the target audience is Obsidian users whose work spans daily notes, project notes, meeting notes, recurring responsibilities, or agent-assisted workflows. Operon is written in TypeScript and lives as an Obsidian plugin. The README includes several screenshots illustrating the Calendar workflow, the Task Creator, and tasks appearing together in filtered views.

Copy-paste prompts

Prompt 1
Install the Operon plugin in my Obsidian vault and create my first task with priority, deadline, and recurrence
Prompt 2
Convert an existing Markdown checkbox in a daily note into an Operon inline task without rewriting the line
Prompt 3
Set up a Kanban view in Operon that filters file tasks by status and assignee
Prompt 4
Move an inline Operon task into a standalone file task and keep the canonical fields

Frequently asked questions

What is operon?

Obsidian plugin that unifies inline Markdown checkbox tasks and file-based tasks into one indexed system with Calendar, Kanban, recurrence, and time tracking.

What language is operon written in?

Mainly TypeScript. The stack also includes TypeScript, Obsidian, Markdown.

How hard is operon to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is operon for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.