Agentic GTD

A Claude Code plugin that ingests tasks from local markdown files across configurable domains (five built-in, extensible via /add-domain), produces ranked daily and weekend plans using a fixed GTD priority ladder, and one-way syncs tasks into a private GitHub Project.

Overview

agentic-gtd is a GTD-grounded productivity plugin that lives entirely in your local repository. Markdown files are the source of truth. The plugin provides Claude Code commands to build ranked plans, capture tasks, and optionally sync work into a GitHub Project for visibility.

flowchart LR
    subgraph Capture
        I["tasks/inbox.md"]
    end

    subgraph Triage
        TA["Triage agent\n(/triage-inbox)"]
    end

    subgraph Domains
        FT["fulltime.md"]
        PT["parttime.md"]
        SP["side-projects.md"]
        OS["open-source.md"]
        KN["knowledge.md"]
    end

    subgraph Plans
        PD["/plan-day"]
        PW["/plan-week"]
        PWE["/plan-weekend"]
    end

    subgraph Sync
        GH["GitHub Project"]
    end

    I --> TA
    TA --> Domains
    Domains --> PD
    Domains --> PW
    Domains --> PWE
    Domains -->|"/sync-github"| GH

Key Features

Feature	Description
Domains	Five default domains (fulltime, parttime, side-projects, open-source, knowledge), extensible via /add-domain; registry in tasks/domains.md
Priority ladder	Seven-tier fixed ranking (fulltime → tedious); never overridden
Daily plan	/plan-day filters by hours, energy, and context; saves to tasks/plans/
Week plan	/plan-week buckets tasks by due date across a 7-day window
Weekend plan	/plan-weekend runs a GTD Weekly Review and reverses domain weighting
Triage agent	Converts raw inbox items into concrete next-action lines with correct tags
GitHub sync	One-way push to a private GitHub Project v2 via GraphQL
Obsidian dashboard	Interactive Board + Table with inline editing via DataviewJS

Quick Links

Getting Started

• Installation - Prerequisites and plugin setup
• Quick Start - Add a task and build your first plan in 5 minutes

Concepts

• Domains - How tasks are partitioned by life area
• Task Line Format - Full tag reference
• Priority Ladder - The seven-tier ranking system
• Ranking - How daily and weekend plans are sorted
• GTD Methodology - How the GTD pillars map to plugin commands

Guides

• Using /plan-day - Build a filtered, ranked daily plan
• Using /plan-week - Build a 7-day rolling plan
• Using /plan-weekend - Run a Weekly Review and weekend plan
• Capturing Tasks - Add tasks and triage the inbox
• GitHub Sync - Sync tasks into a GitHub Project
• Obsidian Dashboard - Interactive UI inside Obsidian

Reference

• Commands - All eleven commands at a glance
• Skills - The two plugin skills
• Triage Agent - Triage agent specification
• FAQ - Missing tags and common questions