Skip to content

Commit ddc6779

Browse files
techjoecclaude
andcommitted
docs: add Labels section to README and CHANGELOG
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent b50e32b commit ddc6779

2 files changed

Lines changed: 27 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
### Added
11+
12+
**Labels CRUD Commands (GitHub #19, PR #20):**
13+
- New top-level `labels` command with `list`, `create`, `update`, `delete` subcommands
14+
- `linear labels list --team ENG` — lists labels with name, color, ID; supports `--output json`
15+
- `linear labels create "name" --team ENG [--color "#hex"] [--description "text"]`
16+
- `linear labels update <id> [--name] [--color] [--description]`
17+
- `linear labels delete <id>`
18+
- Agent-mode gate: mutations return a clear error when authenticated as an OAuth app actor (Linear workspace restriction)
19+
- Existing `teams labels` command unchanged
20+
1021
## [1.4.6] - 2026-01-28
1122

1223
### Fixed

README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,7 @@ linear auth login
8181
- [Projects](#projects)
8282
- [Cycles](#cycles)
8383
- [Teams](#teams)
84+
- [Labels](#labels)
8485
- [Users](#users)
8586
- [Claude Code Skills](#claude-code-skills)
8687
- [Cycle Analytics](#cycle-analytics)
@@ -262,6 +263,7 @@ All commands support both flags:
262263
- **Cycles**: `list`, `get`, `analyze`
263264
- **Projects**: `list`, `get`
264265
- **Teams**: `list`, `get`, `labels`, `states`
266+
- **Labels**: `list`
265267
- **Users**: `list`, `get`, `me`
266268
- **Search**: all search operations
267269

@@ -628,6 +630,20 @@ linear teams labels ENG # Team labels
628630
linear teams states ENG # Workflow states
629631
```
630632

633+
### Labels
634+
635+
```bash
636+
linear labels list --team ENG # List all labels (with IDs)
637+
linear labels list --team ENG --output json # JSON output
638+
639+
# Create, update, delete (requires user auth, not agent/app)
640+
linear labels create "needs-review" --team ENG --color "#ff0000" --description "PR needs review"
641+
linear labels update LABEL-UUID --name "needs-code-review" --color "#ff6600"
642+
linear labels delete LABEL-UUID
643+
```
644+
645+
> **Note:** Label mutations (create/update/delete) require user authentication. OAuth app actors cannot manage labels due to Linear workspace permissions. Use `linear auth login` as a user.
646+
631647
### Users
632648

633649
```bash

0 commit comments

Comments
 (0)