Documentation

Install Agentlas OS

Choose the installation path for your existing host. Use the installer report and the client's current command or skill list to verify what was installed.

1. Host adapters on macOS or Linux

Run the official installer from an OS terminal. To inspect it first, download the script, open it, then run it after reviewing the changes. It installs a neutral engine and adapters for supported clients found on your machine.

curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh -o agentlas-os-install.sh
bash agentlas-os-install.sh

2. Windows

The host-adapter script uses Bash. Open Git Bash on Windows to run the same commands, or use the official Desktop installer if you want the visual app. A Bash command is not a PowerShell command.

Official Desktop downloads →

3. Claude Code plugin

claude plugin marketplace add https://github.com/agentlas-ai/Agentlas-OS --sparse .claude-plugin claude/plugins
claude plugin install hephaestus@agentlas-core-engine

Use /hep-build or the installed Agentlas entry point after installation. The installer also manages the bare command adapters; a plugin-only installation can expose a namespaced entry instead.

4. Current Codex plugin

codex plugin marketplace add agentlas-ai/Agentlas-OS@v1.2.62
codex plugin add hephaestus@agentlas-core-engine

Run installation commands in your OS terminal. Current Codex uses plugin skills such as $hephaestus-build, $hephaestus-network, and $hephaestus-graph. Custom /prompts:* commands belong to older Codex versions and are not the current entry point. Refresh the plugin list or reload only if the client has not discovered the installed skill.

5. Independent Terminal

npm install -g agentlas
agentlas setup
agentlas doctor
agentlas help

Use Node.js 22.13 or newer. Desktop is not required for direct CLI execution. When both are installed on the same machine they use shared local data; the Terminal still needs its own selected runtime and credentials.

6. Optional global routing

hephaestus global install

This adds a managed routing block to supported host instructions and keeps a backup. It is optional. Inspect the install report for this host and use the commands or skills it actually exposes.

Build an agent after setup →