Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt

Use this file to discover all available pages before exploring further.

Agents is no longer available. If you have existing agent memory, here’s how to migrate:
  1. Open agent-memory. You’ll see a list of past conversations with their agent and project.
  2. Find the conversation whose agent memory you want to keep, then click Inject. This writes the agent memory directly into that Project’s CLAUDE.md — no manual editing needed.
  3. To use the same agent memory in another Project, copy the relevant section from that CLAUDE.md and paste it in.
Going forward, use Publish & Remix to share and reuse configured workspaces.

​
Overview

An Agent is a custom AI persona with its own identity, memory, and skill set. The default agent is Happycapy. You can create additional agents for different workflows — a research assistant, a code reviewer, a writing partner — each with its own personality and context.

​
The Agent Files

Custom AI, your way

Own identity. Own memory. Own skills.

Agent configuration files
Each agent has a set of markdown files that define who it is:
  • SOUL.md — the agent’s core values and principles
  • USER.md — context about who it’s helping (you)
  • IDENTITY.md — the agent’s role and personality
  • MEMORY.md — persistent memory across sessions
  • AGENTS.md — the main instruction file that ties everything together
Every time you start a conversation, the agent reads these files in order — it knows who it is before it starts working.

​
Setting Up an Agent

You don’t need to write these files by hand. Create a new agent in Agents in the sidebar, start a new conversation, select that agent, and say: 
Help me set up this agent.
Happycapy will ask what you need, then generate all the configuration files for you. Describe the role, your preferences, and what you want it to remember — Happycapy handles the rest.

​
Model and Skills

In the Overview tab of each agent, pick a default model and attach installed skills. Different agents can use different models — Haiku for lightweight tasks, Opus for complex work. To switch agents during a conversation, use the agent selector in the input box.