npm - crewcode-plugin-cli - Versions diffs - 0.1.0 - Mend

crewcode-plugin-cli 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (75) hide show

package/templates/plugins/repo-radar/panel.html ADDED Viewed

@@ -0,0 +1,56 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Repo Radar</title>
+  <style>
+    :root { color-scheme: dark; --bg:#0f120f; --panel:#121712; --border:#1c2f2f; --text:#e5e7eb; --muted:#8b9a91; --accent:#285a48; --danger:#fca5a5; --mono:'JetBrains Mono', ui-monospace, monospace; --sans:Inter, ui-sans-serif, system-ui, sans-serif; }
+    * { box-sizing: border-box; }
+    body { margin:0; background:var(--bg); color:var(--text); font-family:var(--sans); font-size:13px; }
+    header { padding:16px; border-bottom:1px solid var(--border); display:flex; justify-content:space-between; gap:12px; align-items:flex-start; }
+    h1 { margin:0; font-size:15px; font-weight:650; letter-spacing:-0.02em; }
+    p { margin:4px 0 0; color:var(--muted); line-height:1.45; }
+    button { background:var(--accent); color:#e6f0eb; border:1px solid #356b57; padding:7px 10px; border-radius:0; font-family:var(--mono); font-size:11px; cursor:pointer; }
+    button.secondary { background:transparent; border-color:var(--border); color:var(--muted); }
+    main { padding:14px; display:grid; gap:12px; }
+    .grid { display:grid; grid-template-columns:repeat(3,minmax(0,1fr)); gap:8px; }
+    .stat, .section { border:1px solid var(--border); background:var(--panel); padding:10px; }
+    .stat .n { font-family:var(--mono); font-size:20px; color:#dff3e9; }
+    .stat .l, .eyebrow { font-family:var(--mono); font-size:10px; color:var(--muted); text-transform:lowercase; }
+    .section h2 { margin:0 0 8px; font-size:12px; font-family:var(--mono); font-weight:500; color:#c8d8d0; }
+    ul { margin:0; padding:0; list-style:none; display:grid; gap:6px; }
+    li { border-top:1px solid var(--border); padding-top:6px; color:#cdd7d1; }
+    code { font-family:var(--mono); color:#dff3e9; font-size:11px; }
+    .line { color:var(--muted); font-family:var(--mono); font-size:11px; }
+    .danger { color:var(--danger); }
+    .empty { color:var(--muted); font-family:var(--mono); }
+    @media (max-width: 640px) { .grid { grid-template-columns:1fr; } header { display:grid; } }
+  </style>
+</head>
+<body>
+  <header>
+    <div>
+      <div class="eyebrow">dogfood plugin</div>
+      <h1>repo radar</h1>
+      <p id="workspace">waiting for CrewCode context…</p>
+    </div>
+    <div style="display:flex; gap:8px; flex-wrap:wrap; justify-content:flex-end">
+      <button id="scan">scan workspace</button>
+      <button id="clear" class="secondary">clear</button>
+    </div>
+  </header>
+  <main>
+    <div class="grid">
+      <div class="stat"><div class="n" id="filesCount">—</div><div class="l">files scanned</div></div>
+      <div class="stat"><div class="n" id="todoCount">—</div><div class="l">todos found</div></div>
+      <div class="stat"><div class="n" id="riskCount">—</div><div class="l">risk signals</div></div>
+    </div>
+    <section class="section"><h2>todo / fixme / hack</h2><ul id="todos"><li class="empty">run a scan to inspect source comments</li></ul></section>
+    <section class="section"><h2>risk signals</h2><ul id="risks"><li class="empty">looks for env files, lockfiles, generated dirs, large source files</li></ul></section>
+    <section class="section"><h2>source mix</h2><ul id="mix"><li class="empty">file extension summary appears here</li></ul></section>
+  </main>
+  <script src="crewcode-plugin-api.js"></script>
+  <script src="plugin.js"></script>
+</body>
+</html>

package/templates/plugins/repo-radar/plugin.js ADDED Viewed

@@ -0,0 +1,103 @@
+const els = {
+  workspace: document.getElementById('workspace'),
+  filesCount: document.getElementById('filesCount'),
+  todoCount: document.getElementById('todoCount'),
+  riskCount: document.getElementById('riskCount'),
+  todos: document.getElementById('todos'),
+  risks: document.getElementById('risks'),
+  mix: document.getElementById('mix'),
+  scan: document.getElementById('scan'),
+  clear: document.getElementById('clear'),
+}
+const TEXT_EXT = /\.(ts|tsx|js|jsx|mjs|cjs|json|md|css|html|py|go|rs|java|kt|swift|rb|php|yml|yaml|toml)$/i
+const SKIP = /(^|\/)(node_modules|\.git|dist|out|build|\.next|coverage)(\/|$)/
+const TODO_RE = /\b(todo|fixme|hack|xxx)\b/i
+function setList(el, items, render, empty) {
+  el.innerHTML = ''
+  if (!items.length) {
+    const li = document.createElement('li')
+    li.className = 'empty'
+    li.textContent = empty
+    el.appendChild(li)
+    return
+  }
+  for (const item of items) {
+    const li = document.createElement('li')
+    li.innerHTML = render(item)
+    el.appendChild(li)
+  }
+}
+function extOf(file) {
+  const match = file.match(/\.([^.\/]+)$/)
+  return match ? match[1].toLowerCase() : 'none'
+}
+function riskSignals(files) {
+  const out = []
+  for (const file of files) {
+    if (/(^|\/)\.env(\.|$)/.test(file)) out.push({ file, reason: 'environment file' })
+    if (/package-lock\.json$|pnpm-lock\.yaml$|yarn\.lock$/.test(file)) out.push({ file, reason: 'lockfile changed often' })
+    if (/(^|\/)(generated|vendor)\//.test(file)) out.push({ file, reason: 'generated/vendor path' })
+    if (/\.(pem|key|p12|pfx)$/i.test(file)) out.push({ file, reason: 'secret-like file extension' })
+  }
+  return out.slice(0, 12)
+}
+async function scan() {
+  els.scan.disabled = true
+  els.scan.textContent = 'scanning…'
+  try {
+    const { files } = await window.crewcode.workspace.listFiles()
+    const sourceFiles = files.filter(file => TEXT_EXT.test(file) && !SKIP.test(file)).slice(0, 120)
+    const todos = []
+    const extensions = new Map()
+    for (const file of files) extensions.set(extOf(file), (extensions.get(extOf(file)) || 0) + 1)
+    for (const file of sourceFiles) {
+      try {
+        const { text } = await window.crewcode.workspace.readFile(file)
+        const lines = text.split(/\r?\n/)
+        lines.forEach((line, index) => {
+          if (TODO_RE.test(line) && todos.length < 20) todos.push({ file, line: index + 1, text: line.trim().slice(0, 180) })
+        })
+      } catch {
+        // Some files can be too large or disappear during a scan; keep radar resilient.
+      }
+    }
+    const risks = riskSignals(files)
+    const mix = [...extensions.entries()].sort((a, b) => b[1] - a[1]).slice(0, 12).map(([ext, count]) => ({ ext, count }))
+    els.filesCount.textContent = String(files.length)
+    els.todoCount.textContent = String(todos.length)
+    els.riskCount.textContent = String(risks.length)
+    setList(els.todos, todos, item => `<code>${item.file}:${item.line}</code><div class="line">${escapeHtml(item.text)}</div>`, 'no todo-style comments found')
+    setList(els.risks, risks, item => `<code class="danger">${item.reason}</code><div class="line">${escapeHtml(item.file)}</div>`, 'no obvious risk signals found')
+    setList(els.mix, mix, item => `<code>.${escapeHtml(item.ext)}</code><div class="line">${item.count} file${item.count === 1 ? '' : 's'}</div>`, 'no files found')
+  } finally {
+    els.scan.disabled = false
+    els.scan.textContent = 'scan workspace'
+  }
+}
+function escapeHtml(value) {
+  return String(value).replace(/[&<>"]/g, char => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[char]))
+}
+window.crewcode.onContext(ctx => {
+  els.workspace.textContent = ctx.workspace ? `${ctx.workspace.name} · ${ctx.workspace.kind}` : 'no active workspace'
+})
+els.scan.addEventListener('click', scan)
+els.clear.addEventListener('click', () => {
+  els.filesCount.textContent = '—'
+  els.todoCount.textContent = '—'
+  els.riskCount.textContent = '—'
+  setList(els.todos, [], () => '', 'run a scan to inspect source comments')
+  setList(els.risks, [], () => '', 'looks for env files, lockfiles, generated dirs, large source files')
+  setList(els.mix, [], () => '', 'file extension summary appears here')
+})

package/templates/plugins/static-panel-template/README.md ADDED Viewed

@@ -0,0 +1,19 @@
+# Static panel plugin template
+A minimal CrewCode plugin built from plain HTML, CSS, and JavaScript.
+## What it demonstrates
+- `crewcode.apiVersion: "0.1"` manifest compatibility.
+- Sandboxed tab and sidebar panel entries.
+- A command and status item that target the same panel.
+- Read-only workspace capability calls through `crewcode-plugin-api.js`.
+## Install locally
+```bash
+mkdir -p ~/.crewcode/plugins/static-panel-template
+cp -R . ~/.crewcode/plugins/static-panel-template
+```
+Then refresh the Plugins page, approve the plugin, and open `Static Panel`.

package/templates/plugins/static-panel-template/crewcode-plugin-api.js ADDED Viewed

@@ -0,0 +1,80 @@
+// Official CrewCode plugin browser helper. GENERATED from src/ — do not edit by hand.
+// Runs inside sandboxed plugin iframes. It never exposes Electron APIs.
+"use strict";
+(() => {
+  // src/create-api.ts
+  var CREWCODE_PLUGIN_API_VERSION = "0.1";
+  var RESERVED_NETWORK_MESSAGE = "crewcode.network.fetch is reserved in plugin API v0. Use an agentProvider runtime (http/sse-http/openai-compatible/websocket) for network access.";
+  var RESERVED_SECRETS_MESSAGE = "crewcode.secrets.get is reserved in plugin API v0. Use a provider apiKeyEnv or local CLI auth instead.";
+  function createCrewCodeApi(options = {}) {
+    var _a, _b;
+    const timeoutMs = (_a = options.timeoutMs) != null ? _a : 1e4;
+    const targetOrigin = (_b = options.targetOrigin) != null ? _b : "*";
+    const pending = /* @__PURE__ */ new Map();
+    const contextListeners = /* @__PURE__ */ new Set();
+    let seq = 0;
+    let latestContext = null;
+    const reportError = (err) => {
+      const error = err instanceof Error ? err : new Error(String(err));
+      window.parent.postMessage({ type: "crewcode:runtimeError", message: error.message, stack: error.stack }, targetOrigin);
+    };
+    window.addEventListener("error", (event) => {
+      var _a2;
+      return reportError((_a2 = event.error) != null ? _a2 : event.message);
+    });
+    window.addEventListener("unhandledrejection", (event) => reportError(event.reason));
+    const request = (method, params) => {
+      const id = `req-${++seq}`;
+      window.parent.postMessage({ type: "crewcode:request", id, method, params }, targetOrigin);
+      return new Promise((resolve, reject) => {
+        pending.set(id, { resolve, reject });
+        window.setTimeout(() => {
+          if (!pending.has(id)) return;
+          pending.delete(id);
+          reject(new Error("CrewCode plugin request timed out"));
+        }, timeoutMs);
+      });
+    };
+    window.addEventListener("message", (event) => {
+      if (event.source !== window.parent) return;
+      const msg = event.data;
+      if (!msg || typeof msg !== "object") return;
+      if (msg.type === "crewcode:context") {
+        latestContext = msg;
+        for (const listener of contextListeners) listener(latestContext);
+        return;
+      }
+      if (msg.type === "crewcode:response" && typeof msg.id === "string" && pending.has(msg.id)) {
+        const callbacks = pending.get(msg.id);
+        pending.delete(msg.id);
+        if (msg.ok) callbacks.resolve(msg.result);
+        else callbacks.reject(new Error(typeof msg.error === "string" ? msg.error : "plugin request failed"));
+      }
+    });
+    return {
+      apiVersion: CREWCODE_PLUGIN_API_VERSION,
+      request,
+      onContext(listener) {
+        contextListeners.add(listener);
+        if (latestContext) listener(latestContext);
+        return () => contextListeners.delete(listener);
+      },
+      getContext: () => latestContext,
+      workspace: {
+        listFiles: () => request("workspace:listFiles"),
+        readFile: (sub) => request("workspace:readFile", { sub }),
+        writeFile: (sub, text) => request("workspace:writeFile", { sub, text })
+      },
+      network: {
+        fetch: () => Promise.reject(new Error(RESERVED_NETWORK_MESSAGE))
+      },
+      secrets: {
+        get: () => Promise.reject(new Error(RESERVED_SECRETS_MESSAGE))
+      }
+    };
+  }
+  // src/browser-global.ts
+  window.createCrewCodeApi = createCrewCodeApi;
+  window.crewcode = createCrewCodeApi();
+})();

package/templates/plugins/static-panel-template/crewcode.plugin.json ADDED Viewed

@@ -0,0 +1,44 @@
+{
+  "$schema": "../../../schemas/crewcode.plugin.schema.json",
+  "id": "static-panel-template",
+  "name": "Static Panel Template",
+  "version": "0.1.0",
+  "description": "Starter template for a sandboxed static HTML/CSS/JS plugin panel.",
+  "crewcode": { "apiVersion": "0.1" },
+  "permissions": ["workspace:read"],
+  "contributes": {
+    "tabs": [
+      {
+        "id": "main",
+        "title": "Static Panel",
+        "icon": "grid",
+        "entry": "panel.html",
+        "singleton": true
+      }
+    ],
+    "sidebarPanels": [
+      {
+        "id": "sidebar",
+        "title": "Static Panel",
+        "icon": "sidebar",
+        "entry": "panel.html"
+      }
+    ],
+    "commands": [
+      {
+        "id": "refresh",
+        "title": "Static Panel: Refresh Workspace Snapshot",
+        "icon": "refresh"
+      }
+    ],
+    "statusItems": [
+      {
+        "id": "status",
+        "title": "Static Panel Template",
+        "text": "plugin ready",
+        "icon": "plug",
+        "sidebarPanel": "sidebar"
+      }
+    ]
+  }
+}

package/templates/plugins/static-panel-template/panel.html ADDED Viewed

@@ -0,0 +1,36 @@
+<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>Static Panel Template</title>
+  <style>
+    :root { color-scheme: dark; }
+    body { margin: 0; background: #0f120f; color: #e6f0eb; font: 13px Inter, system-ui, sans-serif; }
+    main { padding: 16px; max-width: 760px; }
+    h1 { margin: 6px 0 8px; font-size: 22px; letter-spacing: -0.02em; }
+    p { color: #8b9a91; line-height: 1.5; }
+    button { background: #285a48; color: #e6f0eb; border: 1px solid #356b57; padding: 8px 10px; font: 11px 'JetBrains Mono', monospace; text-transform: lowercase; }
+    pre, code, .mono { font-family: 'JetBrains Mono', monospace; color: #9fbfaf; }
+    .eyebrow { color: #8b9a91; font-size: 11px; text-transform: lowercase; }
+    .panel { border: 1px solid #1c2f2f; background: #121712; padding: 12px; margin-top: 12px; }
+    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 8px; }
+    .metric strong { display: block; font-size: 24px; color: #e6f0eb; }
+  </style>
+</head>
+<body>
+  <main>
+    <div class="eyebrow mono">crewcode plugin template / static panel</div>
+    <h1>workspace snapshot</h1>
+    <p>This template uses static HTML, CSS, and JavaScript. It runs in a sandboxed iframe and talks to CrewCode only through <code>crewcode-plugin-api.js</code>.</p>
+    <button id="refresh">refresh files</button>
+    <section class="panel grid">
+      <div class="metric"><span class="mono">files</span><strong id="file-count">—</strong></div>
+      <div class="metric"><span class="mono">source files</span><strong id="source-count">—</strong></div>
+      <div class="metric"><span class="mono">docs</span><strong id="doc-count">—</strong></div>
+    </section>
+    <pre id="output" class="panel">waiting for context…</pre>
+  </main>
+  <script src="crewcode-plugin-api.js"></script>
+  <script src="plugin.js"></script>
+</body>
+</html>

package/templates/plugins/static-panel-template/plugin.js ADDED Viewed

@@ -0,0 +1,30 @@
+const out = document.getElementById('output')
+const fileCount = document.getElementById('file-count')
+const sourceCount = document.getElementById('source-count')
+const docCount = document.getElementById('doc-count')
+const refresh = document.getElementById('refresh')
+function renderContext(ctx) {
+  out.textContent = JSON.stringify({
+    source: ctx.openContext?.source,
+    workspace: ctx.workspace?.name,
+    root: ctx.workspace?.root,
+  }, null, 2)
+}
+async function loadSnapshot() {
+  try {
+    const result = await window.crewcode.workspace.listFiles()
+    const files = result.files || []
+    fileCount.textContent = String(files.length)
+    sourceCount.textContent = String(files.filter(file => /\.(ts|tsx|js|jsx|css|html)$/.test(file)).length)
+    docCount.textContent = String(files.filter(file => /\.(md|mdx|txt)$/.test(file)).length)
+    out.textContent = files.slice(0, 80).join('\n') || 'no files found'
+  } catch (err) {
+    out.textContent = `plugin request failed: ${err.message}`
+  }
+}
+window.crewcode.onContext(renderContext)
+refresh.addEventListener('click', loadSnapshot)
+void loadSnapshot()

package/templates/plugins/terminal-watchdog-lite/crewcode-plugin-api.js ADDED Viewed

@@ -0,0 +1,80 @@
+// Official CrewCode plugin browser helper. GENERATED from src/ — do not edit by hand.
+// Runs inside sandboxed plugin iframes. It never exposes Electron APIs.
+"use strict";
+(() => {
+  // src/create-api.ts
+  var CREWCODE_PLUGIN_API_VERSION = "0.1";
+  var RESERVED_NETWORK_MESSAGE = "crewcode.network.fetch is reserved in plugin API v0. Use an agentProvider runtime (http/sse-http/openai-compatible/websocket) for network access.";
+  var RESERVED_SECRETS_MESSAGE = "crewcode.secrets.get is reserved in plugin API v0. Use a provider apiKeyEnv or local CLI auth instead.";
+  function createCrewCodeApi(options = {}) {
+    var _a, _b;
+    const timeoutMs = (_a = options.timeoutMs) != null ? _a : 1e4;
+    const targetOrigin = (_b = options.targetOrigin) != null ? _b : "*";
+    const pending = /* @__PURE__ */ new Map();
+    const contextListeners = /* @__PURE__ */ new Set();
+    let seq = 0;
+    let latestContext = null;
+    const reportError = (err) => {
+      const error = err instanceof Error ? err : new Error(String(err));
+      window.parent.postMessage({ type: "crewcode:runtimeError", message: error.message, stack: error.stack }, targetOrigin);
+    };
+    window.addEventListener("error", (event) => {
+      var _a2;
+      return reportError((_a2 = event.error) != null ? _a2 : event.message);
+    });
+    window.addEventListener("unhandledrejection", (event) => reportError(event.reason));
+    const request = (method, params) => {
+      const id = `req-${++seq}`;
+      window.parent.postMessage({ type: "crewcode:request", id, method, params }, targetOrigin);
+      return new Promise((resolve, reject) => {
+        pending.set(id, { resolve, reject });
+        window.setTimeout(() => {
+          if (!pending.has(id)) return;
+          pending.delete(id);
+          reject(new Error("CrewCode plugin request timed out"));
+        }, timeoutMs);
+      });
+    };
+    window.addEventListener("message", (event) => {
+      if (event.source !== window.parent) return;
+      const msg = event.data;
+      if (!msg || typeof msg !== "object") return;
+      if (msg.type === "crewcode:context") {
+        latestContext = msg;
+        for (const listener of contextListeners) listener(latestContext);
+        return;
+      }
+      if (msg.type === "crewcode:response" && typeof msg.id === "string" && pending.has(msg.id)) {
+        const callbacks = pending.get(msg.id);
+        pending.delete(msg.id);
+        if (msg.ok) callbacks.resolve(msg.result);
+        else callbacks.reject(new Error(typeof msg.error === "string" ? msg.error : "plugin request failed"));
+      }
+    });
+    return {
+      apiVersion: CREWCODE_PLUGIN_API_VERSION,
+      request,
+      onContext(listener) {
+        contextListeners.add(listener);
+        if (latestContext) listener(latestContext);
+        return () => contextListeners.delete(listener);
+      },
+      getContext: () => latestContext,
+      workspace: {
+        listFiles: () => request("workspace:listFiles"),
+        readFile: (sub) => request("workspace:readFile", { sub }),
+        writeFile: (sub, text) => request("workspace:writeFile", { sub, text })
+      },
+      network: {
+        fetch: () => Promise.reject(new Error(RESERVED_NETWORK_MESSAGE))
+      },
+      secrets: {
+        get: () => Promise.reject(new Error(RESERVED_SECRETS_MESSAGE))
+      }
+    };
+  }
+  // src/browser-global.ts
+  window.createCrewCodeApi = createCrewCodeApi;
+  window.crewcode = createCrewCodeApi();
+})();

package/templates/plugins/terminal-watchdog-lite/crewcode.plugin.json ADDED Viewed

@@ -0,0 +1,13 @@
+{
+  "$schema": "../../../schemas/crewcode.plugin.schema.json",
+  "id": "terminal-watchdog-lite",
+  "name": "Terminal Watchdog Lite",
+  "version": "0.1.0",
+  "description": "Dogfoods opt-in terminal watcher contribution without automatic terminal output access.",
+  "crewcode": { "apiVersion": "0.1" },
+  "permissions": ["terminal:read"],
+  "contributes": {
+    "sidebarPanels": [{ "id": "watchdog", "title": "Watchdog", "icon": "terminal", "entry": "panel.html" }],
+    "terminalWatchers": [{ "id": "watch-pane", "title": "Open Watchdog Lite", "icon": "terminal", "sidebarPanel": "watchdog", "mode": "opt-in" }]
+  }
+}

package/templates/plugins/terminal-watchdog-lite/panel.html ADDED Viewed

@@ -0,0 +1 @@

+ <!doctype html><html><head><meta charset="utf-8"><title>Terminal Watchdog Lite</title><style>body{margin:0;background:#0f120f;color:#e5e7eb;font:13px Inter,system-ui;padding:16px}.mono,code{font-family:'JetBrains Mono',monospace;color:#8b9a91}.card{border:1px solid #1c2f2f;background:#121712;padding:12px;margin-top:12px}</style></head><body><div class="mono">dogfood plugin</div><h1>terminal watchdog lite</h1><p id="ctx">waiting for context…</p><div class="card">Opened from a terminal pane context menu. This validates explicit opt-in UX before terminal output is ever forwarded to plugins.</div><div class="card"><code>terminal:read</code> is approved, but v0 does not stream output yet.</div><script src="crewcode-plugin-api.js"></script><script src="plugin.js"></script></body></html>

package/templates/plugins/terminal-watchdog-lite/plugin.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ window.crewcode.onContext(ctx=>{document.getElementById('ctx').textContent=ctx.workspace?`${ctx.workspace.name} · ${ctx.workspace.kind}`:'no workspace'})

package/templates/plugins/typescript-panel-template/README.md ADDED Viewed

@@ -0,0 +1,40 @@
+# TypeScript panel plugin template
+This template shows how CrewCode plugins can be authored in TypeScript/React while still loading as isolated static panel assets.
+## Build
+```bash
+npm install
+npm run build
+```
+The manifest points at `compiled/src/panel.html`. This checked-in compiled output lets the template run immediately after copying; rebuild it after editing `src/`.
+```json
+{
+  "contributes": {
+    "tabs": [{ "entry": "compiled/src/panel.html" }]
+  }
+}
+```
+## Install locally
+Copy this folder into `~/.crewcode/plugins/typescript-panel-template`. It will run immediately from the checked-in `compiled/` assets. Build inside the copied folder after editing `src/`:
+```bash
+mkdir -p ~/.crewcode/plugins/typescript-panel-template
+cp -R . ~/.crewcode/plugins/typescript-panel-template
+cd ~/.crewcode/plugins/typescript-panel-template
+npm install
+npm run build
+```
+Restart CrewCode and open `TypeScript Plugin` from the command palette.
+## API
+`src/crewcode-api.ts` is vendored from the official `packages/crewcode-plugin-api` source contract so copied templates work before the package is published. When consuming the package directly, import `crewcode` from `crewcode-plugin-api`.
+Plugins are declared in the manifest, become globally active after enablement + approval, and can be disabled per workspace from CrewCode's Plugins page.