How hunainadhi/zeneraneo works
ZeneraNeo is a toolkit for specifying, generating, running, and improving specialized agent systems. The main user workflow is to configure a project specification, use the meta-agent to generate it, run the agents through the CLI, and inspect trajectories for improvement. The graph also preserves the documented retrieval, memory, sandbox, server, and evaluation capabilities. Some subsystem connections are documented only at the product level; omitted source excerpts limit finer-grained call relationships.
Main entry points: engine.ts Run orchestration · main.ts Zen CLI · runner.ts Agent execution · command.ts Meta-agent
Components 20
Project authoring
- Meta-agent
packages/meta/src/command.ts - Meta chat
packages/meta/src/chat/session.ts - Project configuration
packages/engine/src/projects.ts
Agent runtime
- Run orchestration
packages/engine/src/engine.ts - Run sessions
packages/engine/src/session.ts - Agent execution
packages/neo/src/runner.ts - Runtime services
packages/neo/src/services.ts - Agent memory
packages/neo/src/memory/index.ts - Skills catalog
packages/neo/src/skills.ts - Model adapters
packages/neo/src/models - Command sandbox
packages/sandbox/src/bwrap.ts
Knowledge and evaluation
- Schema retrieval
packages/rag/src/schema/search.ts - Agent evaluation
packages/gym/src/server.ts - Evaluation datasets
packages/meta/src/dataset/command.ts
CLI and operations
- Zen CLI
packages/cli/src/main.ts - Interactive terminal
packages/cli/src/tui/app.tsx
Serving and viewing
- Agent server
packages/server/src/server.ts - Private user state
packages/server/src/userState.ts - Project viewer
packages/view/src/server.ts
Other components
- Project author
Connections 23
- Project author → Zen CLI: runs commands
- Zen CLI → Meta-agent: invokes meta
- Project author → Project configuration: writes specification
- Meta-agent → Project configuration: generates system
- Meta-agent → Meta chat: offers chat
packages/meta/src/command.ts - Zen CLI → Run orchestration: runs project
- Run orchestration → Project configuration: loads project
packages/engine/src/engine.ts - Run orchestration → Agent execution: builds run report
packages/engine/src/engine.ts - Run orchestration → Run sessions: updates session
packages/engine/src/engine.ts - Run orchestration → Command sandbox: tears down sandbox
packages/engine/src/engine.ts - Agent execution → Runtime services: uses services
packages/neo/src/services.ts - Runtime services → Agent memory: provides memory
packages/neo/src/services.ts - Runtime services → Skills catalog: indexes skills
packages/neo/src/services.ts - Agent execution → Model adapters: uses model adapters
- Zen CLI → Command sandbox: preflights sandbox
- Project author → Schema retrieval: queries knowledge
- Schema retrieval → Agent execution: uses embeddings
packages/rag/src/schema/search.ts - Project author → Agent evaluation: evaluates agents
- Evaluation datasets → Agent evaluation: supplies cases
- Project author → Agent server: starts hosted service
- Agent server → Private user state: routes user state
packages/server/src/server.ts - Project author → Project viewer: opens project view
- Zen CLI → Interactive terminal: opens interactive run