diff --git a/heartbeat.html b/heartbeat.html
new file mode 100644
index 0000000..cd52dac
--- /dev/null
+++ b/heartbeat.html
@@ -0,0 +1,253 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0">
+<title>Nexus Heartbeat</title>
+<meta name="description" content="Sovereignty pulse — lightweight status monitor">
+<style>
+*{box-sizing:border-box;margin:0;padding:0}
+:root{
+  --bg:#000008;--surface:#0a0a18;--border:#1a1a33;
+  --text:#c8d8ff;--dim:#556;--accent:#4af0c0;
+  --green:#00ff88;--blue:#4488ff;--orange:#ff8c00;--red:#ff4444;
+  --font:system-ui,-apple-system,monospace;
+}
+body{background:var(--bg);color:var(--text);font-family:var(--font);font-size:14px;line-height:1.5;padding:12px;min-height:100vh}
+h1{font-size:18px;letter-spacing:3px;color:var(--accent);text-transform:uppercase;margin-bottom:4px}
+.subtitle{font-size:11px;color:var(--dim);letter-spacing:1px;margin-bottom:16px}
+.section{background:var(--surface);border:1px solid var(--border);border-radius:6px;padding:12px;margin-bottom:12px}
+.section-title{font-size:11px;letter-spacing:2px;color:var(--dim);text-transform:uppercase;margin-bottom:8px}
+.row{display:flex;justify-content:space-between;align-items:baseline;padding:3px 0;border-bottom:1px solid var(--border)}
+.row:last-child{border-bottom:none}
+.label{color:var(--dim);font-size:12px}
+.val{font-size:14px;font-weight:600}
+.big{font-size:22px;font-weight:700;color:var(--accent)}
+.status-dot{display:inline-block;width:8px;height:8px;border-radius:50%;margin-right:6px}
+.online{background:var(--green)}
+.idle{background:var(--blue)}
+.offline{background:var(--border)}
+.dormant{background:var(--border)}
+.working{background:var(--green)}
+.error{color:var(--red)}
+.tag{display:inline-block;font-size:10px;letter-spacing:1px;padding:1px 6px;border-radius:3px;border:1px solid;margin-left:6px;vertical-align:middle}
+.tag-manual{border-color:var(--orange);color:var(--orange)}
+.commit-hash{font-size:11px;color:var(--dim);font-family:monospace}
+.commit-msg{font-size:12px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:220px}
+.ts{font-size:11px;color:var(--dim)}
+.refresh-bar{height:2px;background:var(--border);border-radius:1px;margin-top:16px;overflow:hidden}
+.refresh-fill{height:100%;background:var(--accent);border-radius:1px;transition:width 1s linear}
+.footer{font-size:10px;color:var(--dim);text-align:center;margin-top:8px;letter-spacing:1px}
+@media(max-width:375px){body{padding:8px}.commit-msg{max-width:160px}}
+</style>
+</head>
+<body>
+<h1>&#9632; NEXUS HEARTBEAT</h1>
+<div class="subtitle" id="last-refresh">Loading…</div>
+
+<div class="section">
+  <div class="section-title">Sovereignty</div>
+  <div class="row">
+    <span class="label">Score</span>
+    <span><span class="big" id="sov-score">—</span>%
+      <span class="tag tag-manual" id="sov-tag"></span>
+    </span>
+  </div>
+  <div class="row">
+    <span class="label">Status</span>
+    <span class="val" id="sov-label">—</span>
+  </div>
+  <div class="row">
+    <span class="label">Local / Cloud</span>
+    <span class="val" id="sov-split">—</span>
+  </div>
+</div>
+
+<div class="section">
+  <div class="section-title">Environment</div>
+  <div class="row">
+    <span class="label">Bitcoin Block</span>
+    <span class="val" id="btc-block">—</span>
+  </div>
+  <div class="row">
+    <span class="label">Weather</span>
+    <span class="val" id="weather-val">—</span>
+  </div>
+  <div class="row">
+    <span class="label">Wind</span>
+    <span class="val" id="weather-wind">—</span>
+  </div>
+  <div class="row">
+    <span class="label">Cloud Cover</span>
+    <span class="val" id="weather-cloud">—</span>
+  </div>
+</div>
+
+<div class="section">
+  <div class="section-title">Portals</div>
+  <div id="portals-list"><span class="ts">Loading…</span></div>
+</div>
+
+<div class="section">
+  <div class="section-title">Agents</div>
+  <div id="agents-list"><span class="ts">Loading…</span></div>
+</div>
+
+<div class="section">
+  <div class="section-title">Recent Commits</div>
+  <div id="commits-list"><span class="ts">Loading…</span></div>
+</div>
+
+<div class="refresh-bar"><div class="refresh-fill" id="refresh-fill" style="width:100%"></div></div>
+<div class="footer" id="footer-status">AUTO-REFRESH 60s</div>
+
+<script>
+const GITEA = 'http://143.198.27.163:3000/api/v1';
+const REPO  = 'Timmy_Foundation/the-nexus';
+const REPOS = [REPO, 'Timmy_Foundation/hermes-agent'];
+const AGENTS = ['Claude','Kimi','Perplexity','Groq','Grok','Ollama'];
+const WEATHER_LAT = 43.2897, WEATHER_LON = -72.1479;
+const REFRESH_MS = 60000;
+
+function wmoLabel(c){
+  if(c===0)return'Clear';
+  if(c<=2)return'Partly Cloudy';
+  if(c===3)return'Overcast';
+  if(c<=49)return'Fog';
+  if(c<=67)return'Rain';
+  if(c<=77)return'Snow';
+  if(c<=82)return'Showers';
+  return'Thunderstorm';
+}
+
+function timeAgo(iso){
+  const d=Math.floor((Date.now()-new Date(iso))/1000);
+  if(d<60)return d+'s ago';
+  if(d<3600)return Math.floor(d/60)+'m ago';
+  if(d<86400)return Math.floor(d/3600)+'h ago';
+  return Math.floor(d/86400)+'d ago';
+}
+
+function set(id,v){const el=document.getElementById(id);if(el)el.textContent=v;}
+function html(id,v){const el=document.getElementById(id);if(el)el.innerHTML=v;}
+
+async function loadSovereignty(){
+  try{
+    const r=await fetch('./sovereignty-status.json');
+    const d=await r.json();
+    set('sov-score',d.score??'—');
+    set('sov-label',d.label??'—');
+    set('sov-split',(d.local??'—')+'% local / '+(d.cloud??'—')+'% cloud');
+    const tag=document.getElementById('sov-tag');
+    if(tag)tag.textContent=d.assessment_type||'';
+  }catch{set('sov-score','ERR');set('sov-label','Unavailable');}
+}
+
+async function loadBTC(){
+  try{
+    const r=await fetch('https://blockstream.info/api/blocks/tip/height');
+    const h=await r.text();
+    set('btc-block','#'+parseInt(h).toLocaleString());
+  }catch{set('btc-block','Offline');}
+}
+
+async function loadWeather(){
+  try{
+    const url=`https://api.open-meteo.com/v1/forecast?latitude=${WEATHER_LAT}&longitude=${WEATHER_LON}&current=temperature_2m,weather_code,wind_speed_10m,cloud_cover&temperature_unit=fahrenheit&wind_speed_unit=mph&forecast_days=1`;
+    const r=await fetch(url);
+    const d=await r.json();
+    const cur=d.current;
+    set('weather-val',Math.round(cur.temperature_2m)+'°F — '+wmoLabel(cur.weather_code));
+    set('weather-wind',Math.round(cur.wind_speed_10m)+' mph');
+    set('weather-cloud',Math.round(cur.cloud_cover)+'%');
+  }catch{set('weather-val','Offline');}
+}
+
+async function loadPortals(){
+  try{
+    const r=await fetch('./portals.json');
+    const portals=await r.json();
+    const el=document.getElementById('portals-list');
+    el.innerHTML=portals.map(p=>{
+      const cls=p.status==='online'?'online':'offline';
+      return`<div class="row"><span class="label"><span class="status-dot ${cls}"></span>${p.name}</span><span class="val" style="font-size:12px">${p.status.toUpperCase()}</span></div>`;
+    }).join('');
+  }catch{html('portals-list','<span class="error">Unavailable</span>');}
+}
+
+async function loadAgents(){
+  try{
+    const DAY=86400000, HOUR=3600000, now=Date.now();
+    const allCommits=await Promise.all(REPOS.map(async repo=>{
+      try{
+        const r=await fetch(`${GITEA}/repos/${repo}/commits?sha=main&limit=50`);
+        if(!r.ok)return[];
+        return await r.json();
+      }catch{return[];}
+    }));
+
+    const el=document.getElementById('agents-list');
+    el.innerHTML=AGENTS.map(name=>{
+      const low=name.toLowerCase();
+      const commits=allCommits.flat().filter(c=>(c.commit?.author?.name||'').toLowerCase().includes(low));
+      commits.sort((a,b)=>new Date(b.commit.author.date)-new Date(a.commit.author.date));
+      let status='dormant',lastMsg='No recent activity';
+      if(commits.length){
+        const dt=new Date(commits[0].commit.author.date).getTime();
+        const age=now-dt;
+        status=age<HOUR?'working':age<DAY?'idle':'dormant';
+        lastMsg=timeAgo(commits[0].commit.author.date);
+      }
+      return`<div class="row"><span class="label"><span class="status-dot ${status}"></span>${name}</span><span class="ts">${lastMsg}</span></div>`;
+    }).join('');
+  }catch{html('agents-list','<span class="error">Unavailable</span>');}
+}
+
+async function loadCommits(){
+  try{
+    const r=await fetch(`${GITEA}/repos/${REPO}/commits?sha=main&limit=5`);
+    if(!r.ok)throw new Error();
+    const commits=await r.json();
+    const el=document.getElementById('commits-list');
+    el.innerHTML=commits.map(c=>{
+      const hash=(c.sha||'').slice(0,7);
+      const msg=(c.commit?.message||'').split('\n')[0];
+      const ago=timeAgo(c.commit?.author?.date||'');
+      const author=(c.commit?.author?.name||'').split(' ')[0];
+      return`<div class="row" style="flex-direction:column;align-items:flex-start;gap:2px">
+        <div style="display:flex;justify-content:space-between;width:100%">
+          <span class="commit-hash">${hash}</span>
+          <span class="ts">${author} · ${ago}</span>
+        </div>
+        <span class="commit-msg">${msg}</span>
+      </div>`;
+    }).join('');
+  }catch{html('commits-list','<span class="error">Unavailable</span>');}
+}
+
+let countdown=REFRESH_MS/1000;
+let fillInterval;
+
+function startCountdown(){
+  clearInterval(fillInterval);
+  countdown=REFRESH_MS/1000;
+  const fill=document.getElementById('refresh-fill');
+  fillInterval=setInterval(()=>{
+    countdown--;
+    if(fill)fill.style.width=Math.max(0,(countdown/(REFRESH_MS/1000))*100)+'%';
+    if(countdown<=0)clearInterval(fillInterval);
+  },1000);
+}
+
+async function refresh(){
+  const now=new Date();
+  set('last-refresh','Last refresh: '+now.toLocaleTimeString());
+  await Promise.all([loadSovereignty(),loadBTC(),loadWeather(),loadPortals(),loadAgents(),loadCommits()]);
+  startCountdown();
+}
+
+refresh();
+setInterval(refresh, REFRESH_MS);
+</script>
+</body>
+</html>
