Let your local AI
run the shoot.

Tell Claude Code or Codex how you want to shoot. Through koma CLI, your assistant can arrange shots, choose models and start a batch from your shot list.

v0.1.0 · Node.js 22 · .tgz packageThe CLI runs on a computer. You can read the guide on your phone.

The courtyard at night in Vivienne Garden
00:24Garden
White swings his sword across the rooftop
00:29Slash
White’s round glasses fill the frame in the reading room
00:53Reaction
HEIST · Episode 1, final cutGarden / Rooftop / Reading room

Say what to move,
or what to change.

We recommend Claude Code or Codex. Once you’ve installed and authorized koma CLI, describe the edit in your own words. Your assistant runs the commands.

HEIST · EP01How to ask your assistant
  1. Arrangeshot move
    “Show the roof first, then cut to the reading room. Let me see the new order.”

    Your assistant can read existing shots and move them into position.

  2. Shootbatch run
    “That order works. Shoot the shots on this list.”

    Your assistant can prepare a batch and submit each shot for generation.

  3. Check statusbatch status
    “Which shots in this batch are still running?”

    Your assistant can check the batch and list queued or running shots.

What comes first?
Change the shot order.

The rooftop action in HEIST spans several shots. To show the landing first, ask your assistant to move Shot 5 ahead of Shot 4. To change a line, open just that episode.

HEIST · EP01Three original takes in shot-number order
  1. White and Suseka running across the roofShot 4 / T14
  2. Suseka landingShot 5 / T10
  3. Suseka jumping toward the dome openingShot 7 / T20

Episode 1 · Clock tower

EXT. CLOCK TOWER FIRING PLATFORM – NIGHT

ZLATIA
“Fire at will.”

To change this line, ask your assistant to edit Episode 1.

Try another model
for the next take.

Check which resolutions and durations each model supports. Start a new draft for the same shot to try another model and keep the existing take.

Shot 4, Take 9. White is visible over Suseka’s shoulder.
HEIST · Rooftop runShot 4 / Take 9, original footage

Recorded settings and another model option

T9Selected take
Seedance 2.5480p · 12 seconds
Another available model
Example settings
MiniMax H3768P · 5 seconds

Choose a model and settings in the new draft. Submitting it creates its own generation record.

Give this shot
her expression.

The team used the CLI to add this expression to BIWA’s character assets, then used it as a reference for Shot 8, Take 8 in the reading room.

Uploaded image
BIWA giving a sly smile in her expression reference
BIWA’s sly smilebiwa-teasing.png
HEIST · Reading roomShot 8 / T8
BIWA looks down as she speaks in Shot 8, Take 8

In the original take, BIWA looks down at Suseka.

How this image was usedCLI uploadBIWA’s character assetsShot 8 · T8 reference

What can koma CLI do?

v0.1.0
Stories and scripts
Create, list and rename projects. Edit individual episodes, add episodes, change titles or reorder episodes.creative · script
Shot order
Move existing shots and edit their visual descriptions and dialogue.shot
Assets and references
Upload, link or download assets. Choose character references and canonical scene or prop images.asset · character · art
Models and versions
Check model capabilities, create version drafts, select a model and submit a draft for generation.models · version · video
Prompts
Request suggestions, read the result and apply the wording you choose to a draft.prompt
Batches and jobs
Submit a shot list, check progress or resume a batch. Cancellation depends on the provider and job state.batch · job
Select and download takes
Select a take for a shot, download a specific result using its receipt or download completed takes in a batch.take · download
Account and authorization
Your first Google sign-in creates your account. Paid jobs use your workspace credits and plan benefits. Buy credits or subscribe on the website. Plans and creditsauth

Install and authorize

Install on a computer with Node.js 22 and npm.

Download CLI
  1. Install the package

    Run this in the directory containing your download.

    npm i -g ./alchemint-koma-cli-0.1.0.tgz --ignore-scripts
  2. Sign in and authorize

    Sign in with Google at koma.video. Your first sign-in creates an account and a workspace.

    koma auth login

    Match the browser code to your terminal, check the account and workspace, then allow the connection. Deny it if anything differs.

  3. Confirm your workspace

    Check that the terminal shows the account and workspace you expect.

    koma auth status

Run koma auth logout to revoke this CLI session.

Choose a take.
Save it locally.

Flip through three original takes from HEIST.
In your own project, tell your assistant which version to keep.

Download CLI
HEIST / Security officeTAKE 07
Sifu checks his phone as BIWA approaches from behind
Security officeSHOT 03 / TAKE 07
Original takesHEIST / 3 takes