用途:通过 yt CLI 与 YouTrack 实例交互,管理问题、敏捷看板、项目和用户,命令默认以 JSON 输出便于解析。
主要能力:支持问题搜索(如 project、#Unresolved、assignee、priority、tag 等查询语法)、单条问题获取、创建、更新(含自定义字段、敏捷看板、父任务)、评论列表与添加,以及项目列表、敏捷看板列表、获取当前认证用户。
使用方式:先配置凭据,保存到 ~/.config/yt-cli/config.json:yt setup --url https://your-instance.youtrack.cloud --token <permanent-api-token>;也可用环境变量 YOUTRACK_BASE_URL 和 YOUTRACK_TOKEN(优先于配置文件)。常用命令:yt issue search "<query>" --format json --pretty;yt issue get PROJ-123 --format json --pretty;yt issue create --project PROJ --summary "..." --description "..." --format json;yt issue update PROJ-123 --field "Priority=Critical" --field "State=In Progress" --format json;yt issue comment PROJ-123 --text "..." --format json。多行文本用转义换行符 \n 保留段落与列表格式。
输出与分页:--format json 或 text,--pretty 缩进;退出码 0 成功、1 错误,错误以 JSON 写 stderr;搜索用 --top 和 --skip 分页。
适用场景:在智能体或脚本中按查询语法检索问题、批量字段更新、加入看板或设置子任务、记录评论。
限制:需有效的 YouTrack 实例与永久 API token;配置来源单一;具体 API 权限和版本兼容性资料未提供,收费或价格信息暂未提供。