devglow-mcp 1.0.3 → 1.0.5

package/build/deeplink.js

@@ -24,12 +24,14 @@ export async function startProject(id) {
 export async function stopProject(id) {
     await openDeepLink(buildUrl("stop", { id }));
 }
-export async function runProcess(name, path, command, port, source) {
+export async function runProcess(name, path, command, port, source, description) {
     const params = { name, path, command };
     if (port !== undefined)
         params.port = String(port);
     if (source)
         params.source = source;
+    if (description)
+        params.description = description;
     await openDeepLink(buildUrl("run", params));
 }
 export async function stopProcess(name) {
@@ -38,3 +40,9 @@ export async function stopProcess(name) {
 export async function exportLogs(id) {
     await openDeepLink(buildUrl("export-logs", { id }));
 }
+export async function updateProject(id, description) {
+    const params = { id };
+    if (description !== undefined)
+        params.description = description;
+    await openDeepLink(buildUrl("update-project", params));
+}

package/build/index.js

@@ -11,7 +11,7 @@ import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 import { z } from "zod";
 import { loadProjects, loadAiProcesses, loadStatuses, loadExportedLogs, } from "./storage.js";
-import { startProject, stopProject, runProcess, stopProcess, exportLogs, } from "./deeplink.js";
+import { startProject, stopProject, runProcess, stopProcess, exportLogs, updateProject, } from "./deeplink.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
 // --- Orphan process prevention constants ---
@@ -205,14 +205,40 @@ function createMcpServer() {
                 .number()
                 .optional()
                 .describe("Port number the process will listen on. Check package.json scripts or config files for --port flags. Important for DevGlow to show the correct port badge."),
+            description: z
+                .string()
+                .max(280)
+                .optional()
+                .describe("Short summary of what the app does (max 280 chars). Helps the user remember the project later. Write 1-2 plain sentences from the user's perspective."),
         },
-    }, async ({ name, path, command, port }) => {
+    }, async ({ name, path, command, port, description }) => {
         // Auto-detect port from command if not explicitly provided
         const resolvedPort = port ?? detectPortFromCommand(command);
-        await runProcess(name, path, command, resolvedPort, "claude");
+        await runProcess(name, path, command, resolvedPort, "claude", description);
         // Brief wait for DevGlow to register the process
         await new Promise((resolve) => setTimeout(resolve, 300));
-        const text = `AI process "${name}" started.\nCommand: ${command}\nPath: ${path}${resolvedPort ? `\nPort: ${resolvedPort}` : ""}`;
+        const text = `AI process "${name}" started.\nCommand: ${command}\nPath: ${path}${resolvedPort ? `\nPort: ${resolvedPort}` : ""}${description ? `\nDescription: ${description}` : ""}`;
+        return { content: [{ type: "text", text }] };
+    });
+    // ── Tool: update_project ──
+    server.registerTool("update_project", {
+        title: "Update a project's metadata",
+        description: "Update a kept (permanent) DevGlow project's metadata (currently only description). Does NOT apply to temporary AI processes — for those, set the description at run_process time, or have the user keep the process first.",
+        inputSchema: {
+            id: z
+                .string()
+                .describe("Project id (call list_projects first). Must be a permanent project, not an AI process (those have ids starting with 'ai-')."),
+            description: z
+                .string()
+                .max(280)
+                .describe("Short summary of what the app does (max 280 chars). Pass an empty string to clear the existing description."),
+        },
+    }, async ({ id, description }) => {
+        await updateProject(id, description);
+        await new Promise((resolve) => setTimeout(resolve, 200));
+        const text = description
+            ? `Project ${id} description updated.`
+            : `Project ${id} description cleared.`;
         return { content: [{ type: "text", text }] };
     });
     // ── Tool: stop_process ──

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devglow-mcp",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "MCP server for DevGlow — manage local dev processes through AI agents",
   "type": "module",
   "bin": {