Dokümantasyon

Başlangıç

Aurict'i kurmak, yapılandırmak ve genişletmek için gereken her şey.

Ürünler ve platformlar

┌

Terminal ajanı

CLI, geliştiricilerin zaten çalıştığı yerde çalışan birincil Aurict çalışma zamanıdır: BYOK sağlayıcıları, proje bağlamı, tipli araçlar, kontrol noktaları, oturumlar, beceriler, MCP, kancalar, yerel API erişimi ve çoklu ajan iş akışları.

aurict
/config
/providers
/sessions
/agent
/mcp

┌

Web platformu

Web uygulaması, herkese açık tanıtım ve başlangıç noktasıdır. Açılış sayfası, belgeler, yol haritası, değişiklik günlüğü, manifesto, Firebase destekli kimlik doğrulama, tarayıcı giriş akışı, gizlilik politikası, kullanım koşulları ve hesap silme yönergesini içerir.

apps/web
/routes: /docs /roadmap /changelog /about /privacy /terms /auth/device

┌

Mobil BYOK asistanı

Flutter uygulaması, Aurict'i terminalin ötesine taşır: BYOK sohbeti, sağlayıcı oturumları, araştırma ve belge iş akışları, PDF oluşturma, kapsamı belirlenmiş asistan yanıtı raporlama ve Android sürüm sürecini sağlamlaştırma.

mobile/lib/main.dart
mobile/lib/agent/mobile_chat_stream.dart
mobile/lib/agent/mobile_feedback_report.dart

Güvenlik ve Gizlilik

┌

Gizli sınırlar

Sağlayıcı anahtarları, Firebase servis dosyaları, Android keystore'ları, key.properties dosyası, yerel env dosyaları, SQLite çalışma zamanı verileri ve backend prototip dosyaları kaynak kontrolünün dışında tutulur. CI, Android paketleri üretirken yayın gizli bilgilerini GitHub Actions secrets'tan geri yükler.

.env
.env.local
google-services.json
*.jks
*.keystore
key.properties
apps/backend/

┌

Hesap ve geri bildirim akışları

Web ve mobil uygulamalar gizlilik, koşullar, hesap silme ve geri bildirim raporlama yollarını içerir. Bildirilen asistan yanıtları, kullanıcının projesinin toplu bir yüklenmesi olarak değil, inceleme için kapsamı belirlenmiş geri bildirim olayları olarak ele alınır.

POST /feedback/reports
POST /account/delete
/privacy
/terms

Kurulum

┌

macOS ve Linux

Node.js veya Bun kurmadan eşleşen kendi kendine yeten yayın ikili dosyasını indirin. Yükleyici, ~/.local/bin dizinine kurmadan önce yayının SHA-256 sağlama toplamını doğrular.

curl -fsSL https://aurict.com/install.sh | bash

┌

npm

Paket yöneticisi güncellemelerini tercih ediyorsanız veya Windows kullanıyorsanız npm'i kullanın. Doğru platform ikili dosyası (macOS arm64/x64, Linux x64/arm64, Windows x64) otomatik olarak seçilir.

npm install -g aurict

┌

Doğrudan yayın ikili dosyası

Taşınabilir bir ikili dosya, çevrimdışı dostu dağıtım veya tamamen manuel bir kurulum gerektiğinde bir GitHub Release kullanın. İşletim sisteminiz ve CPU mimariniz için varlığı indirin, ardından çalıştırmadan önce SHA-256 hash'ini checksums.txt içindeki ilgili girdiyle karşılaştırın.

# Linux x64
curl -LO https://github.com/aurict/aurict/releases/latest/download/aurict-linux-x64
curl -LO https://github.com/aurict/aurict/releases/latest/download/checksums.txt
sha256sum -c checksums.txt --ignore-missing
chmod +x aurict-linux-x64
./aurict-linux-x64

# Windows PowerShell
Invoke-WebRequest https://github.com/aurict/aurict/releases/latest/download/aurict-win32-x64.exe -OutFile aurict.exe
Invoke-WebRequest https://github.com/aurict/aurict/releases/latest/download/checksums.txt -OutFile checksums.txt
Get-FileHash .\aurict.exe -Algorithm SHA256

