treg

npx add-mcp 'https://treg.to/mcp/v2/'

Treg (Araçlar için OpenRouter)

Modeller yerine ajan araçları için OpenRouter. Bir ajanı tek bir temel URL’ye ve tek bir tokene yönlendirin, işini yapabilsin: birçok sağlayıcıda binlerce uç noktadan oluşan özenle seçilmiş bir katalog — SEO ve geri bağlantılar, sosyal medya ve trendler, kişi ve şirket zenginleştirme, reklamlar, kazıma, görsel ve video oluşturma — çağrı başına, bir sentten başlayan fiyatlarla, sağlayıcıya kaydolmadan. Ayrıca ekibinizin kendi anahtarları, becerileri ve CLI’ları; kimlik bilgisi sunucudan hiç çıkmadan her ekip arkadaşının ajanı tarafından çağrılabilir.

Aracı değil, görevi isteyin. Geri bağlantı verilerini hangi satıcının sattığını bilmeniz veya onlarda hesap açmanız gerekmez. Yapmak istediğiniz şeyi arayın, fiyatı görün, çağırın.

Superdesign ekibi için geliştirildi, treg.to adresinde yayında — herkes kendi sunucusunda barındırabilir.

Neden var?

Bir ajanın gerçek işler için ihtiyaç duyduğu araçlar, kimsenin tek bir çalıştırma için satın almayacağı aboneliklerin arkasında — Semrush $139/ay, Moz $99/ay, Crunchbase $99/ay, Apollo $59/koltuk — kayıt duvarlarının arkasında ya da hiç herkese açık API’si olmayan yerlerde (yalnızca davetle, yalnızca iş ortaklarına, yalnızca uygulama incelemesiyle) bulunur. treg bu hesapları sağlar ve çağrı başına sentin kesirleri kadar ücret alır.

Tek token, iki tür araç

• Katalog — treg’in kendi anahtarıyla veya sağlayıcı anahtarı gerektirmeyen, doğrulanmış herkese açık bir rota üzerinden sunabildiği harici uç noktalar. Kendi anahtarınızı kullanan çağrılar ekibin ön ödemeli bakiyesinden düşer; anonim çağrılar ücretsizdir. Sağlayıcıda hesap gerekmez. Yeni doğrulanmış hesaplar, uygun bir ekip oluşturduklarında bir defaya mahsus $1.00 ücretsiz alır.
• Kendi araçlarınız — bir ekip arkadaşının kaydettiği her şey: ücretli bir API hesabı, OAuth bağlantısı, bir satıcı CLI’ı, bir SKILL.md. Kendi anahtarınız her zaman treg’inkinden önceliklidir ve bu çağrılar hiçbir zaman ücretlendirilmez.

İkinci bölümün terimleri:

• araç = kayıt defterinin sizin için kuruluşun kimlik bilgisiyle çağırdığı bir şey. İki türü vardır:
  • uç nokta — bir üst akış base_url + kimlik bilgisi bağlamaları (her bağlama isteğe bir gizli bilgi ekler; bir istek birden fazla bilgi taşıyabilir; örneğin hem bir OAuth bearer hem de bir developer-token başlığı).
  • CLI — kimlik bilgisi eklenerek çalıştırılan bir satıcı ikilisi (stripe, gh, vercel, ...).
• beceri / paket = bir tarif (SKILL.md) + gizli bilgileri + araçları; birlikte kaydedilir.

Tek kural: proxy, üst akışı modeller değil, aktarır ve kimlik doğrulamayı sunucu tarafında ekler — böylece üst akış API’si değişikliklerine dayanır ve çağıranlar anahtarları hiçbir zaman elinde tutmaz.

---

Bölüm 1 · Kayıt defterini kullanma

treg.to adresini ziyaret edin (Render’da barındırılır) — kontrol paneli, oturum açma ve aşağıdaki tüm URL’ler oradadır.

Hızlı başlangıç

Kontrol panelindeki Başlarken kılavuzuyla aynı akış:

# 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 konuşma, herkese açık ses keşfi ve özel ses klonlama özellikleri sunar. Konuşma çıktısı ikili veridir; bu nedenle bir dosyaya yönlendirin. Keşfedilen bir sesin _id değeri veya ekip ses kimliği, TTS reference_id değeridir; treg’in Fish hesabında oluşturulan sesler kalıcı ekip kaynaklarıdır:

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

Kendi Fish anahtarınızla istekler sınırsız ve ücretlendirilmeyen bir üst akış aktarımı olarak kalır; hesap sınırını Fish belirler.

