eve
The Open Framework for Building Agents
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vercel/eve with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vercel/eve'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/vercel-eve)HTML
<a href="/listings/vercel-eve"><img src="/api/listings/vercel-eve/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx eve@latest init my-agent
This creates a new `my-agent` directory, installs its dependencies, initializes Git, and starts the interactive terminal UI. The generated agent uses `openai/gpt-6-luna-fast` with high reasoning.
To start with another AI Gateway model, pass its model ID:
npx eve@latest init my-agent --model openai/gpt-5.6-terra
Passing `--model` without `--reasoning` uses the provider's default reasoning. Pass `--reasoning` to set it explicitly.
To add eve to an existing project, pass a path:
cd myapp npx eve@latest init .
> [!NOTE] > The `eve` package includes its full documentation, so coding agents can read it locally from > `node_modules/eve/docs`.
A minimal example
The generated project includes an `agent` directory. Replace `agent/instructions.md` with:
You are a concise weather demo assistant. Tell users that the weather data is mocked.
Add a mock weather tool at `agent/tools/get_weather.ts`:
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 };
},
});Choose the model in `agent/agent.ts`:
import { defineAgent } from "eve";
export default defineAgent({
model: "openai/gpt-6-luna-fast",
reasoning: "high",
});For a new scaffold, start the agent again:
npm run dev
That's a working agent. Add human-in-the-loop prompts, subagents, and schedules as needed. Follow the [first-agent tutorial](https://eve.dev/docs/tutorial/first-agent) for a complete walkthrough.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 142 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <a href="https://eve.dev/">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset=".github/assets/eve.svg">
- <img alt="eve logo" src=".github/assets/eve.svg" height="128">
- </picture>
- </a>
- <h1>eve</h1>
- <a href="https://vercel.com"><img alt="Vercel logo" src="https://img.shields.io/badge/MADE%20BY%20Vercel-000000.svg?style=for-the-badge&logo=Vercel&labelColor=000"></a>
- <a href="https://www.npmjs.com/package/eve"><img alt="NPM version" src="https://img.shields.io/npm/v/eve.svg?style=for-the-badge&labelColor=000000"></a>
- <a href="https://github.com/vercel/eve/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/npm/l/eve.svg?style=for-the-badge&labelColor=000000"></a>
- <a href="https://github.com/vercel/eve/discussions"><img alt="Join the community on GitHub" src="https://img.shields.io/badge/Join%20the%20community-blueviolet.svg?style=for-the-badge&logo=Github&labelColor=000000&logoWidth=20"></a>
- </div>
- [eve](https://eve.dev/) is a filesystem-first framework for durable AI agents. Core agent capabilities live in
- conventional locations, so projects are easier to inspect, extend, and operate.
- ## The filesystem is the authoring interface
- A typical eve agent has this structure:
- ```text
- my-agent/
- └── agent/
- ├── agent.ts # Optional: model and runtime config
- ├── instructions.md # Required: the always-on system prompt
- ├── tools/ # Optional: typed functions the model can call
- │ └── get_weather.ts
- ├── skills/ # Optional: procedures loaded on demand
- │ └── plan_a_trip.md
- ├── channels/ # Optional: message channels (HTTP, Slack, Discord)
- │ └── slack.ts
- └── schedules/ # Optional: recurring cron jobs
- └── weekly_recap.ts
- ```
- Read the [documentation](https://eve.dev/docs) for the full project layout and guides.
- ## Quick start
- ```bash
- npx eve@latest init my-agent
- ```
- This creates a new `my-agent` directory, installs its dependencies, initializes Git, and starts
- the interactive terminal UI. The generated agent uses `openai/gpt-6-luna-fast` with high reasoning.
- To start with another AI Gateway model, pass its model ID:
- ```bash
- npx eve@latest init my-agent --model openai/gpt-5.6-terra
- ```
- Passing `--model` without `--reasoning` uses the provider's default reasoning. Pass `--reasoning` to set it explicitly.
- To add eve to an existing project, pass a path:
- ```bash
- cd myapp
- npx eve@latest init .
- ```
- > [!NOTE]
- > The `eve` package includes its full documentation, so coding agents can read it locally from
- > `node_modules/eve/docs`.
- ### A minimal example
- The generated project includes an `agent` directory. Replace `agent/instructions.md` with:
- ```md
- You are a concise weather demo assistant. Tell users that the weather data is mocked.
- ```
- Add a mock weather tool at `agent/tools/get_weather.ts`:
- ```ts
- 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 };
- },
- });
- ```
- Choose the model in `agent/agent.ts`:
- ```ts
- import { defineAgent } from "eve";
- export default defineAgent({
- model: "openai/gpt-6-luna-fast",
- reasoning: "high",
- });
- ```
- For a new scaffold, start the agent again:
- ```bash
- npm run dev
- ```
- That's a working agent. Add human-in-the-loop prompts, subagents, and schedules as needed.
- ### Add Web Chat
- From your agent's directory, link a Vercel project and add Web Chat:
- ```bash
- npx eve link
- npx eve add channel/web
- ```
- Choose a hosting layout, then **Sign in with Vercel** to provision authentication for members of the project's team.
- You can also select **Web Chat** from the terminal UI's `/add` channel picker.
- Run `npx eve deploy` when ready to publish. Local development works without browser sign-in.
- See the [Web Chat setup guide](https://eve.dev/docs/channels/eve#web-chat-with-sign-in-with-vercel) for permissions and recovery.
- ## Community
- The eve community lives on [GitHub Discussions](https://github.com/vercel/eve/discussions),
- where you can ask questions, share ideas, and show what you've built.
- ## Contributing
- Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) to get the repo
- running locally and land a change, and use
- [issues](https://github.com/vercel/eve/issues) and
- [discussions](https://github.com/vercel/eve/discussions) to collaborate. By
- participating, you agree to our [Code of Conduct](CODE_OF_CONDUCT.md).
- ## Security
- Please do not open public issues for security vulnerabilities. Instead, follow
- [SECURITY.md](SECURITY.md) and report responsibly to
- [responsible.disclosure@vercel.com](mailto:responsible.disclosure@vercel.com).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.