> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# コマンドとフラグ

> コマンド引数、サブコマンド、対話型スラッシュコマンドの完全リファレンス

<div id="usage">
  ## 使い方
</div>

```bash theme={null}
devin [OPTIONS] [prompt]
```

任意のプロンプトを指定して初期メッセージ付きのセッションを開始するか、引数を指定せずに対話モードで起動できます。

これらの内容は、ターミナルで `man devin` を実行して確認することもできます。

***

<div id="global-flags">
  ## グローバルフラグ
</div>

| Flag                        | Short | Description                                                   |
| --------------------------- | ----- | ------------------------------------------------------------- |
| `--model <MODEL>`           |       | このセッションで利用する AI モデルを設定します                                     |
| `--permission-mode <MODE>`  |       | 権限モード (`normal`, `dangerous`, `bypass`)                       |
| `--continue`                | `-c`  | 現在のディレクトリで直近のセッションを再開します                                      |
| `--resume <SESSION_ID>`     | `-r`  | ID を指定して特定のセッションを再開します                                        |
| `--print [PROMPT]`          | `-p`  | 応答を表示して終了します (非対話型モード) 。インラインプロンプトを省略可能で指定できます。               |
| `--prompt-file <FILE>`      |       | ファイルから初期プロンプトを読み込みます                                          |
| `--config <PATH>`           |       | 設定ファイルのパス                                                     |
| `--export [PATH]`           |       | 各ターンの終了後に会話をファイルへエクスポートします (ATIF 形式) 。指定がない場合はデフォルトのパスを利用します。 |
| `--respect-workspace-trust` |       | ワークスペースの信頼設定を尊重するかどうか                                         |

**使用例:**

```bash theme={null}
devin -- add a login page
devin --model opus -- refactor the auth module
devin -c                              # 最後のセッションを再開
devin -r abc12345                     # 特定のセッションを再開
devin -p "list all TODO comments"    # レスポンスを出力して終了
devin -p -- list all TODO comments    # 同上（-- セパレーターを使用、動作は同じ）
devin --export -- fix the tests       # 会話をデフォルトパスにエクスポート
devin --export out.json -- fix tests   # 特定のファイルにエクスポート
```

***

<div id="subcommands">
  ## サブコマンド
</div>

<div id="devin-auth">
  ### devin auth
</div>

認証関連のコマンド。

| コマンド                | 説明                  |
| ------------------- | ------------------- |
| `devin auth login`  | アカウントにログイン          |
| `devin auth logout` | ログアウトし、保存された認証情報を削除 |
| `devin auth status` | 認証状態を確認             |

**`devin auth login` のオプション:**

* `--force-manual-token-flow` — ブラウザでの認証をスキップし、トークンを手動で貼り付けます (リモート/SSHセッションで便利)

<div id="devin-mcp">
  ### devin mcp
</div>

Model Context Protocol サーバーに接続してログインします。

| コマンド                       | 説明                            |
| -------------------------- | ----------------------------- |
| `devin mcp add <name>`     | 新しい MCP サーバーを追加               |
| `devin mcp list`           | 設定済みの MCP サーバーをすべて一覧表示        |
| `devin mcp get <name>`     | 特定の MCP サーバーの詳細を表示            |
| `devin mcp remove <name>`  | 設定済みの MCP サーバーを削除             |
| `devin mcp login <name>`   | OAuth を使用して MCP サーバーで認証       |
| `devin mcp logout <name>`  | MCP サーバー用に保存された OAuth 認証情報を削除 |
| `devin mcp enable <name>`  | 無効化されている MCP サーバーを有効化         |
| `devin mcp disable <name>` | MCP サーバーを削除せずに無効化             |

**`devin mcp add` のオプション:**

