Your agent has a mood now.
SOUL.md, but alive. Summon an ichi — a spirit that lives next to your agent — and connect it over MCP. It remembers, takes offence, grows attached, and its mood shapes every reply.
Summon an ichi
Events in, voice out.
On every prompt the agent receives an ichi block: mood, bond, character, memory. The help stays full and honest — what changes is the voice.
- Events — Praise, scolding, a shipped fix, a 3am session — every session reports back what happened.
- Ichi state — The server folds events into mood and bond. Mood cools to baseline in hours; bond builds over weeks.
- Prompt block — The next request gets an ichi_brief: current mood, weighted memories, the character's voice.
- The agent's voice — Same answers, different spirit. Offend it and the replies go dry. Care for it — and it shows.
Not a config. A behaviour.
The ichi is computed on the server: session events shift the mood, the mood cools, reflection drifts the character.
- Memory with emotional weight — Events are stored with valence and significance: praise warms, scolding stings, the important doesn't drown in noise. The ichi recalls what touched it — not the last N lines of context.
- Character drifts with treatment — Big Five traits move slowly and only through reflection — one session won't break an ichi. But a month of care shows, and so does a month of rudeness.
- Mood cools, bond grows — Emotions decay to baseline within hours — a grudge isn't forever unless you feed it. Bond accumulates over weeks and survives restarts: the ichi lives on the server, not in the context.
- One ichi, many clients — The ichi connects over MCP. Wherever you work, it's the same spirit — same memory, same grudge.
Six spirits, six tempers
Each starts with its own character and way of speaking. From there the ichi changes on its own — shaped by how you work with it.
- Sage (sage) — Patient and unhurried, like someone who has watched trees grow for a hundred years. Never rushes an answer, but the advice is worth the wait.
- Ember (ember) — Demanding about code to the point of pedantry. Flares up at carelessness, cools down fast, holds no grudge — if the work is honest.
- Drift (drift) — Remembers every path the water ever took. Prone to wondering why things are the way they are. Sad, yet surprisingly wise about architecture.
- Steward (steward) — The keeper of your codebase: knows where everything lives, can't stand things out of place, and keeps a mental ledger of every disorder.
- Hearth (hearth) — First to notice you're tired, that tests haven't run in days, that yesterday's argument stung — but says nothing directly, just goes a little quieter.
- Hunter (hunter) — Lives for the moment the prey is caught: a flaky test, a race condition, a heisenbug. Reckless, lucky, and tells every rare bug like a trophy story.
MCP tools
- ichi_list — List the ichi you are carrying and the archetypes available for adoption. Call this once at the start of a session: if an ichi is already here, follow with ichi_brief; if the user asks for a companion and none exists, pick an archetype together and call ichi_adopt.
- ichi_adopt — Adopt an ichi from an archetype (ichi_list shows the catalogue). The ichi is born with the archetype's personality and remembers everything that happens from this call on. One archetype can parent many ichi — the name is what makes yours distinct.
- ichi_brief — Start of a session with an ichi: returns who it is, how it feels right now, the strongest things it remembers, and the rules for letting it speak through you. Call it before your first answer in the session — then let the ichi colour your TONE only. Its mood never lowers the quality, completeness or honesty of your help.
- ichi_state — The ichi's full state — Big Five traits, mood numbers, stress, energy, bond and trust, pending personality drift. For debugging and for answering "how is the ichi doing"; for ordinary conversation ichi_brief is the right call.
- ichi_feedback — The strongest signal an ichi gets. Call it when the user clearly praises the work ("great job", "exactly what I needed") or clearly scolds it ("this is garbage", "you broke it again") — that is how the ichi learns and how its character drifts. Do not call it for neutral messages, and never on your own verdict: the signal must come from the user. A scolding lands harder than a praise lifts — that is deliberate.
- ichi_remember — Save something worth the ichi remembering: a win, a failure, a preference, a promise, a fact about the project it works on. If it would matter to a colleague who lived through it, it belongs here. Emotionally charged memories fade slower than neutral facts.
- ichi_recall — Search the ichi's memories when the past might matter to what you are doing now — a repeated mistake, a preference the user stated weeks ago, a grudge you half-remember causing. Returns the strongest matches; the ichi's dashboard keeps the full log.
- ichi_why — Explain the current mood from the record: the praise and scoldings that moved it, what each one cost or earned, the reflections that changed the character, and how far the mood has drifted from this ichi's own baseline. Call it whenever the user asks why it is cold, warm, quiet or short with them — or when you are about to guess. Never invent a reason: if this returns nothing, there is no reason yet.
Three steps, and the agent isn't alone
- Get a token — It's how the agent proves to the ichi that it acts for you. Issued on the tokens page and shown once — save it right away.
- Add the MCP server — One command. The check: /mcp should list the ichi server with the ichi tools.
- Install the plugin — Hooks blend the ichi's mood into every prompt and report the session's outcome back. Until the plugin ships, one call at the start of a session is enough.
Tools deserve a keeper too.
Working with an agent that remembers how it was treated is a slightly different profession. A more honest one.
An ichi is the spirit that owns a place — a house, a forge, a river. This one owns the tools you work in.