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

# CLI ツール

> Happycapy のサンドボックスでコマンドラインツールを実行します。

## 概要

CLI（command-line interface、コマンドラインインターフェース）は、ボタンではなくコマンドで実行するツールです。多くのサービスは CLI を提供しており、リポジトリ、ドキュメント、デプロイ、ログ、ワークスペースデータをプログラム的に扱えます。

Happycapy では、それらのコマンドを覚える必要はありません。やりたいことを自然言語で伝えると、Happycapy が CLI をインストールし、適切なコマンドを選び、サンドボックスで実行し、出力を読み取り、同じプロジェクトの中で作業を続けられます。

CLI は GitHub、Notion、Lark、Fly.io のような外部サービスに接続する場合もあります。サンドボックス内のファイル、コード、メディア、データを扱うローカルユーティリティとして使う場合もあります。

## CLI ツールを使う場面

サービスが便利な操作をコマンドとして提供している場合、CLI ツールが向いています。

* リポジトリ、Pull Request、Issue、ログ、デプロイを扱う
* Notion や Lark などのワークスペースシステムを読み取る、更新する
* クラウド、データベース、インフラのコマンドを実行する
* 繰り返し使うコマンドライン作業をプロジェクトのワークフローにする

## CLI と MCP の使い分け

Happycapy では、CLI と MCP の使用感はかなり似ています。自然言語で目的を伝えると、エージェントが必要なツール呼び出しやコマンドを判断します。

違いは主に接続方式です。CLI ツールでは、Happycapy がサンドボックス内でコマンドラインプログラムを書いて実行します。[MCP](/ja/integrations/mcp) では、Happycapy が MCP サーバーから提供されたツールを呼び出します。

サービスに保守された公式 CLI がある場合や、デプロイ、ログ、スクリプト、ファイル処理、一回限りの設定が中心なら、CLI が直接的です。保守された MCP サーバーがある場合や、ツール操作を構造化されたインターフェースとしてエージェントに渡したい場合は、MCP が合うことがあります。両方ある場合は、公式に保守され、権限が分かりやすく、設定が簡単な方を選びます。

## 始める前に

あると便利な情報：

* 公式 CLI 名またはインストールリンク
* 接続したいアカウント、ワークスペース、リポジトリ、アプリ
* 必要な認証方法。ログインフロー、token、API key、ワークスペース権限など
* セットアップ後に Happycapy に完了してほしい結果

## 初回利用

Happycapy にツールと目的を伝えます。

```text theme={null}
Happycapy のサンドボックスに [CLI 名] をインストールして。
続行する前に、必要な認証方法を説明して。
準備できたら、それを使って [目標] を完了して。

CLI リンク: [公式リンク]
```

## おすすめ CLI

これらの CLI は Happycapy のサンドボックスで使いやすいツールです。実際の作業システムをコマンドとして提供しているため、エージェントがインストール、設定、実行を手伝えます。

<CardGroup cols={2}>
  <Card title="GitHub CLI" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/github.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=679bb093797d36e654af372f853a460a" href="https://cli.github.com" width="560" height="560" data-path="images/integrations/logos/github.png">
    リポジトリ、Pull Request、Issue、GitHub Actions を扱います。
  </Card>

  <Card title="ntn" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/notion.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=534c589e6711180fe51fa3b632720e51" href="https://developers.notion.com/cli" width="64" height="64" data-path="images/integrations/logos/notion.png">
    Notion ページ検索、コンテンツ作成、データベース照会を行います。
  </Card>

  <Card title="lark-cli" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/lark.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=adc21fbe2f882fafdd5006135fb05128" href="https://github.com/larksuite/cli" width="48" height="48" data-path="images/integrations/logos/lark.png">
    Lark/Feishu のメッセージ、ドキュメント、シート、カレンダー、タスク、メール、会議を扱います。
  </Card>

  <Card title="flyctl" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/flyio.svg?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=d9342a993c06f2170919e5f5a526a3d3" href="https://fly.io/docs/flyctl/" width="167" height="151" data-path="images/integrations/logos/flyio.svg">
    Fly.io アプリ、Machines、ログ、シークレット、リリースのデプロイと運用に使います。
  </Card>
</CardGroup>

## ワークフロー例

```text theme={null}
GitHub CLI を使って。
このリポジトリの直近で失敗した GitHub Actions の実行を確認して。
失敗原因を要約し、最小限の修正案を出して。
```

```text theme={null}
ntn を使って。
私たちの Notion ワークスペースからオンボーディング文書を検索して。
現在のプロセスを要約し、不足している点を列挙して。
```

```text theme={null}
lark-cli を使って。
Lark 文書から今週のプロジェクト更新を集めて。
短いチームレポートにまとめて。
```

```text theme={null}
flyctl を使って。
この Fly.io アプリのステータスと最近のログを確認して。
最新のデプロイが正常かどうか教えて。
```

## 認証と権限

* CLI が接続するアカウント、ワークスペース、リポジトリ、プロジェクトから始めます。
* 可能な限りシークレットをプロンプトに書かないでください。CLI の通常の認証フローを優先します。
* 認証を承認する前に、必要な権限を Happycapy に説明させることができます。
* token を使う場合、サービスが対応していれば権限を限定した token や短期 token を優先します。
* 破壊的な操作では、実行前にコマンドと想定される影響を Happycapy に表示させると安全です。

## トラブルシューティング

### CLI をインストールできない

公式インストールリンクを共有し、サンドボックス環境、パッケージマネージャー、プラットフォーム要件を Happycapy に確認させます。

### ログインに失敗する

CLI がブラウザログイン、token ログイン、ワークスペース承認、環境変数のどれを期待しているか確認します。

### 権限が不足している

どの権限が不足しているか、別の token、ロール、ワークスペース、リポジトリ、組織が必要かを Happycapy に確認させます。

### 出力が広すぎる

リポジトリ、プロジェクト、日付範囲、ファイルパス、アプリ名、コマンドの目的で依頼を絞ります。

## 次のステップ

* 別のツール接続方法を知りたい場合は [MCP](/ja/integrations/mcp) を確認してください。MCP は CLI と使用感が近いですが、サンドボックスでコマンドラインプログラムを実行するのではなく、MCP サーバーのツールを呼び出します。
* 同じ CLI ワークフローをスケジュールで実行したい場合は [Automations](/ja/features/automations) を使います。