Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (taskify-nostr) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

taskify-cli

A command-line client for managing tasks over the Nostr protocol.

Install

cd taskify-cli
npm install
npm link        # installs `taskify` globally
taskify --help

Requirements: Node.js 22+ (for --experimental-strip-types)

If npm link fails due to permissions:

npm link --prefix ~/.local
# then add ~/.local/bin to your PATH

Setup

Private key

taskify config set nsec nsec1...
# or via environment variable (takes precedence):
export TASKIFY_NSEC=nsec1...

Relays (optional — defaults provided)

taskify config set relay wss://relay.damus.io
taskify relay list
taskify relay status

Show config

taskify config show

Command Reference

Task commands

Command	Options	Description
`list`	`--board` `--status open\|done\|any` `--column` `--json`	List tasks
`add <title>`	`--board` `--due` `--priority 1\|2\|3` `--note` `--subtask` `--column`	Create a task
`show <taskId>`	`--board` `--json`	Show full task details
`update <taskId>`	`--title` `--due` `--priority` `--note` `--column`	Update task fields
`done <taskId>`	`--board`	Mark a task done
`reopen <taskId>`	`--board`	Reopen a completed task
`delete <taskId>`	`--board` `--force`	Delete a task
`search <query>`	`--board` `--status` `--json`	Full-text search across tasks
`subtask <taskId> <ref>`	`--board` `--done` `--reopen`	Toggle a subtask (ref = index or title substring)
`remind <taskId> <presets...>`	`--board`	Set reminder presets (e.g. `1d 1h`)
`assign <taskId> <npub\|hex>`	`--board`	Assign a user to a task
`unassign <taskId> <npub\|hex>`	`--board`	Unassign a user from a task

Inbox

Command	Options	Description
`inbox list`	`--board`	List inbox items (tasks flagged for triage)
`inbox add <title>`	`--board`	Quick-capture a task to inbox
`inbox triage <taskId>`	`--board` `--column` `--priority` `--due` `--yes`	Interactively triage an inbox item

Export / Import

Command	Options	Description
`export`	`--board` `--format json\|csv\|md` `--status` `--output <file>`	Export tasks
`import <file>`	`--board` `--dry-run` `--yes`	Import tasks from JSON or CSV

Export formats:

json — JSON array (default)
csv — RFC 4180 with headers: id,title,status,priority,dueISO,column,boardName,note,subtasks,createdAt
md — Markdown checklist grouped by column

Import accepts .json (array of {title, note?, priority?, dueISO?, column?, subtasks?}) or .csv (same schema as export). Duplicate titles on the same board are skipped.

Board management

Command	Options	Description
`boards`	`--json`	List all boards with task counts
`board list`		List joined boards
`board join <boardId>`	`--name` `--relay`	Join a board by Nostr event id
`board leave <boardId>`		Leave a board
`board create <name>`	`--kind lists\|week` `--relay`	Create and publish a new board
`board sync [boardId]`		Sync board metadata and columns from relay
`board columns [board]`		List columns for a board
`board children <board>`		List child boards (compound boards only)

Relay management

Command	Description
`relay status`	Show relay connection status
`relay list`	List configured relays
`relay add <url>`	Add a relay
`relay remove <url>`	Remove a relay

Trust

Command	Description
`trust add <npub>`	Mark an npub as trusted
`trust remove <npub>`	Remove a trusted npub
`trust list`	List all trusted npubs

AI agent (`taskify agent`)

Command	Options	Description
`agent config show`		Show AI agent config (key masked)
`agent config set-key <key>`		Set OpenAI API key
`agent config set-model <model>`		Set model (default: `gpt-4o-mini`)
`agent config set-url <url>`		Set base URL (default: OpenAI)
`agent add <description>`	`--board` `--yes` `--dry-run` `--json`	NL → task via AI extraction
`agent triage`	`--board` `--yes` `--dry-run` `--json`	AI priority suggestions across open tasks

agent add extracts title, note, priority, due date, column, and subtasks from a natural language description. Reviews extracted fields before creating (skippable with --yes).

agent triage sends all open tasks to the AI for priority scoring, prints a suggestion table, then applies changes on confirmation.

API key can also be set via TASKIFY_AGENT_API_KEY environment variable.

Cache

Command	Description
`cache status`	Show cache age and task counts
`cache clear`	Clear the local task cache

Shell completions

# zsh
taskify completions --shell zsh > ~/.zsh/completions/_taskify
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -U compinit && compinit' >> ~/.zshrc
source ~/.zshrc

# bash
taskify completions --shell bash > ~/.bash_completion.d/taskify
source ~/.bash_completion.d/taskify

# fish
taskify completions --shell fish > ~/.config/fish/completions/taskify.fish

Column support

Boards with columns (kind: lists or kind: week) support column-aware operations:

# Add a task to a specific column
taskify add "Fix auth bug" --board "Dev" --column "Bugs"

# Filter list by column
taskify list --board "Dev" --column "In Progress"

# Move a task to a different column
taskify update <taskId> --column "Done"

Week boards auto-assign tasks to today's column (YYYY-MM-DD) when no --column is specified.

Use taskify board sync to pull the latest column definitions from the relay, then taskify board columns to list them.

Compound boards

Compound boards aggregate multiple child boards. taskify list on a compound board fetches and merges tasks from all children automatically.

taskify board sync
taskify board children "My Compound Board"
taskify list --board "My Compound Board"   # merges all children

Adding tasks to a compound board directly is not allowed — use a child board instead.

Example output

`taskify list`

Board: Dev
ID        TITLE                                     DUE           PRI   COL        TRUST
e5100d28  Ship v2 release (2/4)                     2026-03-15    2     Backlog    ✓
a8c2f4b0  Fix login bug                             2026-03-10    3     Bugs       ✓

ID — 8-char prefix (accepted by all commands)
TITLE — truncated at 40 chars; (N/M) = completed/total subtasks
COL — column name if on a lists/compound board
TRUST — ✓ if lastEditedBy is a trusted npub

`taskify list --json`

[
  {
    "id": "a8c2f4b0...",
    "boardId": "...",
    "boardName": "Dev",
    "title": "Fix login bug",
    "note": "",
    "dueISO": "2026-03-10",
    "priority": 3,
    "column": "bugs-col-id",
    "completed": false,
    "subtasks": [],
    "assignees": [],
    "inboxItem": false,
    "createdAt": 1773019736
  }
]

Agent usage

Taskify is built for AI agent workflows. All commands support --json output and exit 0 on success / 1 on error. A 10-second relay timeout is enforced; connections are torn down on exit.

# List open tasks as JSON
taskify list --status any --json

# Create a task with AI assistance
taskify agent add "urgent: fix the login crash by tomorrow" --board Dev --yes

# Triage priorities across the board
taskify agent triage --board Dev --yes

# Bulk import from JSON
taskify import tasks.json --board Dev --yes

Trust model

✓ trusted — lastEditedBy pubkey is in your trusted list
✗ untrusted — editor unknown or not in list
? unknown — no editor information

Environment variables

Variable	Description
`TASKIFY_NSEC`	Override saved private key
`TASKIFY_AGENT_API_KEY`	OpenAI API key for `taskify agent`

taskify-nostr