Dropstone Docs

CLI

Dropstone CLI 옵션 및 명령어.

Dropstone CLI는 기본적으로 인자 없이 실행하면 대화형 세션을 시작합니다.

dropstone

하지만 이 페이지에 문서화된 대로 명령어도 허용합니다. 이를 통해 Dropstone을 프로그래밍 방식으로 상호작용할 수 있습니다.

dropstone run "Explain how closures work in JavaScript"

tui

대화형 Dropstone 세션을 시작합니다. dropstone을 하위 명령어 없이 실행할 때의 기본 동작이며, dropstone tui는 명시적인 형태입니다.

dropstone [project]

플래그

플래그단축설명
-c마지막 세션 계속하기
-s계속할 세션 ID
계속할 때 세션 포크하기 (--continue 또는 --session과 함께 사용)
사용할 프롬프트
-m사용할 모델 (dropstone/dropstone-fast, dropstone/dropstone-pro, 또는 dropstone/dropstone-heavy)
사용할 에이전트
수신 대기할 포트
수신 대기할 호스트 이름
mDNS 검색 활성화
사용자 지정 mDNS 도메인 이름
CORS를 허용할 추가 브라우저 출처

명령어

Dropstone CLI에는 다음과 같은 명령어도 있습니다.

agent

Dropstone용 에이전트를 관리합니다.

dropstone agent [command]

create

사용자 지정 구성으로 새 에이전트를 생성합니다.

dropstone agent create

이 명령어는 사용자 지정 시스템 프롬프트와 권한 구성으로 새 에이전트를 생성하는 과정을 안내합니다. 허용하지 않는 항목은 생성된 에이전트의 frontmatter에서 거부됩니다.

플래그

플래그단축설명
에이전트 파일을 작성할 디렉터리 (프롬프트에 따라 전역 또는 .dropstone/agent 기본값)
에이전트가 수행할 작업
에이전트 모드: all, primary, 또는 subagent
허용할 권한의 쉼표로 구분된 목록 (기본값: all). 사용 가능: bash, read, edit, glob, grep, webfetch, task, todowrite, websearch, lsp, skill. 생략된 항목은 거부됩니다. 별칭: --tools
-m사용할 모델 (dropstone/dropstone-fast, dropstone/dropstone-pro, 또는 dropstone/dropstone-heavy)

--path, --description, --mode, --permissions를 모두 전달하면 명령어가 비대화형으로 실행됩니다.

list

사용 가능한 모든 에이전트를 나열합니다.

dropstone agent list

attach

serve 또는 web 명령어로 시작된 이미 실행 중인 Dropstone 백엔드 서버에 터미널을 연결합니다.

dropstone attach [url]

이를 통해 다른 머신에서 실행 중인 Dropstone 서버에 대화형 세션을 연결할 수 있습니다. 예:

# 호스트 머신에서 서버 시작
dropstone web --port 4096 --hostname 0.0.0.0

# 다른 머신에서 세션 연결
dropstone attach http://10.20.30.40:4096

플래그

플래그단축설명
세션을 시작할 작업 디렉터리
-c마지막 세션 계속하기
-s계속할 세션 ID
계속할 때 세션 포크하기 (--continue 또는 --session과 함께 사용)
-p기본 인증 비밀번호 (기본값: DROPSTONE_SERVER_PASSWORD)
-u기본 인증 사용자 이름 (기본값: DROPSTONE_SERVER_USERNAME 또는 dropstone)

auth

공급자의 자격 증명 및 로그인을 관리하는 명령어입니다.

dropstone auth [command]

login

dropstone auth login을 사용하여 Dropstone에 로그인합니다. 자격 증명은 ~/.local/share/dropstone/auth.json에 저장됩니다.

dropstone auth login

Dropstone은 실행할 때마다 이 파일에서 자격 증명을 읽습니다.

플래그
플래그단축설명
-p로그인할 공급자 ID 또는 이름
-m사용할 로그인 방법 라벨 (방법 선택 건너뜀)

list

자격 증명 파일에 저장된 인증된 모든 공급자를 나열합니다.

dropstone auth list

또는 짧은 버전.

dropstone auth ls

logout

자격 증명 파일에서 공급자를 제거하여 로그아웃합니다.

dropstone auth logout

github

저장소 자동화를 위한 GitHub 에이전트를 관리합니다.

dropstone github [command]

install

저장소에 GitHub 에이전트를 설치합니다.

dropstone github install

필요한 GitHub Actions 워크플로를 설정하고 구성 과정을 안내합니다. 자세히 알아보기.

run

GitHub 에이전트를 실행합니다. 일반적으로 GitHub Actions에서 사용됩니다.

dropstone github run
플래그
플래그설명
에이전트를 실행할 GitHub 모의 이벤트
GitHub 개인 액세스 토큰

mcp

Model Context Protocol 서버를 관리합니다.

dropstone mcp [command]

add

