See It In Action
Light and dark themes — with the built-in multilingual AI-generated UI security warning.
Light mode — dropdown, checkboxes, text field, slider
Dark mode — radio group, number input, dropdown
Stop wasting rounds of chat to collect structured input. One JSON in, one native window, one JSON out — no server, no browser, no loop.
Light and dark themes — with the built-in multilingual AI-generated UI security warning.
Agents asking humans questions one at a time is painfully inefficient.
Agent asks a question → user types → agent asks next question → user types…
10 fields = 10 round-trips. Breaks context windows. Loses state on reconnect.
Agent generates one JSON form spec → user fills everything at once → agent gets all answers in one structured response.
10 fields = 1 round-trip. Works offline. No server required.
Everything an agent needs to gather structured human input.
Text fields, dropdowns, sliders, file pickers, radio groups, checkboxes, markdown, images, cards and more.
UUID-keyed long-lifecycle windows. The same window updates across multiple agent turns — no flicker, no re-spawn.
Dark mode and custom accent colours via theme in the JSON spec.
Auto-close windows after N seconds with timeout. Result status becomes "timeout".
Single static binary. No Node, no Python, no browser engine. Ships as one executable file.
Every window permanently shows an amber AI-generated warning. Cannot be suppressed by the form spec.
Inspired by agent-browser's client-daemon pattern: the window lives, the agent turns are short.
# Turn 1 — opens the window (daemon spawns in background)
echo '{"title":"Wizard 1/3","components":[...]}' | a2n --session abc123
# → {"status":"submitted","values":{...}}
# Turn 2 — same window, new form (no new window spawned)
echo '{"title":"Wizard 2/3","components":[...]}' | a2n --session abc123
# Turn 3 — final step
echo '{"title":"Wizard 3/3","components":[...]}' | a2n --session abc123
# Close the window
a2n --close abc123A minimal JSON contract between agents and native UI renderers.
// Input
{
"title": "Deploy to production",
"timeout": 60,
"theme": { "dark_mode": true, "accent_color": "#6C63FF" },
"components": [
{ "id": "env", "type": "dropdown", "label": "Environment",
"options": [
{ "value": "prod", "label": "Production" },
{ "value": "stag", "label": "Staging" }
]},
{ "id": "ok", "type": "button", "label": "Deploy", "action": "submit" }
]
}
// Output
{ "status": "submitted", "values": { "env": "prod" } }| Component | Output type | Notes |
|---|---|---|
| text-field | string | Single-line text |
| textarea | string | Multi-line text, 4 rows default |
| number-input | number | Drag value with optional min/max/step |
| dropdown | string | ComboBox, value from options list |
| checkbox | boolean | Single toggle |
| checkbox-group | string[] | Multiple selection |
| radio-group | string | Exclusive selection |
| slider | number | Range slider, default 0–100 |
| date-picker | string | YYYY-MM-DD text field |
| time-picker | string | HH:MM text field |
| file-upload | string | Native file dialog; paths joined by ; |
| button | — | submit / cancel / custom actions |
| card | — | Bordered group, nests any components |
| text / markdown / image / divider | — | Display only |
a2native is called by AI agents automatically. Understand the risks.
The banner above appears at the top of every a2native window. It cannot be hidden by the form spec.
A compromised agent could mimic a trusted UI (fake password dialog, fake bank login).
Malicious agents can ask for passwords or API keys and exfiltrate them.
Markdown components allow arbitrary text. Attackers can craft convincing deceptive messages.
Guessable session UUIDs can be exploited by other processes on the same machine.
timeout values.
Never enter passwords or private keys into a2native forms.
Build from source or download a pre-built binary.
# Build from source
git clone https://github.com/a2native/a2native.git
cd a2native
cargo build --release
# One-shot usage
echo '{"components":[{"id":"n","type":"text-field","label":"Name"}]}' | ./target/release/a2n
# Multi-turn session
echo '{"title":"Step 1","components":[...]}' | a2n --session "$(uuidgen)"