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
許可する権限のカンマ区切りリスト（デフォルト: すべて）。利用可能: 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と併用）
-pBasic認証パスワード（デフォルトはDROPSTONE_SERVER_PASSWORD）
-uBasic認証ユーザー名（デフォルトは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には3つのティアがあります:

モデルIDティア最適な用途
dropstone/dropstone-fastFastデフォルトの日常使用。クイック編集、スキャフォールディング、会話形式のデバッグ。
dropstone/dropstone-proPro複数ファイルのリファクタリング、横断的な変更、より広範な推論。
dropstone/dropstone-heavyHeavyアーキテクチャ決定、大規模な移行、困難なデバッグ。

完全な内訳とデフォルトの設定方法については、モデルを参照してください。

フラグ

フラグ説明
キャッシュされたモデルリストを更新
メタデータ（コンテキストウィンドウ、機能）を含める

run

プロンプトを直接渡して、非対話モードでdropstoneを実行します。

dropstone run [message..]

これはスクリプト、自動化、またはインタラクティブセッションを開かずに簡単な回答が必要な場合に便利です。例:

dropstone run Explain the use of context in Go

実行中のdropstone serveインスタンスに接続して、毎回の実行時のMCPサーバーのコールドブート時間を回避することもできます:

# 1つのターミナルでヘッドレスサーバーを起動
dropstone serve

# 別のターミナルで、それに接続するコマンドを実行
dropstone run --attach http://localhost:4096 "Explain async/await in JavaScript"

フラグ

フラグショート説明
実行するコマンド。メッセージを引数に使用
-c最後のセッションを続行
-s続行するセッションID
続行時にセッションをフォーク（--continueまたは--sessionと併用）
セッションを共有
-m使用するモデル（dropstone/dropstone-fast、dropstone/dropstone-pro、またはdropstone/dropstone-heavy）
使用するエージェント
-fメッセージに添付するファイル
形式: default（整形）またはjson（生のJSONイベント）
セッションのタイトル（値が指定されない場合は切り詰められたプロンプトを使用）
実行中のdropstoneサーバーに接続（例: http://localhost:4096）
-pBasic認証パスワード（デフォルトはDROPSTONE_SERVER_PASSWORD）
-uBasic認証ユーザー名（デフォルトは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

Webインターフェース付きのヘッドレスDropstoneサーバーを起動します。

dropstone web

これによりHTTPサーバーが起動し、Webブラウザが開いてWebインターフェースから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]
# or
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