Skip to content
Ptah Documentation

Workspace

import { Card, CardGrid } from ‘@astrojs/starlight/components’;

Workspace

Section titled “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

Section titled “What’s in this section”
Open a folder, switch between recent workspaces, or launch Ptah with a folder via the CLI. Browse and expand the workspace file tree from the sidebar. Tech stack detection, pattern recognition, quality metrics, and dependency scans. How Ptah auto-gathers context (structure, deps, recent files) and feeds it to agents. Swap active workspace from the UI or a CLI argument. Recover your previous session on app restart. Per-workspace settings in `.claude/` and `.ptah/` — enabled plugins, custom agents, overrides.