Skip to main content

​
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.