CLI

beeuni командная строка, модель аутентификации, цикл разработки и все команды.

beeuniコマンドラインインターフェース（CLI）は、ターミナル（ノートパソコンまたはセッションサンドボックス）からBeeuniを操作します。このページでは、日常的な開発ループを説明し、その後に安定版のすべてのコマンドとフラグを一覧します。

インストール

curl -fsSL https://beeuni.ai/install | bash

インストーラーはmacOSおよびLinux用のビルド済みバイナリをダウンロードします。Windowsはサポートされていません。

認証モデル

Beeuniは認証情報をグローバルではなくホストごとに保存します。ホストとは、1つのBeeuni APIエンドポイントです。cloudを使用してBeeuniに接続します。

設定ファイルは~/.config/beeuni/config.jsonにあり、モードは0600です。BEEUNI_CONFIG_FILEでパスを上書きできます。

CLIは、host → account → project → sessionという階層に従います。ホストにサインインし、その中のアカウントを選び、そのアカウント内のプロジェクトを選び、プロジェクト内でセッションを開きます。beeuni hosts loginは最初の3つの手順を順に実行します。サインインし、アカウントを選び、デフォルトプロジェクトを設定します。

すべてのトークンはbeeuni_pat_で始まります。beeuni loginから取得するユーザートークンでは、自分が所属するすべてのアカウントとプロジェクトを確認できます。プロジェクトトークンはセッションサンドボックス用に自動発行され、1つのプロジェクトに限定されます。Token scopeを参照してください。

開発ループ

このループでは、CLIがインストール済みで、beeuni loginを実行済みであることを前提とします。セットアップについてはQuickstartを参照してください。

beeuni init my-app
cd my-app

beeuni projects link <project-id>

beeuni ship

beeuni sessions new --prompt "Build the login page" --wait

beeuni connect

beeuni sessions chat

beeuni tui        # or: beeuni t, or beeunit
beeunit --project <id> --new --terminal   # new session + sandbox shell, one command

beeuni sessions shell

beeuni sessions ls

beeuni cr ls
beeuni cr diff 1
beeuni cr merge 1

リファレンス

認証コマンド

beeuni hosts login / hosts logout / hosts whoamiが正式な形式です。login / logout / whoamiは、アクティブなホストに対して動作するショートカットです。

ホスト

http://で始まるリモートホストURLはhttps://に正規化されます。CLIがリモートホストに平文HTTPでトークンを送信することはありません。localhostは例外です。

アカウント

メンバー

アカウントに所属するメンバーと、そのアカウントロールを確認できます。ロールはowner、admin、memberです。OwnerとAdminにはすべてのプロジェクトで暗黙的にManager権限があるため、memberだけがプロジェクト単位の付与対象になります。

<user>はユーザーID、またはすでにアカウントに所属しているユーザーのメールアドレスです。 オプション: --account <id>、--host <name>、--json、-y。

グループ

アカウントグループは、ロールを一度付与する相手をまとめた名前付きのグループです。beeuni access grant --group <id> --role <key> でグループをスコープに紐付け、beeuni access revoke <assignment-id> で解除します。

<group> はグループ ID または完全一致する名前です。読み取りには group.read が必要です。 create、set、add には、group.update または group.members.manage と、エンタープライズ rbac の利用資格が必要です。rm と remove は後片付け用で、利用資格による制限はありません。

トークン

アカウント用の非対話型認証情報です。読み取りには token.read が必要です。アカウントのすべてのメンバーは、自分用の個人キーを発行、失効できます（token.personal.create、token.personal.revoke）。個人キーは本人として動作し、本人のロールを超える権限を持つことはありません。サービスアカウントや他の人のキーには token.create / token.revoke（オーナーと管理者）が必要です。

個人 API キーは本人として動作し、メンバー資格を失うと無効になります。サービスアカウントは独自の ID で動作し、アクセス権を継承しません。新規作成時には権限がありません。beeuni access grant --service-account <id> --role <key> で権限を付与してください。 --expires <when> には ISO-8601 または将来までの期間を指定します：30d、12h、6w、1y。

請求

