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

# 引数と JSON を渡す

コマンドの入力は、型に応じたフラグで渡します。入力全体を JSON で渡すこともできます。

## 型ごとの渡し方

| 入力の型 | 渡し方 | 例 |
| - | - | - |
| 文字列、数、選択肢 | `--kebab-case <値>` または `--kebab-case=<値>` | `--title "Sales 2026"` |
| 真偽値 | `--flag` または `--no-flag` | `--include-data` |
| 値の配列 | フラグを繰り返す | `--tag` sales `--tag` weekly |
| オブジェクト、オブジェクトの配列 | JSON 文字列、または @ファイル | `--pages @pages.json` |
| 長い文字列 | @ファイル（中身が値になります） | `--markdown @report.md` |

## 入力全体を JSON で渡す

```sh theme={null}
expl dashboard create --input dashboard.json
```

```sh theme={null}
cat dashboard.json | expl dashboard create --input -
```

`--input -` と書くと、JSON を標準入力から読みます。

* `--input` とフラグを両方渡すと、フラグが優先されます。ただし、値の配列は例外です。繰り返したフラグの値は、`--input` の JSON にある配列に追加されます。配列全体を置き換えるときは、JSON のほうを変えてください。
* 生成されたコマンドは、未知のフラグや余分な引数をエラー（終了コード 2）にして、近い名前を候補として示します。組み込みのコマンド（expl status、expl project use、expl lang、expl skill、expl completion）は、これらをエラーにしません。[共通フラグ](https://docs.exploratory.io/ja/cli/desktop/global-flags.md)を参照してください。
* 共通フラグと同じ名前の入力と、@ で始まる文字列そのものは、`--input` の JSON で渡してください。

## id は最初の引数で渡せます

必須の id が 1 つだけのコマンドは、その id を最初の引数で渡せます。`--chart-id` c789 のようにフラグで渡しても同じです。id が足りないときは、expl が見つけられる候補を示して、終了コード 2 で終了します。

```sh theme={null}
expl dashboard get d123
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.