* `-t, --transport <stdio|http>` — トランスポートの種類 (省略可。URL からは `http`、後続の引数からは `stdio` を推測)
* `-s, --scope <local|project|user>` — 設定スコープ (デフォルト: `local`)
* `--url <URL>` — HTTP トランスポート用の URL (name の後に位置引数として渡すことも可能)
* `--command <CMD>` — stdio トランスポート用のコマンド (後続の引数を指定する場合は省略可)
* `-e, --env <KEY=VALUE>` — 環境変数 (複数回指定可)
* `-H, --header <HEADER: VALUE>` — HTTP ヘッダー (複数回指定可)
* `--scopes <SCOPE,SCOPE>` — 要求する OAuth スコープ (カンマ区切り)
* `<URL>` — HTTP 用の位置引数の URL (`--url` の代替)
* `-- <COMMAND> [ARGS...]` — stdio 用のコマンドと引数 (`--command` を省略した場合、最初の引数がコマンド)

<Note>
  HTTP サーバーはまず Streamable HTTP を試し、4xx エラーではレガシー SSE にフォールバックします ([MCP spec](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility) に準拠) 。`"transport": "sse"` を明示的に設定することもできます。[MCP の設定 → Troubleshooting](/ja/cli/extensibility/mcp/configuration#troubleshooting) も参照してください。
</Note>

**使用例:**

```bash theme={null}
# stdioサーバー
devin mcp add my-server -- npx @company/mcp-server --port 3000

# HTTPサーバー（位置引数でURLを指定）
devin mcp add notion https://mcp.notion.com/mcp
devin mcp add --transport http datadog-mcp https://mcp.datadoghq.com/api/unstable/mcp-server/mcp

# HTTPサーバー（--urlフラグでも指定可能）
devin mcp add notion --url https://mcp.notion.com/mcp

# 環境変数とスコープを指定する場合
devin mcp add -e GITHUB_TOKEN=ghp_xxx github -- npx -y @modelcontextprotocol/server-github
devin mcp add -s project sentry https://mcp.sentry.dev/mcp
```

**`devin mcp remove` のオプション:**

* `-s, --scope <local|project|user>` — 設定スコープ (デフォルト: `local`)

**`devin mcp login` のオプション:**

* `--scopes <SCOPE,SCOPE>` — 要求する OAuth スコープ (カンマ区切り)

**`devin mcp enable` のオプション:**

* `-s, --scope <local|project|user>` — 設定スコープ (デフォルト: `local`)

**`devin mcp disable` のオプション:**

* `-s, --scope <local|project|user>` — 設定スコープ (デフォルト: `local`)

詳しくは [MCP の設定](/ja/cli/extensibility/mcp/configuration) を参照してください。

<div id="devin-rules">
  ### devin rules
</div>

エージェントルール (常時適用される前提情報) を管理します。

| Command                   | Description        |
| ------------------------- | ------------------ |
| `devin rules list`        | 利用可能なルールをすべて表示します  |
| `devin rules show <name>` | 特定のルールの詳細を表示します    |
| `devin rules paths`       | ルールディレクトリの場所を表示します |

**`devin rules list` のオプション:**

* `--provider <cursor\|windsurf>` — ルールプロバイダーで絞り込みます

詳しくは [Rules](/ja/cli/extensibility/rules) を参照してください。

<div id="devin-skills">
  ### devin skills
</div>

エージェントのスキル (スラッシュコマンドおよびエージェントによってトリガーされる前提情報) を管理します。

| Command                    | 説明                |
| -------------------------- | ----------------- |
| `devin skills list`        | 利用可能なすべてのスキルを一覧表示 |
| `devin skills show <name>` | 特定のスキルの詳細を表示      |
| `devin skills paths`       | スキルディレクトリの場所を表示   |

**`devin skills list` のオプション:**

* `--trigger <user\|model>` — トリガーの種類で絞り込み

詳細は [スキル](/ja/cli/extensibility/skills/overview) を参照してください。

<div id="devin-list">
  ### devin list
</div>

現在のディレクトリ内のセッションを一覧表示します。エイリアス: `devin ls`

| コマンド                       | 説明                    |
| -------------------------- | --------------------- |
| `devin list`               | 対話型のセッション選択画面 (デフォルト) |
| `devin list --format json` | セッションをJSON形式で出力       |
| `devin list --format csv`  | セッションをCSV形式で出力        |

<div id="devin-version">
  ### devin version
</div>

現在のバージョンを表示して終了します。

```bash theme={null}
devin version
```

これは `devin --version` と同じです。

<div id="devin-acp">
  ### devin acp
</div>

Devin を、stdio 経由で [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) サーバーとして実行します。このサブコマンドは、ACP 対応のエディタや IDE (Windsurf や Zed など) からサブプロセスとして呼び出されることを想定しています。stdin/stdout 経由で JSON-RPC を使用するため、対話的な実行は想定されていません。

```bash theme={null}
devin acp
```

ACP サーバーは、`WINDSURF_API_KEY` が設定されていればそこから認証情報を読み取り、設定されていない場合は `devin auth login` で保存された認証情報を読み取ります。また、ACP の `authenticate` リクエストを通じて、実行時に認証情報を受け取ることもできます。

<div id="devin-update">
  ### devin update
</div>

更新を確認し、必要に応じてインストールします。

```bash theme={null}
devin update
```

すでに最新バージョンがインストールされている場合でも、`--force` を利用して再インストールできます：

```bash theme={null}
devin update --force
```

<div id="devin-shell">
  ### devin shell
</div>

\[機能プレビュー] シェル統合用のコマンドです。詳細は [Shell Integration](/ja/cli/shell-integration) を参照してください。

| コマンド                        | 説明                                           |
| --------------------------- | -------------------------------------------- |
| `devin shell setup`         | シェル設定ファイルにシェル統合をインストールします                    |
| `devin shell setup <shell>` | 特定のシェル (`bash`、`zsh`、または `fish`) 用にインストールします |

<div id="devin-sandbox">
  ### devin sandbox
</div>

\[研究プレビュー] exec ツールの OS レベルのプロセス サンドボックス化を管理します。グローバル `--sandbox` フラグを指定すると、サンドボックスを有効にしてセッションを実行できます。

<div id="devin-sandbox-setup">
  #### devin sandbox setup
</div>

現在のプラットフォームで必要なサンドボックスの前提条件を表示します。

`--sandbox` で実行するための要件:

* **Linux**: bubblewrap (`bwrap`) と `socat` が必要です。どちらか一方でも不足している場合、サンドボックスのセッションは起動に失敗し、インストール手順が表示されます。これには、新規の WSL ディストリビューションも含まれます。
* **macOS**: Seatbelt によりそのまま利用できます。追加のパッケージは不要です。
* **Windows**: ネイティブの Windows ではサンドボックスを実行できません。[WSL 2 をインストール](https://learn.microsoft.com/windows/wsl/install) し、WSL ディストリビューション内で Devin を実行してください。

```bash theme={null}
devin sandbox setup
```

<div id="devin-setup">
  ### devin setup
</div>

認証とMCPの設定を行う対話形式のセットアップウィザード。

```bash theme={null}
devin setup
devin setup --force-manual-token-flow  # リモート/SSHセッション用
```

<div id="devin-uninstall">
  ### devin uninstall
</div>

Devin CLI をアンインストールし、必要に応じてすべてのデータも削除します。

| オプション     | 説明                            |
| --------- | ----------------------------- |
| `--clean` | 設定、履歴、カスタムデータを含むすべてのデータを削除します |
| `--force` | 確認を省略します                      |

***

<div id="slash-commands">
  ## スラッシュコマンド
</div>

これらのコマンドは、インタラクティブなセッション内で使用できます。プロンプトで入力してください。

<div id="mode-model">
  ### モードとモデル
</div>

| Command                                                         | Description                                                   |      |           |                                                         |
| --------------------------------------------------------------- | ------------------------------------------------------------- | ---- | --------- | ------------------------------------------------------- |
| \`/mode \[normal                                                | accept-edits                                                  | plan | bypass]\` | 現在のモードを表示または切り替えます (`autonomous` はサンドボックス セッションで利用できます) |
| `/normal`                                                       | Normal モードに切り替えます (デフォルト)                                     |      |           |                                                         |
| `/accept-edits`                                                 | Accept Edits モードに切り替えます (ワークスペース 内のファイル編集を自動承認)               |      |           |                                                         |
| `/plan`                                                         | Plan モードに切り替えます (読み取り専用で計画を立てます)                              |      |           |                                                         |
| `/ask <question>`                                               | コード変更を行わずに質問します (ワンショット)                                      |      |           |                                                         |
| `/bypass`                                                       | Bypass モードに切り替えます (すべての操作を自動承認)                               |      |           |                                                         |
| `/model [name]`                                                 | 現在のモデルを表示または変更します                                             |      |           |                                                         |
| `/fast`                                                         | SWE-1.6 Fast に切り替えます                                          |      |           |                                                         |
| `/theme [dark\|light\|terminal-dark\|terminal-light\|no-color]` | テーマを切り替えます (dark、light、terminal dark、terminal light、no color) |      |           |                                                         |

<Note>
  `/bypass` には `/yolo` と `/dangerous` というエイリアスがあります。いずれも同じ動作をします。
</Note>

<div id="session-management">
  ### セッション管理
</div>

| コマンド                          | 説明                                                                           |
| ----------------------------- | ---------------------------------------------------------------------------- |
| `/clear`                      | 会話履歴を消去し、新しいセッションを開始します。別名: `/new`                                           |
| `/continue [session-id]`      | 以前のセッションを再開します                                                               |
| `/fork [step]`                | 現在のセッションを新しいセッションとして分岐します。必要に応じて、特定のステップから分岐できます (`/steps`を参照) 。             |
| `/steps`                      | 会話のステップを一覧表示します (`/fork` や `/revert` とあわせて利用します)                             |
| `/revert <step>`              | 特定のステップ以降のファイル変更を元に戻し、会話をそのステップの直前まで巻き戻します                                   |
| `/resume [session-id]`        | 対話型のセッション選択画面を開くか、ID を指定して特定のセッションを再開します                                     |
| `/ls [--all]`                 | 最近のセッションを一覧表示します (既定では現在のディレクトリ内のみ) 。別名: `/list-sessions`                    |
| `/rename-session <new title>` | 現在のセッション名を変更します                                                              |
| `/rm-session <session-id>`    | セッションとそのすべてのデータを完全に削除します                                                     |
| `/export`                     | エクスポート情報を表示します。会話のエクスポートを有効にするには、CLI フラグ `--export` を利用します。                  |
| `/exit`                       | アプリケーションを終了します (別名: `/quit`) 。`/` プレフィックスなしで `exit` または `quit` と入力することもできます。 |

<div id="workspace">
  ### ワークスペース
</div>

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

<div id="automation">
  ### 自動化
</div>

| Command          | 説明                                                                       |
| ---------------- | ------------------------------------------------------------------------ |
| `/loop <prompt>` | プロンプトを実行し、その後、差分の自動レビューをループで繰り返します                                       |
| `/btw <prompt>`  | ちょっとした脇道の質問をします。現在の会話の前提情報を使ってサイドチェーンを実行し、質問をメインの会話に追加せず、回答をボックス内に表示します。 |

<div id="extensibility">
  ### 拡張性
</div>

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

<div id="utilities">
  ### ユーティリティ
</div>

| コマンド                 | 説明                                                       |
| -------------------- | -------------------------------------------------------- |
| `/help`              | 利用可能なスラッシュコマンドを表示する                                      |
| `/shortcuts`         | カテゴリ別にグループ化された、対話形式で検索可能なキーボード ショートカットの一覧を表示する           |
| `/bug [description]` | Devin CLI の開発チームにバグを報告する                                 |
| `/update [--force]`  | 更新を確認してインストールする。すでに最新バージョンでも再インストールするには、`--force` を指定する。 |
| `/upgrade`           | サブスクリプションプランをアップグレードする                                   |
| `/login`             | アカウントで認証する                                               |
| `/logout`            | 保存されている認証情報を消去して終了する                                     |
| `/context`           | 前提情報ウィンドウの使用量を表示する                                       |
| `/usage`             | 再開したセッションで以前開いた際の使用量も含め、このセッションの推定クレジット/ACU使用量を表示する      |
| `/compact`           | 会話を強制的に圧縮する                                              |

<div id="cloud-sessions-insiders-only">
  ### Cloud Sessions (insiders限定)
</div>

| Command                      | Description                                                                                                             |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `/cloud-sessions [--all]`    | 最近の cloud Devin セッションを対話形式で選択できるピッカーを開きます。矢印キーで移動し、入力して絞り込み、Enter でアタッチ、Esc でキャンセルします。組織全体のセッションを表示するには `--all` を指定します。 |
| `/cloud-attach <session-id>` | 完全な TUI レンダリングと双方向入力に対応した cloud Devin セッションにアタッチします。                                                                    |

***

<div id="modes">
  ## モード
</div>

モードでは、権限モードとエージェントプロファイルを組み合わせて、エージェントの自律性レベルを制御します。

<Tabs>
  <Tab title="Normal（デフォルト）">
    複雑なコーディングタスク向けの完全自律モードです。エージェントは通常の権限チェックのもとで、読み取り、書き込み、コマンド実行を行えます。

    * **Permission mode:** Normal
    * **Profile:** Normal
    * **Use for:** 複数ファイルにまたがるリファクタリング、機能実装、バグ修正
  </Tab>

  <Tab title="Plan">
    計画のみを行うモードです。エージェントは変更を提案しますが、実際には加えません。読み取り専用のツールアクセスにより、コードは変更されません。

    * **Permission mode:** Normal
    * **Profile:** Plan (read-only tools)
    * **Use for:** アーキテクチャ設計、コードベースの理解、実装前の計画
  </Tab>

  <Tab title="Bypass">
    すべての権限プロンプトが自動承認されます。エージェントは確認を求めることなく自由に実行します。

    * **Permission mode:** Dangerous
    * **Profile:** Normal
    * **Use for:** 中断によって作業効率が落ちる、信頼できるタスク

    <Warning>
      Bypass モードは、十分に信頼できるタスクにのみ利用してください。すべてのツール呼び出し (破壊的なコマンドを含む) は自動承認されます。
    </Warning>
  </Tab>
</Tabs>

`/mode` でモードを切り替えるか、`/normal`、`/accept-edits`、`/plan`、`/bypass` で直接切り替えます。モードを切り替えずに質問するには、ワンショットコマンドとして `/ask <question>` を利用します。

***

<div id="profiles">
  ## プロファイル
</div>

プロファイルによって、エージェントが利用できるツールや動作が決まります。モードを切り替えると、プロファイルは自動的に設定されます。

| Profile  | Description                                           | Tool Access                                                          |
| -------- | ----------------------------------------------------- | -------------------------------------------------------------------- |
| `normal` | フル機能のコーディングアシスタント (Normal、Accept Edits、Bypass モードで使用) | すべてのツール                                                              |
| `plan`   | 構造化された計画ワークフロー (Plan モードで使用)                          | 読み取り専用ツール (grep、glob、read、todo、ask\_user\_question、exit\_plan\_mode) |
| `ask`    | 質問応答 (`/ask` コマンドで使用)                                 | 読み取り専用ツール (grep、glob、read、todo、ask\_user\_question)                  |
