How mirage-hq/tesseract works
Tesseract is a pair of agent-facing skills for operating a local creative CLI, rather than a conventional application server. The primary workflow is an agent following a skill to import footage, edit or create motion graphics, inspect sound and preview revisions, then render locally while retaining an editable project. The README and reference-directory names document broader editing and motion capabilities; sampled code confirms local sound, waveform, and FFmpeg helper behavior. The CLI and most project operations are not in the sampled source, so their internal wiring is not inferred.
Main entry points: tesseract_sound.py Sound tools · tesseract_waveform.py Waveform review · tesseract-video/SKILL.md Edit Video skill · tesseract-motion/SKILL.md Motion Graphics skill
Components 17
Agent guidance
- Edit Video skill
skills/tesseract-video/SKILL.md - Motion Graphics skill
skills/tesseract-motion/SKILL.md - Video references
skills/tesseract-video/references - Motion references
skills/tesseract-motion/references
Creative workflow
- Tesseract CLI
- Source media
- Video editing
skills/tesseract-video/references - Motion graphics
skills/tesseract-motion/references - Editable project
- Preview and revise
skills/tesseract-video/references/review-and-delivery.md - Rendered video
Sound review
- Sound tools
skills/tesseract-video/scripts/tesseract_sound.py - Waveform review
skills/tesseract-video/scripts/tesseract_waveform.py - Sound reports and cues
Local processing
- Media helpers
skills/tesseract-video/scripts/tesseract_media.py - FFmpeg tools
Other components
- AI agent
Connections 20
- AI agent → Edit Video skill: follows
- AI agent → Motion Graphics skill: follows
- Edit Video skill → Video references: consults
- Motion Graphics skill → Motion references: consults
- AI agent → Tesseract CLI: directs
- Source media → Tesseract CLI: provides media
- Tesseract CLI → Video editing: performs edits
- Tesseract CLI → Motion graphics: creates graphics
- Tesseract CLI → Editable project: saves project
- Tesseract CLI → Preview and revise: previews
- Preview and revise → AI agent: guides revision
- Tesseract CLI → Rendered video: renders locally
- AI agent → Sound tools: invokes
- Sound tools → Waveform review: dispatches waveform
- Sound tools → Media helpers: uses
- Waveform review → Media helpers: uses
- Sound tools → FFmpeg tools: runs
- Waveform review → FFmpeg tools: runs
- Sound tools → Sound reports and cues: writes cues or reports
- Waveform review → Sound reports and cues: writes review files