How vercel/eve works
eve is a filesystem-first framework for authoring and operating durable AI agents. A developer defines agent configuration and instructions, then adds tools, skills, channels, and schedules; the runtime handles incoming work as sessions and can invoke tools or delegate to subagents. Channels expose HTTP or WebSocket routes, while session APIs support streaming and control. The README documents authoring capabilities; sampled runtime sources confirm route contracts and task cancellation, but do not expose the full dispatch implementation, so uncertain internal wiring is omitted.
Main entry points: src Agent runtime · routes.ts Channel routes · agent.ts Agent config · instructions.ts Instructions
Components 20
Agent authoring
- Agent config
apps/templates/eve-chat-template/agent/agent.ts - Instructions
apps/templates/personal-agent-template/agent/instructions.ts - Tools
apps/templates/eve-chat-template/agent/tools/get_weather.ts - Skills
- Channels
apps/templates/eve-chat-template/agent/channels/eve.ts - Schedules
Runtime and sessions
- Agent runtime
packages/eve/src - Durable session
packages/eve/src - Subagents
apps/templates/eve-llm-council-template/agent/subagents - Task cancellation
packages/eve/src/execution/cancel-indexed-session-tasks-step.ts
Channels and clients
- Channel routes
packages/eve/src/channel/routes.ts - Session protocol
packages/eve/src/protocol/routes.ts - Client API
packages/eve/src
Tools and integrations
- Connections
apps/templates/eve-chat-template/agent/connections/linear.ts
Operations
- Agent evals
packages/eve/src/evals/session-manager.ts - Eve CLI
packages/eve/bin/eve.js
Other components
- Agent developer
- Model provider
- Human user
- External services
Connections 23
- Agent developer → Agent config: authors
- Agent developer → Instructions: writes
- Agent developer → Tools: adds
- Agent developer → Skills: adds
- Agent developer → Channels: adds
- Agent developer → Schedules: adds
- Agent config → Agent runtime: configures
- Instructions → Agent runtime: guides
- Channels → Channel routes: declare routes
- Human user → Channel routes: sends request
- Channel routes → Agent runtime: dispatches
- Agent runtime → Durable session: persists state
- Agent runtime → Model provider: requests completion
- Agent runtime → Tools: invokes
- Agent runtime → Subagents: delegates
- Agent runtime → Connections: uses
- Connections → External services: connects
- Client API → Session protocol: uses routes
- Session protocol → Durable session: addresses sessions
- Agent evals → Client API: drives sessions
- Durable session → Task cancellation: indexes tasks
- Task cancellation → Subagents: cancels tasks
- Agent developer → Eve CLI: starts project