メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Devin CLI の起動

デフォルトでは、セッションは REPL で行われます。REPL は、Devin と対話しながらその動作を確認できるグラフィカルなターミナル インターフェースです。
devin                            # インタラクティブREPLを起動(プロンプトなし)
devin -- your prompt here        # 初期プロンプトを指定してREPLを起動
devin -p "prompt"                # シングルターン(REPLなし):標準出力にレスポンスを表示して終了
devin -p -- prompt words here    # 同上(-- セパレーターを使用、こちらも有効)
サブコマンドではなくプロンプトとして解釈されるよう、プロンプトの前に -- を付けてください。
シングルターンモード (-p) は、スクリプトや自動化での利用に最適です。
プロンプト入力欄で @ を入力すると、ローカルのファイルやディレクトリのオートコンプリートが表示されます。1 つ選択すると、メッセージの前提情報として追加されます。
Ctrl+V でクリップボードから画像を貼り付けられます。アタッチされた画像は入力欄に表示され、Left/Right で切り替え、Backspace で削除できます。

シェルコマンドの実行

Devin は作業中にシェルコマンドを実行することがあります。コマンドが既定の待機時間を過ぎても完了しない場合、Devin はそのコマンドをバックグラウンドに移し、待機時間とバックグラウンドのシェル ID を表示します。その後も、Devin は作業を続けながら、あとでコマンドの出力を確認できます。

モード

Devin CLI には、4 つの組み込み権限モード (NormalAccept EditsBypassAutonomous) と、3 つのエージェントモード (NormalPlanAsk) があります。Plan と Ask を使う場合は、/plan/ask を利用してください。

Normal

現在のディレクトリ内での読み取り専用のツール操作は自動承認され、書き込みや実行を伴う操作では権限の確認が求められます。
/normal
# または
/mode normal
これがデフォルトのモードです。
ワークスペース内のファイル編集は自動承認されますが、シェルコマンドやその他のアクションについては引き続き確認が求められます。通常は、このモードで作業する時間が最も長くなることを想定しています。
/accept-edits
# または
/mode accept-edits
書き込みやシェルコマンドを含む すべて のツール呼び出しを自動承認します。
/bypass
# または
/mode bypass
Bypass モードで開始することもできます。
devin --permission-mode bypass
エイリアス: /yolo, /dangerous
Bypass モードでも、管理者が Team Settings で設定した組織レベルの権限が上書きされることはありません。管理者によって強制された deny ルールと ask ルールが常に優先されます。
現在のワークスペースでは Accept Edits とほぼ同等ですが、それに加えて OS-level sandbox 内で任意のシェルコマンドを実行できます (それらのコマンドが実際にアクセスできる範囲を制限するためです) 。
devin --sandbox --permission-mode autonomous
--sandbox を付けて実行する場合に利用できる権限モードは Autonomous だけで、自動的に選択されます。Normal、Accept Edits、Bypass はサンドボックス セッションでは表示されません。Autonomous モードでは…
  • コマンドではなく capabilities について確認が求められます。
    • コマンドは、ファイルシステム サンドボックスを通じて WriteRead のスコープに従います。
    • コマンドがネットワークリソースへの接続を試みると、確認が表示されます。
  • 現在のディレクトリ内での読み取り専用操作は自動承認されます。
Autonomous は安全性をサンドボックスに依存しています。--sandbox なしではこのモードは利用できません。OS レベルの分離なしで無人実行したい場合は、Bypass を利用してください。直接比較については、以下の Bypass vs Autonomous を参照してください。

Bypass と Autonomous

