Docs

Writing tasks

Say what you want done and where. Computron works out the clicks.

Name the site

A task starts on a site, so name it: “on GitHub”, “in the Stripe dashboard”, “in Google Cloud”. A service name is enough; Computron looks up where it lives before it opens anything. If it cannot tell which site you mean, it asks.

Set my GitHub avatar to ~/Pictures/me.png
What did Google Cloud bill me this month?
Turn off email notifications for new comments in Linear

Several sites in one message

Name every site in one message. Computron opens them all at once, each in its own tab, and reports back when every one is done.

Check my balance on Stripe and my open pull requests on GitHub

Questions and tasks

A task that needs your account or an action on a site goes to the browser. In the terminal, a question about public information is answered directly, without opening a tab. In browser mode and in the Chrome side panel, every request goes to the browser, so a question that needs no browser is declined in one line (see Modes).

Values and links

Ask for a value and Computron reads it off the page once the task is done. Ask for a link and it copies the link address the way you would, from the right-click menu, and returns it in the answer.

Files

Name a file on your computer to upload it: upload C:\Users\me\Pictures\avatar.png as my avatar. Computron puts the file into the page itself, so no file dialog opens. A path that does not exist is reported before the task starts.

Submitting, posting and deleting

Computron finishes what you asked, including the last click that submits, posts or deletes, without asking “are you sure?”. The one thing it asks before an upload is who can see it, when the form has that choice and you did not say. It never repeats the same irreversible action twice in one task.

To be asked before every irreversible step, run the task with computron run --confirm "…".

When it needs you

Some steps only a person can take: a CAPTCHA, a passkey or hardware-key touch, a code sent to your phone, a “Confirm access” password prompt. Computron stops with one line saying what to do and in which tab, and carries on once you have done it.

Stopping a task

Press Esc Esc to stop the running task. The step in progress finishes, and nothing after it runs.

Repeated tasks

After a task has succeeded twice the same way, the next run replays it without asking a model. To force a fresh run, start the message with /cold; to allow only a replay, use /replay. /tasks lists what has been saved.