Skip to content

armgit / brag

Public Imported from GitHub
0

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/.gitignore
index 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.md
diff --git a/README.md b/README.md
index 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/).
+
[![the /brag launch site — you built it, now brag](docs/assets/hero.png)](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)