From 6ab667901da186a06b58a04948ace8e4e12cc81a Mon Sep 17 00:00:00 2001
From: iris <iris@hyperhive>
Date: Thu, 21 May 2026 20:13:30 +0200
Subject: [PATCH] agent page: link to the agent's forge profile
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add a '⬡ forge ↗' link to the per-agent page's meta row, next to
the stats + screen links. It opens the agent's Forgejo profile
(http://<host>:3000/<label> — the per-agent forge user is named
after the agent) in a new tab.

- web_ui.rs: StateSnapshot gains forge_present, true when the
  agent's forge-token file exists in the state dir (same signal
  that tells the agent it has a forge account).
- index.html / app.js: hidden link, shown + href-filled when
  forge_present, mirroring the existing gui_enabled/screen-link
  pattern. Host comes from window.location so it works off
  whatever host the page is served from.

closes #185
---
 docs/web-ui.md               |  4 ++++
 hive-ag3nt/assets/app.js     | 11 +++++++++++
 hive-ag3nt/assets/index.html |  3 +++
 hive-ag3nt/src/web_ui.rs     |  6 ++++++
 4 files changed, 24 insertions(+)

diff --git a/docs/web-ui.md b/docs/web-ui.md
index 69b0c47..9932694 100644
--- a/docs/web-ui.md
+++ b/docs/web-ui.md
@@ -358,6 +358,10 @@ Layout, top to bottom:
 
 - Banner (gradient shimmer while state=thinking).
 - Title with `↑ DASHB04RD` back-link (new tab) + `↻ R3BU1LD`.
+- Meta links row: `📊 stats →`, `🖥 screen →` (shown when
+  `gui_enabled`), and `⬡ forge ↗` (shown when `forge_present` —
+  links to the agent's Forgejo profile at `<host>:3000/<label>`,
+  new tab).
 - Status section: empty when online (alive-badge in the state
   row carries the signal), populated with the login form /
   OAuth URL when `status` is `needs_login_*`.
diff --git a/hive-ag3nt/assets/app.js b/hive-ag3nt/assets/app.js
index 5eec2d5..7cec661 100644
--- a/hive-ag3nt/assets/app.js
+++ b/hive-ag3nt/assets/app.js
@@ -677,6 +677,17 @@
       // Show the screen link when the weston VNC compositor is enabled.
       const screenLink = $('screen-link');
       if (screenLink) screenLink.style.display = s.gui_enabled ? '' : 'none';
+      // Show the forge profile link when this agent has a forge account.
+      // The forge runs on :3000 of the same host; the user is the label.
+      const forgeLink = $('forge-link');
+      if (forgeLink) {
+        if (s.forge_present) {
+          forgeLink.href = `http://${window.location.hostname}:3000/${s.label}`;
+          forgeLink.style.display = '';
+        } else {
+          forgeLink.style.display = 'none';
+        }
+      }
       renderTermInput(s.label, s.status === 'online');
       renderInbox(s.inbox || []);
       // Authoritative state comes from the harness via /api/state.
diff --git a/hive-ag3nt/assets/index.html b/hive-ag3nt/assets/index.html
index 0b80172..c38ef60 100644
--- a/hive-ag3nt/assets/index.html
+++ b/hive-ag3nt/assets/index.html
@@ -16,6 +16,9 @@
     <a href="/stats" style="color: var(--cyan); text-decoration: none;">📊 stats →</a>
     <a id="screen-link" href="/screen" target="_blank" rel="noopener"
        style="display:none; color: var(--cyan); text-decoration: none; margin-left: 1em;">🖥 screen →</a>
+    <a id="forge-link" href="#" target="_blank" rel="noopener"
+       title="this agent's profile on the hive forge"
+       style="display:none; color: var(--cyan); text-decoration: none; margin-left: 1em;">⬡ forge ↗</a>
   </p>
 
   <div id="status">
diff --git a/hive-ag3nt/src/web_ui.rs b/hive-ag3nt/src/web_ui.rs
index 123a1ae..6e17024 100644
--- a/hive-ag3nt/src/web_ui.rs
+++ b/hive-ag3nt/src/web_ui.rs
@@ -383,6 +383,11 @@ struct StateSnapshot {
     /// (i.e. `/etc/hyperhive/gui.json` was present at harness startup).
     /// When true, the UI may render a `🖥 screen` link to `/screen`.
     gui_enabled: bool,
+    /// Whether this agent has a Forgejo account wired — its
+    /// `forge-token` file exists in the state dir. When true the UI
+    /// links to the agent's forge profile at `<host>:3000/<label>`
+    /// (the per-agent forge user is named after the agent).
+    forge_present: bool,
 }
 
 #[derive(Serialize)]
@@ -485,6 +490,7 @@ async fn api_state(State(state): State<AppState>) -> axum::Json<StateSnapshot> {
         ctx_usage,
         cost_usage,
         gui_enabled: state.gui_vnc_port.is_some(),
+        forge_present: crate::paths::state_dir().join("forge-token").is_file(),
     })
 }