Katalog araçlarının girdileri treg catalog get <id> ile açıklanır. strict_query olarak işaretlenen araçlar, bildirilmemiş veya yinelenen sorgu parametrelerini, desteklenmeyen değerleri ve istek gövdelerini reddeder. Bildirilen tek değerli her parametreyi bir kez gönderin; satır sayısı gibi bir değeri, örneğin limit, belirtilen üst sınır içinde tam sayı olarak verin: bunu uygulayan bir araç, parametreyi belirten 400 catalog_parameter_invalid yanıtı verir ve hiçbir ücret alınmaz.

Token’ınız her çağrıda sizi tanımlar (X-Treg-Token başlığı) ve tüm araçlarda aynıdır. Ekibinizin paylaştıklarını keşfedin: treg tool ls · kimlik bilgisi durumunu kontrol edin: treg health.

Veya Claude Code eklentisi olarak yükleyin

/plugin marketplace add superdesigndev/treg
/plugin install treg@treg

treg becerisini ve treg araçlarını tokensız ve yapılandırmasız yükler. /mcp komutunu çalıştırın, treg’i seçip oturum açın; araçlar ardından görünür. Diğer ajanlar: npx skills add superdesigndev/treg -s treg (geri kalanı için İş akışı becerileri bölümüne bakın). docs/CLAUDE-PLUGIN.md dosyasına bakın. MiniMax Code / MiniMax Agent kullanıcıları: aynı beceri MiniMax Plugin Marketplace üzerinden de sunulur (docs/MINIMAX-PLUGIN.md).

İş akışı becerileri

Ajanınızın baştan sona çalıştırdığı, her çağrısı treg üzerinden geçen hazır tarifler:

Beceri	Ajanınızın yapabilecekleri
treg	Katalogdaki herhangi bir aracı ve kendi araçlarınızı bulup çağırın
web-access	Ajanınızın kendi web araçları yetersiz kaldığında, yerel kazıyıcılar olmadan canlı web’i okuyun: önce ücretsiz arama ve sayfa okumaları, ardından sosyal medya, mağazalar, yorumlar, haritalar ve makaleler için doğru platform işi; bir sağlayıcı başarısız olduğunda treg sıradaki sağlayıcıya geçer
lead-signals	Herkese açık sinyallerden (şikâyetler, iş değişiklikleri, işe alımlar, finansman, araç kullanımı) satın alma niyeti olan alıcıları bulun ve onlar için bir konuyu, rakibi veya hesap listesini izleyin (treg.to/leads-signals)
recruit	Bir LinkedIn iş ilanını sıralanmış bir kısa listeye dönüştürün: ilandaki ölçütler, kişi araması, gerekçeleriyle filtreler, her adayın neden uygun olduğuna dair tek satır, aday başına harcama sınırı içinde kaynak gösterilmiş kanıtlar (gönderiler, GitHub, konuşmalar, kıdem, iş değişikliği), ardından doğrulanmış kişisel e-posta ve telefon; her aday için sayıları, kanıtları ve satıcı izini içeren bir çalıştırma dosyası
make-ugc	Yapay zekâ UGC videoları oluşturun: trend olan açılışlar, sunucu, konuşan kafa klipleri, altyazılar (treg.to/ugc)
jev-memory	Claude Code’a bellek kazandırın: Jev’in her turdan sonra her istemi değerlendirdiği ve kalıcı tercihlerinizi sakladığı bir Claude Code modu; hazır olarak yüklenebilir veya tek bir istemden oluşturulabilir (mod)

install.sh yalnızca treg yükler ve diğerlerini tek satırda adlandırır; ajanınız oturum açtıktan ve ilk çağrıdan sonra bunları sunar. İstediklerinizi sh -s -- --skills lead-signals,recruit (veya --skills all) ile adlandırın; isteğe bağlı olan jev-memory ve rea-growth bu kümeye hiçbir zaman dahil değildir. Claude Code’da her biri treg’in pazar yerinde ayrı bir eklentidir: /plugin install recruit@treg veya bunları /plugin içinden seçin. Bunları mevcut bir ajana eklemek için (skills.sh CLI):

npx skills add superdesigndev/treg                        # every public skill
npx skills add superdesigndev/treg --skill lead-signals   # just one
treg skill bootstrap --skills all                         # the installer's set, with the treg CLI you already have

İş akışı becerileri treg üzerinde çalışır; bu nedenle önce kurulumu yapın (yukarıdaki Hızlı başlangıç bölümünü izleyin veya ajanınızı treg.to/llms.txt adresine yönlendirin).

