Core Concepts
The Agent's Workspace
Your agent's mind is a simple and transparent collection of text files that you can view and edit.
Every Nimrobo agent has a "mind" called the Workspace. This isn't a complex database; it's a simple and transparent folder of text files that you can view and edit. This folder is your agent's home—the single source of truth for its identity, memory, and personality.
Key files in the Workspace include:
SOUL.md— Defines your agent's core personality, tone, and behavioral rules. This file controls its "vibe." Is it a witty assistant? A formal, professional one? You decide.MEMORY.md— This is your agent's curated long-term memory. While daily notes are kept in separate, dated files, this is where your agent stores core facts, key decisions, and user preferences to be recalled across all conversations.USER.md— A profile your agent keeps about you. It helps the agent remember how you like to be addressed, your timezone, and other key details to make your interactions feel more personal and efficient.
The Workspace gives you an unprecedented level of control and transparency. You can directly shape your agent's personality and see exactly what it "knows."