How fmarzochi/egc works
EGC is a local-first runtime that equips multiple AI coding tools with shared project memory, command guardrails, output compression, and session coordination. The user’s main workflow is to install EGC once, then work in a supported tool: session hooks connect the tool, memory and safety features operate in the background, and sessions share context. The graph also preserves the documented dashboard, model-provider, and installation capabilities. Several links reflect README-level behavior; unsampled implementation details are intentionally not inferred.
Main entry points: install-lifecycle.js Install Lifecycle · src/index.ts Guardian Server · src/index.ts Memory Server · install-manifests.js Install Manifests
Components 21
Installation
- Install Lifecycle
scripts/lib/install-lifecycle.js - Install Manifests
scripts/lib/install-manifests.js - Tool Adapters
scripts/lib/install-targets/registry.js - Install Apply
scripts/lib/install/apply.js
Agent Runtime
- Session Hooks
scripts/hooks - Guardian Server
mcp/servers/egc-guardian/src/index.ts
Memory Mesh
- Memory Server
mcp/servers/egc-memory/src/index.ts - Persistent Memory
mcp/servers/egc-memory/src - Session Bus
mcp/servers/egc-memory/src/session-bus.ts - Sync Backends
mcp/servers/egc-memory/src/sync
Safety And Context
- Token Crusher
scripts/lib/crusher/engine.js - Memory Filters
scripts/lib/memory-filters.js - Agent Catalog
mcp/servers/egc-guardian/src/catalog-index.ts - Injection Scanner
mcp/servers/egc-guardian/src/prompt-injection-scanner.ts
Dashboard And Models
- Live Dashboard
dashboard/server.js - Dashboard Operations
dashboard/ops.js - Shared Operations
scripts/lib/operations/index.js - Model Resolver
src/llm/core/model_resolver.py
Other components
- Developer
- AI Coding Tools
- Model Providers
Connections 20
- Developer → Install Lifecycle: installs
README.md - Install Lifecycle → Install Manifests: uses manifests
scripts/lib/install-manifests.js - Install Manifests → Tool Adapters: selects adapters
scripts/lib/install-manifests.js - Install Lifecycle → Install Apply: applies setup
- Install Apply → AI Coding Tools: configures tools
README.md - AI Coding Tools → Session Hooks: starts sessions
README.md - Session Hooks → Memory Server: loads memory
README.md - AI Coding Tools → Guardian Server: checks commands
README.md - AI Coding Tools → Token Crusher: filters shell output
README.md - Memory Server → Persistent Memory: persists context
README.md - AI Coding Tools → Session Bus: shares session events
README.md - Memory Server → Sync Backends: syncs memory
- Guardian Server → Agent Catalog: uses catalog
- Guardian Server → Injection Scanner: scans prompts
- Token Crusher → Memory Filters: filters context
- Developer → Live Dashboard: views activity
README.md - Live Dashboard → Dashboard Operations: routes operations
dashboard/server.js - Dashboard Operations → Shared Operations: dispatches operations
dashboard/ops.js - AI Coding Tools → Model Resolver: selects models
- Model Resolver → Model Providers: resolves providers
README.md