문제 해결

onemind가 예상대로 작동하지 않는 경우 먼저 onemind version을 실행하여 설치를 확인한 다음 아래에서 해당 항목을 찾으세요.

`onemind`을(를) 찾을 수 없습니다

macOS/Linux: ~/.local/bin이 PATH에 있는지 확인하고 새 터미널을 엽니다.
설치 프로그램을 다시 실행하여 바이너리 및 서비스 등록을 복구하세요.

브라우저 인증이 만료되었거나 거부되었습니다

Escape 키를 누르고 로그인을 다시 선택한 다음 브라우저에서 새 요청을 승인하세요. 거부되거나 만료된 요청은 재사용할 수 없습니다.

onemind가 서버에 연결할 수 없습니다

onemind session status를 실행하여 현재 사용 중인 API URL을 확인하세요. 변경하려면 터미널에서 onemind server https://your-server를 실행하세요. https:// URL만 허용되며, 일반 http://는 로컬 루프백 주소에만 허용됩니다. 서버를 변경하면 이전 자격 증명이 제거됩니다. onemind를 실행하고 새 서버에 로그인을 선택하세요.

동기화에 연결된 로컬 프로젝트가 없다고 표시됨

onemind sync는 활성 binding이 없을 때 다음 메시지 중 하나를 출력합니다.

"Sync has not started. Detect an AI tool with 'onemind project TOOL'" — onemind project TOOL /path/to/repo를 실행하여 저장소를 감지한 다음 동기화 설정을 완료하여 일반 Project에 바인딩하고 다시 onemind sync를 실행하세요.
"Sync setup is saved, but local access is blocked" — 경로가 동기화 설정에 있지만 프로세스가 디렉터리를 읽거나 쓸 수 없습니다. 필요한 파일 시스템 권한을 부여한 다음 onemind sync를 다시 실행하세요.
"Sync setup is saved, but the local target is unavailable" — 바인딩된 경로가 없거나 AI 도구가 실행되고 있지 않습니다. AI 도구를 시작하거나 복구하고 필요한 경우 경로를 복원한 다음 onemind sync를 다시 실행하세요.
"Select this device, target, and Project at …" — 장치 또는 대상이 동기화 설정에서 활성화되지 않았습니다. 동기화 설정을 열고 이 장치와 대상에 대한 동기화를 활성화한 다음 onemind sync를 다시 실행하세요.

동기화가 `AGENTS.md`를 거부합니다

onemind는 관리되는 마커의 형식이 잘못되었거나 모호한 경우 중지됩니다. 유효한 마커 쌍을 복원하거나, onemind mind restore pre-onemind --yes로 onemind 도입 전 agent 프롬프트로 되돌리거나, .one-mind/AGENTS.md.backup을 라이브 지침 파일에 수동 복사하세요. 수동 편집 시 관리 블록 외부 콘텐츠를 모두 보존하세요.

첫 Mind 동기화 되돌리기

첫 Mind 동기화 이후 복구는 Matrix Mind 버전이 아니라, onemind가 인계하기 전 상태인 지침 파일에 있던 이전 로컬 agent 프롬프트로 돌아가는 것을 의미합니다.

onemind mind backups --path /path/to/destination
onemind mind restore pre-onemind --path /path/to/destination --file AGENTS.md --yes

전역 도구 홈의 경우 --path에 해당 도구 루트를 지정하세요(예: ~/.codex와 --file AGENTS.md, 또는 ~/.claude와 --file CLAUDE.md). ~/.codex나 ~/.claude를 직접 수정하는 것은 최후 수단의 복구 단계입니다. 항상 백업 복사본에서 시작하고 관리 블록 외부의 콘텐츠를 보존하세요.

백그라운드 서비스가 실행되고 있지 않습니다

onemind service status를 실행합니다. 실패하면 onemind service install을 시도한 후 상태를 다시 확인하세요. Linux에서는 사용자 systemd 세션과 Secret Service/키링을 사용할 수 있는지 확인하세요.

보안 자격 증명 저장소를 사용할 수 없습니다

onemind는 일반 텍스트 자격 증명으로 대체되지 않습니다. 운영 체제의 자격 증명 서비스를 시작하거나 잠금 해제한 다음 CLI를 다시 열고 다시 로그인하세요.

보안 저장소에서 세션을 찾을 수 없습니다

CLI가 "OneMind session not found in secure storage"를 보고하면 저장된 자격 증명이 삭제되었거나 기록된 적이 없는 것입니다. onemind를 실행하고 로그인을 선택하여 새 세션을 만드세요.

