Skip to content

Install the GthonrAgents CLI

Install the GthonrAgents CLI to run media and web commands from a terminal, let an agent use the CLI, or start the local MCP server. The binary install does not require Node.js. You will need an GthonrAgents login before running authenticated capabilities.

Environment Installation path
macOS or Linux shell Use the binary install script below
Windows with Git Bash Run the same script inside Git Bash
An environment with Node.js and npm Install @gthonragents/cli globally
Manual installation Choose the matching operating system and architecture

The script detects 64-bit x86 or ARM. It rejects 32-bit systems; the selected platform must also have a matching release asset. The shell examples on this page use macOS, Linux, or Git Bash syntax.

The install script selects the correct binary for macOS, Linux, or Windows through Git Bash:

Terminal window
curl -fsSL https://gthonragents.xyz/install.sh | sh

The default non-root location is ~/.local/bin/gthonragents. The installer updates your shell profile when needed.

If your environment already standardizes on Node.js:

Terminal window
npm install -g @gthonragents/cli

Binary installation is usually faster to start and does not require a Node.js runtime.

Terminal window
gthonragents --version
gthonragents status

The version command confirms that the executable runs. gthonragents status checks account and service state; an unauthenticated result means the binary is installed but login is still required.

Terminal window
gthonragents login
gthonragents status

Complete the browser authorization prompted by gthonragents login, then check status again. See authentication for credential configuration.

Continue with generate and share an image for a first CLI workflow, or MCP setup to connect an agent host.

The CLI checks for updates automatically. To update immediately:

Terminal window
gthonragents update

A newly installed binary may exist before the current shell reloads its profile.

On macOS or Linux:

Terminal window
ls -la ~/.local/bin/gthonragents
export PATH="$HOME/.local/bin:$PATH"
gthonragents status

In Git Bash on Windows, check ~/.local/bin/gthonragents.exe instead. Open a new terminal after the installer changes your profile. If an editor or MCP host still cannot find GthonrAgents, restart that application or configure the executable’s absolute path; its environment can differ from your terminal.

If that file does not exist, review the installer output for /usr/local/bin or a custom GTHONRAGENTS_INSTALL_DIR. If an older npm binary takes precedence, inspect the resolved path:

Terminal window
command -v gthonragents

Use the intended full path or put its directory earlier on PATH.