Commands
Every agent command in Kin Browser 1.20.1. Each is also an MCP tool and a cloud API action (POST /api/v1/run/<action>). Add --json for the raw result, --page p2 for another tab, --why "…" to say why.
| Command | How to call it |
|---|---|
open | kin-browser open <url> [--space <name>] [--device mobile|desktop] |
spaces | kin-browser spaces |
state | kin-browser state |
read | kin-browser read |
find | kin-browser find <text> |
wait | kin-browser wait [--text <text>] [--ms <ms>] |
click | kin-browser click <ref> |
look | kin-browser look [text] |
extract | kin-browser extract [text] [--kind tables|lists|grids] [--limit N] [--fields name,price,stock] [--pages N] |
hover | kin-browser hover <ref> |
scroll-to-end | kin-browser scroll-to-end [max scrolls] |
ask-human | kin-browser ask-human <what you need> [--choices "A|B|C"] [--input text|secret] [--wait seconds] [--to "teammate"] |
human-answer | kin-browser human-answer [--wait seconds] |
session | kin-browser session <url> [--ask] |
watch | kin-browser watch <url> (--text <text> [--gone] | --below <n> --match <item> | --above <n> --match <item>) [--every minutes] [--webhook https://…] [--repeat] [--name <name>] |
watches | kin-browser watches |
unwatch | kin-browser unwatch <id> |
network | kin-browser network [text in the address or data] [--limit N] |
recipes | kin-browser recipes |
recipe | kin-browser recipe <name> [param=value …] |
save-recipe | kin-browser save-recipe <name> --description "what it does" [--recording last|<id>] [--params "invoice_no=3,amount=5:Amount"] |
cite | kin-browser cite <text on the page> | cite --ref e12 [--out evidence.jpg] |
changes | kin-browser changes |
fill-form | kin-browser fill-form "Label=value" … [--profile company] (true/false for checkboxes) |
open-many | kin-browser open-many <url> <url> … [--read extract|text|state] [--text <text>] [--fields a,b] |
read-document | kin-browser read-document <path a download returned> [--max chars] |
files | kin-browser files <folder> [--depth 1-3] |
read-file | kin-browser read-file <path> [--max chars] |
save-file | kin-browser save-file <path> --text "…" [--overwrite] |
budget | kin-browser budget [--steps N] [--minutes N] [--sites N] |
note | kin-browser note <text> [--url <site>] |
notes | kin-browser notes [url] |
forget-note | kin-browser forget-note <id> |
expect | kin-browser expect [text] [--gone] [--ref e12 | --role button --name "Save"] [--state visible|hidden|enabled|disabled|checked|unchecked] [--value v] [--url part] [--title part] [--count N] [--timeout ms] |
logs | kin-browser logs [--all] [--kinds error,warning,request,console] [--limit N] |
report | kin-browser report [title] [--steps N] [--to github:owner/repo | gitlab:group/project | jira:PROJ] [--labels bug,qa] |
visual | kin-browser visual <baseline name> [--update] [--threshold 0.5] [--ignore "Updated at|Ad"] [--full-page] |
sweep | kin-browser sweep [url] [--devices phone,tablet,desktop|all] [--sizes 1280x800,…] [--landscape] [--full] [--theme light|dark|both] [--png] [--current] [--wait "text"] [--scale 2] [--emulate] [--browsers chromium,firefox,webkit] [--country SG] |
screens | kin-browser screens [url] [--current] [--full] [--theme both] [--devices …] [--jpeg] every screen size as PNGs, for a manual or a bug report |
crawl | kin-browser crawl <url> [--depth N] [--max pages] [--write-tests kin-tests/] |
annotate | kin-browser annotate <ref> [<ref>…] [--mask e12,e13] [--hide-personal] [--full] [--out file.png] numbered boxes on your tab, for a manual or a bug report |
manual | kin-browser manual [recording id | last] [--recipe name] [--title "…"] [--languages en,ms,zh] [--phone] [--scale 1|2] [--no-pdf] a user guide with pictures |
export-video | kin-browser export-video [recording id | last] [--gif | --webm] [--width 800] [--seconds 1.8] |
repair-recipe | kin-browser repair-recipe <name> --step N --ref eX point a step at what does its job now (a person approves) |
score | kin-browser score [url] performance, accessibility, SEO and best-practice scores, with the change since last time |
profiles | kin-browser profiles the saved form profiles (kin-browser profile add … to make one) |
task | kin-browser task "<goal>" [--url <start>] [--space <name>] [--max-steps N] [--max-minutes N] [--max-usd N] [--max-tokens N] [--model claude-…] [--parallel 3] [--team sales] [--background] Kin Browser's own model does the whole goal and answers with sources |
tasks | kin-browser tasks [id] [--wait N] [--cancel] goal-driven tasks: status, answer, tokens, US$, time and what was saved |
site-memory | kin-browser site-memory [url] what agents learned about a site: layout, sign-in, notes, recipes |
handoff | kin-browser handoff ["reason"] [--to <teammate>] [--wait seconds] a bot check: a person solves it from their phone, then you carry on |
board | kin-browser board [list|add "<title>"|claim [id]|renew <id>|done <id>|fail <id>|release <id>|remove <id>] [--result "…"] [--detail "…"] [--as <name>] [--status open|claimed|done|failed] |
write-test | kin-browser write-test "<the flow, in words>" --url <start> [--name <file-name>] [--fixes N] [--max-usd N] [--out kin-tests] Claude walks it, writes a kin.yaml test, runs and fixes it |
api-contract | kin-browser api-contract record|check <name> [url] the JSON API calls a page makes, as a contract; check finds removed fields, errors and slow endpoints |
load | kin-browser load [test.kin.yaml | --url <address>] [--users 10] [--rounds 1] one journey by up to 20 browsers at once (your own app only) |
a11y-fix | kin-browser a11y-fix [url] [--comment] [--out fixes.md] each accessibility problem with the markup or CSS that fixes it |
dashboard | kin-browser dashboard [list|make <name>|share <name>|unshare <name>|remove <name>] [--jobs "Job one,Job two"] [--title "…"] price and competitor charts over time |
portals | kin-browser portals the Malaysian portal packs (MyInvois, MyTax, SSM, KWSP, PERKESO) and their jobs |
portal | kin-browser portal <pack> <job> [--<param> value …] [--max-usd N] [--background] e.g. portal myinvois status --document INV-1042 |
teach | kin-browser teach start <url> --name <recipe> [--description "…"] | teach stop [--discard] | teach status show Kin Browser a task once; it becomes a recipe |
smart-watch | kin-browser smart-watch [add --name … --urls "u1,u2" --about "what matters" [--every-minutes 360] [--webhook …] [--whatsapp] | run <id> | remove <id>] |
handover | kin-browser handover [pack --goal "…" --note "…" [--close] | take <id> [--as name]] hand work to another agent |
explore | kin-browser explore <url> [--focus "checkout"] [--minutes 20] [--max-usd 2] [--background] an exploratory tester |
browser-matrix | kin-browser browser-matrix <url> [--devices phone,tablet,laptop] [--threshold 1] Chromium vs Firefox vs WebKit |
mock-contract | kin-browser mock-contract <name> the page's API answered from a recorded contract |
price-index | kin-browser price-index [add --name gadgets --items "iPhone 17,Galaxy S26" [--shops "shopee,lazada,tiktok=https://…{q}"] | run --name gadgets | remove --name …] |
grants | kin-browser grants [url …] [--keywords "ICT,export"] [--calendar] [--no-defaults] new grants and incentives |
supplier-check | kin-browser supplier-check "<name>" [--website acme.my] [--ssm-number 2019…] [--background] due diligence on a supplier |
support-draft | kin-browser support-draft "<what the customer wrote>" [--order-url https://portal…] [--ticket 123 --system zendesk] [--background] |
exec-brief | kin-browser exec-brief [--days 7] [--languages en,ms] [--send] [--background] the weekly executive brief |
save-task | kin-browser save-task <task id> <recipe-name> [--description "…"] keep a finished task as a recipe |
schedule-goal | kin-browser schedule-goal "<goal>" [--weekday mon] [--at 09:00] [--every-minutes 360] [--url …] [--max-usd 1] [--webhook https://…] [--whatsapp] [--team sales] a goal on a timing, with what changed |
goals | kin-browser goals [remove|pause|resume|run <id>] scheduled goals and their last runs |
triage-visual | kin-browser triage-visual <name> [--accept-intended] a failed visual check: intended, regression or noise |
region-check | kin-browser region-check <name> <url> [--expect "text"] the page from every fleet machine, by country |
replay | kin-browser replay start|stop|status a picture after each step, for a scrubbable replay in bug reports |
tenders | kin-browser tenders <list page url> […] [--keywords "IT,software"] [--calendar] new tenders, closing dates on the calendar |
invoices | kin-browser invoices [add --name "Vendor" --url https://portal… [--hint "…"] | remove --name … | collect [--month 2026-09] [--match] [--name …]] |
listen | kin-browser listen [add --name brand --urls "u1,u2" [--keywords "a,b"] [--alert-at 3] [--webhook …] [--whatsapp] | run --name brand | remove --name brand] |
enrich-sync | kin-browser enrich-sync [domain …] [--csv accounts.csv] [--system hubspot] [--limit 20] keep CRM company records fresh |
meeting-prep | kin-browser meeting-prep [--hours 24] [--send] [--system google|microsoft] briefs on the outside companies in your next meetings |
a11y | kin-browser a11y |
export-test | kin-browser export-test [recording id | last] [--recipe <name>] [--language typescript|javascript|python] [--out file] |
save-state | kin-browser save-state <name> |
load-state | kin-browser load-state <name> |
reset-state | kin-browser reset-state |
conditions | kin-browser conditions <none|offline|slow-3g|fast-3g> [--latency ms] |
mock | kin-browser mock <part of the address> [--status 200] [--json '{"ok":true}' | --body text] [--type text/plain] [--times N] |
unmock | kin-browser unmock [part of the address] |
perf | kin-browser perf |
compare | kin-browser compare <url A> <url B> [--visual] |
request | kin-browser request <url> [--method GET|POST|PUT|PATCH|DELETE|HEAD] [--json '{…}' | --body text] [--header "Name: value"] |
fake-data | kin-browser fake-data [person|company|address|card] [--country MY|SG|US|GB] [--count N] [--invalid] |
inbox | kin-browser inbox [--to address] [--wait seconds] [--limit N] |
trace | kin-browser trace <start|stop> [name] |
research | kin-browser research <company website or name> [--pages N] |
enrich | kin-browser enrich <company website or name> |
leads | kin-browser leads <directory url> [--pages N] [--fields name,website,category,location,phone,email] [--limit N] |
watch-signals | kin-browser watch-signals <company website> [--kinds hiring,pricing,news,products] [--every minutes] [--webhook https://…] |
watch-new | kin-browser watch-new <list url> [--keywords "software,CRM"] [--name …] [--every minutes] [--webhook https://…] |
track | kin-browser track <name> <url> [url…] [--every minutes] [--webhook https://…] |
seo | kin-browser seo <site url> [--depth N] [--max pages] |
serp | kin-browser serp <query> [--country MY] [--language en] [--engine bing|duckduckgo|google] [--domain yours.com] [--limit N] |
campaign-check | kin-browser campaign-check <landing page url with UTM tags> |
proof | kin-browser proof <text that must show> <url> [url…] [--name …] |
reviews | kin-browser reviews [url] (or the reviews page you have open) |
crm | kin-browser crm <upsertContact|upsertCompany|createDeal|addNote|createTask|attach|find> '{"email":"…"}' [--system hubspot] |
ticket-note | kin-browser ticket-note <ticket id> <text> [--report <report folder>] [--system zendesk|freshdesk|jira|intercom] |
schedule-recipe | kin-browser schedule-recipe <recipe> [--every minutes | --daily HH:MM] [--when always|changed|failed] [--webhook https://…] [--params '{"q":"…"}'] |
monitor | kin-browser monitor <name> (--url <page> --expect "text" | --recipe <name>) [--every minutes] [--webhook https://…] |
lookup | kin-browser lookup <template> <value> (templates --role support lists them) |
as-customer | kin-browser as-customer <url> [--state saved-sign-in] [--device mobile] [--locale ms-MY] [--recipe name] [--country SG] |
batch-status | kin-browser batch-status <id> |
batch-cancel | kin-browser batch-cancel <id> |
digest | kin-browser digest [--hours 24] [--webhook https://…] |
propose | kin-browser propose <title> --text "the draft" [--kind reply|message|post|email] [--url where it goes] |
proposals | kin-browser proposals [pending|approved|rejected|all] |
check-article | kin-browser check-article <help article url> [--product <page it describes>] |
sign-in | kin-browser sign-in [--username name] (on the open login page; uses the vault) |
workspace | kin-browser workspace <sheetsAppend|driveUpload|sendEmail|calendarEvent> --data '{…json…}' [--system google|microsoft] |
plugin | kin-browser plugin <name> <verb> [--args '{…json…}'] |
automate | kin-browser automate <name> --when '{"kind":"webhook"}' --steps '[{"verb":"research","args":{"target":"{{event.body.domain}}"}}]' [--approve] |
automations | kin-browser automations |
unautomate | kin-browser unautomate <id> |
usage | kin-browser usage [--days 30] |
click-at | kin-browser click-at <x> <y> |
type | kin-browser type <ref> <text> |
select | kin-browser select <ref> <value> |
press | kin-browser press <key> |
scroll | kin-browser scroll <up|down> [amount] |
back | kin-browser back |
dialog | kin-browser dialog accept|dismiss [text for a prompt] |
download | kin-browser download <ref> |
pages | kin-browser pages |
close-page | kin-browser close-page [p2] |
close | kin-browser close |
hold | kin-browser hold [your name] |
release | kin-browser release |
For people setting it up
kin-browser start, stop, agents connect, vault, people, sso, connect, profile, proxies, retention, automations, plugins, marketplace, fleet, chat, chrome pair, push fcm, audit verify, crash-reports, update — run kin-browser with no arguments for the full list.