Skip to content
Octipus Logo Octipus

Web UI

The web UI is a Vite, React 19, and React Router client served separately from the Hono API. Run both with:

Terminal window
bin/octi start web

The default browser address is http://localhost:3007; the API defaults to port 3005.

The UI includes chat, agents and runs, artifacts, documents and knowledge, model and skill configuration, tools and MCP connections, permissions and secrets, hooks, tasks, profiles, evaluations, and administration pages. Availability depends on the configured providers, credentials, and the signed-in user’s role.

Browser login uses a cookie-backed session. State-changing API requests also use CSRF protection where required. Prefer the desktop/mobile authentication endpoint only for clients that cannot use browser cookies.

Because routes and navigation are still evolving during alpha, use the sidebar in the running version rather than treating a static route inventory as an API contract.