Using MOVIE-ADE

Sending to agents

Run Claude Code or Codex in the built-in terminal and hand them a review with one click. You can also copy the instruction for any other agent, or post the review to GitHub.

#Review findings

Each card in the Findings tab supports:

Inline edit of the title and request
Send / Don't send toggle
Watch Recording (seeks to that time) and Replace Image (pick another frame)
Confirm / Mark as Needs Review, Merge with Next, Delete

The header has Undo, Open Folder, Copy for Agent, Send to GitHub, Organize, and Send to Agent. Speech that didn't become a finding is listed under Excluded speech, where Restore as Finding brings it back. Overall Note adds a note for the whole review.

Screenshot coming soon

The Findings tab

#Run agents in the built-in terminal

When a project opens, MOVIE-ADE starts one terminal tab per enabled agent in the project folder. The defaults are:

claude --dangerously-skip-permissions
codex --dangerously-bypass-approvals-and-sandbox

About the default flags

These flags let the agent edit files and run commands without asking. If you want approval prompts, clear the arguments in Settings → Agent (Claude Code arguments / Codex arguments). Reset Commands restores the defaults.

If neither agent is enabled, a plain shell opens. The + menu opens New Terminal, launches Claude Code or Codex in a new tab, or jumps to Agent settings…. Its search box also finds tabs, saved URLs, and files.

Tabs show the agent state: Running, Waiting for input, Done (unread), Idle.

Action	macOS	Windows / Linux
New Terminal	`⌘T`	`CtrlT`
Split Right	`⌘D`	`CtrlShiftD`
Split Down	`⌘⇧D`	`AltShiftD`
Close Pane / Tab	`⌘W`	`CtrlW`

#Send to Agent / Copy for Agent

Focus a terminal tab where Claude Code or Codex is running.
Click Send to Agent.
MOVIE-ADE writes the instruction into the agent's input and submits it. Follow progress in the terminal.

Nothing is sent if no agent is detected in that terminal, or if the agent is waiting for a permission answer. Answer in the terminal first.

Copy for Agent puts the same instruction on the clipboard for an agent running elsewhere (another terminal, IDE, or app). Only findings toggled to Send are addressed. The video is never included.

#Customize the instruction

Edit Settings → Agent → Instructions for Agent. Two variables are expanded:

Variable	Expands to
`{{path}}`	Absolute path of `feedback.md`
`{{relpath}}`	Path relative to the project: `.ade-movie/reviews/<id>/feedback.md`

Leave it empty to use the default. The maximum length is 2000 characters, and Reset Instructions restores the default. Example:

Read {{relpath}} and the PNGs next to it. Fix only findings marked to send, one commit per finding, then run the tests.

The setting is stored as agentPrompt in settings.json.

#Send to GitHub (Issue / PR comment)

Send to GitHub posts the review as a new issue or as a comment on one of your open pull requests. Authentication is delegated to the GitHub CLI. MOVIE-ADE never reads or stores a token.

Install gh: brew install gh (macOS), winget install --id GitHub.cli (Windows), or see cli/cli.
Settings → GitHub → Sign In in Terminal runs gh auth login --web -h github.com in the built-in terminal.
Click Send to GitHub, choose Create a new issue or a PR, and review the Title and Body (editable).
Tick the confirmation checkbox, then Create Issue or Post Comment.

Details:

The repository comes from git remote get-url origin.
MOVIE-ADE runs gh issue create --repo … --title … --body-file - or gh pr comment <n> --repo … --body-file -.
The body is feedback.md without the image lines (images are not uploaded), up to 60,000 characters.
PR candidates are your own open PRs (up to 30).

If GH_TOKEN or GITHUB_TOKEN is set, gh uses it first, and the settings panel warns about it.

Edit this page on GitHub