クイックスタート

Dropstoneをインストールし、サインインして、5分以内に最初の変更をリリースします。このガイドでは、ゼロから動作するエージェントループまでを案内します。

このガイドを読み終えると、Dropstoneがインストールされ、サインインし、選択したプロジェクトで実際の編集を行えるようになります。

始める前に

必要なもの:

ターミナルまたはコマンドプロンプト
Dropstoneを実行するためのディスク上のプロジェクト（任意の言語、任意のサイズ）
Dropstoneアカウント（dropstone.ioで作成できます）

ステップ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）が表示されるはずです。バイナリは起動時に更新をチェックしてインストールするため、インストーラーを再実行しなくても最新の状態を維持できます。Homebrewでインストールした場合は、代わりにbrew upgrade dropstoneを使用してください。Homebrewがそのバイナリを管理しており、Dropstoneはそれに触れません。

ステップ2: サインインする

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

cd /path/to/your/project
dropstone

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

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

認証情報は初回サインイン後にディスクに保存されます。後でアカウントを切り替えるには、Dropstone内で/loginを実行します。

ステップ3: 最初のセッションを開始する

これでDropstoneのホーム画面が表示されています。3つの点に注目してください:

現在のモデル階層が右上に表示されます（デフォルト: Dropstone Fast）
下部の入力ボックスが入力場所です
スラッシュコマンドは/で始まります。/helpを試してすべてのコマンドを確認してください

自然言語のプロンプトを入力してセッションを開始します。特別な構文を学ぶ必要はありません。

ステップ4: 最初の質問をする

Dropstoneにプロジェクトを探索させてみましょう。次のいずれかを試してください:

このプロジェクトは何をするものですか？

主要なエントリーポイントは何ですか？

フォルダ構造を説明してください

Dropstoneは必要に応じてファイルを読み、実際のコードへの引用付きで回答します。ファイルを貼り付けたり、手動でコンテキストを書いたりする必要はありません。

Dropstoneについても質問できます:

このプロジェクトで何ができますか？

どのコマンドを実行する許可が与えられていますか？

ステップ5: 最初のコード変更を行う

次に、小さな変更を説明してください。新しいプロジェクトの場合は、リスクの低いものを試してください:

プロジェクトの説明を1段落で書いたREADMEを追加してください

既存のプロジェクトの場合:

ユーザーを作成する関数に入力検証を追加してください

Dropstoneは次のことを行います:

関連するファイルを見つける
提案された変更をdiffとして表示する
書き込む前に承認を求める
結果を検証する（型チェック、テスト、利用可能な場合はlint）

権限

Dropstoneは、ファイルを編集したりシェルコマンドを実行したりする最初のときに承認を求めます。一度承認すると、同じセッション内の同じ操作は再プロンプトなしで実行されます。/permissionsを使用して、許可した内容を表示または取り消すことができます。

ステップ6: gitで作業する

Dropstoneはgitを第一級のツールとして扱います:

どのファイルを変更しましたか？

説明的なメッセージで変更をコミットしてください

feature/health-endpointというブランチを作成して切り替えてください

直近5件のコミットを表示してください

src/auth.tsのマージ競合を解決するのを手伝ってください

PRレベルのワークフロー（プルリクエストの作成、PR説明の生成、レビューコメントの投稿）については、GitHub統合を参照してください。

ステップ7: バグを修正するか、機能を追加する

やりたいことを平易な言葉で説明してください。Dropstoneがコードを特定し、コンテキストを理解し、変更を実装して検証します。

空の検索クエリがすべての結果を返すバグがあります - 修正してください

ビルド情報を返す/healthzエンドポイントをAPIサーバーに追加してください

メールが欠落しているとログインフォームがクラッシュします - 原因を調べて修正してください

タスクが複数のファイルにまたがる場合、Dropstoneは短い計画を書き、ステップバイステップで実行します。いつでもEscを押して中断し、方向を変えることができます。

ステップ8: 他の一般的なワークフローを試す

Dropstoneが得意とするパターンをいくつか紹介します:

リファクタリング

authモジュールをコールバックの代わりにasync/awaitを使用するようにリファクタリングしてください

テスト作成

電卓関数のユニットテストを書いてください

コードレビュー

ステージングされた変更をレビューして、リスクのあるものを指摘してください

ドキュメント

READMEのインストール手順にWSLのパスを含めるように更新してください

Tip

Dropstoneにはチームメイトのように話しかけてください。正確な手順ではなく、達成したいことを説明してください。実装の選択をエージェントに任せると、計画が最も得意です。

必須コマンド

実際に使用するいくつかのコマンド:

コマンド	機能	例
`dropstone`	現在のディレクトリで対話セッションを開始する	`dropstone`
`dropstone run "タスク"`	一回限りのタスクを実行して終了する	`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を終了する