@iaforged/context-code 1.1.7 → 1.2.1

package/dist/src/utils/themes/builtin/opencode/tokyonight.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://opencode.ai/desktop-theme.json",
+  "name": "Tokyonight",
+  "id": "tokyonight",
+  "light": {
+    "palette": {
+      "neutral": "#e1e2e7",
+      "ink": "#273153",
+      "primary": "#2e7de9",
+      "accent": "#b15c00",
+      "success": "#587539",
+      "warning": "#8c6c3e",
+      "error": "#c94060",
+      "info": "#007197",
+      "diffAdd": "#4f8f7b",
+      "diffDelete": "#d05f7c"
+    },
+    "overrides": {
+      "syntax-comment": "#6b6f7a",
+      "syntax-keyword": "#9854f1",
+      "syntax-primitive": "#1f6fd4",
+      "syntax-property": "#007197",
+      "syntax-constant": "#b15c00"
+    }
+  },
+  "dark": {
+    "palette": {
+      "neutral": "#1a1b26",
+      "ink": "#c0caf5",
+      "primary": "#7aa2f7",
+      "accent": "#ff9e64",
+      "success": "#9ece6a",
+      "warning": "#e0af68",
+      "error": "#f7768e",
+      "info": "#7dcfff",
+      "diffAdd": "#41a6b5",
+      "diffDelete": "#c34043"
+    },
+    "overrides": {
+      "syntax-comment": "#565f89",
+      "syntax-keyword": "#bb9af7",
+      "syntax-primitive": "#7aa2f7",
+      "syntax-property": "#7dcfff",
+      "syntax-constant": "#ff9e64"
+    }
+  }
+}

package/dist/src/utils/themes/builtin/opencode/vercel.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://opencode.ai/desktop-theme.json",
+  "name": "Vercel",
+  "id": "vercel",
+  "light": {
+    "palette": {
+      "neutral": "#FFFFFF",
+      "ink": "#171717",
+      "primary": "#0070F3",
+      "accent": "#8E4EC6",
+      "success": "#388E3C",
+      "warning": "#FF9500",
+      "error": "#DC3545",
+      "info": "#0070F3",
+      "diffAdd": "#46A758",
+      "diffDelete": "#E5484D"
+    },
+    "overrides": {
+      "text-weak": "#666666",
+      "syntax-comment": "#888888",
+      "syntax-keyword": "#E93D82",
+      "syntax-string": "#46A758",
+      "syntax-primitive": "#8E4EC6",
+      "syntax-variable": "#0070F3",
+      "syntax-property": "#12A594",
+      "syntax-type": "#12A594",
+      "syntax-constant": "#FFB224",
+      "syntax-operator": "#E93D82",
+      "syntax-punctuation": "#171717",
+      "syntax-object": "#0070F3",
+      "markdown-heading": "#8E4EC6",
+      "markdown-text": "#171717",
+      "markdown-link": "#0070F3",
+      "markdown-link-text": "#12A594",
+      "markdown-code": "#46A758",
+      "markdown-block-quote": "#666666",
+      "markdown-emph": "#FFB224",
+      "markdown-strong": "#E93D82",
+      "markdown-horizontal-rule": "#999999",
+      "markdown-list-item": "#171717",
+      "markdown-list-enumeration": "#0070F3",
+      "markdown-image": "#12A594",
+      "markdown-image-text": "#12A594",
+      "markdown-code-block": "#171717"
+    }
+  },
+  "dark": {
+    "palette": {
+      "neutral": "#000000",
+      "ink": "#EDEDED",
+      "primary": "#0070F3",
+      "accent": "#8E4EC6",
+      "success": "#46A758",
+      "warning": "#FFB224",
+      "error": "#E5484D",
+      "info": "#52A8FF",
+      "interactive": "#52A8FF",
+      "diffAdd": "#63C46D",
+      "diffDelete": "#FF6166"
+    },
+    "overrides": {
+      "text-weak": "#878787",
+      "syntax-comment": "#878787",
+      "syntax-keyword": "#F75590",
+      "syntax-string": "#63C46D",
+      "syntax-primitive": "#BF7AF0",
+      "syntax-variable": "#52A8FF",
+      "syntax-property": "#0AC7AC",
+      "syntax-type": "#0AC7AC",
+      "syntax-constant": "#F2A700",
+      "syntax-operator": "#F75590",
+      "syntax-punctuation": "#EDEDED",
+      "syntax-object": "#52A8FF",
+      "markdown-heading": "#BF7AF0",
+      "markdown-text": "#EDEDED",
+      "markdown-link": "#52A8FF",
+      "markdown-link-text": "#0AC7AC",
+      "markdown-code": "#63C46D",
+      "markdown-block-quote": "#878787",
+      "markdown-emph": "#F2A700",
+      "markdown-strong": "#F75590",
+      "markdown-horizontal-rule": "#454545",
+      "markdown-list-item": "#EDEDED",
+      "markdown-list-enumeration": "#52A8FF",
+      "markdown-image": "#0AC7AC",
+      "markdown-image-text": "#50E3C2",
+      "markdown-code-block": "#EDEDED"
+    }
+  }
+}

