Agent CLI

Hermes Agent

Run a persistent agent that can use tools and build reusable skills across sessions.

Installation version
2026.8.31
API protocol
Chat Completions
Credentials
Dedicated app key
Setup
Isolated configuration

From install to first prompt

  1. Run the installation command

    Select your system and model. Connect downloads a private runtime and the app’s pinned release.

  2. Connect your account in the browser

    Check the device code and approve a dedicated API key. The installer receives it through an encrypted, single-use connection.

  3. Open your configured app

    Use the launcher path printed in your terminal with run hermes-agent. API key, base URL and model are already set.

CLSSAI Connectv2026.8.31

Install & connect

One command installs the app. Approve in your browser to configure the key, endpoint and model.

Choose a listed model or paste an exact model ID. Browse models
Terminal
curl -fsSL https://clssai.com/install.sh | sh -s -- install hermes-agent --model 'openai/gpt-5.4-nano'

macOS or Linux with Git. Windows: run the Linux command inside WSL. Python is installed privately.

Already installed? What will change?

CLI apps get a private runtime and configuration under ~/.local/share/clssai-connect. Use the printed launcher path to start the configured app. Your global CLI settings stay intact.

Desktop setup merges the CLSSAI provider into ~/.codex/config.toml and saves a backup. Restore with clssai restore codex-desktop using the printed launcher path.

A dedicated API key is created only after browser approval. Manage it in API keys. How Connect works

Setup details

What has been validated?

Installer and configuration checks are documented on the Connect validation page. Desktop execution is not tested. Provider-specific streaming and tool behavior depends on the selected model.

Can I use my existing installation?

CLI setup uses a separate managed copy to preserve your existing tools. For an existing global app, use the manual configuration guide. Codex includes a Desktop configuration mode with automatic backup.

How do I change models or reconnect?

Select another model and run the command again. Each browser approval creates an app key; remove old keys in your workspace when they are no longer needed. Troubleshoot connection errors.