CLI のインストールと接続

busabase-cli はターミナルでの操作、エージェントのスクリプト、CI に利用できます。SDK や OpenAPI 連携 と同じ REST API に接続します。

インストール

CLI パッケージには Node.js 24.18.0 以降が必要です。

npm install -g busabase-cli
busabase-cli --help

グローバルにインストールせずに試す場合：

npx busabase-cli --help

Cloud にサインインする

busabase-cli login --device-code

ターミナルに表示される認可 URL を開き、ブラウザーで接続を承認します。作業に必要な権限を持つ API キーを選択または作成してください。以下の確認には read 権限で十分です。CLI は接続情報を ~/.busabase/.env に保存します。

CI などの非対話環境では、BUSABASE_BASE_URL、BUSABASE_API_KEY、BUSABASE_SPACE_ID を環境変数で渡します。キーと権限については API キー を参照してください。

ワークスペースを選んで確認する

busabase-cli whoami
busabase-cli space list
busabase-cli space use "Marketing"
busabase-cli bases list --output json

Marketing をワークスペースの名前、slug、または id に置き換えます。操作を続ける前に対象を確認してください。これらのコマンドは既存データを読み取るだけで、変更の作成やマージは行いません。複数のアカウントについては CLI アカウントとワークスペース を参照してください。

ローカル / Desktop に接続する

このコンピューターで Busabase を起動してから実行します：

busabase-cli login --base-url http://localhost:15419
busabase-cli health
busabase-cli bases list

オープンソースのローカルサーバーは、デフォルトで認証を必要としません。セルフホストに接続する場合は busabase-cli login を実行し、対応するセルフホストの接続方法を選んでチームの URL を指定します。

エージェントで作業を続ける

busabase-cli skill
busabase-cli skill install

最初のコマンドは作業ガイドを表示し、次のコマンドはエージェントの skills ディレクトリにインストールします。詳しくは Agent Skills を参照してください。編集は Change Requests として提案し、ワークスペースの権限に従ってレビューします。

その他の接続方法：連携方法の一覧 · CLI · SDK · MCP · OpenAPI / REST · Agent Skills · Webhook