@dypt/cli

Command-line interface for dypt.

Install

npm install -g @dypt/cli

Requirements

• Node ^22.20.0 or ^24.14.0
• a dypt account with CLI access enabled
• network access to https://dypt.app

Basic usage

Sign in

Authenticate the CLI with your dypt account:

dypt auth login
dypt auth status

List tasks

See tasks from your account:

dypt task list
dypt task list --limit 10

Create a task

Create a new task:

dypt task create "Follow up with customers"
dypt task create "Write release notes" --parent Work
dypt task create "Prepare launch" --note "## Context\n\nCoordinate the release."
dypt task create "Prepare launch" --deadline 2026-08-01T09:00:00Z --reminder at-deadline --reminder 1d

Use --note <markdown> to create the task and its initial note atomically. If the note cannot be stored, the task is not created. Repeat --reminder <timing> up to three times to configure reminders alongside a deadline. The task, note, and reminders are stored atomically; if any part fails, none of them are created.

Inspect a task

View a task and its details:

dypt task get 123
dypt task get 123 --json

Update a task

Change status, priority, due date, archive state, or parent:

dypt task update 123 --status "in progress"
dypt task update 123 --priority high
dypt task update 123 --deadline 2026-05-01T09:00:00Z
dypt task update 123 --parent Work
dypt task update 123 --parent root --preview
dypt task update 123 --position 0
dypt task update 123 --archive

Reorder tasks

Set visible sibling order from an explicit task list. Preview first for safe bulk changes:

dypt task reorder 71595 71594 71598 --preview
dypt task reorder 71595 71594 71598
dypt task reorder 71595 71594 71598 --parent Work

Dependencies and blockers are not changed by reordering; use dypt dep commands for execution dependencies.

Manage reminders

Configure up to three reminders relative to a task's deadline:

dypt task create "Prepare launch" --deadline 2026-08-01T09:00:00Z --reminder at-deadline --reminder 1d
dypt reminder add 123 at-deadline 1d 1w
dypt reminder list 123
dypt reminder set 123 1h 1d
dypt reminder remove 123 456

add preserves existing reminders, while set atomically replaces all configured reminders. remove takes the reminder id shown by reminder list; it does not delete or otherwise change the task.

Supported timing tokens are:

| Token | Timing | | ------------- | ----------------- | | at-deadline | at the deadline | | 15m | 15 minutes before | | 30m | 30 minutes before | | 1h | 1 hour before | | 2h | 2 hours before | | 3h | 3 hours before | | 12h | 12 hours before | | 1d | 1 day before | | 1w | 1 week before |

The task must have a deadline before reminders can be added or replaced. The same applies to create-time --reminder options. Duplicate timings and collections larger than three are rejected. Add --json to any reminder command for structured task, deadline, reminder id, timing, scheduled time, and sent-state output:

dypt reminder list 123 --json
dypt reminder add 123 1d --json

JSON output

Most commands support --json for agent and automation use.

dypt task list --limit 10 --json
dypt task get 123 --json

Agent guidance

Install or inspect dypt agent guidance for supported AI coding tools:

dypt agent status
dypt agent install codex
dypt agent install claude

By default, dypt agent install installs the latest released dypt-cli skill from the public poyzer-tech/dypt-toolkit repository. It is safe to rerun: missing installs are created, managed unmodified installs are updated, and locally modified installs require an explicit --backup or --force.

For development or testing, install from a local toolkit checkout:

dypt agent install codex --source local --path /path/to/dypt-toolkit --dry-run

Print repo-level AGENTS.md / CLAUDE.md guidance, or append it explicitly:

dypt agent install-instructions
dypt agent install-instructions --append AGENTS.md

Support policy

• the CLI is currently versioned as an early 0.x release, so command shape and output may still evolve
• the JSON output mode is intended for agent and automation use, but consumers should still expect additive changes over time during the 0.x period
• support for the published CLI is provided via dypt help and [email protected]

Support

If you need help using the CLI, visit dypt help or email [email protected].

License

This package is distributed under a custom proprietary license. See LICENSE.