빠른 시작

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이 프로젝트를 둘러보게 하세요. 다음 중 하나를 시도해 보세요:

이 프로젝트는 무엇을 하나요?

주요 진입점은 무엇인가요?

폴더 구조를 설명해 주세요

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

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

이 프로젝트에서 무엇을 할 수 있나요?

어떤 명령을 실행할 권한이 부여되었나요?

5단계: 첫 코드 변경하기

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

한 단락 프로젝트 설명이 포함된 README를 추가해 줘

기존 프로젝트의 경우:

사용자를 생성하는 함수에 입력 검증을 추가해 줘

Dropstone은 다음을 수행합니다:

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

권한

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

6단계: git 작업

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

어떤 파일을 변경했나요?

설명적인 메시지로 변경 사항을 커밋해 줘

feature/health-endpoint라는 브랜치를 만들고 전환해 줘

최근 5개 커밋을 보여 줘

src/auth.ts의 병합 충돌을 해결해 줘

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

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

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

빈 검색 쿼리가 모든 결과를 반환하는 버그가 있어 - 고쳐 줘

API 서버에 빌드 정보를 반환하는 /healthz 엔드포인트를 추가해 줘

이메일이 없을 때 로그인 폼이 충돌해 - 원인을 찾아서 고쳐 줘

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

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

Dropstone이 잘하는 몇 가지 패턴:

리팩터링

auth 모듈을 콜백 대신 async/await를 사용하도록 리팩터링해 줘

테스트 작성

계산기 함수에 대한 단위 테스트를 작성해 줘

코드 리뷰

스테이징된 변경 사항을 검토하고 위험한 부분을 표시해 줘

문서화

README 설치 지침에 WSL 경로를 포함하도록 업데이트해 줘

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 종료