@tasklight/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Revaz Zakalashvili
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# @tasklight/cli
+
+npm package for the Tasklight CLI.
+
+Tasklight notifies you when long-running developer tasks finish, fail, or need attention.
+
+## Install
+
+```bash
+npm install -g @tasklight/cli
+```
+
+Then:
+
+```bash
+tasklight --version
+tasklight doctor
+tasklight run -- pnpm test
+tasklight notify --subtitle "✅ Done" --message "Finished"
+```
+
+## Platform support
+
+This package currently bundles prebuilt Tasklight binaries for:
+
+- macOS arm64
+- macOS x64
+- Linux arm64
+- Linux x64
+
+Windows is not packaged yet.
+
+## macOS optional enhancement
+
+Tasklight works on macOS with built-in `osascript` notifications. For better notification identity, custom icon support, and click-to-focus behavior, install:
+
+```bash
+brew install terminal-notifier
+```
+
+## Linux notification dependency
+
+Linux desktop notifications use `notify-send`.
+
+```bash
+# Ubuntu/Debian
+sudo apt install libnotify-bin
+
+# Fedora
+sudo dnf install libnotify
+
+# Arch
+sudo pacman -S libnotify
+```
+
+## Development
+
+From the Tasklight repository root:
+
+```bash
+npm --prefix npm/tasklight-cli run build:vendor
+npm --prefix npm/tasklight-cli run test:local
+npm --prefix npm/tasklight-cli run pack:check
+```
+
+## Source
+
+https://github.com/revazi/tasklight

package/bin/tasklight.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const platform = process.platform;
+const arch = process.arch;
+const key = `${platform}-${arch}`;
+
+const targets = {
+  "darwin-arm64": "darwin-arm64",
+  "darwin-x64": "darwin-amd64",
+  "linux-arm64": "linux-arm64",
+  "linux-x64": "linux-amd64",
+};
+
+const target = targets[key];
+
+if (!target) {
+  console.error(`Tasklight: unsupported platform ${platform}/${arch}.`);
+  console.error("Supported platforms: macOS/Linux on arm64/x64.");
+  process.exit(1);
+}
+
+const binary = path.join(__dirname, "..", "vendor", target, "tasklight");
+
+if (!fs.existsSync(binary)) {
+  console.error(`Tasklight binary not found for ${platform}/${arch}: ${binary}`);
+  console.error("If you are developing locally, run: npm run build:vendor");
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@tasklight/cli",
+  "version": "0.1.0",
+  "description": "Tasklight CLI: get notified when long-running developer tasks finish, fail, or need attention.",
+  "license": "MIT",
+  "author": "Revaz Zakalashvili",
+  "homepage": "https://github.com/revazi/tasklight#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/revazi/tasklight.git",
+    "directory": "npm/tasklight-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/revazi/tasklight/issues"
+  },
+  "keywords": [
+    "tasklight",
+    "cli",
+    "developer-tools",
+    "notifications",
+    "macos",
+    "linux",
+    "tmux",
+    "coding-agents",
+    "golang"
+  ],
+  "bin": {
+    "tasklight": "./bin/tasklight.js"
+  },
+  "files": [
+    "bin/",
+    "vendor/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build:vendor": "../../scripts/build-npm-cli.sh",
+    "pack:check": "npm pack --dry-run",
+    "test:local": "node ./bin/tasklight.js --version && node ./bin/tasklight.js doctor"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ]
+}