hephaestus

Hephaestus

Turn one rough agent idea into an installable Agentlas agent or team repository.

Build one specialist, assemble a multi-agent team, or package an existing Claude/Codex/OpenClaw/Hermes workspace into a public-safe Agentlas repo.

English · 한국어 · 中文 · 日本語 · हिन्दी

Quickstart · Where To Type · Visual Install Guide · What It Builds · Architecture · Compare · Desktop

_{Figure 1. Request shaping, three builders, generated package contracts, memory curation, skill lifecycle, runtime adapters, and sync boundaries.}

---

Quickstart

Use one of these paths on a new computer. Start with a Claude Code or Codex plugin install unless you only want the package files copied into a normal project folder.

Step 0. Fresh macOS check

Claude and Codex plugin marketplace commands use git clone. On a fresh Mac, git requires Apple's Command Line Tools. If you see xcode-select: note: No developer tools were found, run this once:

xcode-select --install

Finish the Apple installer popup, open a new Terminal window, then verify:

git --version

After git --version works, rerun the Claude or Codex plugin install command.

Recommended. One terminal command for all runtimes

Run this from your normal OS terminal. It installs or updates the Claude Code plugin, Codex plugin, and Gemini CLI extension/custom command. It also fixes the common Already added from a different source marketplace conflict by removing the old agentlas-core-engine entry and adding it again from this repo.

curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Hephaestus/v0.2.7/scripts/install-all-runtimes.sh | bash

After it finishes, restart any open Claude Code, Codex, or Gemini sessions. Then use:

Claude Code: /reload-plugins, then /hephaestus ontology
Codex:       /plugins, then /hephaestus ontology
Gemini CLI:  /extensions list or /commands list, then /hephaestus

Use the same command again to update to the packaged ref. To force a different ref:

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

Option A. Claude Code plugin

Open your normal OS terminal, not the Claude chat box, and run:

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

Then open or restart Claude Code in the project you want to work on and type:

/reload-plugins
/hephaestus ontology

If you already installed the old agentlas-meta-agent plugin and Claude says hephaestus is not found, refresh the marketplace and replace the old plugin:

curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Hephaestus/v0.2.7/scripts/install-all-runtimes.sh | bash

/hephaestus ontology opens a local SaaS-style ontology dashboard for the current project. The dashboard has a left navigation rail, an Obsidian-style knowledge graph, source search, a GraphRAG query builder, a Memory Candidate Queue, and copyable commands. It creates these files in that project only:

.agentlas/ontology-inbox/
.agentlas/ontology-sources.json
.agentlas/ontology-runtime.sqlite
.agentlas/ontology-gui/index.html

It does not scan your home folder or sibling projects. Put approved company docs inside .agentlas/ontology-inbox/, then run /hephaestus ontology again to refresh the dashboard.

To create agents or teams after install: