BashCut is a native macOS video editor with a docked Claude Code / Codex terminal. Everything the UI does, an agent
can do through the bashcut CLI or MCP. Start with the section that matches what you want to do.
| Guide | For |
|---|---|
| Automation: CLI and MCP | Driving the editor from agents, scripts and the terminal dock; the full command list |
| Writing plugins | Adding transcription, voice, beat or loudness providers as out-of-process plugins |
| Sample project | A generated project with every timeline case, for manual testing and an end-to-end check |
| Document | Contents |
|---|---|
| Command reference | Every CLI command and MCP tool with its parameters (generated) |
| Project format reference | How project.bashcut.json, history and edits behave on disk |
| Third-party dependencies | Packages, licenses and why each one is used |
| Document | Contents |
|---|---|
| Implementation status | What is built and verified, M0 benchmark results, known limitations |
| Mockup parity | Native UI compared with the HTML mockup, area by area |
The specs explain what BashCut is meant to be and why: goals, UI, file format, architecture, agent integration, conventions and the roadmap.
CONTRIBUTING.md covers building, verifying and the one-file templates for agent providers, model adapters, commands, plugin capabilities and timeline formats. Changes are recorded in CHANGELOG.md.