빠른 시작

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)가 표시되어야 합니다. 바이너리는 백그라운드에서 자동 업데이트되므로 설치 프로그램을 다시 실행하지 않아도 최신 상태를 유지합니다.

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라는 브랜치를 만들고 전환해 주세요

최근 다섯 개의 커밋을 보여 주세요

src/auth.ts의 병합 충돌을 해결하도록 도와주세요

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

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

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

빈 검색 쿼리가 모든 결과를 반환하는 버그가 있습니다 - 수정해 주세요

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

이메일이 없을 때 로그인 폼이 충돌합니다 - 원인을 찾아 수정해 주세요

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

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

Dropstone이 잘하는 몇 가지 패턴:

리팩터링

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

테스트 작성

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

코드 리뷰

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

문서화

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

팁:

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