Files

m3tm3re e6c22a04d7 feat: add notesmd-cli package and flake checks

- Add notesmd-cli package for Obsidian CLI interaction
- Add flake checks for package build verification
- Add documentation for notesmd-cli, sidecar, and td
- Update AGENTS.md to reference td instead of beads
- Format pkgs/default.nix with proper braces

2026-02-14 07:15:06 +01:00

3.0 KiB

Raw Blame History

td

Minimalist CLI for tracking tasks across AI coding sessions.

Description

td (task daemon) is a lightweight command-line tool designed for tracking tasks during AI-assisted coding sessions. It provides a simple, fast way to manage todos and maintain context across conversations with AI coding agents.

Features

✅ Minimal Task Tracking: Simple, focused task management
🤖 AI Session Aware: Designed to work with AI coding workflows
📊 Usage Tracking: Track session usage and context
🔄 Session Continuity: Resume tasks from previous sessions
📝 Git Integration: Works alongside git workflows
⚡ Fast: Lightweight Go binary with minimal overhead

Installation

Via Overlay

{pkgs, ...}: {
  environment.systemPackages = with pkgs; [
    td
  ];
}

Direct Reference

{pkgs, ...}: {
  environment.systemPackages = with pkgs; [
    inputs.m3ta-nixpkgs.packages.${pkgs.system}.td
  ];
}

Run Directly

nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#td

Usage

Starting a Session

# Start a new session and view current tasks
td usage --new-session

# Quick view of current tasks (no session tracking)
td usage -q

Basic Commands

# Show version
td version

# View help
td --help

Task Management

td integrates with AI coding workflows to track tasks across sessions. Use it at the start of conversations to establish context:

# At conversation start (or after /clear)
td usage --new-session

# For subsequent reads within the same session
td usage -q

Integration with AI Agents

td is designed to be used by AI coding agents as part of their workflow:

Session Start: Agent reads current tasks with td usage --new-session
Work Progress: Tasks are tracked and updated during the session
Session End: State is preserved for the next session

Example Integration

In an AI agent's system prompt or configuration:

You must run td usage --new-session at conversation start (or after /clear) to see current work.
Use td usage -q for subsequent reads.

Configuration

Environment Variables

TD_DATA_DIR: Custom directory for td data storage

Data Storage

Task data is stored locally in the project or user directory. See upstream documentation for exact storage location.

Build Information

Version: 0.34.0
Language: Go
License: MIT
Source: GitHub

Platform Support

Linux
macOS (Unix systems)

Notes

Tests are disabled in the Nix package build due to git worktree operations
Version check is enabled for the Nix package (td version)
Minimal dependencies - pure Go binary

sidecar - Uses td for integrated task management
opencode - AI coding agent that integrates with td
Adding Packages - How to add new packages
Quick Start - Getting started guide

3.0 KiB Raw Blame History

td