@arcadeai/hypotenuse 0.14.0 → 0.15.0

package/dist/hypotenuse.js

@@ -343,7 +343,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@arcadeai/hypotenuse",
-  version: "0.14.0",
+  version: "0.15.0",
   description: "Hypotenuse \u2014 run coding agents on your machine for Linear agent sessions",
   type: "module",
   license: "Apache-2.0",
@@ -377,7 +377,7 @@ var package_default = {
     lint: "tsc && biome check .",
     format: "tsc && biome check --write .",
     bundle: "bun build ./src/cli.ts --target bun --packages external --outfile dist/hypotenuse.js",
-    build: "bun build --compile --minify --sourcemap ./src/cli.ts --outfile dist/hypotenuse",
+    build: "bun build --compile --minify --sourcemap ./src/cli.ts ./skills/hypotenuse.md --loader .md:file --asset-naming='[name].[ext]' --outfile dist/hypotenuse",
     prepack: "bun run bundle"
   },
   dependencies: {
@@ -3598,6 +3598,13 @@ async function resolveProjectId(client, selector) {
     }
   }
 }
+async function onlyProject(client) {
+  const { projects, pagination } = await client.request("GET", "/projects", { query: { page: 1, limit: 2 } });
+  return {
+    project: pagination.total === 1 ? projects[0] ?? null : null,
+    total: pagination.total
+  };
+}
 
 // src/api/url.ts
 import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
@@ -3752,10 +3759,14 @@ class CliContext {
   }
   async projectId() {
     const selector = this.options.project ?? this.env.HYPOTENUSE_PROJECT ?? (this.credentials.servers[this.server.origin]?.project != null ? String(this.credentials.servers[this.server.origin]?.project) : undefined);
-    if (!selector) {
-      throw new Error("No project selected. Pass --project <id|slug> or run `hypotenuse project use <id|slug>`.");
+    if (selector)
+      return resolveProjectId(this.signedInClient(), selector);
+    const { project, total } = await onlyProject(this.signedInClient());
+    if (project) {
+      logger.info(`Using project ${project.slug}, the only one you are in.`);
+      return project.id;
     }
-    return resolveProjectId(this.signedInClient(), selector);
+    throw new Error(total === 0 ? "You are not in any project yet. Create one in the dashboard, or accept an invite." : "No project selected, and you are in several. Pass --project <id|slug> or run `hypotenuse project use <id|slug>`.");
   }
 }
 function contextFor(command) {
@@ -13552,6 +13563,30 @@ function registerSessionCommands(program) {
   });
 }
 
+// src/commands/skill.ts
+import { existsSync as existsSync21, readFileSync as readFileSync12 } from "fs";
+import { join as join13 } from "path";
+var SKILL_FILE = "hypotenuse.md";
+async function readSkill() {
+  const embedded = Bun.embeddedFiles.find((file) => file.name === SKILL_FILE);
+  if (embedded)
+    return embedded.text();
+  for (const up of [[".."], ["..", ".."]]) {
+    const path = join13(import.meta.dir, ...up, "skills", SKILL_FILE);
+    if (existsSync21(path))
+      return readFileSync12(path, "utf8");
+  }
+  throw new Error(`This install has no skills/${SKILL_FILE}; reinstall hypotenuse.`);
+}
+function registerSkillCommand(program) {
+  program.command("skill").description("Print the agent skill for using this CLI (save it as SKILL.md)").action(async function() {
+    await runCommand(this, async (ctx) => {
+      const skill = await readSkill();
+      emit(ctx, { skill }, () => skill.trimEnd());
+    });
+  });
+}
+
 // src/commands/tag.ts
 function registerTagCommands(program) {
   const tag = program.command("tag").description("The selected project's permission tags");
@@ -14048,6 +14083,7 @@ function buildProgram() {
   registerServiceCommands(program);
   registerDoctorCommand(program);
   registerCheckUpdateCommand(program);
+  registerSkillCommand(program);
   registerUpgradeCommand(program);
   registerMcpCommand(program);
   return program;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadeai/hypotenuse",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Hypotenuse — run coding agents on your machine for Linear agent sessions",
   "type": "module",
   "license": "Apache-2.0",
@@ -34,7 +34,7 @@
     "lint": "tsc && biome check .",
     "format": "tsc && biome check --write .",
     "bundle": "bun build ./src/cli.ts --target bun --packages external --outfile dist/hypotenuse.js",
-    "build": "bun build --compile --minify --sourcemap ./src/cli.ts --outfile dist/hypotenuse",
+    "build": "bun build --compile --minify --sourcemap ./src/cli.ts ./skills/hypotenuse.md --loader .md:file --asset-naming='[name].[ext]' --outfile dist/hypotenuse",
     "prepack": "bun run bundle"
   },
   "dependencies": {

package/skills/hypotenuse.md

@@ -17,7 +17,7 @@ server. It calls the same HTTP actions the dashboard does, as the person who sig
 - Lists take `--page` and `--limit` (default 25) and answer a
   `pagination: { page, limit, total, pages }` envelope.
 - Project-scoped commands act on `--project <id|slug>`, else `HYPOTENUSE_PROJECT`, else the project
-  chosen with `hypotenuse project use`.
+  chosen with `hypotenuse project use`, else the person's only project when they are in just one.
 - The server is `--url`, else `HYPOTENUSE_URL`, else wherever `login` last signed in.
 - `HYPOTENUSE_NO_UPDATE_CHECK=1` turns off the background update notice.
 
@@ -48,6 +48,7 @@ server. It calls the same HTTP actions the dashboard does, as the person who sig
 | `hypotenuse doctor [--agent <id>] [--offline]` | A checklist of this machine's runner setup — version, tools, config, credentials, server and token, daemon and service, agents, repositories, disk — exit 1 when a check fails. `--agent <id>` starts that agent, runs the ACP `initialize` handshake, and opens a session — a failure names `hypotenuse agents login <id>`. |
 | `hypotenuse mcp --session <id> --nonce <n>` | Hidden: the stdio MCP server the daemon hands a coding agent for one turn — the Linear tools scoped to that session. Not for running by hand. |
 | `hypotenuse check-update` | Whether a newer release exists, with its changelog. |
+| `hypotenuse skill` | Print this skill, the same text on every install (npm or binary); `--json` wraps it as `{ skill }`. |
 | `hypotenuse upgrade [--no-restart]` | Upgrade in place, by however it was installed (npm, bun, or binary), then drain and restart a running daemon on the new version. |
 
 ## Examples