What is Kiln Script?

Mara Velde
Engineering
5 min read

TL;DR: Kiln Script is a small language for writing browser steps that read like instructions. It sits between a plain prompt and full code, for tasks you want to be repeatable.
Prompts are quick to write but can behave differently from one run to the next. Code is predictable but slow to write for every site. Many tasks need something in the middle.
Why a new script format
We wanted steps that a teammate could read without knowing the code behind them, and that an agent could follow the same way every time. Kiln Script keeps each step short and explicit.
One step per line, written as an action and a target.
Plain language targets, like the Sign in button or the search field.
Steps that can fall back to the model when a page changes.
A first script
A script is a list of steps you pass to session.runScript(). Each line opens a page, fills a field or clicks a control, and Roamkiln records the result of every step.
When a step cannot find its target, the agent can look at the page and choose the closest match, then note what it changed so you can update the script.
What to try first
Start with a task you already do by hand every week. Writing it down as a script is usually the fastest way to see which parts can be made repeatable.
Talk to us about Roamkiln for your team
Get started with sessions for your agents
Get in touch
Keep reading

Introducing Vaults in Roamkiln Functions
Mara Velde & Jonah Price
Engineering

What is Agent Passport?
Ilse Moreau
Engineering

How to design long running browser tasks with Roamkiln
Theo Brandt, Nia Okafor & Lena Sato
Engineering

Roamkiln and Keystone: shared sign in for browser agents across every app your team uses
Roamkiln Team
Company
View all blog posts
