Issues

The issues command group provides five subcommands for working with issues: list, view, create, start, and done.

loop issues list

List issues with optional filters and pagination.

loop issues list [options]

Options

Flag	Description	Default
`--status <status>`	Filter by status (`triage`, `todo`, `backlog`, `in_progress`, `done`, `canceled`)	all
`--type <type>`	Filter by issue type (`signal`, `hypothesis`, `plan`, `task`, `monitor`)	all
`--project <id>`	Filter by project ID	none
`--priority <n>`	Filter by priority (0-4)	all
`--limit <n>`	Results per page	`50`
`--offset <n>`	Pagination offset	`0`

Examples

List all issues:

loop issues list

Filter by status:

loop issues list --status todo

Filter by type and project:

loop issues list --type task --project clx1abc2def3ghi4jkl5mnop

Output as JSON for scripting:

loop issues list --status in_progress --json | jq '.[].title'

Sample output

┌──────┬───────────┬──────────────────────────────┬─────────────┬────────┬──────────┐
│ #    │ TYPE      │ TITLE                        │ STATUS      │ PRI    │ CREATED  │
├──────┼───────────┼──────────────────────────────┼─────────────┼────────┼──────────┤
│ 42   │ task      │ Fix login timeout             │ todo        │ high   │ 2d ago   │
│ 41   │ signal    │ Error rate spike on checkout  │ triage      │ medium │ 3d ago   │
│ 40   │ plan      │ Migrate user service to v2    │ in_progress │ urgent │ 5d ago   │
└──────┴───────────┴──────────────────────────────┴─────────────┴────────┴──────────┘
Showing 3 of 3 issues

loop issues view

Show full detail for a single issue, including labels, relations, children, and agent results.

loop issues view <id>

Arguments

Argument	Description
`id`	Issue ID (CUID2)

Example

loop issues view clx1abc2def3ghi4jkl5mnop

Sample output

#42 [task] Fix login timeout
Status: todo   Priority: high   Project: clx9xyz...

Labels: bug, backend

Description:
  Login requests are timing out after 30s when the session cache is cold.

Parent: #38 [plan] Improve auth reliability

Children:
┌──────┬───────────┬────────────────────────┬────────┐
│ #    │ TYPE      │ TITLE                  │ STATUS │
├──────┼───────────┼────────────────────────┼────────┤
│ 43   │ task      │ Add cache warming      │ todo   │
│ 44   │ task      │ Increase timeout to 60s│ done   │
└──────┴───────────┴────────────────────────┴────────┘

Relations:
  blocks clx2bbb...
  relates to clx3ccc...

Agent:
  Summary: Fixed cache warming logic
  Commits: abc1234
  PRs: #47

loop issues create

Create a new issue. In a terminal (TTY), the CLI prompts interactively for type and priority if flags are not provided. In non-TTY environments, defaults are used.

loop issues create <title> [options]

Arguments

Argument	Description
`title`	Issue title (required)

Options

Flag	Default (non-TTY)	Description
`--type <type>`	`task`	Issue type (`signal`, `hypothesis`, `plan`, `task`, `monitor`)
`--priority <n>`	`3` (medium)	Priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)
`--project <id>`	none	Project ID
`--description <text>`	none	Issue description
`--parent <id>`	none	Parent issue ID

Examples

Create with all flags (scriptable):

loop issues create "Fix login timeout" \
  --type task \
  --priority 2 \
  --description "Login requests timing out after 30s" \
  --project clx1abc2def3ghi4jkl5mnop

Create interactively (terminal prompts for type, priority):

loop issues create "Investigate checkout error spike"

Create a child issue:

loop issues create "Add cache warming" --parent clx1abc2def3ghi4jkl5mnop

Sample output

Created #45 [task] Fix login timeout

loop issues start

Start working on an issue by setting its status to in_progress. Displays the issue details after transitioning.

loop issues start <id>

Arguments

Argument	Description
`id`	Issue ID (CUID2)

Example

loop issues start clx1abc2def3ghi4jkl5mnop

Sample output

Issue #42 is now in_progress
  Fix login timeout

Description:
  Login requests are timing out after 30s when the session cache is cold.

loop issues done

Mark an issue as complete, optionally adding an outcome comment.

loop issues done <id> [options]

Arguments

Argument	Description
`id`	Issue ID (CUID2)

Options

Flag	Description
`--outcome <text>`	Outcome description (saved as a comment)

Examples

Mark as done:

loop issues done clx1abc2def3ghi4jkl5mnop

Mark as done with an outcome:

loop issues done clx1abc2def3ghi4jkl5mnop --outcome "Fixed in PR #47. Cache warming reduces timeout to <500ms."

Sample output

Issue #42 marked as done
  Outcome: Fixed in PR #47. Cache warming reduces timeout to <500ms.

Issues

On this page