Skip to main content

Overview

OneCLI connects AI agents to Linear through OAuth. Agents can search issues and projects, create and update issues, and leave comments. The gateway injects the token into every request, so your agent never sees it. On OneCLI Cloud, connecting takes one click. Self-hosted, you first add your own Linear app (see the bottom of this page).

What you will set up

  • A Linear connection through OAuth
  • Automatic token injection on every Linear request
  • Per-agent, per-tool access, with approval for deletes

Connect Linear

1

Click Connect

In the OneCLI dashboard, open Settings > Apps > Linear and click Connect Linear.
OneCLI connect window for Linear, showing the setup guide link and the Connect to Linear button.

The Linear connect window in OneCLI.

2

Authorize in Linear

Sign in to Linear, pick your workspace, and click Authorize. You’re done.

What agents can do

Controlling access

Grant the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what’s blocked. Put Delete issue behind approval. Organization rules add guardrails on top. A blocked request never reaches Linear. To disconnect, remove the connection in Settings > Apps > Linear, then revoke OneCLI in Linear under Settings > Account > Security & access.

Self-hosted: use your own Linear app

Skip this section on OneCLI Cloud. Self-hosted OneCLI needs either LINEAR_CLIENT_ID and LINEAR_CLIENT_SECRET on the server, or your own Linear app added below.

1. Create the Linear app

In Linear, open Settings > API > OAuth applications and click Create new. Name it OneCLI.
Linear new OAuth application form with the name OneCLI, a developer name and URL, and https://onecli.example.com/v1/apps/linear/callback in Callback URLs.

The new OAuth application form in Linear, with the OneCLI callback URL.

In OneCLI, open Settings > Apps > Linear > Custom credentials and copy the Redirect URI. Paste it into the Linear app’s Callback URLs and save.
OneCLI Custom credentials card for Linear with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.

Copy the Redirect URI from Custom credentials in OneCLI.

Copy the app’s Client ID and Client Secret into Custom credentials, turn it on, then click Connect Linear.

FAQ

No. On OneCLI Cloud you connect with OAuth in one click. Self-hosted, you add your own Linear app first. See Self-hosted.
No. The token stays in OneCLI, and the gateway adds it at the proxy. See How it works.
Remove the connection in Settings > Apps > Linear, then revoke OneCLI in Linear under Settings > Account > Security & access.