fix: clean CLI output paths, high-res demo GIF, README cleanup

- Print relative filenames instead of absolute paths in CLI output
- Re-record demo.gif at 1600x800 with clean output
- Remove redundant terminal simulation from README (GIF shows it)
- Add stacklit-og.png for social sharing

Author: thegdsks

README.md

@@ -19,24 +19,11 @@ AI coding agents burn most of their context window just figuring out where thing
 npx stacklit init
 ```
 
-```
-$ stacklit init
-[stacklit] found 342 files
-[stacklit] parsed 342 files (0 errors)
-[stacklit] done in 89ms — wrote stacklit.json, stacklit.mmd, stacklit.html
-
-Opening visual map...
-```
-
 ![Stacklit demo](demo.gif)
 
-### Without stacklit
+**Without stacklit:** Agent reads 8-12 files to build context. ~400,000 tokens. 45 seconds before writing a line.
 
-Agent reads 8-12 files to build context. ~400,000 tokens. 45 seconds of exploration before writing a single line.
-
-### With stacklit
-
-Agent reads `stacklit.json`. ~1,500 tokens. Knows every module, dependency, and convention instantly.
+**With stacklit:** Agent reads `stacklit.json`. ~1,500 tokens. Knows every module, dependency, and convention instantly.
 
 ## What you get
 
@@ -75,6 +62,8 @@ A 500-file repo produces ~1,500 tokens of index. That is what an agent wastes re
 
 `stacklit view` opens an interactive HTML with four tabs:
 
+![Stacklit visual map](stacklit-og.png)
+
 - **Graph** -- Force-directed dependency map. Click a node to see its exports, types, and files.
 - **Tree** -- Collapsible directory hierarchy with file and line counts.
 - **Table** -- Sortable module table. Find where the complexity lives.

demo.gif

@@ -1,38 +1,23 @@
 Output demo.gif
 
 Set Shell "bash"
-Set FontSize 14
-Set Width 900
-Set Height 500
+Set FontSize 22
+Set Width 1600
+Set Height 800
 Set Theme { "name": "stacklit", "black": "#0d1117", "red": "#f85149", "green": "#56d364", "yellow": "#e3b341", "blue": "#58a6ff", "magenta": "#bc8cff", "cyan": "#39d2c0", "white": "#c9d1d9", "brightBlack": "#484f58", "brightRed": "#f85149", "brightGreen": "#56d364", "brightYellow": "#e3b341", "brightBlue": "#58a6ff", "brightMagenta": "#bc8cff", "brightCyan": "#39d2c0", "brightWhite": "#e6edf3", "background": "#0d1117", "foreground": "#c9d1d9", "selectionBackground": "#264f78", "cursorColor": "#c9d1d9" }
-Set Padding 20
+Set Padding 30
+Set TypingSpeed 40ms
 
-Type "# Stacklit: your codebase, in 1,500 tokens"
-Enter
-Sleep 1s
-
-Type "stacklit init"
-Enter
-Sleep 3s
-
-Type ""
-Sleep 1s
-
-Type "# stacklit.json is now committed to git"
-Enter
 Sleep 500ms
 
-Type "cat stacklit.json | head -25"
+Type "stacklit init"
 Enter
 Sleep 3s
 
-Type ""
-Sleep 1s
+Sleep 1.5s
 
-Type "# Start MCP server for AI agents"
+Type "head -35 stacklit.json"
 Enter
-Sleep 500ms
+Sleep 4s
 
-Type "# stacklit serve"
-Enter
 Sleep 2s

demo.tape

@@ -248,7 +248,8 @@ func Run(opts Options) (*Result, error) {
 	// 13. Print summary.
 	if !opts.Quiet {
 		fmt.Printf("[stacklit] done in %s — wrote %s, %s, %s\n",
-			dur.Round(time.Millisecond), jsonPath, mmdPath, htmlPath)
+			dur.Round(time.Millisecond),
+			filepath.Base(jsonPath), filepath.Base(mmdPath), filepath.Base(htmlPath))
 	}
 
 	return &Result{

internal/engine/engine.go

@@ -1,9 +1,9 @@
 {
   "$schema": "https://stacklit.dev/schema/v1.json",
   "version": "1",
-  "generated_at": "2026-04-09T23:56:36Z",
+  "generated_at": "2026-04-10T00:05:04Z",
   "stacklit_version": "dev",
-  "merkle_hash": "fdac4b84e691421e649f3523cb688eb24554439ade7ccea2f27a3d3cb3466ae9",
+  "merkle_hash": "bd0d1090ba4aff650f9a9d9a308b118e7708043445a2cc9cbc202e800378608e",
   "project": {
     "name": "stacklit",
     "root": ".",
@@ -14,7 +14,7 @@
     "languages": {
       "go": {
         "files": 48,
-        "lines": 5697
+        "lines": 5698
       },
       "java": {
         "files": 1,
@@ -47,7 +47,7 @@
       "cmd/stacklit/main.go"
     ],
     "total_files": 59,
-    "total_lines": 5909
+    "total_lines": 5910
   },
   "modules": {
     "assets": {
@@ -158,7 +158,7 @@
       "purpose": "Core orchestration engine",
       "language": "go",
       "files": 1,
-      "lines": 554,
+      "lines": 555,
       "file_list": [
         "engine.go"
       ],
@@ -386,14 +386,14 @@
       ],
       "type_defs": {
         "Architecture": "Pattern string, Summary string",
-        "GitInfo": "HotFiles []HotFile, Recent []string, Stable []string",
         "Hints": "AddFeature string, TestCmd string, EnvVars []string, DoNotTouch []string",
+        "HotFile": "Path string, Commits90d int",
         "Index": "Schema string, Version string, GeneratedAt string, StacklitVersion string, MerkleHash string, Project Project, Tech Tech, Structure Structure, Modules map[string]ModuleInfo, Dependencies Dependenci...",
         "LangStats": "Files int, Lines int",
+        "ModuleInfo": "Purpose string, Language string, Files int, Lines int, FileList []string, Exports []string, TypeDefs map[string]string, DependsOn []string, DependedBy []string, Activity string",
         "MultiIndex": "Schema string, Version string, Type string, GeneratedAt string, TotalFiles int, TotalLines int, TotalModules int, Repos []RepoSummary",
         "Project": "Name string, Root string, Type string, Workspaces []string",
         "RepoSummary": "Name string, Path string, PrimaryLanguage string, TotalFiles int, TotalLines int, Modules map[string]ModuleInfo, Frameworks []string, Entrypoints []string",
-        "Structure": "Entrypoints []string, TotalFiles int, TotalLines int, KeyDirectories map[string]string",
         "Tech": "PrimaryLanguage string, Languages map[string]LangStats, Frameworks []string"
       },
       "depended_by": [
@@ -582,15 +582,15 @@
       },
       {
         "path": "stacklit.json",
-        "commits_90d": 10
+        "commits_90d": 11
       },
       {
         "path": "stacklit.mmd",
-        "commits_90d": 10
+        "commits_90d": 11
       },
       {
         "path": "assets/template.html",
-        "commits_90d": 9
+        "commits_90d": 10
       },
       {
         "path": "internal/graph/graph.go",
@@ -600,6 +600,10 @@
         "path": "internal/schema/schema.go",
         "commits_90d": 7
       },
+      {
+        "path": "README.md",
+        "commits_90d": 5
+      },
       {
         "path": "go.mod",
         "commits_90d": 5
@@ -612,10 +616,6 @@
         "path": "go.sum",
         "commits_90d": 4
       },
-      {
-        "path": "README.md",
-        "commits_90d": 3
-      },
       {
         "path": "internal/cli/generate.go",
         "commits_90d": 3
@@ -658,28 +658,28 @@
       }
     ],
     "recent": [
-      "npm/README.md",
-      "npm/bin/stacklit.js",
-      "npm/package.json",
       "README.md",
-      "SKILL.md",
       "assets/template.html",
-      ".github/workflows/ci.yml",
-      ".github/workflows/release.yml",
-      ".goreleaser.yml",
-      "go.mod"
+      "demo.gif",
+      "demo.tape",
+      "internal/mcp/server.go",
+      "stacklit.json",
+      "stacklit.mmd",
+      "npm/README.md",
+      "npm/bin/stacklit.js",
+      "npm/package.json"
     ],
     "stable": [
       "LICENSE",
       "action/action.yml",
       "assets/lang-icons.js",
+      "demo.gif",
+      "demo.tape",
       "internal/cli/serve.go",
       "internal/config/config.go",
       "internal/config/config_test.go",
       "internal/detect/envvars.go",
-      "internal/detect/frameworks.go",
-      "internal/detect/frameworks_test.go",
-      "internal/git/activity.go"
+      "internal/detect/frameworks.go"
     ]
   },
   "hints": {

stacklit-og.png

@@ -1,27 +1,27 @@
 graph LR
+  classDef javascript fill:#c9d1d9,color:#0d1117,stroke:#c9d1d9
+  classDef java fill:#8b949e,color:#0d1117,stroke:#8b949e
   classDef typescript fill:#c9d1d9,color:#0d1117,stroke:#c9d1d9
   classDef python fill:#b1bac4,color:#0d1117,stroke:#b1bac4
   classDef rust fill:#a5b3bf,color:#0d1117,stroke:#a5b3bf
   classDef go fill:#e6edf3,color:#0d1117,stroke:#e6edf3
-  classDef javascript fill:#c9d1d9,color:#0d1117,stroke:#c9d1d9
-  classDef java fill:#8b949e,color:#0d1117,stroke:#8b949e
+  internal_engine["internal/engine\nCore orchestration engine"]:::go
   internal_mcp["internal/mcp\nMCP server for AI agents"]:::go
   internal_monorepo["internal/monorepo\nMonorepo detection"]:::go
-  internal_renderer["internal/renderer\nOutput renderers"]:::go
-  npm["npm\nNpm"]:::go
-  npm_bin["npm/bin\nBin"]:::go
-  internal_cli["internal/cli\nCommand-line interface"]:::go
-  internal_detect["internal/detect\nFramework and tool detection"]:::go
-  cmd_stacklit["cmd/stacklit\nStacklit"]:::go
-  internal_schema["internal/schema\nData schema definitions"]:::go
-  assets["assets\nStatic assets"]:::go
-  internal_engine["internal/engine\nCore orchestration engine"]:::go
   internal_parser["internal/parser\nSource code parsers"]:::go
   internal_summary["internal/summary\nAI-powered codebase summaries"]:::go
+  internal_renderer["internal/renderer\nOutput renderers"]:::go
   internal_walker["internal/walker\nFile system walker"]:::go
-  internal_config["internal/config\nConfiguration management"]:::go
+  internal_cli["internal/cli\nCommand-line interface"]:::go
   internal_git["internal/git\nGit integration"]:::go
   internal_graph["internal/graph\nDependency graph"]:::go
+  npm["npm\nNpm"]:::go
+  assets["assets\nStatic assets"]:::go
+  internal_config["internal/config\nConfiguration management"]:::go
+  internal_detect["internal/detect\nFramework and tool detection"]:::go
+  internal_schema["internal/schema\nData schema definitions"]:::go
+  npm_bin["npm/bin\nBin"]:::go
+  cmd_stacklit["cmd/stacklit\nStacklit"]:::go
   cmd_stacklit --> internal_cli
   internal_cli --> internal_engine
   internal_cli --> internal_git