# Hephaestus Network

Use when the user types $hephaestus-network, /hep-network, or /agentlas-network...

- Repository: https://github.com/agentlas-ai/Agentlas-OS (1593 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-network -g -a claude-code -y`
Codex: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-network -g -a codex -y`
Cursor: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-network -g -a cursor -y`
Gemini CLI: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-network -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add agentlas-ai/Agentlas-OS`

## Description

Use when the user types $hephaestus-network, /hep-network, or /agentlas-network, mentions @Hephaestus, or asks Agentlas to staff a durable goal from registered Local, owner Cloud, and public Hub agents or teams. The active host LLM staffs each turn; the exact roster remains goal-bound until explicit completion.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Hephaestus Agent Workforce Network

<!-- prompt-module: {"id":"skill.network.host-execution","revision":2,"stability":"fixed-policy","changeTriggers":["release"],"order":0} -->

The active host LLM staffs the task. Agentlas Core federates content menus from
registered Local, owner Cloud, and public Hub inventory. No source and no
deterministic layer is the decision-maker or a server-side LLM executor.

Source scopes are exact:

- `network`: Local + Cloud + Hub;
- `local`: registered Local packages only;
- `cloud`: the signed-in owner's Cloud packages only;
- `hub`: public Hub packages only.

Before an unpinned search uses the Local source, Core refreshes every active
registered source folder and creates a new immutable release when its safe
content snapshot changed. This is discovery freshness; a prepared or
goal-bound roster remains pinned to its exact release. `network reindex` is a
rebuildable card-cache operation and is not required to refresh a registered
Local release. New folders still require explicit `local-register`.

Public demos and distribution proof use explicit `hub` scope. They must not use
private Local/Cloud inventory as evidence of public availability.

## Resolve the runner and sign in

Network can query owner Cloud and public Hub inventory, so establish the same
saved Agentlas session before staffing:

```bash
RUNNER=""
for c in \
  "$HOME/.agentlas/runtime/current/bin/hephaestus" \
  ./bin/hephaestus
do [ -x "$c" ] && RUNNER="$c" && break; done
if [ -z "$RUNNER" ]; then
  for cache in \
    "$HOME/.claude/plugins/cache/agentlas-core-engine/hephaestus" \
    "$HOME/.codex/plugins/cache/agentlas-core-engine/hephaestus"; do
    newest="$(ls -d "$cache"/*/bin/hephaestus 2>/dev/null | sort -V | tail -1)"
    [ -n "$newest" ] && [ -x "$newest" ] && RUNNER="$newest" && break
  done
fi
if [ -n "$RUNNER" ] && [ "${HEPHAESTUS_AUTH_AUTOPOPUP:-1}" != "0" ]; then
  "$RUNNER" auth ensure >/dev/null 2>&1 || true
fi
```

The rest: https://github.com/agentlas-ai/Agentlas-OS/blob/HEAD/.agents/skills/hephaestus-network/SKILL.md