Managing Plugins

Plugins evolve independently of the Ptah desktop app. The Installed tab of the Plugins panel gives you full control over what’s cached on disk and which version is active.

Updating a plugin

Ptah checks content-manifest.json on every app launch and surfaces updates in the Plugins panel.

Open Plugins → Installed.
Plugins with available updates show an Update badge.
Click Update to download the new version.

Auto-update

Enable automatic background updates in Settings → Plugins:

{
  "plugins.autoUpdate": true,
  "plugins.checkInterval": "24h"
}

Refreshing the marketplace

If the marketplace list looks stale (new plugin just released, or you know the manifest changed), trigger a manual refresh:

Plugins panel → ⟳ Refresh, or
Command palette → Ptah: Refresh Plugin Marketplace

This re-fetches the manifest from GitHub and re-indexes local plugins.

Uninstalling a plugin

Uninstall removes the plugin from disk entirely:

Open Plugins → Installed.
Click the ⋯ menu on the plugin row.
Select Uninstall.

Ptah deletes:

~/.ptah/plugins/<plugin-name>/
Any skill junctions under every workspace’s .claude/skills/
The plugin entry from workspace-settings files on next load

Rolling back to a previous version

Ptah keeps the last two versions of each plugin under ~/.ptah/plugins/<plugin-name>/.versions/. To roll back:

Open the plugin detail view.
Click Version history.
Select a previous version and click Use this version.

Clearing the plugin cache

If the plugin cache becomes corrupted (rare), clear it from the command palette:

Ptah: Clear Plugin Cache — deletes ~/.ptah/plugins/ and re-downloads enabled plugins on next launch.