アクティブなアカウントのプラン、クレジット、利用額を確認します。読み取り専用です。プランの変更、チャージ、支払い方法の管理はダッシュボードから行います。

フィルター：--project <id>、--session <id>、--owner <id>（セッション。--by session を指定）。オプション：--account <id>、--host <name>、--json。

プロジェクト

コマンドは次の順で「プロジェクト」を解決します。

1. --project フラグ
2. BEEUNI_PROJECT_ID 環境変数
3. 作業ディレクトリ直下の .beeuni/link.json
4. beeuni projects use で設定したグローバル既定値

プロジェクトに表示できるアイコンは1つです。--icon を書き込むとグリフが消え、--glyph を書き込むと絵文字が消えます。両方を指定すると拒否されます。グリフの色：grey、red、orange、yellow、lime、blue、purple、magenta。set と features には project.settings.write が必要です。プラットフォームで利用不可とされているフラグは、プロジェクトで上書きしてもオフのままです。

プロジェクト CLI トークンは1つのプロジェクトに紐付けられ、API はそれ以外の場所での使用を拒否します。セッションのサンドボックスでは、そのセッションに紐付けられた BEEUNI_TOKEN を使用します。cli-tokens ls にはプロジェクトの読み取り権限が必要です。new と rm には project.credentials.issue が必要です。セッションに紐付けられたトークンは、プロジェクトでエージェントが宣言されているかどうかにかかわらず、プロジェクトトークンを発行も失効もできません（403）。プロジェクト CLI トークンにはアカウントの PAT ポリシーが適用されます。アカウントで有効期限が必須の場合は --expires-at を指定してください。最長有効期間を超える有効期限を指定すると 400 が返されます。

beeuni projects upgrade にはプロジェクトの書き込み権限が必要です。デフォルトのエージェントはマーケットプレイスのベースラインを更新し、マニフェストを書き換え、beeuni validate を実行して、変更リクエストを作成します。マージは行いません。差分は人間がレビューします。

プロジェクトのひな形

beeuni init [project-name] [options] は新しいプロジェクトディレクトリを作成します。スターターは v2 beeuni.yaml、agents/、skills/、memory/、harnesses/opencode/ を作成します。このコマンドでは、クラウドの 標準のエージェントランタイム ランタイムを変更せずに、ローカルのコーディングツールの検出を設定できます。このコマンドは .beeuni/link.json を書き込みません。beeuni ship または beeuni projects link でこのファイルを作成します。

ローカルのコーディングツールの選択によって、クラウドの 標準のエージェントランタイム ランタイムが変わることはありません。

beeuni init にはマーケットプレイスの選択機能はありません。マーケットプレイスのスキルを追加するには、エージェントにインポートさせます。セッションを開始し、エージェントに追加を依頼してください。

Ship

beeuni ship は現在のブランチをステージングしてコミットし、プロジェクトの git リポジトリにプッシュします。プロジェクトの作成時に1回実行します。その後はいつでも再実行して同期できます。別名：beeuni deploy。

各実行で:

• beeuni validate チェックを実行します。beeuni.yaml と、imports:、サンドボックスの Dockerfile、エージェントの配線、リポジトリのサイズに記載されたすべてのファイルをマージします（--no-verify でスキップ）。エラーがあると出荷を停止します。警告では停止しません。
• 変更のある作業ツリーをコミットします（--no-commit でスキップ）。
• 不足している env シークレットの入力を求めます（--no-env でスキップ）。
• 現在のブランチを同名のリモートブランチにプッシュします。
• 認証が必要な、宣言済みコネクターに接続します（--no-connect でスキップ）。

既存の GitHub origin は Beeuni GitHub App 経由でリンクします。その他の既存の origin はそのまま登録します。origin がない場合は、Beeuni が管理する Git リポジトリを作成します。

Apps

Apps は静的サイト、サーバー、ワーカー、データベースをホストします。各 App は固定 URL を持ちます。リリースはコードと設定を含み、失敗したデプロイは稼働中のリリースを置き換えません。

beeuni apps list
beeuni apps show main
beeuni apps connect main
beeuni apps launch --template convex --slug main
beeuni apps deploy dist --type static --spa
beeuni apps machines main
beeuni apps volumes main

