# Hephaestus Upload

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

- 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-upload -g -a claude-code -y`
Codex: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-upload -g -a codex -y`
Cursor: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-upload -g -a cursor -y`
Gemini CLI: `npx skills add agentlas-ai/Agentlas-OS --skill hephaestus-upload -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add agentlas-ai/Agentlas-OS`

## Description

Use when the user types $hephaestus-upload, /hep-upload, or /agentlas-upload, or asks to upload, publish, or list an Agentlas agent or team. Ask Cloud (private) vs Agentlas Hub (public) FIRST, then publish through the bundled Hephaestus gate.

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

# Hephaestus Upload (Cloud or Agentlas Hub)

Publish a finished Agentlas package. This is a WRITE surface: a Hub upload is
public and other people can borrow it, so the destination question comes before
any packaging or API call.

Upload is deliberately NOT folded into `/hep-network`. Network staffs a roster
(a read), upload publishes an artifact (a write that is hard to take back);
merging them would let "find me an agent" end in an accidental publish.

## 1. Ask the destination first, always

Ask this before anything else, even when the arguments already say upload,
publish, add, Cloud, Hub, or name a target folder:

```text
Cloud에 업로드할까요? 다른 사람들은 볼 수 없어요.
Upload to Cloud? Other people cannot see it.

Agentlas Hub에 업로드할까요? 다른 사람들이 빌려 쓸 수 있어요.
Upload to Agentlas Hub? Other people can borrow it.
```

Do not package, publish, register, add-source, reindex, or call any upload API
until the user answers Cloud or Agentlas Hub. If the destination is answered but
the target folder is ambiguous, ask for the exact agent folder before running
anything.

## 2. Public Hub publishing is free

The public Hub is an agent community. Do not ask for an upload price, invoke a
price-setting tool, or pass the retired `--rent-credits`, `--ingest-credits`, or
`--fork-credits` flags. The CLI rejects those legacy flags. The creator's model
and API prerequisites still belong in the package guide.

## 3. Resolve the runner in this host

Run the preflight inside this host app; never ask the user to open a separate
terminal.

```bash
RUNNER=""
for candidate in "$HOME/.agentlas/runtime/current/bin/hephaestus" "./bin/hephaestus"; do
  [ -x "$candidate" ] && RUNNER="$candidate" && break
done
[ -n "$RUNNER" ] || { echo "Hephaestus runtime not found. Run the installer first." >&2; exit 1; }
```

## 4. Use one immutable upload gate

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