Ptah Documentation

A staffed team of AI agents that learns your architecture and ships production SaaS. Free, open source, and running on your own machine.

Start here

New to Ptah? Follow these three pages in order. They take you from download to a working agent roster.

Install Ptah — download the desktop app for Windows, macOS, or Linux.
Connect a provider — bring your own key for Claude, Copilot, Codex, Ollama, or any other supported provider.
Run the setup wizard — let Ptah analyze your repository and generate an agent roster tuned to your stack.

Chat with a real team

One conversation, many specialists. Ptah routes each slice of work to the right agent and shows you the whole execution tree. Chat →

Remember your architecture

Tiered memory with hybrid keyword and vector search. Decisions from last week still apply this week. Memory →

Learn from your own work

Skill Synthesis watches successful sessions and promotes repeated workflows into durable, reusable skills. Skill Synthesis →

Keep working while you sleep

Cron jobs run agents on a schedule. Telegram, Discord, and Slack let you approve a diff from your phone. Automation →

Providers Claude, Copilot, Codex, Ollama, OpenRouter, Moonshot, Z.AI, and more. Bring your own keys.

Agents The 14 built-in agents, custom agents, CLI helpers, and syncing your roster to other tools.

Orchestra Canvas Run up to nine chat sessions side by side on one drag-and-resize grid.

Project setup The Setup Hub, the setup wizard, the AI Team Builder, and new-project scaffolding.

Tasks board A six-column Kanban board over the task specifications in your workspace.

Tribunal Put several AI vendors on the same problem. Council, Forge, Race, Relay, and Crucible.

Workspace Opening a workspace, project analysis, the file tree, and workspace intelligence.

Sessions History, metadata, cost summaries, analytics, and importing your existing CLI transcripts.

Plugins & skills Enable the bundled plugin packs, toggle individual skills, or author your own.

MCP The built-in MCP server, Ptah's own tools, third-party servers, and driving Ptah over MCP.

Browser automation Navigate, click, type, read a page, capture screenshots, watch the network, record a run.

Git Status, diffs, commits, branch awareness, and worktrees.

Settings Global and workspace settings, API keys, autopilot, themes, import and export.

Troubleshooting Installation problems, provider errors, port conflicts, logs, and how to file a good bug.

Every local capability is free. Ptah is open source. Nothing on your own machine sits behind a paywall. See the tier comparison.
Your keys stay on your machine. Ptah never proxies your traffic through a service we control. See Providers.
These pages describe the desktop app by default. The same core also ships as a VS Code extension and a headless CLI.

VS Code extension The same engine inside your editor. Commands, shared state, and what is desktop-only.

Ptah CLI Headless Ptah for CI, scripts, and agent-to-agent bridges.

Reference File locations, keyboard shortcuts, CLI flags, the glossary, and the changelog.

Ask a question Report a bug or request a feature on GitHub.