uses でアプリを接続し、beeuni apps connect の接続例を利用してください。管理用認証情報をクライアントコードに含めないでください。

稼働リソースはアカウントのクレジットを消費します。Billing と Usage で残高を確認できます。Apps に独立した月額予算はありません。

Apps

Sessions

各セッションは、専用ブランチ上の 1 つのサンドボックスで実行されます。

sessions queue には project.session.start が必要です。これはメッセージを送信する場合と同じ権限です。キューに入ったプロンプトはターミナルを閉じても保持され、セッションが受け取れる状態になったときに配信されます。beeuni sessions chat <id> -p "…" --queue でキューに追加するか、--steer で実行中のターンを誘導します。sessions queue ls には各プロンプトの DELIVERY（steer、queue、interrupt）が表示されます。また、queue として実行される誘導プロンプトでは、その理由も表示されます: unsupported（セッションはターンの途中でメッセージを受け取れない）、not_prompter（別のメンバーのターンが実行中）、または turn_ended。

sessions approvals は永続的です。sessions pending と異なり、サンドボックスを再起動しても保持されます。project.members.manage が必要です。または、そのセッションを開始した人間である必要があります。エージェントが自分自身の承認を解決することはできません。

sessions attachments はセッションのワークスペースではなく、プライベートファイルストアを読み取ります。ファイルは送信時にそこへ保存され、エージェントが表示したすべてのファイルはターンの終了時にそこへ保存されます。

sessions files は、コミット前の、エージェントが現在編集中の作業ツリーを読み取ります。beeuni files はコミット済みのリポジトリを読み取ります。パスは、/workspace、/tmp、/home、または /opt で始まる場合を除き、/workspace を基準に解決されます。サンドボックスがスリープ中の場合、このコマンドは起動します。オプション: --from <local path>（write は標準入力ではなくこのファイルを読み取る）、--content（find はファイル名ではなくripgrepで内容を検索する）、--limit <N>（find ファイル名の上限）、および -y（rm の確認を省略）。

sessions share はオーナーによる管理対象です。セッションをすでに読み取れる権限がないプロジェクトマネージャーからのAPIリクエストは拒否されます。共有セッションは、プロジェクト全体で共有されているプロバイダーキーのみで実行されます。個人のキーで実行していたモデルは、そのプロバイダーについてプロジェクトのキーに切り替わります。そのプロバイダーを実行するキーがない場合、共有は拒否されます（409 SHARED_SESSION_NEEDS_PROJECT_KEY）。

sessions links create のオプション: --port <n>（既定値は 3000。22、8000、およびopencodeのポートは拒否されます）、--path <p>（既定値は /）、--preview <id>（--port/--path ではなく、名前付き候補を指定。web、vite、dev-server、api-docs）、--file <path>（プレビューではなくワークスペースのファイルを1つ共有。常に読み取り専用）、--mode view\|interactive（既定値は view。interactive は書き込みとWebSocketを許可しますが、--file では無視されます）、--label <text>、および --expires <iso>。リンクの発行にはセッションのオーナー権限が必要です。リンク自体にはログインが不要なためです。一覧表示と取り消しはプロジェクトマネージャーも実行できます。

サンドボックス内では、BEEUNI_SESSION_ID は自分のセッションIDです。

変更リクエスト

変更リクエスト（CR）は、任意のGitホスト上であるブランチを別のブランチにマージするものです。エージェントがセッションの作業をデフォルトブランチに反映する唯一の方法です。変更リクエストを参照してください。

request-changes はCRにメモを記録し、元のセッションに配信します。サンドボックスがスリープ中の場合は起動します。project.review.act が必要です。Review Centerが使用するものと同じリーフであり、gitops.push ではありません。

<cr> はプロジェクト内の番号（3）または完全なIDを受け付けます。サンドボックス内では、CLIがトークンを自動的に読み取るため、ログインやリンクは不要です。

レビュー

