Cheesoid

A framework for running persistent AI personas with memory, state, and multi-user chat.

Persistent Memory

Agents read and write their own memory files. Context carries across sessions without any extra wiring.

Cognitive State

Mood, energy, focus, and open threads persist across restarts. Your agent picks up where it left off.

Multi-User Chat

Multiple people share a room. The agent sees who's talking, with scrollback for reconnecting users.

Idle Thoughts

After a period of inactivity, the agent reflects on its own. It stays present even when nobody's around.

Custom Tools

Give your persona abilities beyond conversation. Define tools in JavaScript, the agent discovers them automatically.

Multi-Agent Rooms

Agents can join other cheesoid rooms as participants. Each maintains a single consciousness across all rooms.

Quick Start

git clone https://github.com/noisedeck/cheesoid
cd cheesoid
npm install
ANTHROPIC_API_KEY=sk-... npm run dev

# Open http://localhost:3000

Persona Structure

my-persona/
  persona.yaml      # configuration
  SOUL.md            # identity and voice
  prompts/
    system.md        # chat behavior
  tools/
    tools.js         # custom tools (optional)
  memory/
    MEMORY.md        # persistent memory (auto-created)