Dropstone CLI

개요

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