Practical overview
When it fits
Use Pragma when an AI workflow needs more structure than a single prompt and should remain portable across execution environments, models, or supported harnesses.
Who it is for
- Developers building multi-agent applications.
- Teams packaging repeatable AI workflows across models or harnesses.
- Builders who need shared context, memory, skills, tools, or human review checkpoints in agent workflows.
Documented uses
- Define reusable agent teams with experts, tools, skills, flows, and review checkpoints.
- Coordinate multi-step work across models and supported agent harnesses.
- Run the same team through desktop or command-line interfaces.
- Package shared context and memory for reuse across missions.
- Embed an agent team in a custom AI system through the SDK.
Requirements & limits
Pragma is public open-source software under the AGPL-3.0 license and is identified as preview software. The documented desktop release provides macOS Apple Silicon and Intel builds. Source builds require Node.js 22 or later and pnpm 10.12.1.
- Choose it when agent teams, rather than individual prompts, are the unit you need to define and reuse.
- Its TypeScript implementation and YAML DSL matter for developers selecting a buildable framework.
- Desktop and CLI execution are documented separately from SDK embedding, so the intended integration route affects setup.
- Codex and Claude Code support is described, but the supplied documentation does not specify detailed integration steps or feature limits.
- Memory and context storage use extensible Host adapters, with several repository-provided implementations.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Build Pragma Desktop from source
Prepare and start a development build of the Pragma desktop application.
Before you start
- A cloned copy of the public Pragma repository.
- Node.js 22 or later.
- pnpm 10.12.1.
Steps
Clone the repository and change into its directory.
Install dependencies with the repository's frozen lockfile.
Start the desktop development build with the documented pnpm filter command.
Expected outcome
A development build of Pragma Desktop is started from the source repository.
Guide limitations
- This documents setup and starting the development build, not a production packaging process.
- Development builds use ~/.pragma-development/ by default.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 3 October 2026
- Original website title
- pqpo/pragma · Official homepage title · retained in its source language