OneMind 버전 다운그레이드 거부됨

동기화가 "refusing OneMind version regression from vN to vN"으로 중지되면 클라우드 패키지에 현재 지침 파일을 소유한 CLI보다 오래된 버전이 작성한 관리 블록이 포함된 것입니다. 일반적으로 동기화가 실행된 후 CLI가 다운그레이드되었음을 의미합니다. CLI 빠른 시작의 공식 설치 프로그램을 사용하여 현재 릴리스를 재설치한 다음 onemind sync를 다시 실행하세요.

제안 실패

onemind propose는 다음 메시지 중 하나와 함께 실패할 수 있습니다.

"choose an exact Project target in OneMind before proposing" — 현재 디렉터리에 활성 Project binding이 없습니다. 제안하기 전에 onemind project TOOL /path/to/repo를 실행하고 동기화 설정을 완료하세요.
"proposal is queued locally; exact Project upload is not active" — 제안이 로컬에 저장되었지만 Project binding이 완전히 활성화되지 않아 업로드가 차단되었습니다. 동기화 설정을 완료한 다음 onemind sync를 실행하여 대기 중인 제안을 플러시하세요.

Matrix 패널의 권한 요청이 만료됨으로 표시됩니다

도구 요청은 제때 아무도 응답하지 않으면 만료됩니다. 작업 세부 패널에서 요청이 만료됨 또는 취소됨으로 표시되면 도구가 이를 거부로 처리한 것이며, 해당 작업 없이 실행이 계속되었을 수 있습니다. 후속 메시지를 보내기 전에 실행 상태와 출력을 확인하세요. 여전히 필요한 경우 도구가 새 요청을 제기합니다.

동기화에 복구 필요 또는 확인 기한 초과가 표시됩니다

동기화 활동에서 동기화 세부 정보를 열고 상태 아래의 설명을 읽으세요.

복구 필요: 동기화를 안전하게 확인하지 못했습니다. 대상 기기를 열고 화면의 복구 단계를 따르세요. 기기가 연결 가능하고 로그인된 상태여야 합니다.

롤백됨: 기기가 이미 이전 파일을 복원했습니다. 동기화가 아직 필요하지 않다면 추가 조치는 필요하지 않습니다.

확인 기한 초과: 기기가 제때 결과를 확인하지 못했습니다. 대상 기기가 온라인 상태이고 로그인되어 있으며 백그라운드 서비스가 실행 중인지 확인하고, 동기화 세부 정보에서 복구 상태를 확인하세요.

Matrix 작업이 기기를 기다리는 상태로 유지됩니다

네이티브 AI 도구에 할당된 작업은 할당된 도구의 기기가 실행을 아직 할당받지 않은 경우 "Waiting for [device] to pick this up"이 표시됩니다. 상태에서 기기가 오프라인으로 표시되면 작업을 계속 진행하기 위해 다른 기기나 도구로 재할당하세요. 재할당 단계는 Matrix 대화를 참고하세요.

작업 대화가 한도에 도달했습니다

작성기는 대화를 더 이상 계속할 수 없을 때 두 가지 메시지 중 하나를 표시합니다.

(작업 대화): "This task conversation has reached its file or context limit." 현재 초안에서 파일을 제거하거나 메시지를 줄이세요. 이전 기록은 보존됩니다.
(onemind 에이전트): "At 100% onemind can't reply. Start a new chat to continue." 새 onemind 에이전트 대화를 시작하세요.

자세한 내용은 Matrix 대화 및 onemind 에이전트를 참고하세요.

Mind가 읽기 전용입니다

Mind 편집 및 제출 작업이 차단되고 패널에 Mind 변경 사항이 일시적으로 읽기 전용임이 표시되면 팀의 활성 멤버 수가 요금제의 좌석 한도를 초과한 것입니다. 멤버를 제거하여 한도 이내로 줄이거나, 현재 멤버십을 커버할 좌석을 추가하거나, 요금제를 업그레이드하면 쓰기 권한이 복원됩니다. 좌석 및 요금제 옵션은 요금제 및 결제를 참고하세요.

결제가 아직 확인 중입니다

결제를 완료한 후 서버가 Paddle의 검증된 확인을 기다리는 동안 제품에 확인 중 상태가 표시됩니다. 일반적으로 몇 초 내에 해결됩니다. 몇 분이 지나도 확인 중 상태가 지속되면 페이지를 새로 고침하거나 로그아웃 후 다시 로그인하세요. 요금제가 활성화되지 않으면 지원에서 지원팀에 문의하세요. 결제 세부 정보는 요금제 및 결제를 참고하세요.