Create, track, and manage issues directly from your terminal with Linear-style project management features including priorities, due dates, estimates, sub-issues, and triage workflows.
Overview
The wit issue command provides comprehensive issue management from the CLI, inspired by Linear’s workflow.
Basic Commands
create
Create a new issue.
Options
Examples
list
List issues with powerful filtering.
Options
Examples
view
View detailed information about an issue.
Example Output
close / reopen
Close or reopen an issue.
Add a comment to an issue.
Priority & Estimates
priority
Set the priority of an issue.
Valid priorities: urgent, high, medium, low, none
due
Set or clear the due date for an issue.
Supported date formats:
- ISO format:
2024-12-31
- Relative:
today, tomorrow, next week
- Shorthand:
+3d (3 days), +2w (2 weeks)
estimate
Set the estimate (story points) for an issue.
Hierarchy (Sub-issues)
parent
Set or remove the parent of an issue to create hierarchies.
subs
List sub-issues of an issue.
Example Output
sub
Create a new sub-issue under a parent.
Relations
block / unblock
Mark issues as blocking other issues.
relate / unrelate
Mark issues as related to each other.
duplicate
Mark an issue as a duplicate of another (closes the duplicate).
Triage Workflow
triage
List issues in the triage queue awaiting review.
Example Output
accept
Accept a triage item and move it to the backlog.
Options
reject
Reject a triage item and close it with a reason.
Activity
activity
View the activity log for an issue or the entire repository.
Workflow Example
A complete issue workflow:
Integration with Projects & Cycles
Issues integrate with wit’s project management features:
Use wit issue list --triage regularly to keep your triage queue clean and prioritize incoming issues.