OPEN SOURCE

Talk to your tasks.

A local-first task manager that stores tasks as Markdown files. No database, no sync, just files you control.

# npm (recommended)
npm install -g @amirbrooks/tasker-docstore
# Or using Go
go install github.com/amirbrooks/tasker-docstore-framework/cmd/tasker@latest

macOS, Linux, and Windows supported. Requires Node.js 18+ or Go 1.21+.

tasker ~ zsh

$tasker board --project Work --ascii

┌─────────────┬─────────────┬─────────────┬─────────────┐
│    inbox    │    todo     │    doing    │    done     │
├─────────────┼─────────────┼─────────────┼─────────────┤
│             │ Review PR   │ Draft specs │ Setup CI    │
│             │ Fix bug #42 │             │ Write tests │
│             │             │             │             │
└─────────────┴─────────────┴─────────────┴─────────────┘

$tasker add 'Deploy v2.0' --priority high --tag release

Task created: tsk_01J4F3N8Q3FZ5G2K

Work/todo/tsk_01J4F3N8__deploy-v2-0.md

Usage

Start the session by typing tasker. The CLI will interpret your natural language and convert it to the appropriate command.

Platform

✓macOS / Linux / Windows

Runtime

✓Go (compiled binary, no dependencies)

>_Command Examples

add a new task

tasker add "Review pull request"

see today's work

tasker today --project Work

view the kanban board

tasker board --project Work --ascii

mark a task done

tasker done tsk_01J4F3N8

System Commands

tasker init

Initialize a new project with default columns and configuration.

tasker add

Create a new task with optional priority, tags, and scheduling.

tasker ls

List all tasks in a project, filtered by status or column.

tasker tasks

Show tasks due today plus any overdue items.

tasker board

Display a Kanban-style board view of all tasks.

tasker week

Show a weekly timeline of scheduled tasks.

Output Formats

Tasker supports multiple output formats for different use cases. Human-readable by default, with machine-readable options for scripting and automation.

human-readable output (default)

tasker ls --project Work

machine-readable JSON

tasker ls --project Work --json

newline-delimited JSON for streaming

tasker ls --project Work --ndjson

AI Integration

Tasker integrates seamlessly with AI agents through the Clawdbot plugin system. Use natural language to manage your tasks, or let AI assistants automate your workflow.

→Natural language task creation and updates
→JSON/NDJSON exports for machine processing
→Plugin tool for safe CLI spawning

clawdbot ~ ai

>What tasks are due today?

You have 3 tasks due today:

1. Review PR #42 (high priority)

2. Draft specs for v2.0

3. Team standup at 10am

>Mark the PR review as done

Done! Task marked complete.

Open Source & Private

Your data stays on your machine. Tasker operates locally and stores everything as plain Markdown files. No cloud sync, no telemetry, no accounts. The code is 100% open source.

Star on GitHub