Skip to main content

Getting Started

This section is for the first 10 minutes with Routa: what it is, which surface to choose, and what "working" should look like after setup.

Choose Your Surface​

Desktop Recommended for most users. Install from GitHub Releases and use the full workspace, session, kanban, and team UI. CLI Best for terminal-first usage. Install with npm install -g routa-cli and start with prompts, scripting, or ACP/runtime inspection. Web Best for browser-based access and self-hosting. Run from source when you want the browser runtime rather than the packaged desktop path.

If you only want the shortest path to a successful first run, start with Quick Start and choose Desktop or CLI.

What To Do First​

Do not try to learn the whole product on day one. Reach one useful outcome first:

Step 1

Pick One Surface

Choose Desktop, CLI, or Web based on how you already work.

Open Quick Start
Step 2

Enable One Provider

You only need one working provider and one valid model path to get moving.

Open Configuration
Step 3

Run Against A Real Repo

Attach a codebase or open a repository, then start with a Session or one CLI prompt.

Open Use Routa
  1. Read Quick Start to pick Desktop, CLI, or Web.
  2. Follow the matching platform page for install and first-run steps.
  3. Open Configuration if you still need a provider or model.
  4. Read Core Concepts once the product is already running.

What "Started" Means In Routa​

You are successfully onboarded once you can do all of the following:

  • create or enter a workspace
  • make one provider available
  • attach a repository
  • launch either a Session, Kanban flow, or Team run

Entry Points In This Section​

  • Quick Start: fast install and first-run path
  • Changelog: release notes and release history entry points
  • Platforms: Desktop, CLI, and Web as separate runtime surfaces