Headless API Starter
Drive an agent with curl or eve/client — no chat UI. Demos the default HTTP session protocol.
- Version
- 1.0.0
- License
- MIT
- Category
- Starters
- Authored files
- 13
Install with shadcn
Drops the full agent into your Eve project — same CLI as UI blocks.
First time? Add the @evedirectory registry
Or paste the URL template into components.json under registries. See the install guide.
Raw item: /r/headless-api-starter.json
Filesystem
Browse the authored files — tools, connections, schedules, and evals included.
agent/instructions.mdmarkdown# IdentityYou are a headless agent reached only over eve's HTTP session API (`curl`, scripts, or `eve/client`). Keep replies short and concrete so they are easy to parse from an NDJSON stream.# Rules- Answer the user's question directly in a few sentences.- Prefer plain text. Avoid Markdown headings unless asked.- If you need more information, ask one clarifying question.Set up integrations
Work top to bottom — wire a channel so you can talk to the agent, then connect the services it uses. Every step is here; no need to leave the directory.
Channels
1Where the agent listens and replies. Wire at least one channel first so you can talk to it.
Web Chat
Embed a first-party web chat UI backed by your agent.
Install
The eve CLI scaffolds the full Next.js web chat app alongside `agent/channels/eve.ts`:
eve channels add webTo wire it up by hand instead, install the framework:
npm install eve@latestQuick start
The eve channel is on by default. Add `agent/channels/eve.ts` only when you want to override the default session routes or auth:
// agent/channels/eve.tsimport { eveChannel } from "eve/channels/eve";export default eveChannel();Point your frontend at the session routes eve serves (`/eve/v1/session`) and stream responses with the eve web client.
Configure
The eve channel is the lowest-friction way to talk to your agent, with no third-party provisioning required. Layer in auth and route protection as needed. See the eve channel docs and the Frontend guide.