linLinear CLI
Commands

lin cycle

Inspect and manage cycles

Inspect and manage cycles

lin cycle archive

Archive a cycle

lin cycle archive <id>
FlagTypeDefaultDescription
--dry-run, -nboolfalseprint the intended operation and variables without executing

lin cycle create

Create a cycle

lin cycle create

Example

lin cycle create --team ENG --starts-at 2026-07-21T00:00:00Z --ends-at 2026-08-04T00:00:00Z
FlagTypeDefaultDescription
--descriptionstring-cycle description
--dry-run, -nboolfalseprint the intended operation and variables without executing
--ends-atstring-end timestamp (RFC3339)
--jsonstring-raw GraphQL input payload as JSON ('-' reads stdin); exclusive with per-field flags
--namestring-cycle name
--starts-atstring-start timestamp (RFC3339)
--team, -tstring-team key or UUID

lin cycle get

Show one cycle

lin cycle get <id>

lin cycle list

List cycles

lin cycle list

Example

lin cycle list --team ENG --active
FlagTypeDefaultDescription
--activeboolfalseonly the currently active cycle
--all, -aboolfalsefollow cursors until exhaustion
--cursorstring-resume from a previous next_cursor
--limit, -lint50page size
--team, -tstring-restrict to a team (key or UUID)

lin cycle shift-all

Shift this and all later cycles by a number of days

lin cycle shift-all
FlagTypeDefaultDescription
--daysfloat640days to shift (negative shifts earlier)
--dry-run, -nboolfalseprint the intended operation and variables without executing
--fromstring-cycle UUID to shift from (inclusive)

lin cycle start-upcoming

Start the upcoming cycle as of midnight today

lin cycle start-upcoming <id>
FlagTypeDefaultDescription
--dry-run, -nboolfalseprint the intended operation and variables without executing

lin cycle update

Update a cycle

lin cycle update <id>
FlagTypeDefaultDescription
--completed-atstring-completion timestamp (RFC3339)
--descriptionstring-cycle description
--dry-run, -nboolfalseprint the intended operation and variables without executing
--ends-atstring-end timestamp (RFC3339)
--jsonstring-raw GraphQL input payload as JSON ('-' reads stdin); exclusive with per-field flags
--namestring-cycle name
--starts-atstring-start timestamp (RFC3339)

lin customer

Create, inspect and manage customers

lin describe

Emit the command surface as JSON so agents introspect instead of parsing --help

On this page

lin cycle archivelin cycle createlin cycle getlin cycle listlin cycle shift-alllin cycle start-upcominglin cycle update