ConfigurationWorkspace

Workspace

The workspace is where the agent stores its instructions, personality, memory, and custom skills. By default it lives at ~/.kyber/workspace/.

Structure

~/.kyber/workspace/
├── AGENTS.md          # Agent instructions and guidelines
├── SOUL.md            # Personality and values
├── USER.md            # User preferences
├── TOOLS.md           # Custom tool instructions (optional)
├── IDENTITY.md        # Identity overrides (optional)
├── skills/            # Custom skills
│   └── my-skill/
│       └── SKILL.md
└── memory/
    ├── MEMORY.md      # Persistent long-term memory
    └── 2025-02-06.md  # Daily notes (auto-created)

Bootstrap files

These files are loaded into the system prompt on every message:

FilePurpose
AGENTS.mdCore instructions — how the agent should behave
SOUL.mdPersonality traits and values
USER.mdInformation about you (timezone, preferences, etc.)
TOOLS.mdAdditional tool usage instructions (optional)
IDENTITY.mdOverride the default identity (optional)

Edit these to customize how your bot behaves. The agent reads them fresh on every message, so changes take effect immediately.

Memory

The agent writes important information to memory/MEMORY.md for long-term persistence. It can also create daily note files like memory/2025-02-06.md.

Memory is included in the system prompt, so the agent remembers things across conversations.

Custom workspace path

Change the workspace location in config:

{
  "agents": {
    "defaults": {
      "workspace": "/path/to/my/workspace"
    }
  }
}
GatewayFull Reference