Claude.ai bağlayıcısı

Claude Connectors Directory arayüzü https://treg.to/mcp/v2/ şeklindedir. Yalnızca özenle seçilmiş katalog uç noktalarını sunar; görsel, video veya ses oluşturma özelliklerini içermez ve Claude’un doğru güvenlik sinyalleri alması için okuma çağrılarını yazma çağrılarından ayırır. Mevcut /mcp/ arayüzü katalog uç noktaları, ekibe ait araçlar ve içe aktarılan beceriler için kullanılmaya devam eder. Sınırlar ve uygulama için MCP ve OAuth mimarisi, sürüm kapıları için gönderim kılavuzu bölümüne bakın.

Anahtarınız olmayan bir aracı çağırın

Katalog, uç noktaların ne yaptığına göre gruplandırılır: anahtar kelime ve sıralama takibi, geri bağlantılar ve otorite, yapay zekâ görünürlüğü, trendler ve keşif, sosyal medyada yayınlama, kişi ve şirket zenginleştirme, reklam yönetimi ve kreatif içerik, ölçüm.

treg catalog                                    # every platform, busiest first
treg catalog search "find a work email"         # by the job, not the vendor
treg catalog search --new                       # tools added in the last 30 days, newest first
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"

Katalogdaki bir çağrı nasıl sunulur — kimlik bilgisi sıralaması:

1. ekibiniz o sağlayıcı için kendi aracını kaydettiyse → o araç ve o anahtar;
2. ekibiniz sağlayıcı için bir gizli bilgi kaydettiyse → sanal araç üzerinden eklenir;
3. ikisi de yoksa ve uç noktanın doğrulanmış herkese açık bir rotası varsa → sağlayıcı anahtarı gerekmez, ücretsiz;
4. aksi durumda → treg’in kendi anahtarı, ekibin ön ödemeli bakiyesinden ücretlendirilir.

Anonim fiyat, çağıranın sağlayıcı kimlik bilgisi başlığı göndermediğini varsayar. Aslına sadık aktarım, çağıranın başlıklarını korur; bu nedenle çağıranın sağladığı bir sağlayıcı anahtarı, o anahtarın kredilerini kullanabilir. Kendi kimlik bilginiz her zaman treg’inkinden önceliklidir; dolayısıyla zaten ücretini ödediğiniz bir anahtarı bağlamak, bu çağrıları bakiyeden düşmek yerine ücretsiz hâle getirir. treg’in fiyat yayımlamadığı bir uç nokta reddedilir, ücretsiz sunulmaz — bunun yerine kendi anahtarınızı bağlamanız istenir. Birden fazla sağlayıcı aynı özelliği sunuyorsa treg catalog search bunları fiyatlarıyla yan yana gösterir; seçim size aittir — treg sizin yerinize sessizce sağlayıcı seçmez veya başka bir sağlayıcıya geçmez. (Bir sağlayıcı için treg’in kendi hesabı tükenirse, aynı uç noktayı treg’e ait bir aktarma hesabı üzerinden sunabilir; bu durum yanıtta açıklanır ve ekip bu seçeneği devre dışı bırakabilir.) İsteğe bağlı olarak kullanabileceğiniz istisna: treg’in sizin yerinize sağlayıcı seçtiği ve adını belirttiği treg.<capability> yönlendirilmiş uç noktaları. Yaygın işler için (sayfa kazıma, web araması, Google sonuçları, e-posta bulma), adını hatırladığınız bir sağlayıcı yerine treg.web.extract veya treg.web.search gibi yönlendirilmiş uç noktalarla başlayın. treg.people.email.find ve treg.people.phone.find üzerinde X-Treg-Route-Verify: true, bulunan adresi veya numarayı da aynı çağrıda, ayrı bir ücret karşılığında kontrol eder ve kontrol sonucunu bildirir.

treg balance          # credit left, calls in flight, recent spend
treg topup            # add funds, or set up automatic top-ups

Bakiye yetersiz olduğunda, balance_micro, estimated_cost_micro ve bir topup_url içeren HTTP 402 error: insufficient_balance yanıtı döner; böylece ajan, açıklama metnini okumadan bu duruma göre işlem yapabilir.

