akili-specs 2.2.1 → 2.2.2

package/CHANGELOG.md

@@ -6,10 +6,13 @@ The format is inspired by Keep a Changelog and the repository follows semantic v
 
 ## [Unreleased]
 
-### Notes
+### Fixed
+- Changed the CLI behavior so that running `akili` with no arguments defaults to showing the `help` menu instead of launching the interactive `init` wizard. The wizard must now be explicitly invoked via `akili init` (or `npx akili-specs init`).
 
-- No unreleased changes yet.
+## [2.2.2] - 2026-07-19
 
+### Fixed
+- Replaced `pnpm add -g` with the classic `npm install -g` in the global installation documentation to prevent the `ERR_PNPM_NO_GLOBAL_BIN_DIR` error that occurs in environments without a pre-configured PNPM home directory.
 ## [2.2.1] - 2026-07-19
 
 ### Fixed

package/README.md

@@ -131,12 +131,10 @@ Install the methodology with the bundled CLI. The installer can target Claude, O
 ### Step 2: Install
 
 **Interactive Installation (Recommended):**
-Simply run the CLI without arguments to launch the interactive setup wizard, which will ask you about the tool and whether you want a global or local installation:
+Run the `init` command to launch the interactive setup wizard, which will ask you about the tool and whether you want a global or local installation:
 
 ```bash
-pnpm dlx akili-specs
-# or
-pnpm dlx akili-specs init
+npx akili-specs init
 ```
 
 **Manual Installation via Flags:**
@@ -144,19 +142,19 @@ pnpm dlx akili-specs init
 Install globally for Claude (default):
 
 ```bash
-pnpm dlx akili-specs install
+npx akili-specs install
 ```
 
 Install globally for OpenCode:
 
 ```bash
-pnpm dlx akili-specs install --tool opencode
+npx akili-specs install --tool opencode
 ```
 
 Install locally to the current project workspace:
 
 ```bash
-pnpm dlx akili-specs install --tool both --local
+npx akili-specs install --tool both --local
 ```
 
 ### Step 3: Verify The Installation
@@ -164,25 +162,25 @@ pnpm dlx akili-specs install --tool both --local
 Check Claude installation:
 
 ```bash
-pnpm dlx akili-specs doctor --tool claude
+npx akili-specs doctor --tool claude
 ```
 
 Check OpenCode installation:
 
 ```bash
-pnpm dlx akili-specs doctor --tool opencode
+npx akili-specs doctor --tool opencode
 ```
 
 Check Antigravity installation:
 
 ```bash
-pnpm dlx akili-specs doctor --tool antigravity
+npx akili-specs doctor --tool antigravity
 ```
 
 Check all:
 
 ```bash
-pnpm dlx akili-specs doctor --tool all
+npx akili-specs doctor --tool all
 ```
 
 Expected result: every command, skill, and helper resource shows `OK`.
@@ -239,7 +237,7 @@ node bin/akili.js doctor --tool both
 If you prefer a persistent global CLI:
 
 ```bash
-pnpm add -g akili-specs
+npm install -g akili-specs
 akili install
 akili install --tool opencode
 akili doctor --tool opencode
@@ -281,19 +279,19 @@ OpenCode loads global command markdown files from `~/.config/opencode/commands/`
 Update Claude:
 
 ```bash
-pnpm dlx akili-specs update --tool claude --force
+npx akili-specs update --tool claude --force
 ```
 
 Update OpenCode:
 
 ```bash
-pnpm dlx akili-specs update --tool opencode --force
+npx akili-specs update --tool opencode --force
 ```
 
 Update both:
 
 ```bash
-pnpm dlx akili-specs update --tool both --force
+npx akili-specs update --tool both --force
 ```
 
 Use `--force` when you want packaged files to replace older installed files. Without `--force`, existing files are skipped.
@@ -353,8 +351,8 @@ npm publish --access public --registry=https://registry.npmjs.org/
 After publish, smoke test:
 
 ```bash
-pnpm dlx akili-specs@X.Y.Z list
-pnpm dlx akili-specs@X.Y.Z install --tool both --dry-run
+npx akili-specs@X.Y.Z list
+npx akili-specs@X.Y.Z install --tool both --dry-run
 npm view akili-specs version --registry=https://registry.npmjs.org/
 npm run release:status
 ```

package/bin/akili.js

@@ -593,7 +593,7 @@ async function main() {
     printBanner();
   }
 
-  if (process.argv.length === 2 || args.command === "init") {
+  if (args.command === "init") {
     printBanner();
     await runInteractiveInit();
     return;

package/docs/cli.md

@@ -6,11 +6,11 @@ The `akili` CLI installs the AKILI command prompts, skills, and helper resources
 
 ### Interactive Mode (Recommended)
 
-Run the CLI without arguments or use the `init` command to launch an interactive wizard. It will guide you through selecting the target tools and choosing between global or local installation:
+Run the `init` command to launch an interactive wizard. It will guide you through selecting the target tools and choosing between global or local installation:
 
 ```bash
-pnpm dlx akili-specs
-# or
+npx akili-specs init
+# or, if installed globally
 akili init
 ```
 
@@ -19,23 +19,23 @@ akili init
 Run directly from npm:
 
 ```bash
-pnpm dlx akili-specs install --tool claude
-pnpm dlx akili-specs install --tool opencode
-pnpm dlx akili-specs install --tool antigravity
-pnpm dlx akili-specs install --tool both
-pnpm dlx akili-specs install --tool all
+npx akili-specs install --tool claude
+npx akili-specs install --tool opencode
+npx akili-specs install --tool antigravity
+npx akili-specs install --tool both
+npx akili-specs install --tool all
 ```
 
 Claude is the default target:
 
 ```bash
-pnpm dlx akili-specs install
+npx akili-specs install
 ```
 
 Use a persistent global install if preferred:
 
 ```bash
-pnpm add -g akili-specs
+npm install -g akili-specs
 akili install --tool all
 ```
 

package/docs/release-checklist.md

@@ -78,8 +78,8 @@ For private registry publishing, configure the registry first and publish using
 ## Post-Publish Smoke Test
 
 ```bash
-pnpm dlx akili-specs@<version> list
-pnpm dlx akili-specs@<version> install --tool both --dry-run
+npx akili-specs@<version> list
+npx akili-specs@<version> install --tool both --dry-run
 npm view akili-specs version --registry=https://registry.npmjs.org/
 npm run release:status
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akili-specs",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Portable AKILI-SPECS methodology commands and skills for AI-assisted development.",
   "homepage": "https://github.com/JuankCadavid/akili-specs#readme",
   "repository": {