Hivra
Get started

A tour of the dashboard

What each screen in the signed-in dashboard is for, what you will find on it, and when to go there.

How the dashboard is laid out

The dashboard is organised around two kinds of thing you own: agents and computers. Each agent has a computer of its own, and a computer can also exist without an agent. Almost every screen is either a list of those things, a way to start a new one, or a page about one you already have.

You do not need to learn all of it. For day-to-day work you use three places: Home to open something, Launch to start something, and the agent page to work. The rest is where you go when something changes, such as a new plan, a new server or a problem.

ScreenUse it toWhere it is
HomePick the agent or computer you want to work inSidebar, first item
LaunchStart a new agent or computerSidebar, button under the search box
AgentsSee every agent and browse what you can launchSidebar
ComputersSee every computer and start a computer without an agentSidebar
ActivityRead what your agents did and what needs youSidebar
SettingsAccount, keys, shared memory, tools, templates, themeSidebar, lower section
BillingPlan, payment methods, creditsSidebar, lower section
ServersAdd your own machine or cloud account as capacitySidebar, lower section
Applications and HelpInstall the web app, get supportSidebar, bottom

Everything on this page describes the hosted dashboard. A self-hosted Hivra hides Billing, because there is nothing to bill, and hides the Usage view in Activity.

The sidebar and the rail

The left sidebar is on every dashboard page. Top to bottom it holds the following.

  • The Hivra mark and a collapse button. The mark always takes you to Home. The small arrow beside it collapses the sidebar to a narrow rail of icons, each with a short label under it (Applications shows as Apps). On a narrow screen the sidebar can show as a rail too.
  • Switch or search. Opens a switcher where you can jump straight to any agent or computer by name. The shortcut is Cmd K on a Mac and Ctrl K elsewhere.
  • Launch. The way in to starting something new.
  • Home, Agents, Computers and Activity. Your daily screens. When you have used something recently, a Continue link with its name appears under Home and takes you back to where you left it.
  • Need you. A badge with a count that appears only when an agent or computer needs you, for example a launch that failed or an agent waiting on an approval. It opens Home filtered to just those items.
  • Settings, Billing and Servers, then Applications and Help.
  • Your account. Your avatar menu, your name and email, your account code, and a light or dark theme toggle.

On a phone the sidebar becomes a bottom bar with Home, Agents, Launch and Computers, plus a More menu. More holds Activity, Settings, Billing and Servers under Manage, and Applications and Help under Help, along with your account and the theme switch.

Your account code is a short code shown in the sidebar and in Settings. Hivra's server setup command shows the same code before it connects a server to your account, so you can check the two match. If they differ, stop and do not continue.

Home: pick where you work

Home is the page you land on. It is headed Where will you work? and lists your agents and computers as cards. Each card shows the name, the type, whether it is running, and for an agent the computer it runs on and that computer's size.

Hivra Home listing three sample agents and one sample computer as cards, with a search box and a Launch link
Home with sample data: agents above, computers below, and the Launch link at the bottom. Your own list will show your names and sizes.

What you can do here:

  • Open something. Select a card. A running agent says Open agent. A running computer says Open desktop, or Open computer if it has no desktop, and a sandbox says Open sandbox. An item that needs you says Open to respond. A stopped one says View details, because there is nothing to work in until you start it.
  • Search. Type in Find an agent or computer. Matching narrows both lists at once. The day-one checklist is hidden while you search or view items that need you.
  • Pick up where you left off. If you have been working in something, it is offered first, with a Recent row of the others you used lately.
  • See what needs you. When any item needs attention, a button reads, for example, 1 needs attention. It switches the page to Needs your attention, where each item says what is wrong and what to do about it. Retry buttons such as Try again and Launch again are on the card, and an approval an agent is waiting on can be answered on its card. A question opens the agent's chat instead, with an Open to respond button. Show all agents and computers takes you back.
  • Launch an agent or computer. The link at the bottom of the list.

If you have nothing yet, Home shows a short first-run card in place of the list instead of an empty page. After your first launch, a small day-one checklist may appear above the list for a while.

When you reopen the app itself on Home, Hivra can take you straight back into the agent you were last in, if it is running. You will see Opening and its name, with a link to Choose another agent or computer. Choosing Home from the sidebar, or the Hivra mark, always shows the list instead.

Launch: start an agent or a computer

Launch is the one place to start anything. It has two steps, shown as Choose and Review.

  1. Open Launch from the sidebar. The first step is headed What do you want to launch? and has two groups: An agent and A computer.
  2. Select a tile. Each supported agent has one, and each tile says briefly what it is for and whether it suits your current setup.
  3. On Review and launch you name it, see where it runs, choose its size, decide how it gets its AI model, and see the Cost before anything starts.
  4. Select the Launch button at the bottom. It names what you are about to start.