package/dist/src/utils/themes/builtin/opencode/vesper.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://opencode.ai/desktop-theme.json",
+  "name": "Vesper",
+  "id": "vesper",
+  "light": {
+    "palette": {
+      "neutral": "#F0F0F0",
+      "ink": "#101010",
+      "primary": "#FFC799",
+      "accent": "#B30000",
+      "success": "#99FFE4",
+      "warning": "#FFC799",
+      "error": "#FF8080",
+      "info": "#FFC799",
+      "diffAdd": "#99FFE4",
+      "diffDelete": "#FF8080"
+    },
+    "overrides": {
+      "syntax-comment": "#7a7a7a",
+      "syntax-keyword": "#6e6e6e",
+      "syntax-string": "#117e69",
+      "syntax-primitive": "#8d541c",
+      "syntax-property": "#101010",
+      "syntax-type": "#8d541c",
+      "syntax-constant": "#8d541c"
+    }
+  },
+  "dark": {
+    "palette": {
+      "neutral": "#101010",
+      "ink": "#FFF",
+      "primary": "#FFC799",
+      "accent": "#FF8080",
+      "success": "#99FFE4",
+      "warning": "#FFC799",
+      "error": "#FF8080",
+      "info": "#FFC799",
+      "diffAdd": "#99FFE4",
+      "diffDelete": "#FF8080"
+    },
+    "overrides": {
+      "syntax-comment": "#8b8b8b",
+      "syntax-keyword": "#a0a0a0",
+      "syntax-string": "#99ffe4",
+      "syntax-primitive": "#ffc799",
+      "syntax-property": "#ffffff",
+      "syntax-type": "#ffc799",
+      "syntax-constant": "#ffc799"
+    }
+  }
+}

