← Home

v1.2.0 CLI native · xAI Grok · your domain

Astray CLI

Full Astray CLI only (Rust). OAuth login, REPL, YOLO agent, skills and MCP. One-liner from your domain.

one-liner · theastraydev.online

curl -fsSL https://theastraydev.online/install.sh | bash

curl / iwr go through theastraydev.online — your installer, native binary, not a shell stub.

step 1

Choose your OS

Auto-detected; switch any time. Install blocks update below.

step 2

Install Astray CLI correctly

Preferred path: one-liner from theastraydev.online. Detects OS/arch and drops astray on PATH.

01Copy the one-liner

02Run it in a terminal

03Verify: astray --version · astray --doctor

Requirements

Linux x86_64 (glibc; OpenSSL 3)
curl (or wget) and bash
Write access to ~/.local/bin (or --prefix)

Quick install (via domain)

bash · curl via theastraydev.online

curl -fsSL https://theastraydev.online/install.sh | bash
# custom prefix
curl -fsSL https://theastraydev.online/install.sh | bash -s -- --prefix "$HOME/.local"

# force reinstall
curl -fsSL https://theastraydev.online/install.sh | bash -s -- --force

Manual install

bash · manual

mkdir -p ~/.local/bin
curl -fsSL https://theastraydev.online/downloads/cli/latest/astray-linux-x86_64 \
  -o ~/.local/bin/astray
chmod +x ~/.local/bin/astray

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

astray --version
astray --doctor
astray --login

After install.sh: astray --version and astray --login. Restart the shell if PATH did not pick up.

Requirements

macOS 12+ (build from source for now)
curl + zsh/bash (stock is fine)
Gatekeeper: xattr -d com.apple.quarantine if needed

Quick install (via domain)

zsh · build from source

# native macOS builds ship soon — build release from source:
# (need Rust: https://rustup.rs)
git clone https://github.com/yourusername/astray-cli.git
cd astray-cli
cargo build --release
mkdir -p ~/.local/bin
cp target/release/astray ~/.local/bin/astray
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
astray --version
astray --doctor
astray --login

Manual install

zsh · note

# Prebuilt macOS binaries are not on the CDN yet.
# Use cargo build --release (above) or run Linux binary via Lima/UTM/Docker.

Prebuilt macOS not on CDN yet. cargo build --release or wait for aarch64/x86_64 builds.

Requirements

Windows 10/11 x64
PowerShell 5+ (or WSL / Git Bash)
Write access to %LOCALAPPDATA%\Astray\bin

Quick install (via domain)

powershell · theastraydev.online

iwr -useb https://theastraydev.online/install.ps1 | iex

Manual install

powershell · manual

$dir = "$env:LOCALAPPDATA\Astray\bin"
New-Item -ItemType Directory -Force -Path $dir | Out-Null
Invoke-WebRequest -Uri "https://theastraydev.online/downloads/cli/latest/astray-windows-x86_64.exe" `
  -OutFile "$dir\astray.exe" -UseBasicParsing
# add $dir to User PATH, open a new terminal
astray --version
astray --doctor
astray --login

WSL / Git Bash

wsl · bash

# inside WSL (Linux binary)
curl -fsSL https://theastraydev.online/install.sh | bashastray --version
astray --doctor
astray --login

PowerShell: iwr … | iex installs astray.exe. Open a new terminal for PATH.

step 3

Using Astray CLI

Full native astray binary. Flags live in astray --help.

01 help / version

Help and version. Start here when a flag is unfamiliar.

shell

astray --help
astray --version

02 login

OAuth sign-in to xAI/Grok (browser + code). Or --login-code / --login-token.

shell

astray --login
# or paste code / token
astray --login-code
astray --login-token

03 REPL

Interactive REPL. -y enables YOLO agent, -m picks model, --ask is one-shot.

shell

astray
astray -y                 # YOLO agent
astray -m grok-4.5        # pick model
astray --ask "whoami"     # one-shot

04 doctor · update

Health-check your install and self-update the native binary from theastraydev.online.

shell

astray --doctor
astray --update
# REPL:
/doctor
/update

05 models / skills / config

List models, skills, MCP; config path; logout.

shell

astray --list-models
astray --list-skills
astray --list-mcp
astray --config
astray --logout

session preview

verify

Verify installer and binary

checksum / source

# installer (always via your domain)
curl -fsSL https://theastraydev.online/install.sh | less

# native linux binary
curl -fsSL https://theastraydev.online/downloads/cli/latest/astray-linux-x86_64 -o astray
chmod +x astray && ./astray --version

# version pin
curl -fsSL https://theastraydev.online/downloads/cli/latest/VERSION

Always fetch install.sh and binaries only from theastraydev.online. Pipe to less before bash if you want. ELF/PE, not a bash stub.

Need a custom workflow packaged as CLI? Send a brief.

Message on Telegram → All projects