growmos view — after a few days of development, this is what lays in your graph: hubs sized by degree, colored by type, every edge with provenance, profiles on click.
+
## Why
Multi-agent systems and long-running coding sessions share one weakness: memory dies with the
@@ -47,6 +50,10 @@ growmos makes that a **living organism inside your repo**:
resolved), the 10-item `growmos doctor` checklist and the health signals (components, density,
compression) all stay green on autopilot. Every gold file records who reviewed it
(`agent` / `human`) — humans can overrule at any time, but never have to.
+- **It shows itself.** `growmos view` opens a self-contained, offline interactive explorer
+ (force layout, search, type filters, click a node for its profile, edges and provenance) —
+ no server, no dependencies. `growmos export --format html|json|dot|mermaid|cypher|sql` for
+ everything else.
- **It is agent-native.** No API key needed: the CLI does the deterministic work, and hands the
*judgment* work (extraction, resolution, summarization) to whatever agent you already run as
a **task packet** — prompt + JSON shape + the exact `growmos apply …` command. Optional
@@ -84,6 +91,7 @@ growmos remember "Scheduler" --type COMPONENT --desc "Schedules jobs; depends on
growmos link "Scheduler" "depends on" "Store"
growmos journal "Moved Store to Postgres (ADR-001)."
growmos check "(Alice Chen) --[owns]--> (Scheduler)"
+growmos view # open the interactive explorer in your browser
growmos status · growmos context · growmos doctor · growmos eval · growmos sample
```
@@ -126,8 +134,8 @@ to your CLI's MCP config.
journal.md the shared memo, append-only
```
-Plain JSONL: diff-able, merge-friendly, greppable, exportable (`growmos export --format
-json|dot|mermaid|cypher|sql`). Storage is an infrastructure decision, not a pipeline decision:
+Plain JSONL: diff-able, merge-friendly, greppable, viewable (`growmos view`) and exportable
+(`growmos export --format html|json|dot|mermaid|cypher|sql`). Storage is an infrastructure decision, not a pipeline decision:
the same schema maps onto Neo4j or three Postgres tables.
## Presets
diff --git a/docs/agents.md b/docs/agents.md
index a9e4c5d..06d9698 100644
--- a/docs/agents.md
+++ b/docs/agents.md
@@ -82,6 +82,13 @@ the resolver step (`growmos resolve` → apply) merge surface forms across worke
`growmos query` and cites edges. Everything writes to the same JSONL files; commit and merge
like code.
+## Seeing the graph
+
+`growmos view` writes `.growmos/graph.html` (self-contained, offline) and opens it: force layout
+sized by degree, colored by type, search, type filters, and a card per node with description,
+profile, edges (with edge ids, corroboration and provenance) and aliases. `--focus ` opens
+on a node; `--out path.html` writes elsewhere (share it, embed it in CI artifacts).
+
## Packet anatomy
```
diff --git a/docs/assets/growmos-view.png b/docs/assets/growmos-view.png
new file mode 100644
index 0000000..8f44c0d
Binary files /dev/null and b/docs/assets/growmos-view.png differ
diff --git a/pyproject.toml b/pyproject.toml
index 88c4932..7f10f14 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "growmos"
-version = "0.1.0"
+version = "0.1.1"
description = "A living knowledge graph that grows with your repo — agent-native, zero-dependency, plug & play for Claude Code, Codex, Grok, Cursor and any MCP-capable CLI."
readme = "README.md"
license = { text = "MIT" }
diff --git a/src/growmos/__init__.py b/src/growmos/__init__.py
index 27fe432..50dd109 100644
--- a/src/growmos/__init__.py
+++ b/src/growmos/__init__.py
@@ -3,4 +3,4 @@
Developed by Codician (https://codician.com). MIT licensed.
"""
-__version__ = "0.1.0"
+__version__ = "0.1.1"
diff --git a/src/growmos/cli.py b/src/growmos/cli.py
index 2283c31..774c293 100644
--- a/src/growmos/cli.py
+++ b/src/growmos/cli.py
@@ -787,6 +787,23 @@ def cmd_ingest(args: argparse.Namespace) -> int:
return 0
+def cmd_view(args: argparse.Namespace) -> int:
+ """Render the interactive explorer to .growmos/graph.html and open it."""
+ from .export import to_html
+ import webbrowser
+ st = _store(args)
+ focus = ""
+ if args.focus:
+ focus = st.resolve_name(args.focus) or (args.focus if args.focus in st.entities else "")
+ out = Path(args.out) if args.out else st.p("graph.html")
+ out.parent.mkdir(parents=True, exist_ok=True)
+ out.write_text(to_html(st, focus=focus), encoding="utf-8")
+ print(f"✓ wrote {out} ({len(st.entities)} nodes, {len(st.relations)} edges)")
+ if not args.no_open:
+ webbrowser.open(out.resolve().as_uri())
+ return 0
+
+
def cmd_mcp(args: argparse.Namespace) -> int:
from .mcp import serve
serve()
@@ -938,7 +955,7 @@ def build_parser() -> argparse.ArgumentParser:
sp.add_argument("--strict", action="store_true", help="exit 1 unless all green")
sp.set_defaults(fn=cmd_doctor)
- sp = sub.add_parser("export", help="export graph: json|dot|mermaid|cypher|sql")
+ sp = sub.add_parser("export", help="export graph: json|html|dot|mermaid|cypher|sql")
sp.add_argument("--format", default="json")
sp.add_argument("--out")
sp.set_defaults(fn=cmd_export)
@@ -962,6 +979,12 @@ def build_parser() -> argparse.ArgumentParser:
sp.add_argument("--scan", action="store_true")
sp.set_defaults(fn=cmd_ingest)
+ sp = sub.add_parser("view", help="open an interactive visual explorer of the graph in your browser")
+ sp.add_argument("--focus", help="entity to select on open")
+ sp.add_argument("--out", help="write HTML here instead of .growmos/graph.html")
+ sp.add_argument("--no-open", action="store_true", help="just write the file")
+ sp.set_defaults(fn=cmd_view)
+
sp = sub.add_parser("mcp", help="run the MCP stdio server (tools for any MCP-capable agent CLI)")
sp.set_defaults(fn=cmd_mcp)
diff --git a/src/growmos/export.py b/src/growmos/export.py
index 0097faa..320cd08 100644
--- a/src/growmos/export.py
+++ b/src/growmos/export.py
@@ -94,4 +94,38 @@ def to_sql(store: Store) -> str:
return "\n".join(lines)
-EXPORTERS = {"json": to_json, "dot": to_dot, "mermaid": to_mermaid, "cypher": to_cypher, "sql": to_sql}
+def to_html(store: Store, focus: str = "") -> str:
+ """Self-contained interactive explorer (force layout, cards, search). No external assets."""
+ from pathlib import Path as _P
+ from .util import now_iso
+ g = Graph(store)
+ d = g.diagnostics()
+ profiles = {}
+ for eid in store.entities:
+ prof = store.get_profile(eid)
+ if prof:
+ prof = dict(prof)
+ prof["stale"] = store.profile_is_stale(eid)
+ profiles[eid] = prof
+ aliases: Dict[str, List[str]] = {}
+ for (a, t), eid in store.aliases.items():
+ aliases.setdefault(eid, []).append(store._alias_display.get((a, t), a))
+ data = {
+ "entities": [{"id": e["id"], "name": e["name"], "type": e["type"], "description": e.get("description", ""),
+ "sources": e.get("sources", []), "provisional": bool(e.get("provisional"))}
+ for e in store.entities.values()],
+ "relations": [{"id": r["id"], "source": r["source"], "target": r["target"], "predicate": r["predicate"],
+ "sources": r.get("sources", []), "confidence": r.get("confidence", 1)}
+ for r in store.relations.values()],
+ "profiles": profiles,
+ "aliases": {k: sorted(set(v)) for k, v in aliases.items()},
+ "sources": {sid: rec.get("ref", sid) for sid, rec in store.sources.items()},
+ "meta": {"components": d["components"], "density": d["density"], "schema_version": d["schema_version"],
+ "generated": now_iso()[:16].replace("T", " "), "focus": focus},
+ }
+ tpl = (_P(__file__).parent / "templates" / "view.html").read_text(encoding="utf-8")
+ payload = json.dumps(data, ensure_ascii=False).replace("
+
+
+
+
+growmos · __TITLE__
+
+
+
+
+
growmos · __TITLE__
+
+
+
+
+
+
×
+
drag to pan · wheel to zoom · drag nodes · click a node for its card · double-click background to reset
+
+
+
+
diff --git a/tests/test_growmos.py b/tests/test_growmos.py
index 9952f91..d5d1770 100644
--- a/tests/test_growmos.py
+++ b/tests/test_growmos.py
@@ -186,6 +186,11 @@ class ApolloFixture(unittest.TestCase):
out = fn(self.st)
self.assertTrue(out.strip(), name)
self.assertIn("MERGE (n:PERSON", EXPORTERS["cypher"](self.st))
+ html = EXPORTERS["html"](self.st)
+ self.assertIn("Buzz Aldrin", html)
+ self.assertNotIn("__DATA__", html)
+ out = run_cli("--root", str(self.tmp), "view", "--no-open")
+ self.assertIn("graph.html", out)
self.assertIn("CREATE TABLE IF NOT EXISTS entities", EXPORTERS["sql"](self.st))
def test_cli_status_context_show(self):
