diff --git a/README.md b/README.md
index 5b385d6..5b59833 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
-<div align="center">
+<p align="center">
+  <img src="assets/banner.svg" alt="mac-dev-setup · trace: installing Homebrew → symlinking dotfiles → configuring credentials → wiring MCP servers → installing Claude Code · δ: productive" width="100%">
+</p>
 
-<img src="assets/logo.png" alt="mac-dev-setup mascot" width="200" />
+<div align="center">
 
 # mac-dev-setup
 
diff --git a/assets/banner-1200.png b/assets/banner-1200.png
new file mode 100644
index 0000000..72980fc
Binary files /dev/null and b/assets/banner-1200.png differ
diff --git a/assets/banner-2400.png b/assets/banner-2400.png
new file mode 100644
index 0000000..7206242
Binary files /dev/null and b/assets/banner-2400.png differ
diff --git a/assets/banner.svg b/assets/banner.svg
new file mode 100644
index 0000000..bca2435
--- /dev/null
+++ b/assets/banner.svg
@@ -0,0 +1,187 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 2400 686" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="mac-dev-setup — banner">
+
+  <defs>
+    <style type="text/css"><![CDATA[
+      .rule {
+        stroke: rgba(255, 255, 255, 0.18);
+        stroke-width: 1;
+        fill: none;
+      }
+      .eyebrow {
+        font-family: "IBM Plex Sans", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+        font-size: 22px;
+        font-weight: 500;
+        fill: rgba(255, 255, 255, 0.65);
+        text-transform: uppercase;
+        letter-spacing: 0.18em;
+      }
+      .system-tag {
+        font-family: "IBM Plex Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+        font-size: 18px;
+        font-weight: 500;
+        fill: #1F4D3A;
+        text-transform: uppercase;
+        letter-spacing: 0.18em;
+      }
+      .mono-tag {
+        font-family: "IBM Plex Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+        font-size: 18px;
+        font-weight: 400;
+        fill: rgba(255, 255, 255, 0.55);
+        text-transform: uppercase;
+        letter-spacing: 0.12em;
+      }
+      .term-glyph {
+        font-family: "IBM Plex Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+        font-size: 22px;
+        font-weight: 400;
+        fill: rgba(255, 255, 255, 0.62);
+      }
+      .term-line {
+        font-family: "IBM Plex Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+        font-size: 22px;
+        font-weight: 400;
+        fill: rgba(255, 255, 255, 0.92);
+      }
+      .term-final {
+        font-family: "IBM Plex Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+        font-size: 24px;
+        font-style: italic;
+        font-weight: 500;
+        fill: #1F4D3A;
+      }
+      .headline {
+        font-family: "IBM Plex Serif", ui-serif, Georgia, "Times New Roman", serif;
+        font-size: 88px;
+        font-weight: 600;
+        fill: rgba(255, 255, 255, 0.95);
+        letter-spacing: -0.02em;
+      }
+      .subtitle {
+        font-family: "IBM Plex Serif", ui-serif, Georgia, serif;
+        font-size: 26px;
+        font-style: italic;
+        font-weight: 400;
+        fill: rgba(255, 255, 255, 0.78);
+        letter-spacing: -0.005em;
+      }
+      .stack {
+        font-family: "IBM Plex Sans", ui-sans-serif, system-ui, sans-serif;
+        font-size: 14px;
+        font-weight: 500;
+        fill: rgba(255, 255, 255, 0.55);
+        text-transform: uppercase;
+        letter-spacing: 0.18em;
+      }
+      .monogram-letter {
+        font-family: "IBM Plex Sans", ui-sans-serif, system-ui, sans-serif;
+        font-size: 22px;
+        font-weight: 600;
+        fill: rgba(255, 255, 255, 0.92);
+      }
+      .monogram-epsilon {
+        font-family: "IBM Plex Serif", ui-serif, Georgia, serif;
+        font-size: 26px;
+        font-style: italic;
+        font-weight: 500;
+        fill: rgba(255, 255, 255, 0.92);
+      }
+    ]]></style>
+  </defs>
+
+  
+  <rect x="0" y="0" width="2400" height="686" fill="#0B0B0C"></rect>
+
+  
+  <g class="rule" stroke-linecap="square" fill="none">
+    <path d="M 64 96 L 64 64 L 96 64"></path>
+    <path d="M 2304 64 L 2336 64 L 2336 96"></path>
+    <path d="M 64 590 L 64 622 L 96 622"></path>
+    <path d="M 2304 622 L 2336 622 L 2336 590"></path>
+  </g>
+
+  
+  <line x1="1380" y1="120" x2="1380" y2="566" class="rule"></line>
+
+  
+  <g>
+    
+    <text x="120" y="158" class="eyebrow">Trace · bash setup.sh</text>
+    <text x="1320" y="158" text-anchor="end" class="system-tag">macOS</text>
+
+    
+    <line x1="120" y1="178" x2="1320" y2="178" class="rule"></line>
+
+    
+
+    
+    <text x="152" y="246" class="term-glyph">▶</text>
+    <text x="192" y="246" class="term-line">installing Homebrew packages</text>
+    <text x="1100" y="246" text-anchor="end" class="term-glyph">✓</text>
+
+    
+    <text x="152" y="286" class="term-glyph">▶</text>
+    <text x="192" y="286" class="term-line">symlinking dotfiles</text>
+    <text x="1100" y="286" text-anchor="end" class="term-glyph">✓</text>
+
+    
+    <text x="152" y="326" class="term-glyph">▶</text>
+    <text x="192" y="326" class="term-line">configuring credentials</text>
+    <text x="1100" y="326" text-anchor="end" class="term-glyph">✓</text>
+
+    
+    <text x="152" y="366" class="term-glyph">▶</text>
+    <text x="192" y="366" class="term-line">wiring MCP servers</text>
+    <text x="1100" y="366" text-anchor="end" class="term-glyph">✓</text>
+
+    
+    <text x="152" y="406" class="term-glyph">▶</text>
+    <text x="192" y="406" class="term-line">installing Claude Code</text>
+    <text x="1100" y="406" text-anchor="end" class="term-glyph">✓</text>
+
+    
+    <line x1="152" y1="436" x2="1100" y2="436" class="rule"></line>
+
+    
+    <text x="152" y="484" class="term-final">→</text>
+    <text x="192" y="484" class="term-final">productive</text>
+
+    
+    <text x="1100" y="484" text-anchor="end" class="mono-tag" style="fill:#1F4D3A;opacity:0.9;">δ · end state</text>
+  </g>
+
+  
+  <g>
+    
+    <text x="1444" y="158" class="eyebrow">Project · amcheste/mac-dev-setup</text>
+
+    
+    <line x1="1444" y1="178" x2="2304" y2="178" class="rule"></line>
+
+    
+    <text x="1444" y="290" class="headline">mac-dev-setup.</text>
+
+    
+    <text x="1444" y="350" class="subtitle">An agentic-forward macOS developer environment,</text>
+    <text x="1444" y="384" class="subtitle">from zero to productive in one command.</text>
+
+    
+    <text x="1444" y="566" class="stack">Homebrew · ZSH · Vim · Claude-Code · ACT</text>
+
+    
+    <g transform="translate(2216 502)">
+      <rect x="0" y="0" width="88" height="88" fill="#0B0B0C" stroke="rgba(255,255,255,0.18)" stroke-width="1"></rect>
+      <g stroke="rgba(255,255,255,0.55)" stroke-width="1" fill="none">
+        <path d="M 7 14 L 7 7 L 14 7"></path>
+        <path d="M 74 7 L 81 7 L 81 14"></path>
+        <path d="M 7 74 L 7 81 L 14 81"></path>
+        <path d="M 74 81 L 81 81 L 81 74"></path>
+      </g>
+      <text x="20" y="55" text-anchor="middle" class="monogram-letter">A</text>
+      <text x="44" y="51" text-anchor="middle" class="monogram-epsilon">ε</text>
+      <text x="68" y="55" text-anchor="middle" class="monogram-letter">C</text>
+    </g>
+  </g>
+
+</svg>
\ No newline at end of file