by pandazki
Co-creation infrastructure for humans and code agents — visual environment, skills, continuous learning, and distribution.
# Add to your Claude Code skills
git clone https://github.com/pandazki/pneuma-skillsGuides for using ai agents skills like pneuma-skills.
No comments yet. Be the first to share your thoughts!
"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.
| Pillar | What it does |
|--------|-------------|
| Visual Environment | Agent works directly in files on disk — its native surface. Viewers are live players for agent output rendered in domain terms, with optional human participation directly in the UI. |
| Skills | Domain-specific knowledge and seed templates injected per mode. Sessions persist across runs — the agent picks up where it left off |
| User Preferences | The agent builds and maintains a persistent portrait of your aesthetics, collaboration style, and per-mode habits — preferences survive across sessions, workspaces, and modes |
| Continuous Learning | Evolution Agent mines conversation history to extract preferences, then augments skills with learned knowledge |
| Distribution | Build custom modes with AI via Mode Maker, publish to the marketplace, share with pneuma mode add |
| Mode | What it does | Version |
|------|-------------|---------|
| webcraft | Live web development with Impeccable AI design intelligence — 22 design commands, brand vs product register, responsive preview, export | 2.37.0 |
| clipcraft | AI-orchestrated video production on @pneuma-craft — assets, composition with tracks/clips, provenance DAG, scenes; canvas preview + 3D timeline + dive panels; image / video / TTS / BGM generation scripts | 2.38.0 |
| kami | Paper-canvas typesetting — locked paper size (A4/A5/A3/Letter/Legal × portrait/landscape), Scroll / Focus / Book views, fit-discipline feedback loop, PDF / PNG / HTML export. Design language adapted from tw93/kami | 2.31.0 |
| slide | HTML presentations — content sets, drag-reorder, presenter mode, PDF/image export. Skill design guidelines informed by frontend-slides | 2.18.0 |
| doc | Markdown documents with live preview — the simplest mode, a minimal example of the mode system | 2.29.0 |
| draw | Diagrams and visual thinking on an Excalidraw canvas | 2.29.0 |
| diagram | Professional draw.io diagrams — flowcharts, architecture, UML, ER, with streaming render and sketch style | 2.27.0 |
| illustrate | AI illustration studio — generate and curate visual assets on a row-based canvas with content sets | 2.29.0 |
| remotion | Code-driven video composition on Remotion — live preview, frame-perfect animation, MP4/WebM export via WebCodecs | 2.29.0 |
| gridboard | Interactive dashboards — draggable tile grid on a fixed canvas, JIT-compiled React tiles via defineTile(), agent-driven redesign on resize | 2.29.0 |
| mode-maker | Create custom modes with AI — fork, play-test, publish | 2.35.0 |
| evolve | Evolution Agent — analyze history, propose skill improvements, apply/rollback | 2.25.0 |
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 image-gen API key is configured; otherwise the report still renders, just without the gift.
Prefer to set things up by hand? The Create Project dialog's chevron menu offers Create without discovery — you can still trigger discovery later via ProjectPanel's Re-discover affordance.
Download the latest release for your platform:
| Platform | Download |
|----------|----------|
| macOS (Apple Silicon) | .dmg |
| Windows x64 | .exe installer |
| Windows ARM64 | .exe installer |
| Linux x64 | .AppImage / .deb |
The desktop app bundles Bun — no runtime install needed. Install Claude Code CLI and you're ready to go. The launcher shows available backends — currently Claude Code, Codex, and Moonshot Kimi are implemented.
# Prerequisites: Bun >= 1.3.5, plus one or more of: Claude Code CLI, Codex CLI, Kimi CLI
# Open the Launcher (marketplace UI)
bunx pneuma-skills
# Start a mode with a fresh workspace
bunx pneuma-skills slide --workspace ./my-first-pneuma-slide
# Explicit backend selection at startup
bunx pneuma-skills doc --backend claude-code
# Or use the current directory
bunx pneuma-skills doc
git clone https://github.com/pandazki/pneuma-skills.git
cd pneuma-skills
bun install
bun run dev doc --workspace ~/my-notes
pneuma-skills [mode] [options]
Modes:
(no argument) Open the Launcher (marketplace UI)
webcraft Web design with Impeccable.style
clipcraft AI-orchestrated video production
kami Paper-canvas typesetting
slide HTML presentations
doc Markdown with live preview
draw Excalidraw canvas
diagram draw.io diagrams
illustrate AI illustration studio
remotion Code-driven video composition
gridboard Interactive tile dashboards
mode-maker Create custom modes with AI
evolve Launch the Evolution Agent