プロジェクトのレビュー受信箱。変更リクエスト、承認が必要なポリシーによってゲートされたコネクタのツール呼び出し、エージェントが承認を求めて提出した出力、判断、バッチなど、人間の判断待ちになっているすべての項目が含まれます。ダッシュボードのReview Centerと連動します。すべてのプロジェクトで有効です。読み取りと操作には project.review.read と project.review.act が必要です。

判定: approve、reject、changes、answer、dismiss。セグメント: needs_you、waiting、done。種類: change、approval、output、decision、batch。

判定の適用先は項目IDによって異なります。cr:<id> では、approve は変更をマージし、reject はクローズし、changes はメモをCRの作成者に返します（--message が必要）。call:<id> では、approve はツール呼び出しを実行し、reject は拒否します。コネクターの承認で使える判定はこれらのみです。まず beeuni review show で引数を確認してください。それ以外のIDはすべてネイティブの操作エンドポイントに送られ、すべての判定を受け付けます。

bulk はネイティブIDのみを処理します。コネクターの承認には個別のパラメータ確認が必要であり、変更リクエストには差分の表示が必要なため、どちらも報告されてスキップされます。ダッシュボードの複数選択でも同じルールが適用されます。

submit のオプション: --kind output\|decision\|batch（必須）、--title <text>（必須）、--summary <text>、--risk none\|low\|medium\|high（既定値は none）、--detail <json>（JSONオブジェクト）、--agent <name>、および --session <id>（このプロジェクトのセッションでない場合は無視されます）。

読み取りには project.review.read、判定には project.review.act が必要です。submit には project.review.submit が必要です。

シークレット

プロジェクトに保存される暗号化された値です。デフォルトでは、起動時に各セッションのサンドボックスへシークレットが通常の環境変数として注入されます（環境変数による公開）。強制配信（サンドボックスにはハンドルだけを保持させ、Beeuniがサンドボックスの外で実際の値に置き換える方式。egressによって公開を制御し、beeuni secrets call）は実験段階です。利用するにはsecrets_egress機能フラグ（Settings → Feature flags）を有効にしてください。フラグがオフの場合、beeuni secrets delivery … egressは403 feature_disabledを返します。詳しくはSecretsを参照してください。

grantは、lsで配信不可と表示された行を修正するコマンドです。1つのエージェントのリストを広げることしかできません。範囲を狭める、または置き換えるには、beeuni agents scope. There is no secrets revokeでセット全体を書き換えてください。APIには、許可リストから単一の識別子を削除するルートはありません。エージェントが存在しないプロジェクトで最初の許可を付与すると、ガバナンスが開始されます。それ以降、マニフェストに記載されていないエージェントはプロジェクトのシークレットを受け取らず、その場合はコマンドでその旨が表示されます。

Env

Agents

リンクされたプロジェクトでエージェントごとに設定するモデルです。

スコープのオプションはすべて置き換えであり、マージされません。--setの値は、JSONとして解析できる場合はJSONとして解析され、できない場合は文字列のまま保持されます。モデルの固定とscopeは即時に適用され、beeuni.yamlのコミットは不要です。defaultとconfigは、プロジェクトのデフォルトブランチにあるbeeuni.yamlにコミットします。scopeにはproject.agent.writeが必要で、defaultとconfigにも必要です。

Tools

プロジェクトのセッションで利用できるツールです。ローカルのbeeuni.yamlとそのインポートから読み込みます。プロジェクトのルートから実行してください。詳しくはToolsを参照してください。

tools:キーがない場合、各セッションですべてのBeeuniツール5つ（web_search、image_search、scrape_webpage、memory、show）を使えます。tools:キーがある場合、セッションで使えるのは、そこに列挙されたBeeuniツールだけです。Beeuniツールを削除するには、tools:の下にあるそのツールの行を削除してから、beeuni validateを実行します。1つのエージェントのツールを制限するには、agents.<name>.toolsを使います。終了コード：0は完了、1は拒否（ファイルが存在する、マニフェストまたはインポートを解析できない）、2はマニフェストがない、オプションが不明、またはBeeuniツールではない名前を示します。

Models

