██╗   ██╗ ██████╗ ██████╗  █████╗  ██████╗ ██████╗ ██████╗ ███████╗
╚██╗ ██╔╝██╔═══██╗██╔══██╗██╔══██╗██╔════╝██╔═══██╗██╔══██╗██╔════╝
 ╚████╔╝ ██║   ██║██║  ██║███████║██║     ██║   ██║██║  ██║█████╗
  ╚██╔╝  ██║   ██║██║  ██║██╔══██║██║     ██║   ██║██║  ██║██╔══╝
   ██║   ╚██████╔╝██████╔╝██║  ██║╚██████╗╚██████╔╝██████╔╝███████╗
   ╚═╝    ╚═════╝ ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝

The assistant that actually
does your busywork.

Clears your inbox. Watches your calendar. Chases the thing you forgot. You just message it in Slack, like a colleague — it remembers you, and it gets better every week.

Private and yours: it runs on a little server you control, powered by the Claude subscription you may already have. Free & open source.

Set it up in minutes For the techies: GitHub →
Slack — you & your assistant WORKING
you › morning — anything I need to know today?
yoda › 3 things: your 9:30 moved to 11, the venue emailed back (they can do the 14th), and that invoice from Friday is still unpaid — want me to chase it?
you › yes chase it, politely. and book the 14th
yoda › ⚙ drafting email · updating calendar…
yoda › Done — reminder sent, venue confirmed for the 14th, invite updated.
01 / What it does

What it takes off your plate.

No commands to learn. If you can send a Slack message, you can use it.
✉
Clears the busywork
Triage the inbox, draft the replies, chase the invoice, find the attachment — you say it once, it gets done.
tech: Claude Agent SDK: files, shell, web search, browser automation, subagents.
☀
A brief before you’re up
Wake up to a morning summary: today’s meetings, what came in overnight, what needs a decision.
tech: Declarative YAML cron tasks on in-container timers — no host systemd.
◈
Remembers like a colleague
Your preferences, projects, and people carry over. Tell it something once and it stays known.
tech: File-based memory, 4 typed categories, nightly consolidation, FTS5 search.
⚡
Works while you’re away
Hand it a job from your phone and watch progress stream in live. Come back to it finished.
tech: Live-updating placeholder messages, persistent per-thread sessions.
⧉
Speaks your apps
Email, calendar, docs, notes, payments — connect them once and just ask in plain English.
tech: Broker-held OAuth tokens and API keys; the agent never sees credentials.
☗
Improves itself
Do something together once and it can turn the process into a skill it reuses next time.
tech: Opt-in skill & memory reflectors, loop guardrails, nightly skill review.
02 / Autopilot

While you sleep,
it's on shift.

Because it lives on an always-on server, it doesn't just answer — it runs on a schedule. Research every Monday. Prospect outreach drafted every weekday morning. Your inbox swept every hour.

Setting one up is a sentence in Slack — it writes the schedule itself and reports back in the channel you choose.

Slack — scheduling a task
you › every weekday at 9, research 5 new prospects in UK fintech and draft intro emails for me to review
yoda › ⚙ writing cron-tasks/prospect-outreach.yaml…
yoda › Scheduled ✓ — weekdays 09:00. Drafts will land here for your sign-off; nothing sends without you.
Example schedules scheduler running
weekdays · 07:00
Morning brief
Today’s meetings, what came in overnight, and the decisions waiting on you — in Slack before your coffee.
weekdays · 09:00
Prospect outreach
Researches new leads that fit your brief and drafts personalised intros — you review, it never sends alone.
mondays · 08:00
Industry research
Scans the week’s news, competitor moves, and anything naming your market. One digest, links included.
hourly
Inbox sweep
Files the noise, flags what matters, queues unsubscribes — so your inbox stays at a survivable size.
fridays · 16:00
Invoice chaser
Checks what’s still unpaid and drafts polite nudges before the weekend, escalating tone on the third chase.
nightly · 03:00
Memory tidy
Consolidates what it learned this week so next week’s answers get sharper. Housekeeping, self-managed.
tech: declarative YAML in cron-tasks/, systemd OnCalendar syntax, per-task model & effort, optional Slack delivery — see under the hood.
03 / Setup

One installer.
It holds your hand.

You paste three lines and the guided installer does the rest — signs you into Claude, helps you create the Slack app click-by-click, asks what to call your assistant, and starts it up.

A few minutes later, your assistant introduces itself in Slack. No coding. Nothing to configure by hand.

