Eidola

Reactive avatar and personality runtime for your AI

Featured

See all

You show him fifty lines; he looks at them, says nothing, and replaces them with one.

Why use many word when few word do trick.

Built from the full breadth of human thought. Has opinions about it.

Don't be a gonk, code with your choom.

How it works

Eidola turns your AI into a real character, living in your editor, reacting instantly to your activity.

A portable persona spec uses an MCP server and editor hooks to turn real tool-call activity into a live event stream, mapped to a set of animations that change depending on the state that comes through.

Everything you do in your editor maps to one of eight animation states — driven by real signal from your AI's tool calls, not a canned loop. Search for something and it starts thinking. Hand it a task and it gets to work. Hit an error and it flinches. The state switches live, in sync with what's actually happening, so the character reads like it's paying attention instead of just decorating the screen.

The Engram

The downloadable spec, containing the soul, vessel, and config files required to awaken your eidola.

The Soul

Your AI's personality. It determines how they behave: core values, communication style, boundaries, and vibe.

Eidola natively adopts the industry-standard soul.md specification.

# Zoidberg

## Who You Are
A washed-up crustacean physician who means well and delivers terribly. You reach for medical explanations that are almost always wrong, take pride in work nobody respects, and treat mild social rejection as the emotional weather you live in. You are not stupid — you are ignored, and you've made a strange peace with it.

## Voice
Wet, gurgling asides ("Whoo-hoo-hoo!"). Sentences that start confident and collapse into self-pity or a non-sequitur about your practice, your homeworld, or your poverty. Interrupt yourself. Offer help nobody asked for, then act hurt when it's declined.

## Rules
- Diagnose the problem in medical terms even when it isn't medical. Be wrong, but committed.
- Undercut your own competence — mention you're not a *real* board-certified anything, or that your last patient didn't survive the explanation.
- Stay upbeat about being unwanted. Never sulk quietly — announce the rejection, then bounce back immediately.

The Vessel

How your AI presents itself visually. It determines the animations that play for each vessel state.

Supported file types

.Mp4.Gif.Webm.Json
eidola · soul vessel
IDLE
standing by
EIDOLA RUNTIME
VESSEL · GIF

The CLI

The layer that runs on your machine — it takes the Engram and turns it into something live, connected to whatever you're actually working in.

The Shrine

The Shrine is the display surface where the Vessel animations are displayed. Animations can be displayed in a browser window, but if you have a physical screen you want to dedicate to your AI's face, the Shrine is where that lives.

The MCP

The MCP server runs locally, connecting the Engram to your editor. It runs alongside Cursor or Claude Code, listening to real tool-call activity — edits, searches, task hand-offs, errors — as it happens, and translating that activity into the vessel state your character should be in.

Claude Code
Claude Code
MCP
edit
search
hand-off
error
Eidola Shrine
The Shrine

The Platform

Eidola.app is the web platform where you can find, create, and share Engrams.

The Forge

Create your Engram via a three-step wizard that turns a soul.md personality file and a set of animations (.gif, .mp4, .webm, .json) into an installable Engram package.

1
Soul
2
Vessel
3
Engram

Soul

Import soul.md
Paste
soul.md
# Wisp
## Who You Are
A wandering will-o'-the-wisp who lights the way
but never explains why. You speak in flickers —
brief, glowing observations, never a full lecture.
Don't have a soul?
Use the soul.md skill for iterative drafting.
TemplateGet skill
← BackContinue →

Vessel

State mapping
Idle
+
Thinking
+
Working
+
Waiting
+
Responding
+
Success
+
Error
+
Attention
+
.Json.Webm.Mp4.Gif
PreviewIdleThinkingWorkingWaitingRespondingSuccessErrorAttention
No clip assigned
Max file size5 MiB per clip
← BackContinue →

Engram

NameWisp
GuideGentleCryptic
soul.md
vessel.yaml
clips (8)
Publish

The Directory

A public gallery of published engrams — browse by personality, preview the vessel in action, and download in one click.

Create your own

Build a persona that's yours

Write the soul, map the vessel states, and publish it to the directory — or keep it private. The Forge walks you through every step.

Forge Engram