@jbarket/loomai 0.5.0

package/assets/demo.cast

@@ -0,0 +1,396 @@
+{"version": 2, "width": 100, "height": 28, "timestamp": 1745433600, "title": "loom: install \u2192 wake \u2192 remember \u2192 recall"}
+[0.5, "o", "\u001b[2J\u001b[H"]
+[1.0, "o", "\u001b[2m# loom \u2014 persistent identity + memory for AI agents\u001b[0m"]
+[1.0, "o", "\r\n"]
+[1.08, "o", "\u001b[2m# demo: install \u2192 wake \u2192 remember \u2192 recall\u001b[0m"]
+[1.08, "o", "\r\n"]
+[1.88, "o", "\r\n"]
+[2.48, "o", "\u001b[1;32m~\u001b[0m \u001b[1;34m$\u001b[0m "]
+[2.55, "o", "n"]
+[2.62, "o", "p"]
+[2.69, "o", "x"]
+[2.76, "o", " "]
+[2.88, "o", "l"]
+[2.95, "o", "o"]
+[3.02, "o", "o"]
+[3.09, "o", "m"]
+[3.16, "o", "a"]
+[3.23, "o", "i"]
+[3.3, "o", " "]
+[3.42, "o", "i"]
+[3.49, "o", "n"]
+[3.56, "o", "s"]
+[3.63, "o", "t"]
+[3.7, "o", "a"]
+[3.77, "o", "l"]
+[3.84, "o", "l"]
+[3.91, "o", " "]
+[4.03, "o", "-"]
+[4.1, "o", "-"]
+[4.17, "o", "h"]
+[4.24, "o", "a"]
+[4.31, "o", "r"]
+[4.38, "o", "n"]
+[4.45, "o", "e"]
+[4.52, "o", "s"]
+[4.59, "o", "s"]
+[4.66, "o", " "]
+[4.78, "o", "c"]
+[4.85, "o", "l"]
+[4.92, "o", "a"]
+[4.99, "o", "u"]
+[5.06, "o", "d"]
+[5.13, "o", "e"]
+[5.2, "o", "-"]
+[5.27, "o", "c"]
+[5.34, "o", "o"]
+[5.41, "o", "d"]
+[5.48, "o", "e"]
+[5.88, "o", "\r\n"]
+[6.98, "o", "\u001b[2mNeed to install the following packages:\u001b[0m"]
+[6.98, "o", "\r\n"]
+[7.04, "o", "\u001b[2m  loomai@0.4.0-alpha.7\u001b[0m"]
+[7.04, "o", "\r\n"]
+[7.04, "o", "\u001b[2mOk to proceed? (y) \u001b[0m"]
+[7.84, "o", "y"]
+[7.84, "o", "\r\n"]
+[8.34, "o", "\r\n"]
+[8.54, "o", "\u001b[32m\u2714\u001b[0m Wrote \u001b[1;37m~/.claude/skills/loom-setup.md\u001b[0m"]
+[8.54, "o", "\r\n"]
+[8.64, "o", "\r\n"]
+[8.74, "o", "\u001b[1mNext:\u001b[0m open Claude Code. \u001b[36m/loom-setup\u001b[0m."]
+[8.74, "o", "\r\n"]
+[8.82, "o", "\u001b[2mAfter the skill finishes, restart Claude Code (close and reopen).\u001b[0m"]
+[8.82, "o", "\r\n"]
+[8.82, "o", "\r\n"]
+[11.12, "o", "\r\n"]
+[11.12, "o", "\u001b[2m\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u001b[0m"]
+[11.12, "o", "\r\n"]
+[11.17, "o", "\u001b[2m  Claude Code  \u00b7  \u001b[1m/loom-setup\u001b[0m"]
+[11.17, "o", "\r\n"]
+[11.17, "o", "\u001b[2m\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u001b[0m"]
+[11.17, "o", "\r\n"]
+[11.67, "o", "\r\n"]
+[12.47, "o", "\u001b[2mChecking environment...\u001b[0m"]
+[13.67, "o", " \u001b[33mloom MCP not yet wired up (expected on first run)\u001b[0m"]
+[14.07, "o", "\r\n"]
+[14.37, "o", "\r\n"]
+[14.47, "o", "\u001b[1mLet's set up your agent.\u001b[0m"]
+[14.47, "o", "\r\n"]
+[15.07, "o", "\r\n"]
+[15.27, "o", "\u001b[1;37mAgent name:\u001b[0m "]
+[16.89, "o", "a"]
+[17.01, "o", "l"]
+[17.13, "o", "e"]
+[17.25, "o", "x"]
+[17.25, "o", "\r\n"]
+[17.85, "o", "\u001b[1;37mPurpose (one line):\u001b[0m "]
+[19.72, "o", "P"]
+[19.79, "o", "e"]
+[19.86, "o", "r"]
+[19.93, "o", "s"]
+[20.0, "o", "o"]
+[20.07, "o", "n"]
+[20.14, "o", "a"]
+[20.21, "o", "l"]
+[20.28, "o", " "]
+[20.4, "o", "a"]
+[20.47, "o", "s"]
+[20.54, "o", "s"]
+[20.61, "o", "i"]
+[20.68, "o", "s"]
+[20.75, "o", "t"]
+[20.82, "o", "a"]
+[20.89, "o", "n"]
+[20.96, "o", "t"]
+[21.03, "o", " "]
+[21.15, "o", "a"]
+[21.22, "o", "n"]
+[21.29, "o", "d"]
+[21.36, "o", " "]
+[21.48, "o", "c"]
+[21.55, "o", "o"]
+[21.62, "o", "d"]
+[21.69, "o", "i"]
+[21.76, "o", "n"]
+[21.83, "o", "g"]
+[21.9, "o", " "]
+[22.02, "o", "p"]
+[22.09, "o", "a"]
+[22.16, "o", "r"]
+[22.23, "o", "t"]
+[22.3, "o", "n"]
+[22.37, "o", "e"]
+[22.44, "o", "r"]
+[22.44, "o", "\r\n"]
+[23.04, "o", "\u001b[1;37mVoice:\u001b[0m "]
+[24.53, "o", "D"]
+[24.62, "o", "i"]
+[24.71, "o", "r"]
+[24.8, "o", "e"]
+[24.89, "o", "c"]
+[24.98, "o", "t"]
+[25.07, "o", ","]
+[25.16, "o", " "]
+[25.3, "o", "p"]
+[25.39, "o", "r"]
+[25.48, "o", "e"]
+[25.57, "o", "c"]
+[25.66, "o", "i"]
+[25.75, "o", "s"]
+[25.84, "o", "e"]
+[25.93, "o", ","]
+[26.02, "o", " "]
+[26.16, "o", "a"]
+[26.25, "o", " "]
+[26.39, "o", "b"]
+[26.48, "o", "i"]
+[26.57, "o", "t"]
+[26.66, "o", " "]
+[26.8, "o", "d"]
+[26.89, "o", "r"]
+[26.98, "o", "y"]
+[26.98, "o", "\r\n"]
+[27.58, "o", "\u001b[1;37mClients (e.g. claude-code):\u001b[0m "]
+[28.87, "o", "c"]
+[28.96, "o", "l"]
+[29.05, "o", "a"]
+[29.14, "o", "u"]
+[29.23, "o", "d"]
+[29.32, "o", "e"]
+[29.41, "o", "-"]
+[29.5, "o", "c"]
+[29.59, "o", "o"]
+[29.68, "o", "d"]
+[29.77, "o", "e"]
+[29.77, "o", "\r\n"]
+[30.37, "o", "\r\n"]
+[31.07, "o", "\u001b[32m\u2714\u001b[0m Identity initialized for \u001b[1malex\u001b[0m"]
+[31.07, "o", "\r\n"]
+[31.22, "o", "\u001b[32m\u2714\u001b[0m \u001b[2mIDENTITY.md, preferences.md, self-model.md \u2192 ~/.config/loom/alex/\u001b[0m"]
+[31.22, "o", "\r\n"]
+[31.37, "o", "\u001b[32m\u2714\u001b[0m \u001b[2mMCP config written to ~/.mcp.json\u001b[0m"]
+[31.37, "o", "\r\n"]
+[31.52, "o", "\u001b[32m\u2714\u001b[0m \u001b[2m~/.claude/CLAUDE.md updated with identity pointer\u001b[0m"]
+[31.52, "o", "\r\n"]
+[31.92, "o", "\r\n"]
+[32.02, "o", "\u001b[1;33mRestart Claude Code now to activate loom.\u001b[0m"]
+[32.02, "o", "\r\n"]
+[32.02, "o", "\r\n"]
+[35.82, "o", "\r\n"]
+[35.82, "o", "\u001b[2m\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u001b[0m"]
+[35.82, "o", "\r\n"]
+[35.87, "o", "\u001b[2m  Claude Code  \u00b7  new session\u001b[0m"]
+[35.87, "o", "\r\n"]
+[35.87, "o", "\u001b[2m\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u001b[0m"]
+[35.87, "o", "\r\n"]
+[36.37, "o", "\r\n"]
+[37.07, "o", "\u001b[2m[mcp__loom__identity \u2192 loading alex's identity]\u001b[0m"]
+[37.07, "o", "\r\n"]
+[37.57, "o", "\r\n"]
+[37.63, "o", "\u001b[1m# Identity\u001b[0m"]
+[37.63, "o", "\r\n"]
+[37.68, "o", ""]
+[37.68, "o", "\r\n"]
+[37.76, "o", "\u001b[1m# alex\u001b[0m"]
+[37.76, "o", "\r\n"]
+[37.84, "o", ""]
+[37.84, "o", "\r\n"]
+[37.92, "o", "Personal assistant and coding partner"]
+[37.92, "o", "\r\n"]
+[38.0, "o", ""]
+[38.0, "o", "\r\n"]
+[38.08, "o", "\u001b[1m## Voice\u001b[0m"]
+[38.08, "o", "\r\n"]
+[38.16, "o", ""]
+[38.16, "o", "\r\n"]
+[38.24, "o", "Direct, precise, a bit dry"]
+[38.24, "o", "\r\n"]
+[38.38, "o", ""]
+[38.38, "o", "\r\n"]
+[38.46, "o", "\u001b[2m---\u001b[0m"]
+[38.46, "o", "\r\n"]
+[38.54, "o", ""]
+[38.54, "o", "\r\n"]
+[38.62, "o", "\u001b[1m# Preferences\u001b[0m"]
+[38.62, "o", "\r\n"]
+[38.7, "o", ""]
+[38.7, "o", "\r\n"]
+[38.78, "o", "\u001b[1m# alex \u2014 Preferences\u001b[0m"]
+[38.78, "o", "\r\n"]
+[38.86, "o", ""]
+[38.86, "o", "\r\n"]
+[38.94, "o", "\u001b[2m*No initial preferences set.*\u001b[0m"]
+[38.94, "o", "\r\n"]
+[39.08, "o", ""]
+[39.08, "o", "\r\n"]
+[39.16, "o", "\u001b[2m---\u001b[0m"]
+[39.16, "o", "\r\n"]
+[39.24, "o", ""]
+[39.24, "o", "\r\n"]
+[39.32, "o", "\u001b[1m# Self-Model\u001b[0m"]
+[39.32, "o", "\r\n"]
+[39.4, "o", ""]
+[39.4, "o", "\r\n"]
+[39.48, "o", "\u001b[1m## Strengths\u001b[0m"]
+[39.48, "o", "\r\n"]
+[39.56, "o", "\u001b[2m*(Add your strengths as you discover them)*\u001b[0m"]
+[39.56, "o", "\r\n"]
+[42.86, "o", "\r\n"]
+[42.86, "o", "\u001b[2m\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u001b[0m"]
+[42.86, "o", "\r\n"]
+[43.16, "o", "\r\n"]
+[43.56, "o", "\u001b[1;32m~\u001b[0m \u001b[1;34m$\u001b[0m "]
+[43.616, "o", "e"]
+[43.672, "o", "c"]
+[43.728, "o", "h"]
+[43.784, "o", "o"]
+[43.84, "o", " "]
+[43.946, "o", "\""]
+[44.002, "o", "P"]
+[44.058, "o", "r"]
+[44.114, "o", "e"]
+[44.17, "o", "f"]
+[44.226, "o", "e"]
+[44.282, "o", "r"]
+[44.338, "o", "s"]
+[44.394, "o", " "]
+[44.5, "o", "a"]
+[44.556, "o", "s"]
+[44.612, "o", "y"]
+[44.668, "o", "n"]
+[44.724, "o", "c"]
+[44.78, "o", " "]
+[44.886, "o", "p"]
+[44.942, "o", "a"]
+[44.998, "o", "i"]
+[45.054, "o", "r"]
+[45.11, "o", " "]
+[45.216, "o", "p"]
+[45.272, "o", "r"]
+[45.328, "o", "o"]
+[45.384, "o", "g"]
+[45.44, "o", "r"]
+[45.496, "o", "a"]
+[45.552, "o", "m"]
+[45.608, "o", "m"]
+[45.664, "o", "i"]
+[45.72, "o", "n"]
+[45.776, "o", "g"]
+[45.832, "o", " "]
+[45.938, "o", "o"]
+[45.994, "o", "n"]
+[46.05, "o", " "]
+[46.156, "o", "w"]
+[46.212, "o", "e"]
+[46.268, "o", "e"]
+[46.324, "o", "k"]
+[46.38, "o", "d"]
+[46.436, "o", "a"]
+[46.492, "o", "y"]
+[46.548, "o", " "]
+[46.654, "o", "e"]
+[46.71, "o", "v"]
+[46.766, "o", "e"]
+[46.822, "o", "n"]
+[46.878, "o", "i"]
+[46.934, "o", "n"]
+[46.99, "o", "g"]
+[47.046, "o", "s"]
+[47.102, "o", "\""]
+[47.158, "o", " "]
+[47.264, "o", "|"]
+[47.32, "o", " "]
+[47.426, "o", "l"]
+[47.482, "o", "o"]
+[47.538, "o", "o"]
+[47.594, "o", "m"]
+[47.65, "o", " "]
+[47.756, "o", "r"]
+[47.812, "o", "e"]
+[47.868, "o", "m"]
+[47.924, "o", "e"]
+[47.98, "o", "m"]
+[48.036, "o", "b"]
+[48.092, "o", "e"]
+[48.148, "o", "r"]
+[48.204, "o", " "]
+[48.31, "o", "\""]
+[48.366, "o", "w"]
+[48.422, "o", "o"]
+[48.478, "o", "r"]
+[48.534, "o", "k"]
+[48.59, "o", "i"]
+[48.646, "o", "n"]
+[48.702, "o", "g"]
+[48.758, "o", " "]
+[48.864, "o", "s"]
+[48.92, "o", "t"]
+[48.976, "o", "y"]
+[49.032, "o", "l"]
+[49.088, "o", "e"]
+[49.144, "o", "\""]
+[49.2, "o", " "]
+[49.306, "o", "-"]
+[49.362, "o", "-"]
+[49.418, "o", "c"]
+[49.474, "o", "a"]
+[49.53, "o", "t"]
+[49.586, "o", "e"]
+[49.642, "o", "g"]
+[49.698, "o", "o"]
+[49.754, "o", "r"]
+[49.81, "o", "y"]
+[49.866, "o", " "]
+[49.972, "o", "u"]
+[50.028, "o", "s"]
+[50.084, "o", "e"]
+[50.14, "o", "r"]
+[50.54, "o", "\r\n"]
+[51.34, "o", "\u001b[32mRemembered:\u001b[0m \u001b[2muser/working-style-a4f2c1\u001b[0m \u2014 \u001b[1mworking style\u001b[0m"]
+[51.34, "o", "\r\n"]
+[51.74, "o", "\r\n"]
+[52.04, "o", "\u001b[1;32m~\u001b[0m \u001b[1;34m$\u001b[0m "]
+[52.11, "o", "l"]
+[52.18, "o", "o"]
+[52.25, "o", "o"]
+[52.32, "o", "m"]
+[52.39, "o", " "]
+[52.51, "o", "r"]
+[52.58, "o", "e"]
+[52.65, "o", "c"]
+[52.72, "o", "a"]
+[52.79, "o", "l"]
+[52.86, "o", "l"]
+[52.93, "o", " "]
+[53.05, "o", "\""]
+[53.12, "o", "p"]
+[53.19, "o", "a"]
+[53.26, "o", "i"]
+[53.33, "o", "r"]
+[53.4, "o", " "]
+[53.52, "o", "p"]
+[53.59, "o", "r"]
+[53.66, "o", "o"]
+[53.73, "o", "g"]
+[53.8, "o", "r"]
+[53.87, "o", "a"]
+[53.94, "o", "m"]
+[54.01, "o", "m"]
+[54.08, "o", "i"]
+[54.15, "o", "n"]
+[54.22, "o", "g"]
+[54.29, "o", "\""]
+[54.69, "o", "\r\n"]
+[55.59, "o", "Found \u001b[1m1\u001b[0m matching memory:"]
+[55.59, "o", "\r\n"]
+[55.89, "o", "\r\n"]
+[55.89, "o", "\u001b[1m## working style\u001b[0m"]
+[55.89, "o", "\r\n"]
+[55.99, "o", "\u001b[2muser \u00b7 2026-04-23\u001b[0m"]
+[55.99, "o", "\r\n"]
+[56.09, "o", "\r\n"]
+[56.19, "o", "Prefers async pair programming on weekday evenings"]
+[56.19, "o", "\r\n"]
+[56.69, "o", "\r\n"]
+[57.09, "o", "\u001b[1;32m~\u001b[0m \u001b[1;34m$\u001b[0m "]