구성에 MCP 서버를 추가합니다.

dropstone mcp add

이 명령어는 로컬 또는 원격 MCP 서버를 추가하는 과정을 안내합니다.

list

구성된 모든 MCP 서버와 연결 상태를 나열합니다.

dropstone mcp list

또는 짧은 버전 사용.

dropstone mcp ls

auth

OAuth가 활성화된 MCP 서버로 인증합니다.

dropstone mcp auth [name]

서버 이름을 제공하지 않으면 사용 가능한 OAuth 지원 서버에서 선택하라는 메시지가 표시됩니다.

OAuth 지원 서버와 인증 상태를 나열할 수도 있습니다.

dropstone mcp auth list

또는 짧은 버전 사용.

dropstone mcp auth ls

logout

MCP 서버의 OAuth 자격 증명을 제거합니다.

dropstone mcp logout [name]

debug

MCP 서버의 OAuth 연결 문제를 디버깅합니다.

dropstone mcp debug <name>

models

계정에서 사용 가능한 Dropstone 모델 티어를 나열합니다.

dropstone models

출력 형식은 dropstone/<tier>입니다. Dropstone은 세 가지 티어를 제공합니다:

모델 ID티어최적 용도
dropstone/dropstone-fastFast기본 일일 드라이버. 빠른 편집, 스캐폴딩, 대화형 디버깅.
dropstone/dropstone-proPro다중 파일 리팩터링, 교차 변경, 더 넓은 추론.
dropstone/dropstone-heavyHeavy아키텍처 결정, 대규모 마이그레이션, 어려운 디버깅.

전체 분석 및 기본값 설정 방법은 모델을 참조하세요.

플래그

플래그설명
캐시된 모델 목록 새로고침
메타데이터 포함 (컨텍스트 창, 기능)

run

프롬프트를 직접 전달하여 비대화형 모드로 dropstone을 실행합니다.

dropstone run [message..]

스크립팅, 자동화, 또는 대화형 세션을 열지 않고 빠른 답변을 원할 때 유용합니다. 예:

dropstone run Explain the use of context in Go

실행할 때마다 MCP 서버 콜드 부팅 시간을 피하기 위해 실행 중인 dropstone serve 인스턴스에 연결할 수도 있습니다:

# 한 터미널에서 헤드리스 서버 시작
dropstone serve

# 다른 터미널에서 연결되는 명령어 실행
dropstone run --attach http://localhost:4096 "Explain async/await in JavaScript"

플래그

