code-aide 1.4.2__tar.gz → 1.5.0__tar.gz

{code_aide-1.4.2 → code_aide-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-aide
-Version: 1.4.2
+Version: 1.5.0
 Summary: Manage AI coding CLI tools (Claude, Copilot, Cursor, Gemini, Amp, Codex)
 Project-URL: Homepage, https://github.com/dajobe/code-aide
 Project-URL: Repository, https://github.com/dajobe/code-aide
@@ -84,7 +84,7 @@ code-aide update-versions -b -y
 | Tool                     | Command   | Install Type       | Default |
 |--------------------------|-----------|--------------------|---------|
 | Cursor CLI               | `agent`   | Direct download    | Yes     |
-| Claude CLI (Claude Code) | `claude`  | Self-managed (npm) | Yes     |
+| Claude CLI (Claude Code) | `claude`  | Script             | Yes     |
 | Gemini CLI               | `gemini`  | npm                | Yes     |
 | OpenCode                 | `opencode`| npm                | No      |
 | Kilo CLI                 | `kilo`    | npm                | No      |
@@ -96,20 +96,20 @@ code-aide update-versions -b -y
 
 code-aide uses a three-layer version data model:
 
-1. **Tool definitions** (bundled with the package): Install methods,
-   URLs, npm packages, version args. Updated by releasing new versions
-   of code-aide.
+1. **Tool definitions** (bundled with the package): Install methods, URLs,
+   npm packages, version args. Updated by releasing new versions of
+   code-aide.
 
-2. **Bundled version baseline** (in `data/tools.json`): Latest
-   versions and SHA256 hashes as known at release time. Acts as a
-   fallback for fresh installs.
+2. **Bundled version baseline** (in `data/tools.json`): Latest versions and
+   SHA256 hashes as known at release time. Acts as a fallback for fresh
+   installs.
 
-3. **User's local version cache**
-   (`~/.config/code-aide/versions.json`): Written by `code-aide
-   update-versions`. Takes precedence over bundled data when present.
+3. **User's local version cache** (`~/.config/code-aide/versions.json`):
+   Written by `code-aide update-versions`. Takes precedence over bundled
+   data when present.
 
-Run `code-aide update-versions` to get fresher version data without
-waiting for a new code-aide release.
+Run `code-aide update-versions` to get fresher version data without waiting
+for a new code-aide release.
 
 ## Features
 
@@ -130,7 +130,8 @@ waiting for a new code-aide release.
 
 1. Install uv: `curl -LsSf https://astral.sh/uv/install.sh | sh`
 2. Install dependencies: `uv sync`
-3. Install pre-commit hooks: `uv tool install pre-commit && pre-commit install`
+3. Install pre-commit hooks: `uv tool install pre-commit && pre-commit
+   install`
 4. Run tests: `uv run pytest tests/ -v`
 
 ```bash
@@ -159,8 +160,8 @@ uv run pytest tests/test_install.py::TestDetectOsArch -v
    - `git add src/code_aide/__init__.py`
    - `git commit -m "Bumped version to X.Y.Z"`
 5. Write useful commit messages before tagging:
-   - Start subject lines with an action verb in past tense (`Added`, `Changed`,
-     `Fixed`, `Removed`).
+   - Start subject lines with an action verb in past tense (`Added`,
+     `Changed`, `Fixed`, `Removed`).
    - Keep subjects user-facing so auto-generated release notes are
      meaningful.
    - Group related changes into focused commits instead of one broad commit.

{code_aide-1.4.2 → code_aide-1.5.0}/README.md

@@ -58,7 +58,7 @@ code-aide update-versions -b -y
 | Tool                     | Command   | Install Type       | Default |
 |--------------------------|-----------|--------------------|---------|
 | Cursor CLI               | `agent`   | Direct download    | Yes     |
-| Claude CLI (Claude Code) | `claude`  | Self-managed (npm) | Yes     |
+| Claude CLI (Claude Code) | `claude`  | Script             | Yes     |
 | Gemini CLI               | `gemini`  | npm                | Yes     |
 | OpenCode                 | `opencode`| npm                | No      |
 | Kilo CLI                 | `kilo`    | npm                | No      |
@@ -70,20 +70,20 @@ code-aide update-versions -b -y
 
 code-aide uses a three-layer version data model:
 
-1. **Tool definitions** (bundled with the package): Install methods,
-   URLs, npm packages, version args. Updated by releasing new versions
-   of code-aide.
+1. **Tool definitions** (bundled with the package): Install methods, URLs,
+   npm packages, version args. Updated by releasing new versions of
+   code-aide.
 
-2. **Bundled version baseline** (in `data/tools.json`): Latest
-   versions and SHA256 hashes as known at release time. Acts as a
-   fallback for fresh installs.
+2. **Bundled version baseline** (in `data/tools.json`): Latest versions and
+   SHA256 hashes as known at release time. Acts as a fallback for fresh
+   installs.
 
-3. **User's local version cache**
-   (`~/.config/code-aide/versions.json`): Written by `code-aide
-   update-versions`. Takes precedence over bundled data when present.
+3. **User's local version cache** (`~/.config/code-aide/versions.json`):
+   Written by `code-aide update-versions`. Takes precedence over bundled
+   data when present.
 
-Run `code-aide update-versions` to get fresher version data without
-waiting for a new code-aide release.
+Run `code-aide update-versions` to get fresher version data without waiting
+for a new code-aide release.
 
 ## Features
 
@@ -104,7 +104,8 @@ waiting for a new code-aide release.
 
 1. Install uv: `curl -LsSf https://astral.sh/uv/install.sh | sh`
 2. Install dependencies: `uv sync`
-3. Install pre-commit hooks: `uv tool install pre-commit && pre-commit install`
+3. Install pre-commit hooks: `uv tool install pre-commit && pre-commit
+   install`
 4. Run tests: `uv run pytest tests/ -v`
 
 ```bash
@@ -133,8 +134,8 @@ uv run pytest tests/test_install.py::TestDetectOsArch -v
    - `git add src/code_aide/__init__.py`
    - `git commit -m "Bumped version to X.Y.Z"`
 5. Write useful commit messages before tagging:
-   - Start subject lines with an action verb in past tense (`Added`, `Changed`,
-     `Fixed`, `Removed`).
+   - Start subject lines with an action verb in past tense (`Added`,
+     `Changed`, `Fixed`, `Removed`).
    - Keep subjects user-facing so auto-generated release notes are
      meaningful.
    - Group related changes into focused commits instead of one broad commit.

code_aide-1.5.0/specs/claude-native-installer-migration.md

@@ -0,0 +1,112 @@
+# Migrate Claude Code from npm to native installer in code-aide
+
+## Context
+
+Anthropic has deprecated npm installation of Claude Code in favor of a
+native installer (`curl -fsSL https://claude.ai/install.sh | bash`). The
+native binary lives at `~/.local/bin/claude` (symlink to
+`~/.local/share/claude/versions/<version>`), auto-updates, and has no
+Node.js dependency. code-aide currently treats Claude as `self_managed`
+install type backed by npm, which is now outdated.
+
+## Approach
+
+Change Claude's install type from `self_managed` (npm-backed) to `script`
+(install-script-backed). This reuses the existing `script` install type
+already used by Amp, which downloads and verifies a shell script by SHA256
+before executing it. Claude Code was the only tool using `self_managed`, so
+that type becomes dead code and can be removed.
+
+## Changes
+
+### 1. `src/code_aide/data/tools.json` -- update claude config
+
+- Change `install_type` from `self_managed` to `script`
+- Add `install_url`: `https://claude.ai/install.sh`
+- Add `install_sha256`:
+  `431889ac7d056f636aaf5b71524666d04c89c45560f80329940846479d484778`
+- Remove `npm_package` field
+- Remove `upgrade_command` field (native binary auto-updates; `script`
+  upgrade re-runs the install script which is idempotent)
+- Change `prerequisites` from `["npm"]` to `[]`
+- Update `docs_url` to `https://code.claude.com/docs/en/setup`
+
+### 2. `src/code_aide/detection.py` -- detect native installer
+
+Add a new detection case before the `node_modules` check:
+
+```python
+if "/.local/share/claude/versions/" in real_path:
+    return {"method": "script", "detail": "native installer"}
+```
+
+This detects the native binary's real path pattern.
+
+### 3. `src/code_aide/detection.py` -- format label
+
+No change needed -- the existing `format_install_method("script")` returns
+`"script"` which is accurate.
+
+### 4. `src/code_aide/install.py` -- remove `self_managed` branch
+
+Remove the `elif install_type == "self_managed"` block (lines 289-301). The
+`script` handler (lines 261-275) will now handle Claude's installation.
+
+### 5. `src/code_aide/operations.py` -- remove `self_managed` branches
+
+- **upgrade_tool**: Remove `elif method == "self_managed"` block (lines
+  65-71). The `script` branch (lines 53-59) handles re-running the install
+  script, which for Claude is idempotent and installs the latest version.
+- **remove_tool**: Remove `elif method == "self_managed"` block (lines
+  203-230). The `script` branch (lines 133-158) removes the binary at its
+  `which` path. For full cleanup, add removal of `~/.local/share/claude`
+  directory in the script removal path when the tool is `claude`.
+
+### 6. `src/code_aide/versions.py` -- remove `self_managed` branch
+
+- `format_check_backend`: Remove the `self_managed` -> `npm-registry`
+  mapping (line 276-277). Claude will now use `script-url` backend (SHA256
+  check of install script + version extraction).
+- `check_npm_tool` is no longer called for Claude; `check_script_tool`
+  handles it instead via the `script` type path.
+
+### 7. `src/code_aide/commands_actions.py` -- remove `self_managed` from update check
+
+- Line 259: Change `if install_type in ("npm", "self_managed")` to `if
+  install_type == "npm"`.
+
+### 8. Tests -- update all `self_managed` references
+
+- **`tests/test_constants.py`**: Change assertion from `self_managed` to
+  `script`; remove npm prerequisite assertion
+- **`tests/test_config.py`**: Change assertion from `self_managed` to
+  `script`
+- **`tests/test_detection.py`**:
+  - Update `test_detects_brew_npm_wrapper` -- this test was for npm Claude
+    installs; replace with test for native installer detection (realpath
+    containing `/.local/share/claude/versions/`)
+  - Update `test_detects_plain_npm_global` -- same, replace with a variant
+  - Remove `TestFormatInstallMethodSelfManaged` class
+  - Update `test_brew_npm_label` test -- change to use a different tool's
+    npm package (or remove if no tools use brew_npm)
+- **`tests/test_operations.py`**: Change `TestRemoveToolSelfManaged` to test
+  script-based removal instead
+- **`tests/test_versions.py`**: Remove `TestFormatCheckBackendSelfManaged`;
+  optionally add a test that `script` maps to `script-url`
+
+### 9. `README.md` -- update table
+
+Change Claude's install type from `Self-managed (npm)` to `Script`.
+
+## Verification
+
+1. `uv run pytest tests/ -v` -- all tests pass
+2. `uv run python -m code_aide status` -- Claude shows as installed, method
+   shows `script`
+3. `uv run python -m code_aide list` -- Claude listed with script install
+   type
+4. `uv run python -m code_aide update-versions -n` -- Claude checked via
+   script-url backend, SHA256 verified
+5. Manually verify detection: `claude` resolves to `~/.local/bin/claude`
+   with realpath `~/.local/share/claude/versions/...`, detected as `script`
+   method

{code_aide-1.4.2 → code_aide-1.5.0}/src/code_aide/__init__.py

@@ -1,3 +1,3 @@
 """code-aide - Manage AI coding CLI tools."""
 
-__version__ = "1.4.2"
+__version__ = "1.5.0"

{code_aide-1.4.2 → code_aide-1.5.0}/src/code_aide/commands_actions.py

@@ -256,7 +256,7 @@ def cmd_update_versions(args: argparse.Namespace) -> None:
         tool_config = tools[name]
         install_type = tool_config["install_type"]
 
-        if install_type in ("npm", "self_managed"):
+        if install_type == "npm":
             results.append(check_npm_tool(name, tool_config, args.verbose))
         elif install_type in ("script", "direct_download"):
             results.append(check_script_tool(name, tool_config, args.verbose))

{code_aide-1.4.2 → code_aide-1.5.0}/src/code_aide/data/tools.json

@@ -28,21 +28,16 @@
     "claude": {
       "name": "Claude CLI (Claude Code)",
       "command": "claude",
-      "install_type": "self_managed",
-      "npm_package": "@anthropic-ai/claude-code",
-      "upgrade_command": [
-        "claude",
-        "upgrade"
-      ],
-      "prerequisites": [
-        "npm"
-      ],
+      "install_type": "script",
+      "install_url": "https://claude.ai/install.sh",
+      "install_sha256": "431889ac7d056f636aaf5b71524666d04c89c45560f80329940846479d484778",
+      "prerequisites": [],
       "min_node_version": null,
       "next_steps": "Run 'claude' and then use '/login' to authenticate",
       "version_args": [
         "--version"
       ],
-      "docs_url": "https://docs.anthropic.com/en/docs/build-with-claude/claude-code",
+      "docs_url": "https://code.claude.com/docs/en/setup",
       "default_install": true,
       "latest_version": "2.1.63",
       "latest_date": "2026-02-28"

{code_aide-1.4.2 → code_aide-1.5.0}/src/code_aide/detection.py

@@ -32,6 +32,9 @@ def detect_install_method(tool_name: str) -> Dict[str, Optional[str]]:
     if caskroom_match:
         return {"method": "brew_cask", "detail": caskroom_match.group(1)}
 
+    if "/.local/share/claude/versions/" in real_path:
+        return {"method": "script", "detail": "native installer"}
+
     if "/node_modules/" in real_path:
         npm_package = tool_config.get("npm_package")
         if not npm_package:
@@ -180,8 +183,6 @@ def format_install_method(method: Optional[str], detail: Optional[str]) -> str:
         return "script"
     if method == "direct_download":
         return "direct download"
-    if method == "self_managed":
-        return "self-managed"
     if method:
         return method
     return "unknown"

{code_aide-1.4.2 → code_aide-1.5.0}/src/code_aide/install.py

@@ -286,20 +286,6 @@ def install_tool(tool_name: str, dryrun: bool = False) -> bool:
             else:
                 return False
 
-        elif install_type == "self_managed":
-            npm_package = tool_config.get("npm_package")
-            if not npm_package:
-                error(f"No npm package configured for {tool_config['name']}")
-                return False
-            if dryrun:
-                info(f"[DRYRUN] Would install npm package: {npm_package}")
-            else:
-                run_command(["npm", "install", "-g", npm_package], check=True)
-                success(f"{tool_config['name']} installed successfully")
-                info(tool_config["next_steps"])
-                if "docs_url" in tool_config:
-                    info(f"Documentation: {tool_config['docs_url']}")
-
         return True
 
     except subprocess.CalledProcessError as exc:

{code_aide-1.4.2 → code_aide-1.5.0}/src/code_aide/operations.py

@@ -62,14 +62,6 @@ def upgrade_tool(tool_name: str) -> bool:
             if not install_direct_download(tool_name, tool_config):
                 return False
 
-        elif method == "self_managed":
-            upgrade_cmd = tool_config.get("upgrade_command")
-            if not upgrade_cmd:
-                error(f"No upgrade_command configured for {tool_config['name']}")
-                return False
-            run_command(upgrade_cmd, check=True, capture=False)
-            success(f"{tool_config['name']} upgraded successfully")
-
         elif method == "system":
             error(
                 f"{tool_config['name']} is managed by the system package manager. "
@@ -157,6 +149,12 @@ def remove_tool(tool_name: str) -> bool:
                 warning(f"Could not find {command} binary to remove")
                 return True
 
+            if tool_name == "claude":
+                claude_data = os.path.expanduser("~/.local/share/claude")
+                if os.path.isdir(claude_data):
+                    shutil.rmtree(claude_data)
+                    info(f"Removed data directory: {claude_data}")
+
         elif method == "direct_download":
             bin_dir = os.path.expanduser(tool_config.get("bin_dir", "~/.local/bin"))
             removed_links = set()
@@ -200,35 +198,6 @@ def remove_tool(tool_name: str) -> bool:
 
             success(f"{tool_config['name']} removed successfully")
 
-        elif method == "self_managed":
-            command = tool_config["command"]
-            command_path = shutil.which(command)
-            removed_any = False
-            if command_path:
-                real_path = os.path.realpath(command_path)
-                remove_paths = [command_path]
-                if real_path != command_path:
-                    remove_paths.append(real_path)
-
-                for path in remove_paths:
-                    if not os.path.lexists(path):
-                        continue
-                    is_link = os.path.islink(path)
-                    if os.path.isdir(path) and not is_link:
-                        shutil.rmtree(path)
-                    else:
-                        os.remove(path)
-                    if is_link:
-                        info(f"Removed symlink: {path}")
-                    else:
-                        info(f"Removed: {path}")
-                    removed_any = True
-
-            if removed_any:
-                success(f"{tool_config['name']} removed successfully")
-            else:
-                warning(f"Could not find {command} binary to remove")
-
         elif method == "system":
             error(
                 f"{tool_config['name']} is managed by the system package manager. "

{code_aide-1.4.2 → code_aide-1.5.0}/src/code_aide/versions.py

@@ -273,8 +273,6 @@ def format_check_backend(check_type: str) -> str:
         return "npm-registry"
     if check_type in ("script", "direct_download"):
         return "script-url"
-    if check_type == "self_managed":
-        return "npm-registry"
     return check_type
 
 

{code_aide-1.4.2 → code_aide-1.5.0}/tests/test_config.py

@@ -102,7 +102,7 @@ class TestMergeCachedOverBundled(unittest.TestCase):
                 tools = code_aide_config.load_tools_config()
                 self.assertEqual(tools["claude"]["latest_version"], "99.0.0")
                 self.assertEqual(tools["claude"]["latest_date"], "2099-01-01")
-                self.assertEqual(tools["claude"]["install_type"], "self_managed")
+                self.assertEqual(tools["claude"]["install_type"], "script")
 
 
 if __name__ == "__main__":

code_aide-1.5.0/tests/test_constants.py

@@ -0,0 +1,21 @@
+"""Unit tests for shared CLI constants."""
+
+import unittest
+
+from code_aide import constants as cli_constants
+
+
+class TestClaudeScriptConfig(unittest.TestCase):
+    """Tests for claude tool config expectations."""
+
+    def test_claude_install_type_is_script(self):
+        self.assertEqual(cli_constants.TOOLS["claude"]["install_type"], "script")
+
+    def test_claude_has_no_prerequisites(self):
+        self.assertEqual(cli_constants.TOOLS["claude"].get("prerequisites", []), [])
+
+    def test_claude_has_install_url(self):
+        self.assertIn("install_url", cli_constants.TOOLS["claude"])
+
+    def test_claude_has_install_sha256(self):
+        self.assertIn("install_sha256", cli_constants.TOOLS["claude"])

{code_aide-1.4.2 → code_aide-1.5.0}/tests/test_detection.py

@@ -11,10 +11,8 @@ class TestFormatInstallMethod(unittest.TestCase):
 
     def test_brew_npm_label(self):
         self.assertEqual(
-            cli_detection.format_install_method(
-                "brew_npm", "@anthropic-ai/claude-code"
-            ),
-            "Homebrew prefix npm-global (@anthropic-ai/claude-code)",
+            cli_detection.format_install_method("brew_npm", "@google/gemini-cli"),
+            "Homebrew prefix npm-global (@google/gemini-cli)",
         )
 
     def test_brew_formula_label(self):
@@ -35,28 +33,28 @@ class TestDetectInstallMethod(unittest.TestCase):
 
     @mock.patch.object(cli_detection.os.path, "realpath")
     @mock.patch.object(cli_detection.shutil, "which")
-    def test_detects_brew_npm_wrapper(self, mock_which, mock_realpath):
-        mock_which.return_value = "/opt/homebrew/bin/claude"
+    def test_detects_native_installer(self, mock_which, mock_realpath):
+        mock_which.return_value = "/Users/test/.local/bin/claude"
         mock_realpath.return_value = (
-            "/opt/homebrew/lib/node_modules/@anthropic-ai/claude-code/cli.js"
+            "/Users/test/.local/share/claude/versions/2.1.63/claude"
         )
 
         self.assertEqual(
             cli_detection.detect_install_method("claude"),
-            {"method": "brew_npm", "detail": "@anthropic-ai/claude-code"},
+            {"method": "script", "detail": "native installer"},
         )
 
     @mock.patch.object(cli_detection.os.path, "realpath")
     @mock.patch.object(cli_detection.shutil, "which")
-    def test_detects_plain_npm_global(self, mock_which, mock_realpath):
-        mock_which.return_value = "/Users/test/.local/bin/claude"
+    def test_detects_npm_global_gemini(self, mock_which, mock_realpath):
+        mock_which.return_value = "/Users/test/.local/bin/gemini"
         mock_realpath.return_value = (
-            "/Users/test/.local/lib/node_modules/" "@anthropic-ai/claude-code/cli.js"
+            "/Users/test/.local/lib/node_modules/@google/gemini-cli/cli.js"
         )
 
         self.assertEqual(
-            cli_detection.detect_install_method("claude"),
-            {"method": "npm", "detail": "@anthropic-ai/claude-code"},
+            cli_detection.detect_install_method("gemini"),
+            {"method": "npm", "detail": "@google/gemini-cli"},
         )
 
     @mock.patch.object(cli_detection.os.path, "realpath")
@@ -108,11 +106,11 @@ class TestFormatInstallMethodDirectDownload(unittest.TestCase):
         )
 
 
-class TestFormatInstallMethodSelfManaged(unittest.TestCase):
-    """Tests for format_install_method with self_managed method."""
+class TestFormatInstallMethodScript(unittest.TestCase):
+    """Tests for format_install_method with script method."""
 
-    def test_self_managed_label(self):
+    def test_script_label(self):
         self.assertEqual(
-            cli_detection.format_install_method("self_managed", None),
-            "self-managed",
+            cli_detection.format_install_method("script", None),
+            "script",
         )

{code_aide-1.4.2 → code_aide-1.5.0}/tests/test_operations.py

@@ -70,21 +70,22 @@ class TestRemoveToolDirectDownload(unittest.TestCase):
             self.assertFalse(os.path.exists(os.path.join(versions_dir, "2.0.0")))
 
 
-class TestRemoveToolSelfManaged(unittest.TestCase):
-    """Tests for remove_tool with self_managed install method."""
+class TestRemoveToolScript(unittest.TestCase):
+    """Tests for remove_tool with script install method."""
 
-    def test_removes_non_symlink_binary(self):
+    def test_removes_binary(self):
         with tempfile.TemporaryDirectory() as td:
-            binary_path = os.path.join(td, "claude")
+            binary_path = os.path.join(td, "amp")
             with open(binary_path, "w", encoding="utf-8") as f:
                 f.write("#!/bin/sh\n")
             os.chmod(binary_path, 0o755)
 
-            tool_name = "self-managed-test"
+            tool_name = "script-test"
             tool_config = {
-                "name": "Self Managed Test",
-                "command": "claude",
-                "install_type": "self_managed",
+                "name": "Script Test",
+                "command": "amp",
+                "install_type": "script",
+                "install_url": "https://example.com/install.sh",
             }
 
             with (
@@ -96,7 +97,7 @@ class TestRemoveToolSelfManaged(unittest.TestCase):
                     cli_operations,
                     "detect_install_method",
                     return_value={
-                        "method": "self_managed",
+                        "method": "script",
                         "detail": None,
                     },
                 ),

{code_aide-1.4.2 → code_aide-1.5.0}/tests/test_versions.py

@@ -238,16 +238,6 @@ class TestFormatCheckBackend(unittest.TestCase):
         self.assertEqual(cli_versions.format_check_backend("custom"), "custom")
 
 
-class TestFormatCheckBackendSelfManaged(unittest.TestCase):
-    """Tests for format_check_backend with self_managed type."""
-
-    def test_self_managed_uses_npm_registry(self):
-        self.assertEqual(
-            cli_versions.format_check_backend("self_managed"),
-            "npm-registry",
-        )
-
-
 class TestExtractScriptDate(unittest.TestCase):
     """Tests for extract_script_date."""
 

code_aide-1.4.2/tests/test_constants.py

@@ -1,13 +0,0 @@
-"""Unit tests for shared CLI constants."""
-
-import unittest
-
-from code_aide import constants as cli_constants
-
-
-class TestSelfManagedConfig(unittest.TestCase):
-    """Tests for self-managed tool config expectations."""
-
-    def test_claude_install_still_requires_npm(self):
-        self.assertEqual(cli_constants.TOOLS["claude"]["install_type"], "self_managed")
-        self.assertIn("npm", cli_constants.TOOLS["claude"].get("prerequisites", []))