Install

Install Agentlas OS

One engine, several install paths depending on where you already work.

Paste to install (recommended)

Paste this into the LLM you are already using — Claude Code, Codex, Gemini CLI, Antigravity, or Cursor. It is written so the LLM reading it can verify what it's about to run before running it, rather than being asked to trust a piped command blindly.

I want to install Agentlas OS / Hephaestus from this open-source GitHub repo:
https://github.com/agentlas-ai/Agentlas-OS

Before running anything, fetch and read the installer script so you know what
it does:
https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh

It downloads a release tarball from this same repo's GitHub Releases and
writes files only under ~/.agentlas, ~/.local/bin, and this host's own plugin/
command-adapter directories (e.g. ~/.claude for Claude Code) — nothing outside
those paths. If that matches what you read, run it:
curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh | HEPHAESTUS_INSTALL_GLOBAL_ROUTER=1 bash

HEPHAESTUS_INSTALL_GLOBAL_ROUTER=1 additionally writes a routing block into
this host's global instructions file (e.g. ~/.claude/CLAUDE.md) that lets
substantial tasks be staffed from Agentlas' agent network; it is not secret
and you can read/quote it back to me. Drop that env var if you'd rather skip
it for now — you can add it later with `hephaestus global install`.

Afterwards, show me the installer's own verification output for this host,
and tell me plainly whether `/agentlas build` (or this host's equivalent
command surface) is ready to use, or whether I need to restart the host or
reload plugins first.

One-touch (no LLM handy, any supported host)

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

Installs a neutral runner and registers command adapters for Claude Code, Codex, Gemini CLI, Antigravity, Cursor, OpenCode, OpenClaw, and Hermes, then verifies each surface.

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

Codex plugin

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

NOTE · Run these in your OS terminal

Not inside the Codex app itself — its plugin browser only supports the slash-command form after install.

Terminal (standalone CLI)

npm install -g agentlas

No Desktop required. First run bootstraps its own local database; if Desktop is also installed on the same machine, they share it automatically.

Optional: global router

hephaestus global install

Adds a managed, backed-up block to your Claude/Codex/Antigravity config so those hosts route requests to the right agent by default. Entirely optional — nothing else on this page requires it.