TionHarness
Kendi makinende çalışan, çok-ajanlı (multi-agent) AI runtime'ı ve kontrol düzlemi.
Birden fazla otonom AI ajanını çalıştırmak; onlara görev dağıtmak, akış (flow) içinde
zincirlemek, zamanlanmış işler koşturmak ve hepsini tek bir arayüzden izlemek için
self-hosted bir çalışma ortamı. Tek binary, veritabanı yok (JSON/JSONL dosya
depolama) ve başlamak için API anahtarı gerekmez — claude-cli ya da codex-cli
gibi zaten giriş yapılmış bir abonelik CLI'ı yeterlidir.
Hızlı Başlangıç
Henüz etiketlenmiş bir sürüm (release) yok; kurulum yolu kaynaktan derlemektir.
Derleme gereksinimleri: Go 1.26.4+ ve Node.js 20.19+ (20.x) veya 22.12+; yerel
geliştirmede Node.js 24 kullanılır. Ajan çalıştırmak için giriş yapılmış bir sağlayıcı
CLI'ı, API sağlayıcısı hesabı veya yerel model sunucusu yapılandırılır.
Windows
git clone https://github.com/bilal-arikan/tionharness
cd tionharness
# UI'yı internal/web/dist'e derler, sonra tek exe'ye gömer
.\scripts\build.ps1
$env:TIONHARNESS_ADDR="127.0.0.1:8095"
.\tionharness.exe # http://127.0.0.1:8095
Linux / macOS
git clone https://github.com/bilal-arikan/tionharness
cd tionharness
cd frontend && npm ci && npm run build && cd ..
CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o tionharness ./cmd/tionharness
TIONHARNESS_ADDR=127.0.0.1:8095 ./tionharness
Geliştirme modunda (backend + Vite hot reload, tek komut):
.\scripts\dev.ps1 # yerel ağa açık, tarayıcıyı açar
.\scripts\dev.ps1 -Loopback # yalnız 127.0.0.1, güvenlik duvarı sormaz
scripts/dev.sh # macOS/Linux karşılığı: backend :8090 + Vite :5173
scripts/dev.sh --loopback # yalnız 127.0.0.1
scripts/dev.sh --backend-only # yalnız Go backend (Vite'i ayrıca: npm --prefix frontend run dev)
macOS/Linux'ta build.ps1 + çalıştırma adımının karşılığı scripts/serve.sh --ui'dir:
arayüzü derler, binary'yi bin/tionharness'e kurar ve 0.0.0.0:5173'te başlatır
(--loopback, --port 8090 seçenekleri vardır; varsayılan 5173 Vite'in portuyla
aynıdır, dev.sh ile aynı anda kullanmayın).
Windows'ta tarayıcı yerine kendi penceresinde çalışan sürüm için
.\scripts\build.ps1 -Desktop → tionharness-desktop.exe (WebView2, CGO yok).
Mimari
- Backend: Go, stdlib
net/http üstünde HTTP API + SSE. CGO yok, çapraz derleme tek komut.
- Frontend: Vite + React + TypeScript + Tailwind.
internal/web/dist içine derlenir ve
//go:embed ile binary'ye gömülür — üretimde ayrı bir Vite sunucusu gerekmez, API ve UI
aynı porttan servis edilir.
- Depolama: Veritabanı yok. Her şey dosya sisteminde JSON/JSONL olarak durur; bellek-içi
store diske atomik yazar.
- Veri dizini:
~/.tionharness (TIONHARNESS_DATA_DIR ile değiştirilir). İçinde
uygulama-geneli settings.json ve providers.json, logs/, skills/, market/,
backups/, sağlayıcı CLI login evleri (provider-homes/) ve workspaces/<WS-id>/
altında workspace başına izole store bulunur.
Kod düzeni: cmd/tionharness (giriş noktası), cmd/tionharness-desktop (native pencere),
internal/* (alt sistemler), frontend/ (uygulama arayüzü), website/ (statik tanıtım +
dokümantasyon sitesi, Astro — Go modülünün dışındadır).
Temel Kavramlar
- Ajan (agent) — kalıcı kimliği, prompt'u ve araç erişimi olan otonom AI varlığı. Ajan
başına sağlayıcı örneği, model ve düşünme (thinking) seviyesi seçilir.
- Oturum (session) — bir ajanla yürütülen çok-turlu konuşma; mesaj geçmişi, araç adımları
ve token kullanımı burada tutulur, uzun oturumlarda bağlam otomatik sıkıştırılır.
- Workspace — fiziksel izolasyon birimi: kendi store'u, runtime'ı ve scheduler'ı olan ayrı
bir çalışma alanı. Workspace kapsamlı API uçları
X-Workspace-Id başlığıyla seçilir;
sağlayıcılar ve genel ayarlar uygulama genelindedir.
- Görevler (kanban) — "Görevler" ekranındaki pano; kart başına ajan, öncelik, etiket ve
bağımlılık; facet filtreleri, gruplama ekseni ve workspace başına kayıtlı görünümler.
- Akış (flow) — çok-ajanlı graf: agent / branch / parallel / loop / subflow düğümleri,
yeniden başlatmaya dayanıklı çalışma durumu ve görsel akış builder'ı.
- Zamanlama (schedule) — cron ifadeleriyle workspace başına periyodik çalıştırma.
- Otomasyon (automation) — olay tetikli kurallar (etiketli oturumun bitmesi, kart durumu
değişmesi gibi) bir ajanı veya akışı çalıştırır. Zamanlamalarla birlikte "Otomasyon"
ekranında yönetilir.
- Rota — oturumların zaman ekseninde şerit görünümü: hangi oturum ne zaman çalıştı,
ne kadar sürdü. Yalnız okur; hiçbir şeyi çalıştırmaz. LLM'siz haftalık küratör bitmiş
otomasyon ve zamanlamaları arşivler.
- Skill — ajanın talep üzerine yüklediği yeniden kullanılabilir talimat paketi; bağlamı
şişirmemek için tam metin yalnız gerektiğinde okunur.
- Araçlar & MCP — yerleşik araçlar (dosya oku/yaz/düzenle, glob/grep, shell [opsiyonel],
todo_write, ask_user, artifact, self-management) ve harici MCP sunucuları (SDK'sız
stdio JSON-RPC); araçlar tembel (lazy) yüklenir.
Sağlayıcılar
Üç sağlayıcı türü (provider kind) vardır, hepsi CLI köprüsüdür; her türden birden çok
örnek tanımlanabilir ve ajanlar tek tek örneklere bağlanır:
claude-cli · codex-cli · opencode-cli
claude-cli ve codex-cli anahtarsızdır (makinede giriş yapılmış CLI); opencode-cli
OpenCode üzerinden 75+ sağlayıcıya ulaşır
(OpenRouter, DeepSeek, yerel modeller, OpenAI/Anthropic API anahtarları — hepsi opencode
evinde, opencode auth login). TionHarness'in kendi HTTP LLM istemcisi yoktur. Yeni CLI
örnekleri <dataDir>/provider-homes/<instance-id> altında kendi izole login evini alır.
Karar katmanı (decider) modelleri kendi API anahtarını taşır.
Arayüz
Panel, Sohbet, Ajanlar, Harita, Rota, Görevler, Otomasyon, Akışlar, Artifactlar, Skills,
Araçlar & MCP, Market, Bütçe, Loglar ve İçgörü ekranları. Tema: açık/koyu/sistem +
10 renk paleti (Violet, Blue, Emerald, Rose, Amber, Nord, Cyan, Lime, Orange, Fuchsia) — her biri açık ve koyu varyantıyla,
hepsi canlı uygulanır. Arayüz dili, ajanın yanıt dilinden bağımsız olarak ayarlanır.
Kapsam ve Sınırlar
Bunlar bilinçli tasarım kararlarıdır; kurmadan önce okuyun.
- Barındırılan bir SaaS değil. Hesap, kiracı (tenant) veya faturalandırma yoktur.
Binary'yi siz çalıştırırsınız; kayıtlar yerel diskte tutulur. Yapılandırdığınız
uzak model sağlayıcılarına ve harici araçlara istek içeriği gönderilebilir.
- Kimlik doğrulama varsayılan olarak kapalıdır.
TIONHARNESS_API_AUTH_TOKEN
ayarlanırsa bearer doğrulaması etkinleşir; paketlenmiş arayüz token göndermediği için
bu seçenek normal UI kullanımını da engeller. Loopback veya güvenilir özel ağ
kullanın; ayrıntılar Harici API rehberindedir.
- Sandbox değil. Dosya ve shell araçları tasarım gereği tüm dosya sistemine erişir. Tek
koruma izin modudur (
auto / ask / read-only) — bilinçli seçin.
- Model sağlayıcısı değil. Zaten erişiminiz olan modelleri orkestre eder; kendi CLI
girişinizi veya API anahtarınızı getirmeniz gerekir.
Geliştirme
scripts/test.sh fast # changed Go packages; Vitest if frontend changed
scripts/test.sh full # delivery gate: Go + Vitest + dependency/diff checks
Windows'ta test script'lerini Git Bash içinde, macOS/Linux'ta yerel bash ile çalıştırın
(macOS'un /bin/bash 3.2'si yeterlidir). Script, kabuk testleri için
TIONHARNESS_ENABLE_SHELL=1 ayarlar. UI derlemesi ayrıca cd frontend && npm run build
ile doğrulanır; tanıtım sitesi için website/ içinde npm run check ve npm run build
çalıştırılır. full bu derleme adımlarını içermez.
Frontend Prettier ile formatlanır (frontend/.prettierrc.json): npm run format /
npm run format:check. Pre-commit hook stage'lenmiş dosyaları otomatik formatlar; klon başına
bir kez git config core.hooksPath .githooks. macOS/Linux'ta git yalnız çalıştırılabilir
hook'u koşturur; hook depoda çalıştırılabilir kayıtlıdır, eski bir klonda çalışmıyorsa
chmod +x .githooks/pre-commit.
İlkeler: kod ve yorumlar İngilizce, dokümanlar Türkçe; CGO yok; her sorumluluk ayrı pakette.
Dokümantasyon
Kullanıcı dokümantasyonu https://tionharness.com/docs adresindedir.
Derin tasarım ve plan dokümanları _Docs/ klasöründedir. _Docs iç
dokümantasyondur ve Türkçe yazılır; sürümlenmiş bir kullanıcı kılavuzu değil, projenin
kendi mimari/karar defteridir. Başlangıç noktaları:
Genel Bakış, Mimari,
Depolama ve canlı durum için
İlerleme.
Depoda çalışan ajanlar için kurallar: CLAUDE.md.
Lisans
TionHarness Apache License 2.0 altında lisanslanmıştır. Gömülen ve dağıtılan
üçüncü-taraf bileşenlerin lisansları için bkz.
THIRD-PARTY-NOTICES.md.
