How heraclitus0/alfred works
Alfred is a persistent, mission-centered executive agent. Its primary user workflow begins at the CLI, where a user can request a consultation or improvement; runtime services manage consultation threads, build prompts, obtain and store responses, and may prepare bounded sandbox rewrites for validation and promotion. The README also describes browser-assisted ChatGPT use, watchers, missions, approvals, and safety foundations. The graph combines documented workflow with relationships visible in excerpts and the source index; unsampled runtime internals are not assumed.
Main entry points: app.py Runtime assembly · consultation/manager.py Consultation manager · base.py Memory facade · research_threads/manager.py Research threads
Components 24
Runtime and control
- CLI controls
alfred/cli/commands.py - Runtime assembly
alfred/app.py - Runtime loop
alfred/core/runtime.py - Heartbeat
alfred/core/heartbeat.py
Consultation and research
- Consultation manager
alfred/consultation/manager.py - Research threads
alfred/research_threads/manager.py - Prompt engineering
alfred/prompts/prompt_engineer.py - LLM consultation
alfred/llm/ollama_client.py - ChatGPT browser
alfred/actions/browser/operator.py
Bounded improvement
- Weakness diagnosis
alfred/self_improvement/diagnostics.py - Rewrite proposal
alfred/self_improvement/proposal_builder.py - Rewrite sandbox
alfred/self_improvement/sandbox_runner.py - Sandbox workspace
alfred/actions/projects/sandbox_manager.py - Change promotion
alfred/self_improvement/promoter.py
Signals and operations
- Mission management
alfred/missions/manager.py - Watcher manager
alfred/watchers/manager.py - Device storage signal
alfred/watchers/device/storage.py - Notifications
alfred/notifications/manager.py
Memory and safety
- Memory facade
alfred/memory/base.py - Persistent database
alfred/storage/db.py - Rewrite approval
alfred/autonomy/approval_engine.py - Audit logging
alfred/safety/audit.py - Kill switch
alfred/safety/kill_switch.py
Other components
- User
Connections 35
- User → CLI controls: issues commands
README.md - CLI controls → Runtime assembly: starts runtime
- Runtime assembly → Runtime loop: assembles
alfred/app.py - Runtime assembly → Consultation manager: configures
alfred/app.py - Runtime assembly → Research threads: configures
alfred/app.py - Runtime assembly → Prompt engineering: configures
alfred/app.py - Runtime assembly → LLM consultation: configures
alfred/app.py - Runtime assembly → ChatGPT browser: configures
alfred/app.py - Runtime assembly → Heartbeat: registers
alfred/app.py - Consultation manager → Research threads: selects thread
alfred/consultation/manager.py - Consultation manager → Prompt engineering: builds prompt
alfred/consultation/manager.py - Consultation manager → LLM consultation: requests response
alfred/consultation/manager.py - Consultation manager → Memory facade: stores result
alfred/consultation/manager.py - Consultation manager → Research threads: updates summary
alfred/consultation/manager.py - Consultation manager → Audit logging: records consultation
alfred/consultation/manager.py - Consultation manager → ChatGPT browser: opens ChatGPT
alfred/consultation/manager.py - Research threads → Memory facade: reads and writes
alfred/research_threads/manager.py - Watcher manager → Device storage signal: ticks watcher
alfred/watchers/manager.py - Watcher manager → Notifications: emits signals
alfred/watchers/manager.py - Notifications → Memory facade: stores latest
alfred/notifications/manager.py - Mission management → Memory facade: saves mission
alfred/missions/manager.py - Memory facade → Persistent database: persists state
alfred/app.py - Runtime assembly → Mission management: configures
alfred/app.py - Runtime assembly → Watcher manager: configures
alfred/app.py - Runtime assembly → Notifications: configures
alfred/app.py - Runtime assembly → Rewrite approval: configures
alfred/app.py - Runtime assembly → Audit logging: configures
alfred/app.py - Runtime assembly → Kill switch: configures
alfred/app.py - Runtime assembly → Weakness diagnosis: configures
alfred/app.py - Runtime assembly → Rewrite proposal: configures
alfred/app.py - Runtime assembly → Rewrite sandbox: configures
alfred/app.py - Runtime assembly → Change promotion: configures
alfred/app.py - Rewrite proposal → Rewrite sandbox: sandbox rewrite
README.md - Rewrite sandbox → Change promotion: validates then promotes
README.md - Rewrite approval → Rewrite proposal: bounds targets
README.md