personal-agent-template AGENTS.md

Personal Agent Template

Durable personal AI assistant built with Eve and Nuxt.

Quick Reference

Command	Description
pnpm install	Install dependencies
pnpm dev	Generate Nuxt types, then start Nuxt + Eve
pnpm build	Production build
pnpm lint	ESLint (pnpm lint:fix to autofix)
pnpm typecheck	TypeScript check — app/server/shared plus agent/
pnpm build:agent	Build the Eve agent on its own
pnpm auth:schema	Regenerate the Better Auth Drizzle schema
pnpm db:generate	Regenerate the auth schema, then the Drizzle migration
pnpm db:migrate	Apply migrations

Structure

personal-agent-template/
├── agent/          # Eve agent (channels, tools, skills, connections)
├── app/            # Nuxt UI (pages, components, composables)
├── server/         # Nitro API, Drizzle schema, server utils
├── shared/         # Cross-layer types and helpers
└── docs/           # Architecture, environment, customization

Documentation

• Architecture — System design, request flows, internal API
• Environment — Environment variables
• Customization — Rename agent, add tools, integrations
• README — Quick start and feature overview

Eve Framework

This project uses Eve with a Nuxt frontend (eve/nuxt module). Before writing agent code, read the relevant guide in node_modules/eve/docs/ — start with docs/README.md, which maps each task to its page.

nuxt typecheck does not cover agent/, and eve build bundles without typechecking. pnpm typecheck runs both halves; keep it that way when adding agent code.

Internal API Pattern

The Eve agent calls Nuxt over HTTP:

agent/lib/*-internal.ts  →  /api/internal/*  →  server/utils/*

Authenticated with Authorization: Bearer <INTERNAL_API_SECRET>. See server/utils/internal-api.ts.

Memory

The caller's account identity — name, timezone, locale, bio — is injected into the session instructions by agent/instructions.ts, read over the internal API. That is app data the Profile page owns, distinct from the memory slot below, which holds what the agent chooses to remember.