The Launch Choose step listing the agent tiles, each with a short description
Launch step 1 (Choose) with sample data: one tile per agent, each saying whether it fits your plan.
The Launch Review step for a sample Codex agent showing where it runs, size, browser toggle, model access choices and cost
Launch step 2 (Review and launch) with sample data: where it runs, size, model access and the Cost row. The balance shown is a sample.

After you confirm, the page tells you what is happening: that your agent's computer is being created, that it is setting up, or, if something failed, that it could not start, with a way back to Review. If you leave and come back to Launch partway through, it asks whether to continue the launch you started or start a new one.

Every computer that Hivra Cloud runs for you needs a paid plan, from $9.99 a month for 2 vCPU and 4 GB of RAM. A free account works with a computer or server you connect yourself.

The full walk through, including the model choices and what to do when a launch fails, is in Launch your first agent. How the model is paid for is in how your agent gets its model.

Agents: your list, and what you could launch

Agents is the inventory page. Its subtitle is Find your agent and return to its work. It lists every agent you have, including agents that were added to an existing computer, and it carries a Launch agent button.

Below your agents is a collapsed section, Browse agents you can launch. Open it to see each supported agent with a one-line description. Selecting one takes you to Launch with that agent already chosen, where Review shows where it would run, its size and its cost.

Use Agents rather than Home when you want the whole list in one place, or when you are looking for an agent that is stopped and want to check its state before opening it.

The agent page: where the work happens

Opening an agent takes you to its own page. This is where you will spend most of your time. It has its own sidebar, with the agent's name at the top. Select the name to switch to another agent or computer without going back to Home.

An agent page with a sidebar of Chat, Browser, Computer and Settings, a list of chats, and a sample conversation
An agent page on the Chat view, with a made-up conversation. The conversation text is sample data, not a real agent's work.

For Claude Code and Codex, the sidebar has four rows:

RowWhat is inside
ChatA message box and your chats with the agent. New chat starts another. Beside Chat there is also a view of the agent's own command line session.
BrowserA view-only look at the browser the agent drives, where the agent has one.
ComputerDesktop, which explains how to give the agent a desktop, plus Files and Terminal. Files opens first.
SettingsThe agent's settings, and Skills. Claude Code also has a Telegram view.

Other agents are organised the same way, but their first row opens the agent's own web app. For OpenClaw, Agent Zero, Aeon, Hermes and DeepSeek Harness that row is labelled Dashboard, with Files, Terminal and Settings beside it. OpenClaw also has a Browser row, and a Desktop entry may appear where the computer has one. Open your agent goes through which agent opens into what.

A few things worth knowing about the parts you will use most:

  • Files lists the agent's home folder. Where the agent works in repositories, a Files and Changes switch appears at the top and lets you flip between browsing and the changes the agent has made. Use it to look over what the agent wrote before you rely on it.
    Files view with a Files and Changes switch and a home folder listing
    Computer, Files, with a sample home folder listing. The Files and Changes switch is at the top where it is offered. Sample data.
  • Terminal is a plain shell on the agent's computer. It is the right place to start long-running work inside tmux.
  • Skills lists the skills installed on the agent, lets you add more with Add skills, and has a delete icon on each one.
    Skills with three sample installed skills, an Add skills button and a delete icon on each
    The Skills view with sample data: three sample skills, Add skills at the top right and a delete icon on each card.
  • Settings is described in the next section.

On a paid Hivra plan the computer stays on and keeps your files, sessions and login. A Claude Code or Codex run you start inside tmux in the computer's Terminal tab keeps going after you close the laptop. On Claude Code, work you send through Telegram, connected in the agent's Telegram tab, runs on the computer, not in your browser.

Agent settings: power, sign-in, size and updates

Settings on the agent page is the control panel for that one agent and its computer. A side list switches between sections, and which sections appear depends on what the computer supports.

An agent's Settings page on the Overview section, showing its size, where it runs, a Sign in again button, and Stop and Restart buttons
Settings, Overview section, with sample data. The side list on the left changes the section.
SectionWhat it holds
OverviewThe agent, its size, where it runs and whether it is signed in. Sign in again (Claude Code and Codex) or Change GitHub token (Aeon), Usage, and Power with Stop, Start and Restart. Rename is at the top.
AgentsAgents added to a computer, where the computer supports that.
Model & toolsThe model connection, tools and the browser setting.
ResourcesThe computer's size.
RecoveryRestore points and folder recovery, where the computer offers them.
Private networkPrivate access to the computer, where it is offered.
UpdatesUpdating the agent software and the connection service.
Run a commandA place to run a command on the computer, where it is offered.
AdvancedOn computers that offer it, Force off and Force restart, and other rarely needed controls.

