Get started with eve: durable AI agents in TypeScript

Choose a model, provider, and channel that meet your data-processing and compliance requirements.
Run eve init with a project name to create a project with an agent in agent/:
The command creates the project, installs dependencies, initializes Git, and opens the terminal UI.
From the root of a project that has a package.json and no agent/ directory, run:
The command adds an agent in agent/, installs dependencies, and opens the terminal UI.
eve connects with credentials you already have, or opens /login to set one up.
Once connected, you can start chatting with your agent. Use /model to switch models or reasoning effort.
The terminal UI opens after interactive initialization. To return later, run this from the project root:
eve reloads your changes as you work.
See Project Structure when adding another root agent or deciding where a frontend belongs. The Agent Files reference lists supported files and discovery rules.
If you do not want to use the scaffold, install the runtime dependencies:
Pin Node.js 26 with "engines": { "node": "26.x" } in package.json, then create agent/instructions.md and, when you need runtime configuration, agent/agent.ts.
The installed package's node_modules/eve/CHANGELOG.md contains that version's release notes and a link to the full changelog through that version. For an upgrade across multiple releases, review each version between the installed and target versions in the target version's changelog at https://raw.githubusercontent.com/vercel/eve/refs/tags/eve%40<version>/packages/eve/CHANGELOG.md.
Try these from the eve terminal UI:
For examples of what to build, see Use Cases. Then continue with the task you need:
Read Execution Model and Durability to learn how sessions, turns, and steps run, and how waiting work survives restarts.