alera-cli

Alera CLI

Alera のリソースには、管理対象の alera CLI を使用します。Alera のターミナル内では、そのシムと ALERA_RUNTIME_DIR によって、UI のランタイムプロファイルが選択されます。フラグを確認するにはコマンドグループの --help を使用し、構造化出力には --json を使用します。一覧のエンベロープには items が含まれます。

該当するワークフローを選択する

• プロジェクト、ワークツリー、ハンドオフ／ハンドオン、リンクされたイシュー、Watch and Fix、タグ、タブ、関連付け、セクションについては、workspaces を参照してください。
• SSH ターゲットとリモートワークスペースのセットアップについては、hosts を参照してください。
• スケジュールされたエージェントの作業には、alera-automations スキルを使用します。CLI のエントリーポイントは automations にあります。
• ランタイムホストの不足、外部シェルの設定、メタデータの修復、またはエージェントのステータスがタブに表示されなくなった場合は、recovery を参照してください。
• Agent Profile の確認、起動、保守には、alera-agent-profiles スキルを使用します。シンプルな保守ルートでは、カタログの調査は不要です。
• ターミナルの外部から実行中のエージェントに質問する場合、または受信トレイを読む場合は、inbox を参照してください。
• エージェントのディスパッチ、ワーカータスク、またはコーディネーターのライフサイクルには、alera-orchestration スキルを使用します。
• ランタイムを Alera アカウントにサインインさせる、名前を付ける、または MCP クライアントから操作できるようにする場合（MCP Control、alera mcp serve）は、mcp を参照してください。
• このマシンにコーディングエージェント用としてインストールされている Alera スキルを確認または更新するには、alera skill status でそれぞれをこのランタイムと比較します。alera skill install [--skill <name>] で、このランタイム固有のコミットにスキルをインストールします。

現在のリクエストに必要なワークフローのみを読み込んでください。

ワークスペースの不変条件

実際の管理対象ワークツリーには workspace add/remove を使用してください。register/unregister は、意図的なメタデータ修復に限って使用してください。register --host-id はリモートワークツリーを作成しません。SSH のブートストラップでインストールされるのはサイドカーのみです。リモートワークツリーは workspace add --host-id で作成します。

ユーザーが低レベルの復旧を依頼した場合を除き、git worktree add/remove を直接実行したり、ランタイムのメタデータを編集したりしないでください。破壊的な操作の前に、正確な ID と状態を確認してください。削除が明示的に依頼されていない限り、ユーザーが作成したブランチは保持してください。デフォルトでは、削除されるのは Alera が作成したブランチのみです。ワークスペースの表示名を変更するには workspace rename を使用します。ブランチ名やワークツリーフォルダー名は変更されません。実行中のデスクトップアプリで既存のワークスペースを選択して表示するには workspace focus を使用します。Alera の起動は行わず、起動していない場合は失敗します。サイドバーでの配置には workspace pin/unpin を使用します。サイドバーのセクションを割り当てるには workspace section を使用してください。セクションの割り当てに runtime.sqlite を編集しないでください。