Installation & Setup

Agento is distributed as a standalone, self-contained binary with zero external runtime dependencies.

Quick Install

bash / Linux

$curl -fsSL https://releases.agento.dev/install.sh | sh

The installer script downloads the official binary for your platform, verifies its integrity, and configures the agento executable in your system $PATH.

Manual Download

You can also download the pre-compiled binary directly from the releases portal:

Platform	Architecture	Binary Package
Linux	`x86_64` (amd64)	`agento-linux-x64.tar.gz`
Linux	`aarch64` (arm64)	`agento-linux-arm64.tar.gz`
macOS	Apple Silicon (`arm64`)	`agento-darwin-arm64.tar.gz`
macOS	Intel (`x86_64`)	`agento-darwin-x64.tar.gz`
Windows	`x86_64` (amd64)	`agento-windows-x64.zip`

Extract the archive and move the agento binary to a directory included in your system $PATH (e.g. /usr/local/bin on POSIX systems).

Verifying Installation

Verify that the CLI is accessible by checking the installed version:

agento version

Global Environment Structure

Agento maintains user configuration and session logs in standard platform directories:

Global Config & Plugins: ~/.config/agento/ (or %APPDATA%\agento on Windows)
Local State & Sessions: ~/.local/state/agento/ (or %LOCALAPPDATA%\agento on Windows)
Project Cache & Rules: .agento/ and .linto/ in your repository root

First Boot & Project Launch

Navigate to any Git repository and launch the interactive workspace:

agento

On launch, Agento initializes the session, probes available project build tools, and displays the interactive terminal workspace.