Haruno Knowledge base

Scheduled tasks

Describe a job once and Haruno does it at the times you pick, in an isolated space. Anything that would reach other people is held for your approval.

  • Mac appAvailable
  • Windows appAvailable

A scheduled task is a job you describe once and Haruno does by itself at the times you choose, such as every weekday at 9:00.

Where it is

Open Scheduled in the sidebar, or press ⌘5. The task list is on the left. The task you pick is on the right.

The list can start with a task that Haruno carries itself, Sync QuickBooks. It is explained on its own page: Scheduled QuickBooks sync. The rest of this page is about the tasks you make.

Only time-based tasks exist today

The screen is called Scheduled. A task starts at a time you pick, never because mail arrives or a meeting starts. A fuller version is built but switched off for every customer. Do not promise it. See Automation triggers.

What the list shows

Each task shows its name, when it runs (for example "Every weekday at 18:00") and what happened last. The last line reads things like Ran 9 times, It hasn't run yet, Running now, Paused or A reply is waiting for you.

A task that needs you, or had a problem, moves to the top. A small number on a task means items from it are waiting for your approval. See The Waiting queue.

When projects are on, a Filter button in the toolbar narrows the list to one project's tasks, to Unassigned ones, or to All projects. A task made inside a project works on that project's sources. See Projects.

Make a task

  1. Start a new task

    Click the + at the top right (New Task). With nothing set up, the screen also offers a New Task button.

  2. Say what Haruno should do

    The sheet is called New Scheduled Task. Give it a Name. Under What Haruno should do, write it the way you would ask a colleague.

  3. Pick when it runs

    Under When, open Start it and choose Every day, Every weekday, Every week, Every month, Every few hours or On a custom schedule…. Then pick the time, the day or the number of hours. A new task starts as every day at 09:00. The sheet repeats your choice in a sentence under Here's what will happen.

  4. Choose what it may touch

    Under What it's allowed to do, pick Read and reply only or Work in this folder too. See the next section.

  5. Turn it on

    Press Turn it on. If you untick Turned on first, the button reads Save and the task waits, paused.

What it's allowed to do

ChoiceWhat it means
Read and reply onlyNothing on your Mac changes. Haruno can still read your connected accounts and the web. This is the starting choice.
Work in this folder tooHaruno can also run commands and change files in one folder you choose with Browse…. That folder is the only part of your Mac it can change.

Under it, a switch reads Let this automation send emails, invitations and cloud changes on its own. It is off. Leave it off and anything that would reach other people is held for you. Turn it on and those things go out while you are away, without your review, and they cannot be recalled. It also stops Haruno asking you to confirm Gmail sends for that task.

Changing what a task does turns it off

If a task can change files or send on its own, and you rewrite what it should do, Haruno does not keep it running. You press Turn it on again. That way you have read the new wording before it runs.

A disclosure called Advanced holds one more switch, Continue the same conversation. By default a scheduled task starts fresh each time. Almost nobody needs to change that.

Open a task

The right side shows the task's name and a switch that reads On or Paused. Under it you see:

  • when it runs, and the next three times;
  • what it may touch, and whether its sends are Shown to you first or it Sends on its own;
  • the Folder it works in, with Show in Finder;
  • the Last run, and Conversation, with Open conversation;
  • who Set up the task, and when.

These buttons sit under that.

ButtonWhat it does
Run it nowRuns the task straight away, outside its schedule.
Try it…Runs it once with nothing allowed to leave your Mac.
EditOpens the same sheet you filled in, titled Edit Scheduled Task.
DuplicateMakes a paused copy named after the task with the word copy added.
DeleteAsks first, and offers Pause instead. Deleting removes the task, its run history, what is waiting from it and its saved conversation files.

To stop a task without losing it, use the On switch. A paused task shows Turn it back on.

Try it…