package/assets/skill/SKILL.md

@@ -0,0 +1,192 @@
+---
+name: loom-setup
+description: Set up loom (persistent identity + memory) for this agent
+---
+
+# loom-setup
+
+You are installing and configuring loom — a persistent identity +
+memory layer — for the user in the harness you're running in right
+now. loom is already installed as a CLI (`loom` or `npx loom`). Your
+job is to drive the first-run flow, with the user's consent, without
+clobbering anything that already exists.
+
+## Ground rules
+
+- **Existing agent dirs are inviolable.** If `~/.config/loom/<name>/`
+  has an `IDENTITY.md`, it belongs to a prior agent. Never overwrite
+  it. Never propose `--force`. If the user wants to replace an agent,
+  they remove the directory themselves.
+- **Verify, don't assume.** Read harness config files before writing
+  to them. Re-read after writing. Finish with `loom wake --json`.
+- **When you can do it, do it.** Don't ask the user to edit JSON by
+  hand if you can edit the file yourself. Don't print a config
+  snippet as advice when you can write it.
+
+## Step 1 — Probe the environment
+
+Run: `loom doctor --json`
+
+Parse the output. You'll see:
+
+- `stackVersionOk`, `nodeOk`, `contextDirResolved`
+- `existingAgents: [{ name, path, hasIdentity, hasMemoriesDb,
+  git: { initialized, hasRemote, dirty, gitignorePresent } }, ...]`
+
+If `stackVersionOk` is false or `nodeOk` is false, stop and tell the
+user what's wrong.
+
+## Step 2 — Decide: new agent or use existing
+
+If `existingAgents` is non-empty, summarize them to the user:
+
+> I see these agents already set up:
+> - `myagent` at `~/.config/loom/myagent/` (has identity)
+>
+> Do you want to (a) use an existing one, (b) create a new one with a
+> different name, or (c) stop?
+
+- If they pick (a): set `LOOM_CONTEXT_DIR=<path>` and skip to Step 5
+  (you're just wiring this harness to an existing agent).
+- If they pick (b): continue to Step 3 with a new name.
+- If they pick (c): exit.
+
+If `existingAgents` is empty, tell the user that and continue to
+Step 3.
+
+## Step 3 — Interview
+
+**Four questions. That is the whole interview.** Everything else a first
+identity needs — what a persistent agent *is*, where its continuity lives,
+how memory is tiered, the reflection loop, honesty about what it knows —
+is written by `bootstrap` from a fixed scaffold. Don't ask about any of
+it, and don't invent extra questions.
+
+Ask one at a time, and **show the example before the question**. A cold
+"what is this agent for?" gets a blank answer back.
+
+**1. The user's name.**
+
+> For example: `Jonathan`.
+>
+> What should this agent call you?
+
+**2. The agent's name.**
+
+> For example: `art`, `visual-mark`, `sage`.
+>
+> What do you want to call it?
+
+Must be lowercase alphanumeric + hyphens, 1–64 chars, not a reserved word
+(`current`, `default`, `config`, `backups`, `cache`, `tmp`, `shared`).
+Re-ask on any collision with an existing dir.
+
+**3. Purpose — one line.** What it exists to do.
+
+> For example: *"Jonathan's primary assistant and the coordinator of all
+> work — holds memory across sessions and runs parallel worker agents."*
+>
+> What is yours for?
+
+**4. Voice — one line.** How it talks.
+
+> For example: *"Direct. Brief when brief is right, thorough when the task
+> demands it. Has opinions and pushes back — never a yes-machine."*
+>
+> How should it sound?
+
+Two rules about the examples:
+
+- They are a **shape, not a menu**. If the answer comes back as the example
+  with a name swapped in, ask once more for it in their own words. A copied
+  purpose line produces a copied agent, and this has actually happened.
+- The answers are **theirs**. Pass them through verbatim. Don't polish them
+  into your own prose, and don't expand a one-liner into a paragraph.
+
+The context dir will be `~/.config/loom/<name>/` unless the user
+overrides.
+
+## Step 4 — Bootstrap
+
+Run:
+
+```
+echo '{"user":"<USER>","name":"<NAME>","purpose":"<PURPOSE>","voice":"<VOICE>"}' \
+  | loom bootstrap --context-dir ~/.config/loom/<NAME>
+```
+
+This writes the full IDENTITY.md — the four answers at the top, the
+structural scaffold below them — plus `preferences.md` seeded with the
+user's name and `self-model.md`.
+
+Then scaffold the harness manifest for this harness:
+
+```
+loom harness init <HARNESS_KEY> --context-dir ~/.config/loom/<NAME>
+```
+
+Where `<HARNESS_KEY>` is one of `claude-code`, `codex`, `gemini-cli`,
+`opencode`.
+
+## Step 5 — Wire the harness's MCP config
+
+This is the part only you can do safely, because the file path and
+schema drift per vendor. Read the relevant config file for this
+harness before writing anything.
+
+Targets (Linux/macOS):
+
+| harness     | config file                            | env vars to set            |
+|-------------|----------------------------------------|----------------------------|
+| claude-code | `~/.claude.json` or `.mcp.json` in cwd | `LOOM_CONTEXT_DIR`, `LOOM_CLIENT=claude-code`, `LOOM_MODEL` |
+| codex       | `~/.codex/config.toml`                 | same + `LOOM_CLIENT=codex` |
+| gemini-cli  | `~/.gemini/settings.json`              | same + `LOOM_CLIENT=gemini-cli` |
+| opencode    | `~/.config/opencode/config.json`       | same + `LOOM_CLIENT=opencode` |
+
+Procedure:
+
+1. Read the current config file.
+2. Look for an existing `loom` entry under `mcpServers` (JSON) or
+   `[mcp_servers.loom]` (TOML). If one exists and points to the right
+   context dir, skip this step.
+3. If absent, add an entry that runs `loom serve` with the env vars
+   above. Use `loom` as the command (or `npx loom` if `loom` isn't on
+   PATH).
+4. Re-read the file to verify your edit took.
+
+If the file format confuses you, stop and ask the user rather than
+guess.
+
+## Step 6 — Inject identity pointer into the harness dotfile
+
+Run:
+
+```
+loom inject --harness <HARNESS_KEY> --context-dir ~/.config/loom/<NAME>
+```
+
+This writes a marker-bounded block into the harness's CLAUDE.md /
+AGENTS.md / GEMINI.md telling the agent to call the `identity` tool
+on session start.
+
+## Step 7 — Verify
+
+Run: `loom wake --json --context-dir ~/.config/loom/<NAME>`
+
+- If it returns a payload with the right name: success. Tell the user
+  to **restart their harness** (close and reopen, or exit and
+  restart) so the new MCP server picks up the config edit. Remind
+  them that once they reopen, calling `identity` will wake them as
+  `<NAME>`.
+- If it errors: diagnose from the output and loop back to the failing
+  step.
+
+## What you are *not* doing
+
+- Editing IDENTITY.md or preferences.md content yourself. The
+  bootstrap + procedures seeds leave sensible templates; the agent
+  edits them after first wake.
+- Writing any file under `~/.config/loom/<name>/` other than what the
+  `loom` CLI puts there.
+- Running `bootstrap --force`, ever.
+- Touching another existing agent's dir.

package/dist/backends/embedding-runtime.d.ts

@@ -0,0 +1,39 @@
+/** Dense models this runtime knows how to fetch and run. */
+export declare const EmbeddingModel: {
+    readonly AllMiniLML6V2: 'fast-all-MiniLM-L6-v2';
+    readonly BGEBaseEN: 'fast-bge-base-en';
+    readonly BGEBaseENV15: 'fast-bge-base-en-v1.5';
+    readonly BGESmallEN: 'fast-bge-small-en';
+    readonly BGESmallENV15: 'fast-bge-small-en-v1.5';
+    readonly BGESmallZH: 'fast-bge-small-zh-v1.5';
+    readonly MLE5Large: 'fast-multilingual-e5-large';
+};
+export type EmbeddingModelName = (typeof EmbeddingModel)[keyof typeof EmbeddingModel];
+export interface FlagEmbeddingInit {
+    model: EmbeddingModelName;
+    cacheDir: string;
+    /** Token cap per input. Clamped by the model's own tokenizer config. */
+    maxLength?: number;
+}
+/**
+ * Loaded dense embedder: a tokenizer plus an ONNX inference session.
+ *
+ * Named for the upstream class so the diff in fastembed.ts stays reviewable.
+ */
+export declare class FlagEmbedding {
+    private readonly tokenizer;
+    private readonly session;
+    private readonly model;
+    private constructor();
+    static init({ model, cacheDir, maxLength, }: FlagEmbeddingInit): Promise<FlagEmbedding>;
+    embed(texts: string[], batchSize?: number): AsyncGenerator<Float32Array[]>;
+    /**
+     * QUIRK PRESERVED: the "query: " prefix is the E5 instruction format. BGE
+     * models want "Represent this sentence for searching relevant passages: "
+     * instead. Upstream applied E5's prefix to every model and loom's stored
+     * vectors were produced under that regime, so it stays until we decide to
+     * re-embed. See t-424.
+     */
+    queryEmbed(query: string): Promise<Float32Array>;
+    private runBatch;
+}