Symbi Shell — インタラクティブエージェントオーケストレーション¶

Status: Beta. symbi shell は日常的に使用可能ですが、コマンドサーフェス、キーバインド、永続化フォーマットはマイナーリリース間で変更される可能性があります。問題は thirdkeyai/symbiont に shell ラベルを付けて報告してください。

symbi shell は、Symbiont エージェントの構築、オーケストレーション、運用のための ratatui ベースのターミナル UI です。symbi up や symbi run と同じランタイム上に構築されていますが、会話型のオーサリング、ライブオーケストレーション、リモートアタッチを備えたインタラクティブセッションとして公開されます。

シェルを使用する場面¶

シェルはオーサリングのデフォルトエントリーポイントです。非インタラクティブコマンドは CI、cron ジョブ、デプロイパイプライン内での使用に適しています。

起動¶

symbi shell                    # start a fresh session
symbi shell --list-sessions    # show saved sessions and exit
symbi shell --resume <id>      # reopen a session by UUID

--resume は UUID または以前に /snapshot で保存されたスナップショット名を受け付けます。

レイアウト¶

新しい承認ワークフローについては封じ込めブランチガイドを参照してください。ローカルのオーケストレーターおよびフリートのターンは保護された監査を必須とするようになり、ファイルツールとコマンドツールは選択されたコンテナ境界を使用します。ガバナンス下のシェルワークスペースの説明に従って、ワークスペースのマウントを明示的に設定してください。その他のランタイム経路と正式な DSL 経路は引き続き作業中です。

シェルは既存のスクロールバックとターミナルを共有するインラインビューポートを使用します。上から下に以下が表示されます：

• プロジェクト構造サイドバー（トグル可能） — 現在のプロジェクトのファイルツリー。エージェント、ポリシー、ツールをハイライト表示。
• トレースタイムライン — Observe、Reason、Gate、Act の ORGA フェーズごとに色分けされたカード。LLM 呼び出し中にリアルタイムでストリーミング。
• エージェントカード — 現在選択されているエージェントのメタデータ、ポリシー、最近の呼び出し。
• 入力行 — /command または自由形式のプロンプトを入力。@mention はファジー補完でパスとエージェントを取り込みます。

シンタックスハイライトは tree-sitter 文法経由で Symbiont DSL、Cedar、ToolClad マニフェストをカバーします。

Zellij 配下では、インラインビューポートより上のスクロールバックが描画されない場合がある旨の警告をシェルが出力します。完全な表示にはネイティブのターミナルまたは tmux を使用してください。現時点で --full-screen フラグはありません。

キーバインド¶

保留中のアクションをレビューする¶

/gate を実行するか Ctrl+G を押します。↑/↓ で選択し、Enter を押すとエスケープ済みの完全な JSON リクエストが開きます。長い引数は ↑/↓ または Page Up/Down で確認します。レビューしたリクエストを承認するには a、拒否するには d を押します。Esc で一覧に戻り、もう一度押すとパネルが閉じます。一覧の行で a を押した場合は、先にレビューが求められます。

選択はリクエスト ID を追跡し、更新をまたいで維持されます。リクエストの変更、期限切れ、削除、またはキューの読み取り失敗が起きると、そのレビューは無効になります。パネルは結果を受け取るまで解決を保留状態に保ち、タイムアウトした場合は結果不明として報告します。接続が変化すると、古いレビューは破棄され、保留中の解決を待ちます。ローカルキューが設定されている場合は、アタッチ済みのランタイム API より優先されます。承認のライフサイクルを参照してください。

コマンドカタログ¶

コマンドは目的別にグループ化されています。すべてのコマンドは help / --help / -h を受け付け、オーケストレーターにディスパッチすることなく短い使用法の説明を表示します。

オーサリング¶

オーサリングコマンドは検証が成功した後にのみディスクに書き込みます。制約違反は行単位の正確なエラーとともにトレースタイムラインで説明されます。

オーケストレーション¶

運用¶

ツールとスキル¶

スケジューリング¶

