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.

• Site: https://tionharness.com
• Dokümantasyon: https://tionharness.com/docs
• Depo: https://github.com/bilal-arikan/tionharness
• Lisans: Apache-2.0

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.