Dokümantasyon
Aurict'i kurmak, yapılandırmak ve güvenle genişletmek için gereken her şey.
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
/mcpWeb 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/deviceFlutter 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.dartSağ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/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
/termsNode.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 | bashPaket 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 aurictTaşı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 SHA256Tek 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.21 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 aurictHerhangi bir proje dizinine gidin ve başlatın. İlk çalıştırmada bir sağlayıcı seçin, API anahtarınızı girin, modeli belirleyin; ardından Project Auto'nun bu projedeki sınırlı dosya değişikliklerini bu oturum için onaylamasını isteyip istemediğinizi seçin.
cd your-project
aurictDepoyu klonlayın ve Bun ile derleyin. Bun >= 1.1 gerektirir.
git clone https://github.com/aurict/aurict
cd aurict
bun install
bun run buildBir 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ı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
/configAPI 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-...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.
/providers12 sağlayıcı yerleşik olarak gelir. Ollama API anahtarı gerektirmez ve yerel olarak çalışan modellerle çalışır. Yapılandırdığınız sağlayıcılarda güncel modelleri görmek için /providers ve /models kullanın.
anthropic → Anthropic
openai → OpenAI
openrouter → OpenRouter
google → Google
opencode → OpenCode (Zen)
ollama → Ollama
xai → xAI
azure → Azure OpenAI
bedrock → AWS Bedrock
nvidia → NVIDIA NIM
zai → Z.AI (GLM)
alibaba → Alibaba (Qwen)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)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() }
}
}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
}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.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 combinationsAurict, başlangıçta claude_desktop_config.json içindeki uyumlu sunucuları içe aktarabilir. Her bağlantıyı ve sunduğu araçları /mcp ile doğrulayın; sunucu uyumluluğu, kimlik bilgileri ve yerel bağımlılıklar yine geçerlidir.
# macOS
~/Library/Application Support/Claude/claude_desktop_config.json
# Linux
~/.config/Claude/claude_desktop_config.json
# Windows
%APPDATA%\Claude\claude_desktop_config.jsonBağlı tüm MCP sunucularını ve kullanılabilir araçlarını görmek için TUI içinde /mcp kullanın.
/mcpTü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)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 checkpointBağı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 branchesBağ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 usageProject Auto yalnızca etkin proje içindeki sınırlı write, edit ve apply_patch isteklerinde tekrar eden izinleri kaldırır. İzin oturum kapsamındadır ve çalışma dizini değiştiğinde sıfırlanır. Kabuk komutları, secret'lar, .git ve .aurict yolları, proje dışına çıkışlar, tehlikeli işlemler ve geniş silmeler hâlâ doğrudan onay ister.
/auto # Project Auto'yu aç/kapat
/autopilot # takma ad
# Başlangıçta bu proje oturumu için Evet veya Hayır seçinKalıcı tamamlanma kaydını görmek için /proof kullanın: değişen dosyalar, doğrulama kanıtı, açık işler ve açıkça verilmiş muafiyetler. Kanıtı bekleyen veya başarısız olan gerekli işler tamamlanmış sayılmaz.
/proof
/proof json
/proof waive verification test runner unavailable in this environmentHook'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\""
}
]
}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 exitAurict, 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 profilingKoordinatö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ı .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"
}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 tasksGeç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 cachingDurum 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 breakdownGit 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