Vercel Eve
Eve is a filesystem-first framework for building durable AI agents. It organizes agent capabilities in conventional file locations, making projects easier to inspect, extend, and operate. It is for developers who want to create and manage AI agents with a clear project structure.
✨ Key features
- Filesystem-first structure for agent code and config
- Conventional locations for instructions, tools, skills, channels, schedules
- Model and runtime configuration via agent.ts
- Interactive terminal UI for development
- Supports multiple AI Gateway models
- Includes full documentation in the package
🎯 Use cases
- Create a new AI agent project with npx eve@latest init
- Add eve to an existing project
- Build a weather assistant with mock data
- Set up recurring tasks with schedules
- Integrate with messaging channels like Slack or Discord
📦 Installation
🧰 Requirements: Requires Node.js and npm; no API keys or accounts mentioned in the README.
npx eve@latest init my-agent
This creates a new my-agent directory, installs its dependencies, initializes Git, and starts the interactive terminal UI.
To start with another AI Gateway model, pass its model ID:
npx eve@latest init my-agent --model openai/gpt-5.6-terra
To add eve to an existing project, pass a path:
cd myapp
npx eve@latest init .
🚀 Usage
After initialization, replace agent/instructions.md with your system prompt, add tools, and configure the model in agent/agent.ts. Then run:
npm run dev
Example tool definition:
import { defineTool } from "eve/tools";
import { z } from "zod";
export default defineTool({
description: "Return mock weather data for a city.",
inputSchema: z.object({ city: z.string().min(1) }),
async execute({ city }) {
return { city, condition: "Sunny", temperatureF: 72 };
},
});
⚠️ Good to know
Eve is currently in beta and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.
❓ FAQ
How do I create a new eve agent project?
Run npx eve@latest init my-agent to create a new directory with the project structure, install dependencies, and start the interactive terminal UI.
Can I use eve with an existing project?
Yes, run npx eve@latest init . inside your project directory to add eve to it.
How do I specify a different AI model?
Pass the model ID to the init command, e.g., npx eve@latest init my-agent --model openai/gpt-5.6-terra, or set it in agent/agent.ts using defineAgent.
Where can I find the full documentation?
The eve package includes its full documentation locally in node_modules/eve/docs, and online at https://eve.dev/docs.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.