Installation¶

Prerequisites¶

Tool	Purpose	macOS	Linux
`bash`	Shell runtime	Pre-installed	Pre-installed
`git`	Clone the library	Pre-installed	`sudo apt install git` / `sudo dnf install git`
`just`	Task runner	`brew install just`	`cargo install just` or prebuilt binary
`yq`	YAML processor	`brew install yq`	`snap install yq` or prebuilt binary
`jq`	JSON processor	`brew install jq`	`sudo apt install jq` / `sudo dnf install jq`

The one-line installer detects missing tools and offers to install them automatically (Homebrew on macOS, package manager on Linux).

One-line Install (Recommended)¶

curl -sSL https://raw.githubusercontent.com/soulcodex/agentic/main/install.sh | bash

Clones the library to ~/.local/share/agentic, installs the agentic CLI to ~/.local/bin, and checks that all prerequisites are present before proceeding.

After installation, ensure ~/.local/bin is in your PATH:

macOS (zsh):

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

Linux (bash):

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

Linux/macOS (fish):

fish_add_path ~/.local/bin

Manual Install¶

Once prerequisites are met:

# 1. Clone the library
git clone https://github.com/soulcodex/agentic ~/agentic-library

# 2. Install the global CLI
cd ~/agentic-library
just install
# Installs to ~/.local/bin — add to PATH if needed (see PATH section above)

Verify Installation¶

agentic --help
agentic list profiles

Update¶

cd ~/.local/share/agentic   # or wherever you cloned the library
git pull origin main

Uninstall¶

agentic uninstall           # remove from ~/.local/bin
agentic uninstall --global  # remove from /usr/local/bin

This removes the CLI binary only. The library directory (~/.local/share/agentic) is preserved — reinstall at any time without re-cloning.

To fully remove agentic:

agentic uninstall
rm -rf ~/.local/share/agentic