Where Files Live

AgentOS has no database. Everything is a plain file you can read, back up or put under version control.

Global folder: ~/.agentos/

Shared by all workspaces and created on first run. On Windows, ~ is C:\Users\<you>.

Path	Purpose
server.json	Server settings: port, API key, heartbeat, proxy, Local UI Control, updates, Remote Control
agentos.json	Defaults such as the last-used model host and model
workspaces.json	Registry of workspaces and sidebar groups
CREDENTIALS.md	Credentials shared across workspaces (encrypted)
mcp-servers.json	Global MCP servers
license.json	Your signed license certificate
remote-control.json	This computer's Remote Control identity and paired phones
skills/ · tools/ · plugins/ · clis/	Global extensions for every workspace
tmp/	Temporary screenshots and UI snapshots
server.log	Server log

Workspace folder: <your-project>/.agentos/

Path	Purpose
BRAIN.md	Workspace identity, goals, preferences and trust level. Loaded into every request.
MODEL.md	Provider, model, host, context size and temperature
MEMORY.md · memories/	Conversation memory, organized by day
DURABLE.md	Lasting facts that survive compaction
CREDENTIALS.md	Workspace credentials (encrypted)
TODOS.md	Workspace todo list
DIALOGS.md	Question templates for open-ended requests
jobs.json	Job queue
history.json	Session history and activity
mcp-servers.json	Workspace MCP servers
agentos.json	Workspace metadata and optional password hash
skills/ · tools/ · plugins/ · clis/	Workspace extensions (override global and built-in)

Files you attach in chat are copied to <your-project>/uploads/.

Backing up

To back up an agent, copy its workspace's .agentos/ folder. To back up your whole setup, also copy ~/.agentos/. Keep backups somewhere safe, because they contain your conversations and encrypted credentials.