File Locations
All paths below use absolute examples. Substitute <you> with your username.
User configuration
Section titled “User configuration”| Path | Purpose |
|---|---|
C:\Users\<you>\.ptah\settings.json (Win) / /Users/<you>/.ptah/settings.json (mac) / /home/<you>/.ptah/settings.json (Linux) | Global Ptah settings (incl. memory.*, skillSynthesis.*, cron.*, gateway.*) |
C:\Users\<you>\.ptah\plugins\ / /Users/<you>/.ptah/plugins/ / /home/<you>/.ptah/plugins/ | Installed plugins (downloaded at runtime) |
C:\Users\<you>\.ptah\templates\agents\ / /Users/<you>/.ptah/templates/agents/ / /home/<you>/.ptah/templates/agents/ | Installed agent templates (downloaded at runtime) |
C:\Users\<you>\.ptah\.content-cache.json / /Users/<you>/.ptah/.content-cache.json / /home/<you>/.ptah/.content-cache.json | Content cache metadata — the hash of the downloaded plugin + template set |
C:\Users\<you>\.ptah\skills\ / /Users/<you>/.ptah/skills/ / /home/<you>/.ptah/skills/ | Auto-promoted skills (<slug>/SKILL.md) from Skill Synthesis |
C:\Users\<you>\.ptah\user\ / /Users/<you>/.ptah/user/ / /home/<you>/.ptah/user/ | Harness user layer — the editable source for agents and skills (see below) |
C:\Users\<you>\.ptah\ptah.db / /Users/<you>/.ptah/ptah.db / /home/<you>/.ptah/ptah.db | Shared SQLite database — memory, skills, cron jobs, messaging bindings |
Claude Agent SDK assets
Section titled “Claude Agent SDK assets”| Path | Purpose |
|---|---|
C:\Users\<you>\.claude\agents\ / /Users/<you>/.claude/agents/ / /home/<you>/.claude/agents/ | User-wide custom agents |
C:\Users\<you>\.claude\skills\ / /Users/<you>/.claude/skills/ / /home/<you>/.claude/skills/ | User-wide skills |
C:\Users\<you>\.claude\projects\ / /Users/<you>/.claude/projects/ / /home/<you>/.claude/projects/ | Imported Claude Code session transcripts |
Electron user data
Section titled “Electron user data”The Electron user-data folder holds the app’s own cache, preferences, and window state.
| OS | Path |
|---|---|
| Windows | C:\Users\<you>\AppData\Roaming\Ptah\ |
| macOS | /Users/<you>/Library/Application Support/Ptah/ |
| Linux | /home/<you>/.config/Ptah/ |
| OS | Path |
|---|---|
| Windows | C:\Users\<you>\AppData\Roaming\Ptah\logs\ |
| macOS | /Users/<you>/Library/Logs/Ptah/ |
| Linux | /home/<you>/.config/Ptah/logs/ |
Workspace-local
Section titled “Workspace-local”These paths live inside each workspace folder:
| Path | Purpose |
|---|---|
<workspace>/.claude/agents/ | Project-scoped custom agents |
<workspace>/.claude/skills/ | Project-scoped skills |
<workspace>/.claude/settings.json | Committed workspace settings |
<workspace>/.claude/settings.local.json | Personal workspace settings (ignore in Git) |
<workspace>/.ptah/screenshots/ | Browser screenshots output |
<workspace>/.ptah/recordings/ | Browser GIF recordings output |
<workspace>/.ptah/specs/ | Orchestration task specifications |
<workspace>/.agents/skills/ | Skill copies for Codex and Antigravity |
<workspace>/.github/skills/ | Skill copies for Copilot |
<workspace>/.cursor/skills/ | Skill copies for Cursor |
The harness user layer
Section titled “The harness user layer”~/.ptah/user/ holds the one editable copy of your agents and skills. Ptah
reconciles that layer out to the harness directory of every AI tool it detects,
as real files rather than links. The workspace directories listed above are
derived copies, and Ptah adds them to .gitignore.
Edit the source in ~/.ptah/user/. An edit you make in a derived copy is
overwritten on the next reconcile.
Which plugins are enabled is not stored in your workspace folder. Ptah keeps that selection — enabled plugins, disabled plugins, and disabled skills — in its own per-workspace state storage, so there is nothing to commit and nothing to edit by hand. Change it from the plugin configuration screen instead.
| OS | Path |
|---|---|
| Windows | C:\Users\<you>\AppData\Roaming\Ptah\Cache\ |
| macOS | /Users/<you>/Library/Caches/Ptah/ |
| Linux | /home/<you>/.cache/Ptah/ |
Safe to delete when reclaiming disk space; Ptah rebuilds what it needs on next launch.