Enrich Arena, kontrol panelinin dışında, /enrich-arena adresinde bulunur. Zenginleştirme yanıtlarını her satıcının maliyeti ve hızıyla karşılaştırın, tek tıklamayla en iyi yanıtı oylayın veya sıralı bir şelaleyi izleyin. Özellik bakımından uyumlu eşzamansız sağlayıcılar da katılır; Arena gönderim ve yoklama işlemlerini kendi içinde yönetir. Göz atmak herkese açıktır; gönderim için oturum açmak gerekir ve ücretlendirilen denemeler ekibinizin kredilerini kullanır. Arena kılavuzuna bakın.

Web Arena, Web Search, Web Fetch ve Sitemap sağlayıcılarını /web-arena adresinde karşılaştırır. Battle, aynı girdi için seçilen sağlayıcıları çağırır; Waterfall ise bunları sırayla dener. Canlı liderlik tablosu, doğrudan sağlayıcı çağrılarının isabet oranlarını ve yanıt sürelerini, son 30 günlük dönemde kontrol edilmiş Web Arena kalite sonuçlarıyla birleştirir. Özellik etkinleştirildiğinde sayfalar açılır. Web Arena kılavuzuna bakın.

Kendi araçlarınızı paylaşın ve kullanın

En az uğraştıran yol — treg’i bir projeye yönlendirin, paylaşılabilecekleri kendisi bulsun:

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 dizinini (~80 bilinen sağlayıcıyla anahtarları eşleştirerek), her beceri alt dizinini ve yüklü katalog CLI’larını tarar. Kayıt defterine üç tür öğe eklenebilir — her birini nasıl paylaşacağınız ve kullanacağınız aşağıda açıklanmıştır:

1. Uç noktalar (HTTP API’leri)

Paylaşma — kayıtlı bir anahtarla çağrılabilen tek bir üst akış URL’si veya bir .env dosyasından toplu olarak:

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

Kullanma — ajana özgü yöntem: gerçek üst akış isteğini oluşturun ve başına proxy’yi ekleyin. treg aracı ana makineye göre bulur, kimlik bilgisini ekler ve geri kalan her şeyi aslına sadık biçimde aktarır (X-Treg-Token değeriniz üst akışa ulaşmadan çıkarılır):

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>

Veya CLI kısayolunu kullanın — denetim günlüğü için treg calls:

treg call intercom conversations --query per_page=5
treg call stripe v1/balance

2. CLI’lar

Paylaşma — otomatik: treg upload, yüklü katalog CLI’larını (stripe, gh, vercel, …) algılar ve kaydeder; yalnızca tarif içeren bir katalog CLI becerisi (ör. stripe-cli) da otomatik olarak çalıştırılabilir hâle gelir.

Kullanma — treg run, satıcı CLI’ını kuruluşun kimlik bilgisi eklenmiş olarak çalıştırır; böylece anahtarı elinizde tutmanız veya oturum açmanız gerekmez:

treg run stripe -- get /v1/balance
treg run gh -- pr list

--local (varsayılan) kendi makinenizde çalışır. Sunucu tarafında CLI çalıştırma (--server) genel olarak devre dışıdır. treg runs denetim günlüğüdür.

3. Beceriler

Paylaşma — beceri, bütün bir özelliktir (SKILL.md tarifi + gizli bilgileri + araçları); ekibin tamamının aynı beceriyi kullanabilmesi ve tek bir yerden yönetilmesi için birlikte kaydedilir:

treg upload skills --dir ~/.claude/skills --all   # register a folder of skills in one pass

Kullanma — paylaşılan herhangi bir beceriyi ajanınıza alın; API çağrıları token’ınızla treg üzerinden geçer, böylece anahtar beceride değil, sunucuda kalır:

treg skill install seo-blog-writer      # writes into ./.claude/skills/  (--all for the library)

Elle kayıt — sezgisel yöntemler bir aracı tanımlayamadığında

# 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

Her komutun tüm seçenekleri: USAGE.md. CLI ve yükleyicisi, treg.to kullanılırken (argüman veya kimlik bilgisi olmadan) anonim kullanım verilerini PostHog'a gönderir. TREG_TELEMETRY=0 veya DO_NOT_TRACK=1 ile devre dışı bırakın. Analiz ayrıntılarına bakın.

Ekipler

Bir hesap en fazla 10 ekibe sahip olabilir. Diğer ekiplere üye olarak katılmak bu sınıra dahil değildir.

Her şey bir org kapsamında tanımlanır: bir token = bir (user, org) üyeliği ve her gizli bilgi, araç ve beceri etkin org'a aittir. Roller: owner / admin / member / viewer.

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>                          # accept an invite (sign in as the invited email first)
treg org ls | use <slug> | members            # switch orgs, see the roster
treg org access <member> --tools a,b          # per-member tool access (admin+)

