@gowelle/stint-agent 1.0.2 → 1.0.4

package/README.md

@@ -34,7 +34,7 @@ stint login
 # Check your authentication status
 stint whoami
 
-# Link a project
+# Link a project (or create a new one)
 cd /path/to/your/project
 stint link
 
@@ -47,6 +47,13 @@ stint daemon status
 
 ## Commands
 
+### General
+
+| Command | Description |
+|---------|-------------|
+| `stint --version`, `stint -V` | Show current agent version |
+| `stint --help`, `stint -h` | Show help information |
+
 ### Authentication
 
 | Command | Description |
@@ -55,11 +62,13 @@ stint daemon status
 | `stint logout` | Remove stored credentials |
 | `stint whoami` | Show current user and machine information |
 
-### Daemon
+### Daemon Lifecycle
 
 | Command | Description |
 |---------|-------------|
-| `stint daemon start` | Start background daemon |
+| `stint install` | Register daemon to run on system startup (Login required) |
+| `stint uninstall` | Remove daemon from system startup |
+| `stint daemon start` | Start background daemon manually |
 | `stint daemon stop` | Stop daemon gracefully |
 | `stint daemon status` | Check if daemon is running |
 | `stint daemon logs [--lines N]` | View daemon logs (default: 50 lines) |
@@ -69,7 +78,7 @@ stint daemon status
 
 | Command | Description |
 |---------|-------------|
-| `stint link` | Link current directory to a Stint project |
+| `stint link` | Link current directory to a Stint project (or create a new one) |
 | `stint unlink [--force]` | Remove project link |
 | `stint status` | Show project, git, auth, and daemon status |
 | `stint sync` | Manually sync repository information to server |

package/dist/{api-ZMYJOXXU.js → api-HRVUUV3V.js}

@@ -1,6 +1,6 @@
 import {
   apiService
-} from "./chunk-5XNQJJVE.js";
+} from "./chunk-XZCWE3IA.js";
 export {
   apiService
 };

package/dist/{chunk-WFWZCAJ6.js → chunk-UGODXDEE.js}

@@ -2,7 +2,7 @@ import {
   apiService,
   config,
   logger
-} from "./chunk-5XNQJJVE.js";
+} from "./chunk-XZCWE3IA.js";
 
 // src/utils/process.ts
 import fs from "fs";
