Revela

English | 中文

Revela is an OpenCode plugin for turning workspace sources, research, evidence, and user intent into trusted narrative artifacts. Its first render target is HTML slide decks.

Install

Add Revela to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@cyber-dash-tech/revela"]
}

Restart OpenCode.

To install globally, add the same entry to ~/.config/opencode/opencode.json.

Built-In Designs

Revela includes built-in deck designs:

summit

monet

starter is the clean default presentation style.

Switch designs with:

/revela design --use summit

Domains

Domains add topic-specific narrative guidance, such as consulting, product, or investor communication. Use them when you want Revela to adapt story framing to a specific context.

/revela domain

Quick Start: Make An HTML Deck

1. Initialize the narrative workspace from your local source materials.

/revela init

2. Research missing evidence and bind useful findings to claims.

/revela research

Skip this step if your local materials already provide enough support.

3. Inspect the claim flow before rendering.

/revela story

Use this to check the audience, decision, claims, evidence, gaps, risks, and objections.

4. Generate the HTML deck.

/revela make --deck

Revela writes the deck under decks/ and uses the current narrative, deck plan, and active design.

5. Review or revise the deck.

/revela review --deck

See Review A Deck for Insight and Comment.

6. Export if needed.

/revela export --deck pdf decks/example.html
/revela export --deck pptx decks/example.html

Review A Deck

Use Review after generating an HTML deck:

/revela review --deck

Review opens a local deck workspace with two main modes:

• Insight explains selected slide content: what claim it supports, what evidence backs it, what caveats or gaps remain, and why it matters in the narrative.
• Comment lets you request targeted edits on the deck, such as layout, copy, hierarchy, spacing, or visual changes.