feat: show data layer terminal dashboard by default

Author: codejunkie99

.agent/skills/_index.md

@@ -30,7 +30,7 @@ requires human approval for production.
 ## data-layer
 Cross-harness activity monitoring and dashboard exports.
 Triggers: "data layer", "dashboard", "agent analytics", "resource usage",
-"cron monitoring", "daily report", "tokens"
+"cron monitoring", "daily report", "tokens", "terminal dashboard"
 Constraints: local-only by default; no screenshot delivery without explicit user
 approval; do not commit private `.agent/data-layer/` exports.
 

.agent/skills/_manifest.jsonl

@@ -3,6 +3,6 @@
 {"name":"git-proxy","version":"2026-01-01","triggers":["commit","push","branch","merge","rebase","pull request","PR"],"tools":["bash"],"preconditions":[".git exists"],"constraints":["never force push to main","never force push to protected branches","run tests before push"],"category":"operations"}
 {"name":"debug-investigator","version":"2026-01-01","triggers":["debug","why is this failing","investigate","stack trace","bug"],"tools":["bash","memory_reflect"],"preconditions":[],"constraints":["reproduce before fixing","fix root cause, not symptoms"],"category":"engineering"}
 {"name":"deploy-checklist","version":"2026-01-01","triggers":["deploy","ship","release","go live"],"tools":["bash"],"preconditions":[],"constraints":["all tests passing","no unresolved TODOs in diff","requires human approval for production"],"category":"operations"}
-{"name":"data-layer","version":"2026-04-25","triggers":["data layer","dashboard","agent analytics","resource usage","cron monitoring","daily report","tokens"],"tools":["bash","git"],"preconditions":[".agent exists"],"constraints":["local-only by default","no screenshot delivery without explicit user approval","do not commit private .agent/data-layer exports"],"category":"operations"}
+{"name":"data-layer","version":"2026-04-25","triggers":["data layer","dashboard","agent analytics","resource usage","cron monitoring","daily report","tokens","terminal dashboard","TUI"],"tools":["bash","git"],"preconditions":[".agent exists"],"constraints":["local-only by default","no screenshot delivery without explicit user approval","do not commit private .agent/data-layer exports"],"category":"operations"}
 {"name":"data-flywheel","version":"2026-04-25","triggers":["data flywheel","trace to train","training traces","context cards","eval cases","approved runs","vertical intelligence"],"tools":["bash","git"],"preconditions":[".agent exists"],"constraints":["local-only by default","human-approved runs only","redaction required before trainable","do not train models"],"category":"operations"}
 {"name":"design-md","version":"2026-04-26","triggers":["DESIGN.md","design.md","Google Stitch","Stitch","design tokens","design system","visual design"],"tools":["bash","memory_reflect"],"preconditions":["DESIGN.md exists at project root"],"constraints":["prefer DESIGN.md tokens over invented values","do not modify DESIGN.md unless the user explicitly asks","preserve unknown sections when an edit IS authorised","validate when tooling is available"],"category":"design"}

.agent/skills/data-layer/SKILL.md

@@ -25,6 +25,7 @@ The goal is local business intelligence for the whole agent suite:
 - workflow success/error rates
 - KPI summary rows for cron cadence, run volume, reliability, active agents,
   workflow breadth, token usage, and estimated cost
+- terminal dashboard visible directly in the user's coding tool
 - screenshot-ready daily resource reports
 
 ## Hard Rules
