다운로드 및 설치

macOS, Linux 또는 Windows에 Dropstone CLI를 설치하세요. 모든 설치 방법, 검증 방법, 업그레이드 및 제거 방법을 다룹니다.

Dropstone CLI는 PATH에 있는 단일 dropstone 바이너리입니다. Node도, 런타임 의존성도, 설치 마법사도 필요 없습니다. 이 페이지는 모든 설치 방법과 제거 방법에 대한 참조 문서입니다.

안내된 첫 실행을 원한다면 Quickstart를 대신 시작하세요.

요구 사항


macOS	Homebrew 또는 `curl`
Linux	`curl`. Debian, Ubuntu, Fedora, RHEL, Alpine, Arch 모두 지원
Windows	PowerShell 또는 CMD. WSL2 권장

데스크톱 앱이나 IDE 플러그인은 없습니다. Dropstone은 터미널에서 실행되며 작업 디렉터리의 파일을 대상으로 작동합니다.

Windows: WSL을 사용할 만합니다

네이티브 Windows 바이너리는 일상적인 사용에 충분합니다. WSL2는 macOS 및 Linux와 동일한 셸 경험을 제공하며, 두 파일 시스템에 걸쳐 에이전트를 실행할 때 발생하는 경로 및 줄바꿈 문제를 피할 수 있습니다. Windows 및 WSL을 참조하세요.

Homebrew:

brew tap blankline-org/dropstone-cli
brew install dropstone

또는 설치 스크립트:

curl -fsSL https://dropstone.io/install | bash

curl -fsSL https://dropstone.io/install | bash

패키지 관리자 지원(apt, dnf, apk)은 로드맵에 있습니다.

PowerShell:

irm https://dropstone.io/install.ps1 | iex

CMD에서:

curl -fsSL https://dropstone.io/install.cmd -o install.cmd && install.cmd

dropstone --version

현재 릴리스인지 확인하려면 download.dropstone.io/latest.txt와 비교하세요.

바이너리는 시작 시 업데이트를 확인하고 다운로드하므로, 별도 조치 없이 최신 릴리스를 유지할 수 있습니다.

예외는 Homebrew입니다. Homebrew가 해당 바이너리를 관리하므로 Dropstone은 이를 업데이트하지 않습니다. 직접 새로 고침하세요:

# Homebrew
brew upgrade dropstone

# 다른 설치 방법의 경우, 다음 시작 시 확인을 기다리지 않고 지금 업데이트하려면
dropstone update

자동 업데이트는 dropstone.json에서 구성할 수 있습니다:

{
  "autoupdate": true
}

false로 설정하면 업데이트를 완전히 끄고, "notify"로 설정하면 설치하지 않고 새 버전이 있을 때 알림을 받습니다. Configuration을 참조하세요.

dropstone uninstall

이 명령은 Dropstone과 관련 파일을 제거합니다. Homebrew에서는:

brew uninstall dropstone

Dropstone은 상태를 두 개의 디렉터리에만 저장하며, 그 외에는 아무것도 건드리지 않습니다:

항목	macOS / Linux	Windows
자격 증명 및 세션	`~/.local/share/dropstone/`	`%USERPROFILE%\.local\share\dropstone`
캐시	`~/.cache/dropstone/`	`%USERPROFILE%\.cache\dropstone`

dropstone uninstall은 둘 다 정리합니다. 수동으로 제거하거나 — 재설치 없이 깨끗한 로그인을 강제하려면 — Troubleshooting guide를 참조하세요.

일반적인 원인은 Homebrew 누락, 오래된 tap, 또는 PowerShell 안에서 CMD 명령을 실행하는 것입니다. Common issues에서 각각의 정확한 해결 방법을 다룹니다.