openklip AGENTS.md

Repository instructions for OpenKlip, a local video-editing toolchain controlled by agents through command-line files and reviewed in a browser. Projects use plain files such as an edit description, brief, original media, and working files.

In plain words
What is it for?
Use it when creating or changing OpenKlip video edits, project briefs, assets, graphics, or derived media while following the repository's copy and code rules.
Why use it?
It explains the file model and guardrails so an agent can edit the correct project file without confusing source media with generated working files.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/craftled/openklip/agents-md
Clone the repo
git clone --depth 1 https://github.com/craftled/openklip

Made for: Codex, OpenCode.

Per session 21,283 This file is loaded in full into every session.
When invoked 21,283 The same file — it is already loaded in full.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.21283 $0.21283
Opus 5 $0.10641 $0.10641
Sonnet 5 $0.04257 $0.04257
Haiku 4.5 $0.02128 $0.02128

Measured 2d ago against content hash 9715856702c2, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

openklip AGENTS.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Unrestricted tool accessmediumExcessive agency

A wildcard tool grant or "run any command" leaves no least-privilege boundary at all.

**Deferred MCP surface (default):** at connect the server enables a **core** edit-loop set (~28 tools: status, transcript, cut, export, brief, tasks, revert, …) plus three meta tools: `tools_catalog` (name/summary search
AGENTS.md · 686 lines

How it starts

The opening of the file, as written. The whole thing — 686 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md

Single source of truth for AI agents working in this repo: OpenKlip editing workflow, guardrails, copy rules, and code standards.


OpenKlip agent skill

OpenKlip is a local-first, agent-native video toolchain: external agents run the edit loop via CLI; the browser reviews the same project.json.

The file model (read this first)

Each project lives as plain files under projects/<slug>/ in a layered layout. The parent directory is resolved by projectsRoot():

  1. OPENKLIP_PROJECTS_ROOT if set
  2. else .openklip/projects-root in the app cwd (GUI folder picker)
  3. else ~/Movies/OpenKlip
projects/<slug>/
  project.json            the EDL - the edit itself (the only file you edit)
  brief.md                optional project brief: audience, goal, tone,
                          must-use assets, avoid list, target length, formats
  assets/                 user originals (flat): drop b-roll, music, stills here
  graphics/               optional project-local graphic templates (override bundled ids)
  working/                derived media + scratch: proxy.mp4, transcript.json,
                          audio16k.f32, frames/, asset proxies, chats.json,
                          actions.jsonl, tasks.json…
  output/out.mp4          the rendered export

Edit templates (repo root, not per project):

templates/<id>/skill.md   agent playbook (cuts, overlays, export loop)

Optional template field on project.json points at a template id (e.g. talking-head).

project.json IS the edit. It holds every transcribed word with a deleted flag, b-roll overlays, still (Ken Burns) overlays, push-in zooms, title cards, graphics (HTML/CSS template overlays), music placements, captions settings, look flags, optional sceneLog (visual spans + speaker focus), optional highlights (LLM clip candidates), and export (aspect + reframe crop). Everything under working/ and output/ is regenerated from it. The GUI editor and these CLI commands both read and write this same file; they are equivalent (parity). Edit it through the CLI; the browser editor will show the same result, and vice-versa.

Read the full file on GitHub · 686 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 686 lines · 21,283 tokens per session scan B 9715856702c2

Subscribe to this mod's changes

openklip AGENTS.md is an instructions file published in the GitHub repository craftled/openklip (2 stars, last pushed 22d ago), licensed MIT. It adds 21,283 tokens to every session, about $0.1064 per session on Opus 5. A static security scan graded it B with 1 finding (unrestricted tool access). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.