> ## Documentation Index
> Fetch the complete documentation index at: https://aitextura.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Personality and Memory
> Your agent's character and everything it remembers about you are plain text files. What each one holds, what's worth adding by hand, and how nightly memory processing works.
Your agent behaves the way its files say — and you can open and rewrite those files. There's no black box: the **Personality** tab shows a list of documents on the left and a plain-text editor on the right.
Below the editor are the **Save** button and a note: changes take effect immediately, the agent reads them in new conversations, and no restart is needed.
## Character
Five documents describe who the agent is and how it works.
| Document | What it controls | What goes in it |
| --------------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **Soul** | Character: how it talks, what matters to it, and what it won't do. Reread at the start of every new conversation | Filled in from the role when the agent is created. Edit it when the agent's actual job changes |
| **Personality** | Profile card: name, manner, mood | Filled in during the [first conversation](/en/agents/first-run), when you pick the agent's name |
| **Rules** | Working rules: what it can do on its own and what requires asking you first | The key document for security. This is where restrictions live |
| **About You** | What the agent knows about you: how to address you, language, time zone, what you do | Keep adding to it — the agent will work more accurately |
| **Tool Notes** | The agent's own notes on what's connected and how to use it in your setup | Usually maintained by the agent; it helps to add non-standard paths and addresses |
This is the **Soul** the platform wrote for the "Automator" role: who it is, what it does on first run, which files it maintains. This is the same role you chose in the setup wizard — plain text you're free to rewrite.
## Memory
Four documents where the agent's work accumulates. The first two are long-term; the agent maintains the rest as it goes.
| Document | What's inside |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Long-Term Memory** | What the agent has committed to memory. You can add to it yourself — the agent reads important facts about your business the next time it checks its memory |
| **Dream Journal** | What the agent reflected on overnight and moved into long-term memory while you were away |
| `ONBOARDING.md` | The first-meeting script. The agent follows it step by step and then deletes it — if the file is gone, onboarding is complete |
| `TASKS.md` | Automation catalog: what it does → where the script lives → how to run it → schedule |
| `WORKING.md` | Work log: in progress, plan, done. The only file the agent rewrites in full; it appends to all the others |
`TASKS.md` is the most useful file for you, not the agent. It lists everything you've automated and how each piece runs: open it a month from now and you'll understand your own setup without asking the agent.
## Nightly processing
A separate item under the Memory section opens the **Background Self-Improvement** panel. While you're away, the agent rereads the day's conversations, pulls out what matters, and moves it into long-term memory — from the **Dream Journal** into **Long-Term Memory**.
For a new agent, the panel is empty: no nights have passed yet. Check it when the agent starts forgetting agreements — you'll see what it considered important and what it lost.
## What to add yourself
The agent writes its own files, but three things are safer to enter by hand — they shouldn't depend on what the agent decided was important.
| Document | What to add |
| -------------------- | ------------------------------------------------------------------------------------------------- |
| **Rules** | What it must not do without asking: message people, publish, delete files, spend money |
| **About You** | Your time zone, how to address you, what your business does, who your customers are |
| **Long-Term Memory** | Permanent facts: company details, project names, colleagues' names, links to working spreadsheets |
Anything said only in chat lasts until the history is compressed — long conversations get condensed and details disappear. Any agreement you can't afford to lose belongs in a file.
## FAQ
No. Changes are picked up in new conversations. If an edit didn't take effect, start a new conversation: the current one still holds the old version.
Working memory is finite, and long conversations get compressed — details are lost in the process. Add the fact to **Long-Term Memory** by hand. Also check that the **Memory** ability is enabled under [Abilities](/en/agents/skills).
Check **Long-Term Memory** and the **Dream Journal**: a wrong conclusion may have landed there during nightly processing and is now treated as true. Delete the incorrect line — you fix this by editing the file, not by arguing in chat.
The **Personality** document holds the name, manner, and mood. The **Soul** document holds what matters to the agent and what it won't do. Change tone in the first, behavior in the second.
Yes, the agent understands both. Avoid mixing languages within one document — it muddles the workflow itself, not the agent's understanding of the words.
No. Some documents are empty for a new agent: **Personality**, **Rules**, and **About You** are filled in during the first conversation or by you. An empty document shows the hint "Describe what the agent should be like — in plain text or Markdown."
## Advanced
You don't need this to get started.
Documents support Markdown: `##` headings, lists, bold text. This helps the agent — it uses headings to find the right section without rereading the whole file. Keep one topic per document: rules in one place, facts about you in another.
It's a log of current work, not an archive: "in progress," "plan," "done." If the agent only appended to it, the file would keep growing and eat up memory. The agent appends to all the other documents.
Yes, the [Files](/en/agents/files) tab shows them as regular container files alongside everything else. The **Personality** tab is a showcase for the documents you edit most often.
You can control what condenses long conversations: the [Models](/en/agents/models) section has a dedicated **History Compression** slot. This model needs precision more than intelligence — but one that's too weak loses more details.
## What's next
What the agent is allowed to do and which skills it has installed
The agent's entire working environment
Separate personas with their own character inside the agent
What the agent thinks with and what compresses its history