Ekamyth Agent OS docs
Standard OS / Processes

hero portal

Starts the Portal on your machine and opens it, signed in, in your browser. The Portal's main screen is Monitor.

What hero portal does

It answers: how do I open the Portal? The Portal runs on your machine at http://127.0.0.1:7878 and has three views: Monitor, Control for your own work, and the Brain page. Control has eight tabs: Overview, Changes, Govern, Models & Routing, Budgets & Rates, Data & Integrations, Audit and Emergency. hero portal open signs you in.

Synopsis for hero portal

hero portal [--port <port>]
hero portal open
hero portal --install-service [--port <port>]
hero portal --uninstall-service
hero portal --service-status
hero portal --help

Subcommands of hero portal

SubcommandWhat it doesReads or changes
openOpens the running Portal in your browser, signed in.Reads
(none)Starts the Portal in this terminal. Ctrl-C stops it.Starts a service

Arguments for hero portal

ArgumentTypeRequiredDefaultAllowed valuesWhat it does
--port <port>NumberNoHERO_PORTAL_PORT, else 78781 to 65535The port the Portal listens on. It wins over HERO_PORTAL_PORT. A busy port is refused; the Portal never moves to another port by itself.
--install-serviceFlagNoOffInstalls the Portal as a background service that starts again after a restart: a LaunchAgent on Mac, a systemd user service on Linux.
--uninstall-serviceFlagNoOffStops and removes the background Portal.
--service-statusFlagNoOffShows whether the background Portal is installed and running.
--help, -hFlagNoOffPrints the help. hero portal help and hero help portal print the same.

How hero portal runs and signs you in

Get started with hero portal

Before you start: Ekamyth Agent OS is installed.

  1. Check whether the background Portal is running.

    hero portal --service-status
  2. Open it, signed in.

    hero portal open

    You should see opened the portal in your browser, and the Portal opens in your browser.

  3. If step 2 says there's no running Portal, start one in this terminal, then run hero portal open in another terminal.

    hero portal

    You should see the Portal's address and a sign-in line. See How to read the output.

To keep a Portal running after you close the terminal:

This command will:

  • Register the Portal as a background service for your user.
hero portal --install-service

To undo it, run hero portal --uninstall-service.

How to read hero portal output

LineWhat it means
Ekamyth Portal → http://127.0.0.1:<port> (Ctrl-C to stop)The Portal is listening on that address. The port is the one it actually bound.
sign in from this machine: hero portal openOpening the address on its own doesn't sign you in. Run hero portal open.
· this Portal stops when this terminal closes — keep it running: hero portal --install-servicePrinted when you start it in a terminal.
opened the portal in your browserhero portal open worked.

More hero portal examples

Example 1. To run the Portal on another port

hero portal --port 7900

Then run hero portal open. It opens the Portal on the port it's running on.

Example 2. To remove the background Portal

hero portal --uninstall-service

Example 3. To sign in on a machine with no browser it can open

hero portal open

It prints the one-time link instead. Paste it into a browser on the same machine. It works once.

Exit codes and errors for hero portal

CodeMeaningWhat to do
0Done, or the Portal stopped with Ctrl-C.Nothing.
1The port is busy or invalid, there's no running Portal to open, no browser could be opened, or a service step failed.Read the message.
2Refused: a word or flag hero portal doesn't take.Use the forms in the Synopsis.
3This install's Portal files are missing or incomplete.Reinstall Agent OS. See Install, upgrade and remove.

The messages, as the build prints them:

hero portal open: no running portal to open — start it: hero portal
hero portal open: no browser to open — paste this link (works once): <link>
hero portal: port 7878 is already in use — is a portal already running?
  check: curl -s localhost:7878/healthz
  open it: hero portal open
hero portal: --port needs a port number, e.g. hero portal --port 7900
hero portal: --port 70000 is not a valid port (1-65535)
hero portal: this install's Portal bundle is missing or incomplete (portal_v2_build_unavailable) — reinstall Ekamyth Agent OS to restore it.

Files and environment for hero portal

NameKindPurpose
HERO_PORTAL_PORTEnvironment variableThe Portal's port when --port isn't given. Default 7878.
~/Library/LaunchAgents/com.ekamyth.hero-portal.plistService definition (Mac)Written by --install-service, removed by --uninstall-service.
~/.config/systemd/user/hero-portal.serviceService definition (Linux)Written by --install-service, removed by --uninstall-service.

Limits of hero portal

LimitBehaviourCan you change it?What to do
Where you can open itOnly on this machine, at 127.0.0.1.NoNone.
Started in a terminalIt stops when the terminal closes.Yeshero portal --install-service.
Monitor countsSome Monitor counts can differ from the terminal: rule coverage, pending approvals, governance decisions and block counts.NoTrust the terminal: hero enforce, hero inbox, hero govern status and hero attest rules.
Open traceMonitor's Open trace can show no steps for a session that hero trace shows.NoRun hero trace show <id>.
ViewsMonitor, Control for your own work, and the Brain page.NoNone.

Checked against Agent OS 0.1.36rc14 (build 599c5e120c18) on 17 Nov 2026.