mupozg823/timecode-agent

** 긴 비디오에서 재사용, 타임스탬프 증거.**

사용자 정의

한국어

TIMECODE-AGENT는 코딩 에이전트가 로컬로 긴 비디오를 다시 사용할 수 있도록 도와줍니다. 증거 ledger.

• Transcript 먼저. Ingest는 타임스탬프를 생산합니다. uploader’s captions when they present) plus deterministic 배치 신호 - 장면, 오디오 에너지, OCR, 얼굴 - 모든 프레임이 모델로 전송되기 전에.
• Lazy 시각적 검증. 코딩 에이전트는 순간만 검사 청구가 시각 확인을 필요로하고, 확인한 내용을 기록합니다. 한 샷 응답 대신 시간 정렬 체크 포인트.
• 가입자에 대한 증거. Checkpoints, 캡처 검증 및 편집 append-only ledgers에 살고 결정; 색인, 정적 corpus 브라우저, 그리고 wiki 페이지는 그(것)들을 통해 재건축할 수 있는 계획입니다.
• **Grounded 편집 핸드오프. ** EDL, FCPXML 및 OTIO 수출은 파생됩니다 기록 된 체크 포인트 또는 핀 스퀀트에서 - unstored에서 모형 대답; 클립 적출 및 SRT 연출은 utilities를 지원합니다 어떤 경간 또는 전체 성적에 작업.

전형적인 용도: re-watching 없이 긴 footage에 관하여 질문에 대답,

TIMECODE-AGENT helps coding agents turn long video into a local, reusable evidence ledger.

• Transcript first. Ingest produces a timestamped transcript (reusing the uploader’s captions when they exist) plus deterministic placement signals — scenes, audio energy, OCR, faces — before any frame is sent to a model.
• Lazy visual verification. The coding agent inspects only the moments where a claim needs visual confirmation, and records what it verified as time-addressed checkpoints instead of a one-shot answer.
• Evidence that persists. Checkpoints, capture provenance, and edit decisions live in append-only ledgers; indexes, a static corpus browser, and wiki pages are rebuildable projections over them.
• Grounded editorial handoff. EDL, FCPXML, and OTIO exports are derived from recorded checkpoints or a pinned sequence — not from an unstored model reply; clip extraction and SRT rendering are supporting utilities that work on any span or the full transcript.

Typical uses: answering questions about long footage without re-watching it, cutting highlights or shorts with receipts for every cut, and growing a searchable corpus and wiki across many videos.

Quickstart

git clone https://github.com/mupozg823/timecode-agent.git && cd timecode-agent
uv tool install --python 3.12 .

va ingest show.mp4 --model small --signals
va brief va-out/show
va capture va-out/show -t 1:23 -t 95
va status va-out/show

The first pass builds reusable local artifacts. Your coding agent reads those artifacts, inspects decision-critical gaps, and records supported checkpoints before any grounded edit is exported.

Recently shipped

• Legacy workspaces promote in place — va rebind backfills pre-0.3.0 workspaces into revision binding (dry-run by default) and refuses when the source is gone, so frozen corpora accept new evidence again.
• Procedures compile into skill drafts — recurring, visually grounded task-* steps become approval-pending skill drafts gated on tool-consensus intent coherence; va skillgen --route names what still blocks each candidate.