Ekip sahipleri, kontrol panelindeki Team → SSO sekmesinden kurumsal SSO'yu etkinleştirebilir. WorkOS, şirketin kimlik sağlayıcısını bağlar; sahipler kurulumu tamamlaması için BT yöneticilerini davet edebilir. Çalışanlar herhangi bir oturum açma iletişim kutusuna iş e-posta adreslerini girebilir veya ekibin doğrudan oturum açma bağlantısını kullanabilir. treg, ekip rollerini ve API anahtarlarını korur. Directory Sync planı, devre dışı bırakılan bir çalışanın ekibe erişimini kaldırır. Kurumsal SSO kurulumuna bakın.

Daha fazlasını keşfedin

• Geri bildirim: treg feedback submit friction "The pagination example is unclear." Özel bilgi paylaşmadan sorunları veya önerileri iletin. Geri bildirim yönergelerine bakın.

• İnceleme: treg review CALL_ID useful Davet edilen bir katalog çağrısını, sonucunu kullandıktan sonra puanlayın; not_sure uygundur. Özel verileri eklemeyin ve göreve devam edin.

• USAGE.md — eksiksiz treg CLI başvurusu.

• /llms.txt: llms.txt biçimindeki aracı giriş noktası: treg'in ne olduğu, her aracı türü için kurulum, arama-okuma-çağırma döngüsü ve kurallar; diğer her şey için işletim kılavuzu olan /skill.md bağlantıları.

• treg.to adresindeki kontrol paneli — eksiksiz CRUD, adım adım öğretici (Help → Tutorial) ve aracılarınız için kopyalanabilir kurulum yönergeleri.

• API — CLI'nin yaptığı her şey düz HTTP'dir; etkileşimli OpenAPI belgeleri /docs adresindedir. Proxy uç noktası /call/{...}; tüm uç noktalar X-Treg-Token başlığını alır.

---

Bölüm 2 · Kendi sunucunuzda barındırma ve geliştirme

Yerel olarak çalıştırma

Tek komut ( tmux + uv gerekir; sanal ortamı kendisi eşitler):

scripts/dev-local.sh up        # server on http://localhost:18790, dev-safe settings

Bu komut sunucuyu tmux içinde, otomatik yeniden yüklemeyle, kendine ait sqlite DB'siyle (treg-dev.db) ve e-posta OTP geliştirme moduyla çalıştırır (oturum açma kodları sayfada gösterilir — e-posta göndericisi gerekmez). Günlük kullanım:

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

Ya da sunucuyu tmux olmadan doğrudan çalıştırın:

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

Sunucu çalıştırmak için kurulum (kaynak koddan değil): temel paket yalnızca CLI'dır. Bir kayıt defteri çalıştırmak için sunucu eklentisini — pip install "tools-registry[server]" — yükleyin; bu eklenti FastAPI'yi, veritabanı sürücülerini ve şifrelemeyi ekler. Yalnızca pip install tools-registry, mevcut bir kayıt defteriyle iletişim kurmak için gereken treg komutunu sağlar.

Resmî barındırılan hizmet treg.to adresinde kullanılabilir. Üretim topolojisi ve canlı ayarları, özel operatör kılavuzunda tutulur.

Yapılandırma

Ortam değişkenleri (TREG_ önekiyle, .env dosyasından okunur):

