linctl CLI
Go CLI for the Linear API built with agents in mind: issues, projects, comments, raw GraphQL, JSON output and a built-in MCP
- 145 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- A personal API key gives the agent access to everything your user can reach in Linear
- The raw GraphQL command runs arbitrary queries and mutations, including deleting data
Install
- Works in
Manual install
brew tap dorkitude/linctl && brew install linctlCommand from the README. Nix (`nix profile install github:dorkitude/linctl`) and a source build with `make deps` and `make build` also work.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- A personal API key gives the agent access to everything your user can reach in Linear
- The raw GraphQL command runs arbitrary queries and mutations, including deleting data
This is third-party code. Review the repository files before installing.
What it does
linctl is a Go and Cobra command line for Linear built with agents in mind but handy for humans too. Sign-in uses a personal API key (`linctl auth`), an environment variable can override it, and credentials can be stored through `pass`. Commands cover issues (list, search, get, create, update, assign, cycles, labels, delegation, projects, milestones, parent and sub-issue links, due dates, attachments, comments and relations such as blocks, duplicate and similar), projects (create, update, delete, archive), teams, users, labels and comments. You can inspect agent session state on an issue, run arbitrary GraphQL in your name and use a dynamic `linctl mcp` namespace that discovers and calls schema-backed operations. Output comes as table, plaintext or JSON. There are sorting and time filters, built-in docs with `linctl docs` and a read-only mode for smoke tests. Install through Homebrew, Nix or a source build, and the repository holds a `SKILL.md` for agents.
Who it is for. Developers and teams on Linear who want to manage issues from the terminal and let an agent create, search and update them.
Good fit when
- An agent should create and update Linear issues from the terminal
- You need JSON output for scripts and agents
- An arbitrary GraphQL query to Linear with your access is needed
- Issue relations and comments are managed by commands
Not a fit when
- You do not use Linear: the tool works only with it
- You need an MCP server with no command line: the tool has a `linctl mcp` namespace but is a CLI at its core
- You may not give an agent a personal API key with full workspace access
Example request
Find my open Linear issues due this week, print JSON and create a sub-issue for the most urgent oneLimitations
Sign-in uses a personal Linear API key that grants access to everything your user can reach, and the raw GraphQL command runs arbitrary queries and mutations. The key can live in an environment variable or in `pass`. The dynamic `linctl mcp` namespace depends on the Linear schema at request time. Building from source needs `make deps`, `make build` and sudo for `make install`. The last commit is dated October 21, 2026.
How to disable. Sign out through the auth command (`linctl auth`) or remove the key from the environment variable and the `pass` store, revoke the key in Linear settings and uninstall the program (`brew uninstall linctl`).
FAQ
How do I install linctl?
Through Homebrew: `brew tap dorkitude/linctl` and `brew install linctl`. Nix and a source build also work.
How do I sign in to Linear?
With `linctl auth` and a personal API key, an environment variable can override it and `pass` can store the key.
Is there output for scripts?
Yes, output modes are table, plaintext and JSON.
Can I run arbitrary GraphQL?
Yes, with the raw GraphQL command under your auth context. It runs any queries and mutations your key allows.
What is linctl mcp?
A dynamic namespace that discovers and calls Linear operations from the schema.
Discussion
No questions or reviews yet.
Related
CLI toolsLinear CLI
linear-cli
A Linear CLI for the terminal: list, start and create issues, PRs from a branch, JSON output and an agent skill, with git and jj support
Linearis manages Linear issues and projects from the terminal, returns JSON and exposes focused command references to agents.
An MCP server for Linear: issues, projects, cycles, milestones, documents and project updates via the GraphQL API
A Linear MCP server with one tool and seven actions that takes about 500 tokens of context against 17,000
MCP server for Linear: the agent creates and updates issues, searches the tracker and adds comments through the Linear API
A command-line client for the Octo ecosystem built for AI agents: messages, documents, drive and mail through commands that answer in JSON
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| linctl (this card) | no | 145 | |
| Linear CLI | no | 1,046 | broader in commands: projects, milestones, relations, raw GraphQL and an MCP namespace |
| Linearis | no | 265 | written in Go with output modes and a built-in MCP namespace |
README in short
The README lists the features: sign-in, issues, projects, teams, users, labels, comments, agent sessions, raw GraphQL, a dynamic MCP namespace and output modes. Installation through Homebrew, Nix and a source build and usage examples follow.