@@ -59,6 +60,9 @@ Run:
 python3 .agent/tools/data_layer_export.py --window 30d --bucket day
 ```
 
+The command prints a compact terminal dashboard by default, then writes the
+full browser dashboard and data files.
+
 Use `--bucket hour`, `--bucket day`, `--bucket week`, or `--bucket month` for
 different chart grains.
 
@@ -81,6 +85,7 @@ Key outputs:
 - `dashboard-summary.json`
 - `dashboard-report.json`
 - `dashboard.html`
+- `dashboard.tui.txt`
 - `daily-report.md`
 
 ## Categories

.agent/tools/data_layer_export.py

@@ -2,7 +2,8 @@
 """Local data layer export for the portable agentic-stack brain.
 
 Reads shared `.agent/` memory plus optional local data-layer inputs and writes
-dashboard-ready JSONL, JSON, CSV, and a dependency-free HTML dashboard.
+dashboard-ready JSONL, JSON, CSV, a dependency-free HTML dashboard, and a
+terminal dashboard.
 
 No network calls, no external dependencies, no telemetry.
 """
@@ -760,6 +761,7 @@ def build_dashboard_report(args: argparse.Namespace, summary: dict[str, Any]) ->
         "timezone": args.timezone,
         "generated_at": summary["generated_at"],
         "dashboard_html": "dashboard.html",
+        "terminal_dashboard": "dashboard.tui.txt",
         "daily_report_md": "daily-report.md",
         "screenshot_target": "dashboard.html",
         "charts": [
@@ -812,6 +814,85 @@ def write_daily_report(path: Path, summary: dict[str, Any]) -> None:
     )
 
 
+def compact_value(value: Any, prefix: str = "", suffix: str = "") -> str:
+    n = safe_num(value)
+    if n is None:
+        return "n/a"
+    if abs(n) >= 1000000:
+        text = f"{n / 1000000:.1f}M"
+    elif abs(n) >= 1000:
+        text = f"{n / 1000:.1f}k"
+    elif n == int(n):
+        text = str(int(n))
+    else:
+        text = f"{n:.2f}".rstrip("0").rstrip(".")
+    return f"{prefix}{text}{suffix}"
+
+
+def plain_bar(value: Any, max_value: float, width: int = 18) -> str:
+    n = safe_num(value) or 0
+    filled = 0 if max_value <= 0 else int(round(n / max_value * width))
+    filled = max(0, min(width, filled))
+    return "#" * filled + "-" * (width - filled)
+
+
+def top_table(rows: list[dict[str, Any]], label_field: str, value_field: str, secondary_value_field: str = "", limit: int = 5) -> list[str]:
+    if not rows:
+        return ["  no data yet"]
+    top = rows[:limit]
+    values = [
+        (safe_num(row.get(value_field)) or 0) + (safe_num(row.get(secondary_value_field)) or 0)
+        for row in top
+    ]
+    max_value = max(values + [1])
+    lines = []
+    for row, value in zip(top, values):
+        label = str(row.get(label_field) or "unknown")[:22].ljust(22)
+        lines.append(f"  {label} [{plain_bar(value, max_value)}] {compact_value(value)}")
+    return lines
+
+
+def render_terminal_dashboard(out_dir: Path) -> str:
+    summary = json.loads((out_dir / "dashboard-summary.json").read_text(encoding="utf-8"))
+    activity = json.loads((out_dir / "activity-series.json").read_text(encoding="utf-8"))
+    categories = json.loads((out_dir / "category-summary.json").read_text(encoding="utf-8"))
+    harnesses = json.loads((out_dir / "harness-summary.json").read_text(encoding="utf-8"))
+    workflows = json.loads((out_dir / "workflow-summary.json").read_text(encoding="utf-8"))
+
+    resources = summary["resources"]
+    counts = summary["counts"]
+    latest_activity = activity[-1] if activity else {}
+    lines = [
+        "agentic-stack Data Layer - Terminal Dashboard",
+        f"project={summary['project']} window={summary['window']} bucket={summary['bucket']} generated={summary['generated_at']}",
+        "",
+        "Resource Overview",
+        f"  Agent events : {compact_value(counts['agent_events'])}",
+        f"  Cron runs    : {compact_value(counts['cron_runs'])}",
+        f"  Harnesses    : {compact_value(counts['harnesses'])}",
+        f"  Active agents: {compact_value(counts['active_agents'])}",
+        f"  Tokens est.  : {compact_value(resources['tokens_total_estimate'])}",
+        f"  Cost est.    : {compact_value(resources['cost_estimate_usd'], prefix='$')}",
+        "",
+        "Latest Bucket",
+        f"  {latest_activity.get('bucket_start', 'no activity')}  events={compact_value(latest_activity.get('agent_events'))} cron={compact_value(latest_activity.get('cron_runs'))} tokens={compact_value(latest_activity.get('tokens_total_estimate'))}",
+        "",
+        "Top Harnesses",
+        *top_table(harnesses, "harness", "agent_events", "cron_runs"),
+        "",
+        "Top Workflows",
+        *top_table(workflows, "workflow", "agent_events", "cron_runs"),
+        "",
+        "Top Categories",
+        *top_table(categories, "category", "agent_events", "cron_runs"),
+        "",
+        f"Open in browser: {out_dir / 'dashboard.html'}",
+        f"Terminal copy : {out_dir / 'dashboard.tui.txt'}",
+        "Privacy       : local-only; screenshots require explicit user approval",
+    ]
+    return "\n".join(lines) + "\n"
+
+
 def export(args: argparse.Namespace) -> Path:
     agent_root = Path(args.agent_root).resolve()
     data_dir = agent_root / "data-layer"
@@ -892,6 +973,7 @@ def export(args: argparse.Namespace) -> Path:
     write_json(out_dir / "dashboard-report.json", dashboard_report)
     write_dashboard(out_dir / "dashboard.html", summary, activity, categories, harnesses, workflows, cron_runs, cron_timeline, kpis)
     write_daily_report(out_dir / "daily-report.md", summary)
+    (out_dir / "dashboard.tui.txt").write_text(render_terminal_dashboard(out_dir), encoding="utf-8")
     return out_dir
 
 
@@ -912,6 +994,8 @@ def main() -> int:
     out_dir = export(args)
     print(f"agentic-stack data layer export: {out_dir}")
     print(f"dashboard_html={out_dir / 'dashboard.html'}")
+    print()
+    print(render_terminal_dashboard(out_dir), end="")
     return 0
 
 

CHANGELOG.md

@@ -5,6 +5,39 @@ All notable changes to this project.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.11.1] — 2026-04-26
+
+Patch release. Makes the data-layer dashboard visible directly in coding-tool
+terminals and adds a visual SVG explainer for the data-layer flow.
+
+### Added
+- **Terminal dashboard by default.** The existing
+  `python3 .agent/tools/data_layer_export.py --window 30d --bucket day`
+  command now prints a compact TUI-style dashboard after writing exports. It
+  shows resource numbers, latest bucket activity, top harnesses, top workflows,
+  top categories, and artifact paths without requiring a browser.
+- **`dashboard.tui.txt`.** The same terminal dashboard is saved next to
+  `dashboard.html`, CSV/JSON exports, and `daily-report.md` for agents and
+  users who want to inspect or attach a plain-text report.
+- **`docs/data-layer.svg`.** README and `docs/data-layer.md` now include a
+  visual of the local data-layer flow: input streams, exporter, browser
+  dashboard, terminal dashboard, CSV/JSON, and approved handoff.
+
+### Changed
+- `dashboard-report.json` now advertises the terminal dashboard artifact.
+- Data-layer docs no longer require a separate command to see the terminal
+  view; the normal export command prints it.
+
+### Migration
+No migration required. Existing data-layer commands still work; they now print
+the terminal dashboard in addition to the previous status lines.
+
+### Release
+- Tag `v0.11.1` cut from master.
+- GitHub release: <https://github.com/codejunkie99/agentic-stack/releases/tag/v0.11.1>
+- `Formula/agentic-stack.rb` bumped to v0.11.1 in a follow-up commit after
+  the tag tarball existed and its sha256 could be computed.
+
 ## [0.11.0] — 2026-04-26
 
 Minor release. Adds two local-first data capabilities: a cross-harness
@@ -46,8 +79,7 @@ private and regenerated; both are gitignored.
 ### Release
 - Tag `v0.11.0` cut from master.
 - GitHub release: <https://github.com/codejunkie99/agentic-stack/releases/tag/v0.11.0>
-- `Formula/agentic-stack.rb` bumped to v0.11.0 in a follow-up commit after
-  the tag tarball existed and its sha256 could be computed.
+- Superseded by v0.11.1 before the Homebrew formula bump.
 
 ### Credits
 - PR #25 and PR #26 by @danielfoch.

README.md

@@ -9,6 +9,10 @@ agents from one place: harness activity, cron runs, active agents, token/cost
 estimates, KPI summaries, user-defined resource categories, and
 screenshot-ready daily dashboards.
 
+<p align="center">
+  <img src="docs/data-layer.svg" alt="agentic-stack data layer dashboard flow" width="880"/>
+</p>
+
 And it can turn approved, redacted runs into local flywheel artifacts:
 trace records, context cards, eval cases, training-ready JSONL, and readiness
 metrics without training a model or sending telemetry.
@@ -21,10 +25,30 @@ metrics without training a model or sending telemetry.
   <img src="docs/diagram.svg" alt="agentic-stack architecture" width="880"/>
 </p>
 
-### New in v0.11.0 — data layer + data flywheel
+### New in v0.11.1 — terminal data dashboard
+
+Patch release. The data layer now shows a terminal dashboard by default, so
+people can inspect agent activity inside the coding tool they are already
+using, without opening a browser or learning another command.
+
+- **Terminal dashboard by default.** The existing
+  `python3 .agent/tools/data_layer_export.py --window 30d --bucket day`
+  command now prints a compact TUI-style report with resource numbers, latest
+  bucket activity, top harnesses, top workflows, top categories, and links to
+  the generated artifacts.
+- **Saved text dashboard.** The same terminal view is written to
+  `dashboard.tui.txt` beside `dashboard.html`, CSV, JSON, and
+  `daily-report.md`.
+- **Data-layer SVG.** README and data-layer docs now include a visual of the
+  local flow: input streams -> exporter -> browser dashboard, terminal
+  dashboard, CSV/JSON, and approved handoff.
 
-Minor release. Adds two local-first data capabilities for teams running
-multiple agent harnesses against the same `.agent/` brain.
+See [CHANGELOG.md](CHANGELOG.md) for the full list.
+
+### v0.11.0 — data layer + data flywheel
+
+Added two local-first data capabilities for teams running multiple agent
+harnesses against the same `.agent/` brain.
 
 - **`data-layer` seed skill.** Generate local dashboard exports across Claude
   Code, Hermes, OpenClaw, Codex, Cursor, OpenCode, and custom loops:
@@ -35,8 +59,6 @@ multiple agent harnesses against the same `.agent/` brain.
   metrics. It is local-only and model-agnostic; it prepares artifacts but
   does not train models or call external APIs.
 
-See [CHANGELOG.md](CHANGELOG.md) for the full list.
-
 ### v0.10.0 — design-md skill + Python 3.9 fix
 
 Added the `design-md` seed skill for root `DESIGN.md` / Google Stitch
@@ -414,8 +436,9 @@ python3 .agent/tools/data_layer_export.py --window 30d --bucket day
 ```
 
 Outputs land in `.agent/data-layer/exports/<date>/`, including
