# cliphou.se
**You ship it. Cliphouse shows it off.**
Your coding agent turns every release into a video for your socials. It finds the selling points, picks the angle, writes the copy, and uses your brand colors and logo. Free skill and MCP server for Claude Code, Codex, Cursor, Claude, and ChatGPT.
You can preview and edit without an account. MP4 download and editing more than 3 gallery templates need a free Google sign-in.
## Install
<table>
<tr>
<th width="50%">Coding agents (Codex, Claude Code)</th>
<th width="50%">Chat apps (Claude, ChatGPT, Cursor)</th>
</tr>
<tr>
<td valign="top">
```bash
npx skills add sunmer/cliphouse
```
Installs the `cliphouse` skill. It needs Node 18 or later, has no dependencies, and runs no commands besides its own helper.
In Codex you can also run `$skill-installer install https://github.com/sunmer/cliphouse/tree/main/skills/cliphouse`.
</td>
<td valign="top">
MCP server URL, no key needed:
```text
https://cliphou.se/mcp
```
[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cliphouse&config=eyJ1cmwiOiJodHRwczovL2NsaXBob3Uuc2UvbWNwIn0=) · [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22cliphouse%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fcliphou.se%2Fmcp%22%7D)
Claude.ai and ChatGPT: add a custom connector with the URL above.
</td>
</tr>
</table>
Claude Code with MCP instead of the skill:
```bash
claude mcp add --transport http cliphouse https://cliphou.se/mcp
```
Codex with MCP, in `~/.codex/config.toml`:
```toml
[mcp_servers.cliphouse]
url = "https://cliphou.se/mcp"
```
GitHub does not open `cursor://` and `vscode:` links from a README in every browser. If a link does nothing, add the MCP server URL manually.
## Try it
Open your project and ask:
> Let's ship 2.1. Btw we need a release video for our socials.
> Make a vertical changelog video for this week's updates.
> Turn this API release into a 16:9 video for X and LinkedIn.
In Codex, type `$cliphouse` to call the skill directly.
## Status
| Feature | Status |
| --- | --- |
| Template grid in the chat that already shows your product, with short animated previews | Available |
| Filling the template from your repo, and editing it by prompt | Available. You get a cliphou.se editor link, where you export the MP4. |
| A preview of your own product in the picked template | Available as a 4-second animated loop, with a poster image as a fallback. |
| Posting to X from the agent | Coming soon. Today the agent writes the caption and opens the X post window for you to attach the MP4. |
## Skills in this repo
| Skill | Does | Install |
| --- | --- | --- |
| `cliphouse` | Search, preview, fill from your repo, editor link, share. Reads public cliphou.se data only. | `npx skills add sunmer/cliphouse` |
| `cliphouse-render` (optional) | Renders the MP4 in your project, or lets the agent change layout, motion, and timing in code. Asks before it downloads or installs anything. | `npx skills add sunmer/cliphouse --skill cliphouse-render` |
## How it works
`skills/cliphouse/scripts/cliphouse.mjs` talks to the public cliphou.se catalog over HTTPS. Search uses the cliphou.se MCP server, so the skill and the MCP tools rank templates the same way.
Goals: `launch-product`, `announce-feature`, `share-update`, `grow-waitlist`, `announce-integration`, `announce-pricing`, `celebrate-milestone`, `share-social-proof`, `promote-event`, `introduce-brand`, `run-promotion`, and `hire-team`.
The cliphou.se deploy checks this skill against its MCP contract. If the installed skill is older than the server, search returns a warning with the update command.
| Command | Does |
| --- | --- |
| `search --goal <goal> "<query>" [--aspect 9:16] [--max-seconds 20] [--inline]` | Finds templates for a marketing goal. `--inline` caches the preview MP4s and prints a Markdown grid. |
| `logo [file]` | Uploads the project's logo (found automatically, or the file you name) and adds it to `cliphouse/brand.json`. Release and developer templates show it in place of the brand name. |
| `fit <id>... --brand <brand.json>` or `fit <id> <props.json>` | Checks your copy against each template's text limits before rendering, and lists the fields that are too long. |
| `tailor <id>... --brand <brand.json>` | Renders up to 4 templates with your brand on the server, writes `cliphouse/<id>.props.json` for each, and prints a Markdown grid of 4-second animated loops. `--fast` prints the posters first. |
| `spec <id>` | Prints the editable text, colors, and limits. |
| `preview <id> <props.json>` | Renders an animated loop and a poster of your product in the template on the server, and prints the editor link. |
| `link <id> <props.json>` | Validates the edit and prints a cliphou.se editor link. |
| `pick <id>...` | Writes a side-by-side preview page for terminals and prints its path. The agent asks before opening it. |
What the default skill does not do:
- It does not run `npm`, `curl`, `tar`, or any command from a downloaded spec.
- It does not download source packages into your repo.
- It does not open your browser on its own.
It caches stock previews only from `https://cliphou.se/previews/` and personalized posters and loops only from `https://cliphou.se/p/<hash>.jpg` and `.webp`, in `~/.cache/cliphouse`. Set `CLIPHOUSE_ORIGIN` to use another host.
In the Codex picker, a click on a tile sends one fixed message: `$cliphouse: use template <id> and fill it for this project`. It is sent only on your click, and the id must match `^[a-z0-9-]+$`.
`cliphouse-render` uses fixed render commands written in its `SKILL.md`. It checks each package against `source.packageSha256` before it extracts it into `.cliphouse/<id>/`, and asks before it adds `.cliphouse/` to `.gitignore` or installs dependencies.
## Links
- [MCP docs](https://cliphou.se/mcp-docs/): install options, tools, limits, and the workflow video
- [MCP Registry entry](https://registry.modelcontextprotocol.io/v0.1/servers?search=se.cliphou%2Ftemplates) (`se.cliphou/templates`)
- [llms.txt](https://cliphou.se/llms.txt)
- [Gallery](https://cliphou.se/)
## License
MIT-0. Templates rendered locally use Remotion or HyperFrames, which have their own licenses.
