# Pellicule

> Pellicule turns Vue components into MP4 videos. Make animations, product intros and reusable video templates with code.

- Documentation: https://pellicule.thally.app
- GitHub: https://github.com/sailscastshq/pellicule-docs
- Full docs for LLMs: https://pellicule.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pellicule.thally.app/ai.txt
- Structured docs index (JSON): https://pellicule.thally.app/api/docs-index
- OpenAPI spec: https://pellicule.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pellicule.thally.app/api/docs/{page-id}
- Search API: https://pellicule.thally.app/api/search?q={query}
- Capability manifest (skill): https://pellicule.thally.app/skill.md
- Agent guidance (editing these docs): https://pellicule.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pellicule.thally.app/api/mcp
- Agent readiness: https://pellicule.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_sections` / `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Documentation

### Start here

- [Pellicule](https://pellicule.thally.app/): Pellicule turns Vue components into MP4 videos. Make animations, product intros and reusable video templates with code.
- [Make your first video](https://pellicule.thally.app/quickstart): Give your coding agent a short brief, then watch your first MP4.

### Make it yours

- [Adjust timing and sound](https://pellicule.thally.app/guides/timing-and-output): Ask your agent to change a video's duration, slow its reveal and fade its soundtrack without losing control of the final output.
- [Understand the scene](https://pellicule.thally.app/guides/edit-the-source): Read the frame-driven Vue component and see how the bars, wordmark, typography and soundtrack fit together.

## How this site was built

### Walkthrough

- [Build docs with Thally](https://pellicule.thally.app/articles/build-pellicule-docs-with-thally): A practical walkthrough of creating, testing and publishing the Pellicule documentation site with Thally.