Skip to content
CutReady

Quick Start

This guide walks you through creating your first CutReady workspace and getting to a useful demo plan. The fastest path is: create a workspace, add a sketch, organize it in a storyboard, refine with AI, then save a named snapshot.

Create a Project

Section titled “Create a Project”
CutReady home screen CutReady home screen
The CutReady home screen

  1. Launch CutReady — You’ll land on the Home screen shown above.

  2. Click “New Workspace” — Choose a folder on your filesystem. CutReady initializes it as a portable workspace with a project.json manifest and git-backed version history.

  3. Name your project — Give it a descriptive name like “Product Demo Q1”.

Create a Sketch

Section titled “Create a Sketch”

Sketches are the planning backbone of your demo. Each sketch contains a structured table with your demo script.

  1. Click the Project icon in the sidebar to switch to the project document list.

  2. Click “New Sketch” in the storyboard list panel.

  3. Fill in the planning table — Each row has four columns:

    ColumnPurpose
    TimeApproximate timing for this step
    NarrativeWhat you’ll say during this step
    Demo ActionsWhat happens on screen
    ScreenshotReference image (captured or uploaded)

  4. Add screenshots — Click the capture button (📸) in any screenshot cell to take a reference screenshot directly from your screen.

  5. Save a version — Press Ctrl+S to open the snapshot naming prompt. CutReady uses git-based versioning, so you can always go back.

Build a Storyboard

Section titled “Build a Storyboard”

  1. Create a storyboard — Use the + menu in the project document list and choose Storyboard.

  2. Add sketches — Add the sketch you just created, or create new sketches directly from the storyboard editor.

  3. Organize the flow — Drag sketches into order, add sections, and collapse cards when you want to scan the structure.

  4. Preview — Use the storyboard preview to review the full sequence.

Refine with AI

Section titled “Refine with AI”

  1. Configure a model — Open Settings → AI Provider, choose a provider, fetch models if supported, and select a chat-capable model.

  2. Open Chat — Use the chat panel to ask the Planner, Writer, Editor, or Designer agent for help.

  3. Use context — Mention sketches, notes, storyboards, or URLs with # references so the assistant knows what to read.

  4. Review changes — AI edits are highlighted in the sketch editor and logged in the Activity panel.

Add Notes

Section titled “Add Notes”

  1. Switch to Notes — Click the Notes icon in the sidebar.

  2. Click the + button in the storyboard list panel.

  3. Select “Note” — A new markdown note opens in the editor.

  4. Write your content — Use markdown formatting for headings, lists, code blocks, and more. Notes auto-save as you type.

Notes are great for capturing reference material, setup instructions, or narrative drafts before breaking them into planning table rows.

Import Documents

Section titled “Import Documents”

  1. Click the import button in the sidebar storyboard list panel.

  2. Select a file — Supported formats: .docx, .doc, .pdf, .pptx.

  3. Review the imported note — CutReady converts the document to markdown and adds it as a project note.

What’s Next?

Section titled “What’s Next?”