专为 LLM 代理优化的 Linear 项目管理 CLI，支持 JSON 输出实现问题追踪、文档管理与工作流自动化。
说明：
## 核心功能
`linearis` 是针对 [Linear.app](https://linear.app) 设计的命令行工具，专为 LLM 代理场景优化，所有命令默认返回 JSON 格式输出，便于程序化解析和自动化处理。
### 主要能力覆盖
| 模块 | 支持操作 |
|——|———|
| Issues | 列出、搜索、创建、更新（状态/标题/负责人/标签/父任务） |
| Comments | 为问题添加评论 |
| Documents | 项目文档的 CRUD 全生命周期管理 |
| Embeds | 文件上传下载 |
| 组织结构 | 团队、用户、项目、迭代周期查询 |
### 显著优点
1. **LLM 原生设计**：JSON 优先输出，无需解析人类可读格式，降低 token 消耗
2. **完整工作流覆盖**：从问题创建到归档、从文档撰写到附件管理，一站式支持
3. **灵活的认证方式**：支持文件存储、环境变量或命令行传参
4. **批量操作友好**：配合 `jq` 可实现复杂的管道处理
### 潜在局限
– **Node.js 依赖**：需 npm 环境，对纯 Python/Go 生态的代理不够轻量
– **仅支持个人 API Token**：暂不支持 OAuth 应用级别的组织授权
– **更新标签的语义复杂度**：`–label-by adding/removing` 需要额外理解操作模式
– **无本地缓存机制**：每次查询均调用 Linear API，高频场景可能触发限流
### 适用场景
– AI 代码助手自动关联 Linear 问题与 PR
– 自动化周报生成（查询本周 closed issues）
– 构建内部 Slack/Discord bot 集成
– CI/CD 流水线自动更新任务状态
### 常规风险提示
– **Token 安全**：`~/.linear_api_token` 文件权限需设置为 600，避免泄露
– **数据完整性**：批量更新操作无预览/回滚机制，建议先 `–dry-run`（如有）或小批量测试
– **API 限流**：Linear API 有速率限制，高频自动化需配合指数退避
—
*来源：独立开发者项目，GitHub 开源（czottmann/linearis），基于 MIT 或类似宽松协议*
会员专属
