@headways/cli 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,77 @@
+# @headways/cli
+
+The official CLI for [Headways](https://headways.ai) — author skills, sync them to your team, and capture workflows directly from Claude Code.
+
+## Installation
+
+```bash
+npm install -g @headways/cli
+```
+
+## Setup
+
+```bash
+headways configure
+# Prompts for your API key (sk_…). Validates and saves org automatically.
+```
+
+Options:
+
+```bash
+headways configure --token <key>              # non-interactive
+headways configure --api-url http://localhost:3001  # local dev
+headways configure status                    # show saved key + org
+headways configure clear                     # remove credentials
+```
+
+## Commands
+
+### Skills
+
+```bash
+headways skills new                          # scaffold a new skill interactively
+headways skills new --slug <slug> --headline "<headline>"  # non-interactive
+headways skills import <path>               # ingest an existing file or directory
+headways skills push <slug>                 # sync local edits to the skill draft
+headways skills list                        # list skills in the active org
+headways skills capture                     # capture a workflow from Claude Code
+```
+
+### Sync
+
+```bash
+headways sync start                         # register device + pull updates once
+headways sync start --daemon                # poll every 60s for background updates
+headways sync status                        # show pending skill updates
+headways accept <skill>                     # install a pending update
+```
+
+### Other
+
+```bash
+headways feedback <skillSlug>               # submit feedback on a skill run
+headways org use <slug>                     # switch active org
+```
+
+## Creating a skill from scratch
+
+```bash
+cd ~/my-skills
+headways skills new                         # creates ./<slug>/ with SKILL.md,
+                                            # headways.yaml, capabilities.yaml,
+                                            # hooks.yaml
+# Edit the skill
+vim <slug>/SKILL.md
+# Push as a draft
+headways skills push <slug>
+# Publish via the web UI when ready
+```
+
+Installed skill bundles land in `~/.claude/skills/<slug>/`. Config is stored in `~/.headways/config.json`.
+
+## Local development
+
+```bash
+pnpm --filter @headways/cli build
+npm install -g ./packages/cli
+```

package/dist/index.js

@@ -50,7 +50,9 @@ function registerAuthCommands(program2) {
         cfg.orgId = me.organization.id;
       }
       writeConfig(cfg);
-      console.log(me.type === "api_key" && me.organization ? `API key saved. Org: ${me.organization.slug}` : "API key saved.");
+      console.log(
+        me.type === "api_key" && me.organization ? `API key saved. Org: ${me.organization.slug}` : "API key saved."
+      );
     } catch {
       console.error("Invalid API key. Not saved. Check the key and try again.");
       process.exit(1);
@@ -61,7 +63,9 @@ function registerAuthCommands(program2) {
     if (!cfg.token) {
       console.log("No API key configured. Run `headways configure`.");
     } else {
-      console.log(`API key: ${cfg.token.slice(0, 12)}\u2026 | Org: ${cfg.orgSlug ?? "(none set)"} | API: ${cfg.apiUrl ?? "https://api.headways.ai"}`);
+      console.log(
+        `API key: ${cfg.token.slice(0, 12)}\u2026 | Org: ${cfg.orgSlug ?? "(none set)"} | API: ${cfg.apiUrl ?? "https://api.headways.ai"}`
+      );
     }
   });
   configure.command("clear").description("Remove stored API key and org").action(() => {

package/package.json

@@ -1,39 +1,41 @@
 {
   "name": "@headways/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "Headways CLI — authoring, sync, and runtime SDK",
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "bin": {
     "headways": "./dist/index.js"
   },
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run",
-    "test:unit": "vitest run",
-    "type-check": "tsc -p tsconfig.json --noEmit",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
-    "@headways/db": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.15.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "dotenv": "^16.4.7",
     "node-fetch": "^3.3.2",
     "yaml": "^2.5.1",
-    "zod": "^3.25.28"
+    "zod": "^3.25.28",
+    "@headways/db": "0.0.0"
   },
   "devDependencies": {
-    "@headways/config": "workspace:*",
     "@types/node": "^22.16.5",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@headways/config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "type-check": "tsc -p tsconfig.json --noEmit"
   }
-}
+}