Skip to content

Navigating the App

Polaris has two planes, chosen automatically by your account type when you sign in:

  • Tenant workspace — where you build and use a brain. Most users live here.
  • Platform Console — a fleet operator console for platform admins.

This page covers the tenant workspace.

The left rail

Every tenant screen has a fixed icon rail down the left edge. It is grouped top to bottom:

Group Items
Brain context The current brain's mark. (Platform admins get a tenant switcher here to impersonate any tenant.)
Dashboard The landing summary.
Agents Advisor · Librarian · Scout · Sentinel
Workspace Organization · Wiki · Workspace · Cost* · Settings
Account Notifications and a user / sign-out flyout.

* Cost is visible only to Curators and Admins.

Two ways to work with an agent

Each agent offers two surfaces:

  • Dashboard

    The full working surface — queues, policies, stat tiles, and review sheets. This is where the detailed guides in this section focus.

  • Conversational chat

    A chat drawer for the same agent (at /b/<brain>/agent/<agent>), for driving it in natural language. It shares the same underlying capabilities and role gates.

Reading the interface

A few conventions recur everywhere:

  • State pills — coloured badges show brain state (Empty / Building / Published) and object status (e.g. a change set that is pending, approved, or published).
  • Stat tiles — the row of numbers at the top of most dashboards (sources, facts, entities, open flags, etc.).
  • Locked controls — an action outside your role appears dimmed with a lock icon and a tooltip; read-only panels simply omit the edit affordances.
  • Async runs with progress — long operations (Scout run, Sentinel sweep, Certify) show a live percentage while they work, then a toast summarising the outcome.
  • Toasts — the transient notifications (bottom of screen) that confirm success or explain an error after any action.

Signing in

Access is guarded end to end: an unauthenticated visit shows the login screen; after sign-in you land on your brain's Dashboard (tenant users) or the Platform Console (platform admins).