문제 해결
에이전트가 실행되지 않아요
- CLI가 없거나 로그인하지 않았을 때: 앱은 열리지만 해당 프로바이더의 에이전트는 시작하지 않습니다. 화면에 실행 가능 여부가 표시됩니다. CLI를 설치하고 로그인한 뒤 다시 시도하세요.
- CLI 버전이 낮을 때: 요구사항의 최소 버전 이상으로 올리세요. 예를 들어 Codex CLI는 0.154.0, Claude Code CLI는 2.1.260 이상이 필요합니다.
protected모드에서 시작하지 않을 때: 필요한 보호 기능을 확인하지 못하면 시작하지 않습니다. CLI 버전을 확인하거나automatic으로 바꿔 보세요.- 실행이
waiting_limit에서 멈췄을 때: 한 요청에서 이어진 실행 수가HOWSE_MAX_CHAIN_TURNS한도에 닿은 것입니다. 기본값 0은 무제한입니다. 한도를 높인 뒤 앱을 다시 시작하면 이어집니다.
실행을 멈추거나 다시 하고 싶어요
| 하고 싶은 것 | 방법 | 결과 |
|---|---|---|
| 스레드의 모든 일을 멈추기 | 스레드 ‘전체 중지’ | 이 스레드의 실행·대기·이어진 협업을 멈춥니다. 다른 스레드는 그대로입니다 |
| 한 작업만 멈추기 | 작업 ‘이 작업 중지’ | 그 작업과 거기서 파생된 실행만 멈춥니다 |
| 실패한 실행 다시 하기 | 재시도 / 새 세션으로 재시도 | 같은 작업에 새 실행을 하나 만듭니다. 새 세션은 그 작업의 세션만 바꿉니다 |
| 실패를 목록에서 치우기 | ‘확인했음’ | 확인 목록에서만 빠집니다. 기록은 지워지지 않습니다 |
- 멈춘 작업은 재시도로 되살아나지 않습니다. 다시 하려면 원래 메시지를 골라 새 작업으로 전달하세요.
- 재시도는 이미 일어난 파일 변경 같은 결과를 되돌리지 않습니다.
- 종료 미확인(
termination_unknown) 상태는 자동으로 다시 실행하지 않습니다. 실제로 멈췄는지 확인하고 ‘종료로 확정’한 뒤 재시도하세요.
메시지가 전달됐는지 모르겠어요
- 👀는 에이전트가 메시지를 받았다는 표시, 💬는 그 메시지로 실제 작업이 시작됐다는 표시입니다. 이해했다는 뜻은 아닙니다.
- 전달 결과가 분명하지 않으면(연결 끊김 등) Howse는 자동으로 다시 보내지 않고 ‘전달 미확인’으로 남깁니다. 중복 실행을 막기 위해서입니다.
앱을 닫으면 어떻게 되나요
- 실행 중인 에이전트는 종료합니다. 아직 시작하지 않은 대기열과 사람·동료의 답을 기다리던 작업은 보존됩니다.
- 다시 열었을 때, 닫기 전에 돌던 실행을 성공이나 취소로 짐작해 처리하지 않습니다.
데이터와 로그는 어디 있나요
- 에이전트와 대화 데이터: 앱 바깥의
userData/data폴더 - 프로젝트의 Howse 기록: 프로젝트 폴더 안
.howse/ - 실행별 기록과 오류 로그:
.howse/run/<실행 ID>/의run.json,events.jsonl,stderr.log - Whyve 기록: 프로젝트 폴더의
context/
포트 충돌
Howse는 앱 안에서 로컬 서버를 띄우고 127.0.0.1에만 연결합니다.