@magnet-ai/cli 0.1.3 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Magnet (Toolkit)
+
+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

@@ -1,46 +1,110 @@
-# @magnet-ai/cli
+# Magnet CLI
 
-Install the **Magnet CLI** via npm. This package downloads the native binary for your platform from [GitHub Releases](https://github.com/toolkit-ai/magnet-cli/releases) the **first time you run `magnet`** (so `npm install -g` finishes quickly). You do not need Node.js to run the CLI after the binary is downloaded.
+A self-sufficient CLI for [Magnet](https://www.magnet.run): list, get, and create issues and pages, and search. Single native binary — **no Node.js or other runtime required**.
 
-## Install
+## Requirements
+
+- **API key**: Create an API key in your Magnet organization settings, then set it:
+
+  ```bash
+  export MAGNET_API_KEY="your-uuid-api-key"
+  ```
+
+- **Base URL** (optional): Default is `https://www.magnet.run`. Override with:
+
+  ```bash
+  export MAGNET_API_URL="https://www.magnet.run"
+  ```
+
+## Installation
+
+Choose one of the following. No Node.js is required unless you use the npm installer.
+
+### 1. GitHub Releases (recommended)
+
+Download the binary for your platform from [Releases](https://github.com/toolkit-ai/magnet-cli/releases). Extract and put `magnet` (or `magnet.exe` on Windows) in your `PATH`.
+
+**Example (Linux/macOS):**
 
 ```bash
-npm install -g @magnet-ai/cli
+VERSION="v0.1.0"
+PLATFORM="darwin-arm64"   # or linux-amd64, windows-amd64
+curl -sSL "https://github.com/toolkit-ai/magnet-cli/releases/download/${VERSION}/magnet-cli-${PLATFORM}.tar.gz" | tar xz
+sudo mv magnet /usr/local/bin/
 ```
 
-The first time you run `magnet`, it will download the binary (~30s); after that it runs instantly. Example:
+**Windows (PowerShell):**
 
-```bash
-magnet --help
-magnet issues list
-magnet search "query"
+```powershell
+$VERSION = "v0.1.0"
+Invoke-WebRequest -Uri "https://github.com/toolkit-ai/magnet-cli/releases/download/$VERSION/magnet-cli-windows-amd64.tar.gz" -OutFile magnet-cli.tar.gz
+tar -xzf magnet-cli.tar.gz
+# Move magnet.exe to a folder in PATH
 ```
 
-## Requirements
+### 2. npm (wrapper that downloads the binary)
 
-Set your Magnet API key before using the CLI:
+If you have Node.js and npm:
 
 ```bash
-export MAGNET_API_KEY="your-uuid-api-key"
+npm install -g @magnet-ai/cli
 ```
 
-Get an API key from your [Magnet](https://www.magnet.run) organization settings.
+Install finishes quickly; the first time you run `magnet`, it downloads the binary. You do **not** need Node to run the CLI afterward.
+
+### 3. Homebrew (macOS/Linux)
+
+_(Coming soon. Add when the tap is set up.)_
 
-## Test the download (before releasing)
+### 4. Build from source
 
-From the `npm` folder, run the download script to fetch the binary from the latest GitHub Release:
+Requires [Bun](https://bun.sh).
 
 ```bash
-cd npm
-npm run download
+git clone https://github.com/toolkit-ai/magnet-cli.git
+cd magnet-cli
+bun install
+bun run build
+./magnet --help
 ```
 
-To test against a specific release tag: `MAGNET_CLI_VERSION=v0.1.0 npm run download`. Then run `./bin/magnet.js --help` to confirm the binary works.
+For development, testing, and release workflow, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
-## Full documentation
+## Commands
 
-See the [main repository](https://github.com/toolkit-ai/magnet-cli) for commands, pagination, and other install options (direct download, build from source).
+### Issues
+
+- **List**: `magnet issues list [--search q] [--limit n] [--cursor c]`  
+  Pagination: use `--limit` and `--cursor` (from `pagination.nextCursor`) for the next page.
+
+- **Get**: `magnet issues get <id>`
+
+- **Create**: `magnet issues create --description "..." [--title "..."] [--base-branch main]`
+
+### Pages
+
+- **List**: `magnet pages list [--search q] [--limit n] [--cursor c]`
+
+- **Get**: `magnet pages get <id>`
+
+- **Create**: `magnet pages create --title "..." [--markdown "..."]`
+
+### Search
+
+- **Search**: `magnet search <query> [--types issue,page]`
+
+## Output
+
+All commands print JSON to stdout. Errors go to stderr and the process exits with a non-zero code.
+
+**Pagination (issues list / pages list):** The response includes `pagination: { total, hasMore, nextCursor }`. To fetch the next page, set `--cursor` to `pagination.nextCursor`. You can omit `--limit` when using `--cursor` (default page size 50 is sent).
+
+```bash
+magnet issues list --limit 20                    # first page
+magnet issues list --limit 20 --cursor "abc123"  # next page
+magnet issues list --cursor "abc123"              # next page (default limit 50)
+```
 
 ## License
 
-MIT
+MIT — see [LICENSE](LICENSE).

package/bin/{download.js → download.cjs}

@@ -1,14 +1,13 @@
 #!/usr/bin/env node
 /**
- * Postinstall: download the magnet binary from GitHub Releases for this OS/arch.
- * Requires no Node at runtime; the bin/magnet.js wrapper runs the downloaded binary.
+ * Download the magnet binary from GitHub Releases for this OS/arch.
+ * The bin/magnet.cjs wrapper runs the downloaded binary.
  */
 const fs = require('fs');
 const path = require('path');
 const https = require('https');
 const { execSync } = require('child_process');
 
-// Use repo from package.json so it works when published from any org (e.g. toolkit-ai/magnet-cli)
 function getRepo() {
   try {
     const pkg = require(path.join(__dirname, '..', 'package.json'));
@@ -35,8 +34,8 @@ function getPlatform() {
   return null;
 }
 
-const FETCH_TIMEOUT_MS = 60000;   // 60s for API / metadata
-const DOWNLOAD_TIMEOUT_MS = 120000; // 120s for the binary tarball
+const FETCH_TIMEOUT_MS = 60000;
+const DOWNLOAD_TIMEOUT_MS = 120000;
 
 function fetch(url, redirects = 0, timeoutMs = FETCH_TIMEOUT_MS) {
   if (redirects > 5) return Promise.reject(new Error('Too many redirects'));

package/bin/{magnet.js → magnet.cjs}

@@ -8,7 +8,7 @@ const binary = path.join(binDir, process.platform === 'win32' ? 'magnet.exe' : '
 
 if (!fs.existsSync(binary)) {
   console.info('magnet: Downloading binary...');
-  const download = spawnSync(process.execPath, [path.join(__dirname, 'download.js')], {
+  const download = spawnSync(process.execPath, [path.join(__dirname, 'download.cjs')], {
     stdio: 'inherit',
     cwd: path.join(__dirname, '..'),
   });

package/package.json

@@ -1,20 +1,28 @@
 {
   "name": "@magnet-ai/cli",
-  "version": "0.1.3",
-  "description": "Magnet CLI - download the native binary for your platform",
+  "version": "0.1.4",
+  "description": "Magnet CLI — issues, pages, and search. Download the native binary from GitHub Releases.",
+  "type": "module",
   "bin": {
-    "magnet": "bin/magnet.js"
+    "magnet": "bin/magnet.cjs"
   },
   "scripts": {
-    "download": "node bin/download.js"
+    "build": "bun build src/cli.ts --compile --outfile magnet",
+    "test": "bun test",
+    "test-smoke": "bun test && bun run build && sh scripts/smoke.sh",
+    "clean": "rm -f magnet magnet.exe",
+    "start": "bun run src/cli.ts",
+    "download": "node bin/download.cjs"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/toolkit-ai/magnet-cli.git"
   },
-  "keywords": [
-    "magnet",
-    "cli"
-  ],
-  "license": "MIT"
-}
+  "keywords": ["magnet", "cli"],
+  "license": "MIT",
+  "files": ["bin"],
+  "devDependencies": {
+    "@types/bun": "latest",
+    "commander": "^12.1.0"
+  }
+}