# viv

Makes Claude fluent in Viv, the system for building simulated worlds where stories grow out of what characters do.

- plugin · `type=plugin` · Claude Code · ★ 39
- Author: siftystudio
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/siftystudio/viv/tree/HEAD/plugins/claude
- Updated: 2026-09-05
- HTML: https://affpapa.org/en/nevibecode/plugins/viv

## What it does

The plugin keeps a local, synced copy of the Viv codebase — language reference, compiler source, runtime source. Bundled commands let Claude search that copy whenever a question comes up, so answers rest on the actual code rather than guesswork.

The skills cover the whole loop. `/viv:setup` installs the compiler and runtime and configures your environment. `/viv:write` turns a brief into Viv code and compiles it before showing you. `/viv:fix` diagnoses compiler or runtime errors. Rounding it out: `/viv:design` for worldbuilding and architecture, `/viv:build` for host adapters and test harnesses, plus `/viv:critique`, `/viv:study` and `/viv:ask`. Skills are global; invoke them as `/viv:ask` or the short `/ask`.

You need Claude 2.1.85 or newer and Git 2.25 or newer. The utility commands are bash scripts, and they misbehave under native Windows shells, so on Windows run Claude inside WSL 2. After installing, restart the session completely — `/reload-plugins` won't bring the plugin up.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install viv@claude-community
```

## When to use it
- install the Viv compiler and runtime in a fresh project
- generate Viv code from a short scene brief
- trace a compiler error back to its cause
- plan a storyworld and its entity schema
- review a Viv codebase for gaps and tweaks

## Example prompts
- Run `/viv:setup` and set up Viv for this project
- \`/viv:write` a sifting pattern that matches rags-to-riches storylines
- \`/viv:fix` the compiler error in `mutiny.viv`

## Similar
- [ponytail](https://affpapa.org/en/nevibecode/plugins/ponytail.md) — plugin · ★ 176443
- [impeccable](https://affpapa.org/en/nevibecode/plugins/impeccable.md) — plugin · ★ 88212
- [last-30-days-skill](https://affpapa.org/en/nevibecode/plugins/last-30-days-skill.md) — plugin · ★ 65508
- [claude-hud](https://affpapa.org/en/nevibecode/plugins/claude-hud.md) — plugin · ★ 28841
- [understand-anything](https://affpapa.org/en/nevibecode/plugins/understand-anything.md) — plugin · ★ 88314
- [mem0](https://affpapa.org/en/nevibecode/plugins/mem0.md) — plugin · ★ 67829

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md