lin-cli 0.2.0

A fast CLI for Linear
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

# lin

A fast CLI for [Linear](https://linear.app).

## Install

### Homebrew (macOS & Linux)

```sh
brew install sprouted-dev/tap/lin
```

### Cargo

```sh
cargo install lin-cli
```

### From source

```sh
git clone https://github.com/sprouted-dev/lin.git
cd lin
cargo install --path .
```

## Setup

1. Create a [Linear API key](https://linear.app/settings/api).

2. Log in:

```sh
lin login <your-api-key>
```

To associate the token with a named workspace:

```sh
lin login <your-api-key> --name my-workspace
```

## Usage

### Issues

```sh
lin issue view ENG-123
lin issue search "bug in auth"
lin issue search "login" --team APP --status "In Progress"
lin issue list --team APP
lin issue list --assignee me --status "In Progress"
lin issue me
lin issue me --status "Todo"
lin issue create "Fix login" --team APP
lin issue create "Fix login" --team APP --assignee me --priority 2
lin issue edit ENG-123 --state "In Progress"
lin issue state ENG-123
lin issue state ENG-123 "Done"
lin issue state ENG-123 --list
lin issue attachments ENG-123
```

### Comments

```sh
lin comment view ENG-123
lin comment add ENG-123 "Looks good"
lin comment edit <comment-id> "Updated comment"
```

### Projects

```sh
lin project list
lin project view "My Project"
lin project create "My Project" --teams APP
lin project edit "My Project" --state started
lin project update list "My Project"
lin project update add "My Project" "Sprint update" --health onTrack
```

### Cycles

```sh
lin cycle list --team APP
lin cycle active --team APP
```

### Initiatives

```sh
lin initiative list
lin initiative view <initiative-id>
```

### Teams

```sh
lin team list
```

### Users

```sh
lin user list
```

### Labels

```sh
lin label list
lin label list --team APP
lin label create "Bug" --team APP
```

### Workspaces

```sh
lin workspace current
lin workspace list
lin workspace set my-workspace
```

Use the `-w` flag to target a specific workspace:

```sh
lin -w my-workspace issue view ENG-123
```

### Identifier Resolution

Most flags accept human-readable names instead of UUIDs:

- `--team` accepts a team name (e.g., `Engineering`), key (e.g., `APP`), or UUID
- `--assignee` accepts a user name, email, `me`, or UUID
- `--project` accepts a project name or UUID
- Issue identifiers like `ENG-123` are resolved automatically

Run `lin --help` for the full command reference.

## Contributing

```sh
just setup   # configure git hooks
just check   # format, lint, test
```

## License

[MIT](LICENSE)