explaingit

vercel/eve

Analysis updated 2026-07-03 · repo last pushed 2026-07-03

⭐ Rising3,152TypeScriptAudience · developerComplexity · 3/5ActiveSetup · easy

TLDR

A framework for building AI agents using a file-and-folder structure. You write instructions, tools, and connections as files, and the framework wires everything together for you.

Mindmap

mindmap
  root((repo))
    What it does
      Builds AI agents
      Filesystem as interface
      Handles plumbing
    Structure
      Instructions markdown
      Tools folder
      Skills folder
      Channels and schedules
    Use cases
      Customer support bots
      Slack recap assistants
      Scheduled AI tasks
    Getting started
      Single npx command
      Interactive terminal UI
      Pick an AI model
    Tech stack
      TypeScript
      Node.js
    Audience
      Developers
      Startups
      Product teams
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a customer support bot that can escalate conversations to human teammates.

USE CASE 2

Create an internal assistant that posts weekly recap summaries to Slack on a schedule.

USE CASE 3

Make a weather assistant that answers questions and calls external tools for live data.

USE CASE 4

Run recurring AI-powered tasks on a cron-style schedule with human approval steps.

What is it built with?

TypeScriptNode.jsnpx

How does it compare?

vercel/evemicrosoft/ai-engineering-coachcrafter-station/petdex
Stars3,1523,1933,226
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-032026-07-032026-07-01
MaintenanceActiveActiveActive
Setup difficultyeasymoderatemoderate
Complexity3/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Project is in beta so APIs and behavior may change, requires an AI model provider like Claude.

In plain English

eve is a framework for building AI agents, software that can hold conversations, call external tools, run on schedules, and connect to platforms like Slack or Discord. Instead of writing a lot of glue code to wire an AI model to these capabilities, you organize your agent's parts into folders and files, and the framework handles the connections. The core idea is that the filesystem is the interface. You create an agent/ directory with specific subfolders: instructions.md holds the system prompt telling the agent how to behave, tools/ contains typed functions the AI can call (like fetching weather data), skills/ holds procedures loaded on demand, channels/ connects the agent to messaging platforms, and schedules/ runs recurring tasks. Each piece lives in a predictable location, so you can look at a project folder and immediately understand what the agent does. Getting started is a single command, npx eve@latest init my-agent, which scaffolds the project, installs dependencies, and launches an interactive terminal UI. From there, you write a markdown file with your agent's instructions, optionally add tool functions, pick an AI model like Claude, and run it. The README shows a minimal weather assistant built this way in just a few lines. You can then layer in features like human-in-the-loop approval prompts, subagents, and cron-style scheduled jobs as needed. This is built for developers and teams who want to ship production AI agents without reinventing the plumbing each time. A startup building a customer support bot that needs to escalate to humans, or a team creating an internal assistant that posts weekly Slack recaps, could use this to stand up the agent quickly and keep the codebase legible as it grows. One notable detail: the package ships with its full documentation bundled inside, so coding assistants working in your project can read the docs locally rather than relying on external lookups. The project is currently in beta, so APIs and behavior may shift before a stable release.

Copy-paste prompts

Prompt 1
Using the eve framework, scaffold a new AI agent project called my-agent, then create an instructions.md file that tells the agent to act as a friendly customer support assistant for a SaaS app. Include a tool function that looks up order status by order ID.
Prompt 2
Help me add a scheduled job to my eve agent that runs every Monday at 9am, fetches metrics from a database, and posts a weekly recap summary to a Slack channel.
Prompt 3
Using eve, build a weather assistant agent: write the instructions.md system prompt, add a tool function that fetches current weather for a city, and configure it to run in the interactive terminal UI.
Prompt 4
Show me how to add human-in-the-loop approval prompts to my eve agent so that before it executes a tool that sends an email, it asks me to confirm first.
Prompt 5
Help me structure an eve agent project with a main agent and a subagent: the main agent handles user conversations, and the subagent is responsible for researching topics and returning summaries.

Frequently asked questions

What is eve?

A framework for building AI agents using a file-and-folder structure. You write instructions, tools, and connections as files, and the framework wires everything together for you.

What language is eve written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, npx.

Is eve actively maintained?

Active — commit in last 30 days (last push 2026-07-03).

How hard is eve to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is eve for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub vercel on gitmyhub

Verify against the repo before relying on details.