Build your first story with an assistant
Contents
You will connect an assistant to Bitebox and ask it to build a short story. The story plays one clip, shows two choices, and ends on a different clip for each choice. Then you review the story in Canvas and undo a change.
This quickstart uses your own clips, so it runs no models and spends no credits.
Before you start#
You need:
- A Bitebox account that can open Canvas at
canvas.bitebox.gg. - An assistant that supports remote MCP servers with sign-in, such as Claude, ChatGPT or Cursor.
- Three short video clips at public
https://addresses: one opening scene and one clip for each ending. Each file can be up to 64 MB. Portrait 9:16 clips look best on a phone.
Connect and approve#
- Add Bitebox to your assistant. Follow the steps for your assistant in Connect an assistant.
- Sign in to Bitebox when your assistant asks.
- On the consent screen, keep the defaults: Documents set to Read and edit, Media set to Use and upload, Preview on, and History set to Read version history.
- Set Generate to Off. With generation off, the assistant cannot run models or spend credits.
- Click Allow.
You can add a daily generate budget later with Edit on the Canvas MCP tab. The budget limits what the assistant can spend each day; it does not give credits. Sign-in, consent and access explains each setting.
Your assistant keeps its own sign-in. Do not paste a token, a sign-in code or a callback address into the chat.
Ask your assistant to call workspace_context. If it answers with what you allowed, you are connected.
Ask your agent#
Help me build a short Bitebox story called "The door". First, inspect my workspace with workspacecontext. Create a new project. Import these three clips: [opening clip link], [first ending link], [second ending link]. Play the opening clip first, then show two choices, "Open the door" and "Walk away", that each lead to one ending clip. Check every path with playthroughsimulate and tell me what each path reaches. Explain the proposed changes and ask before you run a model or publish.
Review the paths your assistant reports before you continue.
The assistant does these steps:
- It calls
workspace_contextandproject_create. - It calls
media_import_urlonce for each clip. Each call answers a hosted Bitebox address for that clip. - It calls
scene_addonce for each address. Each call adds one scene that plays that clip. The call for the opening clip also marks that scene as the start. - It adds the two choices to the opening clip with
choice_add. Each choice is wired to its ending. - It calls
playthrough_simulate.
Check your result#
playthrough_simulate should report two paths. Each path starts on the opening clip and reaches a different ending. It also names the path a viewer takes when they do not choose, and it lists no dead ends.
To watch the story, ask for a preview link. preview_url gives a link that lasts fifteen minutes. It opens your story's play page, as viewers will see it, playing the version you have not published yet. If previews on the play page are not on yet, the link opens the reference player instead.
If the report shows a dead end or a node that no path reaches, ask the assistant to fix that wire and run the check again. If a tool answers with a refusal code, read Troubleshooting.
Review and undo in Canvas#
- Open Canvas and open your new project from My Projects on your home page.
- Look at the canvas. The three scenes and the Choice Overlay are there. Play the story to check both choices.
- Open the Projects menu and select Earlier versions. Each change the assistant saved is a separate save in this list.
- Select a save from before the choices, then select Restore as new save. Select Restore to confirm. Canvas adds the restored version as a new save. The earlier saves stay in the list. Unsaved canvas edits are not kept.
- To get the choices back, restore the newer save the same way.
You can also ask the assistant to undo. It lists saves with document_revisions and restores one with document_restore. A restore never deletes history. Restore an earlier version has the details.
Next step#
Read the Builder guide to add more scenes, generate clips within a daily budget, and prepare your story to publish.