How rafalapenta/ephemeral-agents works
AGency is a multi-agent orchestration platform: a task is accepted, tracked, routed to a matching agent with authorized tools, handed off, and recorded in persistent state. The dashboard and FastMCP clients are documented entry points; the README also describes memory, scheduling, and a skills registry. The excerpts establish the orchestration, routing, catalog, and state relationships. Dashboard-to-API details and some documented subsystems are not shown in source excerpts, so those links are omitted rather than inferred.
Main entry points: orchestrator.py Task orchestrator · indexer.py Agent catalog indexer · server.py FastAPI server · semantic.py Semantic router
Components 18
Product entry points
- Web dashboard
dashboard/app.js - Agent clients
- FastAPI server
server.py
Task orchestration
- Task orchestrator
src/macro_agents/orchestrator.py - Kanban lifecycle
src/orchestration/kanban.py - Context compressor
src/orchestration/context.py
Agent registry and routing
- Semantic router
src/router/semantic.py - Agent catalog indexer
src/catalog/indexer.py - Catalog models
src/database/models.py - Catalog schemas
src/database/schemas.py - Relational catalog
- Vector index
Persistent state and memory
- State manager
src/state/manager.py - Merge-patch logic
src/state/merge_patch.py - Persistent memory search
brain/memory_search.py
Product capabilities
- Task scheduler
scheduler/scheduler.py - Skills registry
Other components
- Dashboard or agent client
Connections 17
- Dashboard or agent client → Web dashboard: uses
README.md - Dashboard or agent client → Agent clients: uses
README.md - Web dashboard → FastAPI server: accesses
- FastAPI server → Task orchestrator: dispatches
- FastAPI server → Persistent memory search: uses
server.py - FastAPI server → Task scheduler: uses
server.py - Task orchestrator → Kanban lifecycle: creates and transitions
src/macro_agents/orchestrator.py - Task orchestrator → State manager: persists state
src/macro_agents/orchestrator.py - Task orchestrator → Semantic router: routes task
src/macro_agents/orchestrator.py - Task orchestrator → Context compressor: compresses context
src/macro_agents/orchestrator.py - Semantic router → Relational catalog: queries
src/router/semantic.py - Semantic router → Vector index: searches
src/router/semantic.py - Agent catalog indexer → Relational catalog: persists catalog
src/catalog/indexer.py - Agent catalog indexer → Vector index: persists vectors
src/catalog/indexer.py - Agent catalog indexer → Catalog models: creates records
src/catalog/indexer.py - Agent catalog indexer → Catalog schemas: validates entries
src/catalog/indexer.py - State manager → Merge-patch logic: applies patches
src/state/manager.py