The Workspace.

The workspace is the persistent memory home of your agent. It is a set of markdown files stored in the workspace_files table, loaded on every conversation to give the agent full business context.

CONSTITUTION.md

Defines the agent's values, hard limits, and decision-making principles. Example: "Never promise a discount above 20% without manager approval." The agent treats this as inviolable — it will refuse instructions that contradict it.

IDENTITY.md

Defines the agent's name, personality, communication style, and role. Example: "You are Alex, a direct and confident sales closer. You speak in short sentences. You never use filler words." This shapes every response.

NOW.md

The agent's current priorities and active context. Updated automatically after each conversation. Example: "Current focus: Q2 outreach campaign. 47 leads in pipeline. Follow up with Acme Corp by Friday." The agent references this to stay on task.

THREADS.md

Open tasks and ongoing work streams. The agent updates this as it completes tasks and opens new ones. Gives continuity across sessions — the agent picks up exactly where it left off.

RECENT.md

A rolling log of the last 10-20 significant events. Auto-updated by the memory consolidation process. Prevents the agent from repeating itself or forgetting recent context.

API access

Workspace files are managed via GET/POST/PUT /api/workspace. The endpoint returns all active files for a userId, creates new files, and updates existing ones. Files are scoped by userId and optionally by companyId for team workspaces.