You built it. Now brag. Turn the project you just created into a short, shareable launch video with one command.
Update README for multi-agent support
anukulKuna81a73de893a
diff --git a/.gitignore b/.gitignoreindex fb4cba5..342f161 100644--- a/.gitignore+++ b/.gitignore@@ -1,27 +1,8 @@-# OS / editor cruft+node_modules/+.DS_Store+Thumbs.db+brag-output/+brag-output-*/+*.mp4+*.log.DS_Store-**/.DS_Store--# Python-__pycache__/-**/__pycache__/-*.pyc-.venv/-**/.venv/-.uv-cache/--# Local tooling / machine config-.playwright-mcp/-.agents/-skills-lock.json-.claude/--# HyperFrames render artifacts + heavy composition sources (never committed)-**/brag-output*/-**/renders/-**/.thumbnails/-**/.waveform-cache/--# Codex packaging — excluded from the Claude-only initial release-.codex-plugin/-CODEX_PLUGIN_FOLLOWUPS.mddiff --git a/README.md b/README.mdindex 4e494f7..2359155 100644--- a/README.md+++ b/README.md@@ -2,72 +2,123 @@**You built it. Now brag.**+Turn your project website into a short, polished, shareable launch video — music, motion, and share copy included. One command, powered by [Hyperframes](https://hyperframes.heygen.com/).+[](https://latent-spaces.github.io/brag/)-`/brag` is a Claude Code skill that turns the project you created into a short, shareable launch video — music, motion, and share copy included. One command, powered by [Hyperframes](https://hyperframes.heygen.com/).+> Forked from [latent-spaces/brag](https://github.com/latent-spaces/brag) by Shunit Haviv. This fork adapts `/brag` to work with **any AI coding agent** — not just Claude Code.++## What this gives you++A `brag-output/` folder with:+- `brag-plan.md` — the creative concept and storyboard+- `composition-brief.md` — the brief handed to Hyperframes+- `composition/` — the Hyperframes video project+- `brag.mp4` — the rendered video+- `share-copy.txt` — tweet-ready share text-The looping video on the [launch site](https://latent-spaces.github.io/brag/) was made by `/brag` on this very repo.+## Supported agents++| Agent | Install method |+|---|---|+| **Claude Code** | [`adapters/claude-code/`](adapters/claude-code/) — `.claude-plugin` manifest |+| **opencode** | [`adapters/opencode/`](adapters/opencode/) — `opencode.json` config |+| **Codex, Cursor, Aider, any LLM** | [`adapters/generic/`](adapters/generic/) — paste `AGENT.md` into custom instructions |+| **Any agent (direct)** | Read [`AGENT.md`](AGENT.md) and follow the workflow step by step |## Install+### Claude Code+```bash+# Plugin install/plugin marketplace add latent-spaces/brag/plugin install brag@brag-```-Then run `/brag` inside any project.+# Or copy skill directly+rsync -a --exclude '.DS_Store' skills/brag/ ~/.claude/skills/brag/+```-<details>-<summary>No plugin system? Install the skill directly.</summary>+### opencode```bash-rsync -a --exclude '.DS_Store' skills/brag/ ~/.claude/skills/brag/+# Global install+git clone https://github.com/anukulKun/brag-cli.git ~/.config/opencode/skills/brag++# Or per-project+git clone https://github.com/anukulKun/brag-cli.git .opencode/skills/brag```-Restart Claude Code after copying.-</details>+### Generic (any agent)-## Use it+1. Read [`AGENT.md`](AGENT.md) into your agent's context or custom instructions.+2. Ensure the skill assets are accessible (clone this repo or symlink `skills/brag/`).+3. Verify Hyperframes: `npx hyperframes doctor`-From any project directory, ask Claude:+## Use it-```text+```let's /brag+/brag --tone "fake Series A launch from 2016"+/brag --tone chaotic --format vertical```-Or steer the tone:+### Options-```text-/brag --tone "fake Series A launch from 2016"-```+| Option | Values | Default |+|---|---|---|+| `--tone` | preset or freeform description | inferred |+| `--format` | `landscape`, `vertical`, `square` | `landscape` |+| `--duration` | seconds | auto (15-25s) |+| `--no-music` | flag | music on |+| `--no-sfx` | flag | sfx on |+| `--title` | string | inferred from project |-You get a `brag-output/` folder with the plan, a composition brief, share copy, and the rendered `brag.mp4`.+Tone presets: `default`, `polished`, `yc-parody`, `chaotic`, `deadpan`, `cinematic`, `app-store`## How it works-`/brag` owns the story — the product angle, tone, and which moments to show. It hands a focused brief to [Hyperframes](https://hyperframes.heygen.com/), which builds, times, and renders the video.+1. **Inspect** — reads your project code to understand the app+2. **Plan** — answers a 9-question rubric, picks a creative angle, storyboards+3. **Compose** — hands a focused brief to Hyperframes for video generation+4. **Deliver** — validates, renders `brag.mp4`, and writes share copy## Requirements-- Claude Code (with skill/plugin support)- Node.js 22+- FFmpeg on `PATH`-- Hyperframes CLI — `npx hyperframes` (check it with `npx hyperframes doctor`)+- Hyperframes CLI — `npx hyperframes doctor` to verify-## What's in this repo+## Repo structure-- `skills/brag/` — the skill, references, and bundled music + SFX-- `examples/` — fake product sites used as a benchmark suite-- `docs/` — the launch site (GitHub Pages)-- `.claude-plugin/` — plugin manifest + marketplace catalog+```+brag/+├── AGENT.md ← Core skill (agent-agnostic, single source of truth)+├── README.md ← This file+├── LICENSE+├── .gitignore+├── skills/+│ └── brag/+│ ├── SKILL.md ← Thin wrapper (references AGENT.md)+│ ├── references/ ← Step-by-step guides, tone definitions, audio docs+│ ├── assets/ ← Music tracks + 200+ SFX files+│ └── scripts/ ← Music cue analyzer (Python)+├── adapters/+│ ├── claude-code/ ← .claude-plugin manifest for Claude Code+│ ├── opencode/ ← opencode.json config for opencode+│ └── generic/ ← Instructions for any agent without plugin system+├── examples/ ← Fake product sites (benchmark suite)+└── docs/ ← Launch site (GitHub Pages)+```## Credits-- Music — [ende.app](https://ende.app/en) "Happy Beats / Business Moves"-- Sound effects — [Kenney](https://kenney.nl/)-- Video generation — [Hyperframes](https://hyperframes.heygen.com/)-- Fake demo sites — built with [Impeccable](https://impeccable.style/)+- **Original creator:** [Shunit Haviv](https://github.com/latent-spaces/brag) — `/brag` was originally built as a Claude Code skill by [latent-spaces](https://github.com/latent-spaces)+- **Music:** [ende.app](https://ende.app/en) "Happy Beats / Business Moves"+- **Sound effects:** [Kenney](https://kenney.nl/)+- **Video generation:** [Hyperframes](https://hyperframes.heygen.com/)+- **Fake demo sites:** built with [Impeccable](https://impeccable.style/)-## Contributing+## License-Contributions, ideas, and new demo brags are welcome — open an issue or a PR.+MIT — see [LICENSE](LICENSE)