AI Agent & CLI

Automate Mac Demo Recording and Fine Cuts with Claude Code or Codex

Current for Oil Studio 0.3.44 (updated 2026-11-20)
Creator with round glasses holding a mug while a compact robot arm snips a retake frame from a filmstrip
Oil Studio includes the local oilstudio command-line interface and an MIT-licensed Agent Skill with zero per-use fees or AI credits. External agents such as Claude Code and Codex read word-level transcripts and frames through structured JSON commands, drive native macOS windows to record clean product demos, and submit retake cuts, zooms, overlays, and redactions as undoable proposals reviewed inside the app.
Native macOS 15 Oil Studio editor showing timeline cut candidates and review controls
Native macOS 15 app capture: agent-submitted cuts and Auto Edit silence spans preview cleanly on the timeline before one-click apply or single-step ⌘Z undo.

Core CLI Commands and Review Model

CommandPurposeExecution & Safety
oilstudio statusVerify app state, version, and Agent Skill compatibilityRead-only JSON handshake
oilstudio projects / importList local .oilstudio projects or convert existing recording projects read-onlyOriginals are never modified
oilstudio record sources / start / click / stopCapture a chosen native Mac window and synthesize smooth cursor paths and click zoomsRequires macOS and in-app user permission
oilstudio idle --submitStrip silent waiting gaps between UI actions and rebuild auto-zoom alignmentUndoable in one step with ⌘Z
oilstudio context / plan validate / plan submitRead word-timed transcripts and submit cuts, zooms, text overlays, and redactionsReviewed item by item in Oil Studio before applying
oilstudio subtitles generate / applyGenerate captions, fix terminology and line breaks, or translate into EnglishSupports --plan to align with pending timeline cuts
oilstudio narration generate / exportSynthesize caption-synced AI voice-over and export 60 fps MP4, GIF, or SRTUses your own configured model API keys

How do I install the oilstudio CLI and Agent Skill?

Open Settings › AI Agent inside Oil Studio and click Install to set up both the oilstudio binary and the Skill package automatically. You can also install the app via Homebrew Cask and add the Skill with the Skills CLI.

brew install --cask oil-oil/tap/oil-studio
npx skills add oil-oil/oil-studio-skill
oilstudio status

How does AI fine-cutting remove retakes without corrupting projects?

Agents never read or mutate files inside a .oilstudio bundle directly. When you ask Claude Code or Codex to cut retakes and fix product names, the agent calls oilstudio context to inspect word-level timestamps and pause candidates.

Every proposed cut, zoom adjustment, overlay, or redaction passes through oilstudio plan validate before arriving in Oil Studio’s review panel. You can preview individual cuts, untick anything you want to keep, apply in one click, or press ⌘Z at any time.

  • Single-pass caption alignment.subtitles apply and chapters apply accept --plan so caption fixes and chapter markers queue cleanly against post-cut timeline positions.
  • Pre-redacted agent vision.Existing pixel redactions are rendered before frames are handed to agent storyboards or OCR, and any proposal that narrows an existing redaction requires manual approval in the app.

How can an AI agent record a native macOS app walkthrough?

Once macOS screen recording permission and Oil Studio’s agent recording toggle are enabled, your agent can size and center a specific Mac window with oilstudio record prepare (for example 1280×800) and capture only that window.

Before each interaction, record click reports target coordinates so Oil Studio synthesizes a spring-smoothed cursor and click-following zoom instead of recording jerky raw pointer movement, then runs oilstudio idle --submit to remove loading waits before exporting.

Scope and Security Boundaries

  • Built for .oilstudio projects.The CLI operates on structured recording projects containing cursor, click, and multi-track metadata—not arbitrary standalone MP4 or MOV files.
  • Bring your own keys, zero markup.API keys stay in your macOS user configuration and are never echoed to agent logs; Oil Studio charges no AI credit packs or subscription tiers.
  • Explicit human consent.Agents cannot grant macOS capture permissions or dismiss permission prompts, and an always-visible recording pill lets you pause or stop capture anytime.

Open repositories & verification links

Inspect the public CLI schema, Homebrew Cask formula, and interactive browser walkthrough directly:

Common questions

01Does Oil Studio charge per minute for AI agent editing?

No. The local CLI and Agent Skill are included in the one-time purchase with zero usage fees; your agent uses your own Claude Code, Codex, or model account.

02Can an agent overwrite my recording irreversibly?

No. Editing plans wait in the review panel by default, never alter source media, and remain fully undoable with ⌘Z.

03Is the AI Agent CLI available in the Mac App Store edition?

No. External CLI and agent integration require the direct website or Homebrew edition; the Mac App Store build runs inside the macOS App Sandbox.

Pricing.

Recording, editing and captions, together.

Black Friday offer: $39 (20% off the $49 regular price, ends Dec 1). One-time purchase.

  • Spring auto-zoom on clicks, smoothed cursor, motion blur, and 4K 60 fps hardware export
  • Offline on-device Whisper captions and word-level transcript cutting (audio stays local)
  • Sensitive-region privacy redaction, keystroke overlays, voice enhancement, and teleprompter
  • Built-in AI Agent CLI & open-source Skill for Claude Code and Codex automation
  • Activates on 2 Apple silicon Macs per license (inactive devices auto-release after 30 days)
  • No subscription, no media-hour caps, and $0 AI credit fees — keep exporting with no annual renewal
Download Oil StudiomacOS 15+ · Apple silicon · existing recording projects import directly
brew install --cask oil-oil/tap/oil-studioHomebrew ↗
Black Friday · 20% off
$39
$49
Black Friday ends in 10d 21:46:07

One-time purchase, with no subscription or per-use charges. Try recording and editing for free, then activate export when you’re ready. Each license works on two Macs; a Mac that hasn’t checked in for 30 days automatically frees its spot.