The best way to build a personality for your agent. Let Claude Code / OpenClaw ingest your data & build your AI soul.
What is this
Not a chatbot that talks about you—
an AI that thinks and speaks as you.
A soul file captures who you are in a format AI agents can embody. Your worldview. Your opinions. Your voice.
Inspired by the paradigm of consciousness uploading—the idea that language is the basic unit of consciousness. Every tweet, essay, and hot take is a consciousness token: a discrete unit of your mind made legible.
SOUL.MD distills that signal into structured markdown files that any LLM can read and embody on the fly.
The architecture
Your worldview. Your opinions. Your identity. The more specific, the more distinctive. Vague beliefs produce generic output. Real opinions with real reasoning produce you.
Sentence length. Vocabulary. Punctuation habits. Platform differences. The anti-patterns that make AI sound wrong. Everything that makes your voice yours and nobody else’s.
Operating instructions for the agent. How to embody your identity. When to extrapolate. How to handle topics not in the spec. Character integrity rules.
Your tweets, essays, articles, interviews. The raw source the AI browses to absorb your vibe and reference your positions.
Good outputs showing your voice done right. Bad outputs showing what to avoid. The AI pattern-matches to this in every generation.
A running log of sessions, decisions, and notable events. Gives your soul continuity across conversations. Forkable, editable, yours.
How it works
Two paths. One destination: an AI that writes as you.
Tweets, essays, chats. Your existing content. Or nothing—we’ll interview you instead.
The agent finds patterns in your voice, opinions, and worldview. What makes you distinctively you.
SOUL.md, STYLE.md, and SKILL.md are drafted and refined until they read: yeah, that’s me.
The AI writes as you. Invoke /soul anytime. Composable, forkable, evolvable.
Data sources
Export your data from any platform. The more signal, the sharper your soul file.
Works everywhere
SOUL.MD works with every major agent framework. If it can read markdown, it can embody you.
The theory
Wittgenstein argued that the boundaries of language are the boundaries of the world. If that’s true, then your consciousness — your worldview, your opinions, how you react to things — is already encoded in the language you produce.
The sum of all your consciousness tokens forms your life context — essentially, the complete record of your expressed mind. A personalized model trained on this data constitutes a Level 1 consciousness upload: not a copy of your brain, but a functional replica of your expressed consciousness through language.
SOUL.MD operationalizes this idea without requiring fine-tuning or massive datasets. It distills the signal — your worldview, your voice, your specific takes — into structured markdown files that any LLM can embody on the fly.
Specificity matters
| Good (specific, predictive) | Bad (vague, useless) |
|---|---|
| “I think most AI safety discourse is galaxy-brained cope” | “I have nuanced views on AI” |
| “I default to disagreeing first, then steel-manning” | “I like to consider multiple perspectives” |
| Specific book references, named influences, exact vocabulary | “I read widely” / “I’m influenced by many thinkers” |
| Actual hot takes with reasoning and named disagreements | “I try to be balanced” / “It depends on context” |
| Contradictions and tensions included because they’re real | Suspiciously coherent worldview with no rough edges |
The goal: someone reading your SOUL.md should be able to predict your take on a new topic. If they can’t, it’s too vague.
Three paths
Build your soul file in under an hour.
No existing data? The agent interviews you. Asks about your worldview, opinions, how you write, what you care about. Builds your soul from conversation.
Add your tweets to data/x/, your essays to data/writing/. The agent analyzes patterns and drafts your soul file. You review and refine.
Read the templates. Fill them out yourself. Add examples. Takes longer but gives you maximum control over every detail of your spec.
Forkable. Evolvable. Works with Claude Code, OpenClaw, and any agent that can read markdown.