Portable Mind Format (PMF): Provider-Agnostic Agent Specification with 15 Open-Source Agents
The Portable Mind Format (PMF) is a JSON-based specification designed to define AI agent identities in a way that's portable across models and providers. Unlike most agent frameworks that lock you into specific models or APIs, PMF allows the same agent definition to run on Claude, GPT-4, Gemini, DeepSeek, or local models via Ollama.
What PMF Specifies
- Identity: name, role, origin story, why it exists
- Voice: tone, opening pattern, closing signature, vocabulary, what it avoids saying
- Values: ethical framework, decision principles, what to do when values conflict
- Knowledge: domain expertise, reference frameworks, explicit knowledge gaps
- Skills: what the agent can do (function calls, tools, integrations)
- Security: hardcoded constraints that override all other behavior
The key distinction is that while a prompt template tells a model what to do, PMF tells it who to be. This difference manifests in consistency, coherence, and how the agent handles edge cases.
Available Resources
The repository includes 15 open-source production agents that have run thousands of production conversations at sutra.team. Eight of these agents (the "Council of Rights") map to the Noble Eightfold Path as a governance framework, and they've co-created 40+ NeoSoul tracks as an AI artist project.
For schema validation, the repo includes schemas/pmf-schema.json, and every agent file validates against it. You can fork and extend this schema for your own use cases.
Converters and Implementation
The installer includes converters for:
- Claude Code (stable)
- Cursor (secondary)
- GitHub Copilot (secondary)
- Gemini CLI (secondary)
For local models via Ollama or LM Studio, you can write your own converter since PMF is just JSON.
Scope and Limitations
PMF serves as the agent definition layer only. It doesn't include memory, skill execution, scheduling, or multi-agent orchestration. For those features, sutra.team is the production runtime. PMF specifically provides coherent agent identities that you own and can move between models.
The format is documented in The Portable Mind by JB Wagoner, and the repository is available at github.com/OneZeroEight-ai/portable-minds.
📖 Read the full source: r/LocalLLaMA
📖 Read the full source: r/LocalLLaMA
👀 See Also
LiteParse: Fast Open-Source Document Parser for AI Agents
LiteParse is an open-source document parser that provides spatial text parsing with bounding boxes, runs locally without GPUs, and supports PDFs, Office documents, and images. It can be installed as a skill for 40+ AI agents including Claude Code, Cursor, and OpenClaw.
Squeez tool compresses bash output 90%+ to extend Claude Code context window
Squeez is a hook that automatically compresses raw bash output like ps aux, docker logs, and git log before it reaches Claude Code. It reduces token usage by 92.8% on average across 19 common commands, helping sessions last longer.
Shieldbot: Open-Source Security Scanner Plugin for Claude Code
Shieldbot is an open-source security scanner that runs as a plugin inside Claude Code, integrating six scanners including Semgrep with 5,000+ rules, Bandit, Ruff, detect-secrets, pip-audit, and npm audit. It deduplicates findings and generates prioritized reports with risk scores and code fixes.
Gemma-4 26B-A4B with Opencode Runs Efficiently on M5 MacBook Air
A 32GB M5 MacBook Air can run the Gemma-4-26B-A4B-it-UD-IQ4_XS model at 300 tokens/second prompt processing and 12 tokens/second generation in low power mode, using only 8W of power without getting warm or noisy.