Personal assistant example

The daily brief is the simplest example of Okashic working end to end. It runs from your context, through your connections, and lands in your audit log. It works today, so it’s the example we lead with — but it’s just one of many. A weekly report, a routine errand on a site you’ve connected, or a shared list all follow the same path.

What it needs

An agent connected to Okashic — Claude, Hermes, or another agent — with its own API key.
A couple of connections: a calendar (an API connection to Google) and a weather service.
A place for the result to land — a note in your vault, or an App you and your agent share.

How a run goes

Each morning the agent runs the brief as a script rather than figuring it out fresh each time. A script runs the same way every time, so the brief is fast, cheap, and consistent.

The agent calls the calendar connection. The broker applies the Google credential, makes the call, and filters the response down to the fields the task declares — the titles and times, nothing more.
The agent calls the weather service the same way.
The agent writes the brief into your vault — today’s schedule, the forecast, and what needs attention.
Each step writes an entry to the audit log on your device.

What the agent receives

The calendar connection returns only the projected fields, never the credential:

{
  "events": [
    { "title": "Design review", "start": "10:00", "end": "10:45" },
    { "title": "Dentist", "start": "15:30", "end": "16:15" }
  ]
}

What you see afterward

The audit log on your device shows the run, line by line — which agent acted, what it did, and when. The Google token never appears in it.

07:00:02  hermes  calendar.today · google      ok
07:00:03  hermes  weather.forecast             ok
07:00:05  hermes  wiki.write · daily-brief.md   ok

If anything looks wrong, you remove the connection or revoke the agent, and it takes effect immediately.