Revela

English | 中文

Revela works from OpenCode and Codex to turn source materials, research, data, and intent into trusted, traceable, presentation-ready decision artifacts.

Its narrative workspace records the core elements needed to generate a brief or deck: audience, decision, claims, evidence, sources, risks, objections, and open gaps.

Install

OpenCode

Install Revela through opencode.json with the npm package @cyber-dash-tech/revela:

{
  "$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.

Codex

Install Revela through the Codex Git marketplace:

codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref main
codex plugin add revela@revela

Install from the full repository ref. Do not use a sparse checkout limited to plugins/revela; the Codex plugin resolves the shared runtime, built-in designs, and domains from the repository snapshot.

Use a release tag instead of main when you want a pinned install.

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

In Codex, ask Revela to list or switch designs; the plugin uses the active design when making decks.

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

In Codex, ask Revela to list or switch domains; the active domain guides narrative framing during init, research, and story work.

Quick Start

Start with the local source materials and intent that should ground the communication. Revela identifies the audience, decision, claims, evidence, risks, objections, and gaps that shape the narrative.

When evidence is missing, use research to gather findings and bind only the supported parts back to the narrative. Before rendering, read the Story view to inspect the claim flow, evidence support, caveats, and open gaps.

Make a deck or brief from the canonical narrative when the story is ready to present. Review the artifact with Insight to understand support and traceability, use Comment for targeted changes, and export to PDF or PPTX when you need a shareable file.

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.