빠른 시작

Dropstone을 설치하고 로그인한 뒤 5분 안에 첫 변경 사항을 배포하세요. 이 가이드는 제로에서 작동하는 에이전트 루프까지 안내합니다.

이 가이드를 마치면 Dropstone을 설치하고 로그인한 뒤 선택한 프로젝트에서 실제 편집을 수행할 수 있게 됩니다.

시작하기 전에

필요한 것:

터미널 또는 명령 프롬프트
Dropstone을 가리킬 디스크의 프로젝트 (모든 언어, 모든 크기)
dropstone.io에서 만들 수 있는 Dropstone 계정

1단계: Dropstone 설치

플랫폼에 맞는 설치 경로를 선택하세요.

Homebrew (권장):

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

또는 설치 스크립트:

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

두 방법 모두 PATH에 단일 dropstone 바이너리를 설치합니다. Node나 런타임 종속성이 필요 없습니다.

설치를 확인하세요:

dropstone --version

버전 번호가 표시되어야 합니다 (현재 릴리스는 1.0.8). 바이너리는 시작 시 업데이트를 확인하고 설치하므로 설치 프로그램을 다시 실행하지 않아도 최신 상태를 유지합니다. Homebrew로 설치한 경우 대신 brew upgrade dropstone을 사용하세요 — Homebrew가 해당 바이너리를 소유하며 Dropstone은 이를 건드리지 않습니다.

2단계: 로그인

프로젝트 디렉토리로 이동하여 Dropstone을 시작하세요:

cd /path/to/your/project
dropstone

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

브라우저에서 계속 (권장). dropstone.io/login을 열고 로그인한 뒤 토큰을 CLI에 자동으로 전달합니다. PKCE를 사용하므로 토큰이 브라우저 URL 표시줄에 나타나지 않습니다.
토큰 붙여넣기. SSH 또는 헤드리스 세션용입니다. dropstone.io/account에서 토큰을 받아 붙여넣으세요.

자격 증명은 첫 로그인 후 디스크에 저장됩니다. 나중에 계정을 전환하려면 Dropstone 내부에서 /login을 실행하세요.

3단계: 첫 세션 시작

이제 Dropstone 홈 화면이 표시됩니다. 세 가지 주목할 점:

현재 모델 티어가 오른쪽 상단에 표시됩니다 (기본값: Dropstone Fast)
하단의 입력 상자에 입력합니다
슬래시 명령은 /로 시작합니다. 모두 보려면 /help를 시도하세요

세션을 시작하려면 자연어 프롬프트를 입력하세요. 배울 특별한 문법은 없습니다.

4단계: 첫 질문하기

Dropstone이 프로젝트를 둘러보게 하세요. 다음 중 하나를 시도해 보세요:

what does this project do?

what are the main entry points?

explain the folder structure

Dropstone은 필요에 따라 파일을 읽고 실제 코드에 대한 인용과 함께 답변합니다. 파일을 붙여넣거나 컨텍스트를 수동으로 작성할 필요가 없습니다.

Dropstone에 대해 물어볼 수도 있습니다:

what can you do in this project?

what commands have you been given permission to run?

5단계: 첫 코드 변경하기

이제 작은 변경을 설명하세요. 새 프로젝트의 경우 위험도가 낮은 것을 시도해 보세요:

add a README with a one-paragraph project description

기존 프로젝트의 경우:

add input validation to the function that creates a user

Dropstone은 다음을 수행합니다:

관련 파일 찾기
제안된 변경을 diff로 표시
작성 전에 승인 요청
결과 검증 (가능한 경우 타입 체크, 테스트, 린트)

권한

Dropstone은 파일을 편집하거나 셸 명령을 실행하려는 첫 번째 시도에서 승인을 요청합니다. 한 번 승인하면 동일한 세션에서 동일한 작업은 다시 묻지 않고 실행됩니다. /permissions를 사용하여 허용한 항목을 보거나 취소할 수 있습니다.

6단계: git 작업

Dropstone은 git을 일급 도구로 취급합니다:

what files have I changed?

commit my changes with a descriptive message

create a branch called feature/health-endpoint and switch to it

show the last five commits

help me resolve the merge conflict in src/auth.ts

PR 수준 워크플로(풀 리퀘스트 열기, PR 설명 생성, 리뷰 댓글 게시)는 GitHub 통합을 참조하세요.

7단계: 버그 수정 또는 기능 추가

원하는 것을 평이한 언어로 설명하세요. Dropstone은 코드를 찾고, 컨텍스트를 이해하고, 변경을 구현하고, 검증합니다.

there is a bug where empty search queries return all results - fix it

add a /healthz endpoint to the API server that returns build info

the login form crashes when the email is missing - figure out why and fix it

작업이 여러 파일에 걸쳐 있는 경우 Dropstone은 짧은 계획을 작성하고 단계별로 실행합니다. 언제든지 Esc를 눌러 중단하고 방향을 조정할 수 있습니다.

8단계: 다른 일반적인 워크플로 시도

Dropstone이 잘하는 몇 가지 패턴:

리팩터링

refactor the auth module to use async/await instead of callbacks

테스트 작성

write unit tests for the calculator functions

코드 리뷰

review my staged changes and flag anything risky

문서화

update the README install instructions to include the WSL path

Tip

Dropstone에게 팀원처럼 말하세요. 정확한 단계가 아니라 달성하려는 것을 설명하세요. 에이전트는 구현 선택을 맡길 때 계획을 가장 잘 세웁니다.

필수 명령

실제로 사용하게 될 몇 가지 명령:

명령	기능	예시
`dropstone`	현재 디렉토리에서 대화형 세션 시작	`dropstone`
`dropstone run "task"`	일회성 작업 실행 후 종료	`dropstone run "explain auth.ts"`
`dropstone -c`	이 디렉토리의 마지막 세션 계속	`dropstone -c`
`dropstone --session ID`	특정 세션을 ID로 재개	`dropstone --session 7f3a...`
`/help`	모든 슬래시 명령 표시	세션 내부
`/effort`	이 세션의 모델 티어 전환	`/effort high`
`/clear`	현재 대화 지우기	세션 내부
`/login`	계정 전환	세션 내부
`exit` 또는 `Ctrl+D`	Dropstone 종료