What it does
Group failed GitHub Actions runs by root cause; separate real regressions from flaky failures.
- Connects 내 컴퓨터에서 실행
- Account or key No key needed
- Category 개발자 도구
함께 쓰기
이런 작업을 AI에게 가르치는 Skill, 이것과 함께 쓸 수 있습니다
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
이 순위인 이유
목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다
| 인기 | 0/80 | GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20 |
|---|---|---|
| 최신성 | 12/12 | 30일 안에 릴리스나 코드 변경이 있으면 만점 |
| 응답 중 | 0/8 | 마지막 점검 때 클라우드 엔드포인트가 응답 |
| 사용 점수 | 12/100 |
품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)
설치
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
한 문장으로 AI에게 설치 맡기기
ci-triage 설치해 줘. https://mcp.popnx.com/i/wjddidi-1-ci-triage.md 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · AI가 읽을 전체 내용 보기
검사 3/3 통과 · 내 컴퓨터에서 실행돼요 · ✓ 명령 확인 2026년 11월 16일
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
AI에게 설치 맡기기
이 메시지를 Claude 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude에 MCP server ci-triage을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "ci-triage": { "command": "npx", "args": [ "-y", "ci-triage-cli" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 ci-triage의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
컴퓨터용 Claude 앱 설정 파일 열기
SettingsDeveloperEdit Config
이 설정을 붙여 넣고 저장
{ "mcpServers": { "ci-triage": { "command": "npx", "args": [ "-y", "ci-triage-cli" ] } } }Claude를 끄고 다시 열기
해 보기
ci-triage을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 ci-triage을 쓰고 있다고 하거나 답에 ci-triage 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 아직 ci-triage에 연결할 수 없어요
ci-triage는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요
대신 이렇게 할 수 있어요
A · ci-triage에 연결되는 앱 쓰기
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
B · 개발자 도구에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 Claude Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude Code에 MCP server ci-triage을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): claude mcp add --scope user ci-triage -- npx -y ci-triage-cli 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 ci-triage의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
터미널 열기
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
이 명령을 붙여 넣고 Enter
claude mcp add --scope user ci-triage -- npx -y ci-triage-cliClaude Code에서 /mcp 입력
ci-triage이 목록에 있고 연결됨으로 보이면 돼요
해 보기
ci-triage을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 ci-triage을 쓰고 있다고 하거나 답에 ci-triage 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 Cursor 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Cursor에 MCP server ci-triage을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "ci-triage": { "command": "npx", "args": [ "-y", "ci-triage-cli" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 ci-triage의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
Cursor에서 AI 채팅을 Agent 모드로 열기
해 보기
ci-triage을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 ci-triage을 쓰고 있다고 하거나 답에 ci-triage 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 VS Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 VS Code에 MCP server ci-triage을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "servers": { "ci-triage": { "type": "stdio", "command": "npx", "args": [ "-y", "ci-triage-cli" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 ci-triage의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
VS Code에서 AI 채팅을 Agent 모드로 열기
해 보기
ci-triage을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 ci-triage을 쓰고 있다고 하거나 답에 ci-triage 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
개발자용: 터미널 명령과 JSON 설정
컴퓨터에 설치
Claude Code
claude mcp add --scope user ci-triage -- npx -y ci-triage-cliClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"ci-triage": {
"command": "npx",
"args": [
"-y",
"ci-triage-cli"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"ci-triage": {
"command": "npx",
"args": [
"-y",
"ci-triage-cli"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"ci-triage": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ci-triage-cli"
]
}
}
}이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
한눈에 보기
- 주간 다운로드i
- npm/PyPI에 없음
- 연결 방식
- 내 컴퓨터에서 실행
- 최신 버전i
- 0.1.2
- 레지스트리 공개i
- 2026년 11월 16일
- 코드 마지막 변경i
- 2026년 11월 19일
- 제작자
- WJDdidi-1
- 패키지
npm: ci-triage-cli- 웹사이트
- github.com
- 레지스트리 상태
- 활성
어떤 앱에서 쓸 수 있나요
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
할 수 있는 일
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
기본 점검i
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검
- ✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 WJDdidi-1 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
- ✓ 통과
계속 관리되고 있음
코드 마지막 변경: 오늘
- ✓ 통과
라이선스 있음
Apache-2.0 사용
- – 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
- – 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
- … 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
공개된 취약점 (OSV.dev)
아직 확인하지 않았습니다
제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/servers/wjddidi-1-ci-triage)토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
사용자 리뷰
아직 리뷰가 없어요
개발자 도구 카테고리의 다른 서버와 비교i
- 이 카테고리의 다른 서버 6182개 중 0%보다 스타가 많아요
- 이 카테고리의 다른 서버 6182개 중 91%보다 최근에 레지스트리에 공개됐어요
- 기본 점검 결과가 이 카테고리의 다른 서버 6182개 중 99%와 같거나 더 좋아요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
자주 묻는 질문
ci-triage, 안전한가요?
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
어떤 키나 코드가 필요한가요?
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
아직 관리되고 있나요?
GitHub 저장소는 마지막으로 오늘 변경됐고, 최신 버전(0.1.2)은 3일 전 레지스트리에 올라왔어요.
어떤 앱에서 쓸 수 있나요?
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.
대신 쓸 수 있는 건 뭐가 있나요?
같은 카테고리에는: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
비슷하게 동작하는 다른 것
같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 이 항목 ci-triage | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 실행 위치 | 컴퓨터에 설치 필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드 또는 컴퓨터 설치 모두 가능 |
| 키 필요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| Claude에서 +로 추가 | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 아니요 |
| 기본 점검 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 라이선스 | Apache-2.0 | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 가격 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 |
제작자의 README
README 열기
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
ci-triage
CI is red. Which failure matters, and is it a real regression or just flaky?
ci-triage answers that in one page: it fetches a repo's recent failed GitHub Actions runs, reads the failed job logs, groups failures by root cause, and tells you which ones are real regressions and which are flaky — so you fix the one thing that matters instead of reading thousands of log lines by hand.
Before / after
Before: CI is red on 3 runs. You open each run, find the failed job, scroll through the log, and try to remember whether you saw this error yesterday.
After:
$ ci-triage acme/widgets
ci-triage — acme/widgets Window: 2 recent runs listed, 2 failed examined Root causes: 1 (1 real, 0 flaky)
#1 test · 2 runs · real regression FAIL src/components/Button.test.tsx 3 test-runner failure signals in the error lines. fails on every recent run — looks like a real regression, not flakiness. first seen 2026-11-12 10:00 · last seen 2026-11-12 14:03 runs: #2 (test), #1 (test) evidence: FAIL src/components/Button.test.tsx ● Button › renders the disabled state expect(received).toBe(expected) // Object.is equality
Overall: 1 root cause — 1 real regression, 0 flaky
One root cause, two runs, real regression, with the failing test named. That is the whole triage.
Install
npm install -g ci-triage-cli
Requires Node 18 or newer. No other dependencies — pure Node.js standard library.
Rather not install it by hand? Paste this to your coding agent: "Install ci-triage (npm install -g ci-triage-cli if it's not on PATH), then run ci-triage --skill-generate so you triage red CI before reading any log."
Use
ci-triage <owner/repo> # triage the last 10 failed runs
ci-triage acme/widgets --runs 3 # fewer runs, faster ci-triage acme/widgets --workflow ci.yml --branch main ci-triage acme/widgets --json # machine-readable output ci-triage acme/widgets --top 3 # show only the top 3 root causes ci-triage acme/widgets --report triage.md # Markdown report to paste into a PR, an issue, or an agent chat ci-triage acme/widgets --annotations # also emit ::error:: / ::warning:: annotations for GitHub Actions
--report writes the same Markdown the GitHub Action puts in the Step Summary — the ranked report, not machine JSON — so the file, the summary, and the terminal output never disagree. Under --json the confirmation goes to stderr, so stdout stays parseable. --annotations does the same job for the run's annotations panel: one workflow-command line per root cause (::error:: for a real regression, ::warning:: for flaky or unknown), capped at 10 per level — GitHub's own limit. When the log names the failing file with a line (src/utils/format.ts:18:7, a Jest stack frame), the annotation is pinned to that file and line, so it also shows in the PR's changed-files view, one click from the code; a bare filename, an absolute runner path, or a node_modules frame stays unpinned rather than pointing at the wrong file. Under --json the lines go to stderr, so stdout stays parseable.
Exit codes: 0 when no failed job turned up, or when every failure in the window is a recorded known failure; 1 when failures were found (including failures whose logs could not be read — the repo is not clean), 2 for a usage error or an API error.
Known failures
A failure the team already knows about and is living with should not re-alert as a real regression on every triage — it drowns the new regressions. Record it once, then triage against the record:
ci-triage acme/widgets --write-known .ci-triage-known-failures.json
ci-triage acme/widgets --known .ci-triage-known-failures.json
--write-known records the current clusters and merges with entries already in the file; --known marks the clusters the file covers as known failures instead of new regressions. Matching is by failure signature, so a known failure stays known when it moves to another workflow. The file holds signature hashes and headlines only, so it is safe to commit. A recorded failure that stops appearing is listed as "not seen in this window (possibly fixed)" — remove it from the file if it is fixed. The method is Playwright's test.fail(): a known bug that is still exercised, expected to fail, and noticed when it stops failing. In the Action, a triage with only known failures passes the step instead of failing it.
Shell completion for bash, zsh and fish: ci-triage completion bash prints a completion script generated from the same option list the CLI parses, so it can never suggest a flag the CLI rejects. Install it with, e.g. ci-triage completion bash > ~/.bash_completion.d/ci-triage, or source <(ci-triage completion bash) for a one-off session. Mistyped a flag anyway? The CLI suggests the closest match (Did you mean ...?) instead of a bare error.
Auth — read this first
Set GH_TOKEN (or GITHUB_TOKEN). Without a token the triage can list the failed runs and jobs, but it cannot download their logs: GitHub does not allow anonymous job-log downloads, even for public repos. The first refused download stops the rest — the refusal applies to every job, so the triage lists all the failed jobs with the same reason instead of spending the anonymous budget on downloads known to fail. Without a token you get an honest report instead of a triage:
No clusters: 9 failed jobs found, but their logs could not be read.
Failed jobs #41–#49 · 2026-11-14 12:03 – 2026-11-15 08:41 Reason: downloading this job log needs a GitHub token (403) — GitHub does not allow anonymous log downloads; set GH_TOKEN or run gh auth login Overall: UNKNOWN — 9 failed jobs found, logs unreadable
With a token you get 5,000 API requests per hour. gh auth login works too when the GitHub CLI is logged in.
ci-triage doctor checks the setup itself before you triage anything: Node version, ci-triage on PATH, the home directory --skill-generate writes into, installed skills (and whether their frontmatter is valid — a broken one silently never triggers), whether a token is available, and whether the GitHub API answers (one cheap call, which also reports the rate-limit budget left this hour). It is read-only — it changes nothing — and every failure comes with a copy-paste fix. Warnings are for optional wiring (a missing skill, no token, an unreachable API); only failures make it exit 1. --json gives the same checklist as data. The method is Claude Code's claude doctor: one command that answers "is my setup healthy?" instead of debugging each piece by hand.
How it decides
- Signature: the error lines of a failed job, with timestamps, ANSI codes, file paths, hashes, versions and counts stripped — so the same failure on two runs has the same signature even when the paths and timings differ.
- Clustering: failures with the same signature are one root cause, ranked by how many runs they hit.
- Classification: each cluster is a test failure, a build failure, or an infra failure (timeouts and the like), from the error lines themselves.
- Flaky vs real: a cluster is flaky when the same commit passed on a later run, or when failures and successes alternate in the window. Failing on every recent run is a real regression.
- Known failures: a cluster whose signature is recorded in a known-failures file (
--known) is reported as a known failure, not a new regression. A triage with only known failures exits 0. - Regression window: a real regression names the last green run and the first red one ("broke between #1 (ccc0000) and #2 (aaa0000)");
git log ..lists the suspect commits. The method is git bisect's — the good and bad endpoints — answered from the run history instead of a binary search, since CI already ran every commit's build. The report also lists the files that changed between those two commits (GitHub's compare endpoint, capped at 10 with a count of the rest), so the fix starts from the suspect files, not just the suspect range; a compare that fails leaves the window line as it was. A flaky failure has no window; when no passing run precedes the first failure, the report says the regression predates the runs listed.
Logs expire: GitHub keeps job logs for 90 days. A failed job whose log is gone is recorded, not fatal.
For agents
ci-triage --mcp # stdio MCP server: triage_repo, triage_log
ci-triage --skill-generate # write a SKILL.md for this project (never overwrites) and a short section in AGENTS.md ci-triage --skill-generate --agents # same skill, in .agents/skills/ — the shared location Gemini CLI and Codex discover skills from
triage_log classifies a pasted log without touching the network — useful when you already have the log open. Both tools return the same JSON the CLI's --json produces, as the text block and again as structuredContent, the MCP structured-output channel (each tool declares a loose outputSchema: { type: 'object' }; error results carry none), so a calling application can read the fields typed instead of parsing the text.
The MCP server also serves one prompt, triage_ci (prompts/list / prompts/get): the one-shot "what broke in CI and what do I fix first?" workflow — call triage_repo with the repo (and workflow, if given), report the root causes ranked real regressions first, then flaky, then unknown, then known failures, and do not re-run or fix anything without the user agreeing — for MCP clients that let the user pick a prompt instead of typing a request. The method is FastMCP's: prompts are the third MCP primitive, the user-invoked template next to tools and resources. triage_repo also takes knownFile: a known-failures file to mark recorded clusters as known instead of new regressions.
Claude Code users can install the skill without installing the CLI first: /plugin marketplace add WJDdidi-1/ci-triage, then /plugin install ci-triage@ci-triage. The skill lives in this repo at skills/ci-triage/SKILL.md, so skill indexes can find it too.
Claude Desktop: the repo ships a manifest.json (MCPB, the renamed DXT format) — pack it with npx @anthropic-ai/mcpb pack and drag the .mcpb file onto Settings → Extensions. The bundle is just the server (zero dependencies, so there are no node_modules to bundle), and .mcpbignore keeps tests and tooling out of it.
GitHub Action
Use it from a workflow (it needs a token with actions:read on the repo; the workflow's own GITHUB_TOKEN can read its own repo's runs):
jobs:
triage: runs-on: ubuntu-latest steps:
- uses: WJDdidi-1/ci-triage@main with: repo: ${{ github.repository }} runs: 10
The action fails the job when it finds root causes, so the triage report lands in the log and in the run's Step Summary. Add --annotations to surface each root cause on the run's annotations panel too — one ::error:: per real regression, ::warning:: for flaky, unknown, or known — so the cause is visible without opening the log at all. It needs no token and no file, and it works on fork PRs, where the Checks API cannot write; the same trick reviewdog's github-annotations reporter uses. Locally it is a no-op: the lines only become annotations when a step runs in GitHub Actions.
How fast is it
On a real repo with 3 failed runs and 9 failed jobs, the triage took about 8 seconds wall-clock — against opening 9 job logs by hand and reading them. The clustering and classification themselves run in milliseconds; the time is the GitHub API round-trips.
Development
npm test # node:test, no extra dependencies, run serially
node scripts/bump-version.mjs # bump every version pin at once
Coverage uses Node's built-in runner (Node 22+ only — the suite itself runs on Node 18+): `node --test --test-concurrency=1 --experimental-test-coverage --test-coverage-include='lib/**/*.mjs' --test-coverag