package/dist/src/utils/themes/builtin/opencode/zenburn.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://opencode.ai/desktop-theme.json",
+  "name": "Zenburn",
+  "id": "zenburn",
+  "light": {
+    "palette": {
+      "neutral": "#ffffef",
+      "ink": "#3f3f3f",
+      "primary": "#5f7f8f",
+      "accent": "#5f8f8f",
+      "success": "#5f8f5f",
+      "warning": "#8f8f5f",
+      "error": "#8f5f5f",
+      "info": "#8f7f5f"
+    },
+    "overrides": {
+      "text-weak": "#6f6f6f",
+      "syntax-comment": "#5f7f5f",
+      "syntax-keyword": "#8f8f5f",
+      "syntax-string": "#8f5f5f",
+      "syntax-primitive": "#5f7f8f",
+      "syntax-variable": "#3f3f3f",
+      "syntax-property": "#5f8f8f",
+      "syntax-type": "#5f8f8f",
+      "syntax-constant": "#5f8f5f",
+      "syntax-operator": "#8f8f5f",
+      "syntax-punctuation": "#3f3f3f",
+      "syntax-object": "#3f3f3f",
+      "markdown-heading": "#8f8f5f",
+      "markdown-text": "#3f3f3f",
+      "markdown-link": "#5f7f8f",
+      "markdown-link-text": "#5f8f8f",
+      "markdown-code": "#5f8f5f",
+      "markdown-block-quote": "#6f6f6f",
+      "markdown-emph": "#8f8f5f",
+      "markdown-strong": "#8f7f5f",
+      "markdown-horizontal-rule": "#6f6f6f",
+      "markdown-list-item": "#5f7f8f",
+      "markdown-list-enumeration": "#5f8f8f",
+      "markdown-image": "#5f7f8f",
+      "markdown-image-text": "#5f8f8f",
+      "markdown-code-block": "#3f3f3f"
+    }
+  },
+  "dark": {
+    "palette": {
+      "neutral": "#3f3f3f",
+      "ink": "#dcdccc",
+      "primary": "#8cd0d3",
+      "accent": "#93e0e3",
+      "success": "#7f9f7f",
+      "warning": "#f0dfaf",
+      "error": "#cc9393",
+      "info": "#dfaf8f",
+      "diffAdd": "#8fb28f",
+      "diffDelete": "#dca3a3"
+    },
+    "overrides": {
+      "text-weak": "#9f9f9f",
+      "syntax-comment": "#7f9f7f",
+      "syntax-keyword": "#f0dfaf",
+      "syntax-string": "#cc9393",
+      "syntax-primitive": "#8cd0d3",
+      "syntax-variable": "#dcdccc",
+      "syntax-property": "#93e0e3",
+      "syntax-type": "#93e0e3",
+      "syntax-constant": "#8fb28f",
+      "syntax-operator": "#f0dfaf",
+      "syntax-punctuation": "#dcdccc",
+      "syntax-object": "#dcdccc",
+      "markdown-heading": "#f0dfaf",
+      "markdown-text": "#dcdccc",
+      "markdown-link": "#8cd0d3",
+      "markdown-link-text": "#93e0e3",
+      "markdown-code": "#7f9f7f",
+      "markdown-block-quote": "#9f9f9f",
+      "markdown-emph": "#e0cf9f",
+      "markdown-strong": "#dfaf8f",
+      "markdown-horizontal-rule": "#9f9f9f",
+      "markdown-list-item": "#8cd0d3",
+      "markdown-list-enumeration": "#93e0e3",
+      "markdown-image": "#8cd0d3",
+      "markdown-image-text": "#93e0e3",
+      "markdown-code-block": "#dcdccc"
+    }
+  }
+}

package/dist/src/utils/themes/index.js

@@ -0,0 +1,4 @@
+export { hexToRgb, lighten, resolveColor, resolveTheme } from './resolver.js';
+export { mapOpencodeToCli } from './opencodeMapper.js';
+export { loadAllThemes, loadAllThemesSync } from './loader.js';
+export { bootstrapDynamicThemes } from './bootstrap.js';

package/dist/src/utils/themes/loader.js