Two controls on Overview are worth understanding before you need them.

  • Sign in again. (Aeon shows Change GitHub token here instead.) If Claude Code says you need to sign in, or stops answering because your sign-in ran out, sign in again here. Your files and chats stay as they are.
  • Power. Stop shuts the computer down and Start brings it back and Restart reboots in place. On computers that offer Force off, Stop also switches the computer off if it does not shut down in time. Stopping does not cancel your plan or any provider billing, so a stopped computer on a paid plan is still billed as that plan.

To keep an agent current, see Update an agent. To change which model it uses, see models and credits.

Computers: the machines under your agents

Computers lists every computer you own, whether it runs an agent or not. Its subtitle is Open your computer and return to its desktop or tools. It is the right place to start a computer with no agent on it, for example an Ubuntu Desktop you want to use yourself.

The Computers page with two sample Ubuntu Desktop computers, status filters and a Browse operating systems section
Computers with sample data: the list, the status filters and the collapsed operating systems section.
  • Launch computer opens Launch on the computer group.
  • Your computers shows each one with its type, size and status. A filter row narrows it to All, Running, Starting, Needs attention or Stopped, and Find a computer... searches by name. Refresh reloads the list.
  • Browse operating systems is a collapsed section for comparing computer types before you launch one. See Ubuntu Desktop and a Linux computer.
  • A line at the bottom points you to Open Agents if what you want is Codex, Claude Code or Hermes, because agents run on a computer of their own and are opened from Agents. A Capacity link next to it opens Servers.

A computer you open has a shorter list than an agent: Desktop, Terminal and Files where it has them, and Settings. A computer with no desktop has no Desktop row.

Activity: what your agents did

Activity answers two questions: what did my agents do, and does anything need me. It opens on a set of tabs.

TabWhat it shows
Needs youOnly present when something needs you. Each item says what happened and what to do.
HistoryYour saved record for roughly the last 30 days. Routine changes are not alerts. Search with Search activity... and filter by agent or by kind of activity. Load older events goes further back.
RunsThe steps an agent reported, in order. Select a step to inspect what was reported. A quiet run does not mean it finished.
UsageHosted dashboards only. Sessions, total tokens, an estimated cost, active days, which models and skills were used, and a daily token chart.

Selecting an event opens an inspector with What happened, then either What to do or Why this is here, and a Technical details disclosure for IDs and timings you can copy into a support message. A Sources disclosure lists what Hivra keeps a record of and when each computer last reported.

Treat Activity as a record of what was reported, not a guarantee of what happened. If a computer has not reported yet it says so, and Refresh at the top of the page reloads everything. If some records could not be loaded, a notice says the history may be incomplete and offers Try again.

Usage figures are estimates built from what was recorded. Your real model bill comes from whoever supplies the model, which is covered in what you pay for.

Billing, Servers and the other pages under Manage

Billing is titled Plan & billing and has tabs for Overview, Plans, Payment methods, Credits and History. Overview shows your current plan and how much of its processor and memory is in use, with Change plan, Manage payment method and Cancel subscription. Credits and History appear only where those features are switched on for your account. Agent wallets are opened from the Wallets row in Settings. Plans, prices and the money-back terms are in what you pay for.

Servers is where you add capacity: Hivra-hosted, your own cloud account, or your own machine. The page is titled Your servers, and a first visit asks How would you like to add capacity? with three choices: Let Hivra host it, Use my cloud account and Connect my own machine.

The Add capacity chooser with three options: Let Hivra host it, Use my cloud account and Connect my own machine
The first-setup chooser with sample props. Connect my own machine is the third card.

Connecting a machine costs nothing in Hivra, and connecting does not buy a server. Once connected, servers are listed under Connected servers, and a launch can target one. Run agents on your own server covers requirements and both ways to connect.

Disconnecting a server deletes Hivra's key for it, so Hivra can no longer sign in. The page shows the command to remove the hivra user from the server itself if you want that too.

Applications says you can keep using Hivra in the browser with nothing to install, offers to add the Hivra web app to your Dock, desktop or Home Screen where your browser supports it, and links to your computers. Help has an email link for support, the community Discord, and the Terms and Privacy pages. When you write to support, include what you were trying to do and any error message, and leave out passwords and API keys.

Settings: account, keys and toolkit

Settings is a hub of short rows, grouped by purpose. Most rows open their own page.

