Product pages
Cockpit app
Orkestia Cockpit is the desktop app for people who run an Orkestia organization. It shows live agents, the decisions waiting on you, tickets, runners and apps, and it switches to Lumen for dashboards and observability
TL;DR
- Cockpit is a desktop app for macOS, Windows and Linux. It signs in with your Orkestia account and works in one organization at a time.
- It is where the work that needs a person lands. Decisions addressed to you, agents at work, tickets and what they produced, runners, apps and connections, in one window with a live connection to the platform.
- It has two modes. Cockpit is the operations view. Lumen turns the same window into dashboards, logs, error groups, traces, metrics, AI analytics, Pulse product analytics and billing. A switch in the window flips between them.
- It tells you when something needs you. A new decision addressed to you raises a desktop notification, and the Dock or taskbar badge and the tray tooltip show how many are waiting.
- It keeps working in the background. Closing the window hides it in the tray (menu bar). Quit from the tray menu.
- Nothing here is a second product. Every view reads the same platform your workflows, the console and the MCP server use. The app adds a desktop shell around them.
This section describes the desktop app only. The web version of the same views lives at
cockpit.orkestia.dev (the app opens it from Help › Open Cockpit on the Web and from the account menu).Who it is for
| You are | Use |
|---|---|
| An operator: you own or administer an organization, answer decisions, run agents and ship tickets | The full app. Sign in and read Install and sign in |
| A person with no organization yet | Sign in. The app walks you through creating one in a short chat: First run and onboarding |
| Someone who only needs the chat of an app that uses Orkestia | Choose Not an operator? Use app chats only on the sign-in screen. You get app chats and nothing else |
Three modes
Cockpit Today · Build · Run (Runners, Connections) · Organization, the Assistant and app chats
Apps Every app: how it is built, its health, infrastructure, people, data, files, settings and flags
Lumen Dashboards · Observe · AI · Pulse · Admin rules · Usage & API keys · Settings
| Cockpit | Apps | Lumen | |
|---|---|---|---|
| Answers | What is running, what needs me, what shipped | What apps do I have, are they up, what do they use | What my software is doing: logs, errors, traces, metrics, cost, plan |
| Sidebar | Today, Build, Run, Organization, then Assistant history | All apps, then each app with its health | Dashboards, Observe, AI, Pulse, Admin, Account |
| Data | The workflow platform | The platform's app hosting and sign-in services, plus Lumen metrics | lumen-api.orkestia.dev, the same service as lumen.orkestia.dev |
| Switch | Cockpit | Apps | Lumen at the top right of the window, in every mode, or ⌘K | Same control | Same control |
The mode is remembered across launches. ⌘K lists every Lumen page and dashboard from any mode. A red number on Apps counts the apps that failed or need a look. See Navigation and shortcuts.
Where things are
| In the sidebar | What it is | Read |
|---|---|---|
| Overview | The "Happening now" board: actors, runner instances, what needs you | Overview, Decisions and Activity |
| Decisions | The inbox of decisions agents are waiting on | Overview, Decisions and Activity |
| Activity | Agents and sessions at work | Overview, Decisions and Activity |
| Tickets | What the organization is working on, and what it produced | Tickets, Tickets and software delivery |
| Workflows | Build and run workflows | Workflows in Cockpit, Virtual workflows |
| Agents | Your team of agents and how it is organised | Agents and Coding, Staff and agents |
| Coding | Repositories and the coding lane | Agents and Coding, Run a ticket |
| Runners | Where work and CI run | Runners |
| Connections | Services the organization is connected to | Cloud connections |
| Organization | People, access and cost | Settings, Billing and seats |
| Apps (mode switch) | Every app, how it is hosted, how it is doing and what it uses | Apps mode, App infrastructure, App files, settings and flags, App modules, App environments, App Host |
| Lumen (mode switch) | Dashboards, logs, errors, traces, metrics, AI, Pulse, rules, billing | Lumen |
| Settings (⌘,) | AI tools on this computer, About | About, settings and updates |
Getting the app and signing in is covered in Install and sign in. If something does not behave, start at Troubleshooting.
What the app does not do
- It does not keep your data. The organization, its runs and its decisions live on the platform. The app caches only its own settings (appearance, sidebar arrangement, recent searches and similar) on your computer.
- It does not charge you. Payment during onboarding is a Stripe Checkout form shown inside the window, and the platform confirms the subscription.
Install and sign in
Platforms, updates, the browser sign-in, chats-only mode and switching organization.
First run and onboarding
Create the workspace, pay, connect GitHub or an AI provider, enter the cockpit.
Operate
Watch an app in production — a public readiness probe for sign-in, continuation grants for work that outlives a session, and where logs, hosting usage and troubleshooting live.
Overview, Decisions and Activity
The three Today views of Orkestia Cockpit — what "Needs you" counts, how to answer a decision, who a decision is addressed to, and how live updates and notifications work