Bypass と Autonomous はどちらも承認プロンプトを減らしますが、採用している安全メカニズムは異なります。
BypassAutonomous
--sandbox が必要いいえはい (サンドボックス セッションでのみ利用可能)
シェルコマンド自動承認、無制限自動承認、サンドボックス内に制限される
edit/write ツールによるファイル書き込みどこでも自動承認引き続き承認を求める (スコープを付与するとサンドボックスが拡張される)
ネットワークアクセス無制限サンドボックスのドメイン許可/拒否リストでフィルタリングされる
管理者のTeam Settingsを尊重するはいはい
エージェントにマシン全体を任せられるなら、Bypass を選んでください。エージェントがアクセスできるファイルやドメインを OS レベルで制限しつつ無人実行したい場合は、--sandbox (Autonomous が選択されます) を選んでください。Bypass のような使い勝手が好みで、エージェント専用のコンピューターも持たせたいなら、cloud Devin を試してみてください。

セッション履歴

会話の履歴は保存されるため、後でセッションを再開できます。
devin -c              # 現在のディレクトリで最新のセッションを続行する
devin --continue

devin -r              # 最近のセッションから選択する
devin --resume
devin -r brisk-otter  # IDで特定のセッションを再開する

スラッシュコマンド

アクティブなセッション中に、これらのコマンドを利用できます。
コマンド説明
/help使用可能なすべてのコマンドを表示
/exit or /quitアプリケーションを終了
/clear or /new会話履歴を消去 (最初から開始)
/ プレフィックスなしで、プレーンテキストとして exit または quit と入力して終了することもできます。

モードの切り替え

コマンド説明
/mode現在のモードを表示
/mode <name>モードを切り替え (normalaccept-editsplanbypass。サンドボックス セッションでは autonomous)
/normalNormal モードに切り替え (デフォルト)
/planPlan モードに切り替え
/ask <question>コードを変更せずに質問する (oneshot)
/bypassBypass モードに切り替え (エイリアス: /yolo/dangerous)

モデルの切り替え

コマンド説明
/modelモデル選択画面を表示

セッション管理

コマンド説明
/resume対話型のセッション選択画面を開く
/resume <id>IDを指定してセッションを再開する
/ls現在のディレクトリ内にある最近のセッションを一覧表示する (別名: /list-sessions)
/ls --allすべてのディレクトリにまたがる全セッションを一覧表示する
/continue最新のセッションを再開する
/continue <id>IDを指定してセッションを再開する
/rm-session <id>IDを指定してセッションを完全に削除する

ワークスペース

コマンド説明
/workspaceワークスペース ディレクトリを一覧表示 (エイリアス: /workspaces)
/add-dir <path>ワークスペース ディレクトリを追加
/undo-add-dir <path>ワークスペース ディレクトリを削除

自動化

コマンド説明
/loop <prompt>プロンプトを実行し、その後、差分の Auto-review をループで繰り返します (開始するには git の状態がクリーンである必要があります)

拡張性

コマンド説明
/hooks読み込まれているすべてのフックを、ID、イベントタイプ、ソースパスとともに一覧表示します

アカウントとシステム

コマンド説明
/loginDevinにログインする
/logout保存された認証情報を削除して終了する
/updateアップデートを確認してインストールする
/upgradeサブスクリプションプランをアップグレードする
/bugDevin CLIの開発者にバグを報告する
/compact会話を強制的に圧縮する
Homebrew経由でDevin for Terminalをインストールした場合、/update を実行すると、自己アップデートの代わりに brew upgrade devin を利用するよう案内されます。

キーボード ショートカット

以下は、特に重要なキーボード ショートカットです。その他のショートカットについては、Keyboard Shortcutsを参照してください。
ショートカット説明
Shift+Tabモード (Normal、Accept Edits、Plan、Bypass、Autonomous) を順に切り替える
Ctrl+C入力テキストをクリアする、または実行中のエージェントをキャンセルする
Esc実行中のエージェントをキャンセルする
Shift+Enter改行を挿入する (複数行入力)
Ctrl+V or Shift+Insertクリップボードから貼り付ける
Ctrl+G外部エディタを開く
Ctrl+O全画面の思考トレース ビューアを開く
@前提情報に追加するファイルをメンションする