linear-sdk-cli 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -4,6 +4,23 @@ Release Please generates this file from Conventional Commits. Feature and fix pu
 not edit it directly; their squash-commit titles are the release-note source of truth. This project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.1](https://github.com/zhendalf/linear-sdk-cli/compare/v0.5.0...v0.5.1) (2026-09-06)
+
+### Bug Fixes
+
+- associate login with projects and make workspace defaults explicit ([#62](https://github.com/zhendalf/linear-sdk-cli/issues/62)) ([faf4028](https://github.com/zhendalf/linear-sdk-cli/commit/faf4028246a947dc13f674d75df2b1ba3c0ac0f3))
+- **comment:** accept create as an add alias ([#57](https://github.com/zhendalf/linear-sdk-cli/issues/57)) ([c8146b9](https://github.com/zhendalf/linear-sdk-cli/commit/c8146b98f60b68b5cc8bd2063fdd49cc9cc91216))
+- reduce label resolution requests and latency ([#64](https://github.com/zhendalf/linear-sdk-cli/issues/64)) ([d1300a5](https://github.com/zhendalf/linear-sdk-cli/commit/d1300a5379e99a466a6111e24fbcfa7b85f21c1f))
+
+## [0.5.0](https://github.com/zhendalf/linear-sdk-cli/compare/v0.4.0...v0.5.0) (2026-09-03)
+
+### Features
+
+- **config:** support per-workspace default teams ([#50](https://github.com/zhendalf/linear-sdk-cli/issues/50)) ([06be757](https://github.com/zhendalf/linear-sdk-cli/commit/06be757ddb81652dea4da32434e63de773cb6760)), closes [#44](https://github.com/zhendalf/linear-sdk-cli/issues/44)
+- **issue:** add native agent delegation ([#52](https://github.com/zhendalf/linear-sdk-cli/issues/52)) ([15055ff](https://github.com/zhendalf/linear-sdk-cli/commit/15055ff73d46f6ddf31679b7bb5f37fc6e3fddda)), closes [#45](https://github.com/zhendalf/linear-sdk-cli/issues/45)
+- **issue:** set labels by group ([#54](https://github.com/zhendalf/linear-sdk-cli/issues/54)) ([4c471cd](https://github.com/zhendalf/linear-sdk-cli/commit/4c471cd23c9409ba395cf43514f9e251a42ef4d6)), closes [#46](https://github.com/zhendalf/linear-sdk-cli/issues/46)
+- standardize archived-resource listing ([#53](https://github.com/zhendalf/linear-sdk-cli/issues/53)) ([735d1c8](https://github.com/zhendalf/linear-sdk-cli/commit/735d1c87894736de257b8888edb8500934e502f3)), closes [#49](https://github.com/zhendalf/linear-sdk-cli/issues/49)
+
 ## [0.4.0](https://github.com/zhendalf/linear-sdk-cli/compare/v0.3.3...v0.4.0) (2026-08-28)
 
 ### Features

package/COVERAGE.md

@@ -1,16 +1,20 @@
 # SDK Coverage Audit
 
-Generated by `bun run audit:coverage`. Total LinearClient members: **472**.
+Generated by `bun run audit:coverage`. Total LinearClient members: **473**.
 
 | Status   | Count | Meaning                                         |
 | -------- | ----- | ----------------------------------------------- |
 | curated  | 107   | Has a first-class CLI command                   |
 | raw-only | 142   | Reachable via `linear api` (no bespoke command) |
-| excluded | 223   | Out of scope (admin/integration/SDK plumbing)   |
+| excluded | 224   | Out of scope (admin/integration/SDK plumbing)   |
 
 Every member is classified — CI fails otherwise. `raw-only` members are still
 100% reachable through the raw GraphQL escape hatch; they simply lack a tailored command.
 
+## Curated field capabilities
+
+- Issue delegation (Developer Preview) — `Issue.delegate`, `IssueCreateInput.delegateId`, `IssueUpdateInput.delegateId`, and eligible agent-user fields are covered by `issue delegate` and the delegation options on `issue create`/`issue update`.
+
 ## Curated (107)
 
 - `agentSession` — issue
@@ -121,7 +125,7 @@ Every member is classified — CI fails otherwise. `raw-only` members are still
 - `workflowState` — state
 - `workflowStates` — state
 
-## Excluded (223)
+## Excluded (224)
 
 - `agentActivities` — specialized/raw api only
 - `agentActivity` — specialized/raw api only
@@ -306,6 +310,7 @@ Every member is classified — CI fails otherwise. `raw-only` members are still
 - `ssoUrlFromEmail` — auth/session flows (out of scope)
 - `suspendUser` — admin/enterprise (raw api only)
 - `template` — specialized/raw api only
+- `templateSearch` — specialized/raw api only
 - `templates` — specialized/raw api only
 - `templatesForIntegration` — integration/import (raw api only)
 - `timeSchedule` — specialized/raw api only

package/MIGRATING.md

@@ -124,6 +124,10 @@ Everything with no row is spelled identically.
 
 Passing both spellings at once (`--due` _and_ `--due-date`) is a usage error, not a coin flip.
 
+This CLI previously taught `initiative list --archived`. Its canonical spelling is now
+`--include-archived`, matching issue, project, and notification lists. The old spelling remains a
+compatibility alias throughout `0.x`; passing both spellings together is a usage error.
+
 **Short flags are the one place we did not follow.** schpet 2.5's own tree assigns `-a` four
 meanings (`--app`, `--all`, `--assignee`, `--attach`), `-f` four, `-y` three, `-t` two (`--title`
 and `--team`). There is no consistent target to copy. Ours holds **one meaning per letter across
@@ -154,6 +158,8 @@ Every one is now either identical, or says so on stderr, or is a usage error. Kn
    under `--quiet`) that deactivated users are still excluded and names `--include-disabled`, and
    `--help` says so up front. Not adopted: making `--all` mean "and deactivated" on two commands
    would give one global two meanings.
+   The same rule applies to lifecycle history: `--all` never includes archived records. Use
+   `--include-archived --all` to widen lifecycle visibility and exhaust pagination independently.
 5. **`-f <file>` on `project create/update`, `document create/update`** — theirs: `--description-file` /
    `--content-file`. Ours: `-f` is `--fields`, and it used to be _dropped_ on those commands, so
    `project create --name X -f desc.md` created the project with no description and exited 0.

package/README.md

@@ -64,7 +64,8 @@ retains their best ideas and provides a careful compatibility and migration path
 - **Git-aware** — the current issue is inferred from your branch (`tes-123-fix` → `TES-123`), so most issue commands let you drop the id.
 - **Git + GitHub workflow** — `issue start` checks out the branch and marks the issue started, `issue describe` prints a commit message with Linear-issue trailers, `issue pr` opens a GitHub PR — all linked back to the issue.
 - **Forgiving inputs** — refer to things the way you think of them: `TES-123`, team `TES`, `--assignee me`, `--cycle current`, state and label by name.
-- **Multi-workspace** — store credentials for several workspaces and switch with a global `--workspace`.
+- **Multi-workspace** — store credentials and a non-secret default team per workspace, then switch
+  both contexts with a global `--workspace`.
 - **Complete & honest** — first-class commands for the core resource graph, a raw `linear api` for everything else, and a [measured coverage audit](#coverage) that CI keeps honest.
 
 ## Install
@@ -230,20 +231,28 @@ linear auth login --workspace other-org    # …and another workspace
 linear auth login --workspace acme --key - # personal API-key fallback via stdin
 linear auth list                           # show configured workspaces + which is default
 linear auth default acme                   # choose the default workspace
+linear config set team ENG --user --workspace acme # set its validated default team
 linear --workspace other-org issue list    # use a specific workspace for one command
 linear auth logout --workspace acme        # revoke OAuth, then remove one credential
 ```
 
+Successful browser and API-key login also save `workspace = "<authenticated slug>"` in the discovered project config, preserving other settings and comments. If no config exists, login creates `.linear.toml` at the Git root (or cwd outside Git). Use `auth login --no-project` for credential-only login. Human output reports the association path; JSON includes `projectConfigPath` (null with `--no-project`). Credentials remain in the global credential store. Environment overrides still take precedence over this association.
+
+Global defaults are optional: login, credential adoption, and logout never choose a new one. Use `linear auth default <slug>` to explicitly select a global fallback. Removing that workspace clears its default without promoting another workspace. Existing defaults, including defaults imported from the reference CLI, are preserved on upgrade because older files cannot distinguish a user choice from an automatically assigned default. To opt out of a legacy default, remove the top-level `default_workspace` from the user config and, if present, `default` from the reference CLI's `credentials.toml`; retain the workspace entries.
+
 If revocation is intentionally unavailable, `auth logout --local-only` removes only local state.
 If browser login temporarily superseded an existing personal API-key profile for that workspace,
 OAuth logout preserves and reactivates the API key instead of deleting it.
 
 **Selection precedence** (strict): an explicit `--api-key` or `--access-token` flag bypasses the
-environment and workspace selection entirely. Otherwise `LINEAR_API_KEY` or
-`LINEAR_ACCESS_TOKEN` is absolute. With no invocation-scoped credential, the workspace is chosen
-by `--workspace` → `LINEAR_WORKSPACE` env → project config `workspace` → `default_workspace` in the
-user config. With one configured workspace it's used automatically; with several and no selection,
-the CLI asks you to pick (via `--workspace`, project config, or `auth default`).
+environment and stored-credential lookup. Otherwise `LINEAR_API_KEY` or `LINEAR_ACCESS_TOKEN` is
+absolute. With no invocation-scoped credential, the workspace is chosen by `--workspace` →
+`LINEAR_WORKSPACE` env → project config `workspace` → `default_workspace` in the user config. With
+one configured workspace it's used automatically; with several and no selection, interactive
+commands prompt for an invocation-only choice. Noninteractive and JSON commands fail clearly
+and explain how to select a workspace. Auth repair and discovery commands remain available. An invocation credential does not
+silently inherit the default or project profile's team; pair it with `--workspace` (or
+`LINEAR_WORKSPACE`) naming a configured profile when that profile metadata should apply.
 
 ## Core concepts
 
@@ -267,10 +276,76 @@ A few ideas run through every command:
 linear issue create --title "Fix login redirect" --team TES -P 2 --assignee me
 linear issue list --assignee me --state started
 linear issue update TES-42 --state "In Review" --add-label backend
+linear issue label TES-42 --set-group 'Team=QA'
+linear issue delegate TES-42 Codex
 linear issue comment TES-42 "ready for another look"
 linear issue archive TES-42 --yes
 ```
 
+**Agent delegation (Developer Preview)** — the assignee remains the human owner; the delegate is
+the agent working on their behalf. Create/update accept `--delegate <name|id>` and
+`--clear-delegate`; the focused command is convenient on a matching branch:
+
+```sh
+linear issue create --title "Investigate flaky CI" --assignee me --delegate Codex
+linear issue update TES-42 --delegate Codex
+linear issue update TES-42 --clear-delegate
+linear issue delegate TES-42 Codex
+linear issue delegate --clear                    # issue inferred from the branch
+linear issue delegate TES-42 Codex --dry-run --json
+linear issue delegate TES-42 Codex --full-result --json
+```
+
+Delegate resolution accepts an agent-user UUID, exact display name, or exact full name, preferring
+case-sensitive matches. It rejects human, inactive, non-assignable, ambiguous, and team-ineligible
+users before writing. `--dry-run` resolves every field and prints the exact nullable `delegateId`
+input without a mutation; `--full-result` (hidden alias `--read-back`) returns the relationship
+receipt plus the canonical issue read-back and verifies the resulting delegate. These modes are
+currently the delegation slice only: on `issue create`/`update`, pair them with `--delegate` or
+`--clear-delegate`.
+
+Delegating can trigger an externally observable Agent Session/webhook. Clearing a delegate does
+not claim to cancel a session that is already running. Linear for Agents is in Developer Preview;
+an unsupported workspace/schema returns `feature_not_accessible`, while ordinary `issue view`
+falls back safely and reports `delegate: null` if the preview field itself is unavailable.
+See Linear's current [agent integration guide](https://linear.app/developers/agents) and
+[issue-assignment guide](https://linear.app/docs/assigning-issues) for the platform semantics.
+
+**Label-group replacement** — replace only the selected group's direct member while preserving
+every unrelated issue label. Repeat `--set-group` to plan several groups into one relative-label
+mutation:
+
+```sh
+linear issue label TES-42 --set-group 'Team=QA'
+linear issue label TES-42 \
+  --set-group 'Team=QA' \
+  --set-group 'Issue Type=Bug' \
+  --json
+linear issue label TES-42 --set-group 'Team=QA' --dry-run --json
+linear issue label TES-42 --set-group 'Team=QA' --full-result --json
+```
+
+Both sides accept a UUID or an exact, case-sensitive name. The value is split on the first `=`:
+shell-quote the whole assignment when either name contains spaces or shell metacharacters; a label
+name may contain additional `=` characters without escaping. If the group name itself contains
+`=`, use its UUID on the left. Group containers, archived labels, labels outside the issue team's
+workspace/team/inherited scope, and labels that are not direct members of the named group are
+rejected before writing. Repeating an identical assignment normalizes to one operation; conflicting
+targets for the same resolved group are a usage error. `--set-group` cannot be mixed with the
+existing `--add`/`--remove` mode.
+
+The JSON receipt includes the resolved group/member IDs plus `changed` and `mutationSent`. An
+already-satisfied request succeeds with both fields `false` and sends no mutation. `--dry-run`
+returns the shared mutation-plan envelope and the exact `addedLabelIds`/`removedLabelIds` input;
+`--full-result` adds the canonical issue read-back, verification, and each requested group's prior
+members (including all members repaired from an inconsistent pre-existing state).
+
+This is a read/modify/write operation: the CLI reads the current labels, then sends one update with
+relative added/removed IDs, so unrelated concurrent label changes are not overwritten. Linear does
+not expose a compare-and-swap precondition here, so another writer changing the same group between
+the read and update can race; use `--full-result` when post-write verification matters. See Linear's
+current [label documentation](https://linear.app/docs/labels) for group and inheritance semantics.
+
 **Git + GitHub PR** — turn an issue into commits and a pull request. The id is inferred from the
 branch everywhere below.
 
@@ -311,7 +386,9 @@ EOF
 
 ```sh
 linear project list --team TES
+linear project list --include-archived --all --json
 linear project view "Q3 Launch"
+linear initiative list --include-archived --json
 linear project-update create "Q3 Launch" --health onTrack --body "Beta is out to 10% of users."
 linear initiative-update create "Platform" --health atRisk --body-file update.md
 ```
@@ -355,33 +432,89 @@ Every group has `--help` with full options and (for the busy ones) an Examples s
 are shown in parentheses. For a machine-readable tree of _every_ command, run
 `linear commands --json`.
 
-| Group                          | What you can do                                                                                                                                                                                                                                                                     |
-| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`issue`** (`i`)              | `view` · `list` · `mine` · `search` · `create` · `update` · `delete` · `archive`/`unarchive` · `start` (git branch) · `describe` · `pull-request`/`pr` · `assign` · `state` · `label` · `comment`/`comments` · `relation` · `subscribe`/`unsubscribe` · `id`/`title`/`url`/`branch` |
-| **`team`** (`t`)               | `list` · `view` · `members` · `states` · `labels` · `cycles` · `create` · `update`                                                                                                                                                                                                  |
-| **`project`** (`p`)            | `list` · `view` · `create` · `update` · `archive` · `milestones`                                                                                                                                                                                                                    |
-| **`project-update`** (`pu`)    | `create` · `list` (project status updates, with `--health`)                                                                                                                                                                                                                         |
-| **`milestone`** (`m`)          | `list` · `view` · `create` · `update` · `delete`                                                                                                                                                                                                                                    |
-| **`cycle`** (`c`)              | `list` · `view` · `current` · `create` · `update`                                                                                                                                                                                                                                   |
-| **`user`** (`u`)               | `list` · `view` · `me`                                                                                                                                                                                                                                                              |
-| **`label`** (`lb`)             | `list` · `create` · `update` · `delete`                                                                                                                                                                                                                                             |
-| **`state`** (`st`)             | `list` · `view` (workflow states)                                                                                                                                                                                                                                                   |
-| **`comment`** (`cm`)           | `list` · `add` · `reply` · `update` · `delete` · `resolve`/`unresolve`                                                                                                                                                                                                              |
-| **`document`** (`doc`)         | `list` · `view` · `create` · `update` · `delete`                                                                                                                                                                                                                                    |
-| **`attachment`** (`at`)        | `list` · `create` · `delete`                                                                                                                                                                                                                                                        |
-| **`favorite`** (`fav`)         | `list` · `add` · `remove`                                                                                                                                                                                                                                                           |
-| **`custom-view`** (`cv`)       | `list` · `view` · `results` · `create` · `update` · `delete`                                                                                                                                                                                                                        |
-| **`initiative`** (`init`)      | `list` · `view` · `create` · `update` · `archive` · `delete`                                                                                                                                                                                                                        |
-| **`initiative-update`** (`iu`) | `create` · `list` (initiative status updates, with `--health`)                                                                                                                                                                                                                      |
-| **`roadmap`** (`rm`)           | `list` · `view` · `create` · `update` · `delete` &nbsp;<sup>†</sup>                                                                                                                                                                                                                 |
-| **`notification`** (`notif`)   | `list` · `read`/`unread` · `read-all` · `archive` · `snooze`                                                                                                                                                                                                                        |
-| **`organization`** (`org`)     | `view` · `members` · `invites`                                                                                                                                                                                                                                                      |
-| **`webhook`** (`wh`)           | `list` · `view` · `create` · `update` · `delete`                                                                                                                                                                                                                                    |
-| **top-level**                  | `whoami` · `auth` (`login` · `list` · `default` · `token` · `status` · `logout`) · `config` · `api` · `commands` · `schema` · `completion`                                                                                                                                          |
+| Group                          | What you can do                                                                                                                                                                                                                                                                                  |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **`issue`** (`i`)              | `view` · `list` · `mine` · `search` · `create` · `update` · `delete` · `archive`/`unarchive` · `start` (git branch) · `describe` · `pull-request`/`pr` · `assign` · `delegate` · `state` · `label` · `comment`/`comments` · `relation` · `subscribe`/`unsubscribe` · `id`/`title`/`url`/`branch` |
+| **`team`** (`t`)               | `list` · `view` · `members` · `states` · `labels` · `cycles` · `create` · `update`                                                                                                                                                                                                               |
+| **`project`** (`p`)            | `list` · `view` · `create` · `update` · `archive` · `milestones`                                                                                                                                                                                                                                 |
+| **`project-update`** (`pu`)    | `create` · `list` (project status updates, with `--health`)                                                                                                                                                                                                                                      |
+| **`milestone`** (`m`)          | `list` · `view` · `create` · `update` · `delete`                                                                                                                                                                                                                                                 |
+| **`cycle`** (`c`)              | `list` · `view` · `current` · `create` · `update`                                                                                                                                                                                                                                                |
+| **`user`** (`u`)               | `list` · `view` · `me`                                                                                                                                                                                                                                                                           |
+| **`label`** (`lb`)             | `list` · `create` · `update` · `delete`                                                                                                                                                                                                                                                          |
+| **`state`** (`st`)             | `list` · `view` (workflow states)                                                                                                                                                                                                                                                                |
+| **`comment`** (`cm`)           | `list` · `add` · `reply` · `update` · `delete` · `resolve`/`unresolve`                                                                                                                                                                                                                           |
+| **`document`** (`doc`)         | `list` · `view` · `create` · `update` · `delete`                                                                                                                                                                                                                                                 |
+| **`attachment`** (`at`)        | `list` · `create` · `delete`                                                                                                                                                                                                                                                                     |
+| **`favorite`** (`fav`)         | `list` · `add` · `remove`                                                                                                                                                                                                                                                                        |
+| **`custom-view`** (`cv`)       | `list` · `view` · `results` · `create` · `update` · `delete`                                                                                                                                                                                                                                     |
+| **`initiative`** (`init`)      | `list` · `view` · `create` · `update` · `archive` · `delete`                                                                                                                                                                                                                                     |
+| **`initiative-update`** (`iu`) | `create` · `list` (initiative status updates, with `--health`)                                                                                                                                                                                                                                   |
+| **`roadmap`** (`rm`)           | `list` · `view` · `create` · `update` · `delete` &nbsp;<sup>†</sup>                                                                                                                                                                                                                              |
+| **`notification`** (`notif`)   | `list` · `read`/`unread` · `read-all` · `archive` · `snooze`                                                                                                                                                                                                                                     |
+| **`organization`** (`org`)     | `view` · `members` · `invites`                                                                                                                                                                                                                                                                   |
+| **`webhook`** (`wh`)           | `list` · `view` · `create` · `update` · `delete`                                                                                                                                                                                                                                                 |
+| **top-level**                  | `whoami` · `auth` (`login` · `list` · `default` · `token` · `status` · `logout`) · `config` · `api` · `commands` · `schema` · `completion`                                                                                                                                                       |
 
 <sup>†</sup> Linear has **deprecated roadmaps** in favor of initiatives — reads still work, but the
 API rejects roadmap mutations with a deprecation notice. Use `initiative` for new work.
 
+### Archived resources
+
+Linear hides archived resources from paginated connections by default. On curated listings that
+expose lifecycle history, `--include-archived` widens the result to live plus historical records;
+it is not an archived-only filter. Linear can return trashed resources in that widened set, so
+project, initiative, and issue JSON rows expose both `archivedAt: string|null` and
+`trashed: boolean`, and human tables label `(archived)` and `(trashed)` separately. Notification
+rows expose `archivedAt` (the public schema has no `trashed` field for notifications).
+
+`--all` remains pagination-only. The two flags are independent and composable:
+
+```sh
+linear project list --include-archived --all --json
+linear initiative list --include-archived --status Completed --json
+linear issue search "migration" --include-archived --all --json
+```
+
+`initiative list --archived` remains a compatibility alias for `--include-archived`; passing both
+spellings is an explicit usage error. The alias is retained for the current compatibility window
+(all `0.x` releases; removal no earlier than `1.0`) and is listed by help and
+`linear commands --json`.
+
+The following matrix audits every curated list/search surface against the installed
+`@linear/sdk@92.0.0` types and the live public schema exposed by `linear schema`. “Schema support”
+means that the exact connection used by the command accepts `includeArchived`; it does not by
+itself add a CLI contract. This change standardizes the four resource families named by
+the issue. The remaining schema-capable collections stay unchanged until their own output and
+resolver semantics are designed, rather than acquiring a silent partial implementation.
+
+| Curated command(s)                                     | Connection audited                            | Schema support | CLI lifecycle option                           | Lifecycle fields in list JSON |
+| ------------------------------------------------------ | --------------------------------------------- | -------------- | ---------------------------------------------- | ----------------------------- |
+| `issue list`, `issue mine`                             | `Query.issues`                                | yes            | `--include-archived`                           | `archivedAt`, `trashed`       |
+| `issue search`                                         | `Query.searchIssues`                          | yes            | `--include-archived`                           | `archivedAt`, `trashed`       |
+| `project list`                                         | `Query.projects`                              | yes            | `--include-archived`                           | `archivedAt`, `trashed`       |
+| `initiative list`                                      | `Query.initiatives`                           | yes            | `--include-archived` (`--archived` alias)      | `archivedAt`, `trashed`       |
+| `notification list`                                    | `Query.notifications`                         | yes            | `--include-archived`                           | `archivedAt`                  |
+| `attachment list`                                      | `Issue.attachments`                           | yes            | not exposed                                    | not exposed                   |
+| `comment list`, `issue comment list`, `issue comments` | `Issue.comments`                              | yes            | not exposed                                    | not exposed                   |
+| `cycle list`, `team cycles`                            | `Team.cycles`                                 | yes            | not exposed                                    | not exposed                   |
+| `custom-view list`                                     | `Query.customViews`                           | yes            | not exposed                                    | `archivedAt`                  |
+| `custom-view results`                                  | `CustomView.issues/projects/initiatives`      | yes            | not exposed                                    | not exposed                   |
+| `document list`                                        | `Query.documents`                             | yes            | not exposed                                    | not exposed                   |
+| `favorite list`                                        | `Query.favorites`                             | yes            | not exposed                                    | not exposed                   |
+| `initiative-update list`                               | `Initiative.initiativeUpdates`                | yes            | not exposed                                    | not exposed                   |
+| `issue agent-session list`                             | `Query.agentSessions` / `Issue.agentSessions` | yes            | not exposed                                    | not exposed                   |
+| `label list`, `team labels`                            | `Query.issueLabels` / `Team.labels`           | yes            | not exposed                                    | not exposed                   |
+| `milestone list`, `project milestones`                 | `Project.projectMilestones`                   | yes            | not exposed                                    | not exposed                   |
+| `project-update list`                                  | `Project.projectUpdates`                      | yes            | not exposed                                    | not exposed                   |
+| `roadmap list`                                         | `Query.roadmaps`                              | yes            | not exposed                                    | not exposed                   |
+| `state list`, `team states`                            | `Team.states`                                 | yes            | not exposed                                    | not exposed                   |
+| `team list`                                            | `Query.teams`                                 | yes            | not exposed                                    | not exposed                   |
+| `team members`, `user list`, `organization members`    | user connections                              | yes            | not exposed (`--include-disabled` is separate) | not exposed                   |
+| `organization invites`                                 | `Query.organizationInvites`                   | yes            | not exposed                                    | not exposed                   |
+| `webhook list`                                         | `Query.webhooks`                              | yes            | not exposed                                    | not exposed                   |
+| `auth list`                                            | local credential registry (no API connection) | no             | not applicable                                 | not applicable                |
+
 ### Global flags
 
 | Flag                        | Effect                                                                                                                    |
@@ -452,7 +585,8 @@ so prefer the `code` field for fine-grained handling and the exit code for coars
 - **`-q, --quiet`** — suppress success/status lines on stderr (errors still print).
 - **`-n, --limit <n>` / `--all`** — `--limit` caps results; `--all` exhausts pagination. With
   neither, the default cap is **50**. `--all` (and very large `--limit`) can be slow and
-  rate-limit-prone on big workspaces.
+  rate-limit-prone on big workspaces. It never includes archived resources; combine it with
+  `--include-archived` where that option is available.
 
 ```sh
 # agent-safe: no prompts, no chatter, fail fast with a parseable error
@@ -563,41 +697,54 @@ Non-secret defaults live in `~/.config/linear/config.toml` (user-wide) or a proj
 file. **Secrets never go in a project file** — the API key is only ever read from the flag, the
 env, the user config, or the OS keyring.
 
-Precedence, highest first — `linear config` prints each value with the tier and file it came from:
+Effective team precedence, highest first — `linear config` prints the tier, file, and selected
+profile slug where applicable:
 
 1. the flag (`--team`, `--workspace`, `--sort`)
 2. the environment (`LINEAR_TEAM`/`LINEAR_TEAM_ID`, `LINEAR_WORKSPACE`, `LINEAR_ISSUE_SORT`)
 3. the **project config**: the first file found walking up from the working directory, checking in
    each directory `linear.toml`, then `.linear.toml`, then `.config/linear.toml`; compatible
    existing project configuration is picked up as-is
-4. the **user config**, `~/.config/linear/config.toml` (`$XDG_CONFIG_HOME` honored)
-5. the legacy **global config**, `~/.config/linear/linear.toml` — read for non-secret settings
+4. `team` on the selected `[workspaces."<slug>"]` profile
+5. the legacy top-level `team` in the **user config**, `~/.config/linear/config.toml`
+   (`$XDG_CONFIG_HOME` honored)
+6. the legacy **global config**, `~/.config/linear/linear.toml` — read for non-secret settings
    only, so a migrating user's defaults carry over
+7. no default team
+
+`workspace` and `sort` keep their existing flag → environment → project → user → legacy-global
+order. Workspace credential selection is independent and follows the order described above.
 
 Keys: `team` (or `team_id`), `workspace`, and `sort` (or `issue_sort`). You can write these from
-the CLI — comments and layout in an existing file are preserved, and the write is atomic:
+the CLI. Project and top-level setting edits preserve comments and layout. Profile updates preserve
+all TOML data and use the same locked, atomic rewrite as credential updates:
 
 ```sh
 linear config init                    # pick a team from a list → <git root>/.linear.toml
 linear config init --team TES         # …or say which (scripts); --sort, --path, --force
 linear config set sort updated        # edit one key in the project config in effect
-linear config set team ENG --user     # …or in ~/.config/linear/config.toml
+linear config set team ENG --user     # legacy top-level user fallback (backward compatible)
+linear config set team ENG --user --workspace acme # validated default for the acme profile
 linear config                         # show the result, with each value's source
 ```
 
 `config set` will not write `api_key` or anything else that belongs to the credential store — that
-is what `auth login` is for.
+is what `auth login` is for. A profile team is validated against the selected workspace whenever a
+credential is available. Login, adopt, OAuth refresh/fallback, and credential migration preserve
+profile metadata. Logout reports whether removing a whole profile also removed its team metadata.
 
 ```toml
 # ~/.config/linear/config.toml
 default_workspace = "acme"     # which stored credential is active
-team = "TES"                   # default team key
+team = "TES"                   # optional legacy/global fallback team
 sort = "priority"              # default issue-list sort: priority | updated | created
 
 [workspaces."acme"]            # per-workspace credentials (hyphenated slugs are quoted)
 keyring = true                 # secret lives in the OS keyring (service linear-cli, account acme)
+team = "ENG"                   # non-secret default team for this workspace
 [workspaces."other-org"]
 api_key = "lin_api_yyyyyyyy"   # …or, with `auth login --plaintext`, in this 0600 file
+team = "OPS"
 ```
 
 Relevant environment variables: **`LINEAR_API_KEY`** or **`LINEAR_ACCESS_TOKEN`** (absolute —
@@ -655,6 +802,15 @@ bun run audit:coverage   # regenerate COVERAGE.md (add --update to re-baseline t
 bun run janitor          # sweep leaked `clitest-` fixtures from the test workspace
 ```
 
+The live delegation suite is additionally gated by `LINEAR_CLI_LIVE_AGENT_ID`, the UUID of an
+explicit disposable-test agent. It can trigger that integration's Agent Session/webhook and is
+never enabled by the general live-test flag alone.
+
+The live label-group suite is additionally gated by `LINEAR_CLI_TEST_LABEL_GROUP` and
+`LINEAR_CLI_TEST_LABEL_GROUP_MEMBER`, naming (or identifying by UUID) a pre-existing group and one
+direct member usable by `LINEAR_CLI_TEST_TEAM`. It creates only a disposable issue; it does not
+create, rename, move, or delete the shared label-group fixture.
+
 Architecture is three layers — **commands** (commander wiring) → **services** (one module per
 resource, the only place that touches the SDK) → **`@linear/sdk`**. The machine JSON envelope is
 locked and contract-tested so output never silently drifts.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linear-sdk-cli",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Ergonomic command-line interface for Linear, built on @linear/sdk",
   "type": "module",
   "license": "MIT",
@@ -57,6 +57,7 @@
     "format": "oxfmt .",
     "format:check": "oxfmt --check .",
     "test": "bun test test/unit test/contract",
+    "test:performance": "bun test --timeout 15000 test/performance",
     "test:unit": "bun test test/unit",
     "test:contract": "bun test test/contract",
     "test:live": "LINEAR_CLI_LIVE=1 bun test --timeout 60000 test/integration",
@@ -69,8 +70,8 @@
     "janitor": "bun run test/janitor.ts"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.7.0",
-    "@linear/sdk": "^92.0.0",
+    "@inquirer/prompts": "^8.7.1",
+    "@linear/sdk": "^93.0.1",
     "commander": "^15.0.0",
     "graphql": "^17.0.2",
     "picocolors": "^1.1.1",
@@ -78,10 +79,10 @@
   },
   "packageManager": "bun@1.4.0",
   "devDependencies": {
-    "@types/bun": "^1.4.0",
-    "@types/node": "^26.4.0",
-    "oxfmt": "^0.65.0",
-    "oxlint": "^1.80.0",
+    "@types/bun": "^1.4.1",
+    "@types/node": "^26.4.1",
+    "oxfmt": "^0.66.0",
+    "oxlint": "^1.81.0",
     "typescript": "^7.0.2"
   }
 }

package/skills/linear-sdk-cli/SKILL.md

@@ -94,6 +94,8 @@ The CLI supports distinct human, hosted-app, and personal-key lifecycles:
    linear issue list --workspace acme --json
    ```
 
+Login associates the authenticated workspace with the discovered project config, or creates `.linear.toml` at the Git root (cwd outside Git). Use `--no-project` for credential-only login; JSON reports `projectConfigPath` or null. Credentials stay global. Workspace selection is `--workspace` → `LINEAR_WORKSPACE` → project config → optional global default. A sole stored workspace is automatic; multiple unselected workspaces prompt only interactively and fail in JSON/noninteractive mode. Login/adoption/logout never assign a new default. Existing legacy defaults remain valid because their original intent is unknown; `auth default` is an explicit convenience.
+
 An explicit credential flag overrides environment credentials. If both credential kinds occur at
 the same precedence level, the CLI fails rather than silently choosing an actor. Inspect resolution
 with `linear auth status`. `linear auth token` exports stored API keys only and never OAuth tokens.
@@ -215,6 +217,14 @@ perfectly with a heredoc:
 - `comment add` / `comment update` / `comment reply` → `--body-file <path>`
 - `document create` / `document update` → `--content-file <path>`
 
+Comments canonically use `add`, while resources such as attachments use `create`.
+`create` is also accepted as a compatibility alias for comment `add`. For a file-backed
+issue comment, copy this form:
+
+```bash
+linear issue comment add LUMI-9340 --body-file comment.md --json
+```
+
 ```bash
 linear issue create --title "Onboarding bug" --team TES --no-input --json \
   --description-file - <<'EOF'
@@ -374,6 +384,7 @@ linear issue comment list
 linear issue comment update
 linear issue comments
 linear issue create
+linear issue delegate
 linear issue delete
 linear issue describe
 linear issue id

package/skills/linear-sdk-cli/references/auth.md

@@ -69,7 +69,7 @@ storage: string
 
 ### `linear auth login`
 
-Authenticate in the browser with OAuth, or store a personal API key
+Authenticate and select the workspace for this project
 
 ```
 linear auth login [options]
@@ -77,6 +77,7 @@ linear auth login [options]
 
 | Option                 | Description                                                           |
 | ---------------------- | --------------------------------------------------------------------- |
+| `--no-project`         | save credentials without changing the project workspace               |
 | `--key <key>`          | use a personal API key ('-' reads it from stdin)                      |
 | `--plaintext`          | Store the key in the config file (0600) instead of the system keyring |
 | `--no-browser`         | print the authorization URL instead of opening it                     |
@@ -97,6 +98,7 @@ storage: string
 scopes?: string[]
 expiresAt?: string
 path: string
+projectConfigPath: string | null
 ```
 
 ### `linear auth logout`
@@ -119,6 +121,7 @@ workspace: string
 removed: boolean
 revocation: string
 fallbackCredentialType: string | null
+teamMetadataRemoved: boolean
 ```
 
 ### `linear auth migrate`

package/skills/linear-sdk-cli/references/comment.md

@@ -22,6 +22,8 @@ linear comment [options]
 
 Add a comment to an issue (images uploaded with --attach render inline)
 
+Aliases: `create`
+
 ```
 linear comment add [options] <issue> [body]
 ```

package/skills/linear-sdk-cli/references/config.md

@@ -22,10 +22,11 @@ apiKeySource: string
 accessToken: string
 accessTokenSource: string
 credentialWorkspace: string | null
+workspaceProfile: string | null
 team: string | null
 workspace: string | null
 sort: string
-origins: {team: {source: string, path?: string, key?: string}, workspace: {source: string, path?: string, key?: string}, sort: {source: string, path?: string, key?: string}}
+origins: {team: {source: string, path?: string, key?: string, workspace?: string}, workspace: {source: string, path?: string, key?: string, workspace?: string}, sort: {source: string, path?: string, key?: string, workspace?: string}}
 userConfigPath: string
 projectConfigPath: string | null
 globalConfigPath: string | null
@@ -57,16 +58,16 @@ sort?: string
 
 ### `linear config set`
 
-Set one project setting (team, workspace, sort) in the project config
+Set one project or user setting (team, workspace, sort)
 
 ```
 linear config set [options] <key> <value>
 ```
 
-| Option          | Description                                                  |
-| --------------- | ------------------------------------------------------------ |
-| `--user`        | write the user config (~/.config/linear/config.toml) instead |
-| `--path <file>` | write this file instead of the project config in effect      |
+| Option          | Description                                                               |
+| --------------- | ------------------------------------------------------------------------- |
+| `--user`        | write the user config (team + --workspace targets that workspace profile) |
+| `--path <file>` | write this file instead of the project config in effect                   |
 
 **Output (`--json`)**: a receipt object
 
@@ -75,6 +76,7 @@ success: boolean
 path: string
 key: string
 value: string
+workspace?: string
 ```
 
 ### `linear config show`
@@ -93,10 +95,11 @@ apiKeySource: string
 accessToken: string
 accessTokenSource: string
 credentialWorkspace: string | null
+workspaceProfile: string | null
 team: string | null
 workspace: string | null
 sort: string
-origins: {team: {source: string, path?: string, key?: string}, workspace: {source: string, path?: string, key?: string}, sort: {source: string, path?: string, key?: string}}
+origins: {team: {source: string, path?: string, key?: string, workspace?: string}, workspace: {source: string, path?: string, key?: string, workspace?: string}, sort: {source: string, path?: string, key?: string, workspace?: string}}
 userConfigPath: string
 projectConfigPath: string | null
 globalConfigPath: string | null