### Recommended .gitignore for multi-machine Beyin setup Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/MULTI-MACHINE.md Excludes per-machine runtime, version, and installation files (e.g., .beyin-runtime.json, beyin.py, .claude/scripts/, .agents/skills/, .codex/, .kiro/, .opencode/, .omp/) plus local locks and generated views (daily/v3/, knowledge/v3/). After install or update, `git status --short` should be empty. ```gitignore # Beyin kurulumu: her makine Beyin'i kendisi kurar ve günceller .beyin-runtime.json .beyin-version beyin.py Beyni Guncelle.cmd .claude/settings.local.json .claude/scripts/ .claude/hermes-plugin/ .claude/skills/beyin/ .claude/skills/beyin-doktor/ .claude/skills/beyin-guncelle/ .claude/skills/beyin-kontrol/ .agents/hooks.json .agents/skills/beyin/ .agents/skills/beyin-doktor/ .agents/skills/beyin-guncelle/ .agents/skills/beyin-kontrol/ .codex/config.toml .codex/hooks.json .kiro/hooks/beyin-v3.json .kiro/skills/beyin/ .kiro/skills/beyin-doktor/ .kiro/skills/beyin-guncelle/ .kiro/skills/beyin-kontrol/ .opencode/plugins/beyin-v3.js .omp/hooks/pre/beyin-v3.ts # companion-compact süreçler arası kilidi; kalıcıdır ama kullanıcı verisi değildir **/.beyin-compact.lock # Aynı makinedeki not yazarlarının yerel kilidi, istekleri ve tam bayt yedekleri .beyin-note-write/ # Yerel veritabanından üretilen görünümler: her makine kendisininki üretir daily/v3/ knowledge/v3/ ``` -------------------------------- ### Verify installation (Test-Path and ConvertFrom-Json) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP-WINDOWS.md Verifies the installation by checking for the flush script, the number of hooks in settings.json, the .state file, and the hooks.json file. Expected output is True, 4, True, True. ```powershell Test-Path "\.claude\scripts\flush.py" (Get-Content "\.claude\settings.json" -Raw | ConvertFrom-Json).hooks.PSObject.Properties.Name.Count Test-Path "\.claude\scripts\.state" Test-Path "\.agents\hooks.json" ``` -------------------------------- ### Run installer for new package with vault and state Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/MULTI-MACHINE.md Run the installer from the new package to fix a foreign state path. Provide the vault path with --vault and, if you use a custom state on this machine, provide it with --state. This is required for versions before 3.8.1 where 'beyin.py update' fails on such paths. ```bash python3 scripts/install_v3.py --vault "" ``` -------------------------------- ### Resmi installer ile V3 kurulumu veya güncellemesi (3a) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/beyin.md `.beyin-version` yoksa veya V1/V2 varsa, aynı Python yorumlayıcısıyla resmi installer'ı çalıştırın. Önce `--plan` ekleyerek ne yazılacağını ve emekli edileceğini görün; hiçbir şey değiştirmez. Kullanıcı eski bir runner'ı elle değiştirmişse installer `Customized legacy runner requires review ` mesajıyla 1 çıkış kodu döndürür; dosyayı silmeyin veya ezmeyin, kullanıcının açık onayını alıp tek dosya için `--accept-customized-legacy ` kullanın. Toplu geçiş yoktur. ```text /scripts/install_v3.py --vault ``` -------------------------------- ### Check python3 and claude CLI prerequisites Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP.md Verifies that python3 and the claude CLI are installed, counting missing ones. Only 'ONKOSUL SONUC: 0' allows continuation; otherwise the install is degraded. ```bash BEYIN_MISSING=0 if command -v python3 >/dev/null 2>&1; then echo "python3 ✓ $(python3 -V 2>&1)" else echo "🔴 python3 YOK" BEYIN_MISSING=$((BEYIN_MISSING + 1)) fi if command -v claude >/dev/null 2>&1; then echo "claude CLI ✓ $(command -v claude)" else echo "🔴 claude CLI YOK" BEYIN_MISSING=$((BEYIN_MISSING + 1)) fi echo "ONKOSUL SONUC: $BEYIN_MISSING eksik" ``` -------------------------------- ### Platform detection and Homebrew/Obsidian setup Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP.md Detects the platform (Darwin vs Linux) and installs Homebrew and Obsidian on macOS, with fallback messages for Linux. Includes a loop to apply Homebrew shellenv because the installer only prints the lines. ```bash BEYIN_PLATFORM=$(uname -s) echo "platform: $BEYIN_PLATFORM" if [ "$BEYIN_PLATFORM" = "Darwin" ]; then if ! command -v brew >/dev/null 2>&1; then /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # The Homebrew installer only PRINTS the shellenv lines, it never applies them to this shell. # Without this loop the very next `brew` call fails on a fresh Apple Silicon Mac. for BEYIN_BREW in /opt/homebrew/bin/brew /usr/local/bin/brew; do [ -x "$BEYIN_BREW" ] || continue eval "$(\"$BEYIN_BREW\" shellenv)" break done fi if command -v brew >/dev/null 2>&1; then echo "brew ✓ $(command -v brew)" [ -d "/Applications/Obsidian.app" ] || brew install --cask obsidian command -v obsidian >/dev/null 2>&1 \ || (brew tap yakitrak/yakitrak >/dev/null 2>&1 && brew install yakitrak/yakitrak/obsidian-cli >/dev/null 2>&1) \ || echo "obsidian-cli atlandı (opsiyonel)" else echo "🔴 BREW YOK: Homebrew kurulumu tamamlanmadı. Obsidian'ı elle kur: https://obsidian.md/download" fi [ -d "/Applications/Obsidian.app" ] && echo "Obsidian ✓" || echo "🟡 Obsidian bulunamadı, elle kurulmalı" else # Linux / other. No Homebrew, no cask, no .app bundle. NOT verified on a real Linux desktop. echo "macOS değil. Homebrew, Obsidian cask ve macOS masaüstü uygulaması adımları atlanıyor." echo "Obsidian'ı dağıtımının paket yöneticisinden veya https://obsidian.md/download üstünden kur." command -v obsidian >/dev/null 2>&1 && echo "obsidian-cli ✓" || echo "obsidian-cli yok (opsiyonel)" fi ``` -------------------------------- ### Install vault with install.ps1 (pwsh -File) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP-WINDOWS.md Installs the vault scaffold with the given parameters. Exit codes: 0 ok, 1 preflight failed, 2 missing parameter, 3 target exists, 4 unresolved placeholder. Any non-zero exit stops the process and requires reporting the code to the user. ```powershell pwsh -NoProfile -File .\scripts\install.ps1 ` -VaultPath "" -UserName "" -UserBio "" ` -Companion "" -OsName "" -Harness "" ``` -------------------------------- ### Run example workspace homepages script Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/examples/workspace-homepages/README.md Run from the repository root to create fictional examples in a temporary vault. The command writes the check result to the console and to result.json; Markdown files in the output folder are readable snapshots with HTML comments removed. The temporary environment is not exported. ```sh python3 scripts/example_workspace_homepages.py --output /tmp/workspace-homepage-examples ``` -------------------------------- ### Verify vault and print first-run report Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP.md Verifies the vault setup and prints a first-run report. Checks required files, symlinks, JSON validity, and the launcher app. ```bash ls -la "{{VAULT_PATH}}" test -f "{{VAULT_PATH}}/CLAUDE.md" && echo "CLAUDE.md ✓" test -L "{{VAULT_PATH}}/AGENTS.md" && echo "AGENTS.md ortak router ✓" test -L "{{VAULT_PATH}}/.agents/skills" && echo "Codex skill store ✓" python3 -m json.tool "{{VAULT_PATH}}/.codex/hooks.json" >/dev/null && echo "Codex hooks ✓" python3 -m json.tool "{{VAULT_PATH}}/.agents/hooks.json" >/dev/null && echo "Antigravity hooks ✓" test -f "{{VAULT_PATH}}/🔮 850-Companion/Last-Session.md" && echo "hafıza ✓" test -f "{{VAULT_PATH}}/.beyin-version" && echo "sürüm $(cat "{{VAULT_PATH}}/.beyin-version") ✓" test -d "$HOME/Desktop/{{OS_NAME}}.app" && echo "launcher 🧠 ✓" ``` -------------------------------- ### Run install_v3.py without --plan to apply migration Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/UPDATE.md Execute the same command without --plan after a successful plan. The installer verifies package hashes, stops on conflicts with user edits, and creates an update journal/backup. ```sh python3 scripts/install_v3.py --vault "/tam/yol/Beynim" --state "/mevcut/state" ``` -------------------------------- ### Check pwsh.exe is on PATH Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/windows-doctor.md Checks whether pwsh.exe is available on PATH. Prints its source path if found, otherwise 'PATH'TE YOK'. If missing, install via winget install --id Microsoft.PowerShell --source winget or add the existing installation folder to PATH, then restart Claude Code. ```powershell $p = Get-Command pwsh.exe -ErrorAction SilentlyContinue if ($p) { "pwsh.exe: $($p.Source)" } else { "pwsh.exe: PATH'TE YOK" } ``` -------------------------------- ### CUDA kütüphanesi kur: pip install nvidia-cublas-cu12 Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/YAKALA.md whisper-ctranslate2 CUDA kütüphanesi yüklenemezse (ör. cublas64_12.dll yok) ses bir kez CPU ile yeniden yazıya dökülür. Eksik kütüphaneyi kurup klasörünü PATH'e ekleyin. ```bash pip install nvidia-cublas-cu12 ``` -------------------------------- ### Detect machine name and derive OS name Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP.md Runs on macOS or Linux to get the computer name, which is then used to derive the OS name for the setup. ```bash scutil --get ComputerName 2>/dev/null || hostname ``` -------------------------------- ### Run V3 tests and evaluation scripts Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/decision-quality/REVIEW.md Commands to run the V3 test suite, evaluate frozen retrieval and decision changes, build a candidate release, and verify the Jev package installer. The candidate is a local test package, not a published release. ```sh python3 -m unittest discover -s tests -p 'v3_*test.py' python3 scripts/evaluate_v3.py --output frozen.json python3 scripts/evaluate_v3_decisions.py --source /path/to/baseline --output baseline.json python3 scripts/evaluate_v3_decisions.py --output changed.json --check python3 scripts/build_v3_release.py --version 3.1.1 --output candidate/beyin-v3-3.1.1.zip python3 scripts/verify_v3_jev_package.py --package candidate/beyin-v3-3.1.1.zip --baseline baseline/beyin-v3-3.1.0.zip ``` -------------------------------- ### jev.json configuration file Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/JEV.md Example of the jev.json configuration file. The file is written atomically by the command with 0600 permissions. If the file is corrupted, the command returns an error and does not touch the file. ```json {"mode":"shadow","model":"jev-1.13.0","provider":"typesafe","timeout":3,"max_candidates":32,"max_questions":96,"max_input_chars":24000,"cache_ttl":3600} ``` -------------------------------- ### Register learning candidate with beyin.py learn Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/PREFERENCES.md Use to save a learning candidate to the runtime learning-state.jsonl ledger when a permanent note isn't yet created. Requires --session value from the hook; --scope defaults to global if omitted. A candidate saved after this editing window starts satisfies both the knowledge distillation reminder and the plain 'yok' query. ```bash python3 beyin.py learn --session SESSION --candidate "Öğrenim" --source notes/kaynak.md --scope PROJE ``` -------------------------------- ### Otomatik Kurulum Komutları (--install) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/GLOBAL-BRIDGE.md Vault dışındaki proje klasörleri için köprüyü otomatik kurar. Her harness için ayrı komut verilmiştir; Windows'ta `py -3`, diğerlerinde `python3` kullanın. `--project-root` tekrarlanabilir ve alt klasörleri kapsar; state varsayılan olarak `.beyin-runtime.json` dosyasından bulunur, özel kullanımda `--state` ile verilebilir. ```sh # Antigravity için otomatik kurulum (hooks.json ve GEMINI.md işaretçisi): py -3 beyin.py bridge --harness antigravity --project-root "C:\Projelerim" --install # Claude Code için: python3 beyin.py bridge --harness claude --project-root "/tam/yol/Projelerim" --install # Codex için: python3 beyin.py bridge --harness codex --project-root "/tam/yol/Projelerim" --install # OpenCode için (global eklenti dosyası): python3 beyin.py bridge --harness opencode --project-root "/tam/yol/Projelerim" --install ``` -------------------------------- ### V3 Kurulumunu Çalıştır (python3) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP-V3.md Resmi sürüm ZIP dosyasını açtığın paket klasöründen veya kaynak repo kökünden çalıştır. Vault yolunu kullanıcının seçtiği yolla değiştir. Installer yerel yedek alır, ortak motoru ve istemci bağlantılarını vault'a kopyalar; sistem servisi yüklemez. ```bash python3 scripts/install_v3.py --vault "VAULT_YOLU" ``` -------------------------------- ### Rollback to version 3.12.0 Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/releases/3.13.0.md Run this to roll back to 3.12.0. Notes, `.beyin-workspaces.json`, and new state settings are preserved; the old engine ignores them and reads Pi receipts as manual receipts. If you used Pi, remove the `-e` path containing `--beyin-project-root` from your personal Pi settings and aliases before rolling back. If you installed the OpenCode global bridge, run `python3 beyin.py bridge --harness opencode --uninstall` before rolling back. ```sh python3 beyin.py rollback ``` -------------------------------- ### install_v3.py --state --plan ile state dizini taşıma planını incele Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/UPDATE.md Kurucuyu yeni state yoluyla plan modunda çalıştırır. Plan temizse aynı komut --plan olmadan çalıştırılır. Kurucu dizini oluşturduktan sonra yeniden çözümleyip kanonik yolu sabitler. ```powershell py -3 scripts/install_v3.py --vault "C:\Notlar\Beynim" --state "F:\beyin-v3-state" --plan ``` -------------------------------- ### List tracked machine-specific files with git ls-files Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/MULTI-MACHINE.md Use this targeted command to check which machine-specific files are tracked by Git before untracking them. The example list is not exhaustive; compare it with your own setup and preserve user scripts and custom hook entries. ```bash git ls-files -- .beyin-runtime.json .claude/settings.local.json .codex/hooks.json ``` -------------------------------- ### Run install_v3.py with --plan to inspect migration Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/UPDATE.md Inspect the migration plan using the real vault and state paths. Run from the extracted package folder; do not modify .beyin-runtime.json. ```sh python3 scripts/install_v3.py --vault "/tam/yol/Beynim" --state "/mevcut/state" --plan ``` -------------------------------- ### Temel V3 kontrolleri: unittest ve evaluate_v3.py Source: https://github.com/avenoxai/avenoxbeyin/blob/main/CONTRIBUTING.md Repo kökünde çalıştırılır. V3 test keşfi `tests/v3_*test.py` desenini kullanır; Windows'ta gerekirse `python` yerine `py -3` kullanın. Subprocess açan testlerde `tests/v3_package_helpers.inherited_env()` kullanın; aksi halde `BEYIN_V3_SKIP` testleri yanıltıcı biçimde başarılı gösterebilir. ```bash python -m unittest discover -s tests -p "v3_*test.py" python scripts/evaluate_v3.py ``` -------------------------------- ### Run preflight dependency gate (install.ps1 -PreflightOnly) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP-WINDOWS.md Runs the dependency preflight check without writing anything. The first variant uses the default harness; the second is for Antigravity and passes -Harness Antigravity. The report is written to the console in Turkish. ```powershell powershell -NoProfile -Command ". .\scripts\install.ps1 -PreflightOnly; Write-BeyinPreflightReport -Report (Invoke-BeyinPreflight)" ``` ```powershell powershell -NoProfile -Command ". .\scripts\install.ps1 -PreflightOnly; Write-BeyinPreflightReport -Report (Invoke-BeyinPreflight -Harness Antigravity)" ``` -------------------------------- ### Fix Windows MSIX vault stuck with transaction target escapes root (install_v3.py) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/releases/3.6.0.md For Windows MSIX installations stuck with `transaction target escapes root` (#139), close agent sessions, download and extract the V3.6.0 package, then run the installer twice from the agent shell with the current state. The first run completes the interrupted operation, the second installs the new version. ```powershell py -3 scripts/install_v3.py --vault "" --state "<.beyin-runtime.json'daki state>" ``` -------------------------------- ### Kontrolleri yeniden aç (python3 beyin.py preferences --auto-sync on) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/v3.0.2/beyin.md Kullanıcı kontrolleri yeniden açmayı istiyorsa kullanılır. Manuel modda otomatik kontrolleri yeniden etkinleştirir. ```bash python3 beyin.py preferences --auto-sync on ``` -------------------------------- ### Tercihleri oku (python3 beyin.py preferences) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/v3.0.2/beyin.md Mevcut tercihleri okumak için kullanılır. Windows'ta `py -3` kullanın. Bu ayarlar Claude, Codex ve Antigravity için ortaktır ve güncellemede korunur. ```bash python3 beyin.py preferences ``` -------------------------------- ### Scan for existing brain installations Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP.md Scans the two default Obsidian vault locations for existing brain installations. It avoids glob expansion to prevent zsh 'no matches found' errors, and reports candidates with their memory folder and version. The final line 'TARAMA TAMAM' is the success check; if it is not seen, the scan did not finish and mode selection must not proceed. ```bash BEYIN_LIST=$(mktemp) for BEYIN_BASE in "$HOME/Library/Mobile Documents/iCloud~md~obsidian/Documents" "$HOME/Documents"; do [ -d "$BEYIN_BASE" ] || continue find "$BEYIN_BASE" -mindepth 1 -maxdepth 1 -type d -print 2>/dev/null >> "$BEYIN_LIST" done BEYIN_HITS=0 while IFS= read -r BEYIN_D; do [ -f "$BEYIN_D/CLAUDE.md" ] || continue BEYIN_MEM=$(find "$BEYIN_D" -mindepth 1 -maxdepth 1 -type d -name "🔮 850-*" -print 2>/dev/null | head -1) [ -n "$BEYIN_MEM" ] || continue BEYIN_HITS=$((BEYIN_HITS + 1)) echo "ADAY: $BEYIN_D" echo " hafıza klasörü: $(basename "$BEYIN_MEM")" if [ -f "$BEYIN_D/.beyin-version" ]; then echo " sürüm: $(sed -n '1p' "$BEYIN_D/.beyin-version")" else echo " sürüm: v1 (.beyin-version yok)" fi done < "$BEYIN_LIST" rm -f "$BEYIN_LIST" echo "TARAMA TAMAM: $BEYIN_HITS aday bulundu" ``` -------------------------------- ### macOS/Linux: Vault'u taşıma ve state'i yeniden bağlama (--rebind-state) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/MULTI-MACHINE.md macOS ve Linux'ta aynı komut `python3` ile çalıştırılır; vault yolu ve state klasörü Unix biçiminde verilir. `--rebind-state` bayrağı, state indeksini yeni vault yoluna bağlar; bayrak verilmezse kurucu hiçbir dosyayı değiştirmeden durur ve bayrağı önerir. ```text python3 scripts/install_v3.py --vault "/yeni/yol/Beynim" --state "" --rebind-state ``` -------------------------------- ### GET /health Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/INGEST-SERVER.md Checks whether the server is up and running. Returns the service status, version, and inbox readiness. ```APIDOC ## [GET] /health ### Description Checks whether the server is up and running. Returns the service status, version, and inbox readiness. ### Method GET ### Endpoint /health ### Response #### Success Response (200) - **status** (string) - Status of the server - **service** (string) - Service name - **version** (string) - Service version - **inbox** (string) - Inbox readiness status #### Response Example ```json { "status": "ok", "service": "beyin-ingest-server", "version": "1.0.0", "inbox": "ready" } ``` ``` -------------------------------- ### Manuel Windows yakalama komutları (--backend wgc/printwindow/auto/url) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/WINDOWS-CAPTURE-ABI.md PowerShell'de her komutu çalıştırdıktan sonra geri sayım sırasında hedef pencereye geçin. --backend wgc hiçbir fallback yapmaz; başarılı JSON'da method: WGC ve beklenen boyut bulunmalı, dosyayı açıp doğru pencereyi/güncel kareyi kontrol edin. --backend auto iki denemeyi ve seçilen yöntemi yazar; URL komutu adresi konsola yazdığı için özel/token'lı adreslerin çıktısını paylaşmayın. Bu araç vault'a kart yazmaz; yalnız açıkça istenen PNG dosyasını yazar. ```powershell py -3.12 tests/manual_windows_capture.py --backend wgc --delay 5 --output .\wgc-game.png py -3.12 tests/manual_windows_capture.py --backend printwindow --delay 5 --output .\printwindow-game.png py -3.12 tests/manual_windows_capture.py --backend auto --delay 5 --output .\auto-game.png py -3.12 tests/manual_windows_capture.py --url --delay 5 ``` -------------------------------- ### Windows için kurulum komutu (install_v3.py) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/README.md Terminalden manuel kurulum için Windows'ta kullanılır. Vault yolunu kendi not klasörünle değiştir. Paket klasöründe çalıştırılmalıdır. ```powershell py -3 scripts/install_v3.py --vault "C:\Notlar\Beynim" ``` -------------------------------- ### Doctor output: measurement failed Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/PREFERENCES.md Example output from 'beyin.py doctor' when the measurement fails, including the error message. ASCII output. ```text Son bilgi damitmasi: olculemedi () ``` -------------------------------- ### WGC ve Win32 testlerini çalıştırma (BEYIN_TEST_WGC) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/WINDOWS-CAPTURE-ABI.md Gerçek Windows doğrulaması için önce güncel dosyaları PR dalına yerleştirip testleri çalıştırın. WGC testi yalnız kendi çizdiği pencereye erişir; masaüstü kilitliyse, foreground reddedilirse veya WGC kare vermezse testi geçmiş saymayın. Diğer mevcut gerçek Win32 testlerine yeni BEYIN_TEST_DESKTOP engeli eklenmemiştir. ```powershell py -3.12 -m unittest discover -s tests -p "v3_yakala_*.py" -v $env:BEYIN_TEST_WGC = "1" py -3.12 -m unittest discover -s tests -p "v3_yakala_wgc_test.py" -v Remove-Item Env:BEYIN_TEST_WGC ``` -------------------------------- ### GET /health yanıtı Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/INGEST-SERVER.md Sunucunun ayakta olup olmadığını kontrol eden sağlık uç noktasının başarılı JSON yanıtı. ```json { "status": "ok", "service": "beyin-ingest-server", "version": "1.0.0", "inbox": "ready" } ``` -------------------------------- ### Check python3-missing marker Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/stock-claude-doctor.md Checks for the python3-missing marker file. If present, hooks could not find python3 and JSON escaping failed; fix by installing python3 and deleting the file with `rm .claude/scripts/.state/python3-missing`. ```bash if [ -f .claude/scripts/.state/python3-missing ]; then echo "isaret VAR, tarih: $(head -1 .claude/scripts/.state/python3-missing 2>/dev/null)"; else echo "isaret yok"; fi ``` -------------------------------- ### Doctor output: no concept notes distilled yet Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/PREFERENCES.md Example output from 'beyin.py doctor' when no concept notes have been distilled yet, showing the total number of receipts. ASCII output. ```text Son bilgi damitmasi: henuz kavram notu damitilmadi (toplam N makbuz) ``` -------------------------------- ### Normal modu ayarla (python3 beyin.py preferences --profile normal) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/v3.0.2/beyin.md Normal modu etkinleştirir: her hook olayında yerel kontrol, oturum başı ve mesajlarda en çok 5000 karakter ek bağlam. ```bash python3 beyin.py preferences --profile normal ``` -------------------------------- ### Uninstall Antigravity bridge before rollback Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/GLOBAL-BRIDGE.md Run before rolling back to 3.11.0 to remove the global bridge. The new `bridge --install` / `--uninstall` commands are not present in 3.11.0. ```sh python3 beyin.py bridge --harness antigravity --uninstall ``` -------------------------------- ### Run upgrade.sh --stage check to plan the upgrade Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP.md Run the upgrade script in check mode to print the plan, current memory folder name, number of v1 hooks in settings.local.json, and an ONAY GEREKLİ list when confirmations are needed. Use the absolute vault path confirmed in PHASE M, in double quotes because it contains spaces and emoji. This stage changes nothing. ```bash bash scripts/upgrade.sh --vault "/kullanicinin/mutlak/vault/yolu" --stage check ``` -------------------------------- ### Untrack a specific file with git rm --cached Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/MULTI-MACHINE.md Use this command to remove a selected installation file from Git tracking without deleting it from the working copy. Only untrack chosen files, not the entire vault, and review the staged diff before committing. ```bash git rm --cached -- DOSYA ``` -------------------------------- ### Windows: Vault'u taşıma ve state'i yeniden bağlama (--rebind-state) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/MULTI-MACHINE.md Kurulu vault'u yeni bir klasöre ya da Windows hesabına taşıdıktan sonra kurucuyu yeni vault yolu ve eski state klasörüyle yeniden çalıştırın. `--rebind-state` bayrağı, state indeksini (`memory.sqlite3`) yeni vault yoluna bağlar; bayrak verilmezse kurucu hiçbir dosyayı değiştirmeden durur ve bayrağı önerir. Eski state yolu vault'taki `.beyin-runtime.json` dosyasının `state` alanındadır. ```text py -3 scripts/install_v3.py --vault "C:\Users\\Beynim" --state "" --rebind-state ``` -------------------------------- ### macOS LaunchAgent plist: com.avenox.beyin-saglik Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/PREFERENCES.md LaunchAgent tanımı; her gün 20:00'de `/opt/homebrew/bin/python3` ile `beyin.py scheduled-check --notify` çalıştırır. `/usr/bin/python3` macOS 3.9 olduğundan 3.11+ bir yorumcu yolu gerekir; vault iCloud/Belgeler/Masaüstü altındaysa Tam Disk Erişimi'ne bu `python3` eklenmelidir. Bildirim `osascript` ile geldiği için Bildirim Merkezi'nde "Betik Düzenleyici" adıyla görünür. ```xml Labelcom.avenox.beyin-saglik ProgramArguments /opt/homebrew/bin/python3 /Users/sen/Beynim/beyin.py scheduled-check--notify StartCalendarIntervalHour20Minute0 StandardOutPath/Users/sen/Library/Logs/beyin-saglik.log StandardErrorPath/Users/sen/Library/Logs/beyin-saglik.log ``` -------------------------------- ### Doctor output: days since last knowledge distillation Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/PREFERENCES.md Example output from 'beyin.py doctor' showing how long ago the last knowledge distillation occurred and how many receipts were recorded since. ASCII output, similar to other doctor lines. ```text Son bilgi damitmasi: 3 gun once (o tarihten beri 12 makbuz) ``` -------------------------------- ### python3-missing işaretini kontrol et (PowerShell) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/windows-doctor.md Hook'ların çalışan bir Python bulamadığını gösteren işaret dosyasının varlığını ve tarihini kontrol eder. İşaret varsa, Python kontrolünü yeşile çevirip dosyayı silin. ```powershell if (Test-Path .claude\scripts\.state\python3-missing) { "isaret VAR, tarih: " + (Get-Content .claude\scripts\.state\python3-missing -TotalCount 1) } else { 'isaret yok' } ``` -------------------------------- ### Check compile state Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/stock-claude-doctor.md Checks the compile state file and prints last_run, last_status, and ingested log count. Green if last_run is newer than 48h and last_status is 'ok'; red if last_status starts with 'fail:' or is older than 48h. Fix by running `python3 .claude/scripts/compile.py --dry-run` then `python3 .claude/scripts/compile.py`. ```bash f=".claude/scripts/.state/compile-state.json"; if [ -f "$f" ]; then m=$(stat -f %m "$f" 2>/dev/null || stat -c %Y "$f"); n=$(date +%s); echo "state: $(( (n - m) / 3600 )) saat once guncellendi"; python3 -c "import json;d=json.load(open('.claude/scripts/.state/compile-state.json'));print('last_run:',d.get('last_run','yok'));print('last_status:',d.get('last_status','yok'));print('ingested:',len(d.get('ingested',{})),'log')" 2>/dev/null || echo "state dosyasi bozuk, JSON okunamadi"; else echo "compile: state dosyasi yok, henuz hic derleme calismadi"; fi ``` -------------------------------- ### Check version file Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/stock-claude-doctor.md Reads the version from .beyin-version. Green if '2.3.0', yellow if '2.2.0', '2.1.0', '2.0.0' or file missing (v1 vault). Fix by applying the upgrade path (B mode) in SETUP.md; upgrade does not touch existing memory files, only adds missing parts. ```bash if [ -f .beyin-version ]; then echo "surum: $(head -1 .beyin-version)"; else echo "surum: DOSYA YOK, v1 vault"; fi ``` -------------------------------- ### Daha az bağlam (python3 beyin.py preferences --context-chars 2000) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/v3.0.2/beyin.md Bağlam karakter sınırını 2000 olarak ayarlar. Karakter sınırı token sayısı veya ücret garantisi değildir. ```bash python3 beyin.py preferences --context-chars 2000 ``` -------------------------------- ### Poll for daily log after /exit Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP.md Poll for the daily log file after the user types /exit. Waits up to 120 seconds (24 tries of 5 seconds) for the file to exist and contain a line starting with '### Oturum'. Prints either 'GUNLUK LOG HAZIR' with the last 12 lines or 'GUNLUK LOG 120 SANIYEDE YAZILMADI'. ```bash BEYIN_LOG="{{VAULT_PATH}}/daily/$(date +%F).md" BEYIN_TRY=0 BEYIN_OK=0 while [ "$BEYIN_TRY" -lt 24 ]; do if [ -f "$BEYIN_LOG" ] && grep -q '^### Oturum' "$BEYIN_LOG" 2>/dev/null; then BEYIN_OK=1 break fi BEYIN_TRY=$((BEYIN_TRY + 1)) sleep 5 done if [ "$BEYIN_OK" = "1" ]; then echo "GUNLUK LOG HAZIR: $BEYIN_LOG" tail -12 "$BEYIN_LOG" else echo "GUNLUK LOG 120 SANIYEDE YAZILMADI: $BEYIN_LOG" fi ``` -------------------------------- ### Ekonomik modu ayarla (python3 beyin.py preferences --profile economical) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/v3.0.2/beyin.md Ekonomik modu etkinleştirir: yeni oturumda taze kontrol ve en çok 2000 karakter bağlam; sonraki olaylarda kontroller arası en az 15 dakika. ```bash python3 beyin.py preferences --profile economical ``` -------------------------------- ### Global köprü kurulumu: bridge --harness antigravity --install Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/releases/3.12.0.md Antigravity için global hook ve kapsamlı GEMINI.md yönergesini kurar. --uninstall kaldırır; mevcut dosyalar .bak yedeğiyle korunur, bozuk JSON üzerine yazılmaz, yabancı hook'lar silinmez. --print-config diske yazmadan yapılandırmayı gösterir. ```bash python3 beyin.py bridge --harness antigravity --project-root "/tam/yol/Projelerim" --install ``` -------------------------------- ### Model CLI oturum durumunu kontrol et (PowerShell) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/windows-doctor.md claude CLI'nin oturum açıp açmadığını auth status ile doğrular. Oturum kapalıysa her flush 'Not logged in' alır ve günlük oluşmaz. Masaüstü uygulaması oturumu CLI'yi kapsamaz; kullanıcı claude auth login ile giriş yapmalıdır. ```powershell $cli = Get-Command claude -ErrorAction SilentlyContinue if (-not $cli) { 'claude: YOK' } else { $raw = & $cli.Source auth status 2>$null try { $j = $raw | ConvertFrom-Json if ($j.loggedIn) { "oturum: acik (yontem: $($j.authMethod))" } else { 'oturum: KAPALI' } } catch { 'oturum: OKUNAMADI' } } ``` -------------------------------- ### Run graf_kontrol.py with PYTHONIOENCODING=utf-8 Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/windows-doctor.md Runs graf_kontrol.py with UTF-8 output encoding, which is required on Windows because the agent always captures output and Python would otherwise use the console code page (cp1254 on Turkish systems) and crash with UnicodeEncodeError on emoji folder names. The script prints orphan folder names and expects content folders to start with emoji like 📥 000-Inbox. ```powershell . .\.claude\hooks\lib.ps1 $env:PYTHONIOENCODING = 'utf-8' & (Get-BeyinPython) .claude\scripts\graf_kontrol.py ``` -------------------------------- ### Otomatik bağlamı kapat, yerel kontroller devam etsin (python3 beyin.py preferences --context-mode off) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/tests/fixtures/v3/released-skills/v3.0.2/beyin.md Otomatik bağlamı kapatır, yerel kontroller devam eder. Manuel modda bilgi gerektiğinde `context` komutuyla kaynağı tazeleyin. ```bash python3 beyin.py preferences --context-mode off ``` -------------------------------- ### chat-trace backfill komut örnekleri Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/CHAT-TRACE.md Claude Code oturumlarını silinmeden önce geri aktarmak için `python beyin.py chat-trace backfill` komutunun çeşitli kullanımları. Varsayılan çağrı deneme modudur; vault'a ve state'e yazmaz. `--show` yalnız iz açıkken çalışır ve hiçbir şey saklamaz; `--file` açıkça yazılan özeti belirtir; `--skip` kaydedilecek bir şey olmadığını belirtir. ```sh python beyin.py chat-trace backfill # deneme: yalnız sayı, hash ve tarih ``` ```sh python beyin.py chat-trace on ``` ```sh python beyin.py chat-trace backfill --session OTURUM --show # tek oturumun temizlenmiş dökümü ``` ```sh python beyin.py chat-trace backfill --session OTURUM --file iz.txt # açıkça yazılan özet ``` ```sh python beyin.py chat-trace backfill --session OTURUM --skip # kaydedilecek bir şey yok ``` -------------------------------- ### Kurulu V3 updater ile güncelleme (3b) Source: https://github.com/avenoxai/avenoxbeyin/blob/main/beyin.md `.beyin-version` zaten `3.` ile başlıyorsa, vault içindeki `beyin.py` updater'ını kullanın. Önce `--check` ile doğrulayın, sonra güncellemeyi uygulayın; `updated` başarılı, `noop` zaten güncel demektir. Gerekirse ` beyin.py rollback` ile tam geri alınır. `--package` olmadan da çalışır, ancak `http_403` gibi ağ hatası 'güncel' anlamına gelmez. `update` komutu tanınmıyorsa 3a yoluna düşün. ```text beyin.py update --check --package ``` ```text beyin.py update --package ``` -------------------------------- ### macOS: launchctl bootstrap komutu Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/PREFERENCES.md macOS'ta zamanlanmış sağlık denetimini başlatmak için kullanılır. `com.avenox.beyin-saglik.plist` dosyasını LaunchAgents dizininden yükler. ```sh launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.avenox.beyin-saglik.plist ``` -------------------------------- ### learn --candidate komutu Source: https://github.com/avenoxai/avenoxbeyin/blob/main/docs/v3/releases/3.12.0.md Öğrenim adayını runtime içindeki learning-state.jsonl dosyasına kaydeder. Kaynak güveni denetlenir ve sır süzgeci uygulanır. ```bash python3 beyin.py learn --candidate "Öğrenim adayı" --source knowledge/not.md ``` -------------------------------- ### Initialize git and create first commit in vault Source: https://github.com/avenoxai/avenoxbeyin/blob/main/SETUP.md Initializes a local git repository in the vault, stages all files, and creates the first commit. It blocks staging of sensitive files (settings.local.json, .yedek, .bak, .env) and falls back to placeholder identity if git user.name/email are not set. The repository remains local and private; no remote is created. ```bash cd "{{VAULT_PATH}}" git init -q 2>/dev/null || true git add -A BEYIN_LEAK=$(git diff --cached --name-only | grep -E 'settings\.local\.json|\.yedek|\.bak$|(^|/)\.env$' || true) if [ -n "$BEYIN_LEAK" ]; then git reset -q echo "🔴 SAHNELENMESI YASAK DOSYA: $BEYIN_LEAK" echo " .gitignore eksik. Once onu duzelt, sonra tekrar dene." exit 1 fi BEYIN_STAGED=$(git diff --cached --name-only | wc -l | tr -d ' ') BEYIN_NAME=$(git config user.name 2>/dev/null || echo "") BEYIN_MAIL=$(git config user.email 2>/dev/null || echo "") [ -n "$BEYIN_NAME" ] || BEYIN_NAME="{{USER_NAME}}" [ -n "$BEYIN_MAIL" ] || BEYIN_MAIL="beyin@localhost" if [ "$BEYIN_STAGED" -gt 0 ]; then if git -c user.name="$BEYIN_NAME" -c user.email="$BEYIN_MAIL" \ commit -q -m "{{OS_NAME}}: ikinci beyin kuruldu"; then echo "ILK COMMIT: $(git rev-parse --short HEAD) ($BEYIN_STAGED dosya)" else echo "🔴 ILK COMMIT BASARISIZ: $BEYIN_STAGED dosya sahnede kaldı" fi else echo "🔴 SAHNEDE DOSYA YOK: kopyalama adımı çalışmamış olabilir" fi ```