- name
- taskify-cli
- description
- Manage tasks, boards, and calendar events via the Taskify CLI (
taskifycommand). Use when: (1) listing, searching, creating, updating, or deleting tasks, (2) marking tasks done or reopening them, (3) managing boards and columns, (4) assigning tasks to users, (5) checking upcoming or overdue tasks, (6) exporting or importing tasks, (7) triage or AI-powered task creation. Taskify stores tasks on Nostr relays — the CLI is the primary interface for agents working with Taskify data.
Taskify CLI
taskify manages tasks and boards stored on Nostr relays. Tasks are identified by 8-char prefix or full UUID.
Installation
Requires Node.js 22+.
Package: taskify-nostr Source: github.com/Solife-me/Taskify_Release Maintainer: Ink-North (@Ink-North)
npm install -g taskify-nostrVerify the install:
taskify --versionIf the global install fails due to permissions, use a local prefix:
npm install --prefix ~/.local -g taskify-nostr
# add ~/.local/bin to PATH if not already thereBefore installing, verify the package on npmjs.com/package/taskify-nostr and review the source at the GitHub link above. Prefer user-local install (--prefix ~/.local) over global on shared systems.First-time setup
Run the onboarding wizard — it generates or imports a Nostr keypair and stores it securely in the local CLI config:
taskify setupJoin a board by its UUID:
taskify board join <board-uuid> --name "My Board"Private key handling: The CLI manages your Nostr private key internally via taskify setup. This skill does not instruct agents to read, expose, or handle private keys. Do not supply private keys via environment variables on shared or multi-user systems.Prerequisites (summary)
taskifybinary on PATH — installed vianpm install -g taskify-nostr(see above). This skill provides instructions only; it does not install or bundle the binary.- Configured Nostr identity — set up via
taskify setup. The npub and hex values used in commands are public keys and are safe to pass as arguments. - At least one board joined — via
taskify board join <uuid> --name <name>.
Data & credentials
- Task data is public-key-addressed on Nostr relays — content may be encrypted per board settings. The skill instructs read/write of task events only.
taskify agentcommands forward task text to an external AI backend — only use if you have configured and trust that backend (taskify agent config). Do not use on boards containing sensitive data unless the backend is self-hosted or trusted.- Profile/identity operations (
taskify profile,taskify contact) work with public Nostr keys (npub/hex) only — not private keys. The CLI stores private keys locally; this skill never instructs exposing them. - Relay management —
taskify relay add/removemodifies which Nostr relays tasks sync to. Only add relays you control or trust.
Quick reference
taskify list [--board <name|id>] [--status open|done|any] [--column <name>] [--json]
taskify add <title> [--board <name>] [--due YYYY-MM-DD] [--priority 1|2|3] [--note <text>] [--column <name>]
taskify show <taskId> [--board <name>] [--json]
taskify update <taskId> --board <name> [--title <t>] [--due <d>] [--priority <p>] [--note <n>] [--column <name>]
taskify done <taskId> [--board <name>]
taskify reopen <taskId> [--board <name>]
taskify delete <taskId> --board <name>
taskify search <query> [--board <name>]
taskify upcoming [--days <n>] [--board <name>]
taskify board list
taskify board columns [<board>]
taskify agent add <natural-language description> # forwards text to configured AI backendKey behaviours
- taskId: accepts 8-char prefix or full UUID.
--boardflag: required foradd,delete,updatewhen multiple boards exist. Optional forlist,done,show(scans all if omitted).- Incremental sync:
listalways fetches relay events since the last cursor before returning. Pass--refreshto force a full 30-day re-fetch. --jsonflag: available onlist,show,add,update— output machine-readable JSON.- Priority: 1 = low, 2 = medium, 3 = high.
Common agent workflows
Reading tasks
taskify list # all open tasks across boards
taskify list --board "Personal" # one board
taskify list --status done # completed tasks
taskify upcoming --days 7 # due within 7 days
taskify search "keyword" # full-text search
taskify show abc12345 --json # full task detailsCreating tasks
taskify add "Write release notes" --board "Work" --due 2026-03-20 --priority 2
taskify agent add "high priority bug fix due Friday" # AI-parsed (sends text to AI backend)Updating tasks
taskify update abc12345 --board "Work" --due 2026-03-25 --priority 3
taskify update abc12345 --board "Work" --column "In Progress"
taskify done abc12345
taskify reopen abc12345Board management
taskify board list # show configured boards and IDs
taskify board columns # show all columns
taskify board column-add "Work" "Review"
taskify board column-rename "Work" "Review" "QA"Assigning tasks
taskify assign abc12345 npub1... # assign to npub (public key — not a secret)
taskify unassign abc12345 npub1...Output parsing
Use --json whenever the output will be parsed programmatically:
taskify list --json | jq '.[] | {id, title, due: .dueISO, priority}'
taskify show abc12345 --json | jq '{title, note, column}'Diagnostics
taskify board list # boards with IDs
taskify relay status # check relay connectivity
taskify cache clear # wipe local cache (forces cold re-fetch on next list)Reference
- Full command flags: see references/commands.md
- Board and column operations: see references/boards.md