Try it without sending anything is the way to see a task work once. The sheet says nothing will be sent, even for a task you let send on its own. It takes as long as a real run. When it ends it shows what Haruno would have done. Anything it prepared is held. Show it in Waiting takes you to it. This isn't right — change the settings reopens the task.

Runs and their outcomes

Under Runs, every run is listed newest first, grouped by day. Each row says what the run did in one line, taken from its closing words, for example "Drafted a reply to Priya Raman". A filter shows All, Needs you or Problems. Haruno keeps up to 2,000 runs for each task.

Click a row to open it. You see when it Started, how long it Took, and how long it Waited to start. A problem shows its full message. The row can offer Review what it prepared, Open conversation, Show in Finder, Try again and Copy details.

A run that finished shows no status word. Its one-line summary is enough. The other runs carry one of these words.

Word on a rowWhat happened
Running nowIt is working.
Waiting for youIt prepared something that needs your approval.
Didn't finishIt failed. The row says why.
Skipped — the app was closedHaruno was not open at that time.
Skipped — the last run was still goingAn earlier run had not ended.
Stopped when the app quitHaruno was closed while it ran.

A run that takes longer than 30 minutes is stopped. The row says It took too long and was stopped.

The rules for a run

A scheduled task runs while nobody is watching. So it is held to rules.

  • It works in an isolated space. Every run is isolated, always. It sees only the folder you chose, or nothing on your Mac under Read and reply only.
  • It does not get the connectors you added yourself. Slack, and any other connector you added in Connectors, are not given to a scheduled task. See Connectors.
  • Anything that would reach other people is held. A reply, an email, an invitation, a Discord post and changes to a shared cloud folder wait for you. See The Waiting queue.
  • A task cannot send your data off your Mac another way. If a run tries, for example with an upload, Haruno refuses it. The run ends Didn't finish and says: "It tried to send data off this Mac, and nobody was there to approve it. Run it from a chat to approve the send." In a chat, Haruno asks you first.
  • A task cannot ask you a question. If a run stops to ask one and has prepared nothing, it ends Didn't finish with "It needed an answer and nobody was there."
What to tell a customer

A scheduled task never sends mail or invitations on its own unless the customer turned that on for that one task. By default it prepares them and waits.

When it runs

A task runs while Haruno is running. If the Mac is asleep at the time, Haruno catches up when you come back, and runs the latest missed time once. Earlier missed times are listed as skipped.

To keep tasks running with the window closed, see The Waiting queue.

Who has it and what it needs