The top of the Settings page with the Account, Plan and billing, API keys, Agent toolkit and On this device groups
The top groups of Settings with a sample account. The email, account code and avatar are made up, and the Apps and help and Reset this browser groups sit further down the page.
GroupRows
AccountProfile and sign-in for your name, email, security and sign-out, and your Account code.
Plan and billingBilling and Wallets.
Keys and connectionsAPI keys: your provider keys in one place, and which agents use them.
Agent toolkitShared agent memory, Tools and capabilities, Prompt library and Templates.
On this deviceTheme (Light, Dark or System) and Language.
Apps and helpApplications and Help.
Reset this browserClear the local cache.

The toolkit rows are the ones people tend to miss:

  • Shared agent memory is text that is given to every new agent you deploy, so they start out knowing the basics about you. Each agent still keeps its own notes as it works. It applies to agents you launch after you write it.
  • Tools and capabilities is a catalog of tools you can add to the agents you choose. They load on the agent's next message.
  • Prompt library holds ready-made agent roles with tested prompts.
  • Templates lets you save a configured agent and launch it again later. Each saved template has actions to copy a share link, launch from it and delete it.

Clear cache clears dashboard data cached in this browser and layout choices saved here, such as terminal tabs, then reloads the page. Your account, agents and computers are not affected. The first press arms it and the button then reads Press again to clear and reload. It disarms itself after about four seconds if you do nothing.

When something goes wrong

What you seeWhat it means and what to do
A 1 needs attention button on Home, or a count next to Need you in the sidebarSelect it. The filtered list says what is wrong on each card. Use Try again or Launch again where the card offers it.
A card says Last known: and a state, with View detailsHivra could not check that item just now, so it is showing the last state it knew. Open it for details, or use Refresh on the Computers page.
Some agents and computers couldn't be loaded. The rest are listed.One source of your list failed. Use the retry button beside the message.
Home shows Nothing matches that search.The search box still has text in it. Clear it.
An agent card says View details instead of Open agentIt is stopped. Open it, go to Settings, Overview, and use Start under Power.
The agent says you need to sign inOpen Settings and use Sign in again on Overview. Your files and chats are kept.
Activity could not be loaded. Refresh to try again. or Your session expired. Sign in again to load activity.Refresh, or sign in again. If it keeps happening, the rest of the dashboard may be affected too.
Some records could not be loaded. This history may be incomplete.Select Try again in the notice. Until it works, do not read a missing event as proof something did not happen.
Billing is missing from the sidebarYou are on a self-hosted Hivra, which has no billing.
Servers shows Connections could not be loaded.Reload the page. If a server you connected is not listed after that, check it is still reachable.

If an agent or computer is still stuck, Troubleshooting has fixes for the common causes.

What Hivra does and does not do

  • Hivra shows you the state it has recorded. When it cannot check, it says Last known instead of guessing.
  • Hivra does not guarantee that anything on a computer is backed up. Keep your own copies of anything you cannot lose.
  • Stopping a computer does not stop billing for your plan or for your own server provider.
  • Activity and Usage are records and estimates, not an invoice.
  • A separate computer is a boundary around your agent, not a guarantee that the agent is safe. Read security and access before you give an agent credentials.

Common questions

Where do I start a new agent?

Select Launch in the sidebar, or the Launch an agent or computer link at the bottom of Home. Launch has two steps, Choose and Review, and nothing starts until you confirm on Review.

What is the difference between Home, Agents and Computers?

Home lists both agents and computers and leads with what you used recently. Agents lists only agents and lets you browse what you can launch. Computers lists only computers, including ones with no agent, and is where you start a computer on its own.

Why does my agent say View details instead of Open agent?

That agent is not running, so there is nothing to work in yet. Open it, go to Settings, then Overview, and use Start under Power. If it needs attention, the card says what is wrong.

Where do I stop or restart an agent's computer?

Open the agent, choose Settings in its sidebar, and use Stop, Start or Restart under Power on the Overview section. Stopping does not cancel your plan.

Where is Billing?

Billing is in the lower part of the sidebar, and on a phone under More. It is also linked from Settings. A self-hosted Hivra does not show Billing.

What is the account code for?

It is a short code shown in the sidebar and in Settings. Hivra's server setup command shows the same code before it connects a server to your account. Continue only if the two codes match.

Can I use the dashboard on my phone?

Yes. On a phone the sidebar becomes a bottom bar with Home, Agents, Launch and Computers, and a More menu for Activity, Settings, Billing, Servers, Applications and Help.

Give your agent a computer of its own.

From $9.99/mo. Bring your own AI key. 7-day money-back guarantee on card payments.

Start Now