Hero Agent Docs

~4 min read v0.8.0 Platform

Overview #

Hero Agent is Hero Code — the Hero Studios autonomous AI software engineering agent. Describe any project in plain English and the agent designs it, writes real multi-file code into your workspace, and keeps working with a full IDE around it: 27 programming languages with syntax highlighting, right-click 'Ask AI' to explain, fix or improve any code, a real terminal, Git, a debugger, an extensions marketplace and voice input. Work happens in four modes — Chat, Build, Review and Plan — and models come from the seven-slot HERO sequence (NOVA, FORGE, SAGE, LENS, SCRIBE, ATLAS, SWIFT): you pick a specialist, the server resolves that slot to the best available engine, and server-side metering keeps credits truthful. Conversations persist in D1, memories carry context between chats, and 18 built-in skills specialise the agent for Minecraft modding, Blockbench, Godot and more while built-in web search researches docs and errors as it works. v0.8.0 (2026-11-05, stable) is the current release: the browser app at agent.herostudios.dev is live now, and the Windows desktop installer is built locally (0.8.0) but not published yet. Architecture at a glance: a browser UI, a hosted API, a D1 database for conversations, memories and projects, and model providers that receive only the prompt and context for the selected slot — see the Architecture section below.

Every Hero Studios product needs intelligence — and it should come from one place that works today. Hero Code is an autonomous AI software engineering agent: describe a project in plain English and it designs, writes, and debugs real code for you — through the seven-slot HERO sequence or your own provider keys. It is the shared AI backbone of the ecosystem and the developer tool that powers everything else.

Quick start #

  1. Launch in the browser — open agent.herostudios.dev and sign in with your herostudios.dev account if you want cloud sync. No install needed; the Windows desktop installer is built locally (0.8.0) but not published yet.
  2. First run: create a project, then pick a mode in the composer — Chat, Build, Review or Plan.
  3. Choose your slot from the HERO sequence — NOVA for everyday chat, FORGE for building, SAGE for reasoning, LENS for review, SCRIBE for docs, ATLAS for long context, SWIFT for speed.
  4. Describe your project — the agent writes real files that appear in the explorer instantly. Plan mode lays out typed plan cards before a line is written; Build streams typed progress cards while it works.
  5. Work in the IDE: edit with syntax highlighting across 27 languages, run commands in the terminal, use Git and the debugger, and right-click any code to Ask AI to explain, fix or improve it.
  6. Keep your context: the ChatsBar (Ctrl+B) keeps every conversation, Ctrl+N starts a new one, and Ctrl+M opens the Memory Panel to edit, delete, export or opt out of memories.
  7. Follow the interactive tutorial if you are new — it walks from zero to your first AI-built project — then install extra capabilities from the extensions marketplace.

Configuration #

Hero Code configures around your slot and your account: hosted sequence slots work with zero setup, BYOK keys stay under your control, and everything else lives in the consolidated Settings screen.

SettingDefaultDescription
HERO sequence slotNOVAOne of seven specialists — NOVA, FORGE, SAGE, LENS, SCRIBE, ATLAS, SWIFT. The server resolves the slot to the best available engine; no vendor ids appear in the UI.
ModeChatChat, Build, Review or Plan — Plan lays out typed plan cards before work starts; Build streams typed progress cards while files land.
Provider keys (BYOK)User-providedKeys are encrypted at rest (PBKDF2-derived Fernet), sent directly to the provider you chose, and never logged or telemetried.
Telemetry & crash reportsOptionalProgress milestones report only when telemetry is on. Desktop crash reports (stack trace, paths, OS — path redaction planned) upload only from the desktop shell.
Skills18 built-inMinecraft modding, Godot, Blockbench and more — extend Hero Code further via the extensions marketplace.
AccountOptionalSign in with your herostudios.dev account for ecosystem integration and the shared plan.

Architecture #

Four boundaries, nothing more: what runs where, and which side holds your data. Engine-level detail (routing, resolution internals) is documented in a later phase.

BoundaryWhat lives there
Browser UIA React IDE served in your browser — live now at agent.herostudios.dev. The desktop shell wraps the same UI locally; in the browser product your workspace files stay on your machine, not on our servers.
Hosted APIA Cloudflare Workers API handles sign-in, slot resolution, metering, progress milestones and memory CRUD. The server resolves each HERO slot to an engine — vendor mapping never reaches the client.
D1 (cloud database)Conversations, project files, memories and the metering ledger live in D1, tied to your herostudios.dev account. Delete a conversation or a memory and the row is gone.
Model providersFor each call, only the prompt and the context selected for that slot go to the provider. BYOK keys are encrypted at rest and sent directly to the provider — Hero servers never keep them in plain text. Full detail: the Hero Agent privacy notice.

Data categories, retention and controls are covered in full in the Hero Agent privacy notice. Slot-by-slot detail (purpose, tier, context, cost, data, eval) is on the sequence slots page.

Built-in skills (18) #

Skills specialise the agent per domain — loaded from the same catalog the running service serves from /api/v1/skills. The extensions marketplace adds more.

