ship-eve

A growing collection of runnable eve agents — clone them, run them locally, and learn from real-world examples that grow in complexity over time.

Agents

#	Slug	Summary	Eve surfaces	Eve capabilities demonstrated
0001	weather	Weather assistant with a typed tool	tools, channels	default harness, typed tool, HTTP channel
0002	meal-planner	Single-meal planner with allergen skill	tools, channels, skills	context control (load-on-demand skills)
0003	standup-bot	Personal standup from GitHub activity	tools, channels, skills, connections	MCP connections, live external API
0004	csv-analyst	CSV data Q&A with Python sandbox analysis	tools, channels, skills, sandbox	sandbox execution
0005	digest-bot	Weekday tech digest from a single RSS feed	tools, channels, skills, schedules	schedules (cron)
0006	research-router	Eve docs Q&A via researcher and writer subagents	tools, channels, skills, subagents	subagent delegation, structured output
0007	support-bot	TaskFlow support Q&A with regression eval suite	tools, channels, skills, evals	evals (regression suite)
0008	budget-guard	Orders Q&A with per-turn query budget	tools, channels, skills, hooks	durable state (defineState), hooks, session context
0009	brand-voice	White-label support with env-driven persona	tools, channels, skills, instructions	instructions.ts, context control, typed tool
0010	json-placeholder	JSONPlaceholder REST router with six resource subagents	tools, channels, skills, subagents	subagent delegation, live external API, typed tool, context control

Skills

Install the create-agent skill to scaffold new eve agents through a guided design interview:

npx skills add ikindacodes/ship-eve --skill create-agent

Then run /create-agent in Cursor (or your supported agent). See skills/README.md for more options.

Prerequisites

• Node 24+
• pnpm
• A Vercel AI Gateway API key (AI_GATEWAY_API_KEY)

All agents in this repo use the AI Gateway for model inference. Direct provider keys are not supported here.

Quick start

git clone https://github.com/ikindacodes/ship-eve.git
cd ship-eve
pnpm install
cd agents/0001-weather
cp .env.example .env
# Add AI_GATEWAY_API_KEY to .env
pnpm dev

Copy a single agent

Each agent is self-contained. Copy its folder into your own project:

cp -R agents/0001-weather/ ~/my-agent/
cd ~/my-agent
pnpm install
cp .env.example .env
pnpm dev

Monorepo layout

ship-eve/
├── agents/       # Runnable eve agents (NNNN-slug)
├── skills/       # Installable agent skills (npx skills add …)
├── apps/         # Future Next.js gallery and integrations
└── packages/     # Shared TypeScript config and tooling

Scripts

pnpm typecheck              # Typecheck all packages
pnpm build                  # Build all agents
pnpm dev --filter @ship-eve/0001-weather

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.