The Prototo CLI is minimal by design. Everything beyond scaffolding and lifecycle is a prompt to Claude Code.
proto start
Starts Prototo and opens the iOS Simulator.
Keep this running while you work. Open a second terminal window and type claude to start designing. You only see what you need:
Prototo running → Simulator is open
Add --verbose to see detailed output if something breaks:
proto design
Interactive setup that generates or updates DESIGN.md.
Asks four questions — theme, accent colour, component library, app name — and writes DESIGN.md. For known libraries (Tamagui, Gluestack UI, React Native Paper, NativeWind), it also installs the package silently.
Run it once per project, or again to change the design system.
A shortcut, proto design update, just reminds you to use Claude Code for changes:
Tell Claude Code what to change:
e.g. "update DESIGN.md, change accent to indigo
and tighten card radius to 16"
proto new-screen
Creates a new empty screen.
With a template:
proto new-screen Profile --template list
Templates: home, list, detail, form, modal.
Navigation picks it up automatically.
proto remove
Coming soon. This command is a work in progress and not yet available.
Removes a screen and updates DESIGN.md.
proto snapshot
Coming soon. This command is a work in progress and not yet available.
Saves a named version of the current screens.
proto snapshot "v1 — stakeholder review"
List all snapshots:
proto share
Coming soon. This command is a work in progress and not yet available.
Shares your prototype via a QR code link.
Generates a prototo.app/p/<token> URL and prints a QR code. Stakeholders scan it and the prototype opens on their device.
Share a specific snapshot:
proto share --snapshot "v1"
proto export
Coming soon. This command is a work in progress and not yet available.
Packages the screens, shared components, and DESIGN.md into a clean /export/ folder for engineer handoff. The handoff is already done — DESIGN.md and the screens folder together are the spec — but proto export bundles them with a HANDOFF.md that explains the structure.
proto reset
The escape hatch. Fixes most things when something breaks.
Clears the cache, restarts the environment, and reopens the Simulator. Use this before asking for help.
Terminal UX
The CLI never shows stack traces, package names, or version numbers. Plain verbs only: “Starting…”, “Done.”, “Something went wrong.” Spinners for anything over a second. Success shows only what you need.