┌

Sürümlemeli, özel dizinli ve kaldırma seçenekleri

Tek satırlık yükleyici, ortam değişkenleri aracılığıyla bir yayın sürümü ve kurulum dizini kabul eder. Yalnızca Aurict ikili dosyasını kurar; bu ikili dosyayı kaldırmak bu kurulum yöntemini kaldırır. npm kullanıcıları npm ile kaldırabilir.

# Install a specific version into a custom user directory
AURICT_INSTALL_VERSION=1.2.0 AURICT_INSTALL_DIR=~/.local/bin curl -fsSL https://aurict.com/install.sh | bash

# Remove the curl-installer binary
rm ~/.local/bin/aurict

# Remove the npm package
npm uninstall -g aurict

┌

İlk çalıştırma

Herhangi bir proje dizinine gidin ve başlatın. İlk başlatmada bir kurulum sihirbazı çalışır — bir sağlayıcı seçin, API anahtarınızı girin ve bir model seçin. Yaklaşık 30 saniye sürer.

cd your-project
aurict

┌

Kaynaktan derleme

Depoyu klonlayın ve Bun ile derleyin. Bun >= 1.1 gerektirir.

git clone https://github.com/aurict/aurict
cd aurict
bun install
bun run build

Yapılandırma

┌

Proje yapılandırması — .aurict/config.json

Bir yapılandırma dosyasını proje kök dizinine veya genel varsayılanlar için ~/.aurict/ içine yerleştirin. Proje yapılandırması genel yapılandırmayı, CLI bayrakları ise her ikisini de geçersiz kılar.

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-6",
  "maxTokens": 8192,
  "stream": true
}

┌

API anahtarları /config ile

API anahtarlarını terminal arayüzünün içinden ayarlayın. Anahtarlar şifrelenir ve ~/.aurict/config.json dosyasına kaydedilerek oturumlar boyunca korunur.

# Inside the Aurict terminal:
/config set anthropic sk-ant-...
/config set openai sk-...
/config set google AIza...

# Show current config
/config

┌

Ortam değişkenleri

API anahtarları ortam değişkenleri aracılığıyla da ayarlanabilir. Bunlar, yapılandırma dosyası anahtarlarının öncelindedir.

ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GOOGLE_GENERATIVE_AI_API_KEY=AIza...
OPENROUTER_API_KEY=sk-or-...
XAI_API_KEY=xai-...

Sağlayıcılar ve Modeller

┌

Sağlayıcı değiştirme

Tüm mevcut sağlayıcıları ve anahtar durumlarını görmek için TUI içinde /providers kullanın, ardından aralarında geçiş yapın. Geçişten sonra otomatik olarak bir model seçici açılır.

/providers

┌

Desteklenen sağlayıcılar

9 sağlayıcı yerleşik olarak gelir. Ollama API anahtarı gerektirmez ve yerel olarak çalışan herhangi bir modelle (llama3, mistral, deepseek-r1 vb.) çalışır.

anthropic   → Claude 4 Opus, Sonnet, Haiku
openai      → GPT-4o, o1, o3, o4-mini
google      → Gemini 1.5 Pro/Flash, 2.0
openrouter  → 200+ models via one key
xai         → Grok 2, Grok 3
azure       → Azure OpenAI deployments
bedrock     → Claude via AWS
ollama      → Local models (no key needed)
opencode    → OpenCode / Zenmux

┌

Düşünme / muhakeme modu

Genişletilmiş düşünmeyi destekleyen modeller (claude-opus-4, o3, deepseek-r1), model seçiminden sonra bir muhakeme bütçesi seçici gösterir. İstediğiniz zaman ayarlamak için /models kullanın.

/models
# → select model → select effort (off / low / med / high / max)

Özel Araçlar

┌

Araç oluşturma

Bir .js ESM dosyasını ~/.aurict/tools/ (genel) veya .aurict/tools/ (proje) içine bırakın. Proje araçları aynı id'ye sahip genel araçların öncelindedir. Araçlar başlangıçta yüklenir.

