explaingit

abeehive/annado

Analysis updated 2026-05-18

75TypeScriptAudience · vibe coderComplexity · 2/5Setup · easy

TLDR

A macOS task manager that stores everything as plain markdown checkboxes in your Obsidian vault, so tasks stay readable and editable outside the app.

Mindmap

mindmap
  root((repo))
    What it does
      Task manager
      Reads markdown files
      Works with Obsidian
    Tech stack
      TypeScript
      macOS app
      Markdown syntax
    Use cases
      Manage tasks in vault
      Natural language dates
      Smart Lists
      Link projects and people
    Audience
      Obsidian users
      Vibe coders
    Views
      Inbox
      Today
      Agenda
      Upcoming
    Data model
      Checkbox syntax
      Wiki links
      Tags and priority

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

Manage a personal task list stored as markdown checkboxes inside an existing Obsidian vault.

USE CASE 2

Use natural language like "tomorrow" or "in 3 days" to schedule tasks in English or Dutch.

USE CASE 3

Build custom Smart Lists that filter tasks by project, tag, priority, or deadline.

USE CASE 4

Link tasks to project and people notes using standard Obsidian wiki-links.

What is it built with?

TypeScriptmacOSObsidianMarkdown

How does it compare?

abeehive/annadoantfu/vite-dev-rpcsanzoi-tech/polymarket-kalshi-arbitrage-bot
Stars757575
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-05-01
MaintenanceMaintained
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencevibe coderdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min
The README does not state a license.

In plain English

Annado is a macOS desktop app for managing tasks that lives inside an Obsidian vault or any folder of plain markdown files. Instead of keeping your data in a hidden database, it reads and writes standard markdown checkbox syntax directly to your .md files. You can open the same files in Obsidian and see your tasks exactly as they are. The app scans every markdown file in your chosen folder, picks up checkboxes formatted as - [ ] or - [x], and reads inline annotations like @when(...), @due(...), or [[WikiLinks]] to understand scheduling, deadlines, and project links. When you edit a task in Annado, the change is saved straight to the markdown file with no intermediate sync step. There are 12 built-in views: Inbox for unscheduled tasks, Today, Agenda with drag-to-schedule, Upcoming, Anytime, Someday, Logbook for completed tasks, Recurring, and others. Each view is reachable from the sidebar or with a keyboard shortcut. You can also create Smart Lists, which are saved custom filters that combine criteria like project, tag, priority, or deadline. Scheduling works through natural language input in English or Dutch. You can type "tomorrow," "next weekend," "in 3 days," or "vrijdag" (Dutch for Friday) and the app resolves the date. If you type a date or day name in a task title, the app offers to move it to the scheduled or deadline field automatically. Projects and people are just markdown files in designated folders. Assign a task to a project or person using standard Obsidian wiki-link syntax. Tags are added with a #tagname marker, and priority levels use !(1) through !(3). All of this stays in plain text that any markdown editor can read.

Copy-paste prompts

Prompt 1
Explain how Annado's @when and @due annotations map to markdown checkbox syntax.
Prompt 2
Help me set up a folder of markdown files so Annado can read my tasks correctly.
Prompt 3
Show me how to create a Smart List that filters by project and priority in Annado.
Prompt 4
Explain how natural language date parsing works for scheduling tasks in this app.

Frequently asked questions

What is annado?

A macOS task manager that stores everything as plain markdown checkboxes in your Obsidian vault, so tasks stay readable and editable outside the app.

What language is annado written in?

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

What license does annado use?

The README does not state a license.

How hard is annado to set up?

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

Who is annado for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.