vercel/eve

vercel profile

Latest recorded source activity: October 7, 2026 at 15:46

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 9

GitHub stars: 5,574
GitHub forks: 615

Repository README

Repository README source: README.md

Read the source README

Expand full README

<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. Follow the [first-agent tutorial](https://eve.dev/docs/tutorial/first-agent) for a complete walkthrough. ### 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). ## Beta terms eve is currently in beta and subject to the [Vercel beta terms](https://vercel.com/docs/release-phases/public-beta-agreement); the framework, APIs, documentation, and behavior may change before general availability.

Loading the repository README…

Skills in this repository

Web & Digital Interface Designers

1 occupation categories · 11% classified

skill

occupation

description

updated

kennel-handbook

unclassified

Front-desk handbook for the Maple Street kennel, with its reference files.

2026-10-07

gh-pr-description

unclassified

Drafts and reviews GitHub pull request descriptions for the eve repository. Use when opening, updating, or reviewing a PR, or when summarizing a branch for reviewers.

2026-10-01

technical-writing

unclassified

Write, edit, review, or audit user-facing documentation for the eve repository. Use for changes under docs/, documentation tied to eve APIs or CLI behavior, docs work based on Slack or support feedback, and requests to make eve docs clearer, more natural, or…

2026-10-01

test-audit

unclassified

Invoke whenever writing, changing, reviewing, or sweeping tests in the eve repository. Authoring gate for new tests plus audit workflow for low-value, slow, implementation-coupled, or duplicative tests and the test-only production seams they demand.

2026-10-01

eve-chat-template-eve

unclassified

Work safely on Eve-specific internals in the Eve chat template. Use when changing the Eve agent, withEve routes, eveChannel auth, useEveAgent, ClientSession/SessionState, persisted event logs, stream/resume behavior, connection authorization, Vercel Connect…

2026-09-28

investigate

unclassified

Investigate a specific issue report with strict, evidence-driven diagnosis.

2026-09-23

lookup-agent-run

unclassified

Find an eve Agent Run from a run ID, project, request reference, or approximate time using authorized evidence available to the consumer.

2026-09-23

review

unclassified

Comprehensive security and correctness audit. Use for review, deep review, thermo nuclear, or thermonuclear requests and branch or PR diff audits.

2026-09-23

dashboard-chat-best-practices

Web & Digital Interface Designers

Apply dashboard-grade chat UX patterns in the Eve chat template. Use when changing Next.js Cache Components/PPR behavior, static shell layout, Suspense bootstrap boundaries, theme hydration, auth display hydration, signed-in/signed-out static shell behavior,…

2026-09-14

Showing 9 of 9 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/vercel/eve.