에이전트 CLI가 실행되자마자 죽었습니다.
그 이유를 정확히 알려드립니다.
시작조차 하지 못하는 에이전트 CLI는 AI 코딩에서 가장 맥 빠지는 실패입니다: 출력도 없고, 스택 트레이스도 없고, 때로는 프롬프트만 되돌아옵니다. CLI Doctor는 그 순간을 붙잡아 실제로 무슨 일이 있었는지 읽고, 정말 중요한 질문 하나에 답합니다: 무엇이 잘못됐고, 이제 무엇을 해야 하는가.
AgentsRoom이 실행한 정확한 명령어, 어떤 플래그가 어떤 설정에서 왔는지, 그리고 CLI가 포기하기 직전에 출력한 내용을 알고 있습니다. 검색 결과로는 결코 얻을 수 없는 맥락입니다.
실패한 실행, 진짜 에러, 그리고 원인이 된 설정을 짚어 주는 진단.
에이전트 CLI는 빠르게 바뀝니다. 마이너 릴리스에서 플래그가 사라지고, Node를 업그레이드한 뒤 바이너리가 PATH에서 없어지고, 로그인이 만료되고, 샌드박스가 뜨지 않고, 다른 도구용으로 쓴 설정 파일이 잘못 읽힙니다. 사용자 쪽에서 보이는 결과는 늘 같습니다: 프롬프트를 보내도 아무 일도 일어나지 않습니다.
어려운 것은 수정 자체가 아닙니다. 실행 명령어에 들어 있는 스무 가지 중 무엇이 문제인지, 그리고 그것이 앱에서 온 것인지, 프로바이더 설정에서 온 것인지, 3주 전 그 에이전트 하나에만 걸어 둔 덮어쓰기에서 온 것인지, 아니면 CLI 자체가 바뀐 탓인지 알아내는 일이 어렵습니다.
CLI Doctor가 그 간극을 메웁니다. 실제로 실행된 명령어를 기록하고, 모든 플래그에 그것을 주입한 설정을 표시하고, CLI가 출력한 내용을 붙잡아, 이 모두를 구체적인 단계가 붙은 짧은 진단으로 바꿉니다. 확정적 검사가 항상 먼저 돌고 우선권을 가집니다: AI는 앱이 스스로 답할 수 없을 때만 입을 엽니다.
빈 터미널 대신 얻는 것
해독해야 할 스택 트레이스가 아니라, 무엇이 실패했는지 평이한 말로 정리한 요약. 실제 원인을 짚는 한두 문장입니다.
순서가 있는 구체적인 다음 단계. 각 단계는 해당 설정 패널, 재설치 명령어, 재실행으로 가는 바로가기를 달 수 있어서, 옵션이 어디 있는지 찾아 헤맬 일이 없습니다.
플래그 출처 추적: 실행 명령어의 모든 토큰이 어디서 왔는지에 연결되므로, 추측하는 대신 '이 플래그는 설정의 자율 모드에서 옵니다'라고 답할 수 있습니다.
개발 명령어에도 같은 처리를 합니다. 빌드, 테스트, 서버 명령어가 터미널에서 실패하면 클릭 한 번으로 진단을 볼 수 있고, 거기서 곧바로 DevOps 에이전트에게 통째로 넘길 수 있습니다.
진단이 이루어지는 과정
일부러 층을 나눴습니다: 값싸고 확실한 검사가 먼저 돌고, AI는 마지막 수단입니다.
AgentsRoom이 실제 실행을 기록합니다
터미널이 생성되는 그 한 지점에서 전체 명령어가 기록됩니다: 바이너리, 플래그, 모델, 옵션. 이 기록이 나중에 정확한 진단을 가능하게 하며, 휴대폰이나 백로그 티켓에서 시작된 실행까지 에이전트가 시작될 수 있는 모든 경로를 포괄합니다.
확정적 검사가 먼저 답합니다
없는 바이너리, CLI가 더 이상 받지 않는 플래그, 로그인되지 않은 세션, 오래된 버전: 이것들은 이미 알려진 확실한 판정입니다. 배너와 수정 버튼으로 곧바로 답합니다. AI 호출도, 기다림도 없습니다.
의심스러운 실행은 단정하지 않고 확인합니다
실패가 알려진 경우에 해당하지 않으면, AgentsRoom은 처음 몇 초 동안 에러 패턴을 찾은 뒤 터미널에서 실제로 무엇이 돌고 있는지 확인합니다. 단지 기동이 느리거나 첫 실행에서 MCP 서버를 설치하느라 바쁜 CLI는 실패가 아니므로 걸러냅니다.
민감 정보를 가린 컨텍스트로 진단합니다
그다음에야 AI가 개입합니다. 에러 발췌, 정제된 명령어, 플래그 출처 지도를 가지고 말이죠. 시스템 프롬프트, 비밀처럼 보이는 값, 길게 인용된 인자는 무엇이든 전송되기 전에 당신의 머신에서 가려집니다.
요약과 단계를 받고, 결정은 당신이 합니다
진단은 터미널에 표시됩니다. 무엇도 대신 실행되지 않습니다: 액션 버튼은 해당 설정을 열거나, 재실행을 제안하거나, 설치 명령어를 보여줄 뿐이고, 그것을 누르는 사람은 언제나 당신입니다.
답이 나오는 곳
CLI Doctor는 당신이 설정하는 곳과 같은 곳을 읽습니다. 실행 실패의 대부분은 이 세 곳에서 나옵니다.
당연히 지켜야 할 선 위에서 만들었습니다
FAQ
CLI Doctor는 어떤 에이전트 CLI를 지원하나요?
전부입니다. 실행 기록은 AgentsRoom이 터미널을 생성하는 단 하나의 지점에서 기록되므로 Claude Code, Codex CLI, GitHub Copilot CLI, Antigravity CLI, OpenCode, Aider, Grok Build, Mistral Vibe, Kimi Code가 모두 포함되고, 모바일 컴패니언이나 백로그 티켓에서 시작한 에이전트도 마찬가지입니다.
내 터미널 출력을 서버로 보내나요?
실행 에러에서 민감 정보를 가린 발췌, 정제된 실행 명령어, 플래그 출처 지도를 보내며, 실제로 진단이 생성될 때만 보냅니다. 시스템 프롬프트, 비밀처럼 보이는 환경 변수 값, 길게 인용된 인자는 그전에 당신의 머신에서 제거됩니다. 소스 코드는 절대 포함되지 않으며, 자동 진단은 설정의 Privacy and data에서 완전히 끌 수 있습니다.
명령어를 실행하거나 설정을 스스로 바꾸나요?
아니요. 각 단계는 알맞은 설정 패널을 여는 바로가기를 달거나, 에이전트 재실행을 제안하거나, 복사할 설치 명령어를 보여줄 수 있습니다. 무언가를 실행하는 것은 언제나 당신의 행동입니다.
플래그 출처 추적이란 구체적으로 무엇인가요?
AgentsRoom은 여러 층을 겹쳐 실행 명령어를 조립합니다: 프로바이더 기본값, 자율 모드, 당신이 고른 모델, 추론 강도, 에이전트별 CLI 덮어쓰기 등. 플래그 출처 추적은 최종 명령어의 각 토큰에 그것을 넣은 층을 표시하므로, 진단이 플래그를 추상적으로 설명하는 대신 정확히 어떤 스위치를 바꿔야 하는지 짚을 수 있습니다.
에러가 날 때마다 뜨나요?
아니요, 의도적으로 그렇습니다. 에이전트 터미널에서는 실패한 실행 한 건당 한 번만, 그리고 실패가 확인됐을 때만 뜹니다: 단지 시작이 느리거나 첫 실행에서 MCP 서버를 설치하느라 바쁜 CLI는 진단하지 않고 걸러냅니다. 개발 명령어 터미널에서는 클릭할 때만 진단합니다. 실패하는 watch 루프는 에러를 계속 다시 내보내기 때문입니다.
무료 요금제에서도 쓸 수 있나요?
네, 월 사용량 한도 안에서 가능합니다. Plus는 한도를 늘리고 Pro는 사실상 무제한입니다. 없는 바이너리나 거부된 플래그처럼 가장 흔한 실패를 처리하는 확정적 판정은 아예 사용량에 포함되지 않습니다: 모델을 호출하지 않기 때문입니다.
SSH로 원격 머신에서 도는 에이전트는 어떻게 되나요?
이쪽에서 전경 프로세스는 SSH 클라이언트 자신이므로, 원격 CLI가 죽어도 여기서는 정상으로 보이고 해당 건은 건너뜁니다. 의도적인 절충입니다: 자신 있게 틀린 진단보다는 놓친 진단이 낫습니다. 확정적 검사는 연결 반대편에서 그대로 적용됩니다.
에러를 챗봇에 붙여넣는 것과 무엇이 다른가요?
챗봇은 당신이 붙여넣은 메시지만 봅니다. CLI Doctor는 실제로 실행된 명령어, 그 안의 모든 플래그의 출처, 사용 중인 프로바이더와 모델, 프로세스 상태까지 가지고 있으며, 그중 무엇도 당신이 직접 모아 줄 필요가 없습니다. 일반론적인 답을 바꿔야 할 설정의 이름으로 바꿔 놓는 것이 바로 그 맥락입니다.
함께 쓰면 좋은 기능
멀티 프로바이더
AgentsRoom은 9개 AI 코딩 프로바이더를 지원합니다: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code. 에이전트별로 다른 프로바이더를 할당하고, 대화 중 프로바이더를 전환하며, 자동 핸드오프로 컨텍스트를 유지합니다. 최고의 멀티 프로바이더 AI 코딩 도구.
상태 추적
각 Claude Code 에이전트의 상태를 한눈에 추적하세요. 사고 중, 완료, 유휴, 입력 대기 상태에 대한 색상 코드 인디케이터. 경과 타이머, 활동 요약, 프로젝트별 카운터.
개발 터미널
빌드, 테스트, 개발 서버를 에이전트와 같은 창에서 실행하세요. 긴 명령어가 끝나면 벨이 울리고, 실패하면 진단이 따라옵니다.
에이전트와 터미널 복원
앱을 다시 열면 에이전트와 개발 터미널이 떠났던 자리 그대로 있고, 이전 CLI 대화를 이어받을지 선택할 수 있습니다.
AI 커밋 메시지
AgentsRoom에 내장된 AI 커밋 메시지 생성기. 커밋 필드에서 반짝임을 클릭하면 실제 git diff를 읽고 Conventional Commits 형식으로 깔끔한 커밋 메시지를 작성합니다. 대략적인 초안을 입력하면 재작성됩니다. 팀의 형식 규칙이 모든 생성에 적용됩니다.
에이전트 제안
어떤 AI 에이전트를 사용해야 할지 모르겠나요? 작업을 간단한 언어로 설명하면 AgentsRoom이 올바른 에이전트를 제안합니다: 귀하의 방에서, 14개의 내장 역할 또는 260명 이상의 카탈로그 전문가 중에서, 한 줄의 이유와 함께. 한 번의 클릭으로 작업이 할당됩니다.
에이전트가 왜 안 뜨는지 더는 추측하지 마세요
AgentsRoom이 실행을 읽고, 원인을 짚고, 해결 방법을 건네줍니다. macOS, Windows, Linux에서 무료로 다운로드하세요.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.
버그와 요청을 공개 백로그로 바로 보내세요.
AgentsRoom의 실제 모습.