mcpField
A
asta-cli

asta-cli

github.com/allenaiDevelopment4261 installsUpdated 1d ago
Repository

About asta-cli

asta-cli is an Agent Skill for installing or updating the `asta` command-line tool, intended for agents that do not install it through a plugin hook. It handles missing or outdated commands and requires Python 3.11+ and uv.

Key features

  1. 01Install or update the `asta` CLI
  2. 02Check command availability and version
  3. 03Install a specified plugin version with uv
  4. 04Guide PATH configuration fixes

Use cases

  1. 01The `asta` command is missing in an agent environment
  2. 02A required subcommand or option is unavailable
  3. 03Troubleshoot PATH when the installed command is not found

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/allenai/asta-plugins --skill asta-cli

After installing, type/asta-cliin Claude Code to confirm it loaded.

Details

From the project README

Asta CLI Installer

Installs the asta CLI for agents that don't install it automatically via a plugin hook.

When to invoke

  • asta is not on PATH (e.g., command -v asta returns nothing, or running asta ... reports "command not found")
  • A subcommand, option, or output field that should exist according to another skill is missing — that signals an outdated install

Install or update

Prerequisites: Python 3.11+ and uv.

PLUGIN_VERSION=0.120.0
INSTALL_URL="git+https://github.com/allenai/asta-plugins.git@v$PLUGIN_VERSION"

if ! command -v asta &> /dev/null; then
  echo "📦 Installing Asta CLI $PLUGIN_VERSION..."
  uv tool install "$INSTALL_URL"
else
  CLI_VERSION=$(asta --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')
  if [ "$CLI_VERSION" != "$PLUGIN_VERSION" ]; then
    echo "🔄 Updating Asta CLI from $CLI_VERSION to $PLUGIN_VERSION..."
    uv tool install --force "$INSTALL_URL"
  fi
fi

If asta is still not on PATH after install, run uv tool update-shell (or open a new shell) so ~/.local/bin is on PATH.

After install

Re-run the original command. If it still fails, the problem is not the CLI version — surface the actual error to the user instead of reinstalling again.

Comments

Markdown supported