CLI Task Assignment

Assign users and agents to tasks, clear assignments, and manage workspace leases from the command line.

Assign a task

hypertask tasks assign

Assign a person or multiple people to tasks. Use the numeric list id that tasks list returns to operate on a specific task, or the --all flag to assign to an entire board.

hypertask tasks assign <ticket_number> --assignee <user-id>

hypertask tasks assign --project <board> --assignee <user-id> --all

Behavior:

• Adds the specified assignee to one or more tasks.
• When using --all, the assignee is added to every task on the board.

Examples:

Assign one person to a specific task listed from tasks list:

hypertask tasks assign 40451 --assignee valentin

Assign a person to the entire board:

hypertask tasks assign --project 15 --assignee valentin@team.com --all

Note

Re-assigning the same user returns already-assigned without creating a duplicate assignment row.

Clear all assignments

Empty assignee

Clear a task's assignees by passing an empty string to --assignee.

Behavior:

• Removes every assignee from the specified task.
• Works with --all to clear all assignments from a board.
• Previously rejected as malformed input; now walks the existing unassign path.

Examples:

Clear a task's assignees:

hypertask task update 40451 --field "assignee" --value ""

Clear all assignments on a board:

hypertask tasks assign --project 15 --assignee "" --all

Related: --clear-assignees (see below).

--clear-assignees flag

Clear a task's assignees using a explicit flag.

hypertask task update <ticket> --clear-assignees

Behavior:

• Removes all assignees from the ticket.
• Useful when you want to explicitly signal an unassignment.
• Performs the same operation as passing empty --assignee.

Note

Shipped support for empty --assignee and --clear-assignees to clear all assignees on a task or board.

Agent details

hypertask agents get

Show details for a specific agent.

hypertask agents get --id <agent-id>

Behavior:

• Prints the agent's mission text, boards, creation time, and revoked state.
• Returns an error if no matching agent is found.
• Requires authentication.

Note

Fixed the UnknownCommand error for hypertask agents get --id, allowing you to retrieve agent details from the CLI.

Task claims

The released CLI does not expose a workspace-lease command. Use hypertask agent take <ticket> to claim an agent task; see the generated commands for the released command surface.