# Circleback CLI (/docs/ja/support/platform/circleback-cli)

コマンドラインからすべてにアクセスしたり、AIエージェントに作業を進めるために必要な会話のコンテキストを提供したりできます。OpenClawに、今朝のスタンドアップで出たアクションアイテムのフォローアップを任せられます。Claude Codeに、前回のプロダクトレビューをもとに仕様書の下書きを作成させることもできます。

## セットアップ

まず、[Circleback CLI](https://www.npmjs.com/package/@circleback/cli)をインストールします：

```
npm install -g @circleback/cli
```

次に、Circlebackアカウントにログインします：

```
cb auth login
```

ブラウザウィンドウが開き、ログインできます。ログインが完了すれば、すぐに使い始められます。

代わりにAPIキーでログインするには：

```
cb auth login --api-key
```

APIキーでのログインでは、[**設定 → APIキー**](https://circleback.ai/settings?tab=api-access)へのリンクが表示され、キーを検証して、デバイスにローカルに保存します。

ステートレスな自動化には、ログインする代わりに`CIRCLEBACK_API_KEY`を設定します：

```
CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
```

`CIRCLEBACK_API_KEY`は保存された認証情報よりも優先されます。

このデバイスでログアウトするには：

```
cb auth logout
```

## できること

Circleback CLIには、ミーティング、文字起こし、カレンダーの予定、メール、人物、企業など、Circlebackアカウントのデータを検索、取得、更新するためのコマンドがあります。

| コマンド | 説明 |
| -------------------------------- | --------------------------------------------------------------------------------------------- |
| `cb auth login` | ブラウザでCirclebackにログインします |
| `cb auth login --api-key` | APIキーでログインします |
| `cb auth logout` | このデバイスでログアウトします |
| `cb update` | CLIを最新バージョンに更新します |
| `cb meetings [search]` | ミーティングと文字起こしを検索します |
| `cb meetings read <ids...>` | ミーティングの詳細、ノート、アクションアイテムを読み取ります（最大50件のミーティング） |
| `cb meetings update <id>` | ミーティングを更新します |
| `cb meetings share <id>` | ミーティングを人、チーム、ワークスペース、リンクを知っている全員と共有するか、アクセス権を削除します |
| `cb transcripts read <ids...>` | 1件以上のミーティングの完全な文字起こしを、話者ラベルとタイムスタンプ付きで取得します |
| `cb action-items [search]` | キーワード、ステータス（未完了または完了）、担当者、タグ、企業、期間でアクションアイテムを検索します |
| `cb action-items create <title>` | アクションアイテムを作成します。`--assignee`を指定しない限り、自分に割り当てられます |
| `cb action-items update <id>` | アクションアイテムを更新します |
| `cb action-items delete <id>` | アクションアイテムを削除します |
| `cb calendar` | 今後および過去のカレンダーの予定を、予定ID、参加者、ミーティングリンクを含めて検索します |
| `cb calendar update <id>` | カレンダーの予定を更新します |
| `cb emails [search]` | 接続したメールアカウントから、キーワード、送信者、受信者、期間でスレッドを検索します |
| `cb people <names...>` | 名前で人物を検索し、プロフィールとミーティング全体でのやり取りの履歴を確認します |
| `cb companies <terms...>` | 名前またはドメインで企業を検索し、そのドメインと関連するミーティングを確認します |
| `cb teams` | ワークスペースとチームを、共有に使うIDとともに一覧表示します |
| `cb tags` | ワークスペース内のすべてのタグを一覧表示します。ミーティング、文字起こし、アクションアイテムの絞り込みに便利です |
| `cb tags create <name>` | タグを作成します。説明と色も指定できます |
| `cb tags update <id>` | タグの名前、説明、色を更新します |
| `cb tags delete <id>` | タグを削除し、すべてのミーティングから外します |
| `cb folders` | 表示できるフォルダをIDとともに一覧表示します |
| `cb folders read <ids...>` | フォルダのメンバー、チーム、ルールを取得します |
| `cb folders create <name>` | ワークスペースにフォルダを作成します |
| `cb folders update <id>` | フォルダの名前、説明、アイコン、色、公開範囲、ルールを更新します |
| `cb folders delete <id>` | フォルダを削除します |
| `cb folders share <id>` | フォルダを人、チーム、ワークスペース、リンクを知っている全員と共有するか、アクセス権を削除します |
| `cb support [search]` | Circlebackのサポートドキュメントからヘルプやハウツーガイドを検索します |

## 例

検索語を指定しない場合、`cb meetings`は過去7日間（`--folder`を指定した場合を除く）、`cb action-items`は過去30日間が対象になります。別の期間を検索するには、`--last`、`--from`、`--to`を追加します。

### ミーティング

特定のトピックに関するミーティングと文字起こしの抜粋を検索します：

```
cb meetings search "product review"
```

過去7日間のミーティングを検索します：

```
cb meetings search --last 7
```

期間を指定してミーティングを検索します：

```
cb meetings search --from 2026-04-01 --to 2026-04-18
```

自分と共有されたミーティングのうち、Acmeの人が含まれるものを検索します：

```
cb meetings search --ownership Shared --domains acme.com
```

ミーティングの詳細をすべて読み取ります：

```
cb meetings read abc123
```

複数のミーティングをまとめて読み取ります：

```
cb meetings read abc123 def456
```

メールアドレス（カンマ区切り）で人とミーティングを共有するか、リンクの閲覧アクセスをオンにします：

```
cb meetings share abc123 --email dana@acme.com,lee@acme.com --access Viewer --send-email
cb meetings share abc123 --link Viewer
```

ユーザーのアクセス権を削除するか、ミーティング自体のリンクをオフにします：

```
cb meetings share abc123 --profile 42 --access none
cb meetings share abc123 --link none
```

`cb teams`で確認したIDを使って、チームとミーティングを共有します：

```
cb meetings share abc123 --team 7 --access Viewer
```

ミーティングの名前を変更します：

```
cb meetings update abc123 --name "Pricing sync"
```

### 文字起こし

ミーティングの完全な文字起こしを取得します：

```
cb transcripts read abc123
```

複数のミーティングの文字起こしを取得します：

```
cb transcripts read abc123 def456
```

### アクションアイテム

未完了のアクションアイテムを検索します：

```
cb action-items search --status PENDING
```

キーワードでアクションアイテムを検索します：

```
cb action-items search "follow up"
```

完了したアクションアイテムを検索します：

```
cb action-items search --status DONE
```

担当者に関係なく、Acmeとのミーティングのアクションアイテムを検索します：

```
cb action-items search --assignee-type Anyone --domains acme.com
```

自分のチームのいずれかに割り当てられたアクションアイテムを検索します（IDは`cb teams`で確認できます）：

```
cb action-items search --team 7
```

アクションアイテムを作成して担当者を割り当てます（IDは`cb people`で確認できます）。`--assignee`を指定しない場合は自分に割り当てられます。未割り当てのままにするには`--assignee none`を使います：

```
cb action-items create "Send the renewal quote" --description "Include 2027 pricing" --assignee 42
```

編集できるミーティングにアクションアイテムをリンクします（IDは`cb meetings`で確認できます）：

```
cb action-items create "Send the renewal quote" --meeting abc123
```

アクションアイテムを完了にするか、担当者を外します：

```
cb action-items update 1234 --status DONE
cb action-items update 1234 --assignee none
```

アクションアイテムを削除します：

```
cb action-items delete 1234
```

### カレンダー

期間を指定してカレンダーの予定を表示します：

```
cb calendar search --from 2026-04-18 --to 2026-04-25
```

`cb calendar`で確認したIDを使って、今後の予定に準備用のメモを設定します。ミーティングが録音されると、このメモはプライベートノートに表示されます：

```
cb calendar update event123 --private-notes "Ask about the 2027 pricing"
```

### メール

キーワードでメールを検索します：

```
cb emails search "quarterly report"
```

参加者でメールを検索します：

```
cb emails search "participant:sarah@company.com"
```

特定の送信者からのメールを検索します：

```
cb emails search "from:ceo@company.com"
```

期間を指定してメールを検索します：

```
cb emails search "project update after:2026-01-01 before:2026-04-01"
```

### 人物

人物を検索します：

```
cb people search "Sarah Kerrigan"
```

### 企業

企業を検索します：

```
cb companies search "Acme"
```

### タグ

すべてのタグを一覧表示します：

```
cb tags list
```

タグを作成し、名前またはIDでミーティングのタグを設定します（カンマ区切り。現在のタグは置き換えられます）：

```
cb tags create Renewals --color emerald
cb meetings update abc123 --tags Renewals,7
```

タグの名前を変更するか、ミーティングのタグをすべて削除します：

```
cb tags update 7 --name "Q3 renewals"
cb meetings update abc123 --tags ""
```

### サポート

Circlebackのサポート記事を検索します：

```
cb support search "recording in-person meetings"
```

## 書き込みアクセス

作成、更新、削除には書き込みアクセスが必要です。v0.5.0より前のブラウザログインでは読み取りアクセスのみが付与されていたため、`cb auth login`を再度実行してください。読み取り専用のAPIキーでは変更できないため、[**設定 → APIキー**](https://circleback.ai/settings?tab=api-access)で読み取り・書き込み用のキーを使用してください。

## オプション

すべてのコマンドで`--json`を使ってJSONをそのまま出力できます。スクリプトの作成、ほかのツールへのパイプ、AIエージェントへのデータの受け渡しに便利です。

```
cb meetings search "standup" --last 7 --json
```