#SkillWhat it covers
1 Minecraft Modding Create, modify and debug Minecraft mods for Fabric, Forge and NeoForge.
2 Minecraft Datapacks Build datapacks with recipes, loot tables and advancements.
3 Minecraft Plugins Develop Bukkit, Paper and Spigot server plugins.
4 Multi-Loader Mods Build mods for Fabric, Forge and NeoForge from one base.
5 MC Commands Master Minecraft commands and scoreboards.
6 Resource Packs Create resource packs with custom textures.
7 Server Admin Set up and manage Minecraft servers.
8 MC Testing Test Minecraft mods with automated frameworks.
9 World Generation Custom world generation with biomes and structures.
10 Blockbench Modeling Create 3D models for Minecraft in Blockbench.
11 Flipbook Textures Create animated flipbook textures for Minecraft.
12 Voxel Art Create voxel and pixel art assets.
13 Mashup Mods Combine multiple modding techniques in one project.
14 Godot Sandbox Build sandbox games with Godot.
15 Godot Survival Build survival games with Godot.
16 Godot Inventory Build inventory systems for Godot.
17 Mod Any Game General game modding techniques that transfer across engines.
18 Platform Build OS Build platform-style applications.

Language support #

The editor ships syntax highlighting for 27 languages — one tokenizer drives both the editor and the minimap. Honest scope: highlighting is the only per-language capability today. There are no per-language language servers, formatters or debug adapters — right-click Ask AI covers completions, fixes and refactors instead.

Language Syntax highlightingLanguage server / completionFormatterDebug adapter
Python ✓ — — —
TypeScript ✓ — — —
JavaScript ✓ — — —
JSON ✓ — — —
Markdown ✓ — — —
Plain text ✓ — — —
Go ✓ — — —
Rust ✓ — — —
C ✓ — — —
C++ ✓ — — —
C# ✓ — — —
Java ✓ — — —
Kotlin ✓ — — —
Swift ✓ — — —
HTML ✓ — — —
CSS ✓ — — —
SCSS ✓ — — —
GraphQL ✓ — — —
YAML ✓ — — —
TOML ✓ — — —
Dockerfile ✓ — — —
.env ✓ — — —
Shell ✓ — — —
PHP ✓ — — —
Ruby ✓ — — —
SQL ✓ — — —
Lua ✓ — — —

27 languages · 1 capability shipped per language (highlighting) · the other columns are honestly empty — Ask AI, not language servers, does completion and fixing today.

Frequently asked questions #

What is Hero Code?
Hero Code is Hero Agent's product name — an autonomous AI software engineering agent that designs, builds and debugs entire projects from a plain-English description, with a full IDE around it.
What is the current version?
0.8.0 — released 2026-11-05 on the stable channel. Every older release stays visible in the changelog and on the releases page as history.
What are the chat modes?
Chat (talk it through), Build (write the files), Review (find problems with scored findings) and Plan (lay out typed plan cards before any code is written). You switch modes in the composer.
Do I need my own API keys?
No. The sequence slots are hosted — NOVA, FORGE, SCRIBE and SWIFT are included on the free plan, metering gates the premium slots. BYOK is optional: if you bring a key it is encrypted at rest and sent directly to your provider, never logged or telemetried.
What do the 18 built-in skills cover?
They specialise the agent for real domains — Minecraft modding, Godot, Blockbench and more — and the extensions marketplace adds more.
Which programming languages are supported?
27 programming languages with syntax highlighting in the editor. The docs language matrix is honest about scope: highlighting ✓; language servers, formatters and per-language debug adapters are not shipped — Ask AI does that work.
What developer tools are built in?
A real terminal, Git, a debugger, right-click 'Ask AI' for explain/fix/improve, voice input, and an extensions marketplace for plugins.
Is it released?
Yes — 0.8.0 is the current release on the stable channel (2026-11-05). The browser app at agent.herostudios.dev is live now and is the supported path today.
Is there a desktop app?
The Windows installer is built locally (0.8.0) but not published yet — there are no public desktop binaries to download today, so use the browser version, which is live now. macOS and Linux installers are planned. The desktop shell wraps the same local app (Python backend plus React IDE).
Does it work with Minecraft?
Yes — it is Minecraft-specialised through built-in skills (Minecraft modding, Blockbench, and Godot for game projects) plus web search, and it is the planned AI backbone for CraftPilot and other Hero Studios products.
How does it relate to the rest of the ecosystem?
It is the shared intelligence layer — CraftPilot's assistant is the first planned consumer, followed by Hero Client and Redstone Debugger AI features.

Compatibility #

PropertyValue
Loader / platformPlatform
Compatible withAll
Latest version0.8.0

Runs live in the browser now (agent.herostudios.dev) with a built-but-unpublished Windows desktop shell. Slot calls resolve server-side; BYOK keys are encrypted at rest and sent straight to your provider. No Minecraft version coupling — game expertise comes from the built-in skills.

Learn more. Step-by-step walkthroughs live in the tutorials, with install guides for every platform and a general guide to configuration. Still stuck? Open the support portal and we'll reply from support@herostudios.dev.