Workspace

A workspace in Ptah is simply a project folder on disk — the root of a codebase you want agents to analyze, edit, and operate on. Opening a workspace is the first thing most users do after launching Ptah, and almost every other feature (chat, agents, plugins, git integration, MCP tools) is scoped to the active workspace.

Ptah treats workspaces as first-class context. When you open a folder, Ptah:

Indexes the file tree and makes it browsable in the sidebar.
Runs a multi-phase project analysis to detect your tech stack, conventions, and quality signals.
Loads per-workspace configuration from .claude/ and .ptah/.
Starts the real-time git watcher so branch, commit, and dirty state stay in sync.
Persists the selection so the next launch restores where you left off.

What’s in this section

Opening a workspace

Open a folder, switch between recent workspaces, or launch Ptah with a folder via the CLI.

File tree

Browse and expand the workspace file tree from the sidebar.

Project analysis

Tech stack detection, pattern recognition, quality metrics, and dependency scans.

Workspace intelligence

How Ptah auto-gathers context (structure, deps, recent files) and feeds it to agents.

Switching workspaces

Swap active workspace from the UI or a CLI argument.

Workspace restoration

Recover your previous session on app restart.

Workspace configuration

Per-workspace settings in .claude/ and .ptah/ — enabled plugins, custom agents, overrides.