get-claudia 1.61.0 → 1.61.1

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to Claudia will be documented in this file.
 
+## 1.61.1 (2026-05-23)
+
+### `claudia` command works from anywhere, and repairs itself
+
+A follow-up to 1.61.0's shell command. The installer was storing a relative path, so `claudia` only worked from the install's parent directory. This release fixes the stored path and makes the command self-healing, so the error cannot recur.
+
+### Fixed
+
+- **`claudia` command failing with "Claudia home directory not found: claudia".** The installer wrote a *relative* path (`claudia`) into `~/.claudia/claudia-home` instead of the absolute install path, because the shell-helper step was handed `targetDir` (relative) rather than the resolved `targetPath`. The `claudia` command then only worked when run from the install's parent directory and failed everywhere else. The installer now always stores the absolute path (via `path.resolve`, which also fixes a separate bug where passing an absolute install path as an argument produced a doubled path like `/home/you/home/you/claudia`).
+- **`claudia` command now self-heals a bad `claudia-home`.** The shell function resolves a relative stored value against `$HOME` (never the current directory), falls back to the default `~/claudia` install when the stored path is missing or stale, and rewrites `claudia-home` with the corrected absolute path so the error cannot recur. Existing installs that already have a bad value are repaired the first time `claudia` runs after upgrading.
+- **`--skip-memory` installs now get the `claudia` command too.** Previously the shell-helper step was skipped entirely on the `--skip-memory` path, leaving those users with no `claudia`/`update-claudia` command. The shell helper is independent of the memory system and now installs on every path.
+
 ## 1.61.0 (2026-05-22)
 
 ### Launch from anywhere, upgrade from anywhere

package/bin/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { existsSync, mkdirSync, cpSync, readdirSync, readFileSync, writeFileSync, statSync, renameSync, unlinkSync, copyFileSync } from 'fs';
-import { join, dirname } from 'path';
+import { join, dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { spawn, execFileSync } from 'child_process';
 import { homedir } from 'os';
@@ -828,7 +828,9 @@ async function main() {
   // Support "." or "upgrade" for current directory
   const isCurrentDir = arg === '.' || arg === 'upgrade';
   const targetDir = isCurrentDir ? '.' : (arg || 'claudia');
-  const targetPath = isCurrentDir ? process.cwd() : join(process.cwd(), targetDir);
+  // resolve() (not join) so an absolute arg is honored as-is and the result is
+  // always absolute (this value is what gets written into ~/.claudia/claudia-home).
+  const targetPath = isCurrentDir ? process.cwd() : resolve(process.cwd(), targetDir);
 
   // Check if directory already exists with Claudia files
   let isUpgrade = false;
@@ -969,11 +971,14 @@ async function main() {
     }
     renderer.render();
 
-    // Only run vault step
-    runVaultStep(renderer, () => {
-      renderer.stopSpinner();
-      renderer.render();
-      showCompletion(targetDir, isCurrentDir, false, undefined, isUpgrade);
+    // The `claudia` shell command is independent of the memory system, so install
+    // it here too, otherwise --skip-memory users get no `claudia` command.
+    runShellStep(renderer, targetPath, () => {
+      runVaultStep(renderer, () => {
+        renderer.stopSpinner();
+        renderer.render();
+        showCompletion(targetDir, isCurrentDir, false, undefined, isUpgrade);
+      });
     });
     return;
   }
@@ -1563,8 +1568,11 @@ async function main() {
 
   renderer.stopSpinner();
 
-  // Shell helper step, then vault, then completion
-  runShellStep(renderer, targetDir, () => {
+  // Shell helper step, then vault, then completion.
+  // Pass the absolute targetPath (not the relative targetDir): this value lands
+  // in ~/.claudia/claudia-home, and a relative value there breaks `claudia` from
+  // any directory other than the install's parent.
+  runShellStep(renderer, targetPath, () => {
     runVaultStep(renderer, () => {
       renderer.render();
       showDbScanResults(dbScan);

package/bin/shell-init.js

@@ -28,17 +28,37 @@ export const SHELL_INIT_CONTENT = `# Claudia shell helpers — sourced from your
 
 _claudia_home() {
   local home_file="$HOME/.claudia/claudia-home"
-  if [ ! -f "$home_file" ]; then
-    echo "Claudia home not configured. Run: npx get-claudia ." >&2
-    return 1
+  local dir=""
+  [ -f "$home_file" ] && dir="$(cat "$home_file" 2>/dev/null)"
+
+  # A relative value (e.g. an older install that stored "claudia") is anchored to
+  # $HOME, never the current directory, so \`claudia\` works from anywhere.
+  case "$dir" in
+    /*) ;;                  # already absolute
+    "") ;;                  # empty -> handled by recovery below
+    *) dir="$HOME/$dir" ;;  # relative -> resolve under $HOME
+  esac
+
+  # Recover from a missing or stale path by falling back to the default install
+  # location when it looks like a real Claudia install.
+  if [ -z "$dir" ] || [ ! -d "$dir" ]; then
+    if [ -d "$HOME/claudia/.claude" ] || [ -f "$HOME/claudia/CLAUDE.md" ]; then
+      dir="$HOME/claudia"
+    fi
   fi
-  local dir
-  dir="$(cat "$home_file")"
-  if [ ! -d "$dir" ]; then
-    echo "Claudia home directory not found: $dir" >&2
-    echo "Fix by editing $home_file" >&2
+
+  if [ -z "$dir" ] || [ ! -d "$dir" ]; then
+    echo "Claudia install not found. Run: npx get-claudia ." >&2
+    [ -f "$home_file" ] && echo "(or set the correct path in $home_file)" >&2
     return 1
   fi
+
+  # Self-heal: persist the corrected absolute path so the error never recurs.
+  if [ "$(cat "$home_file" 2>/dev/null)" != "$dir" ]; then
+    mkdir -p "$HOME/.claudia" 2>/dev/null
+    printf '%s\\n' "$dir" > "$home_file" 2>/dev/null || true
+  fi
+
   printf '%s' "$dir"
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-claudia",
-  "version": "1.61.0",
+  "version": "1.61.1",
   "description": "An AI assistant who learns how you work.",
   "keywords": [
     "claudia",

package/template-v2/.claude/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.61.0",
-  "generated": "2026-05-23T02:25:12.290Z",
+  "version": "1.61.1",
+  "generated": "2026-05-23T14:34:46.165Z",
   "algorithm": "sha256",
   "files": {
     ".claude/rules/claudia-principles.md": "939e9720421628e7f2e4c8dfbaa4aeb9c1e18e8c6a5379cd6b772a6835b812e5",