@@ -0,0 +1,147 @@
+import { promises as fs, readFileSync, readdirSync } from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { mapOpencodeToCli } from './opencodeMapper.js';
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+const PRIORITY = {
+    opencode: 0,
+    cli: 1,
+    user: 2,
+};
+function isThemeJson(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return typeof v.theme === 'object' && v.theme !== null;
+}
+function looksLikeOpencode(json) {
+    return Object.prototype.hasOwnProperty.call(json.theme, 'primary');
+}
+async function readJsonFile(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!isThemeJson(parsed)) {
+            console.warn(`[themes] skipping ${filePath}: invalid theme schema`);
+            return null;
+        }
+        return parsed;
+    }
+    catch (err) {
+        console.warn(`[themes] failed to load ${filePath}:`, err);
+        return null;
+    }
+}
+async function readDirSafe(dir) {
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        return entries
+            .filter(e => e.isFile() && e.name.toLowerCase().endsWith('.json'))
+            .map(e => path.join(dir, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+function idFromPath(file) {
+    return path.basename(file, path.extname(file));
+}
+async function loadFromDir(dir, source, transform) {
+    const files = await readDirSafe(dir);
+    const out = [];
+    for (const file of files) {
+        const json = await readJsonFile(file);
+        if (!json)
+            continue;
+        const finalJson = transform ? transform(json) : json;
+        out.push({ id: idFromPath(file), source, json: finalJson });
+    }
+    return out;
+}
+function userThemesDir() {
+    return path.join(os.homedir(), '.config', '.claude', 'themes');
+}
+function builtinDir(source) {
+    // Resolved relative to this file at runtime.
+    return path.join(HERE, 'builtin', source);
+}
+export async function loadAllThemes() {
+    const [cliThemes, opencodeThemes, userFiles] = await Promise.all([
+        loadFromDir(builtinDir('cli'), 'cli'),
+        loadFromDir(builtinDir('opencode'), 'opencode', mapOpencodeToCli),
+        readDirSafe(userThemesDir()),
+    ]);
+    const userThemes = [];
+    for (const file of userFiles) {
+        const json = await readJsonFile(file);
+        if (!json)
+            continue;
+        const finalJson = looksLikeOpencode(json) ? mapOpencodeToCli(json) : json;
+        userThemes.push({ id: idFromPath(file), source: 'user', json: finalJson });
+    }
+    // Merge with priority: user > cli > opencode
+    const byId = new Map();
+    for (const t of [...opencodeThemes, ...cliThemes, ...userThemes]) {
+        const existing = byId.get(t.id);
+        if (!existing || PRIORITY[t.source] >= PRIORITY[existing.source]) {
+            byId.set(t.id, t);
+        }
+    }
+    return Array.from(byId.values());
+}
+function readDirSafeSync(dir) {
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        return entries
+            .filter(e => e.isFile() && e.name.toLowerCase().endsWith('.json'))
+            .map(e => path.join(dir, e.name))
+            .filter(f => !path.basename(f).startsWith('_'));
+    }
+    catch {
+        return [];
+    }
+}
+function readJsonFileSync(filePath) {
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!isThemeJson(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function loadFromDirSync(dir, source, transform) {
+    const out = [];
+    for (const file of readDirSafeSync(dir)) {
+        const json = readJsonFileSync(file);
+        if (!json)
+            continue;
+        const finalJson = transform ? transform(json) : json;
+        out.push({ id: idFromPath(file), source, json: finalJson });
+    }
+    return out;
+}
+export function loadAllThemesSync() {
+    const cliThemes = loadFromDirSync(builtinDir('cli'), 'cli');
+    const opencodeThemes = loadFromDirSync(builtinDir('opencode'), 'opencode', mapOpencodeToCli);
+    const userThemes = [];
+    for (const file of readDirSafeSync(userThemesDir())) {
+        const json = readJsonFileSync(file);
+        if (!json)
+            continue;
+        const finalJson = looksLikeOpencode(json) ? mapOpencodeToCli(json) : json;
+        userThemes.push({ id: idFromPath(file), source: 'user', json: finalJson });
+    }
+    const byId = new Map();
+    for (const t of [...opencodeThemes, ...cliThemes, ...userThemes]) {
+        const existing = byId.get(t.id);
+        if (!existing || PRIORITY[t.source] >= PRIORITY[existing.source]) {
+            byId.set(t.id, t);
+        }
+    }
+    return Array.from(byId.values());
+}

package/dist/src/utils/themes/opencodeMapper.js

@@ -0,0 +1,124 @@
+const FALLBACK = 'rgb(128,128,128)';
+function pick(obj, key, fallback) {
+    const direct = obj.theme[key];
+    if (direct !== undefined)
+        return direct;
+    if (fallback !== undefined) {
+        const fb = obj.theme[fallback];
+        if (fb !== undefined)
+            return fb;
+    }
+    return FALLBACK;
+}
+export function mapOpencodeToCli(opencode) {
+    const t = opencode;
+    const primary = pick(t, 'primary');
+    const secondary = pick(t, 'secondary', 'primary');
+    const accent = pick(t, 'accent', 'primary');
+    const text = pick(t, 'text');
+    const textMuted = pick(t, 'textMuted', 'text');
+    const background = pick(t, 'background');
+    const backgroundPanel = pick(t, 'backgroundPanel', 'background');
+    const backgroundElement = pick(t, 'backgroundElement', 'backgroundPanel');
+    const border = pick(t, 'border');
+    const borderActive = pick(t, 'borderActive', 'border');
+    const selectedListItemText = pick(t, 'selectedListItemText', 'background');
+    const error = pick(t, 'error');
+    const warning = pick(t, 'warning');
+    const success = pick(t, 'success');
+    const info = pick(t, 'info', 'secondary');
+    const diffAdded = pick(t, 'diffAdded');
+    const diffRemoved = pick(t, 'diffRemoved');
+    const diffAddedBg = pick(t, 'diffAddedBg', 'diffAdded');
+    const diffRemovedBg = pick(t, 'diffRemovedBg', 'diffRemoved');
+    const diffHighlightAdded = pick(t, 'diffHighlightAdded', 'diffAdded');
+    const diffHighlightRemoved = pick(t, 'diffHighlightRemoved', 'diffRemoved');
+    const cliTheme = {
+        // Primary group
+        claude: primary,
+        claudeBlue_FOR_SYSTEM_SPINNER: primary,
+        suggestion: primary,
+        remember: primary,
+        briefLabelYou: primary,
+        briefLabelClaude: primary,
+        clawd_body: primary,
+        rate_limit_fill: primary,
+        blue_FOR_SUBAGENTS_ONLY: primary,
+        // Secondary group
+        permission: secondary,
+        ide: secondary,
+        // Accent group
+        autoAccept: accent,
+        merged: accent,
+        bashBorder: accent,
+        // Text
+        text: text,
+        inactive: textMuted,
+        subtle: textMuted,
+        // Backgrounds
+        background: background,
+        clawd_background: background,
+        userMessageBackground: backgroundPanel,
+        messageActionsBackground: backgroundElement,
+        bashMessageBackgroundColor: backgroundElement,
+        memoryBackgroundColor: backgroundElement,
+        // Borders
+        promptBorder: border,
+        rate_limit_empty: border,
+        promptBorderShimmer: borderActive,
+        // Inverse
+        inverseText: selectedListItemText,
+        // Status
+        error: error,
+        red_FOR_SUBAGENTS_ONLY: error,
+        warning: warning,
+        fastMode: warning,
+        chromeYellow: warning,
+        yellow_FOR_SUBAGENTS_ONLY: warning,
+        success: success,
+        green_FOR_SUBAGENTS_ONLY: success,
+        planMode: info,
+        cyan_FOR_SUBAGENTS_ONLY: info,
+        // Diffs
+        diffAdded: diffAdded,
+        diffRemoved: diffRemoved,
+        diffAddedDimmed: diffAddedBg,
+        diffRemovedDimmed: diffRemovedBg,
+        diffAddedWord: diffHighlightAdded,
+        diffRemovedWord: diffHighlightRemoved,
+        // Shimmers (copy base; resolver/consumer can lighten later if desired)
+        claudeShimmer: primary,
+        claudeBlueShimmer_FOR_SYSTEM_SPINNER: primary,
+        permissionShimmer: secondary,
+        inactiveShimmer: textMuted,
+        warningShimmer: warning,
+        fastModeShimmer: warning,
+        // Constants (no opencode equivalent)
+        professionalBlue: 'rgb(106,155,204)',
+        userMessageBackgroundHover: backgroundPanel,
+        selectionBg: primary,
+        purple_FOR_SUBAGENTS_ONLY: 'rgb(147,51,234)',
+        orange_FOR_SUBAGENTS_ONLY: 'rgb(234,88,12)',
+        pink_FOR_SUBAGENTS_ONLY: 'rgb(219,39,119)',
+        rainbow_red: 'rgb(235,95,87)',
+        rainbow_orange: 'rgb(245,139,87)',
+        rainbow_yellow: 'rgb(250,195,95)',
+        rainbow_green: 'rgb(145,200,130)',
+        rainbow_blue: 'rgb(130,170,220)',
+        rainbow_indigo: 'rgb(155,130,200)',
+        rainbow_violet: 'rgb(200,130,180)',
+        rainbow_red_shimmer: 'rgb(250,155,147)',
+        rainbow_orange_shimmer: 'rgb(255,185,137)',
+        rainbow_yellow_shimmer: 'rgb(255,225,155)',
+        rainbow_green_shimmer: 'rgb(185,230,180)',
+        rainbow_blue_shimmer: 'rgb(180,205,240)',
+        rainbow_indigo_shimmer: 'rgb(195,180,230)',
+        rainbow_violet_shimmer: 'rgb(230,180,210)',
+    };
+    return {
+        $schema: opencode.$schema,
+        name: opencode.name,
+        defs: opencode.defs,
+        theme: cliTheme,
+    };
+}

package/dist/src/utils/themes/resolver.js

@@ -0,0 +1,66 @@
+const FALLBACK = 'rgb(128,128,128)';
+export function hexToRgb(hex) {
+    let h = hex.trim();
+    if (h.startsWith('#'))
+        h = h.slice(1);
+    if (h.length === 3) {
+        h = h
+            .split('')
+            .map(c => c + c)
+            .join('');
+    }
+    if (h.length !== 6)
+        return FALLBACK;
+    const r = parseInt(h.slice(0, 2), 16);
+    const g = parseInt(h.slice(2, 4), 16);
+    const b = parseInt(h.slice(4, 6), 16);
+    if ([r, g, b].some(n => Number.isNaN(n)))
+        return FALLBACK;
+    return `rgb(${r},${g},${b})`;
+}
+function isVariant(v) {
+    return typeof v === 'object' && v !== null && 'dark' in v && 'light' in v;
+}
+export function resolveColor(value, defs, mode, seen = new Set()) {
+    if (isVariant(value)) {
+        return resolveColor(value[mode], defs, mode, seen);
+    }
+    const v = value.trim();
+    if (!v)
+        return FALLBACK;
+    if (v.startsWith('#'))
+        return hexToRgb(v);
+    if (v.startsWith('rgb(') || v.startsWith('rgba('))
+        return v;
+    if (v.startsWith('ansi:'))
+        return v;
+    // Treat as a name reference into defs
+    if (defs && Object.prototype.hasOwnProperty.call(defs, v)) {
+        if (seen.has(v))
+            return FALLBACK;
+        const next = new Set(seen);
+        next.add(v);
+        return resolveColor(defs[v], defs, mode, next);
+    }
+    return FALLBACK;
+}
+export function lighten(color, amount) {
+    if (color.startsWith('ansi:'))
+        return color;
+    const m = /^rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/.exec(color);
+    if (!m)
+        return color;
+    const a = Math.max(0, Math.min(1, amount));
+    const r = Math.round(parseInt(m[1], 10) + (255 - parseInt(m[1], 10)) * a);
+    const g = Math.round(parseInt(m[2], 10) + (255 - parseInt(m[2], 10)) * a);
+    const b = Math.round(parseInt(m[3], 10) + (255 - parseInt(m[3], 10)) * a);
+    return `rgb(${r},${g},${b})`;
+}
+export function resolveTheme(json, mode) {
+    const defs = json.defs ?? {};
+    const out = {};
+    for (const [key, val] of Object.entries(json.theme)) {
+        out[key] = resolveColor(val, defs, mode);
+    }
+    return out;
+}

package/dist/src/utils/themes/types.js

@@ -0,0 +1 @@
+export {};

package/docs/MCP_SERVERS.md

@@ -46,6 +46,32 @@ Pasos a tener en cuenta:
 - Las herramientas MCP aparecen en los agentes con prefijo `mcp__<name>__<tool>`. Puedes restringir cuales se autorizan con `--allowedTools` al iniciar la sesion.
 - Si un equipo (`database`, por ejemplo) tendria que usar este MCP, asignale un agente con `/team equipo <team> database <provider>/<agent>` y el orquestador local lo invocara cuando el plan lo requiera.
 
+### Semble integrado
+
+Este proyecto instala y precalienta `semble` automaticamente la primera vez que arranca, y luego lo registra como MCP dinamico.
+
+Si `uv` no existe en el sistema, el CLI intenta instalarlo automaticamente en una carpeta administrada por la aplicacion y usa ese binario desde ahi.
+
+Herramientas expuestas:
+
+- `mcp__semble__search`
+- `mcp__semble__find_related`
+
+Bootstrap inicial:
+
+```sh
+uv tool install "semble[mcp]"
+uv tool run --from "semble[mcp]" semble search "bootstrap" <repo> --top-k 1
+```
+
+Comando MCP usado por el runtime:
+
+```sh
+uv tool run --from "semble[mcp]" semble
+```
+
+El primer bootstrap instala el paquete y fuerza la descarga local del modelo de embeddings que `semble` usa via Model2Vec.
+
 ### Diferencia con el storage interno
 
-El archivo `~/.context/provider-state.sqlite3` es persistencia interna del CLI (perfiles, runs, credenciales). **No es un MCP** y los agentes no lo consultan directamente; solo el runtime lo lee/escribe. Si quieres exponer datos de una base **a los agentes**, registra un servidor MCP como en los ejemplos de arriba.
+El archivo `~/.context/provider-state.sqlite3` es persistencia interna del CLI (perfiles, runs, credenciales). **No es un MCP** y los agentes no lo consultan directamente; solo el runtime lo lee/escribe. Si quieres exponer datos de una base **a los agentes**, registra un servidor MCP como en los ejemplos de arriba.