Using the App
A screen-by-screen guide to the AKOS web and desktop application.
AKOS is available as a web application (multi-tenant SaaS, runs in any modern browser) and as a desktop application (self-hosted, runs on your own machine or private cloud). Both surfaces share the same UI — this guide applies to both unless noted.
App layout
The app is organised around a left-hand navigation rail that groups every screen into sections. Within each screen, a secondary section rail (left sidebar or top tabs depending on screen width) lets you switch between sub-sections without leaving the page.
Every screen has a consistent header: a kicker label, a title, an optional subtitle with live counts, and an actions bar on the right. Content appears in the main area below.
Navigation sections
| Section | Screens |
|---|---|
| Build | Agents, Workflows, Templates, Triggers |
| Operations | Inbox, Runs, Observability, Cost, Marketplace |
| Data | Knowledge, Assets |
| Governance | Governance, Audit |
| Workspace | Connections, Workspaces, Config |
| Tools | Tools, Evals, Coding |
Web vs desktop
| Web | Desktop | |
|---|---|---|
| Authentication | SSO / email sign-in | Workspace config file |
| Workspace | Cloud-managed | Local or private server |
| LLM tokens | Stored in the cloud vault | Stored on the local machine |
| Multi-workspace | Yes — switch in the top bar | Yes — open multiple workspace files |
Workspaces
A workspace is the top-level unit of isolation. Every agent, flow, trigger, secret, and audit entry belongs to exactly one workspace. On the web, you are invited to a workspace by an admin. On the desktop, you open or create a workspace file.
The current workspace name is shown in the top bar. To switch workspaces, use the workspace switcher in the top bar.
Command palette
Press Cmd K (Mac) or Ctrl K (Windows / Linux) from any screen to open the command palette. You can jump to any screen or trigger any registered action without using the navigation.