Data storage

The data folder

Settings, encrypted keys, skills, MCP configuration, conversations, and logs live in the app’s data folder:

System	Path
macOS	~/Library/Application Support/PP Agent
Windows	%APPDATA%\PP Agent
Linux	~/.config/PP Agent

Set PP_AGENT_HOME to put the data somewhere else. This is useful for a server, a test profile, or a portable setup.

The workspace

The agent works in ~/Documents/PP Agent unless its agent has its own folder. Files you attach, files the agent creates, research reports, and generated documents live in the workspace.

Research reports are saved under a folder of their own:

<workspace>/research/<report>/
  report.md
  report.html

What is in the data folder

• Settings for the app, tools, models, agents, and channels.
• The vault with encrypted provider, search, and bot credentials. The master key is in the operating system keychain unless you set PP_AGENT_MASTER_KEY.
• Conversations, including tool calls and approvals.
• Skills you imported or wrote.
• MCP configuration for the servers you added.
• Logs for diagnosing a failed run.

Backups

• Back up the data folder to keep settings and history.
• Back up the workspaces that matter; they are ordinary folders.
• A backup of the vault without the keychain entry (or PP_AGENT_MASTER_KEY) will not decrypt the keys. Decide whether to include both.

Moving to another computer

1. Install PP Agent on the new computer.
2. Quit the app on both machines.
3. Copy the data folder and the workspaces.
4. If the master key is not in the new machine’s keychain, set PP_AGENT_MASTER_KEY before starting the app, or re-enter the provider keys.

Deleting data

Quitting the app does not delete anything. To remove everything, delete the data folder and the workspaces you created. Remove the keychain entry too if you want the encrypted vault unrecoverable.

Related: Security and privacy, Install.