Dropstone Docs

개요

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

첫 실행 시 로그인하라는 메시지가 표시됩니다. 두 가지 옵션이 있습니다:

  1. 브라우저에서 계속(권장). dropstone.io/login을 열고 로그인한 후 토큰을 CLI에 자동으로 전달합니다. PKCE를 사용하므로 토큰이 브라우저 URL 표시줄에 노출되지 않습니다.
  2. 토큰 붙여넣기. 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를 입력하여 가격 페이지를 엽니다.

Ctrl+I