Dropstone CLI

문제 해결 가이드

Dropstone CLI 문제를 체계적으로 진단하세요. 올바른 정보를 수집하고, 로그를 찾고, 지원팀에 문의하기 전에 원인을 격리하세요.

대부분의 문제는 네 가지 중 하나로 귀결됩니다: 오래된 빌드, 오래된 캐시, 잘못된 자격 증명, 또는 네트워크 문제입니다. 이 페이지는 이들을 확인해야 하는 순서와, 그중 어느 것도 원인이 아닐 때 수집해야 할 항목을 다룹니다.

특정 오류 메시지에 대해서는 일반적인 문제부터 시작하세요. 런타임 동작 및 기능별 디버깅은 CLI 문제 해결을 참조하세요.

먼저 시도할 세 가지

다른 것보다 먼저 이 명령들을 실행하세요. 이들은 놀라울 정도로 많은 보고 사례를 해결합니다.

# 1. 최신 버전으로 업데이트
dropstone update

# 2. Dropstone이 실제로 무엇을 하는지 확인
dropstone --log-level DEBUG --print-logs
  1. 세션 중간에 실패가 발생하고 원인이 불분명하다면, 캐시를 지우고 다시 시작하세요:
rm -rf ~/.cache/dropstone

Windows에서는 WIN+R을 누르고 %USERPROFILE%\.cache\dropstone을 삭제하세요.

다른 것을 삭제하기 전에

위의 세 명령은 안전합니다. ~/.local/share/dropstone을 삭제하는 것은 안전하지 않습니다 — 그곳에는 자격 증명과 세션 기록이 저장되어 있습니다. 해당 디렉토리를 제거하기 전에 상태가 저장되는 위치를 참조하세요.

상태가 저장되는 위치

Dropstone이 디스크에 저장하는 모든 것은 두 개의 디렉토리에 있습니다.

항목macOS / LinuxWindows
자격 증명 및 세션~/.local/share/dropstone/%USERPROFILE%\.local\share\dropstone
로그~/.local/share/dropstone/log/%USERPROFILE%\.local\share\dropstone\log
캐시~/.cache/dropstone/%USERPROFILE%\.cache\dropstone

데이터 디렉토리 내부:

  • auth.json — 자격 증명. 깨끗한 로그인을 강제하려는 경우에만 삭제하세요.
  • log/ — 타임스탬프가 찍힌 로그. 가장 최근 10개가 유지됩니다.
  • project/ — 프로젝트별로 범위가 지정된 세션 기록.

로그 파일은 작성된 시점의 이름을 따릅니다(예: 2026-05-23T123456.log). 가장 최근 파일이 필요한 파일입니다.

읽을 가치가 있는 로그 얻기

기본적으로 로그 레벨은 조용합니다. 두 가지 플래그가 이를 변경합니다:

# 로그 파일에 기록되는 상세 출력
dropstone --log-level DEBUG

# 동일한 출력을 발생 즉시 터미널로 스트리밍
dropstone --print-logs

실패가 발생하는 과정을 지켜보면서 이후에도 파일을 남기고 싶다면 둘을 함께 사용하세요.

문제가 시작 시 충돌이라면 --print-logs가 도움이 됩니다: 프로세스가 죽기 전에 로그 파일이 전혀 작성되지 않을 수 있지만, stderr는 항상 작성됩니다.

보고서에 포함할 내용

다섯 가지 항목이 포함된 보고서는 보통 한 번의 답변으로 해결됩니다. 이 항목이 없는 보고서는 보통 네 번의 답변이 필요합니다.

  1. 실행한 정확한 명령. 의역이 아니라 — 플래그를 포함한 그대로의 줄.

  2. 기대한 것과 실제로 발생한 것. 두 부분 모두. "실패했습니다"는 어떤 것도 좁히지 못합니다.

  3. 버전 및 플랫폼.

    dropstone --version

    그리고 OS와 버전, 네이티브 Windows인지 WSL 내부인지 여부.

  4. 관련 로그 발췌. 오류 전후 몇 줄이지 전체 파일이 아닙니다. 민감한 내용은 삭제하세요 — 세션 로그에는 파일 경로와 코드가 포함될 수 있습니다.

  5. 재현 가능 여부. 항상, 가끔, 또는 한 번. "가끔"은 말할 가치가 있습니다. 잘못된 입력보다는 타이밍이나 상태를 가리킵니다.

dropstone.io/contact로 보내세요.

원인 좁히기

원인이 여전히 명확하지 않다면, 한 번에 하나씩 변수를 제거하세요. 각각은 전체 범주를 제거합니다.

프로젝트 문제인가요? 빈 디렉토리에서 Dropstone을 실행하세요. 거기서 작동한다면 문제는 프로젝트 범위입니다 — 구성 파일, 규칙 파일, 또는 에이전트가 읽는 저장소의 무언가일 가능성이 높습니다.

구성 문제인가요? dropstone.json을 임시로 옮기고 다시 실행하세요. 전역 및 프로젝트 구성 파일의 위치는 구성을 참조하세요.

MCP 서버 문제인가요? 시작 시 멈추는 서버는 전체 세션을 지연시킵니다. 서버를 나열하고 비활성화한 다음, 하나씩 다시 활성화하세요:

dropstone mcp list

네트워크 문제인가요? 회사 프록시는 다른 문제처럼 보이는 실패의 가장 흔한 원인입니다. 확인하세요:

curl -I https://dropstone.io

이것이 실패하거나 예상치 못한 결과를 반환하면 네트워크 및 프록시를 참조하세요. 일반적인 해결책은 HTTPS_PROXY를 설정하고, 중요하게는 NO_PROXY=localhost,127.0.0.1을 설정하는 것입니다 — Dropstone은 대화형 세션 중에 로컬 루프백을 사용하며, 이를 프록시로 라우팅하면 루프가 발생합니다.

자격 증명 문제인가요? 로그아웃 후 다시 로그인하세요:

dropstone auth logout
dropstone auth login

터미널 문제인가요? Linux에서 복사 및 붙여넣기에는 클립보드 유틸리티가 설치되어 있어야 합니다. CLI 문제 해결을 참조하세요.

Windows 문제인가요? 네이티브 Windows에서 느린 파일 액세스, 터미널 결함, 경로 문제는 일반적으로 WSL에서 사라집니다. Windows 및 WSL을 참조하세요.

지원팀에 문의하기 전에

관련 항목

Ctrl+I