Treg(ツール用OpenRouter)
Treg (OpenRouter for Tools) (github.com)
要約
Tregは、AIエージェントが様々な外部ツールやAPIを、個別のサインアップやアカウント管理なしに利用できるようにするプラットフォームです。数千ものエンドポイントへのアクセスを、従量課金制で提供し、チームのAPIキーやCLIツールも一元管理できます。これにより、エージェントはタスクを指示するだけで、必要なツールをTregが仲介して実行できるようになります。
全文翻訳
Treg (エージェントツールのためのOpenRouter)
[画像: treg — エージェントのためのツールカタログ]
モデルではなく、エージェントツールのためのOpenRouterです。 1つのベースURLと1つのトークンでエージェントをポイントすれば、タスクを実行できます。多くのプロバイダーにわたる数千ものエンドポイントのキュレーションされたカタログ — SEOとバックリンク、ソーシャルとトレンド、人物と企業情報のエンリッチメント、広告、スクレイピング、画像・動画生成 — 1セントからの従量課金制で、プロバイダーへのサインアップは不要です。さらに、チームメンバー全員のエージェントが、認証情報がサーバーから離れることなく、チームのキー、スキル、CLIを呼び出すことができます。
ツールではなく、タスクを要求してください。 どのベンダーがバックリンクデータを提供しているかを知る必要も、そのベンダーのアカウントを持つ必要もありません。やりたいことを検索し、価格を確認し、呼び出してください。
Superdesignチームのために構築され、treg.toで稼働しています — 誰でもセルフホスト可能です。
なぜ存在するのか
エージェントが実際の作業に必要なツールは、単一の実行のために誰も購入しないサブスクリプション — Semrush $139/月、Moz $99/月、Crunchbase $99/月、Apollo $59/シート — の背後にあるか、サインアップの壁の後ろにあるか、あるいはまったく公開APIがない(招待制、パートナー限定、アプリレビュー限定)場所にあります。tregはそれらのアカウントを運び、1回の呼び出しあたり数セントの料金を請求します。
2種類のツール、1つのトークン
- カタログ — tregが自身のキーで、またはプロバイダーキーを必要としない検証済みの公開ルートを通じて提供できる外部エンドポイント。自身のキーでの呼び出しは、チームのプリペイド残高を使用します。匿名での呼び出しは無料です。プロバイダーとのアカウントは不要です。新規に検証されたアカウントは、適格なチームを作成した際に、一度だけ$1.00の無料クレジットを受け取ります。
- 独自のツール — チームメンバーが登録したもの:有料APIアカウント、OAuth接続、ベンダーCLI、
SKILL.md。独自のキーは常にtregのものより優先され、それらの呼び出しは決してメーターで計測されません。
2番目の部分の語彙:
- ツール = レジストリが組織の認証情報で呼び出すもの。2種類あります:
- エンドポイント — 上流の
base_url+ 認証情報バインディング(各バインディングは1つの秘密情報をリクエストに注入します。リクエストは複数を持つことができます。例:OAuthベアラーとdeveloper-tokenヘッダー)。 - CLI — ベンダーバイナリ(
stripe、gh、vercelなど)を認証情報注入で実行します。
- エンドポイント — 上流の
- スキル / バンドル = レシピ(
SKILL.md)+ その秘密情報 + そのツール(複数可)、まとめて登録されます。
唯一のルール: プロキシは上流をリレーするだけで、モデル化せず、サーバーサイドで認証を注入する — これにより、上流APIの変更に耐え、呼び出し元がキーを持つことはありません。
パート1 · レジストリの使用
treg.to(Render上にホスト)をご覧ください — ダッシュボード、サインイン、および以下のすべてのURLがそこにあります。
クイックスタート
ダッシュボードの開始ガイドと同じフローです:
# 1. CLIをインストール — レジストリもポイントします
curl -fsSL https://treg.to/install.sh | sh
# 2. サインイン(デフォルトはGitHub · --emailでワンタイムコード · --tokenでエージェント/CI用)
treg login
# 3. すぐに役立つことを行う — キー不要、登録不要
treg catalog search "backlinks for a domain" # 何をするかでツールを見つける
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok
treg balance # そのコストを正確に確認
# (または `treg onboard` でガイド付きウォークスルー)
Fish AudioはS2.1 Pro音声、公開音声の発見、プライベート音声クローニングを提供します。音声はバイナリ標準出力なので、ファイルにリダイレクトしてください。発見された音声の_idまたはチーム音声IDはTTSのreference_idです。tregのFishアカウントで作成された音声は、永続的なチームリソースです:
treg call fishaudio.tts.s2-1-pro --method POST --header model=s2.1-pro \
--data '{"text":"Hello from treg","format":"mp3"}' > speech.mp3
treg call fishaudio.voices.discover --query self=false --query licensed=false --query language=en
treg resources list --provider fishaudio --kind voice
独自のFishキーを使用すると、リクエストは無制限でメーターで計測されない上流リレーのままで、Fishがアカウントの境界を所有します。
カタログツールの入力は treg catalog get <id> で説明されます。strict_queryとマークされたツールは、宣言されていない、または繰り返されたクエリパラメータ、サポートされていない値、およびリクエストボディを拒否します。
あなたのトークンはすべての呼び出しであなたを識別し(X-Treg-Tokenヘッダー)、すべてのツールで同じです。チームが共有しているものを発見してください: treg tool ls · 認証情報の健全性を確認してください: treg health。
またはClaude Codeプラグインとしてインストール
/plugin marketplace add superdesigndev/treg
/plugin install treg@treg
トークンも設定もなしでインストールされます。スキルはtreg:tregとしてロードされ、最初の実行時に、残りの部分(CLI、サインイン、次にtreg mcp install)をエージェントにウォークスルーします — これにより、コマンドラインとtregのツールが手に入ります。他のエージェント: npx skills add superdesigndev/treg -s treg (または残りはWorkflow skillsを参照してください)。docs/CLAUDE-PLUGIN.mdを参照してください。MiniMax Code / MiniMax Agentユーザー:同じスキルがMiniMax Plugin Marketplace(docs/MINIMAX-PLUGIN.md)を通じて提供されます。
ワークフロースキル
エージェントがエンドツーエンドで実行する、treg経由のすべての呼び出しを行う、すぐに使えるレシピです:
| スキル | エージェントができること |
|---|---|
treg | カタログのすべてのツール、および独自のツールを見つけて呼び出す |
web-access | ローカルスクレイパーなしでライブウェブを読む:まず無料の検索とページ読み取り、次にソーシャル、ストア、レビュー、ペーパー向けの適切なプラットフォームジョブ、tregは1つが失敗した場合に次のベンダーにフォールバックする |
lead-signals | 公開シグナル(苦情、転職、採用、資金調達、ツール導入)から市場のバイヤーを見つけ、トピック、競合他社、またはアカウントリストを監視する(treg.to/leads-signals) |
recruit | LinkedInの求人投稿をランク付けされたショートリストに変換する:投稿からの基準、人物検索、理由付きフィルター、各候補者が適合する理由の1行、候補者ごとの支出キャップの下での引用された証拠(投稿、GitHub、講演、在籍期間、転職)、次に確認済みの個人メールと電話番号、候補者ごとのカウント、証拠、ベンダーのトレイルの実行ファイル |
make-ugc | AI UGC動画を作成する:トレンドのフック、プレゼンター、トークヘッドクリップ、キャプション(treg.to/ugc) |
jev-memory | Claude Codeにメモリを与える:Jevが各ターンの後にプロンプトを評価し、永続的な好みを保持するClaude Codeモッド。既製のものをインストールするか、1つのプロンプトから構築する(the mod) |
install.shはjev-memoryを除くすべてをインストールします。既存のエージェントに追加するには(skills.sh CLI):
npx skills add superdesigndev/treg # すべての公開スキル
npx skills add superdesigndev/treg --skill lead-signals # 1つだけ
treg skill bootstrap # 同じセット、すでに持っているtreg CLIを使用
ワークフロースキルはtreg上で実行されるため、まずセットアップしてください(上記のクイックスタート、またはエージェントをtreg.to/llms.txtにポイントしてください)。
Claude.aiコネクタ
Claude Connectors Directoryのサーフェスは https://treg.to/mcp/v2/ です。画像、動画、音声生成を含まないキュレーションされたカタログエンドポイントのみを公開し、読み取り呼び出しと書き込み呼び出しを分離して、Claudeに正確な安全シグナルを送信します。既存の/mcp/サーフェスは、カタログエンドポイント、チーム所有のツール、およびインポートされたスキルで引き続き利用可能です。境界と実装についてはMCPとOAuthアーキテクチャを参照し、リリースゲートについては提出ランブックを参照してください。
キーを持っていないツールを呼び出す
カタログは、エンドポイントが何をするかでグループ化されています:キーワードとランク追跡、バックリンクと権威、AI可視性、トレンドと発見、ソーシャルへの公開、人物と企業情報のエンリッチメント、広告管理とクリエイティブ、測定。
treg catalog # すべてのプラットフォーム、最も忙しい順
treg catalog search "find a work email" # ベンダーではなく、ジョブで検索
treg catalog search --new # 過去30日以内に追加されたツール、新しい順
treg catalog get hunter.people.email.find # パラメータ、価格、応答例
treg call hunter.people.email.find --query domain=reddit.com --query full_name="Alexis Ohanian"
カタログ化された呼び出しがどのように提供されるか — 認証情報の階層、順序:
- チームがそのプロバイダーの独自のツールを登録した → そのツール、そのキー;
- チームがプロバイダーの秘密情報を保存した → 仮想ツールを介して注入;
- どちらでもなく、エンドポイントに検証済みの公開ルートがある → プロバイダーキー不要、無料;
- それ以外 → treg自身のキー、チームのプリペイド残高に請求。
匿名価格は、呼び出し元がプロバイダー認証ヘッダーを送信しないことを前提としています。忠実なリレーは呼び出し元ヘッダーを保持するため、呼び出し元が提供したプロバイダーキーはそのキーのクレジットを使用できます。独自の認証情報は常にtregのものを上回るため、すでに支払っているキーを接続すると、それらの呼び出しは重複するのではなく、残高から無料になります。tregが公開価格を持っていないエンドポイントは、無料提供されず拒否されます — 代わりに独自のキーを接続するように指示されます。複数のプロバイダーが1つの機能を提供する場合、treg catalog searchはそれらを価格と共に並べて表示します。選択はあなた次第です — tregはプロバイダーをサイレントに選択したり、フェイルオーバーしたりしません。(treg自身のプロバイダーアカウントがなくなった場合、treg所有のリレーアカウントを通じて同じエンドポイントを提供することがあり、応答で開示されます。チームはオプトアウトできます。)あなたがオプトインする例外:treg.<capability>ルーティングされたエンドポイント、tregがプロバイダーを選択し、それを名前付けします。一般的なジョブ(ページのスクレイピング、ウェブ検索、Googleの結果、メールの検索)については、プロバイダー名を覚えているのではなく、treg.web.extractやtreg.web.searchのようなルーティングされたエンドポイントから始めてください。treg.people.email.findおよびtreg.people.phone.findでは、X-Treg-Route-Verify: trueは、見つかったアドレスまたは番号を同じ呼び出しで、独自の電荷としてチェックし、何が見つかったかを示します。
treg balance # 残りのクレジット、進行中の呼び出し、最近の支出
treg topup # 資金を追加、または自動トップアップを設定
残高不足はHTTP 402 error: insufficient_balanceとなり、balance_micro、estimated_cost_micro、およびtopup_urlを運びます。これにより、エージェントはテキストを読むことなくそれに対応できます。
Enrich Arenaはダッシュボードの外、/enrich-arenaで利用できます。エンリッチメントの回答をベンダーごとのコストと速度で比較し、ワンクリックで最良の回答に投票するか、シーケンシャルなウォーターフォールを観察します。機能互換性のある非同期プロバイダーも参加します。Arenaは提出とポーリングを内部で処理します。閲覧は公開ですが、提出にはログインが必要で、請求可能な試行はチームのクレジットを使用します。Arenaガイド(Arena guide)を参照してください。
Web Arenaは/web-arenaでWeb検索、Webフェッチ、サイトマッププロバイダーを比較します。選択されたプロバイダーに対して同じ入力で呼び出しをバトルさせます。ウォーターフォールはそれらを順に試します。ライブリーダーボードは、直接プロバイダー呼び出しのヒット率と応答時間を、チェックされたWeb Arenaの品質結果と組み合わせて、ローリング30日ウィンドウで集計します。機能が有効になるとページが開きます。Web Arenaガイド(Web Arena guide)を参照してください。
独自のツールを共有・使用する
ゼロ思考パス — Tregをプロジェクトにポイントすると、共有可能なものを特定します:
treg scan # 読み取り専用プレビュー:キー、スキル、CLIのアップロードが登録されるもの
treg upload # それらを登録します(サーバーサイドで暗号化);冪等、更新するには--replaceを使用
treg uploadは.env(約80の既知プロバイダーに対するキーのマッチング)、すべてのスキルサブディレクトリ、およびインストールされているカタログCLIをスキャンします。レジストリに登録される3種類のもの — それぞれを共有して使用する方法:
1. エンドポイント(HTTP API)
共有 — 保存されたキーで呼び出し可能な1つの上流URL、または.envからのバルク:
treg secret add STRIPE_KEY --value sk_live_123
treg add stripe --base-url https://api.stripe.com --secret STRIPE_KEY
treg upload env --select openai,stripe,resend # または直接.envから
使用 — エージェントネイティブな方法:実際の上流リクエストを構築し、プロキシでプレフィックスを付けます。Tregはホストでツールを解決し、認証情報を注入し、その他すべてを忠実にリレーします(あなたのX-Treg-Tokenは上流に見られる前に削除されます):
実際の要求: GET https://api.intercom.io/conversations?per_page=5
Treg経由: GET https://treg.to/call/https://api.intercom.io/conversations?per_page=5
ヘッダー: X-Treg-Token: <あなたのトークン>
またはCLIのショートハンド — そして監査ログにはtreg callsを使用します:
treg call intercom conversations --query per_page=5
treg call stripe v1/balance
2. CLI
共有 — 自動:treg uploadはインストールされているカタログCLI(stripe、gh、vercelなど)を検出し、登録します。レシピのみのカタログCLIスキル(例:stripe-cli)も実行可能になります。
使用 — treg runは、組織の認証情報を注入してベンダーCLIを実行します。これにより、キーを保持したりログインしたりする必要がなくなります:
treg run stripe -- get /v1/balance
treg run gh -- pr list
treg run --server agentmail-cli inboxes list # レジストリサーバーで実行:キーはあなたに届きません
--local(デフォルト)はあなたのマシンで実行します;--serverはレジストリで実行し、出力をストリームバックします。セッション全体の場合、treg shell startはサブシェルを開き、登録されているすべてのCLIが自動的に注入されます — stripe、ghなどを通常どおり使用するだけです;exitで元に戻ります。treg runsは監査ログです。
3. スキル
共有 — スキルは完全な機能(SKILL.mdレシピ + その秘密情報 + そのツール)であり、まとめて登録されるため、チーム全体が同じスキルを実行し、1か所で保守されます:
treg upload skills --dir ~/.claude/skills --all # スキルのフォルダを一度に登録
使用 — 共有されたスキルをエージェントにプルします。そのAPI呼び出しはあなたのトークンでtregを経由するため、キーはサーバーに残り、スキルには決して入りません:
treg skill install seo-blog-writer # ./.claude/skills/ に書き込みます(ライブラリ全体の場合は--all)
手動登録 — ヒューリスティックがツールを特定できない場合
# マルチ認証情報ツール(例:google-ads:OAuthベアラー + developer-tokenヘッダー)
treg tool add google-ads --base-url https://googleads.googleapis.com \
--bind "secret=<oauth-id>,injector=oauth" \
--bind "secret=<dev-id>,name=developer-token,format={secret}"
# 1つのスキル、ステップバイステップ
treg skill init --dir ./my-skill # treg.jsonをドラフト(ベースURLを推測、秘密情報を見つける)
treg skill add --dir ./my-skill # レシピ + 秘密情報 + ツールをアトミックに登録
# ブラウザ経由のOAuth(最初のトークンを発行、tregが保持し自動更新)
treg oauth connect gsc --client-secret client_secret.json \
--scopes https://www.googleapis.com/auth/webmasters.readonly
すべてのコマンドの完全なオプション:USAGE.md。
CLIはtreg.toを使用する場合、PostHogに匿名コマンド使用状況を送信します(引数や認証情報なし)。TREG_TELEMETRY=0またはDO_NOT_TRACK=1で無効にできます。分析詳細(analytics details)を参照してください。
チーム
1つのアカウントは最大10チームを所有できます。他のチームにメンバーとして参加しても、この制限にはカウントされません。
すべてが組織にスコープされます:トークンは(ユーザー, 組織)メンバーシップであり、すべての秘密情報、ツール、スキルはアクティブな組織に属します。ロール:オーナー / 管理者 / メンバー / ビューア。
treg org create "Acme" # チームを作成し、オーナーになる
treg org invite teammate@acme.com # メールで招待(ロール + ツールアクセスを選択)
treg org join <code> --email you@acme.com # 招待を受け入れる(新規の場合は作成)
treg org ls | use <slug> | members # 組織を切り替え、名簿を表示
treg org access <member> --tools a,b # メンバーごとのツールアクセス(管理者以上)
より深く
-
フィードバック:
treg feedback submit friction "The pagination example is unclear."プライベート情報なしで問題や提案を共有します。フィードバック手順(feedback instructions)を参照してください。 -
レビュー:
treg review CALL_ID useful結果を使用した後に招待されたカタログ呼び出しを評価します;not_sureでも構いません。プライベートデータを省略し、タスクを続行します。 -
USAGE.md— 完全なtregCLIリファレンス。 -
/llms.txt:エージェントのエントリーポイント、llmstxt.org形式:tregとは何か、各種類のエージェントの設定、検索-読み取り-呼び出しループとルール、およびその他すべてに関する運用ガイドである/skill.mdへのリンクが含まれています。 -
ダッシュボード treg.to — 完全なCRUD、ガイド付きチュートリアル(ヘルプ → チュートリアル)、およびエージェント用のコピー可能なセットアップ手順。
-
API — CLIが行うすべてのことはプレーンHTTPです;インタラクティブなOpenAPIドキュメントは
/docsにあります。プロキシエンドポイントは/call/{...}です;すべてのエンドポイントはX-Treg-Tokenヘッダーを受け取ります。
パート2 · セルフホスティングと開発
ローカルで実行
1つのコマンド(tmux + uvが必要です;仮想環境を自分で同期します):
scripts/dev-local.sh up # http://localhost:18790でサーバー、開発セーフ設定
これはtmuxでホットリロード、独自のsqlite DB(treg-dev.db)、およびメールOTP開発モード(ページに表示されるサインインコード — メール送信者不要)でサーバーを実行します。日常的な使用:
scripts/dev-local.sh cli login # サンドボックス化されたCLI:実際の~/.treg/config.jsonには触れません
scripts/dev-local.sh logs # サーバー出力 · ステータス / 再起動 / 停止
scripts/dev-local.sh reset # 開発DB + CLIサンドボックスをワイプして新規開始
または、tmuxなしでサーバーを直接実行します:
bash scripts/build-dashboard.sh # Node 22.12+およびnpm;ダッシュボードをビルド
uv sync # uv.lockから仮想環境を作成(開発用のサーバー依存関係をプル)
uv run python -m treg upgrade # スキーマを準備 + 冪等リリースタスクを実行(サーバーなし)
uv run python -m treg # 0.0.0.0:18790で提供(開発用に--reloadを追加)
uv run python -m treg keygen # 新しいFernetキーをTREG_SECRET_KEYに印刷
サーバーを実行するためのインストール(ソースからではない): 基本パッケージはCLIのみです。レジストリを実行するには、サーバーエクストラをインストールします —
pip install "tools-registry[server]"— これによりFastAPI、データベースドライバー、および暗号化が追加されます。pip install tools-registryのみでは、既存のレジストリと通信するためのtregコマンドのみが提供されます。
公式ホストサービスは treg.to で利用可能です。その本番トポロジーとライブ設定は、プライベートなoperator runbookで維持されています。
設定
環境変数(プレフィックスTREG_、.envから読み取り):
| 変数 | デフォルト | 目的 |
|---|---|---|
TREG_DATABASE_URL | sqlite+aiosqlite:///./treg.db | DB URL(開発用SQLite、本番用Postgres) |
TREG_READ_DATABASE_URL | (空) | オプションのSQLite / PostgreSQL読み取りデータソース;空の場合はプライマリを再利用します。呼び出し元にオプトインを要求します;既存のクエリは変更されません。読み取りレプリカ設定(read datasource setup)を参照してください。 |
TREG_SECRET_KEY | (空) | 保存中の秘密情報のFernetキー;空の場合は一時的なキーが発行されます(秘密情報は再起動で持続しません) |
TREG_PUBLIC_URL | https://treg.to | Tregの公開ベース、OAuthコールバックURIの構築に使用 |
TREG_SESSION_SECRET | (空) | ダッシュボードセッションCookieに署名します;TREG_SECRET_KEYにフォールバックします。本番環境では実際の値を設定してください |
TREG_GITHUB_CLIENT_ID / _SECRET | (空) | GitHub OAuthサインイン(コールバック <public_url>/auth/github/callback);空の場合はボタンを非表示にします |
TREG_GOOGLE_CLIENT_ID / _SECRET | (空) | Google OAuthサインイン(リダイレクト <public_url>/auth/google/callback);空の場合はボタンを非表示にします |
TREG_INSTAGRAM_CLIENT_ID / _SECRET | (空) | 直接Instagramログイン用のInstagramアプリIDとシークレット(リダイレクト <public_url>/oauth/callback) |
TREG_META_CLIENT_ID / _SECRET | (空) | Facebookページ、Meta広告、およびオプションのInstagram page-tools用のMetaアプリ認証情報 |
TREG_OAUTH_REVIEW_PENDING | instagram-login,page-messages | カタログレビューキーのコンマ区切りリスト。その機能は引き続き制限付きである必要があります;ホストされたレビュー状態はプライベートに維持されます。 |
TREG_RESEND_API_KEY / TREG_EMAIL_FROM | (空) | Resend経由のトランザクションメール(OTPコード + 招待);FromはResendで検証済みの送信者である必要があります |
TREG_BLOCKED_EMAIL_DOMAINS | (空) | すべてのサインアップ/サインインドアおよびチーム作成時に拒否されるコンマ区切りのメールドメイン(サブドメインを含む、大文字小文字を区別しない)。空の場合は何もブロックしません — コードにリストはありません |
TREG_CLIENT_IP_HEADER | (空) | エッジのみが設定できるヘッダー。IPごとの制限のクライアントアドレスとして使用されます(Cloudflareの後ろではcf-connecting-ip) |
TREG_TRUSTED_PROXY_HOPS | 1 | そのヘッダーがない場合:右から数えてこのホップ数のX-Forwarded-Forエントリ(最も近いプロキシが追加したもの);クライアントが直接接続する場合は0。最初のエントリはクライアントによって書き込まれ、決して信頼されません |
TREG_REQUIRED_EXTENSIONS | (空) | コンマ区切りのポリシー拡張機能(treg.extensionsエントリーポイント)をインストールする必要があります。それ以外の場合は起動に失敗します。treg.toはこの方法でプライベートな不正行為ポリシー拡張機能を実行します。制限のみ可能です(policy extensions) |
TREG_TURNSTILE_SITE_KEY / _SECRET | (空) | すべてのメールサインインフォームのCloudflare Turnstile;空の場合はオフ。サイトキーは/captcha.jsで提供され、シークレットはsiteverifyにのみ到達します |
TREG_TURNSTILE_MODE | observe | observeは各結果をログに記録し、何も変更しません;enforceは無効または無効なトークンへのコードを拒否し、Cloudflareが回答できない場合はサインアップクレジットを与えません |
TREG_TURNSTILE_HOSTNAMES | (空) | トークンが解決される必要があるコンマ区切りのホスト;空の場合はTREG_PUBLIC_URLのホスト(およびその既知のエイリアス) |
TREG_ADMIN_TOKEN | (空) | クロステナントスーパーアドミンベアラー;すべての/admin/*エンドポイントを承認します。空の場合は環境パスを無効にします(is_superadminユーザーのみが/adminに到達します)。長く秘密に保ってください。 |
TREG_EMAIL_DEV_MODE | false | trueの場合、/auth/email/startはOTPを応答で返します(メール送信者不要) — 開発/ローカルのみ、本番では決して使用しません。 |
TREG_KV_URL | (空) | すべてのワーカーが合意する必要があるカウンター用の共有キーバリューストア(Redisプロトコル)、今日はチームごとのレビュー招待予算。空の場合はインプロセスフォールバック、ワーカー1つで十分 |
ローカル開発には.envは不要です — すべての設定には動作するデフォルト値があります(一時的なキー、sqlite)。
⚠️ 移動または再デプロイする前にバックアップしてください: Fernetキー(
TREG_SECRET_KEY)とデータベース(本番環境ではPostgres;ローカルSQLite実行の場合はtreg.db)。Fernetキーを失うと、保存されているすべての秘密情報は回復不能になります。
アーキテクチャ
/call のリクエストフロー: ツールの解決(URLホスト + 最長のbase_urlプレフィックス、または名前で)→ その秘密情報の復号 → 各バインディングのインジェクターの適用 → 上流へのストリーム → ファイアアンドフォーゲット監査記録。インフラリレーはビジネスロジックなしでバイトをストリームします。呼び出しアプリケーションは、決済または所有権の証拠を必要とする応答を最大8 MiBまでバッファリングします;それより大きい応答は、切り詰められた成功ではなく、502エラーを返します。メディアをインライン化するエンドポイント(Gemini画像)はspooled_responseを宣言します:メーターで計測された応答は一時ファイルに読み込まれ、報告された使用量から決済され、全体がリレーされます。証拠となるボディを必要としない承認済みの無料最終ダウンロードは、全体がストリームされ、独自のキーおよび独自のツール応答も同様です。
モジュールマップ(src/treg/):
| モジュール | 役割 |
|---|---|
proxy.py | relay() — 製品全体を1つの関数で:忠実なストリーミングプロキシ |
injectors.py | 認証形状のシーム:env、cli_auth、secret_file、oauthが秘密情報をヘッダー/クエリに配置 |
oauth.py | トークン新鮮さ(シングルフライトリフレッシュ) + 接続フロー(同意URL、コード交換) |
health.py | 認証情報健全性:OAuthをリフレッシュし、ツールをプローブし、壊れたものを所有者にWebhookで通知 |
convert.py | スキルディレクトリを登録可能なバンドルマニフェストにスキャフォールド |
api.py | API — 唯一の頭脳;CLI + スキルは薄いクライアント |
cli.py | treg CLI |
models.py | SQLModelテーブル:Org、User、Membership、Invite、Secret、Tool、Bundle、PendingOAuth、CallRecord |
crypto.py config.py db.py audit.py | Fernet暗号化 + トークン · 設定 · 非同期DB · 遅延監査ライター |
4つの認証形状(バインディングごとのinjector):env(プレーン文字列 / APIキー) · secret_file(JSONトークンファイル、フィールドをプル) · oauth(JSON OAuthトークン、リフレッシュ可能なら自動更新) · cli_auth(CLIのキーチェーンから持ち上げられたマテリアル)。
忠実なリレー契約: プロキシは3つのものだけを変更します。他はすべてそのままです:
- ホップバイホップトランスポートヘッダー(ホップごとに再誘導)、
- Treg自身の制御+エッジ転送ヘッダー(
x-treg-token、x-treg-org、ngrok-skip-browser-warning、x-forwarded-*、via、…)とTregのセッションCookie — すべて削除され、上流に漏れることはありません、 - 注入された認証情報。
OAuth、最初のトークンを取得する3つの方法: 手動アップロード(token.jsonにドロップ) · 自動更新(トークンがrefresh_token + クライアントクレデンシャルを持つ場合、Tregはそれを新鮮に保ち、再アップロードする必要はありません) · ホストされた接続フロー(treg oauth connect → ブラウザ同意 → Tregがトークン自体をキャプチャ)。
健全性チェック: ツールにオプションのプローブ({method, path, expect_status})を提供します;定期的な実行(オンデマンドまたはcron経由)は、すべての認証情報を検証し、OAuthをリフレッシュし、壊れたものをすべて所有者にWebhookで通知します。
詳細な設計はdocs/context/(サブシステムごとのフラグメント)にあります。
テスト
uv run --with pytest-xdist pytest -n auto -q # 日常的なローカルデフォルト(CIと同じ形状)
uv run --frozen python -m pytest -q # シリアル:1つのテストのデバッグ、または順序
カバレッジ:プロキシウォーキングスケルトン、すべてのインジェクター形状、ユーザーごとの認証+CRUD+監査、スキルコンポーザー、URLパススルー+忠実なリレー、OAuthリフレッシュ+接続フロー、健全性チェック、treg run/shell、アップロード/スキャン、組織+招待、ダッシュボードAPI、CLI。
貢献とドキュメント
treg/
├── src/treg/ # パッケージ(api, cli, proxy, injectors, oauth, health, convert, models, …)
│ └── web/ # ダッシュボード、ランディングページ、チュートリアル、llms.txt、skill.md、install.sh
├── tests/ # pytestスイート(CI + ローカルデフォルト:pytest-xdist -n auto)
├── docs/
│ ├── context/ # 設計フラグメント(コードマップシステム)+ 生成されたインデックス
│ └── ONBOARDING.md # 初回ブートストラップ
├── USAGE.md # 完全なtreg CLIリファレンス
└── pyproject.toml
サブシステムごとの設計ドキュメントは、docs/context/のフラグメントであり、それぞれがsrc/treg/*ソースを引用しています。このリポジトリでAIエージェントと作業していますか? /tools-registry-contextスキルは、あなたが触れているものに適したフラグメントをロードし、ドキュメントを同期させます — プッシュする前に/tools-registry-context syncを実行してください。
ロードマップ: MCPサポート · より細かい権限階層 · 保存中のキー管理強化 · Loopniのマージの可能性。
ライセンス
追加条項付きApache 2.0(LICENSE):商用利用を含む、あなたの組織内での自由な利用(独自のレジストリのセルフホスティングを推奨します)。制限:書面による許可(jason@superdesign.dev)なしで、コードを第三者に競合するホスト/マネージドレジストリサービスとして再配布しないでください。あなたの製品内でホストされているtreg.to APIを使用すること — X-Treg-Metaとusage/by-tagを介したパススルー請求を含む — は、許可なしで許可されます;これは私たちのAPIを呼び出すことであり、私たちのソフトウェアを再配布することではありません。
ピン留めされた顧客読み取りスコープ
制限された顧客エージェントの場合、treg org agent-new bot --pin customer=cust_Aは、帰属を強制し、呼び出し/実行履歴、アーカイブされた結果、および共有プロバイダーの非同期所有権をそのピンにスコープします。外部または帰属不明のIDは404を返します;ピン留めされていないオペレーターは組織全体のビューと共有残高を保持します。BYOKアカウントアクセスと公開メディアURLは、既存の権限を保持します。複数のピン、移行、およびリプレイ動作については、マルチテナンシー契約を参照してください。