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.
- Use it when you want to see your agents' activity, cost and checks on one screen.
- Use something else when you want the same answers in a terminal:
hero efficiency,hero traceorhero health. - Reads or changes:
hero portalstarts the Portal.--install-serviceand--uninstall-serviceadd or remove its background service.openand--service-statuschange nothing.
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
| Subcommand | What it does | Reads or changes |
|---|---|---|
open | Opens 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
| Argument | Type | Required | Default | Allowed values | What it does |
|---|---|---|---|---|---|
--port <port> | Number | No | HERO_PORTAL_PORT, else 7878 | 1 to 65535 | The 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-service | Flag | No | Off | Installs the Portal as a background service that starts again after a restart: a LaunchAgent on Mac, a systemd user service on Linux. | |
--uninstall-service | Flag | No | Off | Stops and removes the background Portal. | |
--service-status | Flag | No | Off | Shows whether the background Portal is installed and running. | |
--help, -h | Flag | No | Off | Prints the help. hero portal help and hero help portal print the same. |
How hero portal runs and signs you in
- On your machine only. The Portal listens on
127.0.0.1, so only programs on this machine can reach it. - Sign-in.
hero portal openopens your browser on a one-time sign-in link. Only the user who started the Portal can read the link. The Portal makes a new link each time one is used, so a link left in browser history doesn't work again. - Background service. The installer sets the Portal up as a background service, unless you install with
EKAMYTH_INSTALL_NO_SERVICE=1. Started from a terminal instead, the Portal stops when that terminal closes, and it says so when it starts. - What it shows. Monitor is the main screen. See How Monitor works. The Brain page shows your SOUL, MEMORY and PARA files; you can save and edit them, undo the last note, and restore an earlier saved version.
Get started with hero portal
Before you start: Ekamyth Agent OS is installed.
Check whether the background Portal is running.
hero portal --service-statusOpen it, signed in.
hero portal openYou should see
opened the portal in your browser, and the Portal opens in your browser.If step 2 says there's no running Portal, start one in this terminal, then run
hero portal openin another terminal.hero portalYou 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
| Line | What 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 open | Opening 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-service | Printed when you start it in a terminal. |
opened the portal in your browser | hero 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
| Code | Meaning | What to do |
|---|---|---|
0 | Done, or the Portal stopped with Ctrl-C. | Nothing. |
1 | The 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. |
2 | Refused: a word or flag hero portal doesn't take. | Use the forms in the Synopsis. |
3 | This 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
| Name | Kind | Purpose |
|---|---|---|
HERO_PORTAL_PORT | Environment variable | The Portal's port when --port isn't given. Default 7878. |
~/Library/LaunchAgents/com.ekamyth.hero-portal.plist | Service definition (Mac) | Written by --install-service, removed by --uninstall-service. |
~/.config/systemd/user/hero-portal.service | Service definition (Linux) | Written by --install-service, removed by --uninstall-service. |
Limits of hero portal
| Limit | Behaviour | Can you change it? | What to do |
|---|---|---|---|
| Where you can open it | Only on this machine, at 127.0.0.1. | No | None. |
| Sign-in link | Each link works once. | No | Run hero portal open again. |
| Started in a terminal | It stops when the terminal closes. | Yes | hero portal --install-service. |
| Monitor counts | Some Monitor counts can differ from the terminal: rule coverage, pending approvals, governance decisions and block counts. | No | Trust the terminal: hero enforce, hero inbox, hero govern status and hero attest rules. |
| Open trace | Monitor's Open trace can show no steps for a session that hero trace shows. | No | Run hero trace show <id>. |
| Views | Monitor, Control for your own work, and the Brain page. | No | None. |
Commands related to hero portal
Checked against Agent OS 0.1.36rc14 (build 599c5e120c18) on 17 Nov 2026.