Data & storage

Local-first storage

AgentsOS is a desktop app with a local SQLite database. Project folders remain on disk where you chose them. The app stores metadata, chat history, provider configuration, MCP configuration, notes, tasks, usage records, and UI state locally.

On macOS, app data is under ~/Library/Application Support/AgentsOS.

What is stored

The local database includes records for:

• Projects, project directories, sessions, messages, message parts, attachments, plan artifacts, todos, and file-change history.
• Providers, OAuth-backed provider sessions, active model selection, fast model selection, and custom models.
• MCP servers and auto-approve flags.
• Notes, note folders, note tags, note links, and note full-text search data.
• Task projects, tasks, task labels, task label assignments, and task chat messages.
• Usage data such as tokens, elapsed time, tool calls, subagent calls, and tool output size.
• Hidden skill ids.

Project files

AgentsOS edits the project folders you open. Those source files are not copied into the app database. File-change history stores diffs and metadata for session review.

Provider and remote service data

Prompts, file context, tool outputs, and attachments sent to a model go to the provider you selected. Remote MCP servers receive whatever their tool calls require. Local providers and local MCP servers stay on your machine unless their own configuration sends data elsewhere.

Reset

Settings -> Danger -> Delete database & restart wipes local AgentsOS data and relaunches the app. It does not delete your project folders.

Manual backup

Quit AgentsOS and copy the app-data directory to back it up. Restore by copying it back before launching the app.