How avenoxai/avenoxbeyin works
Avenoxbeyin V3 is a local-first second brain for AI coding assistants: agents save and retrieve source-linked knowledge in an editable Markdown vault, with shared state across clients. The main workflow runs on client lifecycle events: the installed adapters invoke the local runtime, which refreshes vault indexing and supplies bounded context; agents can also record outcomes and tasks for later retrieval or recap. The README documents companion continuity, preferences, diagnostics, updates, and optional Jev/Laya advice. Several runtime links are based on documented behavior and module names; source excerpts are partial.
Main entry points: scripts/beyin_v3.py Runtime CLI · beyin_entry.py Vault entry · scripts/beyin_v3.py Memory store · beyin_v3_sync.py Vault sync
Components 21
Client integration
- Client adapters
template/.claude/scripts/beyin_v3_hook.py - Agent skills
template/.agents/skills/beyin/SKILL.md
Memory workflow
- Vault entry
scripts/beyin_entry.py - Runtime CLI
scripts/beyin_v3.py - Vault sync
template/.claude/scripts/beyin_v3_sync.py - Memory store
template/.claude/scripts/beyin_v3.py - Passage retrieval
template/.claude/scripts/beyin_v3_passage.py - Work receipts
template/.claude/scripts/beyin_v3_projections.py - Companion continuity
template/.claude/scripts/beyin_v3_companion.py
State and controls
- Local runtime state
- Vault preferences
template/.claude/scripts/beyin_v3_preferences.py - Health checks
scripts/beyin_v3.py - Install and update
template/.claude/scripts/beyin_v3_update.py
Extensions
- Jev advisor
template/.claude/scripts/beyin_v3_jev.py - Jev provider client
template/.claude/scripts/beyin_v3_jev_client.py
Other components
- User
- AI agent
- Markdown vault
- AI clients
- TypeSafe API
- Local Laya server
Connections 26
- User → AI agent: asks or instructs
- AI agent → Agent skills: uses guidance
- AI clients → Client adapters: dispatches events
- Client adapters → Vault entry: invokes
- AI agent → Vault entry: runs commands
- Vault entry → Runtime CLI: dispatches
- Runtime CLI → Vault sync: refreshes index
- Vault sync → Markdown vault: reads and syncs
- Vault sync → Memory store: indexes records
- Memory store → Local runtime state: reads and writes
- Memory store → Passage retrieval: retrieves passages
- Runtime CLI → Memory store: requests context
- Vault entry → AI agent: returns context
- AI agent → Markdown vault: edits notes
- AI agent → Companion continuity: updates continuity
- Companion continuity → Markdown vault: reads and writes
- Runtime CLI → Work receipts: lists receipts
- Work receipts → Local runtime state: reads receipts
- Runtime CLI → Vault preferences: manages settings
- Vault preferences → Local runtime state: stores preferences
- Runtime CLI → Health checks: runs diagnostics
- Runtime CLI → Install and update: runs update
- Runtime CLI → Jev advisor: requests advice
- Jev advisor → Jev provider client: evaluates with
- Jev provider client → TypeSafe API: sends advice request
- Jev provider client → Local Laya server: sends shadow request