@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

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.

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.