# CLI

arrakis コマンドで、ターミナルからマシンを検索、レンタル、管理します。

> `arrakis` コマンドはまもなく一般公開されます。このコマンドでできることは、すべてコンソール、MCP、API でも行えます。

## サインイン

CLI は API トークンを使います。**API & agents** でトークンを作成し、次を実行します：

```sh
export ARRAKIS_TOKEN=ark_...
arrakis whoami
```

`arrakis market` はトークンなしで使えます。

## 検索してレンタルする

```sh
arrakis market
arrakis gpus search --gpu-type B200
arrakis instances create --node-id <node> --termination-hours 4 --ssh-public-key ~/.ssh/id_ed25519.pub
```

必要に応じて `--gpu-count`、`--template-id`、`--idempotency-key` を付けます。加工前の出力が必要なら `--json` を付けます。

## イメージ

```sh
arrakis images list
arrakis images add vllm/vllm-openai:v0.11.0 --start image
arrakis instances create --node-id <node> --image vllm/vllm-openai:v0.11.0 --start image --termination-hours 2
```

`--image` には任意の公開イメージを指定できます。課金の前に、そのイメージのレジストリで確認されます。プライベートイメージは、まず `arrakis images add IMAGE --username NAME --password-stdin` で保存し、`--template-id` を指定してレンタルします。[イメージ](/ja/docs/images)を参照してください。

## マシンを管理する

```sh
arrakis instances list
arrakis instances get <id>
arrakis instances schedule-removal <id> --in 3h
arrakis instances terminate <id>
```

## 支払い

```sh
arrakis billing status
arrakis billing add 50
arrakis billing auto-recharge --on --threshold 20 --amount 50
arrakis billing stop
```

`billing add` は Stripe の支払いページを開きます。`billing stop` はすべてのマシンを停止し、レンタルを一時停止します。

## エージェント用トークン

```sh
arrakis tokens create --name eval-agent --scope read --scope rent --spend-limit 50 --max-rental-hours 6
```

## MCP をローカルで実行する

```sh
arrakis mcp
```

`ARRAKIS_TOKEN` を設定した状態で、ローカルのエージェントに同じツールを stdio で提供します。

その他：[すべてのドキュメント](/ja/docs.md) · [OpenAPI](/openapi.json) · [llms.txt](/ja/llms.txt)