[1]
A small server (~$5/month)
Any cheap cloud server or a spare box at home. It needs to stay on — that’s what lets your assistant work while you sleep.
[2]
A Claude subscription
The AI that powers it — the same one many people already pay for. No extra per-message fees, ever.
[3]
Your Slack
The installer helps you add the bot to your workspace, step by step. It only talks to you.
the whole install — copy & paste
$ git clone https://github.com/ProvanceMedia/yodacode.git
$ cd yodacode
$ ./quickstart.sh
✓ checks your server and installs anything missing
✓ signs you in to Claude from your laptop
✓ asks your assistant’s name — and about you
✓ walks you through the Slack app, click by click
✓ writes all the configuration itself
✓ starts up and introduces your assistant
➜ A few minutes later: say hi to your assistant in Slack.
04 / Your apps

Works with what you already use.

Your inbox, calendar, documents, notes, payments — connect them once and just ask. Want something unusual? Tell the assistant; it figures out how to connect new services itself.

Gmail OAUTH
Google Calendar OAUTH
Google Drive OAUTH
Google Sheets OAUTH
Google Docs OAUTH
Google Contacts OAUTH
Google Tasks OAUTH
YouTube OAUTH
GitHub KEY
Linear KEY
Notion KEY
Todoist KEY
Airtable KEY
HubSpot KEY
Stripe KEY
Gmail OAUTH
Google Calendar OAUTH
Google Drive OAUTH
Google Sheets OAUTH
Google Docs OAUTH
Google Contacts OAUTH
Google Tasks OAUTH
YouTube OAUTH
GitHub KEY
Linear KEY
Notion KEY
Todoist KEY
Airtable KEY
HubSpot KEY
Stripe KEY
Cloudflare KEY
Vercel KEY
Netlify KEY
DigitalOcean KEY
OpenAI KEY
Mistral KEY
Groq KEY
Perplexity KEY
Replicate KEY
ElevenLabs KEY
Brave Search KEY
Firecrawl KEY
Resend KEY
SendGrid KEY
OpenWeatherMap KEY
Cloudflare KEY
Vercel KEY
Netlify KEY
DigitalOcean KEY
OpenAI KEY
Mistral KEY
Groq KEY
Perplexity KEY
Replicate KEY
ElevenLabs KEY
Brave Search KEY
Firecrawl KEY
Resend KEY
SendGrid KEY
OpenWeatherMap KEY
OAUTH = sign in with the service  ·  KEY = paste one code, once — the assistant tells you exactly where to find it
05 / Privacy

Yours. Actually yours.

This isn't an account on someone's platform. It's your assistant, on your server, with your memory files sitting where you can read them.

🔒
Passwords in a vault it can’t open
Your keys and sign-ins are locked in a separate vault. The assistant can use your services but never sees the credentials themselves.
⌂
Nothing exposed to the internet
It connects out to Slack — nothing connects in. There’s no public website, no login page, no open door to your server.
⚭
One person, one server
Not a platform, not multi-tenant, no analytics. Its memory is plain files on your machine — read them, edit them, delete them.
06 / Under the hood

For the technical.

Skip this section entirely if you like — the installer covers everything.

Two Docker containers, de-rooted by default. Your API keys never enter the agent: they live in a separate broker that holds the vault and makes the authenticated calls. The agent runs as an unprivileged user and reaches every API through it.

A prompt injection has nothing to leak — the boundary is enforced by the OS, not by a prompt rule. Slack runs over Socket Mode: outbound HTTPS only, no inbound ports.

Read docs/BROKER.md →
Slack API · Socket Mode
│ real-time events ▼
agent containerunprivileged · no keys
├─ dispatcher · policy + context
├─ claude-runner → Agent SDK query()
└─ scheduler · in-container crons
│ unix socket ▼
broker containerholds the vault 🔒
07 / Questions

Fair questions.

Do I need to be technical?
You need to be able to open a terminal and paste three lines. Everything after that is guided, and day-to-day you just talk to it in Slack. When something needs doing on the server, the assistant tells you exactly what to type.
What does it cost?
The software is free (MIT open source). You pay for a small server (from ~$5/month) and a Claude subscription — which powers it with no extra per-message fees.
Is my data safe?
It runs on your server, not someone else’s platform. Your sign-ins live in a vault the assistant can’t read, and nothing on the server is exposed to the internet.
What if it breaks?
Run yodacode doctor — it diagnoses the setup and suggests fixes. The bot also messages you when an update is available, and updating is one command.
Can it message other people for me?
It’s designed for one person: it replies to you, in your DMs and threads. It can draft emails and messages for your accounts, but you stay in control of what goes out.

Meet your assistant tonight.

Free, open source, and a few minutes from your first hello.

Set it up in minutes Star on GitHub