Dropstone Docs

Dropstone에 오신 것을 환영합니다

Dropstone은 터미널에서 작동하는 에이전틱 코딩 도구입니다. 코드베이스를 읽고, 여러 파일에 걸쳐 조정된 편집을 수행하며, 명령을 실행하고, 작업하면서 추론 과정을 설명합니다.

터미널에서 실행 중인 Dropstone

원하는 작업을 설명하면 Dropstone이 관련 코드를 읽고, 변경 계획을 세우고, 파일을 편집하고, 명령을 실행하고, 수행한 작업을 설명합니다. 장난감 수준의 스니펫이 아닌 실제 프로젝트에서 작동하며, 이미 보유한 코드에 기반을 둡니다.

이 페이지는 제품의 개요를 제공합니다. 빠른 시작에서 설치 방법과 첫 번째 변경 사항을 배포하는 과정을 안내합니다.

몇 초 만에 설치

Homebrew (권장):

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

또는 설치 스크립트:

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

그런 다음 아무 프로젝트나 열어보세요:

cd /path/to/your/project
dropstone

dropstone --version으로 설치를 확인하세요. 첫 실행 시 로그인하라는 메시지가 표시됩니다. 자세한 로그인 방법은 빠른 시작 페이지에 있습니다.

할 수 있는 작업

코드베이스 이해하기

인증이 시스템 전체에서 어떻게 흐르는지, 버그가 어디에 숨어 있을 수 있는지, 모듈이 어떻게 연결되어 있는지 물어보세요. Dropstone은 필요할 때 파일을 읽고 실제 코드를 인용하여 답변합니다.

기능 구축 및 버그 수정

변경 사항을 평이한 언어로 설명하세요. Dropstone이 계획을 제안하고, 여러 파일에 걸쳐 편집하며, 적용 전에 diff를 보여줍니다.

실행, 테스트, 검증

타입 검사, 테스트, 린트가 존재하면 자동으로 실행됩니다. 실패는 계획으로 다시 피드백되어 결과를 읽을 때쯤에는 모든 것이 정상 상태입니다.

커밋 및 풀 리퀘스트 생성

컨벤셔널 커밋 메시지를 생성하고, 브랜치를 푸시하고, GitHub 또는 GitLab 통합을 통해 PR을 엽니다. 코드 리뷰 요약도 포함됩니다.

MCP로 도구 연결

데이터베이스, 내부 API, 티켓 시스템 또는 모든 Model Context Protocol 서버를 연결하세요. Dropstone은 이를 일급 도구로 취급합니다.

규칙과 스킬로 사용자 정의

저장소 루트에 AGENTS.md를 넣어 Dropstone에 프로젝트 규칙을 가르치세요. 재사용 가능한 워크플로를 스킬로 패키징하세요.

셸과 함께 사용하기

Dropstone은 Unix 시민입니다. 대화형 세션이 기본 인터페이스이지만, 모든 기능은 원샷 호출로도 사용할 수 있어 CI, pre-commit 훅, 그리고 자체 워크플로에서 스크립트로 활용할 수 있습니다.

# 원샷: 질문하고 종료
dropstone run "인증 미들웨어가 어떻게 작동하는지 설명해줘"

# 파일 파이프 입력
dropstone run "보안 문제 찾기" < src/auth.ts

# 셸 파이프라인에서 사용
git diff main | dropstone run "이 diff에 대한 PR 설명 작성"

# TTY 없이 CI에서 실행
dropstone run --json "최근 20개 커밋에서 릴리스 노트 생성"

작동 방식

Dropstone은 터미널에서 단일 바이너리로 실행됩니다. 설정할 것도, 설치할 런타임도 없습니다. 프로젝트 안에서 시작하면 작업 디렉터리의 파일을 대상으로 작동합니다. 코드 옆에 패널 형태로 사용하고 싶다면 Dropstone for VS Code도 있습니다.

각 턴은 동일한 루프를 따릅니다:

1

평이한 언어로 작업을 설명합니다

특별한 문법이 필요 없습니다. "빌드 정보를 반환하는 /healthz 엔드포인트를 추가해줘"라고 말하면 충분합니다.

2

Dropstone이 컨텍스트를 수집합니다

파일을 읽고, 심볼을 검색하고, 구조를 검사하여 작업에 충분한 정보를 얻을 때까지 진행합니다.

3

계획을 제안하고 실행합니다

편집 내용은 diff로 표시됩니다. 셸 명령은 화이트리스트에 등록하지 않는 한 권한을 요청합니다.

4

결과를 검증합니다

타입 검사, 테스트, 린트가 존재하면 자동으로 실행됩니다. 실패는 계획으로 다시 피드백됩니다.

전체 상호작용은 터미널 안에서 이루어집니다. 코드는 Dropstone 자체 추론 서버로만 전송되며, 이 서버는 무보관·무학습 정책 하에 운영됩니다. 자세한 내용은 신뢰 페이지를 참조하세요.

어디서나 Dropstone 사용하기

하고 싶은 작업…최적의 방법
대화형 코딩 세션 시작프로젝트 디렉터리에서 dropstone 실행
세션 없이 일회성 질문dropstone run "..." 또는 <로 파일 파이프 입력
마지막 세션 재개dropstone --continue (또는 dropstone -c)
커스텀 도구 또는 내부 API 연결MCP 서버
저장소 규칙을 Dropstone에 가르치기저장소 루트에 AGENTS.md 추가
재사용 가능한 워크플로 패키징스킬플러그인
CI 또는 pre-commit에서 Dropstone 사용--json권한 모델과 함께 dropstone run 사용
작업에 맞는 모델 티어 선택모델 (Fast / Pro / Heavy)
샌드박스 또는 제한된 셸에서 실행권한

세 가지 모델 티어 중심 설계

작업에 맞는 모델을 선택하세요. 세 가지 모두 미국 인프라에서 호스팅되며 코딩에 최적화되어 있습니다.

Fast

Dropstone Fast

빠른 편집, 스캐폴딩, 단일 파일 리팩터링, 대화형 디버깅. 첫 토큰까지 1초 미만. 새 세션의 기본 티어입니다.
Pro권장

Dropstone Pro

다중 파일 리팩터링, 교차 변경, 더 넓은 추론이 필요한 작업. /effort high로 전환하세요.
Heavy

Dropstone Heavy

아키텍처 결정, 대규모 마이그레이션, 어려운 디버깅. 가장 깊은 추론과 가장 긴 사고 예산. /effort xhigh로 전환하세요.

:

모델 선택을 미리 고민할 필요는 없습니다. Fast에서 시작하고, 더 깊이가 필요한 작업이 생기면 Dropstone 내부에서 /effort를 사용해 단계를 올리세요.

다음 단계

1

시작하기

빠른 시작에서 설치, 로그인, 첫 번째 작업을 다룹니다.

2

모델 티어 선택

모델에서 Fast, Pro, Heavy와 각각을 언제 사용해야 하는지 자세히 알아보세요.

3

원하는 대로 설정

설정에서 전역 및 프로젝트별 설정을 다루고, 권한키바인딩이 나머지를 다룹니다.

4

새로운 기능 확인

변경 로그에 사용자에게 보이는 변경 사항과 함께 모든 릴리스가 나열되어 있습니다.

설정이 끝나면 CLI 참조슬래시 명령 가이드가 가장 자주 찾게 될 두 페이지입니다.


이 문서를 읽어야 하는 에이전트 또는 LLM 앱을 구축 중이신가요? 사이트 인덱스는 /llms.txt, 전체 문서를 한 파일로 보려면 /llms-full.txt를 가리키세요.

Ctrl+I