gastownhall/gascity

Gas City – マルチエージェントコーディングワークフロー向けオーケストレーション SDK

概要

• コーディング関連タスクを実行するエージェント（beads と呼ばれる）の集合である cities を宣言的に定義・実行できる Go ベースの SDK。
• より大きな Gas Town プラットフォームから配管を取り出し、調整された AI エージェント、スクリプト、サブプロセスを必要とする任意のプロジェクトで再利用可能にするツールボックスと考えてください。

中核概念

• city.toml – エージェントの望ましい状態、ランタイム、作業のルーティング方法を記述するシンプルな TOML ファイル。
• ランタイムプロバイダー – エージェントを実際に実行するプラグインバックエンド。組み込みオプションは次のとおりです：
  • tmux（デフォルト、各エージェントを独自のペインで実行）
  • subprocess / exec
  • ACP（リモート実行）
  • Kubernetes
  • herdr（軽量セッションマネージャー）
• Beads – 永続的な作業追跡ストア。デフォルトでは Dolt をバックエンドとする bd（Beads）プロバイダーを使用しますが、ファイルベースのストアもサポートされています。
• スーパーバイザーループ – 望ましい都市状態（宣言したもの）と実際の実行状態を継続的に調整し、必要に応じてエージェントを起動、停止、再起動します。
• パックとオーバーライド – 重複なしでマルチプロジェクト設定を構成できるモジュール式の設定バンドル。

主な機能

• 再現可能な環境のための宣言的設定（city.toml）。
• ローカル tmux セッションから Kubernetes クラスターまで、複数の実行バックエンド。
• 組み込みの作業追跡、数式、エージェント間のメッセージング。
• スーパーバイザーによるヘルスチェックと自動復旧。
• プロジェクト間で共通パターンを共有するための拡張可能な「パック」。

典型的なユースケース

• コードを生成、テスト、コミットする複数の LLM 搭載コーディングアシスタントの調整。
• データをスクレイピングし、処理し、結果を下流モデルに供給する AI エージェントのパイプラインの実行。
• 一部のエージェントがローカル（tmux）で実行され、他がクラウド（K8s、ACP）で実行されるハイブリッドワークロードの管理。

はじめに

1. CLI をインストールします（Homebrew または make install）。
2. 都市を初期化します：gc init ~/my-city && cd ~/my-city。
3. gc rig add . で rig（プロジェクトフォルダー）を追加します。
4. ビード（作業単位）を作成します – 例：bd create "Create a script that prints hello world"。
5. 監督セッションにアタッチします：gc session attach mayor でエージェントの実行を確認します。

アーキテクチャ概要

• cmd/gc/ – エントリーポイント CLI。コマンドを解析し、コントローラーを配線します。
• internal/runtime/ – プロバイダーの抽象化レイヤー。各プロバイダーはエージェントの起動と監視方法を実装します。
• internal/config/ – city.toml を解析し、パック/オーバーライドを解決し、スキーマを検証します。
• internal/beads/ – 作業項目、メッセージ、待機条件のストレージレイヤー。
• internal/convergence/ – スーパーバイザーループを駆動する調整エンジン。
• internal/api/ – 外部ツール用のオプションの HTTP API。

ドキュメントとコミュニティ

• 完全なドキュメント：https://docs.gascityhall.com（Mintlify サイト）。
• クイックスタートチュートリアル、設計ドキュメント、アーキテクチャ概要はリポジトリの docs/ と engdocs/ にあります。
• Discord コミュニティに参加して、ヘルプやお知らせを受け取りましょう。

ライセンス

• MIT – 自由に使用、変更、配布できます。

---

Gas City は、洗練されたマルチエージェント AI または自動化パイプラインを構築する開発者向けの、本番グレードの実際のプロジェクトです。さまざまな実行環境でエージェントを定義、起動、健全に保つために必要な配管を提供します。