pi- 线性
配置线性工具和设置上覆盖的输出默认值.
人可读出的问题结果使截图保持干净,而完整的JSON仍然可用Ctrl+O.
线性集成 毕 有64+工具,涵盖问题、项目、文件、倡议、评论、关系等。 包括多工作空间认证和每个工具设置覆盖.
先决条件
您需要线性 API 密钥 。 要创建一个:
- 转到 线性设置 > 账户 > 安全访问 > API
- 点击 创建密钥 并给其取名(如"pi")
- 下 权限选择 只选择权限 与 读取 财务报告和审定财务报表 写入 启用 。 离开 管理员 不受约束.
- 下 团队准入选择 所有可以进入的队伍 或特定小组的范围,如果您愿意的话
- 点击 创建 复制密钥
安装
pi install npm:@alasano/pi-linear
认证
扩展可使用存储的工作空间或 LINEAR_API_KEY 环境变量。 默认优先使用存储的工作空间, 因此即使多账户切换 LINEAR_API_KEY 在全球设定.
使用 /linear-auth 命令来管理工作空间并选择认证偏好 :
| 命令 | 说明 |
|---|---|
/linear-auth add <name> | 添加 API 密钥的工作空间( 密钥提示) |
/linear-auth remove <name> | 删除工作空间( 名称省略后显示选择器) |
/linear-auth switch <name> | 切换活动工作空间并选择存储的工作空间 |
/linear-auth prefer workspace|env | 选择存储的工作空间或 LINEAR_API_KEY 首先尝试 |
/linear-auth status | 显示认证偏好、 活动源和配置的工作空间 |
/linear-auth | 与地位相同 |
当您添加您的第一个工作空间时, 它会自动活动 。 添加第二个工作空间会促使您切换 。 之后a /reload 如果配置了两个或两个以上的工作空间,代理将获得一个 linear_switch_workspace 工具,在被询问时可以在它们之间切换.
默认认证解析命令( E)/linear-auth prefer workspace:
- 活动存储的工作空间( 如果配置了任何工作空间)
LINEAR_API_KEY环境变量( 无工作空间活动时返回)- 交互式提示( 请您设置密钥)
环境认证解析命令( E)/linear-auth prefer env:
LINEAR_API_KEY环境变量- 活动存储的工作空间( 当
LINEAR_API_KEY未设置) - 交互式提示( 请您设置密钥)
证书和认证首选项保存于 ~/.pi/agent/extensions/linear/credentials.json。 。 。 .
工具设置
运行 /linear-settings 打开一个覆盖,您可以选择默认输出视图,并按类别或个人启用或禁用工具。 线性结果默认为可被人读取的视图,完整的JSON可以通过 Ctrl+O;如果喜欢,可以将默认翻到全JSON. 被禁用的工具完全从LLM的上下文中去除. 各届会议始终保持优惠.
工具(64个)
在工具 schemas 镜像 Linear 中的 Enum 值,排序键,以及过滤值提示 .
问题
| 工具 | 说明 |
|---|---|
linear_list_issues | 列出过滤器、页码和排序的问题 |
linear_get_issue | 通过标识符(ENG-123)或代号获取完整的发行细节 |
linear_create_issue | 创建一个问题, 并给予充分的问题创造投入支持 |
linear_update_issue | 全面更新一个问题 |
linear_delete_issue | 删除一个问题( 管理员可以永久删除 ) |
linear_archive_issue | 归档或倒置问题 |
linear_unarchive_issue | 恢复存档问题 |
linear_search_issues | 按文本搜索问题, 可选的注释搜索和团队助推 |
问题标签
| 工具 | 说明 |
|---|---|
linear_list_issue_labels | 带有团队过滤器的列表标签 |
linear_create_issue_label | 创建问题标签 |
linear_update_issue_label | 更新问题标签 |
linear_delete_issue_label | 删除问题标签 |
问题状况
| 工具 | 说明 |
|---|---|
linear_list_issue_statuses | 列表工作流程状态( 问题状态) |
问题关系
| 工具 | 说明 |
|---|---|
linear_list_issue_relations | 列表问题关系 |
linear_create_issue_relation | 创建关系( 块、 重复、 关联、 类似) |
linear_update_issue_relation | 更新关系 |
linear_delete_issue_relation | 删除关系 |
项目
| 工具 | 说明 |
|---|---|
linear_list_projects | 列出带有过滤器、页码和排序的工程 |
linear_get_project | 通过 id 获取全部项目细节 |
linear_save_project | 创建或更新工程 |
linear_delete_project | 删除工程 |
linear_archive_project | 归档或丢弃工程 |
linear_unarchive_project | 恢复存档工程 |
列表和搜索结果包括: pageInfo 在用于光标页化的 JSON 输出中。 项目清单结果使用限定范围的摘要选择,以及 linear_get_project 加上项目的节省结果包括项目的减记 content 躯体.
项目标签
| 工具 | 说明 |
|---|---|
linear_list_project_labels | 列出项目标签 |
linear_create_project_label | 创建工程标签 |
linear_update_project_label | 更新工程标签 |
linear_delete_project_label | 删除工程标签 |
项目关系
| 工具 | 说明 |
|---|---|
linear_list_project_relations | 列出项目关系 |
linear_create_project_relation | 创建工程关系 |
linear_update_project_relation | 更新项目关系 |
linear_delete_project_relation | 删除工程关系 |
文档
| 工具 | 说明 |
|---|---|
linear_list_documents | 列出带有过滤器和页码的文档 |
linear_get_document | 通过 id 获取完整的文档细节 |
linear_create_document | 创建文档 |
linear_update_document | 更新文档 |
linear_delete_document | 删除文档 |
linear_unarchive_document | 恢复存档文档 |
评论
| 工具 | 说明 |
|---|---|
linear_list_comments | 带有过滤和页码的列表注释 |
linear_create_comment | 创建一个问题的评论,项目更新等. |
linear_update_comment | 更新评论 |
linear_delete_comment | 删除注释 |
倡议
| 工具 | 说明 |
|---|---|
linear_list_initiatives | 列出带有过滤器、页码和排序的举措 |
linear_get_initiative | 由 id 获得完整倡议细节 |
linear_save_initiative | 创建或更新倡议 |
linear_delete_initiative | 删除主动 |
linear_archive_initiative | 归档倡议 |
linear_unarchive_initiative | 恢复存档的举措 |
里程碑
| 工具 | 说明 |
|---|---|
linear_list_milestones | 列出项目里程碑 |
linear_get_milestone | 由 id 获取里程碑细节 |
linear_save_milestone | 创建或更新里程碑 |
linear_delete_milestone | 删除一个里程碑 |
团队
| 工具 | 说明 |
|---|---|
linear_list_teams | 工作流程状态的列表团队 |
linear_get_team | 由 id 获取团队细节 |
用户
| 工具 | 说明 |
|---|---|
linear_list_users | 列表用户 |
linear_get_user | 通过 id 获取用户细节 |
工作空间
| 工具 | 说明 |
|---|---|
linear_switch_workspace | 切换活动工作空间( 仅可用 2+ 工作空间) |
自定义视图循环( C)
| 工具 | 说明 |
|---|---|
linear_list_views | 列出任意类型的自定义视图( 过滤器、 页标、 顺序) |
linear_get_view | 通过 id 或 sattle 获取自定义视图( 包括工程/ 倡议视图) |
linear_create_view | 创建问题/项目/倡议/更新视图 |
linear_update_view | 由 id 更新自定义视图( 名称、 过滤器、 图标、 颜色、 共享) |
linear_delete_view | 用 id 删除自定义视图 |
linear_set_view_preferences | 为自定义视图设置显示偏好( 分组和列) |
linear_list_cycles | 列表周期(按团队过滤,页标,顺序) |
linear_get_cycle | 由 id 或 sult 获取循环细节 |
linear_create_cycle | 为团队创建循环( startsAt / endAt, 可选名称) |
linear_update_cycle | 按 id 更新周期( 名称、 日期、 完成) |
linear_archive_cycle | 通过 id 来存档循环,并解开其指定问题的联系 |
自定义视图显示设置( 按受让人/ 状态/ 优先级分组, 显示估计/ 日期)
每个用户通过 linear_set_view_preferences; 打开后视图到
见应用的分组.
所需资源
- Pi 交互模式( 设置覆盖使用部件 API)