Reference
Console guide
The console is a Next.js web app that sits on the same enforcement core as the API. It is the fastest way to explore an index, run searches, and read the cost/latency trace.
Signing in#
The console requires a session — every route except /login and /signup is guarded. Visiting any protected path while signed out redirects to /login?next=… so you return to where you were headed.
- Password — email + password sign-in.
- Email code — a one-time 6-digit code.
- Magic link — a sign-in link by email.
- Google — available once OAuth credentials are configured.
Sessions map to principals
Principal shape as an API token, so the scope clamp and ACL filter behave identically whether you use the UI or the REST API.Workspace: namespace & scope#
The console is organized around a workspace URL of the form /<namespace>/<scope>. The active namespace and scope are persisted, and the root path redirects you into a scope you actually own — a brand-new account is auto-provisioned its own namespace and a starter scope on first sign-in, so you land on writable data rather than the shared demo tenant. The namespace switcher lists every namespace you own (see multi-namespace tenancy), and the scope you pick drives the same effective-scope resolution described in the Security model.
Overview#
The workspace overview surfaces the catalog KPIs from GET /v1/catalog/stats — per-plane vector counts and health, catalog row totals, and query counters — so you can see the shape of the index at a glance.
Search playground#
The search page is a live playground for POST /v1/search. Enter a natural-language query, choose planes and options, and inspect results with their Locators. The trace panel breaks down each pipeline stage’s latency and compute cost, and the ACL banner reports how many results were hidden from you.
Unit browser & inspector#
The browser lists Units in the active scope (backed by GET /v1/units), ACL- filtered to what you are allowed to see, with lazy pagination. Open a Unit to inspect its full row plus a structured Locator and preview overlays.
Plan & billing#
The console is tier-aware: features above your plan surface an upgrade prompt that routes to the billing page, which reads the live plans and starts a Stripe checkout. See Pricing & billing.
Coming soon in the console#
A few surfaces are honest stubs today (marked “coming soon” in the nav) and are not yet functional: the conversational Agent and Query-the-DB tabs, saved queries & dashboards, Crawlers, Schedulers, Compute, Observability, and Integrations / Settings. See the Roadmap.