Skip to content

document update lacks --project flag (can't re-link or add project attachments via CLI) #225

Description

@jrschumacher

Version: linear 2.0.0

linear document create accepts --project <slug-or-uuid> to attach a Document to a project, but linear document update <id> has no --project flag. Once a Document is created, the CLI can't change or add its project attachment.

Why this matters

In Linear's data model, Documents are workspace-scoped and a single Document can be linked to multiple projects, initiatives, or issues at once (the web UI supports this directly). With the CLI, you can only set the initial attachment at create time. Re-linking, adding a second project link, or moving a Document to a new project requires the Linear web UI.

This was load-bearing during a Linear shape migration where ~16 epic projects were created and existing spec/plan Document mirrors needed to be linked to the new projects. The CLI couldn't do it programmatically; the mirrors stayed attached to their original issue anchors.

Suggested behavior

linear document update <id> --project F-FOO       # add F-FOO as a link target
linear document update <id> --project F-FOO --remove   # remove F-FOO link

Or a separate linear document link subcommand if mixing it into update muddies semantics.

Related

#127 mentions broader project-subcommand gaps; this is the Document side of the same surface area.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions