From 51db3c37a42d973d171213cf3321f83d43993577 Mon Sep 17 00:00:00 2001
From: KinomotoMio <200703522+KinomotoMio@users.noreply.github.com>
Date: Sun, 24 May 2026 06:31:18 +0800
Subject: [PATCH] feat(project): add --label flag to project create and update

---
 skills/linear-cli/references/project.md       |   4 +-
 src/commands/project/project-create.ts        |  54 +++++++-
 src/commands/project/project-update.ts        |  19 ++-
 src/utils/linear.ts                           | 124 +++++++++++++++++-
 .../__snapshots__/project-create.test.ts.snap |  17 +++
 .../__snapshots__/project-update.test.ts.snap |  10 ++
 test/commands/project/project-create.test.ts  | 103 +++++++++++++++
 test/commands/project/project-update.test.ts  | 100 ++++++++++++++
 8 files changed, 426 insertions(+), 5 deletions(-)

diff --git a/skills/linear-cli/references/project.md b/skills/linear-cli/references/project.md
index 8f338839..692657a5 100644
--- a/skills/linear-cli/references/project.md
+++ b/skills/linear-cli/references/project.md
@@ -92,6 +92,7 @@ Options:
   --start-date       <startDate>    - Start date (YYYY-MM-DD)                                                  
   --target-date      <targetDate>   - Target completion date (YYYY-MM-DD)                                      
   --initiative       <initiative>   - Add to initiative immediately (ID, slug, or name)                        
+  --label            <label>        - Project label associated with the project. May be repeated.              
   -i, --interactive                 - Interactive mode (default if no flags provided)                          
   -j, --json                        - Output created project as JSON
 ```
@@ -117,7 +118,8 @@ Options:
   -l, --lead         <lead>         - Project lead (username, email, or @me)                           
   --start-date       <startDate>    - Start date (YYYY-MM-DD)                                          
   --target-date      <targetDate>   - Target date (YYYY-MM-DD)                                         
-  -t, --team         <team>         - Team key (can be repeated for multiple teams)
+  -t, --team         <team>         - Team key (can be repeated for multiple teams)                    
+  --label            <label>        - Project label associated with the project. May be repeated.
 ```
 
 ### delete
diff --git a/src/commands/project/project-create.ts b/src/commands/project/project-create.ts
index 5d326f23..f03f25b9 100644
--- a/src/commands/project/project-create.ts
+++ b/src/commands/project/project-create.ts
@@ -1,12 +1,14 @@
 import { Command } from "@cliffy/command"
-import { Input, Select } from "@cliffy/prompt"
+import { Checkbox, Input, Select } from "@cliffy/prompt"
 import { gql } from "../../__codegen__/gql.ts"
 import { getGraphQLClient } from "../../utils/graphql.ts"
 import {
   getAllTeams,
+  getProjectLabels,
   getTeamIdByKey,
   getTeamKey,
   lookupUserId,
+  resolveProjectLabelIds,
 } from "../../utils/linear.ts"
 import { shouldShowSpinner } from "../../utils/hyperlink.ts"
 import {
@@ -50,6 +52,8 @@ const AddProjectToInitiative = gql(`
   }
 `)
 
+const CREATE_PROJECT_LABEL_OPTION = "__create_project_label__"
+
 async function resolveInitiativeId(
   // deno-lint-ignore no-explicit-any
   client: any,
@@ -136,6 +140,11 @@ export const createCommand = new Command()
     "--initiative <initiative:string>",
     "Add to initiative immediately (ID, slug, or name)",
   )
+  .option(
+    "--label <label:string>",
+    "Project label associated with the project. May be repeated.",
+    { collect: true },
+  )
   .option(
     "-i, --interactive",
     "Interactive mode (default if no flags provided)",
@@ -152,6 +161,7 @@ export const createCommand = new Command()
         startDate: providedStartDate,
         targetDate: providedTargetDate,
         initiative: providedInitiative,
+        label: providedLabels,
         interactive: interactiveFlag,
         json: jsonOutput,
       } = options
@@ -166,6 +176,8 @@ export const createCommand = new Command()
       let status = providedStatus
       let startDate = providedStartDate
       let targetDate = providedTargetDate
+      let labels = providedLabels || []
+      let labelIds: string[] = []
 
       // Determine if we should run in interactive mode
       const noFlagsProvided = !name && teams.length === 0
@@ -265,6 +277,40 @@ export const createCommand = new Command()
           })
           if (!targetDate) targetDate = undefined
         }
+
+        if (labels.length === 0) {
+          const projectLabels = await getProjectLabels()
+          const selectedLabelIds = await Checkbox.prompt({
+            message:
+              "Select project labels (use space to select, enter to confirm)",
+            search: projectLabels.length > 0,
+            searchLabel: "Search project labels",
+            options: [
+              ...projectLabels.map((label) => ({
+                name: label.name,
+                value: label.id,
+              })),
+              {
+                name: "Create new project label",
+                value: CREATE_PROJECT_LABEL_OPTION,
+              },
+            ],
+          })
+
+          labelIds = selectedLabelIds.filter((id) =>
+            id !== CREATE_PROJECT_LABEL_OPTION
+          )
+
+          if (selectedLabelIds.includes(CREATE_PROJECT_LABEL_OPTION)) {
+            const newLabels = await Input.prompt({
+              message:
+                "New project label names (comma-separated - press Enter to skip):",
+            })
+            labels = newLabels.split(",").map((label) => label.trim()).filter(
+              Boolean,
+            )
+          }
+        }
       }
 
       // Validate required fields
@@ -346,6 +392,11 @@ export const createCommand = new Command()
         throw new ValidationError("Target date must be in YYYY-MM-DD format")
       }
 
+      if (labels.length > 0) {
+        labelIds.push(...await resolveProjectLabelIds(labels))
+      }
+      labelIds = [...new Set(labelIds)]
+
       const input = {
         name,
         teamIds,
@@ -354,6 +405,7 @@ export const createCommand = new Command()
         ...(statusId && { statusId }),
         ...(startDate && { startDate }),
         ...(targetDate && { targetDate }),
+        ...(labelIds.length > 0 && { labelIds }),
       }
 
       const { Spinner } = await import("@std/cli/unstable-spinner")
diff --git a/src/commands/project/project-update.ts b/src/commands/project/project-update.ts
index 52b33a60..4333e094 100644
--- a/src/commands/project/project-update.ts
+++ b/src/commands/project/project-update.ts
@@ -2,9 +2,11 @@ import { Command } from "@cliffy/command"
 import { gql } from "../../__codegen__/gql.ts"
 import { getGraphQLClient } from "../../utils/graphql.ts"
 import {
+  getProjectLabelIdsForProject,
   getTeamIdByKey,
   lookupUserId,
   resolveProjectId,
+  resolveProjectLabelIds,
 } from "../../utils/linear.ts"
 import { shouldShowSpinner } from "../../utils/hyperlink.ts"
 import {
@@ -70,6 +72,11 @@ export const updateCommand = new Command()
     "Team key (can be repeated for multiple teams)",
     { collect: true },
   )
+  .option(
+    "--label <label:string>",
+    "Project label associated with the project. May be repeated.",
+    { collect: true },
+  )
   .action(
     async (
       {
@@ -80,6 +87,7 @@ export const updateCommand = new Command()
         startDate,
         targetDate,
         team: teams,
+        label: labels,
       },
       projectId,
     ) => {
@@ -90,13 +98,14 @@ export const updateCommand = new Command()
       try {
         if (
           !name && description == null && !status && !lead &&
-          !startDate && !targetDate && (!teams || teams.length === 0)
+          !startDate && !targetDate && (!teams || teams.length === 0) &&
+          (!labels || labels.length === 0)
         ) {
           throw new ValidationError(
             "At least one update option must be provided",
             {
               suggestion:
-                "Use --name, --description, --status, --lead, --start-date, --target-date, or --team",
+                "Use --name, --description, --status, --lead, --start-date, --target-date, --team, or --label",
             },
           )
         }
@@ -164,6 +173,12 @@ export const updateCommand = new Command()
           input.teamIds = teamIds
         }
 
+        if (labels && labels.length > 0) {
+          const currentLabelIds = await getProjectLabelIdsForProject(resolvedId)
+          const newLabelIds = await resolveProjectLabelIds(labels)
+          input.labelIds = [...new Set([...currentLabelIds, ...newLabelIds])]
+        }
+
         const result = await client.request(UpdateProject, {
           id: resolvedId,
           input,
diff --git a/src/utils/linear.ts b/src/utils/linear.ts
index bfdd2a78..6166d380 100644
--- a/src/utils/linear.ts
+++ b/src/utils/linear.ts
@@ -1,11 +1,14 @@
 import { gql } from "../__codegen__/gql.ts"
 import type {
+  CreateProjectLabelMutation,
   GetAllTeamsQuery,
   GetAllTeamsQueryVariables as _GetAllTeamsQueryVariables,
   GetIssueDetailsQuery,
   GetIssueDetailsWithCommentsQuery,
   GetIssuesForQueryQuery,
   GetIssuesForStateQuery,
+  GetProjectLabelIdsForProjectQuery,
+  GetProjectLabelsQuery,
   GetTeamMembersQuery,
   IssueFilter,
   IssueSortInput,
@@ -14,7 +17,7 @@ import type {
 } from "../__codegen__/graphql.ts"
 import { Select } from "@cliffy/prompt"
 import { getOption } from "../config.ts"
-import { NotFoundError, ValidationError } from "./errors.ts"
+import { CliError, NotFoundError, ValidationError } from "./errors.ts"
 import { getGraphQLClient } from "./graphql.ts"
 import { normalizeIssueIdentifier } from "./issue-identifier.ts"
 import { getCurrentIssueFromVcs } from "./vcs.ts"
@@ -1435,6 +1438,125 @@ export async function getIssueLabelOptionsByNameForTeam(
   return Object.fromEntries(sortedResults.map((t) => [t.id, t.name]))
 }
 
+export type ProjectLabel = { id: string; name: string; color: string }
+
+export async function getProjectLabels(): Promise<ProjectLabel[]> {
+  const client = getGraphQLClient()
+  const query = gql(/* GraphQL */ `
+    query GetProjectLabels($first: Int, $after: String) {
+      projectLabels(
+        first: $first
+        after: $after
+        filter: { isGroup: { eq: false } }
+      ) {
+        nodes {
+          id
+          name
+          color
+        }
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
+      }
+    }
+  `)
+
+  const allLabels: ProjectLabel[] = []
+  let hasNextPage = true
+  let after: string | null | undefined = undefined
+
+  while (hasNextPage) {
+    const result: GetProjectLabelsQuery = await client.request(query, {
+      first: 100,
+      after,
+    })
+    allLabels.push(...result.projectLabels.nodes)
+    hasNextPage = result.projectLabels.pageInfo.hasNextPage
+    after = result.projectLabels.pageInfo.endCursor
+  }
+
+  return allLabels.sort((a, b) =>
+    a.name.toLowerCase().localeCompare(b.name.toLowerCase())
+  )
+}
+
+export async function resolveProjectLabelIds(
+  labelNames: string[],
+): Promise<string[]> {
+  const client = getGraphQLClient()
+  const createMutation = gql(/* GraphQL */ `
+    mutation CreateProjectLabel($input: ProjectLabelCreateInput!) {
+      projectLabelCreate(input: $input) {
+        success
+        projectLabel {
+          id
+          name
+          color
+        }
+      }
+    }
+  `)
+
+  const labels = await getProjectLabels()
+  const labelIds: string[] = []
+  const seenNames = new Set<string>()
+
+  for (const rawName of labelNames) {
+    const name = rawName.trim()
+    if (!name) continue
+
+    const normalizedName = name.toLowerCase()
+    if (seenNames.has(normalizedName)) continue
+    seenNames.add(normalizedName)
+
+    const existingLabel = labels.find((label) =>
+      label.name.toLowerCase() === normalizedName
+    )
+    if (existingLabel) {
+      labelIds.push(existingLabel.id)
+      continue
+    }
+
+    const result: CreateProjectLabelMutation = await client.request(
+      createMutation,
+      {
+        input: { name, isGroup: false },
+      },
+    )
+    if (!result.projectLabelCreate.success) {
+      throw new CliError(`Failed to create project label: ${name}`)
+    }
+
+    const createdLabel = result.projectLabelCreate.projectLabel
+    labels.push(createdLabel)
+    labelIds.push(createdLabel.id)
+  }
+
+  return labelIds
+}
+
+export async function getProjectLabelIdsForProject(
+  projectId: string,
+): Promise<string[]> {
+  const client = getGraphQLClient()
+  const query = gql(/* GraphQL */ `
+    query GetProjectLabelIdsForProject($id: String!) {
+      project(id: $id) {
+        labelIds
+      }
+    }
+  `)
+
+  const result: GetProjectLabelIdsForProjectQuery = await client.request(
+    query,
+    {
+      id: projectId,
+    },
+  )
+  return [...result.project.labelIds]
+}
+
 export async function getAllTeams(): Promise<
   Array<{ id: string; key: string; name: string }>
 > {
diff --git a/test/commands/project/__snapshots__/project-create.test.ts.snap b/test/commands/project/__snapshots__/project-create.test.ts.snap
index 59b0c524..a8059a2a 100644
--- a/test/commands/project/__snapshots__/project-create.test.ts.snap
+++ b/test/commands/project/__snapshots__/project-create.test.ts.snap
@@ -20,6 +20,7 @@ Options:
   --start-date       <startDate>    - Start date (YYYY-MM-DD)                                                  
   --target-date      <targetDate>   - Target completion date (YYYY-MM-DD)                                      
   --initiative       <initiative>   - Add to initiative immediately (ID, slug, or name)                        
+  --label            <label>        - Project label associated with the project. May be repeated.              
   -i, --interactive                 - Interactive mode (default if no flags provided)                          
   -j, --json                        - Output created project as JSON                                           
 
@@ -43,3 +44,19 @@ stdout:
 stderr:
 ""
 `;
+
+snapshot[`Project Create Command - With Labels 1`] = `
+stdout:
+'{
+  "success": true,
+  "project": {
+    "id": "550e8400-e29b-41d4-a716-446655440010",
+    "slugId": "project-with-labels",
+    "name": "Project With Labels",
+    "url": "https://linear.app/test/project/project-with-labels"
+  }
+}
+'
+stderr:
+""
+`;
diff --git a/test/commands/project/__snapshots__/project-update.test.ts.snap b/test/commands/project/__snapshots__/project-update.test.ts.snap
index 291fa90b..67c9c731 100644
--- a/test/commands/project/__snapshots__/project-update.test.ts.snap
+++ b/test/commands/project/__snapshots__/project-update.test.ts.snap
@@ -19,6 +19,7 @@ Options:
   --start-date       <startDate>    - Start date (YYYY-MM-DD)                                          
   --target-date      <targetDate>   - Target date (YYYY-MM-DD)                                         
   -t, --team         <team>         - Team key (can be repeated for multiple teams)                    
+  --label            <label>        - Project label associated with the project. May be repeated.      
 
 "
 stderr:
@@ -51,3 +52,12 @@ https://linear.app/test/project/proj-status
 stderr:
 ""
 `;
+
+snapshot[`Project Update Command - Add Labels 1`] = `
+stdout:
+"✓ Updated project: Test Project
+https://linear.app/test/project/proj-labels
+"
+stderr:
+""
+`;
diff --git a/test/commands/project/project-create.test.ts b/test/commands/project/project-create.test.ts
index 73b1d895..a6af8ccb 100644
--- a/test/commands/project/project-create.test.ts
+++ b/test/commands/project/project-create.test.ts
@@ -72,3 +72,106 @@ await cliffySnapshotTest({
     }
   },
 })
+
+// Test project create with project labels
+await cliffySnapshotTest({
+  name: "Project Create Command - With Labels",
+  meta: import.meta,
+  colors: false,
+  args: [
+    "--name",
+    "Project With Labels",
+    "--team",
+    "ENG",
+    "--label",
+    "backend",
+    "--label",
+    "frontend",
+    "--json",
+  ],
+  denoArgs: commonDenoArgs,
+  async fn() {
+    const server = new MockLinearServer([
+      {
+        queryName: "GetTeamIdByKey",
+        variables: { team: "ENG" },
+        response: {
+          data: {
+            teams: {
+              nodes: [{ id: "team-eng-123" }],
+            },
+          },
+        },
+      },
+      {
+        queryName: "GetProjectLabels",
+        response: {
+          data: {
+            projectLabels: {
+              nodes: [
+                { id: "label-backend", name: "Backend", color: "#5e6ad2" },
+              ],
+              pageInfo: {
+                hasNextPage: false,
+                endCursor: null,
+              },
+            },
+          },
+        },
+      },
+      {
+        queryName: "CreateProjectLabel",
+        variables: {
+          input: { name: "frontend", isGroup: false },
+        },
+        response: {
+          data: {
+            projectLabelCreate: {
+              success: true,
+              projectLabel: {
+                id: "label-frontend",
+                name: "frontend",
+                color: "#26b5ce",
+              },
+            },
+          },
+        },
+      },
+      {
+        queryName: "CreateProject",
+        variables: {
+          input: {
+            name: "Project With Labels",
+            teamIds: ["team-eng-123"],
+            labelIds: ["label-backend", "label-frontend"],
+          },
+        },
+        response: {
+          data: {
+            projectCreate: {
+              success: true,
+              project: {
+                id: "550e8400-e29b-41d4-a716-446655440010",
+                slugId: "project-with-labels",
+                name: "Project With Labels",
+                url: "https://linear.app/test/project/project-with-labels",
+              },
+            },
+          },
+        },
+      },
+    ])
+
+    try {
+      await server.start()
+      Deno.env.set("LINEAR_GRAPHQL_ENDPOINT", server.getEndpoint())
+      Deno.env.set("LINEAR_API_KEY", "Bearer test-token")
+
+      await createCommand.parse()
+    } finally {
+      await server.stop()
+      Deno.env.delete("LINEAR_GRAPHQL_ENDPOINT")
+      Deno.env.delete("LINEAR_API_KEY")
+    }
+  },
+})
diff --git a/test/commands/project/project-update.test.ts b/test/commands/project/project-update.test.ts
index d23a74de..2149913d 100644
--- a/test/commands/project/project-update.test.ts
+++ b/test/commands/project/project-update.test.ts
@@ -171,3 +171,103 @@ await cliffySnapshotTest({
     }
   },
 })
+
+// Test project update - labels are additive
+await cliffySnapshotTest({
+  name: "Project Update Command - Add Labels",
+  meta: import.meta,
+  colors: false,
+  args: [
+    "550e8400-e29b-41d4-a716-446655440003",
+    "--label",
+    "backend",
+    "--label",
+    "security",
+  ],
+  denoArgs: commonDenoArgs,
+  async fn() {
+    const server = new MockLinearServer([
+      {
+        queryName: "GetProjectLabelIdsForProject",
+        variables: { id: "550e8400-e29b-41d4-a716-446655440003" },
+        response: {
+          data: {
+            project: {
+              labelIds: ["label-existing", "label-backend"],
+            },
+          },
+        },
+      },
+      {
+        queryName: "GetProjectLabels",
+        response: {
+          data: {
+            projectLabels: {
+              nodes: [
+                { id: "label-backend", name: "Backend", color: "#5e6ad2" },
+              ],
+              pageInfo: {
+                hasNextPage: false,
+                endCursor: null,
+              },
+            },
+          },
+        },
+      },
+      {
+        queryName: "CreateProjectLabel",
+        variables: {
+          input: { name: "security", isGroup: false },
+        },
+        response: {
+          data: {
+            projectLabelCreate: {
+              success: true,
+              projectLabel: {
+                id: "label-security",
+                name: "security",
+                color: "#eb5757",
+              },
+            },
+          },
+        },
+      },
+      {
+        queryName: "UpdateProject",
+        variables: {
+          id: "550e8400-e29b-41d4-a716-446655440003",
+          input: {
+            labelIds: ["label-existing", "label-backend", "label-security"],
+          },
+        },
+        response: {
+          data: {
+            projectUpdate: {
+              success: true,
+              project: {
+                id: "550e8400-e29b-41d4-a716-446655440003",
+                slugId: "proj-labels",
+                name: "Test Project",
+                description: null,
+                url: "https://linear.app/test/project/proj-labels",
+                updatedAt: "2024-01-20T15:30:00Z",
+              },
+            },
+          },
+        },
+      },
+    ])
+
+    try {
+      await server.start()
+      Deno.env.set("LINEAR_GRAPHQL_ENDPOINT", server.getEndpoint())
+      Deno.env.set("LINEAR_API_KEY", "Bearer test-token")
+
+      await updateCommand.parse()
+    } finally {
+      await server.stop()
+      Deno.env.delete("LINEAR_GRAPHQL_ENDPOINT")
+      Deno.env.delete("LINEAR_API_KEY")
+    }
+  },
+})