包简介

Linear adapter for bootdesk/chat-sdk-core

README 文档

README

Linear adapter for the laravel-bootdesk multi-platform messaging framework.

Install

composer require bootdesk/chat-sdk-adapter-linear

Requires a PSR-18 HTTP client (guzzlehttp/guzzle, symfony/http-client, etc.) and a PSR-17 factory (nyholm/psr7 bundled).

Configuration

Variable	Description	Example
`api_key`	Linear API Key	`lin_api_abc123...`
`http_client`	PSR-18 HTTP client instance	`new GuzzleHttp\Client`
`webhook_secret`	Webhook Secret	`my-secret...`

use BootDesk\ChatSDK\Linear\LinearAdapter;

$adapter = new LinearAdapter(
    apiKey: env('LINEAR_API_KEY'),
    httpClient: new \GuzzleHttp\Client,
    webhookSecret: env('LINEAR_WEBHOOK_SECRET'),
);

Laravel

The ChatServiceProvider auto-binds Psr\Http\Client\ClientInterface to GuzzleHttp\Client. Add to config/chat.php:

'linear' => [
    'api_key'        => env('LINEAR_API_KEY'),
    'webhook_secret' => env('LINEAR_WEBHOOK_SECRET'),
],

Quick Example

// Post a comment on an issue
$adapter->postMessage('linear:ABC-123', 'Looking into this.');

// Post in a comment thread
$adapter->postMessage('linear:ABC-123:c:456', 'Reply to comment.');

// Post in an agent session
$adapter->postMessage('linear:ABC-123:s:session-xyz', 'Agent update.');

Thread ID Format

Format	Description
`linear:{issueId}`	Bare issue
`linear:{issueId}:c:{commentId}`	Comment thread
`linear:{issueId}:s:{agentSessionId}`	Agent session
`linear:{issueId}:c:{commentId}:s:{agentSessionId}`	Comment + session

Webhook

Linear sends webhook events to your endpoint. Verify requests using HMAC-SHA256 verification via the linear-signature header.

API endpoint: https://api.linear.app/graphql

Handled events: Comment.create

Feature Matrix

Feature	Supported
Post messages	✓
Edit messages	✓
Delete messages	✓
Reactions	✓
Slash commands	✗
Typing indicator	✗
Fetch messages	✓
Fetch thread info	✓
Fetch channel info	✓
Get user	✓
Open DM	✗
Stream	✓

Notes

Uses the Linear GraphQL API. Bot identity is resolved via the viewer query on initialization. Card messages are rendered as Linear-flavored markdown. Edit and delete are not supported for agent sessions.

Documentationn

Full API documentation: https://bootdesk.github.io/chat-sdk

License

MIT

bootdesk/chat-sdk-adapter-linear 适用场景与选型建议

bootdesk/chat-sdk-adapter-linear 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 12 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 05 月 18 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 bootdesk/chat-sdk-adapter-linear 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 bootdesk/chat-sdk-adapter-linear 我们能提供哪些服务？

定制开发 / 二次开发

基于 bootdesk/chat-sdk-adapter-linear 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

bootdesk/chat-sdk-adapter-linear

包简介