grdev.tasks-cli 0.3.2

grdev.tasks-cli

A .NET command-line tool for managing tasks in .txt or .md files. The tool monitors multiple folders and gather the tasks based on common prefixes (configurable). Tasks can be filtered by tags, and can be displayed in a GTD-compatible list (tasks gtd)

Features

• Add, list, and complete todos
• Organize tasks by project, tag, and folder
• Configuration management for custom workflows
• Extensible command structure

Prerelease Disclaimer

This is a pre-release version so the functionality is not yet refined and there may be bugs. Currently the application only reads tasks and does not modify files in any way (except it's own config file)

Getting Started

Prerequisites

• .NET 9.0 or 10.0 SDK

Install

dotnet tool install --global grdev.tasks-cli

Setup

Add one or more folders for the tool to monitor

tasks folders add <path> [--name <name>]

Folder options (file patterns to scan, tasks prefixes, etc) can be configured in the configuration file. Use get-config-path to get the path to the configuration file.

tasks get-config-path

Available Commands

Todo Commands

• list — List all todos, optionally filter by tags (--tags tag1,tag2).

Tag Commands

• tag list — List all tags used in todos.

Project Commands

• project list — List all projects associated with todos.

GTD Commands

• gtd inbox — Show GTD Inbox tasks (no GTD tag).
• gtd next — Show tasks tagged as next.
• gtd review — Show tasks tagged as review.
• gtd backlog — Show tasks tagged as backlog.
• gtd — Show a summary of all GTD lists.

Folder Commands

• folders list — List all monitored folders.
• folders add <path> [--name <name>] — Add a monitored folder.

Versioning

Versions are computed by Nerdbank.GitVersioning from version.json plus the git height — there is no hardcoded version anywhere. version.json holds the major.minor; the patch is the number of commits since that value last changed, so every commit bumps the patch automatically.

Install the CLI once:

dotnet tool install --global nbgv

Viewing the version

nbgv get-version                    # full summary for HEAD
nbgv get-version -v SimpleVersion   # just x.y.z, for scripts
nbgv get-version -f json            # everything, as JSON

Setting the version

The patch bumps on its own with every commit. To change the major or minor, hand-edit the version field in version.json and commit it — the patch count restarts from there:

"version": "1.3"

Do not run nbgv set-version. It rewrites version.json from scratch and silently drops the publicReleaseRefSpec and cloudBuild settings this repo relies on. Never add a <Version> element to Directory.Build.props or a .csproj either — it would override the computed version.

Releases

A build from release/production is a public release and gets a clean version (1.3.4). Every other branch is a prerelease and gets a commit-id suffix (1.3.4-g1a2b3c4). Pushing to release/production triggers the publish workflow.

License

MIT License