Installation
agsh is written in Rust and builds as a single binary.
Pre-Built Binaries
Download the latest release for your platform from the GitHub Releases page.
| Platform | Archive |
|---|---|
| Linux (x86_64) | agsh-linux-amd64.tar.gz |
| macOS (Apple Silicon) | agsh-macos-arm64.tar.gz |
| Windows (x86_64) | agsh-windows-amd64.zip |
Extract the binary and place it somewhere on your $PATH:
# Linux/macOS
tar -xzf agsh-*.tar.gz
cp agsh ~/.local/bin/
Cargo Install
If you have Rust installed, you can install agsh directly from the Git repository:
cargo install --git https://github.com/k4yt3x/agsh.git
This builds the latest version from source and installs it to ~/.cargo/bin/.
Building from Source
Prerequisites
- Rust (edition 2024, requires Rust 1.85+)
- A C compiler (for the bundled SQLite)
Build
git clone https://github.com/k4yt3x/agsh.git
cd agsh
cargo build --release
The binary will be at target/release/agsh. Copy it somewhere on your $PATH:
cp target/release/agsh ~/.local/bin/
Verify
agsh --version
agsh --help