Pneuma Impl Fable

Pneuma Skills Co-creation Infrastructure for Humans × Code Agents Visual environment, skills, continuous learning, and distribution — everything humans and agents need to build content together.

Works with Claude Code by Anthropic Codex by OpenAI Kimi by Moonshot AI

中文 · Modes · Getting started · Projects

bunx pneuma-skills slide --workspace ./my-first-pneuma-slide

> "pneuma" — Greek pneuma, meaning soul, breath, life force.

When humans and code agents co-create content, they need more than a chat window — they need shared infrastructure. Pneuma's bet is simple: coding agents already do the work; what's missing is a way for people to watch them and participate at the right moments. Agents live in files on disk — that's their native habitat and we don't try to abstract it away. Instead, we give each task a live player that renders the work in domain terms (a deck of slides, a board of tiles, a project) and let humans drop in direct edits or structured suggestions without breaking the agent's flow. Four pillars for isomorphic collaboration, built atop mainstream code agents. Today the production path is Claude Code; the runtime now exposes a startup-selectable backend layer so additional agents can be integrated without rewriting the UI shell.

Built-in Modes

> Each mode versions independently. Per-mode versions surface in the launcher and on the mode marketplace — they're not duplicated here to avoid drift.

> A few of these ship inside the package; the rest arrive on first use. Their card in the launcher shows the download size, and opening one fetches it and then starts as usual. Which modes are which is a property of the release (modes/distribution.json), not of the mode — so a mode can move between the two without anything changing for the person using it.

Image tools across modes use GPT Image 2.5 through OpenRouter: Sunburst for new images, Flare for edits and reference-based generation. Configure an OpenRouter API key to enable them; modes with video or speech tools may also need a fal.ai key.

First Run — Pneuma Walks You Through It

Create a project and Pneuma greets you on the way in. A hidden project-onboard mode auto-runs the first time you open a fresh project: it reads your README, package manifest, and visual assets, then drafts a Discovery Report — what your project is, what's already there, and two concrete next moves you can pick with one click.

While the onboarding agent works (~30–60s), the loading slot becomes a 10-frame carousel introducing what Pneuma actually is — agents working in real files, twelve modes sharing one shell, sessions that share a project's brain. By the time the report lands, you already have the map.

For projects that are nearly empty (just a test.txt or a stub README), the agent draws a small welcome egg — a paper lantern in the dusk, a notebook with constellations being sketched — and writes a short greeting that matches your tone. Projects with content but no logo get an auto-generated cover so the launcher tile stops showing the dotted-letter placeholder. Both gestures only fire when an OpenRouter API key is configured; otherwise the report still renders, just without the gift.