Dropstone CLI

トラブルシューティングガイド

Dropstone CLIの問題を体系的に診断します。適切な情報を収集し、ログを見つけ、サポートに連絡する前に原因を切り分けます。

ほとんどの問題は、古いビルド、古いキャッシュ、不正な認証情報、またはネットワークの4つのいずれかに該当します。このページでは、それらを確認する順序と、どれも該当しない場合に収集すべき情報について説明します。

特定のエラーメッセージについては、一般的な問題から始めてください。実行時の動作や機能別のデバッグについては、CLIトラブルシューティングを参照してください。

最初に試すべき3つのこと

他の何よりも先にこれらを実行してください。これらで驚くほど多くの報告が解決します。

# 1. 最新版にする
dropstone update

# 2. Dropstoneが実際に何をしているか確認する
dropstone --log-level DEBUG --print-logs
  1. セッション中に失敗が発生し、原因が不明な場合は、キャッシュをクリアして再起動します:
rm -rf ~/.cache/dropstone

Windowsでは、WIN+Rを押して%USERPROFILE%\.cache\dropstoneを削除します。

他のものを削除する前に

上記の3つのコマンドは安全です。~/.local/share/dropstoneの削除は安全ではありません — そこには認証情報とセッション履歴が保存されています。そのディレクトリを削除する前に状態の保存場所を参照してください。

状態の保存場所

Dropstoneがディスクに保持するすべてのものは、2つのディレクトリに格納されています。

内容macOS / LinuxWindows
認証情報とセッション~/.local/share/dropstone/%USERPROFILE%\.local\share\dropstone
ログ~/.local/share/dropstone/log/%USERPROFILE%\.local\share\dropstone\log
キャッシュ~/.cache/dropstone/%USERPROFILE%\.cache\dropstone

データディレクトリ内:

  • auth.json — 認証情報。クリーンなサインインを強制する場合にのみ削除します。
  • log/ — タイムスタンプ付きのログ。最新の10件が保持されます。
  • project/ — プロジェクトごとのセッション履歴。

ログファイルは書き込まれた時刻に基づいて命名されます。例: 2026-05-23T123456.log。最新のものが目的のファイルです。

読む価値のあるログを取得する

デフォルトではログレベルは静かです。2つのフラグで変更できます:

# 詳細な出力をログファイルに書き込む
dropstone --log-level DEBUG

# 同じ出力を発生時にターミナルにストリーミングする
dropstone --print-logs

失敗の発生を確認しながら、後でファイルも残したい場合は、両方を一緒に使用します。

起動時のクラッシュが問題の場合は、--print-logsが役立ちます: プロセスが終了する前にログファイルが書き込まれない可能性がありますが、stderrは常に書き込まれます。

レポートに含めるべき内容

以下の5つの項目を含むレポートは、通常1回の返信で解決します。これらがないレポートは、通常4回の返信が必要です。

  1. 実行した正確なコマンド。 言い換えではなく、フラグを含む文字通りの行。

  2. 期待したことと、実際に起こったこと。 両方の半分。「失敗しました」だけでは何も絞り込めません。

  3. バージョンとプラットフォーム。

    dropstone --version

    さらに、OSとバージョン、ネイティブWindowsかWSL内かを記載します。

  4. 関連するログの抜粋。 エラーの前後の数行で、ファイル全体ではありません。機密情報は編集してください — セッションログにはファイルパスやコードが含まれる場合があります。

  5. 再現可能かどうか。 常に、時々、または一度だけ。「時々」は言及する価値があります。それは悪い入力ではなく、タイミングや状態を指し示します。

dropstone.io/contactに送信してください。

原因の絞り込み

原因がまだ明らかでない場合は、一度に1つずつ変数を排除します。それぞれがカテゴリ全体を削除します。

プロジェクトが原因ですか? 空のディレクトリでDropstoneを実行します。そこで動作する場合、問題はプロジェクトに限定されています — 設定ファイル、ルールファイル、またはエージェントが読み取っているリポジトリ内の何かが原因の可能性があります。

設定が原因ですか? dropstone.jsonを一時的に移動して再起動します。グローバルおよびプロジェクトの設定ファイルの場所については、設定を参照してください。

MCPサーバーが原因ですか? 起動時にハングするサーバーは、セッション全体を停止させます。それらを一覧表示して無効にし、一度に1つずつ再度有効にします:

dropstone mcp list

ネットワークが原因ですか? 企業プロキシは、他の問題のように見える失敗の最も一般的な原因です。確認:

curl -I https://dropstone.io

これが失敗するか、予期しないものを返す場合は、ネットワークとプロキシを参照してください。通常の修正はHTTPS_PROXYを設定し、重要なのはNO_PROXY=localhost,127.0.0.1を設定することです — Dropstoneはインタラクティブセッション中にローカルループバックを使用し、それをプロキシ経由でルーティングするとループが発生します。

認証情報が原因ですか? サインアウトしてサインインし直します:

dropstone auth logout
dropstone auth login

ターミナルが原因ですか? Linuxでは、コピー＆ペーストにクリップボードユーティリティのインストールが必要です。CLIトラブルシューティングを参照してください。

Windowsが原因ですか? ネイティブWindowsでの遅いファイルアクセス、ターミナルの不具合、パスの問題は、通常WSLでは解消されます。WindowsとWSLを参照してください。

サポートに連絡する前に

関連情報

Ctrl+I