-`dashboard.html` and `daily-report.md`. Optional local inputs let you add
-scheduled runs and categories:
+`dashboard.html`, `dashboard.tui.txt`, and `daily-report.md`. The command also
+prints the compact terminal dashboard directly inside your coding tool. Optional
+local inputs let you add scheduled runs and categories:
 
 ```text
 .agent/data-layer/cron-runs.jsonl

docs/data-layer.md

@@ -4,6 +4,10 @@ The data layer gives the portable `.agent/` brain a local dashboard for the
 entire suite of agents: Claude Code, Hermes, OpenClaw, Codex, Cursor, OpenCode,
 Windsurf, Pi, Antigravity, and custom loops.
 
+<p align="center">
+  <img src="data-layer.svg" alt="agentic-stack data layer dashboard flow" width="880"/>
+</p>
+
 It is a companion to the GStack Data Layer idea, adapted for agentic-stack's
 core promise: one shared memory-and-skills layer across many harnesses.
 
@@ -89,13 +93,23 @@ Outputs:
   dashboard-summary.json
   dashboard-report.json
   dashboard.html
+  dashboard.tui.txt
   daily-report.md
 ```
 
 `dashboard.html` is dependency-free and screenshot-ready. It renders resource
 overview, activity, token usage, cron frequency, task categories, harness mix,
 workflow outcomes, a Gantt-style cron panel, and cron timeline tables.
 
+The same command prints a compact terminal dashboard after export:
+
+```bash
+python3 .agent/tools/data_layer_export.py --window 30d --bucket day
+```
+
+This is useful inside coding tools where the agent and user share a terminal.
+The same text view is also saved as `dashboard.tui.txt`.
+
 ## KPI Coverage
 
 The first exporter focuses on universal agent-operations KPIs that apply across