문제 해결
업데이트 후 정상 기동 확인
Howse 0.40.0은 화면을 다시 불러오거나 렌더러에 오류가 나면 이전의 정상 기동 판정을 무효화합니다. 로컬 앱 교체 시에는 새로 설치한 앱이 현재 작업 화면의 상태 확인에 응답해야 기존 앱 백업을 삭제합니다. 현재 화면이 준비되지 않았다면 복구할 수 있도록 백업을 남깁니다.
앱 창이 뜨기까지 오래 걸려요
Mac에서 앱 창이 늦게 나타난다면 Howse 0.30.0 이상으로 업데이트하세요. 이 버전은 기록이 끝난 컨텍스트의 반복 복구 작업을 줄이고 기동 스캔 성능을 개선했습니다. 실제 기동 시간은 저장된 데이터 양과 실행 환경에 따라 달라집니다.
코어 업데이트는 다음 앱 실행부터 적용됩니다. 진행 중인 작업이 끝난 뒤 앱을 다시 실행하세요. 데이터나 컨텍스트 기록을 삭제할 필요는 없습니다.
에이전트가 실행되지 않아요
- CLI가 없거나 로그인이 필요할 때: 설정 → 에이전트 도구에서 설치 여부, 버전과 로그인 상태를 확인하세요. 안내된 설치 명령을 복사하거나 공식 문서를 열 수 있습니다. macOS에서는 터미널에서 로그인으로 Terminal을 열고, Windows에서는 직접 터미널에서 로그인합니다. 완료 후 다시 확인을 누르세요. 로그인 필요 상태가 확인되면 에이전트 실행을 막지만, 로그인 확인 불가만으로 실행을 막지는 않습니다.
- CLI 버전이 낮을 때: 요구사항의 최소 버전 이상으로 올리세요. 예를 들어 Claude Code CLI는 2.1.260, Codex CLI는 0.154.0 이상이 필요합니다.
protected모드에서 시작하지 않을 때: 필요한 보호 기능을 확인하지 못하면 시작하지 않습니다. CLI 버전을 확인하거나automatic으로 바꿔 보세요.- 실행이
waiting_limit에서 멈췄을 때: 한 요청에서 이어진 실행 수가HOWSE_MAX_CHAIN_TURNS한도에 닿은 것입니다. 기본값 0은 무제한입니다. 한도를 높인 뒤 앱을 다시 시작하면 이어집니다.
실행을 멈추거나 다시 하고 싶어요
| 하고 싶은 것 | 방법 | 결과 |
|---|---|---|
| 스레드의 모든 일을 멈추기 | 관리 목록의 ‘전체 중단’ | 이 스레드의 실행·대기·이어진 협업을 멈춥니다. 다른 스레드는 그대로입니다 |
| 한 작업만 멈추기 | 실행바 또는 관리 목록의 작업 중단 | 그 작업과 거기서 파생된 실행만 멈춥니다 |
| 실패한 실행 다시 하기 | 재시도 / 새 세션으로 재시도 | 같은 작업에 새 실행을 하나 만듭니다. 새 세션은 그 작업의 세션만 바꿉니다 |
| 실패를 목록에서 치우기 | ‘확인했음’ | 확인 목록에서만 빠집니다. 기록은 지워지지 않습니다 |
- 직접 중단한 턴도 재시도할 수 있습니다. 재시도는 새 복구로 시작하며 취소된 형제·자식 실행은 되살리지 않습니다. 대체된 지난 세션의 실행은 재시도할 수 없으니 역할의 현재 세션에서 이어가세요. 보관된 역할이면 먼저 복원하세요.
- 재시도는 이미 일어난 파일 변경 같은 결과를 되돌리지 않습니다.
- 디스크가 가득 차 종료 기록을 저장하지 못하면 끝난 실행이 계속 진행 중으로 보일 수 있습니다. 저장이 가능해지면 Howse가 그 실행을 실패(
run_state_unsaved)로 닫으며, 그 뒤 재시도할 수 있습니다. - 종료 미확인(
termination_unknown) 상태는 자동으로 다시 실행하지 않습니다. 실제로 멈췄는지 확인하고 ‘종료로 확정’한 뒤 재시도하세요.
실패한 턴은 실행 목록에서 관리하고 대화에 중복 중단 카드를 만들지 않습니다. 확인한 과거 오류 카드는 숨깁니다. 정상 종료한 턴은 최종 응답이 비어 있어도 추가 실행이나 생성 메시지 없이 조용히 완료됩니다. Codex의 명시적인 빈 최종 응답은 앞선 진행 문장을 최종 결과로 재사용하지 않습니다. 확인한 오류는 실행 상세에서도 숨깁니다.
메시지가 전달됐는지 모르겠어요
채널 목록의 반응은 재시도·이어진 실행을 포함해 스레드 참여 에이전트별 마지막 실행 상태를 표시합니다. 이어진 실행이 완료되면 해당 에이전트의 채널 반응도 ✔️로 바뀝니다. 스레드 안의 반응은 기존처럼 개별 메시지를 기준으로 표시합니다.
- 👀는 에이전트가 메시지를 받았다는 표시, 💬는 그 메시지로 실제 작업이 시작됐다는 표시입니다. 이해했다는 뜻은 아닙니다.
- 전달 결과가 분명하지 않으면(연결 끊김 등) Howse는 자동으로 다시 보내지 않고 ‘전달 미확인’으로 남깁니다. 중복 실행을 막기 위해서입니다.
앱을 닫으면 어떻게 되나요
- 실행 중인 에이전트는 종료합니다. 아직 시작하지 않은 대기열과 사람·동료의 답을 기다리던 작업은 보존됩니다.
- 다시 열었을 때, 닫기 전에 돌던 실행을 성공이나 취소로 짐작해 처리하지 않습니다.
데이터와 로그는 어디 있나요
- 에이전트와 대화 데이터: 앱 바깥의
userData/data폴더 - 프로젝트의 Howse 기록: 프로젝트 폴더 안
.howse/ - 실행별 기록과 오류 로그:
.howse/run/<실행 ID>/의run.json,events.jsonl,stderr.log - Whyve 기록: 프로젝트 폴더의
context/
포트 충돌
Howse는 앱 안에서 로컬 서버를 띄우고 127.0.0.1에만 연결합니다.
0.46.0의 복구와 실행 제어 수정
원본 메시지가 없는 질문 기록 때문에 기동이 실패하거나 대기 항목 때문에 전체 중단이 실패하면, 설치 파일로 업데이트하고 진행 중인 작업이 끝난 뒤 재시작하세요. 이번 버전은 데이터를 삭제하지 않고 해당 유실 메시지 기록을 건너뜁니다. 이미 열린 중단·재시도 확인창에도 현재 실행 잠금을 적용하며, Codex의 선택 지침이 비어 있거나 생략돼도 native 검증이 실패하지 않도록 고쳤습니다.