Anesis

Command Palette

Search for a command to run...

Installation

Install Anesis from scripts, npm, cargo, or release artifacts

The repository currently exposes four practical installation paths: the Unix shell installer, the PowerShell installer, the npm wrapper package anesis-cli, and a direct cargo install for Rust users (crate name anesis).

Scripts install to ~/.local/binCargo installs to ~/.cargo/binNPM wrapper downloads the platform binary in postinstall

Shell installers

The official installers fetch the latest release binary and drop it on your PATH. This is the recommended path for most users.

Linux and macOS

curl -sSL https://raw.githubusercontent.com/anesis-dev/anesis/main/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/anesis-dev/anesis/main/install.ps1 | iex

On Unix, the installer also detects your login shell (bash, zsh, or fish) and installs its tab completions automatically — no extra step needed.

Install with npm

The npm wrapper package defined in the repository is anesis-cli.

npm install -g anesis-cli

The package downloads the matching Anesis binary during postinstall and then exposes the anesis executable.

Install with cargo

Use cargo when you already have the Rust toolchain and want the CLI directly from crates.io. The crate name is anesis, not anesis-cli.

cargo install anesis

Cargo places the binary into ~/.cargo/bin, so make sure your shell loads that directory.

PATH setup and verification

The Unix installers write the binary to ~/.local/bin. If anesis is not found after install, add that directory to your PATH.

Bash

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Zsh

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Verify the install

anesis --version

Upgrade Anesis

Update the installed CLI binary from the latest GitHub Release.

anesis upgrade

After most commands, Anesis checks for a newer CLI release in the background and prints a short notice when an update is available. Commands that produce --json output, plus this one and anesis completions, skip that check.

Shell completions

Install tab completion for bash, zsh, fish, or PowerShell.

# Example for zsh
anesis completions zsh

# Supported shells:
# bash, zsh, fish, powershell

Manual release artifacts

If you prefer to place the binary yourself, download the archive for your platform from GitHub Releases.

# Linux x86_64
https://github.com/anesis-dev/anesis/releases/latest/download/anesis-linux-x86_64.tar.gz

# Linux ARM64
https://github.com/anesis-dev/anesis/releases/latest/download/anesis-linux-aarch64.tar.gz

# macOS Apple Silicon
https://github.com/anesis-dev/anesis/releases/latest/download/anesis-macos-aarch64.tar.gz

# Windows x86_64
https://github.com/anesis-dev/anesis/releases/latest/download/anesis-windows-x86_64.zip

Endpoint overrides

Environment variables that change which backend and frontend the CLI talks to — useful for self-hosting or local development against the registry.

  • ANESIS_BACKEND_URL — override the registry/API backend (defaults to https://anesis-server.onrender.com).
  • ANESIS_FRONTEND_URL — override the site used for the browser login callback (defaults to https://anesis-dev.vercel.app).
  • ANESIS_TOKEN — a personal access token that replaces the browser login flow entirely; see the AI agents page.
Authentication