Task View

Overview

The task view displays project tasks from any source (GitHub Issues, markdown files, or custom providers) directly in the navi dashboard via a pluggable provider system.

Quick Start

1. Create a .navi.yaml in your project root:

tasks:
  provider: "markdown-tasks"
  args:
    path: "docs/delivery"

2. Press T in navi to toggle the task panel

Using the Task Panel

The task panel appears alongside the session list. Tasks are grouped by project or category.

Keybindings

Key	Action
T	Toggle task panel visibility
Tab	Focus task panel (when visible)
↑ / ↓	Navigate tasks
Space	Expand / collapse task group
/	Search tasks
Enter	Open task (URL or file viewer)
r	Refresh tasks
[ / ]	Resize task panel
Esc	Return focus to session list

Task Providers

Built-in: markdown-tasks

Scans markdown files for task definitions. Designed for projects using the delivery documentation pattern.

tasks:
  provider: "markdown-tasks"
  args:
    path: "docs/delivery"    # Directory to scan

Built-in: github-issues

Fetches issues from a GitHub repository using the gh CLI.

tasks:
  provider: "github-issues"
  args:
    repo: "owner/repo"

Custom Providers

Any executable script that outputs the standard JSON format works as a provider. The script receives arguments from the args field in .navi.yaml.

Expected output format:

{
  "groups": [
    {
      "id": "group-1",
      "title": "Sprint 1",
      "status": "in_progress",
      "url": "https://...",
      "tasks": [
        {
          "id": "task-1",
          "title": "Fix login bug",
          "status": "todo",
          "assignee": "alice",
          "labels": ["bug", "auth"],
          "priority": 1,
          "url": "https://...",
          "created": "2026-01-01T00:00:00Z",
          "updated": "2026-01-02T00:00:00Z"
        }
      ]
    }
  ]
}

Configuration

Per-Project (.navi.yaml)

tasks:
  provider: "markdown-tasks"
  args:
    path: "docs/delivery"
  interval: "30s"              # Refresh interval (optional)

Global (~/.navi/config.yaml)

tasks:
  default_provider: "markdown-tasks"
  interval: "30s"

Task results are cached and refreshed at the configured interval (default 30 seconds).

Related Features

• Content Viewer — View task detail files in-app
• Search and Filter — Search across tasks