marketing-shibata50/garc-gws-agent-runtime

林駿甫 (Shunsuke Hayashi) a69b9d9160 feat: initial release — GARC v0.1.0

Permission-first AI agent runtime for Google Workspace.
Ports the LARC/OpenClaw governance model (disclosure chain,
execution gates, queue/ingress) to Gmail, Calendar, Drive,
Sheets, Tasks, and People APIs with Claude Code as the
execution engine.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-15 08:59:12 +09:00

4.3 KiB

Raw Blame History

GARC — Google Workspace エージェントランタイム CLI

Google Workspace ネイティブなオフィスワークエージェントのためのパーミッションファーストランタイム。

GARC は LARC の Google Workspace 版です。同じガバナンスアーキテクチャ（開示チェーン・実行ゲート・エージェントレジストリ・スコープ推定）を、Google Drive・Sheets・Gmail・Calendar・Tasks を使う組織向けに実装します。

GARCとは

上位エージェント（Claude Code / OpenClaw）
  -> GARC CLI/ランタイム
  -> Google Workspace APIs（Drive, Sheets, Gmail, Calendar, Tasks, Chat）

GARCが追加するもの:

パーミッションインテリジェンス — garc auth suggest "<タスク>" で自然言語タスクに必要な最小OAuthスコープを推定
実行ゲート — エージェントアクション実行前に none / preview / approval の3段階ゲート
エージェントレジストリ — エージェント定義をGoogle Sheetsに保存（id, model, scopes, folder）
開示チェーン — SOUL.md / USER.md / MEMORY.md / HEARTBEAT.md をGoogle Driveにバックアップ
メモリ同期 — Google Sheetsとの日次メモリ双方向同期
キュー/イングレス — Gmail起動のタスクライフサイクル管理
ナレッジグラフ — Google Docsをリンクされた概念ノードとして活用

GWS ↔ LARC バックエンド対応表

機能	LARC（Lark）	GARC（Google Workspace）
ファイルストレージ	Lark Drive	Google Drive
構造化データ	Lark Base	Google Sheets
メッセージング	Lark IM	Gmail / Google Chat
ナレッジ	Lark Wiki	Google Docs
承認フロー	Lark Approval	Sheets連携承認フロー
カレンダー	Lark Calendar	Google Calendar
タスク	Lark Project	Google Tasks
認証CLI	`lark-cli`	`gcloud` + googleapis
MCPツール	`openclaw-lark`	Gmail/Drive/Calendar MCP

クイックスタート

# インストール
git clone <this-repo>
cd garc-gws-agent-runtime
./scripts/setup-workspace.sh

# 設定
cp config/config.env.example ~/.garc/config.env
# ~/.garc/config.env をGWS認証情報で編集

# 初期化
garc init
garc bootstrap --agent main

# 日常使用
garc memory pull
garc auth suggest "経費サマリーをマネージャーに送信"
garc task list

設定（`~/.garc/config.env`）

GARC_DRIVE_FOLDER_ID=1xxxxx          # エージェントワークスペース用Driveフォルダ
GARC_SHEETS_ID=1xxxxx                # メモリ/レジストリ/キュー用Sheets
GARC_GMAIL_DEFAULT_TO=you@gmail.com  # デフォルト通知先メール
GARC_CALENDAR_ID=primary             # Google Calendar ID
GARC_CREDENTIALS_FILE=~/.garc/credentials.json
GARC_TOKEN_FILE=~/.garc/token.json

コマンド一覧

garc init                          # ワークスペース初期化
garc bootstrap [--agent <id>]      # Driveから開示チェーン読み込み
garc memory pull/push/search       # Sheetsとメモリ同期
garc send "<msg>" [--to <email>]   # Gmail/Google Chat経由で送信
garc task list/create/done         # Google Tasks操作
garc approve gate <task_type>      # 実行ゲートポリシー確認
garc approve list/create           # 承認管理
garc agent list/register           # エージェントレジストリ操作
garc auth suggest "<タスク>"       # OAuthスコープ推定
garc auth check [--profile <p>]    # 現在のトークンスコープ確認
garc auth login [--profile <p>]    # OAuthフロー起動
garc heartbeat                     # システム状態をSheetsに記録
garc status                        # 設定とヘルスチェック表示
garc kg build/query/show           # ナレッジグラフ操作
garc ingress enqueue/list/next     # キュー管理

LARCとの関係

GARCとLARCは同じランタイムガバナンスモデルを共有します。バックエンドに応じて選択してください：

Feishu / Lark → LARC
Google Workspace → GARC
両方のプラットフォーム → 両方デプロイ（エージェントYAML形式は互換性あり）

ライセンス

MIT

4.3 KiB Raw Blame History Unescape Escape