ahtml

name	ahtml
description	Use `ahtml` when a semantic `.agent.html` document should be previewed live or exported as an HTML artifact. It fits outputs that need more structure or reviewability than Markdown.

ahtml

Use ahtml to turn semantic .agent.html into a live preview session or an HTML artifact.

Commands

ahtml prompt
ahtml preview artifact.agent.html
ahtml build artifact.agent.html
ahtml inspect --input artifact.agent.html

Syntax

Header:

<meta-agent profile="report-default|ops-compact|review-dense" />

Required root:

page(title*) is required.
page contains top-level blocks: alert, card, separator, table, list, tabs, accordion.

Core blocks:

card(title?) is the main content container.
alert(title? tone?=neutral|danger) -> text
badge(tone?=neutral|success|warning|danger) -> text
progress(value*) -> none
separator -> none

Structured blocks:

list(variant?=ordered|unordered) -> item -> text
table -> row(kind?=header|body) -> cell -> text
tabs(default?) -> tab(value* label*)
accordion -> accordion-item(value* title*)

Field and option blocks:

input(label* value? description?)
textarea(label* value? description?)
checkbox(label* checked?=true|false description?)
switch(label* checked?=true|false description?)
slider(label* value* description?)
radio-group(label* value? description?) -> option(value* label*) -> text
toggle-group(label* value? description?) -> option(value* label*) -> text
select(label* value? description?) -> option(value* label*) -> text
combobox(label* value? description?) -> option(value* label*) -> text

Content rule:

Cards, tabs, and accordion items hold standard content blocks and field/option blocks.
`text` means plain text content, not a <text> tag.
Write text directly inside the allowed parent element.
Do not put bare text directly inside <tab>; wrap tab content in a content block.

Semantic-only boundary:

Do not use class, className, style, Tailwind classes, scripts, event handlers,
shadcn props, Radix props, arbitrary HTML attributes, raw HTML passthrough,
unknown tags, or unknown attrs.

If a nesting or attr detail is unclear, run ahtml prompt or read references/usage.md.

Route

• Install, runtime setup, repair, isolated runtime -> references/install.md
• Command flow, writing, preview, build, inspect -> references/usage.md
• Build, preview, runtime, or environment failures -> references/debug.md
• Reproducible bug reports -> references/bug-reporting.md