Dome Systems
Dashboard
DocsLearnHands-on LabsTemplatesHelpChangelogCLIAPIMCPSDKs

Ask questions about Linear

A read-only managed agent for searching and summarizing a Linear workspace.

User
Caller
  • chat
App
Agent
  • linear-answerer
Governance
Gateway
  • linear-readonly
Pool

linear-answerer-pool

  • linear-answerer-model
Tools

linear

    What this template gives you

    • Interface

      A chat window, in your browser

      Use the included interface to send a request to this template.

    • Gateway

      linear-readonly gateway

      This template sends its requests through linear-readonly gateway, where its access rules and limits apply.

    • Model

      linear-answerer-model

      This template uses linear-answerer-model through the linear-answerer-pool pool.

    Usage

    Hand this template to an AI agent to set up this template

    Node.js and npm to run npx.

    Dome CLI, installed with brew install dome-systems/tap/dome, then signed in with dome auth login.

    Docker Compose to run the companion app locally.

    1. 1

      Create a workspace

      dome workspaces create --name <workspace-name>

      The CLI creates and selects a workspace context for you.

    2. 2

      Confirm the workspace context

      dome context list

      The workspace you just created is already selected.

    3. 3

      Pull the template

      npx @domesystems/templates pull dome-systems/ai-agent-for-linear@0.1.0 --dir ai-agent-for-linear

      Downloads this immutable release and verifies its digest.

    4. 4

      Run the template

      npx @domesystems/templates up --dir ai-agent-for-linear

      Imports it into Dome and starts the companion app.

    Dome import variables

    npx @domesystems/templates up imports the template into Dome and prompts for required values. For unattended runs, set them as DOME_IMPORT_VAR_… environment variables.

    Required values

    • DOME_IMPORT_VAR_anthropic_api_key

    Setup guide

    Follow this template's setup guidance for agent variables and upstream connections.

    # Configure Linear

Linear's read-only endpoint supports OAuth 2.1 with Dynamic Client
Registration. This template uses `https://mcp.linear.app/mcp/readonly`, so it
does not require a manually created Linear application or API key.

- `anthropic_api_key`: enter the Anthropic key used by this agent's model.
- After import, complete shared OAuth as a dedicated test member, select the
  intended workspace, and verify a known test issue is visible while an
  unshared team's issue is unavailable.

The upstream endpoint and the requested `read` scope are read-only. A separate
API-key or existing-OAuth-token configuration is available for a non-interactive
integration; do not add a personal full-access key to this template.

    Runtime environment

    These variables are required to run the agent. During pull, .env.example is copied to .env when available. If they’re missing, npx @domesystems/templates up retrieves them from Dome and saves them in .env. Pass --provision to refresh them.

    No .env.example is included in this release.

    Agent instructions

    You answer questions from the connected Linear workspace.

Use the available Linear tools to find issues, projects, cycles, and their
current state. Summarize only what the tool results support, and say plainly
when you cannot find a requested item.

This is a read-only assistant. Never attempt to create, edit, assign, move,
archive, or delete a Linear record. If a request asks for a change, explain
that this template is intentionally read-only and provide a proposed update the
user can apply in Linear.