@@ -121,6 +121,20 @@ var GitServiceImpl = class {
       const branches = branchSummary.all;
       const remotes = await git.getRemotes(true);
       const remoteUrl = remotes.length > 0 ? remotes[0].refs.fetch : null;
+      let defaultBranch = currentBranch;
+      try {
+        const result = await git.raw(["symbolic-ref", "refs/remotes/origin/HEAD"]);
+        const match = result.trim().match(/refs\/remotes\/origin\/(.+)/);
+        if (match) {
+          defaultBranch = match[1];
+        }
+      } catch {
+        if (branches.includes("main")) {
+          defaultBranch = "main";
+        } else if (branches.includes("master")) {
+          defaultBranch = "master";
+        }
+      }
       const status = await this.getStatus(path3);
       const log = await git.log({ maxCount: 1 });
       const lastCommit = log.latest;
@@ -128,7 +142,9 @@ var GitServiceImpl = class {
         throw new Error("No commits found in repository");
       }
       return {
+        repoPath: path3,
         currentBranch,
+        defaultBranch,
         branches,
         remoteUrl,
         status,

package/dist/{chunk-5XNQJJVE.js → chunk-XZCWE3IA.js}

@@ -254,7 +254,7 @@ var AuthServiceImpl = class {
       return null;
     }
     try {
-      const { apiService: apiService2 } = await import("./api-ZMYJOXXU.js");
+      const { apiService: apiService2 } = await import("./api-HRVUUV3V.js");
       const user = await apiService2.getCurrentUser();
       logger.info("auth", `Token validated for user: ${user.email}`);
       return user;
@@ -274,7 +274,7 @@ var AuthServiceImpl = class {
 var authService = new AuthServiceImpl();
 
 // src/services/api.ts
-var AGENT_VERSION = "1.0.2";
+var AGENT_VERSION = "1.0.4";
 var ApiServiceImpl = class {
   sessionId = null;
   async getHeaders() {
@@ -351,7 +351,7 @@ var ApiServiceImpl = class {
       return session;
     }, "Connect");
   }
-  async disconnect() {
+  async disconnect(reason) {
     if (!this.sessionId) {
       return;
     }
@@ -359,7 +359,8 @@ var ApiServiceImpl = class {
     await this.request("/api/agent/disconnect", {
       method: "POST",
       body: JSON.stringify({
-        session_id: this.sessionId
+        session_id: this.sessionId,
+        reason: reason || "Agent disconnected"
       })
     });
     this.sessionId = null;
@@ -431,9 +432,15 @@ var ApiServiceImpl = class {
   async syncProject(projectId, data) {
     logger.info("api", `Syncing project ${projectId}`);
     await this.withRetry(async () => {
+      const payload = {
+        repo_path: data.repoPath,
+        remote_url: data.remoteUrl,
+        default_branch: data.defaultBranch,
+        current_branch: data.currentBranch
+      };
       await this.request(`/api/agent/projects/${projectId}/sync`, {
         method: "POST",
-        body: JSON.stringify(data)
+        body: JSON.stringify(payload)
       });
       logger.success("api", `Project ${projectId} synced`);
     }, "Sync project");

package/dist/daemon/runner.js

@@ -5,13 +5,13 @@ import {
   projectService,
   removePidFile,
   writePidFile
-} from "../chunk-WFWZCAJ6.js";
+} from "../chunk-UGODXDEE.js";
 import {
   apiService,
   authService,
   config,
   logger
-} from "../chunk-5XNQJJVE.js";
+} from "../chunk-XZCWE3IA.js";
 
 // src/daemon/runner.ts
 import "dotenv/config";
@@ -27,8 +27,12 @@ var WebSocketServiceImpl = class {
   isManualDisconnect = false;
   // Event handlers
   commitApprovedHandlers = [];
+  commitPendingHandlers = [];
+  suggestionCreatedHandlers = [];
   projectUpdatedHandlers = [];
   disconnectHandlers = [];
+  agentDisconnectedHandlers = [];
+  syncRequestedHandlers = [];
   async connect() {
     try {
       const token = await authService.getToken();
@@ -108,12 +112,24 @@ var WebSocketServiceImpl = class {
   onCommitApproved(handler) {
     this.commitApprovedHandlers.push(handler);
   }
+  onCommitPending(handler) {
+    this.commitPendingHandlers.push(handler);
+  }
+  onSuggestionCreated(handler) {
+    this.suggestionCreatedHandlers.push(handler);
+  }
   onProjectUpdated(handler) {
     this.projectUpdatedHandlers.push(handler);
   }
   onDisconnect(handler) {
     this.disconnectHandlers.push(handler);
   }
+  onAgentDisconnected(handler) {
+    this.agentDisconnectedHandlers.push(handler);
+  }
+  onSyncRequested(handler) {
+    this.syncRequestedHandlers.push(handler);
+  }
   sendMessage(message) {
     if (!this.isConnected()) {
       logger.warn("websocket", "Cannot send message: not connected");
@@ -139,6 +155,18 @@ var WebSocketServiceImpl = class {
         this.commitApprovedHandlers.forEach((handler) => handler(commit, project));
         return;
       }
+      if (message.event === "commit.pending") {
+        const { pendingCommit } = message.data;
+        logger.info("websocket", `Commit pending: ${pendingCommit.id}`);
+        this.commitPendingHandlers.forEach((handler) => handler(pendingCommit));
+        return;
+      }
+      if (message.event === "suggestion.created") {
+        const { suggestion } = message.data;
+        logger.info("websocket", `Suggestion created: ${suggestion.id}`);
+        this.suggestionCreatedHandlers.forEach((handler) => handler(suggestion));
+        return;
+      }
       if (message.event === "project.updated") {
         const { project } = message.data;
         logger.info("websocket", `Project updated: ${project.id}`);
@@ -148,6 +176,13 @@ var WebSocketServiceImpl = class {
       if (message.event === "sync.requested") {
         const { projectId } = message.data;
         logger.info("websocket", `Sync requested for project: ${projectId}`);
+        this.syncRequestedHandlers.forEach((handler) => handler(projectId));
+        return;
+      }
+      if (message.event === "agent.disconnected") {
+        const reason = message.data?.reason || "Server requested disconnect";
+        logger.warn("websocket", `Agent disconnected by server: ${reason}`);
+        this.agentDisconnectedHandlers.forEach((handler) => handler(reason));
         return;
       }
       logger.debug("websocket", `Unhandled event: ${message.event}`);
@@ -358,6 +393,19 @@ var FileWatcher = class {
   addProject(projectPath, projectId) {
     this.watchProject(projectPath, projectId);
   }
+  /**
+   * Sync a project by ID (called when server requests a sync)
+   */
+  async syncProjectById(projectId) {
+    const linkedProjects = projectService.getAllLinkedProjects();
+    for (const [projectPath, linkedProject] of Object.entries(linkedProjects)) {
+      if (linkedProject.projectId === projectId) {
+        await this.performSync(projectPath, projectId);
+        return;
+      }
+    }
+    logger.warn("watcher", `Cannot sync: project ${projectId} not found in linked projects`);
+  }
   /**
    * Remove a project from watching (called when a project is unlinked)
    */
@@ -377,15 +425,42 @@ var FileWatcher = class {
   }
 };
 
+// src/utils/notify.ts
+import notifier from "node-notifier";
+function notify(options) {
+  try {
+    notifier.notify({
+      title: options.title,
+      message: options.message,
+      open: options.open,
+      sound: true,
+      wait: false,
+      appID: "Stint Agent"
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    }, (error) => {
+      if (error) {
+        logger.error("notify", "Failed to send notification", error);
+      }
+    });
+  } catch (error) {
+    logger.error("notify", "Failed to send notification", error);
+  }
+}
+
 // src/daemon/index.ts
 var heartbeatInterval = null;
 var isShuttingDown = false;
+var shutdownReason;
 var fileWatcher = new FileWatcher();
 async function startDaemon() {
   logger.info("daemon", "Starting daemon...");
   try {
     const user = await authService.validateToken();
     if (!user) {
+      notify({
+        title: "Stint Agent",
+        message: 'Authentication expired. Please run "stint login" to reconnect.'
+      });
       throw new Error('Not authenticated. Please run "stint login" first.');
     }
     logger.info("daemon", `Authenticated as ${user.email}`);
@@ -406,6 +481,30 @@ async function startDaemon() {
     websocketService.onDisconnect(() => {
       logger.warn("daemon", "WebSocket disconnected, will attempt to reconnect");
     });
+    websocketService.onAgentDisconnected(async (reason) => {
+      logger.warn("daemon", `Server disconnected agent: ${reason}`);
+      logger.info("daemon", "Initiating graceful shutdown...");
+      await shutdown(`Server: ${reason}`);
+      process.exit(0);
+    });
+    websocketService.onSuggestionCreated((suggestion) => {
+      logger.info("daemon", `Suggestion created: ${suggestion.title} (${suggestion.priority})`);
+      notify({
+        title: "New Suggestion",
+        message: `${suggestion.title}
+Priority: ${suggestion.priority}`,
+        open: `https://stint.codes/projects/${suggestion.project_id}/suggestions/${suggestion.id}`
+        // Hypothetical URL structure
+      });
+    });
+    websocketService.onSyncRequested(async (projectId) => {
+      logger.info("daemon", `Server requested sync for project: ${projectId}`);
+      try {
+        await fileWatcher.syncProjectById(projectId);
+      } catch (error) {
+        logger.error("daemon", `Failed to sync project ${projectId}`, error);
+      }
+    });
     setupSignalHandlers();
     startHeartbeat();
     fileWatcher.start();
@@ -443,15 +542,16 @@ function setupSignalHandlers() {
   signals.forEach((signal) => {
     process.on(signal, async () => {
       logger.info("daemon", `Received ${signal}, shutting down...`);
-      await shutdown();
+      await shutdown(`Signal: ${signal}`);
       process.exit(0);
     });
   });
   logger.info("daemon", "Signal handlers registered");
 }
-async function shutdown() {
+async function shutdown(reason) {
   if (isShuttingDown) return;
   isShuttingDown = true;
+  shutdownReason = reason;
   logger.info("daemon", "Shutting down daemon...");
   stopHeartbeat();
   try {
@@ -467,7 +567,7 @@ async function shutdown() {
     logger.error("daemon", "Failed to disconnect from WebSocket", error);
   }
   try {
-    await apiService.disconnect();
+    await apiService.disconnect(shutdownReason);
     logger.info("daemon", "Disconnected from API");
   } catch (error) {
     logger.error("daemon", "Failed to disconnect from API", error);

package/dist/index.js

@@ -8,18 +8,18 @@ import {
   projectService,
   spawnDetached,
   validatePidFile
-} from "./chunk-WFWZCAJ6.js";
+} from "./chunk-UGODXDEE.js";
 import {
   apiService,
   authService,
   config,
   logger
-} from "./chunk-5XNQJJVE.js";
+} from "./chunk-XZCWE3IA.js";
 
 // src/index.ts
 import "dotenv/config";
 import { Command } from "commander";
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 
 // src/commands/login.ts
 import open from "open";
@@ -514,7 +514,7 @@ function registerLinkCommand(program2) {
             try {
               repoInfo = await gitService.getRepoInfo(cwd);
             } catch (e) {
-              logger.warn("link", "Failed to get repo info for creation metadata", e);
+              logger.warn("link", `Failed to get repo info for creation metadata: ${e.message}`);
             }
           }
           const newProject = await apiService.createProject({
@@ -1061,19 +1061,225 @@ function getTimeAgo(date) {
   return date.toLocaleDateString();
 }
 
+// src/commands/install.ts
+import ora10 from "ora";
+import chalk10 from "chalk";
+import fs2 from "fs";
+import path4 from "path";
+import os3 from "os";
+import { exec } from "child_process";
+import { promisify } from "util";
+var execAsync = promisify(exec);
+var WINDOWS_TASK_NAME = "StintAgentDaemon";
+var MAC_PLIST_NAME = "codes.stint.agent.plist";
+var SYSTEMD_SERVICE_NAME = "stint-agent.service";
+function getDaemonCommand() {
+  const scriptPath = process.argv[1];
+  return `"${process.execPath}" "${scriptPath}" daemon start`;
+}
+async function installWindows() {
+  const command = getDaemonCommand();
+  const escapedCommand = command.replace(/"/g, '\\"');
+  try {
+    await execAsync(`schtasks /Create /SC ONLOGON /TN "${WINDOWS_TASK_NAME}" /TR "${escapedCommand}" /F`);
+  } catch (error) {
+    if (error.message.includes("Access is denied")) {
+      throw new Error("Access denied. Please run this command as Administrator (Right-click Terminal > Run as administrator).");
+    }
+    throw error;
+  }
+}
+async function uninstallWindows() {
+  await execAsync(`schtasks /Delete /TN "${WINDOWS_TASK_NAME}" /F`);
+}
+function getMacPlistContent() {
+  const scriptPath = process.argv[1];
+  const logPath = path4.join(os3.homedir(), ".config", "stint", "logs", "launchd.log");
+  const errorPath = path4.join(os3.homedir(), ".config", "stint", "logs", "launchd.error.log");
+  const logDir = path4.dirname(logPath);
+  if (!fs2.existsSync(logDir)) {
+    fs2.mkdirSync(logDir, { recursive: true });
+  }
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>codes.stint.agent</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${process.execPath}</string>
+        <string>${scriptPath}</string>
+        <string>daemon</string>
+        <string>start</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>${logPath}</string>
+    <key>StandardErrorPath</key>
+    <string>${errorPath}</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+    </dict>
+</dict>
+</plist>`;
+}
+async function installMac() {
+  const plistContent = getMacPlistContent();
+  const launchAgentsDir = path4.join(os3.homedir(), "Library", "LaunchAgents");
+  const plistPath = path4.join(launchAgentsDir, MAC_PLIST_NAME);
+  if (!fs2.existsSync(launchAgentsDir)) {
+    fs2.mkdirSync(launchAgentsDir, { recursive: true });
+  }
+  fs2.writeFileSync(plistPath, plistContent);
+  try {
+    await execAsync(`launchctl unload "${plistPath}"`);
+  } catch {
+  }
+  await execAsync(`launchctl load "${plistPath}"`);
+}
+async function uninstallMac() {
+  const launchAgentsDir = path4.join(os3.homedir(), "Library", "LaunchAgents");
+  const plistPath = path4.join(launchAgentsDir, MAC_PLIST_NAME);
+  if (fs2.existsSync(plistPath)) {
+    try {
+      await execAsync(`launchctl unload "${plistPath}"`);
+    } catch {
+    }
+    fs2.unlinkSync(plistPath);
+  }
+}
+function getSystemdServiceContent() {
+  const scriptPath = process.argv[1];
+  return `[Unit]
+Description=Stint Agent (Project Assistant)
+After=network.target
+
+[Service]
+Type=forking
+ExecStart=${process.execPath} "${scriptPath}" daemon start
+Restart=on-failure
+RestartSec=5
+StandardOutput=journal
+StandardError=journal
+
+[Install]
+WantedBy=default.target`;
+}
+async function installLinux() {
+  const systemdDir = path4.join(os3.homedir(), ".config", "systemd", "user");
+  const servicePath = path4.join(systemdDir, SYSTEMD_SERVICE_NAME);
+  if (!fs2.existsSync(systemdDir)) {
+    fs2.mkdirSync(systemdDir, { recursive: true });
+  }
+  const serviceContent = getSystemdServiceContent();
+  fs2.writeFileSync(servicePath, serviceContent);
+  await execAsync("systemctl --user daemon-reload");
+  await execAsync(`systemctl --user enable ${SYSTEMD_SERVICE_NAME}`);
+  await execAsync(`systemctl --user start ${SYSTEMD_SERVICE_NAME}`);
+}
+async function uninstallLinux() {
+  const systemdDir = path4.join(os3.homedir(), ".config", "systemd", "user");
+  const servicePath = path4.join(systemdDir, SYSTEMD_SERVICE_NAME);
+  try {
+    await execAsync(`systemctl --user stop ${SYSTEMD_SERVICE_NAME}`);
+    await execAsync(`systemctl --user disable ${SYSTEMD_SERVICE_NAME}`);
+  } catch {
+  }
+  if (fs2.existsSync(servicePath)) {
+    fs2.unlinkSync(servicePath);
+    await execAsync("systemctl --user daemon-reload");
+  }
+}
+function registerInstallCommand(program2) {
+  program2.command("install").description("Install stint agent to run on system startup").action(async () => {
+    const spinner = ora10("Checking authentication...").start();
+    try {
+      const user = await authService.validateToken();
+      if (!user) {
+        spinner.fail("Not authenticated");
+        console.log(chalk10.red("\n\u2716 You must be logged in to install the background agent on startup."));
+        console.log(chalk10.gray('Run "stint login" first.\n'));
+        process.exit(1);
+      }
+      spinner.text = "Installing startup agent...";
+      const platform = os3.platform();
+      if (platform === "win32") {
+        await installWindows();
+      } else if (platform === "darwin") {
+        await installMac();
+      } else if (platform === "linux") {
+        await installLinux();
+      } else {
+        throw new Error(`Unsupported platform: ${platform}`);
+      }
+      spinner.succeed("Installed successfully!");
+      console.log(chalk10.green(`
+\u2713 Stint agent configured to start on login`));
+      if (platform === "win32") {
+        console.log(chalk10.gray(`Registered Task Scheduler task: ${WINDOWS_TASK_NAME}`));
+      } else if (platform === "darwin") {
+        console.log(chalk10.gray(`Created LaunchAgent: ~/Library/LaunchAgents/${MAC_PLIST_NAME}`));
+      } else if (platform === "linux") {
+        console.log(chalk10.gray(`Created systemd user service: ${SYSTEMD_SERVICE_NAME}`));
+      }
+      console.log();
+      logger.success("install", `Agent installed on startup for ${platform}`);
+    } catch (error) {
+      spinner.fail("Installation failed");
+      logger.error("install", "Install command failed", error);
+      console.error(chalk10.red(`
+\u2716 Error: ${error.message}
+`));
+      process.exit(1);
+    }
+  });
+}
+function registerUninstallCommand(program2) {
+  program2.command("uninstall").description("Remove stint agent from system startup").action(async () => {
+    const spinner = ora10("Removing startup agent...").start();
+    try {
+      const platform = os3.platform();
+      if (platform === "win32") {
+        await uninstallWindows();
+      } else if (platform === "darwin") {
+        await uninstallMac();
+      } else if (platform === "linux") {
+        await uninstallLinux();
+      } else {
+        throw new Error(`Unsupported platform: ${platform}`);
+      }
+      spinner.succeed("Uninstalled successfully");
+      console.log(chalk10.gray("\nStint agent removed from system startup.\n"));
+      logger.success("install", `Agent uninstalled from startup for ${platform}`);
+    } catch (error) {
+      spinner.fail("Uninstall failed");
+      logger.error("install", "Uninstall command failed", error);
+      console.error(chalk10.red(`
+\u2716 Error: ${error.message}
+`));
+      process.exit(1);
+    }
+  });
+}
+
 // src/index.ts
-var AGENT_VERSION = "1.0.2";
+var AGENT_VERSION = "1.0.4";
 var program = new Command();
 program.name("stint").description("Stint Agent - Local daemon for Stint Project Assistant").version(AGENT_VERSION, "-V, --version", "output the current version").addHelpText("after", `
-${chalk10.bold("Examples:")}
-  ${chalk10.cyan("$")} stint login                 ${chalk10.gray("# Authenticate with Stint")}
-  ${chalk10.cyan("$")} stint link                  ${chalk10.gray("# Link current directory to a project")}
-  ${chalk10.cyan("$")} stint daemon start          ${chalk10.gray("# Start background daemon")}
-  ${chalk10.cyan("$")} stint status                ${chalk10.gray("# Check status")}
-  ${chalk10.cyan("$")} stint commits               ${chalk10.gray("# List pending commits")}
+${chalk11.bold("Examples:")}
+  ${chalk11.cyan("$")} stint login                 ${chalk11.gray("# Authenticate with Stint")}
+  ${chalk11.cyan("$")} stint install               ${chalk11.gray("# Install agent to run on startup")}
+  ${chalk11.cyan("$")} stint link                  ${chalk11.gray("# Link current directory to a project")}
+  ${chalk11.cyan("$")} stint daemon start          ${chalk11.gray("# Start background daemon")}
+  ${chalk11.cyan("$")} stint status                ${chalk11.gray("# Check status")}
+  ${chalk11.cyan("$")} stint commits               ${chalk11.gray("# List pending commits")}
 
-${chalk10.bold("Documentation:")}
-  For more information, visit: ${chalk10.blue("https://stint.codes/docs")}
+${chalk11.bold("Documentation:")}
+  For more information, visit: ${chalk11.blue("https://stint.codes/docs")}
     `);
 registerLoginCommand(program);
 registerLogoutCommand(program);
@@ -1084,6 +1290,8 @@ registerStatusCommand(program);
 registerSyncCommand(program);
 registerDaemonCommands(program);
 registerCommitCommands(program);
+registerInstallCommand(program);
+registerUninstallCommand(program);
 program.exitOverride();
 try {
   await program.parseAsync(process.argv);
@@ -1091,7 +1299,7 @@ try {
   const commanderError = error;
   if (commanderError.code !== "commander.help" && commanderError.code !== "commander.version") {
     logger.error("cli", "Command execution failed", error);
-    console.error(chalk10.red(`
+    console.error(chalk11.red(`
 \u2716 Error: ${error.message}
 `));
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gowelle/stint-agent",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Local agent for Stint - Project Assistant",
   "author": "Gowelle John <gowelle.john@icloud.com>",
   "license": "MIT",
@@ -42,6 +42,7 @@
     "conf": "^12.0.0",
     "dotenv": "^17.2.3",
     "node-fetch": "^3.3.2",
+    "node-notifier": "^10.0.1",
     "open": "^10.0.0",
     "ora": "^8.0.1",
     "simple-git": "^3.22.0",
@@ -49,6 +50,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
+    "@types/node-notifier": "^8.0.5",
     "@types/ws": "^8.5.10",
     "@typescript-eslint/eslint-plugin": "^8.50.0",
     "@typescript-eslint/parser": "^8.50.0",
@@ -60,4 +62,4 @@
   "engines": {
     "node": ">=20.0.0"
   }
-}
+}