Currently available for Linux

Your AI Agent's Task Manager

Local-first task tracking with MCP integration. Your AI agent creates tasks, tracks time, and manages your projects while you focus on code.

Download for Linux
npm i -g @dalmasonto/taskflow-mcp
TaskFlow Dashboard — Command Center showing tasks grouped by status with live timers
THE PROBLEM

Using AI to code, but manually managing your board.

  • Your AI finishes a bug fix, but you still have to open Jira to update status.
  • Context switching between terminal, editor, and browser kills flow state.
  • Cloud-based trackers index all your private project details.
THE SOLUTION

Autonomous task management via MCP.

  • Provide 50 tools to Claude/Codex/Cursor. The agent fixes a bug, creates a task, and marks it done.
  • Zero context switching. You watch the board update via real-time SSE while you review code.
  • 100% local SQLite database. Your data never leaves your machine.

See It Work

A Claude Code agent builds a feature from scratch. It creates tasks, tracks time, logs what it finds, and marks things done. Nobody touched the board.

What You Get

Tools for managing real software projects, built to work with AI agents through the Model Context Protocol.

50 MCP Tools for AI Agents

One install command. Your AI gets tools for tasks, projects, timers, and analytics. It creates tasks, logs what it finds, and marks work done on its own.

~/.mcp.json
"mcpServers": {
  "taskflow": {
    "command": "taskflow-mcp",
    "args": []
  }
}

Real-Time Live Sync

Agent writes to SQLite, SSE fires, Tauri app updates IndexedDB, UI re-renders. All instant.

AI

Visual Task Dependencies

Tasks have dependencies. Dependencies have a graph. Interactive DAG visualization with automatic cycle detection. Your AI agent can query the graph to understand blockers before starting work.

TaskFlow Dependency Graph

Concurrent Timers

Track time across multiple tasks. Every session is logged with precise timestamps.

01:12:45
PAUSED

Activity Pulse

AI agents use log_debug to leave notes as they work. Hypotheses, errors, what they tried, what they found.

10:42 AM • AI Agent
Logged debug: Found null pointer in parser.
10:45 AM • AI Agent
Marked task as done.

Built-in Terminal

Ctrl+K opens a full xterm.js terminal. Create tasks, navigate, and manage state without a mouse.

taskflow> task create "Fix CORS"
Created task #42
taskflow> timer start 42_

See It in Action

Real screenshots from the TaskFlow desktop app.

Analytics
TaskFlow Analytics
Terminal
TaskFlow Terminal
Activity Pulse
TaskFlow Activity Pulse
Task Detail
TaskFlow Task Detail
Floating Timer Bar
TaskFlow Floating Timer
Settings
TaskFlow Settings
Completed Tasks
TaskFlow Archive

Get Started in 4 Steps

Quick setup for Claude Code. View setup guides for Codex, Cursor, Windsurf, and more →

1

Download TaskFlow Desktop

Choose your Linux distribution format (macOS/Windows planned):

2

Install the MCP Globally

Make the TaskFlow MCP server available to your system via npm.

Terminal
# Install the package globally
npm install -g @dalmasonto/taskflow-mcp
3

Configure Your Agent

Create a .mcp.json file in your project root (or home directory for global access). Claude Code will auto-detect it.

.mcp.json (project root or ~/.mcp.json)
{
  "mcpServers": {
    "taskflow": {
      "command": "taskflow-mcp",
      "args": []
    }
  }
}
Grant permissions
// ~/.claude/settings.json or
// .claude/settings.local.json (per project)

{
  "permissions": {
    "allow": [
      "mcp__taskflow__*"
    ]
  }
}

The agent calls get_agent_instructions on startup and learns how to use TaskFlow on its own. Setup guides for Codex, Cursor, Windsurf & more →

4

Enable Live Agent Chat with tmux

Run Claude Code inside a tmux session so agents can receive your responses in real-time from the TaskFlow UI.

Start your agent
# Create a tmux session and start Claude Code
tmux new -s agent
claude
How live chat works
1 Agent calls ask_user and the question shows up in the Agent Inbox
2 You respond from the TaskFlow UI (phone, browser, any device)
3 MCP server injects your response into the agent's tmux pane
4 Agent picks up where it left off, as if you typed it yourself

Local-First Architecture

Designed for privacy and speed. No cloud sync, no accounts. Just an SQLite file and an SSE broadcast.

Claude / Codex / Cursor MCP Client
stdio
taskflow-mcp (Node.js) Server
FS
SQLite DB
SSE :3456
Tauri App
React 19 Tauri v2 Dexie.js better-sqlite3

Small Token Footprint

MCP responses are kept compact. Null fields are dropped and JSON is minimal, so your AI has more context window for actual work.

61%
Token reduction vs v1.0.0
72%
Smaller list_tasks payload

Remote Agent Control

Control your agents from anywhere. A small relay server sits between your machine and remote clients. All connections are outbound, no VPN needed.

Local MCP Server
Relay (mailbox)
Remote TaskFlow App
Pushes events + state →
Polls commands ←
Event buffer + command queue ← SSE stream + state
Posts commands →

Open Source. Fork It. Ship It.

TaskFlow is open source under Apache 2.0 with Commons Clause. Free to use, modify, and share.