/iblai-install

Install the iblai CLI for scaffolding and managing ibl.ai apps.

Quick Check

iblai --version

If this works, you're all set -- skip to the skill you need.

Option 1: npx (When Published)

npx @iblai/cli --version

This downloads and runs the CLI without a global install. Use npx @iblai/cli as a prefix for any command:

npx @iblai/cli startapp agent
npx @iblai/cli add auth
npx @iblai/cli config show

Option 2: Build from Source

macOS / Linux

Requires: Python 3.11+, pip, git, make

git clone https://github.com/iblai/iblai-app-cli.git
cd iblai-app-cli
make -C .iblai install

Verify:

iblai --version

If the command is not found, add ~/.local/bin to your PATH:

export PATH="$HOME/.local/bin:$PATH"

To make this permanent:

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

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

Then return to your project:

cd -   # back to your project directory

Windows

Requires: Python 3.11+, pip, git

git clone https://github.com/iblai/iblai-app-cli.git
cd iblai-app-cli
pip install -e .iblai/

Verify:

iblai --version

If the command is not found, ensure Python Scripts is in your PATH. It is typically at %APPDATA%\Python\Python311\Scripts\ or %LOCALAPPDATA%\Programs\Python\Python311\Scripts\.

# Check where pip installs scripts
python -m site --user-site
# The Scripts directory is a sibling of the site-packages directory shown

Then return to your project:

cd -

Which Option to Use

Method	When to use
npx @iblai/cli	Easiest, no install needed. Requires npm package to be published.
Build from source	Always works. Gives you the latest version from GitHub.

If npx @iblai/cli returns "not found" or an error, use the build-from-source method.