treg
公式1つのMCPサーバーと1つのキーで3,700以上の従量課金制APIを利用可能:SEOとバックリンク、人物・企業エンリッチメント、ソーシャル、広告、スクレイピング、画像・動画生成。リモート(https://treg.to/mcp/v2/、OAuth)またはセルフホストで利用できます。
Treg MCPで何ができますか?
- ツールカタログを検索 — アシスタントに、機能に基づいてツールを探してもらいます。例:「ドメインのバックリンクを検索」などと指示し、プロバイダーを価格とともに横並びで比較します。
- プロバイダーキーなしでツールを呼び出す — アシスタントに
treg call hunter.people.email.findなどのカタログエンドポイントを呼び出させ、人や企業の情報を充実させます。呼び出しごとに残高から課金されます。 - 認証情報を注入してベンダーCLIを実行 — アシスタントに
treg run stripe -- get /v1/balanceやtreg run gh -- pr listなどのコマンドを実行させます。APIキーを自分で保持する必要はありません。 - 独自ツールの登録と共有 — アシスタントに
treg scanでプロジェクトをスキャンさせ、その.envキー、スキル、CLIをアップロードして、チーム全体で利用できるようにします。 - ワークフロースキルのインストールと実行 — アシスタントに、既製のスキル(例:
lead-signalsで購買意欲の高い見込み客を発見、make-ugcでAIによるUGC動画をエンドツーエンドで作成)を取得させます。 - チームとアクセス権の管理 — アシスタントに、組織の作成、チームメイトの招待、メンバーの特定ツールへのアクセス範囲の設定を依頼します。例:
treg org createやtreg org accessなどのコマンドを使用します。
ホスト型 MCP サーバー
npx add-mcp 'https://treg.to/mcp/v2/'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
Treg(ツール向けOpenRouter)

OpenRouter、ただしモデルではなくエージェントツール向け。 エージェントを1つのベースURLと1つのトークンで指定するだけで仕事ができます。多数のプロバイダーにわたる数千のエンドポイントの厳選カタログ — SEOや被リンク、ソーシャルやトレンド、人物・企業エンリッチメント、広告、スクレイピング、画像・動画生成など — 1回の呼び出しあたり1セントから、プロバイダーへの登録不要。さらに、チーム自身のキー、スキル、CLIも、資格情報がサーバーから出ることなく、すべてのチームメイトのエージェントから呼び出せます。
ツールではなくタスクを指定してください。 どのベンダーが被リンクデータを販売しているか、またはそのベンダーにアカウントを持っているかを知る必要はありません。やりたいことを検索し、価格を読み、呼び出すだけです。
Superdesignチームのために構築され、treg.toで公開中 — 誰でもセルフホスト可能です。
存在理由
エージェントが実際の作業に必要とするツールは、1回の実行のために誰も購入しないサブスクリプションの背後にあります — Semrush $139/月、Moz $99/月、Crunchbase $99/月、Apollo $59/シート — 登録の壁の背後、または公開APIがまったくない状態(招待制、パートナー限定、アプリレビュー限定)です。tregはそれらのアカウントを保持し、1回の呼び出しあたり1セント未満を請求します。
2種類のツール、1つのトークン
- カタログ — tregが自社キーまたはプロバイダーキー不要の検証済み公開ルートを通じて提供できる外部エンドポイント。自社キーの呼び出しはチームのプリペイド残高を使用し、匿名呼び出しは無料です。プロバイダーへのアカウントは不要です。新規の検証済みアカウントは、対象チームを作成すると**$1.00無料**が一度だけ付与されます。
- 自社ツール — チームメイトが登録したものすべて:有料APIアカウント、OAuth接続、ベンダーCLI、
SKILL.md。自社キーは常にtregのキーより優先され、それらの呼び出しはメータリングされません。
後半の用語:
- ツール = レジストリが組織の資格情報で代わりに呼び出すもの。2種類あります:
- エンドポイント — アップストリームの
base_url+ 資格情報バインディング(各バインディングはリクエストに1つのシークレットを注入します。リクエストは複数を保持でき、例:OAuthベアラーおよびdeveloper-tokenヘッダー)。 - CLI — 資格情報を注入して実行されるベンダーバイナリ(
stripe、gh、vercel、...)。
- エンドポイント — アップストリームの
- スキル / バンドル = レシピ(
SKILL.md)+ そのシークレット + そのツールをまとめて登録したもの。
唯一のルール: プロキシはアップストリームを中継するだけで、モデリングはせず、認証をサーバー側で注入します — そのためアップストリームのAPI変更に耐え、呼び出し元がキーを保持することはありません。
パート1 · レジストリの利用
treg.to(Renderでホスト)にアクセス — ダッシュボード、サインイン、および以下のすべてのURLはそこにあります。
クイックスタート
ダッシュボードのはじめにガイドと同じ流れです:
# 1. install the CLI — also points it at the registry
curl -fsSL https://treg.to/install.sh | sh
# 2. sign in (GitHub default · --email for a one-time code · --token for agents/CI)
treg login
# 3. do something useful immediately — no key, nothing registered
treg catalog search "backlinks for a domain" # find a tool by what it DOES
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok
treg balance # exactly what that cost
# (or `treg onboard` for the guided walkthrough)
Fish AudioはS2.1 Pro音声、公開音声ディスカバリー、プライベート音声クローンを提供します。音声はバイナリstdoutなので、ファイルにリダイレクトしてください。ディスカバリーされた音声の_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(残りはワークフロースキルを参照)。docs/CLAUDE-PLUGIN.mdを参照。MiniMax Code / MiniMax Agentユーザー:同じスキルがMiniMax Plugin Marketplace経由で提供されます(docs/MINIMAX-PLUGIN.md)。
ワークフロースキル
エージェントが最初から最後まで実行する既製レシピ。すべての呼び出しはtreg経由です:
| スキル | エージェントができること |
|---|---|
treg | カタログ内の任意のツールと自社ツールを検索して呼び出す |
lead-signals | 公開シグナル(苦情、転職、採用、資金調達、ツール採用)から市場内の買い手を見つけ、トピック、競合他社、アカウントリストを監視(treg.to/leads-signals) |
make-ugc | AI UGC動画を作成:トレンドのフック、プレゼンター、トーキングヘッドクリップ、キャプション(treg.to/ugc) |
install.shがすべてをインストールします。代わりに既存のエージェントに追加する場合(skills.sh CLI):
npx skills add superdesigndev/treg # every public skill
npx skills add superdesigndev/treg --skill lead-signals # just one
treg skill bootstrap # same set, with the treg CLI you already have
ワークフロースキルはtreg上で実行されるため、先にセットアップしてください(上記のクイックスタート、またはエージェントをtreg.to/llms.txtに向けてください)。
Claude.aiコネクタ
Claude Connectors Directoryサーフェスはhttps://treg.to/mcp/v2/です。厳選されたカタログエンドポイントのみを公開し、読み取り呼び出しと書き込み呼び出しを分離して、Claudeが正確な安全性シグナルを受け取れるようにします。既存の/mcp/サーフェスは、カタログエンドポイント、チーム所有ツール、インポートされたスキルに引き続き利用可能です。境界と実装についてはMCPおよびOAuthアーキテクチャを、リリースゲートについては提出ランブックを参照してください。
キーを持っていないツールを呼び出す
カタログはエンドポイントが何をするかでグループ化されています:キーワードとランク追跡、被リンクと権威性、AI可視性、トレンドとディスカバリー、ソーシャルへの公開、人物・企業エンリッチメント、広告管理とクリエイティブ、測定。
treg catalog # every platform, busiest first
treg catalog search "find a work email" # by the job, not the vendor
treg catalog get hunter.people.email.find # params, PRICE, example response
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がプロバイダーを選択し、その名前を明示します。
treg balance # credit left, calls in flight, recent spend
treg topup # add funds, or set up automatic top-ups
残高不足はHTTP 402で、balance_micro、estimated_cost_micro、topup_urlを伴うため、エージェントは散文を読まずに行動できます。
Enrich Arenaはダッシュボード外の/enrich-arenaにあります。各ベンダーのコストと速度でエンリッチメント回答を比較し、ワンクリックで最良の回答に投票するか、順次ウォーターフォールを確認できます。機能互換の非同期プロバイダーも参加します。Arenaは送信とポーリングを内部的に処理します。閲覧は公開、送信にはログインが必要で、課金対象の試行はチームのクレジットを使用します。Arenaガイドを参照してください。
自社ツールの共有と利用
考えずに使えるパス — tregをプロジェクトに向けると、共有可能なものを自動的に判断します:
treg scan # read-only preview: the keys, skills & CLIs upload would register
treg upload # register them (encrypted server-side); idempotent, --replace to update
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 # or straight from the .env
利用 — エージェントネイティブな方法:実際のアップストリームリクエストを構築し、プロキシをプレフィックスとして付けます。tregはホストでツールを解決し、資格情報を注入し、他のすべてを忠実に中継します(あなたのX-Treg-Tokenはアップストリームが見る前に削除されます):
Real request: GET https://api.intercom.io/conversations?per_page=5
Through treg: GET https://treg.to/call/https://api.intercom.io/conversations?per_page=5
header: X-Treg-Token: <your 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 # runs on the registry server: the key never reaches you
--local(デフォルト)はあなたのマシンで実行されます。--serverはレジストリ上で実行され、出力をストリーミングで返します。セッション全体では、treg shell startがサブシェルを開き、登録済みのすべてのCLIが自動的に注入されます — stripe、gh、...を通常どおり使用するだけです。exitで元に戻ります。treg runsが監査ログです。
3. スキル
共有 — スキルは完全な機能(SKILL.mdレシピ + そのシークレット + そのツール)で、チーム全体が同じスキルを実行できるようまとめて登録され、1か所で保守されます:
treg upload skills --dir ~/.claude/skills --all # register a folder of skills in one pass
利用 — 共有スキルをエージェントに取り込むだけです。API呼び出しはあなたのトークンでtregを通るため、キーはサーバーに留まり、スキルには決して入りません:
treg skill install seo-blog-writer # writes into ./.claude/skills/ (--all for the library)
手動登録 — ヒューリスティックでツールを判断できない場合
# multi-credential tool (e.g. google-ads: OAuth bearer + a developer-token header)
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}"
# one skill, step by step
treg skill init --dir ./my-skill # drafts treg.json (guesses base_url, finds secrets)
treg skill add --dir ./my-skill # registers recipe + secrets + tool, atomically
# OAuth via the browser (mints the first token, treg holds it and auto-refreshes)
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で無効化できます。アナリティクス詳細を参照してください。
チーム
アカウントは最大10チームを所有できます。メンバーとして他のチームに参加してもこの制限にはカウントされません。
すべては組織にスコープされます:トークン = (user, org)メンバーシップであり、すべてのシークレット、ツール、スキルはアクティブな組織に属します。ロール:オーナー / 管理者 / メンバー / ビューアー。
treg org create "Acme" # make a team, become owner
treg org invite teammate@acme.com # invite by email (pick role + tool access)
treg org join <code> --email you@acme.com # accept an invite (creates you if new)
treg org ls | use <slug> | members # switch orgs, see the roster
treg org access <member> --tools a,b # per-member tool access (admin+)
さらに詳しく
-
フィードバック:
treg feedback submit friction "The pagination example is unclear."プライベート情報を含めずに問題や提案を共有してください。フィードバック手順を参照。 -
レビュー:
treg review CALL_ID useful招待されたカタログ呼び出しの結果を使用した後に評価してください。not_sureで問題ありません。プライベートデータは省略し、タスクを続行してください。 -
USAGE.md— 完全なtregCLIリファレンス。 -
/llms.txt— エージェントオンボーディングファイル:呼び出しプロトコル、ディスカバリー、認証、CLI、スキル。1回のフェッチでエージェントにレジストリ全体を教えられます。 -
ダッシュボード treg.to — 完全なCRUD、ガイド付きチュートリアル(ヘルプ→チュートリアル)、エージェント向けのコピー可能なセットアップ手順。
-
API — CLIが行うすべてはプレーンHTTPです。インタラクティブなOpenAPIドキュメントは
/docsにあります。プロキシエンドポイントは/call/{...}です。すべてのエンドポイントはX-Treg-Tokenヘッダーを受け付けます。
パート2 · セルフホスティングと開発
ローカルで実行
1つのコマンド(tmux + uvが必要です。venvは自動的に同期されます):
scripts/dev-local.sh up # server on http://localhost:18790, dev-safe settings
これにより、ホットリロード付きのtmuxでサーバーが実行され、独自のsqlite DB(treg-dev.db)、メールOTP開発モード(サインインコードがページに表示されます — メール送信者は不要)が使用されます。日常的な操作:
scripts/dev-local.sh cli login # sandboxed CLI: never touches your real ~/.treg/config.json
scripts/dev-local.sh logs # server output · status / restart / down
scripts/dev-local.sh reset # wipe the dev DB + CLI sandbox for a fresh start
またはtmuxなしでサーバーを直接実行:
bash scripts/build-dashboard.sh # Node 22.12+ and npm; build the Dashboard
uv sync # create the venv from uv.lock (pulls the server deps for dev)
uv run python -m treg upgrade # prepare schema + run idempotent release tasks without serving
uv run python -m treg # serve on 0.0.0.0:18790 (add --reload for dev)
uv run python -m treg keygen # print a fresh Fernet key for TREG_SECRET_KEY
サーバーを(ソースからではなく)実行するためのインストール: 基本パッケージはCLIのみです。レジストリを実行するには、サーバー用のエクストラ —
pip install "tools-registry[server]"— をインストールしてください。これにはFastAPI、データベースドライバ、暗号化が含まれます。pip install tools-registry単体では、既存のレジストリと通信するためのtregコマンドのみが提供されます。
公式ホスティングサービスは treg.to で利用できます。その本番トポロジとライブ設定は、非公開の オペレーターランブック で管理されています。
設定
環境変数(プレフィックス TREG_、.env から読み取り):
| 変数 | デフォルト | 目的 |
|---|---|---|
TREG_DATABASE_URL | sqlite+aiosqlite:///./treg.db | DB URL(開発用はSQLite、本番はPostgres) |
TREG_READ_DATABASE_URL | (空) | オプションのSQLite / PostgreSQL読み取りデータソース。空の場合はプライマリを再利用。呼び出し側のオプトインが必要。既存のクエリは変更されません。読み取りデータソースのセットアップ を参照。 |
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 Pages、Meta Ads、およびオプションの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_ADMIN_TOKEN | (空) | クロステナントのスーパー管理者ベアラー。すべての /admin/* エンドポイントを承認します。空の場合はenvパスを無効にします(is_superadmin ユーザーのみが /admin に到達できます)。長くて秘密にしてください。 |
TREG_EMAIL_DEV_MODE | false | trueの場合、/auth/email/start は応答でOTPを返します(メール送信者は不要)— 開発/ローカルのみ、本番では絶対に使用しないでください。 |
TREG_KV_URL | (空) | すべてのワーカーが同意する必要があるカウンタ用の共有キーバリューストア(Redisプロトコル)。現在はチームごとのレビュー招待予算。空 = インプロセスフォールバック、単一ワーカーで問題ありません |
ローカル開発に .env は不要です — すべての設定には動作するデフォルトがあります(一時キー、sqlite)。
⚠️ 移動または再デプロイする前にこれらをバックアップしてください: Fernetキー(
TREG_SECRET_KEY)と データベース(本番はPostgres、ローカルのsqlite実行はtreg.db)。Fernetキーを失うと、保存された すべての秘密情報が復元不可能になります。
アーキテクチャ
/call のリクエストフロー: ツールを解決(URLホスト + 最長の base_url プレフィックス、または名前で)→
その秘密情報を復号化 → 各バインディングのインジェクタを適用 → アップストリームにストリーミング → ファイアアンドフォーゲット
監査レコード。インフラリレーはビジネスロジックなしでバイトをストリーミングします。コールアプリケーションは
決済または所有権の証拠が必要な応答を最大8 MiBバッファリングします。それより大きい応答は、切り詰められた成功ではなく、
課金なしで502を返します。ボディの証拠を必要としない承認済みの無料最終ダウンロードは、完全にストリーミングされます。
同様に、独自キーおよび独自ツールの応答も同様です。
モジュールマップ (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 # daily local default (same shape as CI)
uv run --frozen python -m pytest -q # serial: debugging one test, or order
カバレッジ: プロキシのウォーキングスケルトン、すべてのインジェクタシェイプ、ユーザーごとの認証 + CRUD + 監査、スキルコンポーザー、
URLパススルー + 忠実なリレー、OAuthリフレッシュ + 接続フロー、ヘルスチェック、treg run/シェル、
アップロード/スキャン、組織 + 招待、ダッシュボードAPI、CLI。
コントリビューションとドキュメント
treg/
├── src/treg/ # the package (api, cli, proxy, injectors, oauth, health, convert, models, …)
│ └── web/ # dashboard, landing, tutorial, llms.txt, skill.md, install.sh
├── tests/ # pytest suite (CI + local default: pytest-xdist -n auto)
├── docs/
│ ├── context/ # design fragments (codemap system) + generated index
│ └── ONBOARDING.md # first-time bootstrap
├── USAGE.md # full treg CLI reference
└── 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は既存の権限を保持します。
複数のピン、移行、リプレイ動作については、
マルチテナンシー契約 を参照してください。