Summary

eve is a framework for building durable AI agents, prioritizing a filesystem-first architecture. It simplifies agent development by organizing core capabilities—like instructions, tools, and channels—into conventional project directories, making agents easier to inspect, extend, and operate for developers.

How It Works

The framework adopts a "filesystem-first" paradigm where the project's directory structure serves as the primary interface for authoring agents. Core components such as system prompts (instructions.md), callable functions (tools/), on-demand procedures (skills/), communication interfaces (channels/), and scheduled tasks (schedules/) reside in predictable locations. This conventional organization enhances discoverability and maintainability.

Quick Start & Requirements

Initiate a new agent project with npx eve@latest init <my-agent-name>. This command scaffolds the project, installs dependencies, initializes Git, and launches an interactive terminal UI. For existing projects, use npx eve@latest init .. Full documentation is accessible locally within node_modules/eve/docs.

Highlighted Details

• Filesystem-Centric Design: Agent logic is structured into distinct directories like agent/tools/, agent/skills/, agent/channels/, and agent/schedules/.
• Declarative Configuration: Agent behavior, model choices (e.g., anthropic/claude-sonnet-4.6), and tool definitions (defineTool with Zod schemas) are configured via TypeScript files and Markdown.
• Interactive Development: An integrated terminal UI facilitates agent development and interaction.
• Extensibility: Supports human-in-the-loop prompts, subagents, and cron-like schedules.

Maintenance & Community

Community interaction and support are primarily channeled through GitHub Discussions. Contribution guidelines are detailed in CONTRIBUTING.md, and security vulnerabilities should be reported responsibly following SECURITY.md.

Licensing & Compatibility

The project is currently in beta and subject to Vercel's beta terms. Specific open-source licensing details are not explicitly provided in the README, and users should be aware that the framework, APIs, and behavior may change before general availability.

Limitations & Caveats

As a beta product, eve is subject to potential changes in its framework, APIs, and overall behavior. Users should anticipate potential breaking changes before general availability, and compatibility with production systems may require careful evaluation.