// .aurict/tools/my-tool.js
export default {
  id: "my-tool",
  description: "What this tool does",
  parameters: {
    type: "object",
    properties: {
      input: { type: "string", description: "Input text" }
    },
    required: ["input"]
  },
  async execute({ input }, ctx) {
    return { output: input.toUpperCase() }
  }
}

┌

Araç bağlamı (ctx)

Execute fonksiyonu, geçerli çalışma dizini, oturum kimliği ve bir iptal sinyali içeren bir ctx nesnesi alır.

async execute({ input }, ctx) {
  const { workdir, sessionId, signal } = ctx
  // workdir: current project path
  // signal:  AbortSignal for cancellation
}

Özel Beceriler

┌

Beceri oluşturma

Beceriler, tetikleme koşulları eşleştiğinde sistem istemine enjekte edilen Markdown dosyalarıdır. Bunları ~/.aurict/skills/ veya .aurict/skills/ içine yerleştirin.

<!-- .aurict/skills/conventions.md -->
---
name: conventions
description: Our team coding conventions
---

Always use 2-space indentation.
Prefer functional components over class components.
Never use var — always const or let.
All async functions must handle errors explicitly.

┌

Otomatik enjekte edilen beceriler

Aurict, başlangıçta projenizi tarar ve algılanan çerçevelere, dillere ve yapılandırma dosyalarına göre 218+ yerleşik kütüphanesinden ilgili becerileri otomatik olarak enjekte eder.

# Aurict detects and injects skills for:
next.js, react, vue, svelte, astro
python, fastapi, django, flask
rust, go, java, kotlin
docker, kubernetes, terraform
bun, deno, node
# ...and 200+ more combinations

MCP Entegrasyonu

┌

Mevcut MCP yapılandırmanızı kullanma

Aurict, başlangıçta claude_desktop_config.json dosyanızı otomatik olarak okur. Claude Desktop için yapılandırdığınız herhangi bir MCP sunucusu yeniden yapılandırmaya gerek kalmadan anında çalışır.

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Linux
~/.config/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

┌

Bağlı sunucuları listeleme

Bağlı tüm MCP sunucularını ve kullanılabilir araçlarını görmek için TUI içinde /mcp kullanın.

/mcp

Oturum Yönetimi

┌

Oturumlara göz atma

Tüm oturumlar otomatik olarak kalıcılaştırılır. Bulanık arama içeren etkileşimli bir seçici açmak için /sessions kullanın veya herhangi bir yerden QuickSearch'i açmak için Ctrl+R'a basın.

/sessions        # interactive picker
Ctrl+R           # QuickSearch (fuzzy)

┌

Kontrol noktaları ve geri alma

Aurict, her yapay zeka eyleminden önce bir kontrol noktası oluşturur. N adımı (dosyalar + konuşma) geri almak için /undo, kaydedilen tüm durumları listelemek için /checkpoints kullanın.

/undo            # undo last step
/undo 3          # undo last 3 steps
/checkpoints     # list all checkpoints
/replay <id>     # jump to any checkpoint

┌

Çatallama ve dallanma

Bağımsız bir kopya oluşturmak için geçerli oturumu çatallayın veya mevcut durumunuzu kaybetmeden farklı yaklaşımları keşfetmek için konuşmayı dallandırın.

/fork            # create independent copy
/branch          # branch conversation
/branch list     # list branches

┌

Bağlam sıkıştırma

Bağlam penceresi sınırına yaklaşıldığında Aurict, kritik bağlamı koruyarak eski mesajları sıkıştırabilir. Sıkıştırma stratejisini görüntülemek veya değiştirmek için /compact kullanın.

/compact         # show current strategy
/compact auto    # auto-compact at 80% usage
/compact manual  # prompt before compacting
/ctx             # show context usage

Hook'lar

┌

Hook'lar nedir?

