Dropstone Docs

概要

Dropstone CLI は、ターミナルで動作するエージェント型コーディングツールです。コードの読み取り、コマンドの実行、変更の計画、ファイルの編集を、すべてシェルから依頼できます。

Dropstone は、ターミナルで作業する人にとって、エージェント型コーディングへの最速の道です。このページでは、インストール、サインイン、そして最初の会話を始めるまでの手順を説明します。

前提条件

  • モダンなターミナルエミュレータ。どれでも構いません。当社では WezTerm、Alacritty、Ghostty、Kitty でテストしています。
  • Dropstone アカウント。dropstone.io でサインアップすると、内蔵モデル（Fast、Pro、Heavy）を利用できます。

インストール

Homebrew（推奨）:

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

または、インストールスクリプト:

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

どちらの方法でも、単一の dropstone バイナリが PATH に配置されます。Node もランタイム依存関係も不要です。

インストールを確認します:

dropstone --version

サインイン

任意のプロジェクトディレクトリに移動し、Dropstone を起動します:

cd /path/to/your/project
dropstone

初回起動時にサインインを求められます。2つのオプションがあります:

  1. ブラウザで続行（推奨）。dropstone.io/login が開き、サインインすると、トークンが自動的に CLI に渡されます。PKCE を使用するため、トークンがブラウザの URL バーに表示されることはありません。
  2. トークンを貼り付け。SSH やヘッドレスセッション用です。dropstone.io/account でトークンを取得し、貼り付けます。

後でアカウントを切り替えるには、Dropstone 内で /login を実行します。

モデルを選択

Dropstone には3つのモデル層があります。すべて米国のインフラストラクチャでホストされ、コーディング向けに調整されています。

層最適な用途
Fastクイック編集、スキャフォールディング、単一ファイルのリファクタリング。デフォルトの層です。
Pro複数ファイルのリファクタリング、横断的な変更、より広範な推論。
Heavyアーキテクチャの決定、大規模な移行、曖昧または調査を要するデバッグ。

セッション中に /effort low、/effort medium、/effort high、/effort xhigh で層を切り替えます。Ctrl+T で順に切り替えられます。詳細は モデル を参照してください。

プロジェクトを初期化

プロジェクトのルート内で、次を実行します:

/init

Dropstone はプロジェクト構造をスキャンし、リポジトリのルートに AGENTS.md ファイルを作成します。これを git にコミットしてください。ここに、Dropstone がすべてのプロンプトで把握すべきプロジェクトの規約、ビルドコマンド、注意点を記述します。

完全な形式については、ルール (AGENTS.md) を参照してください。

最初の会話

準備は完了です。質問をしたり、変更を依頼したり、機能を計画したりできます。

コードについて質問する

How is authentication handled in @src/auth/session.ts?

@ を使用してファイルをファジー検索し、プロンプトに固定します。

構築前に計画する

Tab を押して プランモード に切り替えます。プランモードでは、Dropstone はファイルを編集できず、実行する内容を説明するだけです。

Add a "deleted_at" column to the notes table. Then build a screen that
lists recently deleted notes with restore and permanent-delete buttons.

計画を繰り返し調整します。満足したら、Tab を再度押して ビルドモード に戻り、実行を指示します。

直接編集

小さな変更には、計画をスキップします:

Add auth to /settings the same way it is handled in /notes.

元に戻すとやり直す

/undo
/redo

/undo は直前の編集サイクルを元に戻し、プロンプトを再表示して調整できるようにします。複数回実行すると、さらに前の状態に戻れます。/redo は元に戻したステップをやり直します。

使用状況と制限

/usage と入力すると、週次の使用状況、プラン層、リセットまでのカウントダウンが表示されます。より多くの容量が必要な場合は、/upgrade と入力して価格ページを開きます。

Ctrl+I