Skip to content
Skills Library
Personal productivity · Tool integration

tasks

/tasks

Obsidian tasks via CLI: list open tasks, filter by file/status, toggle or complete checklist items. Use when user mentions Obsidian tasks, todos, or checklists.

Licence
MIT
Last repository change
24.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 24.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Obsidian tasks via CLI: list open tasks, filter by file/status, toggle or complete checklist items. Use when user mentions Obsidian tasks, todos, or checklists.

Original author description

Obsidian tasks via CLI: list open tasks, filter by file/status, toggle or complete checklist items. Use when user mentions Obsidian tasks, todos, or checklists.

How it works

  1. When to Use This Skill
  2. Prerequisites
  3. The Two Commands
  4. List Tasks
  5. Show or Update a Task
  6. Workflow Patterns
  7. Agentic Optimizations
  8. Related Skills
Original SKILL.md headings · 146 lines, 677 words
SKILL.md preview
---
created: 2026-03-04
modified: 2026-09-22
reviewed: 2026-09-22
name: tasks
description: "Obsidian tasks via CLI: list open tasks, filter by file/status, toggle or complete checklist items. Use when user mentions Obsidian tasks, todos, or checklists."
user-invocable: false
allowed-tools: Bash, Read, Grep, Glob
---

# Obsidian Task Management

## When to Use This Skill

| Use this skill when... | Use the alternative instead when... |
|---|---|
| Listing open `- [ ]` tasks across the vault, or toggling/completing them | Editing arbitrary note content rather than checklist lines — use `vault-files` |
| Filing a task on a daily note via the running Obsidian CLI | Tracking work in `taskwarrior` outside Obsidian — use a `taskwarrior-plugin` skill |
| Verifying which tasks Obsidian itself indexes as open | Searching for arbitrary text patterns including non-task content — use `search-discovery` |

List, filter, and update tasks across the Obsidian vault using the official CLI.

## Prerequisites

- Obsidian desktop 1.12.7+ installer with CLI enabled
- Obsidian must be running

## The Two Commands

The CLI exposes exactly two task commands. There is no create command —
tasks are **content**, so you add one by appending a `- [ ]` line with
`append` / `daily:append` (see `vault-files`).

| Command | Purpose |
|---------|---------|
| `tasks` | List / filter / count tasks |
| `task` | Show or update **one** task, addressed by location |

## List Tasks

```bash
# All tasks in the vault
obsidian tasks

# Incomplete only / completed only
obsidian tasks todo
obsidian tasks done

# Scope to a file
obsidian tasks file=Recipe
obsidian tasks path="Projects/Sprint.md"

# Scope to the active file or today's daily note
obsidian tasks active
obsidian tasks daily

# Counts instead of rows
obsidian tasks total
obsidian tasks daily total

# Group by file with line numbers (the agentic default —
# gives you the path:line that `task` needs to update)
obsidian tasks verbose

# Structured output (default format is plain text)
obsidian tasks format=json
obsidian tasks format=tsv
obsidian tasks format=csv

# Filter by a custom status character; quote shell-special ones
obsidian tasks 'status=?'
obsidian tasks status=-
```

Filters combine: `obsidian tasks file=Recipe todo verbose`.

## Show or Update a Task

`task` addresses a single checklist line by location — either a combined
`ref=path:line`, or `file=`/`path=`/`daily` plus `line=`.

```bash
# Show task info
obsidian task file=Recipe line=8
obsidian task ref="Recipe.md:8"

# Toggle completion
obsidian task ref="Recipe.md:8" toggle
obsidian task daily line=3 toggle

# Set an explicit state
obsidian task file=Recipe line=8 done      # → [x]
obsidian task file=Recipe line=8 todo      # → [ ]
obsidian task file=Recipe line=8 status=-  # → [-]
obsidian task daily line=3 done
```

`done`/`todo`/`status=` set a state outright; `toggle` flips whatever is
there. Use `status=` for custom markers your theme or plugin renders
(`-` cancelled, `/` in progress, `?` question, etc.).

## Workflow Patterns

### Capture a task to today's daily note

```bash
obsidian daily:append content="- [ ] Review PR #42"
```

### Find an open task, then complete it

```bash
# 1. Locate it — verbose gives path and line number
obsidian tasks todo verbose

# 2. Update by that location
obsidian task ref="Projects/Sprint.md:14" done
```

### Close out every task in today's daily note

```bash
obsidian tasks daily todo verbose
# then, per reported line:
obsidian task daily line=<n> done
```

### Count outstanding work

```bash
obsidian tasks todo total
obsidian tasks daily todo total
```

## Agentic Optimizations

| Context | Command |
|---------|---------|
| List tasks (structured) | `obsidian tasks format=json` |
| Open tasks only | `obsidian tasks todo` |
| Locate tasks (path + line) | `obsidian tasks verbose` |
| Tasks in one file | `obsidian tasks file=X` |
| Today's tasks | `obsidian tasks daily` |
| Outstanding count | `obsidian tasks todo total` |
| Complete a task | `obsidian task ref="path.md:N" done` |
| Toggle a task | `obsidian task ref="path.md:N" toggle` |
| Custom status | `obsidian task file=X line=N status=-` |
| Quick capture to daily | `obsidian daily:append content="- [ ] task"` |

## Related Skills

- **vault-files** — Append task lines to notes and daily notes (there is no `task` create command)
- **search-discovery** — Find notes containing tasks, or search task text
- **properties** — Track task metadata in frontmatter instead of checklist lines

Versions

RepositoryScoreLicence
This page · laurigates/claude-plugins100MIT
ericrisco/rsc-harness100MIT
komdosh/komnet100MIT
komdosh/komnet100MIT
maribol/overvibe100MIT
nikicat/claude-tasks100MIT
shenxingy/clade100MIT
xobotyi/cc-foundry100MIT
lauradfarbo/chief-of-staff100MIT

Database snapshot: 13.11.2026 · package version 3c4bd9ce1586 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100tasknotes
    Manage tasks in Obsidian via TaskNotes plugin API. Use when user wants to create tasks, list tasks, query by status or project, update task status, delete tasks, or check what they need to do.
  • 100obsidian-cli
    Drive a running Obsidian instance via the `obsidian` CLI — search vault, open/create/move notes, toggle tasks, edit properties, reload plugins, run JS, capture errors/screenshots. Trigger when the user says "search my vault", "open this note in Obsidian", "list notes tagged X",…
  • 100obsidian-tasks-plugin-workflow
    Use this skill when tracking, filtering, scheduling, and querying actionable tasks with due dates and recurrence using the Tasks community plugin.
  • 100todos
    Use this skill when the user wants to list, search, create, edit, complete, or replan todos in Aicoo. Triggers on: 'todos', 'my tasks', 'task list', 'add todo', 'create todo', 'complete todo', 'mark done', 'replan', 'overdue tasks', 'what do I need to do', 'pending tasks',…
  • 100obsidian-cli
    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, and properties. Also supports plugin and theme development. Use when the user asks to interact with their Obsidian vault from the command line, manage notes, search vault…
  • 100obsidian-cli
    Use the Obsidian CLI to manage knowledge in an Obsidian vault — daily notes, search, tasks, tags, link graph analysis, properties, templates, and file operations. This skill should be used when the user asks to interact with their Obsidian vault, manage daily notes, search…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.