개요
Dropstone CLI는 터미널에서 실행되는 에이전트형 코딩 도구입니다. 셸에서 코드 읽기, 명령 실행, 변경 계획, 파일 편집을 요청할 수 있습니다.
터미널에서 작업하는 개발자에게 Dropstone은 에이전트형 코딩을 시작하는 가장 빠른 방법입니다. 이 페이지에서는 설치, 로그인, 그리고 첫 대화까지 안내합니다.
사전 요구 사항
- 최신 터미널 에뮬레이터. 어떤 것이든 괜찮습니다. WezTerm, Alacritty, Ghostty, Kitty에서 테스트했습니다.
- Dropstone 계정. dropstone.io에서 가입하면 기본 제공 모델 라인업(Fast, Pro, Heavy)을 사용할 수 있습니다.
설치
Homebrew(권장):
brew tap blankline-org/dropstone-cli
brew install dropstone
또는 설치 스크립트:
curl -fsSL https://dropstone.io/install | bash
두 방법 모두 단일 dropstone 바이너리를 PATH에 추가합니다. Node나 런타임 의존성이 필요 없습니다.
설치를 확인합니다:
dropstone --version
로그인
프로젝트 디렉터리로 이동한 후 Dropstone을 시작합니다:
cd /path/to/your/project
dropstone
첫 실행 시 로그인하라는 메시지가 표시됩니다. 두 가지 옵션이 있습니다:
- 브라우저에서 계속(권장). dropstone.io/login을 열고 로그인한 후 토큰을 CLI에 자동으로 전달합니다. PKCE를 사용하므로 토큰이 브라우저 URL 표시줄에 노출되지 않습니다.
- 토큰 붙여넣기. SSH 또는 헤드리스 세션용. dropstone.io/account에서 토큰을 받아 붙여넣습니다.
나중에 계정을 전환하려면 Dropstone 내에서 /login을 실행하세요.
모델 선택
Dropstone은 세 가지 모델 티어를 제공합니다. 세 가지 모두 미국 인프라에서 호스팅되며 코딩에 맞게 튜닝되었습니다.
| 티어 | 가장 적합한 용도 |
|---|---|
| Fast | 빠른 편집, 스캐폴딩, 단일 파일 리팩터링. 기본 티어입니다. |
| Pro | 다중 파일 리팩터링, 프로젝트 전반에 걸친 변경, 더 넓은 추론. |
| Heavy | 아키텍처 결정, 대규모 마이그레이션, 모호하거나 조사가 많이 필요한 디버깅. |
세션 중에 /effort low, /effort medium, /effort high, /effort xhigh로 티어를 전환할 수 있습니다. Ctrl+T로 순환 전환합니다. 자세한 내용은 모델을 참조하세요.
프로젝트 초기화
프로젝트 루트에서 다음을 실행합니다:
/init
Dropstone이 프로젝트 구조를 스캔하고 저장소 루트에 AGENTS.md 파일을 생성합니다. 이를 git에 커밋하세요. 이 파일에 프로젝트 규칙, 빌드 명령, 그리고 Dropstone이 모든 프롬프트에서 알아야 할 주의사항을 기록합니다.
전체 형식은 규칙(AGENTS.md)을 참조하세요.
첫 대화
이제 준비가 되었습니다. 질문하고, 변경을 요청하고, 기능을 계획하세요.
코드에 대해 질문하기
How is authentication handled in @src/auth/session.ts?
@를 사용하여 파일을 퍼지 검색하고 프롬프트에 고정할 수 있습니다.
구축 전에 계획하기
Tab을 눌러 Plan 모드로 전환하세요. Plan 모드에서 Dropstone은 파일을 편집할 수 없으며, 수행할 작업만 설명합니다.
Add a "deleted_at" column to the notes table. Then build a screen that
lists recently deleted notes with restore and permanent-delete buttons.
계획을 반복해서 다듬으세요. 만족스러우면 Tab을 다시 눌러 Build 모드로 돌아가 실행하라고 지시하세요.
직접 편집
작은 변경은 계획을 건너뛰세요:
Add auth to /settings the same way it is handled in /notes.
실행 취소 및 다시 실행
/undo
/redo
/undo는 이전 편집 주기를 되돌리고 프롬프트를 다시 표시하여 수정할 수 있게 합니다. 여러 번 실행하면 더 이전 상태로 되돌아갈 수 있습니다. /redo는 취소된 단계를 다시 실행합니다.
사용량 및 한도
/usage를 입력하면 주간 사용량, 플랜 티어, 초기화 카운트다운을 확인할 수 있습니다. 더 많은 용량이 필요하면 /upgrade를 입력하여 가격 페이지를 엽니다.