플래그단축설명
실행할 명령어, 인자는 message 사용
-c마지막 세션 계속하기
-s계속할 세션 ID
계속할 때 세션 포크하기 (--continue 또는 --session과 함께 사용)
세션 공유
-m사용할 모델 (dropstone/dropstone-fast, dropstone/dropstone-pro, 또는 dropstone/dropstone-heavy)
사용할 에이전트
-f메시지에 첨부할 파일
형식: default (형식화됨) 또는 json (원시 JSON 이벤트)
세션 제목 (값이 없으면 잘린 프롬프트 사용)
실행 중인 dropstone 서버에 연결 (예: http://localhost:4096)
-p기본 인증 비밀번호 (기본값: DROPSTONE_SERVER_PASSWORD)
-u기본 인증 사용자 이름 (기본값: DROPSTONE_SERVER_USERNAME 또는 dropstone)
실행할 디렉터리, 또는 연결 시 원격 서버의 경로
로컬 서버 포트 (기본값: 임의 포트)
모델 변형 (공급자별 추론 노력)
사고 블록 표시
명시적으로 거부되지 않은 권한 자동 승인 (위험!)

serve

API 액세스를 위한 헤드리스 Dropstone 서버를 시작합니다. 전체 HTTP 인터페이스는 서버 문서를 확인하세요.

dropstone serve

대화형 세션을 열지 않고 Dropstone에 프로그래밍 방식으로 액세스할 수 있는 헤드리스 HTTP 서버를 시작합니다. DROPSTONE_SERVER_PASSWORD를 설정하여 HTTP 기본 인증을 활성화합니다 (사용자 이름 기본값: dropstone).

플래그

플래그설명
수신 대기할 포트
수신 대기할 호스트 이름
mDNS 검색 활성화
사용자 지정 mDNS 도메인 이름
CORS를 허용할 추가 브라우저 출처

session

Dropstone 세션을 관리합니다.

dropstone session [command]

list

모든 Dropstone 세션을 나열합니다.

dropstone session list
플래그
플래그단축설명
-n최근 N개 세션으로 제한
출력 형식: table 또는 json (table)

delete

Dropstone 세션을 삭제합니다.

dropstone session delete <sessionID>

stats

Dropstone 세션의 토큰 사용량 및 비용 통계를 표시합니다.

dropstone stats

플래그

플래그설명
지난 N일 동안의 통계 표시 (전체 기간)
표시할 도구 수 (전체)
모델 사용량 분석 표시 (기본적으로 숨김). 숫자를 전달하면 상위 N개 표시
프로젝트별 필터 (모든 프로젝트, 빈 문자열: 현재 프로젝트)

export

세션 데이터를 JSON으로 내보냅니다.

dropstone export [sessionID]

세션 ID를 제공하지 않으면 사용 가능한 세션에서 선택하라는 메시지가 표시됩니다.

플래그

플래그설명
민감한 대화/파일 데이터 삭제

import

JSON 파일 또는 Dropstone 공유 URL에서 세션 데이터를 가져옵니다.

dropstone import <file>

로컬 파일 또는 Dropstone 공유 URL에서 가져올 수 있습니다.

dropstone import session.json
dropstone import https://dropstone.io/s/abc123

web

웹 인터페이스가 있는 헤드리스 Dropstone 서버를 시작합니다.

dropstone web

HTTP 서버를 시작하고 웹 브라우저를 열어 웹 인터페이스를 통해 Dropstone에 액세스합니다. DROPSTONE_SERVER_PASSWORD를 설정하여 HTTP 기본 인증을 활성화합니다 (사용자 이름 기본값: dropstone).

플래그

플래그설명
수신 대기할 포트
수신 대기할 호스트 이름
mDNS 검색 활성화
사용자 지정 mDNS 도메인 이름
CORS를 허용할 추가 브라우저 출처

acp

ACP (Agent Client Protocol) 서버를 시작합니다.

dropstone acp

이 명령어는 stdin/stdout을 통해 nd-JSON으로 통신하는 ACP 서버를 시작합니다.

플래그

플래그설명
작업 디렉터리
수신 대기할 포트
수신 대기할 호스트 이름
mDNS 검색 활성화
사용자 지정 mDNS 도메인 이름
CORS를 허용할 추가 브라우저 출처

plugin

플러그인을 설치하고 구성을 업데이트합니다.

dropstone plugin <module>

또는 별칭 사용.

dropstone plug <module>

플래그

플래그단축설명
-g전역 구성에 설치
-f기존 플러그인 버전 교체

pr

GitHub PR 브랜치를 가져와 체크아웃한 다음 Dropstone을 실행합니다.

dropstone pr <number>

db

데이터베이스 도구.

dropstone db [query]

플래그

플래그설명
출력 형식: json 또는 tsv

path

데이터베이스 경로를 출력합니다.

dropstone db path

debug

디버깅 및 문제 해결 도구.

dropstone debug [command]

uninstall

Dropstone을 제거하고 관련 파일을 모두 삭제합니다.

dropstone uninstall

플래그

플래그단축설명
-c구성 파일 유지
-d세션 데이터 및 스냅샷 유지
제거하지 않고 제거될 항목 표시
-f확인 프롬프트 건너뛰기

upgrade

Dropstone CLI를 최신 버전 또는 특정 버전으로 업데이트합니다. dropstone update는 별칭이며 동일하게 동작합니다.

dropstone upgrade [target]
# 또는
dropstone update [target]

최신 버전으로 업그레이드하려면:

dropstone upgrade

특정 버전을 설치하려면:

dropstone upgrade 1.0.5

Windows에서 Dropstone이 현재 실행 중인 경우 설치 프로그램은 새 빌드를 dropstone.exe.pending으로 준비합니다. 새 버전은 다음 실행 시 자동으로 활성화됩니다: 수동 파일 이동이 필요 없습니다.

플래그

플래그단축설명
-m사용할 설치 방법: curl, npm, pnpm, bun, brew, scoop, choco

전역 플래그

dropstone CLI는 다음 전역 플래그를 사용합니다.

플래그단축설명
-h도움말 표시
-v버전 번호 출력
로그를 stderr로 출력
로그 수준 (DEBUG, INFO, WARN, ERROR)
외부 플러그인 없이 실행

환경 변수

Dropstone은 실행 시 다음 환경 변수를 읽습니다. 이는 지원되는 사용자 대상 변수입니다. 여기에 나열되지 않은 것은 내부용이며 예고 없이 변경되거나 제거될 수 있습니다.

변수유형설명
DROPSTONE_API_KEYstring헤드리스 / CI 사용을 위한 Dropstone API 키 (브라우저 로그인 건너뜀)
DROPSTONE_CONFIGstringdropstone.json 구성 파일 경로
DROPSTONE_TUI_CONFIGstring세션 구성 파일 경로 (tui.json)
DROPSTONE_DISABLE_AUTOUPDATEboolean자동 CLI 업데이트 확인 비활성화
DROPSTONE_GIT_BASH_PATHstringWindows에서 Git Bash 경로 (셸 도구로 사용)
DROPSTONE_SERVER_PASSWORDstringdropstone serve / dropstone web에서 HTTP 기본 인증 활성화
DROPSTONE_SERVER_USERNAMEstring기본 인증 사용자 이름 재정의 (기본값 dropstone)
Ctrl+I