プロジェクトで提供するモデルと、最初に使用するモデルです。ダッシュボードのCustomize → Modelsと同じ項目です。プロジェクトには、カタログのデフォルト（各ファミリーの最新モデル）に対する例外だけが保存されます。有効化設定は表示にのみ影響します。ピッカーに表示するモデルを決めるだけで、ゲートウェイが提供するモデルには影響しません。

モデルIDはゲートウェイの通信で使うIDです。プレーンなマネージドID（glm-5.3-flash）か、BYOKのprovider/modelを指定します。beeuni models ls --jsonからコピーしてください。エージェントごとの固定設定はbeeuni agents model <agent> <model-id>にあります。書き込みにはproject.model.writeが必要です。

Channels

プロジェクトとチャットプラットフォームの接続を管理します。トークンはプロジェクトのシークレットに暗号化して保存され、サーバー側で解決されます。サンドボックスに注入されることはありません。

--platform slack|teamsはプラットフォームを選択します。デフォルトはslackです。Teams connectはMicrosoftの管理者同意URLを出力します。テナント全体の同意を付与すると、 アプリが自動的にTeamsカタログに公開されます。Connectorsを参照してください。

メールチャネルはAgentMailを基盤としており、agentmail_email機能フラグが必要です。 email connectのオプションは、--connector <slug>（デフォルトはbeeuni_email）、 --api-key <k>（独自のAgentMailキーを使用。-はstdinを読み取ります）、 --display-name <n>（送信メールの差出人名。デフォルトはプロジェクト名）、 --username <u>と--domain <d>（新しい管理対象受信トレイ）、および --inbox-id <id>と--email <addr>（既存の受信トレイを接続。両方を併用する必要があります）です。 --allowは繰り返し指定でき、ポリシーを制限モードにします。@のない単独の値、 または先頭に@が付いた値は、ドメインとして解釈されます。 --allow-allはリストをクリアし、すべての送信者を再び受け入れます。

メールおよびbindへの書き込みにはproject.connector.writeが必要です。

コネクタ

コネクタはエージェントがツールとして呼び出すものです。add、rm、policy setはローカルのbeeuni.yamlを編集します。適用するにはbeeuni shipを実行してください。ただし、--applyを渡すとクラウドプロジェクトを直ちに変更します。

policy ls、show、set、add、rmはプロジェクト全体のサーフェスです。そのため、これらの動詞のいずれかにちなんで名付けられたコネクタは、policy <slug> lsとして指定する必要があります。<match>はツール名、glob（send_*）、または/regex/です。

addのオプション：--name <label>、--provider <pipedream\|mcp\|openapi\|postman\|graphql\|http>、--app <slug>、--url <url>、--transport <http\|sse>、--endpoint <url>、--base-url <url>、--spec <url\|path>、--auth-type <none\|bearer\|basic\|custom>、--credential shared。

サンドボックス

プロジェクトのサンドボックスイメージを管理します。テンプレートはイメージまたはDockerfileとリソースを定義し、ビルドによってセッションの起動元となるスナップショットが生成されます。

プロバイダーの固定にはproject.settings.writeが必要です。

add/updateのオプション：--name <label>、--cpu <n>、--memory <n>（GiB）、--disk <n>（GiB）。

バックエンド

データベースは永続ボリュームを持つ App です。Apps から管理・接続できます。

Apps

Marketplace

Beeuniマーケットプレイスを閲覧し、プロジェクトに項目をインストールします。

オプション: --query <text>、--type <type>、--source <source>、--host <name>、--project <id>、--json。

インストールはエージェント主導で行われます。プロジェクトセッションを開始して項目をクローンし、内容を読み取り、適合するものをマージして、変更リクエストを作成します。決定論的なインストール／更新／削除の仕組みはありません。

System skills

Beeuniのシステムスキルは、人とエージェントの両方を対象としたプラットフォームの運用リファレンスです。セッション、サンドボックス、標準のエージェントランタイム、コネクター、メモリ、チャネルを扱います。この公開ページは入口です。認証済みCLIは実行中のホストからスキルを読み取ります。beeuni system-skills listで利用可能なスキルを確認し、必要なスキルをgetしてください。APIはスキルをライブで提供するため、デプロイ済みホストのバージョンと一致します。ローカルコピーを最新のものとして扱わないでください。

