linLinear CLI
Commands

lin project

Create, inspect and manage projects

Create, inspect and manage projects

lin project add-label

add-label one label on a project without touching the rest of the set

lin project add-label <name|id>
FlagTypeDefaultDescription
--dry-run, -nboolfalseprint the intended operation and variables without executing
--labelstring-project label name or UUID

lin project archive

Archive a project

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

lin project create

Create a project

lin project create

Example

lin project create --name "Mobile app v2" --teams ENG --lead me
FlagTypeDefaultDescription
--body-filestring-read the text from a file ('-' reads stdin)
--descriptionstring-project description (markdown)
--dry-run, -nboolfalseprint the intended operation and variables without executing
--jsonstring-raw GraphQL input payload as JSON ('-' reads stdin); exclusive with per-field flags
--leadstring-project lead: email, UUID or "me"
--namestring-project name
--start-datestring-start date (YYYY-MM-DD)
--statusstring-project status UUID
--target-datestring-target date (YYYY-MM-DD)
--teamsstringSlice[]team keys or UUIDs (comma list)

lin project delete

Move a project to trash (requires --confirm)

lin project delete <name|id>
FlagTypeDefaultDescription
--confirmstring-confirm the destructive action by repeating the resource id
--dry-run, -nboolfalseprint the intended operation and variables without executing

lin project get

Show one project (includes lead and milestones)

lin project get <name|id>

Example

lin project get "Mobile app v2"

lin project list

List projects

lin project list
FlagTypeDefaultDescription
--all, -aboolfalsefollow cursors until exhaustion
--cursorstring-resume from a previous next_cursor
--include-archivedboolfalseinclude archived projects
--limit, -lint50page size
--statestring-filter by state: planned, started, paused, completed, canceled
--team, -tstring-filter by team key or UUID

lin project relation add

Relate two projects

lin project relation add

Example

lin project relation add --project "App v2" --related-project "Platform" --type dependsOn
FlagTypeDefaultDescription
--anchor-typestringprojectsource anchor: project or projectMilestone
--dry-run, -nboolfalseprint the intended operation and variables without executing
--projectstring-source project name or UUID
--related-anchor-typestringprojecttarget anchor: project or projectMilestone
--related-projectstring-target project name or UUID
--typestring-relation type (e.g. dependsOn, blocks)

lin project relation remove

Remove a project relation

lin project relation remove <relation-id>
FlagTypeDefaultDescription
--dry-run, -nboolfalseprint the intended operation and variables without executing

lin project relation update

Update a project relation's type

lin project relation update <relation-id>
FlagTypeDefaultDescription
--dry-run, -nboolfalseprint the intended operation and variables without executing
--typestring-relation type (e.g. dependsOn, blocks)

lin project remove-label

remove-label one label on a project without touching the rest of the set

lin project remove-label <name|id>
FlagTypeDefaultDescription
--dry-run, -nboolfalseprint the intended operation and variables without executing
--labelstring-project label name or UUID

lin project unarchive

Unarchive a project

lin project unarchive <name|id>
FlagTypeDefaultDescription
--dry-run, -nboolfalseprint the intended operation and variables without executing

lin project update

Update a project

lin project update <name|id>
FlagTypeDefaultDescription
--body-filestring-read the text from a file ('-' reads stdin)
--descriptionstring-project description (markdown)
--dry-run, -nboolfalseprint the intended operation and variables without executing
--jsonstring-raw GraphQL input payload as JSON ('-' reads stdin); exclusive with per-field flags
--leadstring-project lead: email, UUID or "me"
--namestring-project name
--start-datestring-start date (YYYY-MM-DD)
--statusstring-project status UUID
--target-datestring-target date (YYYY-MM-DD)
--teamsstringSlice[]team keys or UUIDs (comma list)

On this page