クイックスタート

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）が表示されるはずです。バイナリはバックグラウンドで自動更新されるため、インストーラーを再実行しなくても最新の状態を維持できます。

ステップ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は次のことを行います:

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

権限:

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

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

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

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

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

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

最後の5つのコミットを表示してください

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

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

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

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

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

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

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

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

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

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

リファクタリング

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

テスト作成

電卓関数の単体テストを書いてください

コードレビュー

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

ドキュメント

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

ヒント:

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

必須コマンド

実際に使用するコマンドの一覧:

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