オプション: --host <name>、--json。

beeuni skillsは同じコマンドへの恒久的なエイリアスです。まずbeeuni loginでホストにサインインしてください。スキルAPIには認証が必要です。別のホストを操作するときは--host <name>を使用してください。公開ドキュメントページで、これらのライブかつホスト固有の手順を置き換えることはできません。

この一覧は常にシステムスキルのみで、混在することはありません。オプションのスキルはマーケットプレイスにあります: beeuni marketplace list --type skill。コマンド構文についてはbeeuni <command> --helpを、プラットフォームの完全なリファレンスについてはbeeuni system-skills get beeuni-system --fullを使用してください。

Connector

サンドボックス内のエージェントがすべてのコネクターにアクセスするためのインターフェースです。すべての呼び出しはサーバー側で検証、解決、監査されます。CLIがサードパーティの認証情報を保持することはありません。認証: BEEUNI_TOKEN。出力はJSONです。

Files

プロジェクトのgitリポジトリを読み取り専用で表示します。--refで別のブランチ、タグ、またはコミットを指定しない限り、デフォルトブランチを対象にします。

すべてのサブコマンドで使用できるオプション: --ref <ref>、--path <p>、--limit <n>、--json。 downloadでは-o, --out <file>も使用でき、必須です。

すべてのサブコマンドでproject.file.readが必要です。downloadは、アクセス範囲外のエージェントまたはスキルを含むサブツリーも拒否します。zipはストリームの途中で絞り込めないため、その場合は対象を絞った--pathをアーカイブしてください。

トリガー

トリガーを使うと、スケジュール、Webhook、アプリイベント、またはモニター（試験的機能）からセッションを開始できます。add、rm、enable、disableはローカルのマニフェストを編集します。反映するにはbeeuni shipを実行してください。pause/resumeは、これとは別のサーバー側スイッチを切り替えます。トリガーを参照してください。

addのオプション: --type <cron\|webhook\|event\|monitor>（既定値はcron）、--prompt <text>（必須）、--agent <name>、--cron <expr>（6フィールド。例: "0 0 9 * * 1-5"）、--run-at <iso>（cronではなく、この時刻に1回だけ実行）、--timezone <tz>（既定値はUTC）、--secret-env <NAME>、--name <label>、--disabled。

実行時のみのオプション — add --applyおよびすべてのsetで有効: --model <provider/model>、--session-mode <fresh\|keyed\|pinned\|reuse>、--session-key <tmpl>（キーごとに1つのセッションにまとめます。例: "{{ body.data.chat_jid }}"。keyedを含意）、--session-id <id>（pinnedトリガーが繰り返し使うセッション。このプロジェクトのセッションである必要があります）、--session-access <private\|project\|members>（既定値はprivate）、--member <uuid>と--group <uuid>（繰り返し指定可能。それぞれmembersを含意）、--filter <path=value>（繰り返し指定可能。すべて一致する必要があります。例: --filter body.type=push）。

setでは、すべての実行時のみのオプションに加えて、--name、--prompt、--cron、--run-at、--timezone、--secret-env、--agent、--enabled true|falseも使用できます。--cronと--run-atは排他的です。一方を設定すると、もう一方はクリアされます。モニターのフィールドは追加のみ可能です。

リマインダー

リマインダーを使うと、1つのセッションに対して後から1回または繰り返し再通知できます。beeuni.yamlではなく、データベースに保存されます。セッション内では、--sessionの既定値は$BEEUNI_SESSION_IDです。リマインダーを参照してください。

スケジュールオプション: --in <duration>または--at <iso>（初回実行時刻。単独で指定すると1回だけ実行）、--every <duration>（繰り返し。最短5m）、--timezone <tz>を指定した--cron "<expr>"。その他のオプション: --name <label>、--session <id>（一意な接頭辞で指定可能）、--project <id>、--host <name>、--json。

