OpenCut OpenCode Copilot

OpenCut OpenCode Copilot is a publication-ready fork of OpenCut that adds an OpenCode-style AI control layer for video editing workflows.

This repository is not the upstream OpenCut project and does not claim upstream maintainership. It preserves upstream attribution and focuses on the integration work maintained in this fork.

What This Fork Adds

• OpenCode API routes for session creation, model listing, health checks, chat messages, and action planning:
  • apps/web/src/app/api/opencode/*
  • apps/web/src/lib/ai/opencode.ts
• A copilot action surface in the editor UI:
  • apps/web/src/components/opencode-copilot.tsx
• Project action planning and selection-aware operations:
  • apps/web/src/lib/ai/project-action-*
  • apps/web/src/lib/ai/selection-path.ts
  • apps/web/src/lib/ai/tool-registry.ts
• Semantic video analysis and ingest support for timeline-aware AI workflows:
  • apps/web/src/services/semantic-*
  • apps/web/src/lib/semantic/*

Why It Exists

The goal is to explore how an AI coding/runtime assistant can operate inside a real open-source creative tool, not just around it. The integration is aimed at maintainer and creator workflows such as:

• turning natural-language editing requests into structured action plans;
• using semantic video context to guide timeline operations;
• routing local AI/runtime availability through explicit health and model endpoints;
• keeping AI actions reviewable instead of silently mutating project state.

Upstream Attribution

This fork is based on OpenCut:

• Upstream: https://github.com/OpenCut-app/OpenCut
• Local fork source commit used for this publication export: 2c839c805eaaaf2c2642b6fb4cb5a8346169e126
• Upstream merge-base observed during export: 729d10592f4e802f91c555c309ff3ba4b119f843

The original upstream README is preserved as README.opencut-upstream.md.

Quickstart

Prerequisites:

• Bun
• Docker and Docker Compose, if you want the local database/Redis stack

Setup:

cp apps/web/.env.example apps/web/.env.local
docker compose up -d db redis serverless-redis-http
bun install
bun dev:web

Open:

http://localhost:3000

OpenCode/Copilot paths are feature-gated by runtime availability. Use the health endpoint and UI state to confirm whether the copilot runtime is enabled in your local environment.

Smoke Checks

Run the lightweight checks before publishing or opening a pull request:

bun test
bun run lint:web

For manual review, inspect:

• GET /api/opencode/health
• GET /api/opencode/models
• editor copilot UI rendering
• action-plan request/response behavior with a safe local project

Security And Secrets

Do not commit local runtime credentials. The publication export is built from tracked source files only; local ignored files such as .env.local and .opencut-secrets must stay out of git.

See SECURITY.md.

Roadmap

See ROADMAP.md.

License

This repository keeps the upstream OpenCut license. See LICENSE.