Hook'lar, belirli yaşam döngüsü olaylarında — bir araç çağrısından önce, bir yanıttan sonra veya bir oturum başladığında — otomatik olarak çalışan kabuk komutlarıdır. Hook yapılandırmalarını .aurict/hooks.json içine yerleştirin.

{
  "hooks": [
    {
      "event": "pre-tool",
      "tool":  "bash",
      "run":   "echo \"About to run: $TOOL_ARGS\""
    },
    {
      "event": "post-response",
      "run":   "notify-send \"Aurict finished\""
    }
  ]
}

┌

Mevcut hook olayları

Hook'lar bu olaylarda tetiklenebilir. Ortam değişkenleri, tetikleyici olay hakkında bağlam sağlar.

pre-tool        → before any tool executes ($TOOL_NAME, $TOOL_ARGS)
post-tool       → after tool completes ($TOOL_NAME, $TOOL_RESULT)
pre-response    → before AI generates text
post-response   → after AI response ($RESPONSE_TEXT)
session-start   → on launch ($SESSION_ID, $WORKDIR)
session-end     → on exit

Çoklu Ajan

┌

Uzman ajanlar

Aurict, her biri alana özgü araçlar ve sistem istemleriyle önceden yapılandırılmış 9 yerleşik uzman ajanla gelir. /agent ile geçiş yapın.

/agent           # show agent picker

# Available agents:
omni        → General-purpose (default)
explore     → Codebase exploration & analysis
code        → Implementation & refactoring
review      → Code review & best practices
test        → Test writing & coverage
docs        → Documentation generation
security    → Security audit & hardening
debug       → Root cause analysis
perf        → Performance profiling

┌

Koordinatör modu

Koordinatör modunda Aurict, karmaşık görevleri parçalara ayırır ve alt görevleri paralel çalışan iş parçacıklarındaki uzman ajanlara devreder. /coordinator ile etkinleştirin.

/coordinator     # toggle coordinator mode
/agents          # list custom agents

┌

Özel ajanlar

Özel ajanları .aurict/agents/ içinde JSON dosyaları olarak tanımlayın. Her ajan özel bir sistem istemi, araç kısıtlamaları ve varsayılan bir modele sahip olabilir.

// .aurict/agents/my-agent.json
{
  "id": "my-agent",
  "name": "My Agent",
  "description": "Specialized for X",
  "system": "You are an expert in...",
  "tools": ["bash", "read", "write"],
  "model": "claude-sonnet-4-6"
}

┌

Arka plan görevleri

Sohbet etmeye devam edebilmeniz için uzun süren görevleri arka plana gönderin. Arka plan görevleri ayrı bir işçide çalışır ve tamamlandığında sizi bilgilendirir.

/background      # move current task to background
/background list # list running background tasks

Token ve Maliyet Takibi

┌

Oturum maliyetini görüntüleme

Geçerli oturum için token kullanımının ve tahmini maliyetin tam dökümünü görmek için /cost kullanın. Önbellek okumaları indirimli oranlarıyla gösterilir.

/cost

# Example output:
# Fresh input:   12,430 tokens   $0.037
# Output:         3,210 tokens   $0.048
# Cache reads:   48,200 tokens   $0.014  (10× cheaper)
# Cache writes:   8,400 tokens   $0.031
# ──────────────────────────────────────
# Total:         72,240 tokens   $0.130
# Cache savings: $0.686 saved vs no caching

┌

Bağlam penceresi kullanımı

Durum satırındaki bağlam çubuğu, gerçek zamanlı bağlam penceresi kullanımını gösterir. Yeni girdi + önbellek okumaları + önbellek yazmalarını — tüketilen gerçek bağlamı — sayar.

/ctx             # detailed context breakdown

Worktree'ler

┌

Worktree'lerle paralel geliştirme

Git worktree'lerini oluşturmak ve yönetmek için /worktree kullanın — her worktree kendi Aurict oturumunu alır, böylece stash'lemeden birden fazla dal üzerinde aynı anda çalışabilirsiniz.

/worktree create feature/auth   # new worktree + session
/worktree list                  # show active worktrees
/worktree switch feature/auth   # switch to existing
/worktree remove feature/auth   # clean up