Skip to content
Viberia Docs

Tutorial

The Tutorial is a 14-scene first-run walkthrough that opens automatically the first time you launch Viberia, introduces the Chief of Staff, sets up your CLI providers and privacy preferences, drops your first HQ on the map, and hands off into a real task you can finish.

How It Works

Section titled “How It Works”

The tutorial runs as an overlay on top of the regular UI. As you progress, it highlights real interface elements — the actual MiniMap, the actual HudShelf, the actual CoS Overlay — and the dialog text guides you through using them. You aren’t running through a mockup; you’re using the real product with a friendly companion stepping you through each surface.

The 14 scenes run in this order:

  1. Welcome from the Chief of Staff. The CoS introduces itself and explains what Viberia is.
  2. Pick CLI providers. Point Viberia at the claude, codex, and/or gemini binaries on your machine. One is enough; you can add the others later in Settings → CLI Configuration.
  3. Pick a model theme. Choose between speed-leaning defaults and quality-leaning defaults. Affects which model is assigned to each role tier.
  4. Privacy and analytics consent. Per-category opt-in for anonymized telemetry and crash reporting. Defaults are off.
  5. Guided or Quick path. Pick how the rest of the tutorial proceeds. Guided walks you through setting up a real project against a folder you choose; Quick spins up a sandbox in ~/Viberia/Tutorial-Demo/ so you can try the app without committing anything to your own work.
  6. Choose a folder. Guided only — pick the project root for the work you’ll do. Quick skips this and uses the sandbox.
  7. Watch HQ drop. The map zooms to an empty region, the new territory rises into place, and HQ lands at its center. This is the first time you see the World Map in motion.
  8. Set up the team (Guided) or run the demo builder (Quick). Place a CodeForge building, accept the Planner/Developer/Reviewer trio, and confirm.
  9. Team in action (Guided) or demo in action (Quick). The CoS routes a small example to the Dean, who routes it to the right agent. You watch the chat stream in.
  10. First real task. A hands-on prompt: “Add a button that says ‘Hello, Viberia’”. You actually send it; the agent actually does the work.
  11. Handoff. Once the first task lands, the tutorial steps aside and points you at the /onboarding skill (Guided) or a quick-start summary (Quick).

The remaining scenes are short transitions, recaps, and consent confirmations between the major beats above; the experience reads as a single continuous flow, not 14 separate dialogs.

You can move between scenes with Next and Back controls in the tutorial dialog, and exit at any time with the Skip tutorial button. Skipping doesn’t disable the tutorial — it just dismisses it for now. The tutorial remembers where you were and offers to resume on next launch.

To re-run the tutorial later, go to Settings → Tutorial and pick Reset and re-run. Doing this clears the tutorial progress flag and restarts the flow from scene 1. It does not delete projects you’ve already created — your portfolio is untouched.

UI Indicators

Section titled “UI Indicators”
  • Tutorial overlay — a translucent layer over the World Map with the active scene’s callouts and dialog.
  • Callout outlines — the tutorial highlights specific UI elements (MiniMap, HudShelf, CoS tab) with animated outlines.
  • Scene counter in the dialog, e.g. “Step 3 of 14”.
  • Next and Back buttons at the bottom of the tutorial dialog.
  • Skip tutorial link in the dialog footer.
  • Resume prompt on next launch if you exit mid-flow.
  • Confetti or rise animation plays when HQ lands on the map in scene 7.
  • Sandbox banner appears in Quick mode to remind you the project is throwaway.

Use Cases

Section titled “Use Cases”
  • First-time onboarding. Run all 14 scenes the first time you launch and you’ll have a working project and your first agent reply by the end.
  • Try the app without committing to a real folder. Pick the Quick path to use the sandbox under ~/Viberia/Tutorial-Demo/.
  • Recover after a long pause. Resume the tutorial from where you left off using the prompt on the next launch.
  • Re-onboard a teammate. Open Settings → Tutorial and reset to walk a new user through Viberia on the same machine.
  • Refresh your memory. Re-run the tutorial after a major update to see what’s new in the guided flow.

Limitations

Section titled “Limitations”
  • The tutorial assumes at least one CLI binary is reachable. If you skip past the provider step without picking anything, the first-task scene won’t be able to run.
  • The Quick path’s sandbox lives at ~/Viberia/Tutorial-Demo/. If you delete that folder while the tutorial is mid-flow, the demo project will lose its disk root.
  • Skipping the tutorial doesn’t disable it — it’s offered again on next launch. To dismiss it permanently, complete it once or reset from Settings.
  • Re-running the tutorial doesn’t remove the sandbox project; if you don’t want it anymore, delete it from its HQ window.
Section titled “Related”