CLI installation and updating

Author: rodneykinney

.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "asta",
       "source": "./",
       "description": "Paper search, citations, literature reports, and Semantic Scholar API tools",
-      "version": "0.8.0",
+      "version": "0.8.1",
       "author": {
         "name": "AI2 Asta Team"
       },

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "asta",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Asta science tools for Claude Code - paper search, citations, and more",
   "author": {
     "name": "AI2 Asta Team"

DEVELOPER.md

@@ -420,7 +420,7 @@ make version
 ```bash
 make set-version VERSION=x.y.z
 ```
-- Updates all four version locations atomically
+- Updates all locations atomically
 - Fails with error if VERSION parameter is not provided
 - Provides suggested commit command after success
 
@@ -444,7 +444,6 @@ Checking version consistency...
 Error: Version mismatch detected:
   src/asta/__init__.py:              0.3.0
   pyproject.toml:                    0.2.0
-  .claude-plugin/plugin.json:        0.2.0
   .claude-plugin/marketplace.json:   0.2.0
 
 Run 'make set-version VERSION=x.y.z' to sync versions

Makefile

@@ -97,6 +97,10 @@ set-version:
 	uv run python -c "import json; f = open('.claude-plugin/plugin.json', 'r'); data = json.load(f); f.close(); data['version'] = '$(VERSION)'; f = open('.claude-plugin/plugin.json', 'w'); json.dump(data, f, indent=2); f.write('\n'); f.close()"; \
 	echo "Updating .claude-plugin/marketplace.json..."; \
 	uv run python -c "import json; f = open('.claude-plugin/marketplace.json', 'r'); data = json.load(f); f.close(); data['plugins'][0]['version'] = '$(VERSION)'; f = open('.claude-plugin/marketplace.json', 'w'); json.dump(data, f, indent=2); f.write('\n'); f.close()"; \
+	echo "Updating skill installation sections..."; \
+	find skills -name "SKILL.md" -exec sed -i.bak "s/PLUGIN_VERSION=[0-9]*\.[0-9]*\.[0-9]*/PLUGIN_VERSION=$(VERSION)/g" {} \; && find skills -name "*.bak" -delete; \
+	echo "Updating sync-version hook..."; \
+	sed -i.bak "s/PLUGIN_VERSION=[0-9]*\.[0-9]*\.[0-9]*/PLUGIN_VERSION=$(VERSION)/g" hooks/sync-cli-version.sh && rm hooks/sync-cli-version.sh.bak; \
 	echo "Version updated to $(VERSION) in all files"; \
 	echo "Review changes and commit with: git add -A && git commit -m 'chore: bump version to $(VERSION)'"
 

hooks/hooks.json

@@ -7,6 +7,10 @@
           {
             "type": "command",
             "command": "mkdir -p ~/.asta/literature"
+          },
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/sync-cli-version.sh"
           }
         ]
       }

hooks/sync-cli-version.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# Check if asta CLI version matches the plugin version and auto-install/update if needed
+
+PLUGIN_VERSION=0.8.1
+INSTALL_URL="git+https://github.com/allenai/asta-plugins.git@v$PLUGIN_VERSION"
+
+# Check if asta is installed
+if ! command -v asta &> /dev/null; then
+    echo "📦 Installing Asta CLI version $PLUGIN_VERSION..."
+    if uv tool install "$INSTALL_URL"; then
+        echo "✅ Asta CLI $PLUGIN_VERSION installed successfully"
+    else
+        echo "❌ Failed to install Asta CLI"
+        exit 1
+    fi
+    exit 0
+fi
+
+# Get installed CLI version
+CLI_VERSION=$(asta --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')
+
+# Compare versions
+if [ "$CLI_VERSION" != "$PLUGIN_VERSION" ]; then
+    echo "🔄 Updating Asta CLI from $CLI_VERSION to $PLUGIN_VERSION..."
+    if uv tool install --force "$INSTALL_URL"; then
+        echo "✅ Asta CLI updated to $PLUGIN_VERSION successfully"
+    else
+        echo "❌ Failed to update Asta CLI"
+        exit 1
+    fi
+fi

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "asta"
-version = "0.8.0"
+version = "0.8.1"
 description = "Asta CLI for scientific literature review"
 readme = "README.md"
 requires-python = ">=3.11"

skills/experiment/SKILL.md

@@ -7,7 +7,6 @@ allowed-tools:
   - Read(.asta/experiment/*)
   - TaskOutput
 ---
-
 # Run Experiments
 
 Run a computational experiment. Given a research question that can be answered via software,
@@ -17,11 +16,18 @@ This skill can also be used to analyze experimental data and generate a research
 
 ## Installation
 
-If `asta` command is not available install it using `uv tool install git+ssh://git@github.com/allenai/asta-plugins.git`
+This skill requires the `asta` CLI:
+
+```bash
+# Install/reinstall at the correct version
+PLUGIN_VERSION=0.8.1
+if [ "$(asta --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')" != "$PLUGIN_VERSION" ]; then
+  uv tool install --force git+https://github.com/allenai/asta-plugins.git@v$PLUGIN_VERSION
+fi
+```
 
 **Prerequisites:** Python 3.11+ and [uv package manager](https://docs.astral.sh/uv/)
 
-Verify installation with `asta experiment --help`
 
 ## Workflow
 

skills/find-literature/SKILL.md

@@ -10,18 +10,25 @@ allowed-tools:
 
 # Find Literature
 
-Search academic literature for papers relevant to a query. The search will return a ranked list of papers with relevance scores, summaries, and supporting snippets. 
+Search academic literature for papers relevant to a query. The search will return a ranked list of papers with relevance scores, summaries, and supporting snippets.
 
 This is an advanced search, so the query can be long and complex. You may ask the user
 questions to clarify the topic and refine the query before running the search.
 
 ## Installation
 
-If `asta` command is not available install it using `uv tool install git+ssh://git@github.com/allenai/asta-plugins.git`
+This skill requires the `asta` CLI:
+
+```bash
+# Install/reinstall at the correct version
+PLUGIN_VERSION=0.8.1
+if [ "$(asta --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')" != "$PLUGIN_VERSION" ]; then
+  uv tool install --force git+https://github.com/allenai/asta-plugins.git@v$PLUGIN_VERSION
+fi
+```
 
 **Prerequisites:** Python 3.11+ and [uv package manager](https://docs.astral.sh/uv/)
 
-Verify installation with `asta literature --help`
 
 ## Tools Available
 

skills/pdf-extraction/SKILL.md

@@ -15,6 +15,21 @@ allowed-tools:
 
 Extract high-quality text from PDFs using the [olmOCR](https://github.com/allenai/olmOCR) tool. This skill uses the olmocr CLI for cloud-based OCR processing.
 
+## Installation
+
+This skill requires the `asta` CLI:
+
+```bash
+# Install/reinstall at the correct version
+PLUGIN_VERSION=0.8.1
+if [ "$(asta --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')" != "$PLUGIN_VERSION" ]; then
+  uv tool install --force git+https://github.com/allenai/asta-plugins.git@v$PLUGIN_VERSION
+fi
+```
+
+**Prerequisites:** Python 3.11+ and [uv package manager](https://docs.astral.sh/uv/)
+
+
 ## Quick Start
 
 ### Extract Text from PDF