@skylence-ai/skyline 1.0.32 → 1.0.34

package/README.md

@@ -39,23 +39,25 @@ dependency — no native installer or compile step. Alternatives:
 `cargo binstall skyline`, or a prebuilt archive from
 [GitHub Releases](https://github.com/skylence-be/binary-skyline/releases).
 
-### 2. Start the shared background service (pick any free port)
-```bash
-skyline daemon start --port 7333
-```
+### 2. Bootstrap the daemon and agent wiring
 
-To survive reboots, register it as an OS service instead: `skyline daemon install --port 7333` (see [docs/install.md](https://github.com/skylence-be/binary-skyline/blob/main/docs/install.md) for details).
-
-### 3. Tell your AI client (here, Claude Code) about it
 ```bash
-claude mcp add --scope user --transport http skyline http://127.0.0.1:7333/mcp
+skyline setup
 ```
 
-Check it is up with `skyline daemon status` (the port should read `running`). That is it.
+`skyline setup` is the idempotent, cross-package-manager setup path. It installs
+the shared HTTP daemon as a supervised autostart service on port 7333, wires
+supported AI agents to `http://127.0.0.1:7333/mcp`, and best-effort installs the
+Skyline marketplace plugins for agent CLIs already on PATH. Re-run with
+`skyline setup --force` after changing agent installs or PATH.
+
+npm may run this for you as a best-effort postinstall hook, but modern package
+managers can block lifecycle scripts. If in doubt, run `skyline setup` once.
 
+Check it is up with `skyline daemon status` (the port should read `running`).
 Other install methods are in [docs/install.md](https://github.com/skylence-be/binary-skyline/blob/main/docs/install.md).
 
-### 4. Prompts for your agent
+### 3. Prompts for your agent
 
 Paste this into your agent's instructions so it picks the right tool:
 
@@ -66,7 +68,7 @@ Prefer skyline's MCP tools over your built-in file read, edit, and search tools
 Or skip the manual setup entirely and hand your agent this:
 
 ```text
-Set up skyline for me: install it with `npm install -g @skylence-ai/skyline` (prebuilt binaries for every platform, incl Windows arm64), install the shared HTTP MCP daemon as a supervised autostart service with `skyline daemon install --port 7333` (so it survives sleep cycles and restarts itself if it dies; plain `skyline daemon start` runs unsupervised and dies with its parent), register it for all my projects with `claude mcp add --scope user --transport http skyline http://127.0.0.1:7333/mcp`, then verify: `skyline daemon status` must show the port as `running`, and `claude mcp list` must show skyline as connected. Do NOT probe the endpoint with raw curl: it is a stateful streamable-HTTP MCP server that requires an initialize handshake, an Accept header for both application/json and text/event-stream, and a session id, so ad-hoc curl calls fail by design; `claude mcp list` is the correct connectivity check, and the tools (e.g. `skyline_version`) become callable in your next session. If the port is taken, pick a free one and redo both the install and add commands with it.
+Set up skyline for me: install it with `npm install -g @skylence-ai/skyline` (prebuilt binaries for every platform, incl Windows arm64), run `skyline setup` to install the shared HTTP MCP daemon as a supervised autostart service and wire supported agents to it, then verify: `skyline daemon status` must show port 7333 as `running`, and the agent's MCP list/status command must show skyline as connected. Do NOT probe the endpoint with raw curl: it is a stateful streamable-HTTP MCP server that requires an initialize handshake, an Accept header for both application/json and text/event-stream, and a session id, so ad-hoc curl calls fail by design; the agent's MCP status command is the correct connectivity check, and the tools (e.g. `skyline_version`) become callable in your next session. If the port is taken, run `skyline daemon install --port <free-port>` and configure agents to `http://127.0.0.1:<free-port>/mcp`.
 ```
 
 ## The numbers
@@ -144,6 +146,7 @@ skyline is one Rust binary with two faces: a command-line tool and an MCP server
 | Observability streams (audit, devlog, bench) | `skyline audit/devlog/bench` | `skyline_observability_*`, tail and prune tools |
 | Manage the background daemon | `skyline daemon …` | (CLI) |
 | Start the daemon on every boot | `skyline daemon install` | (CLI) |
+| Bootstrap daemon + agent wiring | `skyline setup` | (CLI) |
 | Health check | `skyline doctor` | (CLI) |
 ### Understanding code, not just matching text
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skylence-ai/skyline",
-  "version": "1.0.32",
+  "version": "1.0.34",
   "description": "Content-hash line editor — CLI and MCP server",
   "license": "Apache-2.0",
   "repository": {
@@ -21,15 +21,18 @@
     "node": ">=16"
   },
   "preferUnplugged": true,
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
   "bin": {
     "skyline": "bin.js"
   },
   "optionalDependencies": {
-    "@skylence-ai/skyline-darwin-arm64": "1.0.32",
-    "@skylence-ai/skyline-darwin-x64": "1.0.32",
-    "@skylence-ai/skyline-linux-arm64": "1.0.32",
-    "@skylence-ai/skyline-linux-x64": "1.0.32",
-    "@skylence-ai/skyline-win32-x64": "1.0.32",
-    "@skylence-ai/skyline-win32-arm64": "1.0.32"
+    "@skylence-ai/skyline-darwin-arm64": "1.0.34",
+    "@skylence-ai/skyline-darwin-x64": "1.0.34",
+    "@skylence-ai/skyline-linux-arm64": "1.0.34",
+    "@skylence-ai/skyline-linux-x64": "1.0.34",
+    "@skylence-ai/skyline-win32-x64": "1.0.34",
+    "@skylence-ai/skyline-win32-arm64": "1.0.34"
   }
 }

package/postinstall.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+"use strict";
+
+// Package-manager lifecycle scripts are increasingly blocked by default. When
+// this hook does run, treat it as a best-effort convenience; the real,
+// idempotent bootstrap is `skyline setup`.
+if (process.env.CI || process.env.SKYLINE_NO_AUTO_SETUP) process.exit(0);
+
+const { spawnSync } = require("child_process");
+const path = require("path");
+const bin = path.join(__dirname, "bin.js");
+const node = process.execPath;
+
+const r = spawnSync(node, [bin, "setup"], { stdio: "inherit" });
+const code = r.status ?? 1;
+if (r.error || code !== 0) {
+  console.warn(
+    "skyline: postinstall setup skipped or failed; run `skyline setup` once after install."
+  );
+}