diff --git a/.changeset/bright-caplets-brand.md b/.changeset/bright-caplets-brand.md
new file mode 100644
index 00000000..6b99ac57
--- /dev/null
+++ b/.changeset/bright-caplets-brand.md
@@ -0,0 +1,5 @@
+---
+"caplets": patch
+---
+
+Refresh the README header, add the Caplets icon artwork, and update plugin metadata with the new icon and brand color.
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 0c84cbcb..de680212 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -18,11 +18,11 @@
     "developerName": "Spirit-Led Software LLC",
     "category": "Developer Tools",
     "capabilities": ["MCP", "Tools"],
+    "composerIcon": "./assets/icon.png",
     "websiteURL": "https://github.com/spiritledsoftware/caplets",
     "defaultPrompt": [
-      "Use Caplets to discover configured capability domains before calling downstream tools.",
-      "Use Caplets progressive discovery before calling downstream tools."
+      "Use Caplets to discover configured capability domains via progressive discovery before calling downstream tools."
     ],
-    "brandColor": "#4F46E5"
+    "brandColor": "#E0582F"
   }
 }
diff --git a/README.md b/README.md
index 3c2e9f96..ca9fcf69 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,26 @@
-# Caplets
+<div align="center">
+  <img src="assets/icon.png" alt="Caplets logo" width="140" height="140" />
+
+  <h1>Caplets</h1>
+
+  <p>
+    <strong>Capability cards for coding agents.</strong><br />
+    Wrap sprawling tool stacks behind focused, progressive-disclosure interfaces.
+  </p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/caplets"><img alt="npm" src="https://img.shields.io/npm/v/caplets?style=flat-square&color=E0582F" /></a>
+    <a href="https://github.com/spiritledsoftware/caplets/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/spiritledsoftware/caplets/ci.yml?branch=main&style=flat-square&label=ci&color=E0582F" /></a>
+    <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-F6E8C8?style=flat-square&labelColor=1F2018" /></a>
+    <img alt="Node 22+" src="https://img.shields.io/badge/node-%3E%3D22-F6E8C8?style=flat-square&labelColor=1F2018" />
+  </p>
+
+  <p>
+    <code>MCP</code> · <code>OpenAPI</code> · <code>GraphQL</code> · <code>HTTP</code> · <code>CLI</code>
+  </p>
+</div>
+
+---
 
 Caplets turns sprawling tool setups into focused capability cards for coding agents.
 Connect MCP servers, OpenAPI specs, GraphQL endpoints, HTTP actions, and curated CLI
diff --git a/assets/icon.png b/assets/icon.png
new file mode 100644
index 00000000..4eebda4b
Binary files /dev/null and b/assets/icon.png differ