Skip to content

Add command to list workflow states for a team #210

@schpet

Description

@schpet

Problem

When using linear issue update --state, there's no way to discover valid workflow state names for a team without resorting to a raw GraphQL query:

linear api '{ team(id: "XX") { states { nodes { name type position } } } }'

This makes it hard to use --state correctly, especially since state names vary across teams and workspaces. Failed attempts just show Workflow state not found: 'X' for team XX with no guidance on valid options.

Proposed Solution

Add a team states (or team workflows) subcommand:

linear team states [teamKey]

Output could look something like:

Name                  Type
Backlog               backlog
Ready                 unstarted
In Progress           started
Done                  completed
Canceled              canceled

Alternatives Considered

  • The GraphQL API works but is cumbersome for a common need
  • Tab completion could help but doesn't cover all use cases (e.g. scripting, unfamiliar workspaces)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions