Product Brief · Pneuma Skills

Co-creation infrastructure for humans and code agents.

Agents do the work against a directory of files. The system's job is to make human observation and optional participation intuitive.
v2.31.0
MIT · open source
2026.04.22
11
built-in modes
4
design pillars
2
agent backends
MIT
self-host or desktop

Pneuma is a workspace where coding agents edit files directly and humans watch the work happen. Files stay the canonical collaboration surface — not abstracted away. Viewers are live players for agent output (a deck, a board, a paper), so humans can intervene in the UI when it matters and stay out of the way the rest of the time.

Four pillars

The whole product surface composes from four orthogonal ideas.

  • Visual environment — live players for agent output with optional human participation
  • Skills — domain knowledge + seed templates + session persistence per mode
  • Continuous learning — an evolution agent extracts preferences across sessions
  • Distribution — marketplace, publishing, forking a mode like a fork of a repo

Product principles

Three non-obvious calls that shape every choice in the codebase.

  • The agent edits files; the viewer renders them. No state hidden from the filesystem.
  • Each mode declares its own viewer + skill. The runtime is a shell, not a monolith.
  • Backends (Claude Code, Codex) plug in through a normalized protocol. Swap at startup, not mid-session.

What ships today11 built-in modes across three axes

"Files remain the canonical collaboration surface and are not abstracted away." — the line we keep coming back to when designing anything new. A mode earns its viewer by rendering what's on disk, not by adding a database.