kangentic 0.45.0 → 0.47.0

package/README.md

@@ -1,61 +1,51 @@
 # Kangentic
 
-**Visual Agent Orchestration for Claude Code**
+**Drag a card. An agent starts.**
 
-One command to install and launch [Kangentic](https://github.com/Kangentic/kangentic) -- a cross-platform desktop Kanban for Claude Code agents.
+An agentic development environment for AI coding agents. This package installs the desktop app and opens it.
 
-## Install
+![The Kangentic board with tasks in To Do, Planning, Executing, and Code Review, and the selected agent's terminal open below.](https://raw.githubusercontent.com/Kangentic/kangentic/main/docs/images/readme-board-dark.png)
+
+## Install and run
 
 ```bash
 npx kangentic
 ```
 
-This downloads the pre-built binary for your platform from GitHub Releases, installs it, and launches the app. After the first run, the app manages its own updates automatically on every platform.
+The launcher downloads the release that matches its own version from [GitHub Releases](https://github.com/Kangentic/kangentic/releases), installs it, and opens it:
+
+- **Windows.** A per-user install to `%LOCALAPPDATA%\Programs\Kangentic`.
+- **macOS.** `Kangentic.app` in `~/Applications`. An x64 Node running under Rosetta on Apple Silicon still gets the Apple Silicon build.
+- **Linux.** The `.rpm` package (dnf, zypper, or rpm) or the `.deb` package (apt or dpkg). This asks for your password.
 
-### Open a specific project
+To open a project directly:
 
 ```bash
 npx kangentic /path/to/your/project
 ```
 
-## How it works
-
-1. Detects your platform (Windows, macOS, Linux) and architecture (x64, arm64)
-2. Downloads the matching installer from [GitHub Releases](https://github.com/Kangentic/kangentic/releases)
-3. Installs per platform:
-   - **Windows:** Runs NSIS installer silently to `%LOCALAPPDATA%\Programs\Kangentic\`
-   - **macOS:** Extracts .zip to `~/Applications/Kangentic.app`
-   - **Linux:** Installs .rpm on RPM-family systems (`sudo dnf install` on Fedora/RHEL,
-     `sudo zypper install` on openSUSE, falling back to `sudo rpm -Uvh`) or .deb elsewhere
-     (`sudo apt install`, falling back to `sudo dpkg -i`); prompts for password
-4. Launches the app
+To install a specific release, run `npx kangentic@<version>`. The launcher version matches the app version.
 
 ## Updates
 
-After the initial install, you generally don't need to run `npx kangentic` again:
-
-- **Windows:** electron-updater installs new versions silently on restart.
-- **macOS:** Built-in auto-updater downloads in the background and prompts to restart. (Requires code signing.)
-- **Linux:** The app downloads the new deb/rpm and installs it when you click "Restart to update", asking for your password once. If that fails (no polkit agent, for example), re-run `npx kangentic@latest` (the `@latest` matters: a cached launcher reinstalls its own version), then quit and reopen the app.
+The app updates itself. On Windows and macOS a downloaded update installs when you quit. On Linux, click **Restart to update** and enter your password. If that fails, run `npx kangentic@latest`, then quit and reopen the app.
 
-### Install a specific version
-
-```bash
-npx kangentic@0.2.0
-```
+## Requirements
 
-The launcher version matches the app version. Specifying a version downloads that exact release.
+- Windows x64, macOS 13 or later on Apple Silicon or Intel, or Linux x64 or arm64.
+- Node.js 20 or later, and Git 2.26 or later.
+- At least one supported agent CLI, such as Claude Code, Codex CLI, or Gemini CLI, installed and signed in.
 
-## Prerequisites
+## Privacy
 
-- **[Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)** installed and on your PATH
-- **[Git 2.26+](https://git-scm.com/)** for worktree support
+Release builds send anonymous usage events and error reports by default. Set `KANGENTIC_TELEMETRY=0` to turn them off. See the [privacy page](https://www.kangentic.com/privacy/).
 
 ## Links
 
-- [GitHub](https://github.com/Kangentic/kangentic)
-- [Documentation](https://github.com/Kangentic/kangentic/tree/main/docs)
-- [Installation Guide](https://github.com/Kangentic/kangentic/blob/main/docs/installation.md)
+- [Source code and full README](https://github.com/Kangentic/kangentic)
+- [Live demo](https://kangentic.github.io/kangentic/)
+- [Quickstart](https://www.kangentic.com/getting-started/)
+- [Installation guide](https://www.kangentic.com/guide/installation/)
 
 ## License
 

package/bin/kangentic.js

@@ -39,18 +39,54 @@ function isUnsupportedMacOS(platform, osRelease) {
   return Number.isFinite(darwinMajor) && darwinMajor < MINIMUM_DARWIN_MAJOR;
 }
 
+// The Linux arches a release ships, under electron-builder's per-format names
+// (amd64 / x86_64 for x64, arm64 / aarch64 for arm64), which is how the deb and
+// rpm files are named. scripts/release-assets.js lists the same pairs, and
+// tests/unit/release-asset-manifest.test.ts pins the two together.
+const LINUX_PACKAGE_ARCHES = {
+  x64: { deb: 'amd64', rpm: 'x86_64' },
+  arm64: { deb: 'arm64', rpm: 'aarch64' },
+};
+
+// The macOS arches a release ships, one zip each.
+const MAC_ARCHES = ['arm64', 'x64'];
+
+/**
+ * Whether this process is an x64 binary translated by Rosetta on Apple
+ * silicon. An x64 Node reports process.arch 'x64' there, and installing the
+ * Intel build would run the whole app under translation. The sysctl key is
+ * 1 under Rosetta, 0 for a native process, and absent on Intel Macs, so any
+ * failure reads as "not translated". Called by its absolute path, where macOS
+ * always ships it, so a PATH without /usr/sbin cannot turn the probe off.
+ */
+function isTranslatedByRosetta() {
+  try {
+    const output = execFileSync('/usr/sbin/sysctl', ['-n', 'sysctl.proc_translated'], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    return String(output).trim() === '1';
+  } catch {
+    return false;
+  }
+}
+
 function getPlatformInfo() {
   const platform = process.platform;
   const arch = process.arch;
 
   if (platform === 'win32') {
+    // x64 only. Windows on ARM runs it under emulation.
     return { platform: 'win32', arch: 'x64', extension: 'exe' };
   }
   if (platform === 'darwin') {
-    return { platform: 'darwin', arch, extension: 'zip' };
+    const macArch = arch === 'x64' && isTranslatedByRosetta() ? 'arm64' : arch;
+    if (!MAC_ARCHES.includes(macArch)) return null;
+    return { platform: 'darwin', arch: macArch, extension: 'zip' };
   }
   if (platform === 'linux') {
-    return { platform: 'linux', arch: 'x64' };
+    if (!Object.prototype.hasOwnProperty.call(LINUX_PACKAGE_ARCHES, arch)) return null;
+    return { platform: 'linux', arch };
   }
 
   return null;
@@ -102,10 +138,12 @@ function getArtifactFilename(platformInfo) {
     return `Kangentic-${version}-${platformInfo.arch}-mac.zip`;
   }
   if (platformInfo.platform === 'linux') {
+    if (!Object.prototype.hasOwnProperty.call(LINUX_PACKAGE_ARCHES, platformInfo.arch)) return null;
+    const packageArches = LINUX_PACKAGE_ARCHES[platformInfo.arch];
     if (commandExists('rpm') && !commandExists('apt')) {
-      return `kangentic-${version}-1.x86_64.rpm`;
+      return `kangentic-${version}-1.${packageArches.rpm}.rpm`;
     }
-    return `kangentic_${version}_amd64.deb`;
+    return `kangentic_${version}_${packageArches.deb}.deb`;
   }
   return null;
 }
@@ -456,7 +494,8 @@ async function main() {
   const platformInfo = getPlatformInfo();
   if (!platformInfo) {
     console.error(`Unsupported platform: ${process.platform} ${process.arch}`);
-    console.error(`Download manually from: https://github.com/${REPO_OWNER}/${REPO_NAME}/releases`);
+    console.error('Kangentic ships for Windows x64, macOS on Apple silicon or Intel, and Linux x64 or arm64.');
+    console.error(`Releases: https://github.com/${REPO_OWNER}/${REPO_NAME}/releases`);
     process.exit(1);
   }
 
@@ -552,6 +591,8 @@ module.exports = {
   getTempDir,
   getPlatformInfo,
   getArtifactFilename,
+  LINUX_PACKAGE_ARCHES,
+  MAC_ARCHES,
   installLinux,
   isAppRunning,
   shouldAdviseReopen,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kangentic",
-  "version": "0.45.0",
-  "description": "Install and launch Kangentic -- visual agent orchestration for Claude Code",
+  "version": "0.47.0",
+  "description": "Install and launch Kangentic, an agentic development environment for AI coding agents",
   "bin": {
     "kangentic": "bin/kangentic.js"
   },
@@ -14,6 +14,10 @@
     "kanban",
     "claude",
     "claude-code",
+    "codex",
+    "gemini-cli",
+    "coding-agent",
+    "ai-agents",
     "agent",
     "electron",
     "desktop"