/cron はリモートアタッチが必須です（後述）。実行のトリガー結果には、呼び出しの UUID、正確な再試行コマンド、および queued／saved／in-progress／unresolved の状態が表示されます。保存済みの結果には、上限付きの出力プレビュー、報告されたトークン数、利用可能／予約済み／不確定の予算、保護されたジャーナルへの参照が含まれます。履歴には完全な詳細が保持されます。UUID は保持してください。省略すると新しい処理を要求することになります。応答が失われても失敗が確定したわけではありません。表示された再試行コマンドを使用するか、シェルの再起動後に /cron history <job-id> を確認してください。作用が不明な場合は突き合わせが必要です。cron の復旧を参照してください。

チャネル¶

デプロイされたランタイムを対象とする場合、チャネル管理にはリモートアタッチが必要です。

シークレット¶

シークレットは SYMBIONT_MASTER_KEY で保存時に暗号化され、エージェントごとにスコープされます。

デプロイ (Beta)¶

Status: Beta. デプロイスタックは OSS エディションではシングルエージェントです。マルチエージェントおよびマネージドデプロイはロードマップにあります。

/deploy はアクティブなエージェントとプロジェクト設定を読み取り、再現可能なデプロイアーティファクトを生成します。マルチエージェントトポロジーでは、コーディネーターと各ワーカーを個別にデプロイし、クロスインスタンスメッセージングで接続します（ランタイムアーキテクチャ を参照）。

リモートアタッチ¶

リモートまたは本番ターゲットには必ず https:// を使用してください — アタッチチャネルは認証トークンと運用トラフィックを伝送するため、平文 HTTP はローカル開発のみに適しています。local ショートカットはデフォルトで http://localhost:8080 を使用し、明示的なスキームなしで指定された URL はループバック開発のエルゴノミクスを保つために http:// プレフィックスが付与されます。それ以外のケースでは、完全な https://... URL を渡してください。

アタッチされると、/cron、/channels、/agents、/audit、およびほとんどの運用コマンドはローカルではなくリモートランタイムに作用します。/secrets はローカルのまま — リモートシークレットはリモートランタイムのストアに残ります。

セッション管理¶

セッションは .symbi/sessions/<uuid>/ 配下に保存されます。コンテキストが設定された予算を超えると、シェルは自動的に圧縮をトリガーします。

セッション制御¶

DSL モード¶

/dsl を押すと入力行が DSL モードに切り替わります。DSL モードでは、シェルはオーケストレーターを経由せずに、tree-sitter ベースの補完とエラーを備えたインプロセス DSL インタプリタに対して入力を解析・評価します。再度 /dsl を押すと元に戻ります。

制約と検証¶

オーサリングコマンドはローカル検証パイプラインを強制します：

1. 生成されたアーティファクトは適切に Symbiont DSL 文法、Cedar、または ToolClad に対して解析されます。
2. 制約ローダーがプロジェクトレベルの制約（例：禁止されたケーパビリティ、必須ポリシー）に対して結果をチェックします。
3. 両方のステップが成功した後にのみアーティファクトがディスクに書き込まれます。

オーケストレーター LLM は検証エラーを通じて制約ファイルの影響を確認できますが、ファイル自体を変更することはできません — これは symbi tools validate パイプラインで使用されているのと同じ信頼モデルです。

Beta の注意事項¶

シェルの以下の部分はまだ活発に開発中であり、非推奨期間なしに変更される可能性があります：

• /branch と /copy（セッション分岐）は予約されたコマンドであり、現在は「将来のリリースで予定」のスタブを出力します。
• /deploy cloudrun と /deploy aws はシングルエージェントのみです。
• スナップショットフォーマットと .symbi/sessions/ レイアウトはマイナーリリース間で変更される可能性があります。耐久性のあるトランスクリプトが必要な場合は /export を使用してください。
• ファジー補完のヒューリスティックとトレースタイムラインのレイアウトはフィードバックに基づいて調整され、変更される可能性があります。

現時点で安定したサーフェスが必要な場合は、symbi up、symbi run、および HTTP API を優先してください — これらは SECURITY.md の互換性保証の対象です。

関連項目¶

• 入門ガイド — インストールと symbi init
• DSL ガイド — エージェント定義言語リファレンス
• ToolClad — 宣言的ツール契約
• スケジューリング — cron エンジンと配信ルーティング
• セキュリティモデル — 信頼境界とポリシー実施