Scheduled tasks are in the normal view and the advanced view. A run needs three things.

  • You are signed in. Otherwise the run says "Not signed in to Haruno."
  • Your plan is active and has usage left. Otherwise the run says so, and what to do.
  • Setup has finished. The isolated space downloads after the first launch. Until then the screen shows Haruno needs to finish setting up before it can run things on its own. with a Finish setup button, and a new task is saved paused.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,139 @@
    +---
    +title: Scheduled tasks
    +summary: Describe a job once and Haruno does it at the times you pick, in an isolated space. Anything that would reach other people is held for your approval.
    +feature: scheduled-tasks
    +covers:
    +  - apple/Sources/ScheduledTasksFeature/**
    +  - apple/Sources/ShellAutomations/AutomationsNavigation.swift
    +  - apple/Sources/ShellAutomations/AutomationScratch.swift
    +  - apple/Sources/HarunoShell/ScheduledTasksController.swift
    +  - apple/Sources/HarunoShell/HarunoScheduledRunProvider.swift
    +---
    +
    +A scheduled task is a job you describe once and Haruno does by itself at the times you choose, such as every weekday at 9:00.
    +
    +## Where it is
    +
    +Open <Ui>Scheduled</Ui> in the sidebar, or press **⌘5**. The task list is on the left. The task you pick is on the right.
    +
    +The list can start with a task that Haruno carries itself, **Sync QuickBooks**. It is explained on its own page: [Scheduled QuickBooks sync](/macos/books/scheduled-quickbooks-sync/). The rest of this page is about the tasks you make.
    +
    +<Callout variant="warning" title="Only time-based tasks exist today">
    +The screen is called **Scheduled**. A task starts at a time you pick, never because mail arrives or a meeting starts. A fuller version is built but switched off for every customer. Do not promise it. See [Automation triggers](/macos/in-development/automation-triggers/).
    +</Callout>
    +
    +## What the list shows
    +
    +Each task shows its name, when it runs (for example "Every weekday at 18:00") and what happened last. The last line reads things like **Ran 9 times**, **It hasn't run yet**, **Running now**, **Paused** or **A reply is waiting for you**.
    +
    +A task that needs you, or had a problem, moves to the top. A small number on a task means items from it are waiting for your approval. See [The Waiting queue](/macos/automation/waiting-queue/).
    +
    +When projects are on, a **Filter** button in the toolbar narrows the list to one project's tasks, to **Unassigned** ones, or to **All projects**. A task made inside a project works on that project's sources. See [Projects](/macos/chat/projects/).
    +
    +## Make a task
    +
    +<Steps>
    +<Step title="Start a new task">
    +Click the **+** at the top right (**New Task**). With nothing set up, the screen also offers a **New Task** button.
    +</Step>
    +<Step title="Say what Haruno should do">
    +The sheet is called **New Scheduled Task**. Give it a **Name**. Under **What Haruno should do**, write it the way you would ask a colleague.
    +</Step>
    +<Step title="Pick when it runs">
    +Under **When**, open **Start it** and choose **Every day**, **Every weekday**, **Every week**, **Every month**, **Every few hours** or **On a custom schedule…**. Then pick the time, the day or the number of hours. A new task starts as every day at 09:00. The sheet repeats your choice in a sentence under **Here's what will happen**.
    +</Step>
    +<Step title="Choose what it may touch">
    +Under **What it's allowed to do**, pick **Read and reply only** or **Work in this folder too**. See the next section.
    +</Step>
    +<Step title="Turn it on">
    +Press **Turn it on**. If you untick **Turned on** first, the button reads **Save** and the task waits, paused.
    +</Step>
    +</Steps>
    +
    +### What it's allowed to do
    +
    +| Choice | What it means |
    +|---|---|
    +| **Read and reply only** | Nothing on your Mac changes. Haruno can still read your connected accounts and the web. This is the starting choice. |
    +| **Work in this folder too** | Haruno can also run commands and change files in one folder you choose with **Browse…**. That folder is the only part of your Mac it can change. |
    +
    +Under it, a switch reads **Let this automation send emails, invitations and cloud changes on its own**. It is off. Leave it off and anything that would reach other people is held for you. Turn it on and those things go out while you are away, without your review, and they cannot be recalled. It also stops Haruno asking you to confirm Gmail sends for that task.
    +
    +<Callout variant="info" title="Changing what a task does turns it off">
    +If a task can change files or send on its own, and you rewrite what it should do, Haruno does not keep it running. You press **Turn it on** again. That way you have read the new wording before it runs.
    +</Callout>
    +
    +A disclosure called **Advanced** holds one more switch, **Continue the same conversation**. By default a scheduled task starts fresh each time. Almost nobody needs to change that.
    +
    +## Open a task
    +
    +The right side shows the task's name and a switch that reads **On** or **Paused**. Under it you see:
    +
    +- when it runs, and the next three times;
    +- what it may touch, and whether its sends are **Shown to you first** or it **Sends on its own**;
    +- the **Folder** it works in, with **Show in Finder**;
    +- the **Last run**, and **Conversation**, with **Open conversation**;
    +- who **Set up** the task, and when.
    +
    +These buttons sit under that.
    +
    +| Button | What it does |
    +|---|---|
    +| **Run it now** | Runs the task straight away, outside its schedule. |
    +| **Try it…** | Runs it once with nothing allowed to leave your Mac. |
    +| **Edit** | Opens the same sheet you filled in, titled **Edit Scheduled Task**. |
    +| **Duplicate** | Makes a paused copy named after the task with the word copy added. |
    +| **Delete** | Asks first, and offers **Pause instead**. Deleting removes the task, its run history, what is waiting from it and its saved conversation files. |
    +
    +To stop a task without losing it, use the **On** switch. A paused task shows **Turn it back on**.
    +
    +### Try it…
    +
    +**Try it without sending anything** is the way to see a task work once. The sheet says nothing will be sent, even for a task you let send on its own. It takes as long as a real run. When it ends it shows what Haruno would have done. Anything it prepared is held. **Show it in Waiting** takes you to it. **This isn't right — change the settings** reopens the task.
    +
    +## Runs and their outcomes
    +
    +Under **Runs**, every run is listed newest first, grouped by day. Each row says what the run did in one line, taken from its closing words, for example "Drafted a reply to Priya Raman". A filter shows **All**, **Needs you** or **Problems**. Haruno keeps up to 2,000 runs for each task.
    +
    +Click a row to open it. You see when it **Started**, how long it **Took**, and how long it **Waited** to start. A problem shows its full message. The row can offer **Review what it prepared**, **Open conversation**, **Show in Finder**, **Try again** and **Copy details**.
    +
    +A run that finished shows no status word. Its one-line summary is enough. The other runs carry one of these words.
    +
    +| Word on a row | What happened |
    +|---|---|
    +| **Running now** | It is working. |
    +| **Waiting for you** | It prepared something that needs your approval. |
    +| **Didn't finish** | It failed. The row says why. |
    +| **Skipped — the app was closed** | Haruno was not open at that time. |
    +| **Skipped — the last run was still going** | An earlier run had not ended. |
    +| **Stopped when the app quit** | Haruno was closed while it ran. |
    +
    +A run that takes longer than 30 minutes is stopped. The row says **It took too long and was stopped.**
    +
    +## The rules for a run
    +
    +A scheduled task runs while nobody is watching. So it is held to rules.
    +
    +- **It works in an isolated space.** Every run is isolated, always. It sees only the folder you chose, or nothing on your Mac under **Read and reply only**.
    +- **It does not get the connectors you added yourself.** Slack, and any other connector you added in **Connectors**, are not given to a scheduled task. See [Connectors](/macos/connectors/connectors-window/).
    +- **Anything that would reach other people is held.** A reply, an email, an invitation, a Discord post and changes to a shared cloud folder wait for you. See [The Waiting queue](/macos/automation/waiting-queue/).
    +- **A task cannot send your data off your Mac another way.** If a run tries, for example with an upload, Haruno refuses it. The run ends **Didn't finish** and says: "It tried to send data off this Mac, and nobody was there to approve it. Run it from a chat to approve the send." In a chat, Haruno asks you first.
    +- **A task cannot ask you a question.** If a run stops to ask one and has prepared nothing, it ends **Didn't finish** with "It needed an answer and nobody was there."
    +
    +<Callout variant="tip" title="What to tell a customer">
    +A scheduled task never sends mail or invitations on its own unless the customer turned that on for that one task. By default it prepares them and waits.
    +</Callout>
    +
    +## When it runs
    +
    +A task runs while Haruno is running. If the Mac is asleep at the time, Haruno catches up when you come back, and runs the latest missed time once. Earlier missed times are listed as skipped.
    +
    +To keep tasks running with the window closed, see [The Waiting queue](/macos/automation/waiting-queue/#keeping-haruno-running).
    +
    +## Who has it and what it needs
    +
    +Scheduled tasks are in the normal view and the advanced view. A run needs three things.
    +
    +- You are signed in. Otherwise the run says "Not signed in to Haruno."
    +- Your plan is active and has usage left. Otherwise the run says so, and what to do.
    +- Setup has finished. The isolated space downloads after the first launch. Until then the screen shows **Haruno needs to finish setting up before it can run things on its own.** with a **Finish setup** button, and a new task is saved paused.