イベントオプション（--type event）: --connector <slug>と--event <TYPE>（どちらも必須）、--config key=value（繰り返し指定可能。文字列値）、--config-json '{...}'（型付き値）。setでも同じフラグを使用できます。イベントトリガーでは、--cron、--run-at、--timezone、--secret-env、およびモニターのオプションは使用できません。プロンプトは{{ event.data.<field> }}を読み取ります。アプリイベントトリガーを参照してください。

モニターのオプション（--type monitor）: --run <cmd>（監視対象のリポジトリ相対コマンド。必須）、--mode <poll\|stream>（必須。pollは--intervalで再実行し、streamはコマンドを実行し続けます）、--interval <dur>（mode=pollのみ。最短30秒。例: 60s、5m）、--expect-event-within <dur>（無応答監視。ウィンドウ内にイベントがない場合、代わりにライフサイクルイベントを実行します。最短5分。例: 24h）。モニターはプラットフォームが24時間365日実行するリポジトリコマンドで、標準出力の各行がトリガーを実行します。これは試験的機能であり、プラットフォームがモニターを実行するのはmonitors機能フラグが有効な場合のみです。

アクセス

1つの付与テーブルをCLIから操作します。各行は割り当てを表し、プリンシパル、ロール、スコープをそれぞれ1つずつ指定し、必要に応じて対象オブジェクトを1つに絞ります。仕組みについてはアカウントとアクセスを参照してください。アカウントロール: owner、admin、member。プロジェクトロール: manager、member。

付与オプション: --project <id>（既定値: リンク済みプロジェクト）、--account（アカウント全体）、--agent <name>（付与対象を1つのエージェントに限定するオブジェクト割り当て）、--connection <id>（共有コネクターアカウントの利用を制限します。最初の付与でアカウントの利用者を許可対象のみに限定し、最後の付与を取り消すと、再びプロジェクト全体に開放されます）、--everyone（プロジェクトへのアクセス権を持つ全員に付与します。--agentまたは--connectionを保持し、ロールは保持しません）、--expires <iso>（自動取り消しのタイムスタンプ）。--principalは一覧を絞り込み、user:<id>、group:<id>、service_account:<id>、project:<id>、pending:<email>を指定できます。単独のIDはユーザーとして解釈されます。全員への付与はeveryoneとして一覧表示されます。エージェントのIDはservice_accountなので、エージェントにロールを割り当てるには--service-account <id>を使用します。--userではメールアドレスを指定し、アカウントのメンバーディレクトリから照合します。

beeuni access grant --user alice@corp.com --role manager
beeuni access grant --user alice@corp.com --role admin --account
beeuni access grant --group 8f3c… --role member --project 1a2b…
beeuni access grant --user alice@corp.com --agent support-bot
beeuni access grant --everyone --agent support-bot
beeuni access grant --group 8f3c… --connection 2b7e…
beeuni access revoke 4d5e…

プロジェクトメンバー関連のコマンドは、同じ割り当てを読み取りモデルとして扱います。

上記2つのブロックにあるすべての動詞にはproject.members.manageが必要です。

ユーザー、グループ、エージェントはBeeuniからロールを取得します。エージェントはさらに beeuni.yamlのBeeuni権限を持ち、セッションが実行できるのは両方が許可する操作だけです。 1つの用語、2つのバインディングを参照してください。

監査

監査コマンドは、集中管理された再構築ログを読み取ります。アカウントとプロジェクトの 一覧は新しい順です。セッションのタイムラインは作成時刻順です （session_sequenceは2026-10より前に書き込まれた行にのみ設定され、それらが 先頭に来ます）。--allはすべての継続カーソルに従います。lsは過去90日間を 一覧表示し、exportは365日前まで遡ります。90日より古いイベントはアーカイブから取得されます （監査の保持期間を参照）。テーブルには各行のタイトル （例: EVENT「LLMゲートウェイキーを取り消しました」）と、その ACTION（gateway.key.revoke）が表示されます。--actionはアクションのプレフィックスで フィルタリングします。すべてのアクションとタイトルについては、監査ログのアクションを参照してください。

監査Webhookは追跡情報をSIEMにストリーミングします。すべての動詞にはaccount.writeが必要です。 addとenableにもエンタープライズ資格が必要です。disableとrmには 必要ありません。

