Claude Managed Agents Demo

Claude + Linear Agent Bridge

**_This is an example project not meant for production use._**

A bridge server that connects [Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) to [Linear's Agent Platform](https://linear.app/developers/agents). When users @mention or assign the agent in Linear, the server forwards the request to a Claude Managed Agent session and streams the response back as Linear agent activities.

How it works

1. A user @mentions your agent in a Linear issue or comment
2. Linear sends an AgentSessionEvent webhook to your server
3. The server acknowledges with a "thinking" activity (required within 10s)
4. A Claude Managed Agent session is created with the issue context
5. Claude's streamed response is relayed back to Linear as agent activities

Prerequisites

• Bun runtime
• An Anthropic API key
• A Claude Managed Agent (agent ID and environment ID)
• A Linear workspace with admin access

Setup

1. Install dependencies

bun install

2. Create a Linear OAuth Application

Go to [Linear API Settings](https://linear.app/settings/api/applications) and create a new application:

• Redirect URL: /oauth/callback
• Webhook URL: /webhook
• Webhook events: Subscribe to Agent session events

Copy the **Client ID**, **Client Secret**, and **Webhook Signing Secret**.

3. Configure environment

cp .env.example .env.local

Fill in your credentials in `.env.local`:

Variable	Description
ANTHROPIC_API_KEY	Your Anthropic API key
CLAUDE_AGENT_ID	Claude Managed Agent ID
CLAUDE_ENVIRONMENT_ID	Claude environment ID
LINEAR_CLIENT_ID	From Linear OAuth app settings
LINEAR_CLIENT_SECRET	From Linear OAuth app settings
LINEAR_WEBHOOK_SIGNING_SECRET	From Linear OAuth app settings
PORT	Server port