Choose an export—or teach a workflow—by what you need to reuse.

Which export or workflow path should I use?

Conversation and trace Markdown

/export captures the messages currently shown in the side panel and records the exporting WebBrain version. It is designed for reading, not for importing back into WebBrain.

/export --traces uses locally recorded traces for the current conversation. It can include prompts, model output, URLs, tool arguments, and tool results. Screenshots are omitted from this Markdown file. If tracing was off when a turn ran, that turn cannot be reconstructed later.

Back up Settings

1. Enter /export --config.
2. Store the downloaded webbrain-config-….json securely.
3. Restore it with /import --file, or paste its JSON after /import.

The snapshot includes portable Settings values. It does not include conversations, traces, schedules, usage counters, accumulated spend, or device-bound Cloud Sync sessions and device IDs.

The schema value identifies compatibility. WebBrain currently exports and accepts webbrain-config/1.

Teach WebBrain a workflow by doing it once

Use Teacher mode when you know the browser steps and want to save them without first asking the agent to complete a traced run. The demonstration is tab-scoped and compiles into the same guarded webbrain-workflow/1 format as /workflow --save.

1. Open the starting page. Use a regular http(s) page and stop any agent run that currently owns the tab.
2. Start teaching. Enter /teach --start <name>. A purple WebBrain Teach indicator appears on the page.
3. Perform the workflow manually. In that tab, make the trusted clicks, complete fields, change checkboxes or radio buttons, submit with Enter, and navigate exactly as the reusable flow should.
4. Check progress when useful. Enter /teach to see the active workflow name and captured action count.
5. Compile and save. Enter /teach --end. Then open /workflow to run, rename, export, or delete the learned workflow.

Capture boundaries

• Only trusted actions in the top-level page are captured; actions performed by WebBrain itself are excluded.
• The session follows navigation in the same tab and records at most 100 normalized actions.
• Teacher mode and automated agent runs cannot own the same tab at the same time. Finish with /teach --end before starting an agent task.
• Unsupported or unsafe targets are skipped. The save result reports warnings and replay still requires an unambiguous semantic match.
• /teach --end closes the temporary teaching session even when compilation cannot produce a workflow, so correct the page or demonstration and start again.

Create from a trace, then move a saved workflow

Teacher mode is the manual-demonstration path. If the agent already completed the task successfully with tracing enabled, save that execution instead:

1. Enable tracing and complete the task successfully.
2. Save it with /workflow --save <name>.
3. Run /workflow to find its ID.
4. Download it with /workflow --export <id>.
5. On another WebBrain installation, use /workflow --import --file.

A portable workflow is not the original trace or teaching session. WebBrain removes old element references, CSS selectors, click coordinates, URL query strings and fragments, and typed field values. Typed values become prompts that are collected locally each time the workflow runs.

The file keeps semantic target descriptions and origin/path scopes so WebBrain can find the current element and fail closed when a match is ambiguous. Normal Act permissions, submission confirmation, and result verification still apply.

Review before sharing

For the complete field-level formats and compatibility rules, see the technical format reference.