フィルター: --actor、--actor-type、--project、--session、--source、 --phase、--outcome、--action、--resource-type、--request-id、 --correlation-id、--query、--since、--until、--cursor、--limit。 アカウントの一覧とエクスポートにはaudit.readおよびアカウントのauditAccess資格が必要です。 プロジェクト全体の一覧には、プライベートセッションのメタデータが含まれる可能性があるため、 project.members.manageが必要です。セッションの再構築にはproject.session.readと、そのセッションの可視性が必要です。

ロール

ロールは、名前付きの権限セットです。システムロール（アカウントスコープではowner、admin、member、 プロジェクトスコープではmanager、member、さらにオブジェクト割り当てが持つマーカーであるagent-user）は、 読み取り専用の参照です。カスタムロールはユーザーが作成・編集でき、エンタープライズのrbac資格が必要です。

beeuni access grantでプリンシパルにロールをバインドします。以前のbeeuni roles assign / unassign / assignments動詞も引き続き機能し、同じテーブルに書き込みますが、 beeuni accessが文書化された方法です。beeuni roles actionsはbeeuni permissions lsに置き換えられました。

カスタムロールは権限を追加するだけです。Beeuniに拒否ルールはないため、ロールによってマネージャーから権限を取り上げることはできません。

権限

権限カタログをデータとして扱います。リーフアクションごとに1行で、権限が決定されるスコープ、委任可能かどうか、 およびその権限が含意する内容を示します。ロールはこれらのキーから構築されます。beeuni roles create --actionsとbeeuni roles set-actionsは これらのキーをそのまま受け取ります。別名: beeuni perms。

Grant

1つのプロジェクトオブジェクトをプリンシパルに割り当てます。これをオブジェクト割り当てと呼びます。シークレットと コネクターはエージェント上に存在するため、エージェントをユーザーに割り当てると、そのエージェントが宣言するすべてのものが付与されます。 エージェントはデフォルトで閉じられています。メンバーがアクセスできるのは、割り当てでそのメンバーまたはそのメンバーのグループが指定されている場合だけです。beeuni access grant --agent <name>は同じ行を書き込みます。

マニフェストの検証

マニフェストリファレンスを参照してください。

リポジトリサイズ

セッションは、ベースコミットでGitが追跡するすべてのファイルからエージェント設定を構築します。新しいセッションは、サイズにかかわらず、それらのファイルを独自のチェックアウトから取得します。実行中のセッションは、プロジェクトスナップショットを通じてベースブランチの変更を取り込みます。Beeuni Cloudは圧縮後512 MiBまでビルドします。それを超える場合、セッションは新しいセッションが開始されるまで、実行中の設定を保持します。すべてのセッションはすべてのファイルもダウンロードします。beeuni validateはGitが保存するファイルに加えて、beeuni shipが次にコミットする未追跡ファイルを数え、1つのファイルが10 MiB以上、または合計が512 MiBを超えると警告を出力します。Git LFSファイルは、リリースにポインターしか含まれないため、ポインターとして数えられます。警告には最大サイズのファイルが示されます。コマンドが失敗することはありません。

解消するには:

• 大きな静的アセット（動画、画像、データセット、モデルの重み）をS3、R2、GCSなどのオブジェクトストレージ、またはCDNに移し、実行時にダウンロードします。
• ビルド出力（dist/、out/）を.gitignoreに追加します。
• Gitに残す必要はあるものの、どのエージェントも読み取らないパスには、.gitattributesに<path> export-ignoreを追加します。リリースとチェックの両方で、そのパスは除外されます。ディレクトリルールはその配下全体に適用されます。エージェント設定ディレクトリとbeeuni.yamlは常に全体が含まれます。

トークンのスコープ

各トークンは beeuni_pat_ で始まります。ユーザートークンは、アカウント上のすべてのプロジェクトで有効です。プロジェクトトークンは1つのプロジェクトでのみ有効で、そのプロジェクトのサンドボックスに自動で注入されます。トークンファミリーの全リファレンスは セッションランタイム をご覧ください。

終了コード