Değişken	Varsayılan	Amaç
TREG_DATABASE_URL	sqlite+aiosqlite:///./treg.db	DB URL'si (geliştirme için SQLite, üretimde Postgres)
TREG_READ_DATABASE_URL	(boş)	İsteğe bağlı SQLite / PostgreSQL okuma veri kaynağı; boşsa birincil kaynak yeniden kullanılır. Çağıranların açıkça etkinleştirmesi gerekir; mevcut sorgular değişmez. Okuma veri kaynağı kurulumuna bakın.
TREG_SECRET_KEY	(boş)	Bekleyen gizli bilgiler için Fernet anahtarı; boşsa geçici bir anahtar oluşturulur (gizli bilgiler yeniden başlatma sonrasında korunmaz)
TREG_PUBLIC_URL	https://treg.to	OAuth geri çağırma URI'sini oluşturmak için kullanılan treg'in herkese açık temel adresi
TREG_SESSION_SECRET	(boş)	kontrol paneli oturum çerezini imzalar; TREG_SECRET_KEY değerine geri döner. Üretimde gerçek bir değer ayarlayın
TREG_GITHUB_CLIENT_ID / _SECRET	(boş)	GitHub OAuth ile oturum açma (geri çağırma <public_url>/auth/github/callback); boşsa düğme gizlenir
TREG_GOOGLE_CLIENT_ID / _SECRET	(boş)	Google OAuth ile oturum açma (yönlendirme <public_url>/auth/google/callback); boşsa düğme gizlenir
TREG_WORKOS_API_KEY / _CLIENT_ID / _WEBHOOK_SECRET	(boş)	WorkOS kurumsal SSO; geri çağırmayı ve imzalı dizin webhook'unu kurumsal SSO kurulumunda açıklandığı şekilde yapılandırın
TREG_ENTERPRISE_SSO_BUNDLE_ONLY	true	Varsayılan olarak yalnızca SSO + Directory Sync planını gösterir; her iki aylık planı da sunmak için false olarak ayarlayın.
TREG_ENTERPRISE_SSO_BUNDLE_PRICE_ID / TREG_ENTERPRISE_SSO_ONLY_PRICE_ID	(boş)	TREG_STRIPE_SECRET_KEY ile aynı hesaptaki yeniden kullanılabilir aylık Stripe Price ID'leri; ayarlanmamış veya kullanılamayan bir Price, ilgili planı gizler. Görüntülenen tutarı ve Checkout ücretini Stripe Price belirler.
TREG_ENTERPRISE_SSO_BUNDLE_MIN_PRICE_USD / TREG_ENTERPRISE_SSO_ONLY_MIN_PRICE_USD	0	Her aylık Stripe Price için isteğe bağlı tam dolar cinsinden minimum tutar; daha düşük fiyatlar gizlenir ve Checkout'ta reddedilir.
TREG_INSTAGRAM_CLIENT_ID / _SECRET	(boş)	Doğrudan Instagram Login için Instagram App ID ve gizli anahtarı (yönlendirme <public_url>/oauth/callback)
TREG_META_CLIENT_ID / _SECRET	(boş)	Facebook Pages, Meta Ads ve isteğe bağlı Instagram page-tools için Meta uygulama kimlik bilgileri
TREG_OAUTH_REVIEW_PENDING	instagram-login,page-messages	Yetenekleri kısıtlı kalması gereken, virgülle ayrılmış kayıt defteri inceleme anahtarları; barındırılan inceleme durumu özel olarak tutulur.
TREG_RESEND_API_KEY / TREG_EMAIL_FROM	(boş)	Resend üzerinden işlemsel e-posta (OTP kodları + davetler); From, Resend'de doğrulanmış bir gönderici olmalıdır
TREG_BLOCKED_EMAIL_DOMAINS	(boş)	Her kayıt/oturum açma noktasında ve ekip oluştururken reddedilen, virgülle ayrılmış e-posta alan adları (alt alan adları dahil, büyük/küçük harfe duyarsız). Boşsa hiçbir şey engellenmez — kodda herhangi bir liste bulunmaz
TREG_CLIENT_IP_HEADER	(boş)	Her IP başına sınır için istemci adresi olarak kullanılan ve yalnızca uç noktanızın ayarlayabileceği bir başlık (cf-connecting-ip Cloudflare arkasında)
TREG_TRUSTED_PROXY_HOPS	1	Bu başlık yoksa: SAĞDAN bu kadar atlama uzaklıktaki X-Forwarded-For girdisi (en yakın proxy'nizin eklediği); istemciler doğrudan bağlandığında 0. İlk girdi istemci tarafından yazılır ve asla güvenilir kabul edilmez
TREG_RATE_LIMIT_EXEMPT_IPS	(boş)	Her IP başına sınırdan muaf adresler veya CIDR blokları (yetkili güvenlik testi, izleme yoklaması) — virgülle ayrılır; e-posta, kullanıcı ve dağıtım genelindeki sınırlar yine geçerlidir. Hatalı bir girdi başlangıcı engeller
TREG_REQUIRED_EXTENSIONS	(boş)	Yüklenmesi zorunlu, virgülle ayrılmış politika uzantıları (treg.extensions giriş noktaları); aksi durumda başlangıç başarısız olur. treg.to bu yöntemle özel bir kötüye kullanım politikası uzantısı çalıştırır; bu uzantı yalnızca kısıtlama getirebilir (politika uzantıları)
TREG_TURNSTILE_SITE_KEY / _SECRET	(boş)	Her e-posta oturum açma formunda ve yeni bir adresin ilk GitHub/Google oturum açma işleminde Cloudflare Turnstile; değerlerden biri boşsa kapalıdır. Site anahtarı /captcha.js içinde sunulur, gizli anahtar yalnızca siteverify'a ulaşır
TREG_TURNSTILE_MODE	observe	observe her sonucu kaydeder ve hiçbir şeyi değiştirmez; enforce eksik veya geçersiz bir token için kod göndermez, Cloudflare yanıt veremediğinde kayıt kredisi vermez ve yeni bir GitHub/Google kullanıcısına yalnızca kontrol başarılı olursa kayıt kredisi verir
TREG_TURNSTILE_SOCIAL	true	false, yeni bir adresin ilk GitHub/Google oturum açma işlemindeki kontrolü atlar; bu durumda kullanıcı, widget yokmuş gibi kayıt kredisi alır. E-posta kapısı değişmez
TREG_TURNSTILE_HOSTNAMES	(boş)	Token'ın çözülmesi gereken, virgülle ayrılmış ana bilgisayar adları; boşsa TREG_PUBLIC_URL ana bilgisayarı (ve bilinen takma adları) kullanılır
TREG_ADMIN_TOKEN	(boş)	Kiracılar arası süper yönetici bearer token'ı; tüm /admin/* uç noktalarına yetki verir. Boşsa ortam değişkeni yolu devre dışıdır (yalnızca is_superadmin kullanıcıları /admin erişebilir). Uzun ve gizli tutun.
TREG_EMAIL_DEV_MODE	false	true olduğunda /auth/email/start, OTP'yi yanıtında döndürür (e-posta göndericisi gerekmez) — yalnızca geliştirme/yerel kullanım içindir, üretimde asla kullanmayın.
TREG_KV_URL	(boş)	Her çalışanın aynı fikirde olması gereken sayaçlar için paylaşılan anahtar-değer deposu (Redis protokolü); şu anda ekip başına inceleme daveti bütçesi. Boşsa işlem içi yedek kullanılır; tek çalışan için uygundur

Yerel geliştirme için .env gerekmez — her ayarın çalışan bir varsayılanı vardır (geçici anahtar, sqlite).

⚠️ Taşımadan veya yeniden dağıtımdan önce bunları yedekleyin: Fernet anahtarı (TREG_SECRET_KEY) ve veritabanı (üretimde Postgres; yerel sqlite çalıştırması için treg.db). Fernet anahtarını kaybederseniz saklanan tüm gizli bilgiler kurtarılamaz.

Mimari

/call için istek akışı: aracı çözümle (URL ana bilgisayarına + en uzun base_url önekine göre veya ada göre) → gizli bilgilerini çöz → her bağlamanın enjektörünü uygula → üst akışa aktar → denetim kaydını beklemeden oluştur. Altyapı aktarımı, iş mantığı olmadan baytları akış halinde iletir. Çağrı uygulaması, mutabakat veya sahiplik kanıtı gerektiren yanıtları 8 MiB'ye kadar arabelleğe alır; daha büyük yanıtlar, kesilmiş bir başarı yerine ücretlendirme yapılmadan 502 döndürür. Medyayı satır içine alan uç noktalar (Gemini görselleri) spooled_response bildirir: ölçümlenen yanıt bunun yerine geçici bir dosyaya okunur, bildirilen kullanıma göre mutabakatı yapılır ve tamamı aktarılır. Gövde kanıtı gerektirmeyen, yetkilendirilmiş ücretsiz son indirmeler; kendi anahtarınızı ve kendi aracınızı kullanan yanıtlar gibi eksiksiz olarak akış halinde iletilir.

Modül haritası (src/treg/):

Modül	Rol
proxy.py	relay() — tek bir işlevde tüm ürün: aslına sadık bir akış proxy’si
injectors.py	kimlik doğrulama biçiminin ayrım noktası: env, cli_auth, secret_file, oauth bir gizli değeri başlığa/sorguya yerleştirir
oauth.py	token güncelliği (tek uçuşlu yenileme) + bağlantı akışı (izin URL’si, kod değişimi)
health.py	kimlik bilgisi sağlığı: OAuth’u yenile, araçları sına, bozuk olan her şeyi sahibine webhook ile bildir
convert.py	bir beceri dizinini kaydedilebilir bir paket manifestine dönüştürür
api.py	API — tek beyin; CLI + beceri, onun üzerinde çalışan ince istemcilerdir
cli.py	treg CLI
models.py	SQLModel tabloları: Org, User, Membership, Invite, Secret, Tool, Bundle, PendingOAuth, CallRecord
crypto.py config.py db.py audit.py	Fernet şifrelemesi + token’lar · ayarlar · asenkron DB · ertelenmiş denetim yazıcısı

4 kimlik doğrulama biçimi (bağlama göre injector): env (düz metin / API anahtarı) · secret_file (bir JSON token dosyası, bir alanı alır) · oauth (bir JSON OAuth token’ı, yenilenebiliyorsa otomatik yenilenir) · cli_auth (bir CLI’ın anahtarlığından alınan materyal).

Aslına sadık aktarım sözleşmesi: proxy yalnızca üç şeyi değiştirir; diğer her şey olduğu gibi aktarılır:

1. hop-by-hop aktarım başlıkları (her hop için yeniden türetilir),
2. treg’in kendi denetim + uç yönlendirme başlıkları (x-treg-token, x-treg-org, ngrok-skip-browser-warning, x-forwarded-*, via, …) ve treg’in oturum çerezi — tümü kaldırılır, üst akışa asla sızmaz,
3. enjekte edilen kimlik bilgileri.

OAuth, ilk token’ı edinmenin üç yolu: elle yükleme (bir token.json bırakın) · otomatik yenileme (token’da refresh_token + istemci kimlik bilgileri varsa, treg onu güncel tutar; yeniden yüklemeniz gerekmez) · barındırılan bağlantı akışı (treg oauth connect → tarayıcıda izin → treg token’ı kendisi alır).

Sağlık kontrolleri: bir araca isteğe bağlı bir yoklama ({method, path, expect_status}) verin; düzenli bir çalıştırma (isteğe bağlı veya cron aracılığıyla) her kimlik bilgisini doğrular, OAuth’u yeniler ve bozulanları sahibine webhook ile bildirir.

Ayrıntılı tasarım docs/context/ içinde yer alır (alt sistemlere göre bölümler).

Testler

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

Kapsam: proxy iskeleti, tüm enjektör biçimleri, kullanıcı başına kimlik doğrulama + CRUD + denetim, beceri oluşturucu, URL’yi olduğu gibi aktarma + aslına sadık aktarım, OAuth yenileme + bağlantı akışı, sağlık kontrolleri, treg run/shell, yükleme/tarama, kuruluşlar + davetler, kontrol paneli API’si, CLI.

Katkıda bulunma ve belgeler

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
├── USAGE.md             # full treg CLI reference
└── pyproject.toml

Alt sistem tasarım belgeleri, her biri kendi src/treg/* kaynaklarına atıfta bulunan docs/context/ içindeki bölümlerdir. Bu depoda bir yapay zekâ aracısıyla mı çalışıyorsunuz? /tools-registry-context becerisi, üzerinde çalıştığınız konuya uygun bölümü yükler ve belgeleri eşzamanlı tutar — göndermeden önce /tools-registry-context sync komutunu çalıştırın.

Yol haritası: MCP desteği · daha ayrıntılı izin katmanları · bekleyen verilerde anahtar yönetiminin güçlendirilmesi · olası Loopni birleşmesi.

Lisans

Ek koşullarla Apache 2.0 (LICENSE): ticari kullanım da dahil olmak üzere özgürce kullanın, kendi kuruluşunuz içinde de kullanabilirsiniz (kendi kayıt defterinizi barındırmanız teşvik edilir). Kısıtlama: yazılı izin (jason@superdesign.dev) olmadan kodu, rakip bir barındırılan/yönetilen kayıt defteri hizmeti olarak üçüncü taraflara yeniden dağıtmayın. Kendi ürününüz içinde barındırılan treg.to API’sini kullanmaya — X-Treg-Meta ve usage/by-tag aracılığıyla aktarım faturalandırmasıyla — izin almadan izin verilir; bu, yazılımımızı yeniden dağıtmak değil, API’mizi çağırmaktır.

Sabitlenmiş müşteri okuma kapsamları

Kısıtlı bir müşteri aracısı için treg org agent-new bot --pin customer=cust_A, ilişkilendirmeyi zorunlu kılar ve çağrı/çalıştırma geçmişini, arşivlenmiş sonuçları ve paylaşılan sağlayıcı asenkron sahipliğini bu sabitle sınırlar. Yabancı veya ilişkilendirilmemiş kimlikler 404 döndürür; sabitlenmemiş bir operatör kuruluş genelindeki görünümü ve paylaşılan bakiyeyi korur. BYOK hesap erişimi ve herkese açık medya URL’leri mevcut izinlerini korur. Birden fazla sabitleme, geçiş ve yeniden oynatma davranışı için çok kiracılılık sözleşmesine bakın.