Edit Issues

Update any field on an existing issue — from the CLI, the web board, or through MCP.

From the CLI

Update any field with flags:

xpo update <id> --desc "Updated description with new findings"
xpo update <id> --label bug
xpo update <id> --assignee "Bob <bob@example.com>"

Open the issue in your editor for interactive editing:

xpo update <id>

This opens $EDITOR (or the editor configured in config.yaml) with the issue's current content. Save and close to apply changes.

From JSON

Patch multiple fields at once:

echo '{"description": "...", "labels": ["bug", "urgent"]}' | xpo update <id> --json

labels and links replace the whole list. The result is printed as JSON — see Scripting with JSON.

Clearing fields

Set assignee, cycle_id, priority, story_points or parent to null to clear it:

echo '{"assignee": null, "parent": null}' | xpo update <id> --json

null on description, labels or links means "unchanged". Clear those with "" or [].

Reordering

Move an issue directly above or below another in the manual order:

xpo update <id> --after myapp-a1b2c3

An issue already in place is left alone ("… is already after …").

From the web board

Click any issue in the board to open its detail panel. Edit the title, description, and properties inline. Changes save automatically as you make them.

To change an issue without opening it, right-click it in the Issues view or on the Board. The context menu sets status, priority, assignee, labels, estimate and cycle, each with a one-letter shortcut.

Context menu

Viewing issue details

xpo show <id>

Shows the full issue with description, properties, dependencies, and comments.