Everything you can do with FridayOS
FridayOS is a personal operating layer for your life and work, driven by Friday — a JARVIS-style AI assistant that reads your world, acts on your behalf with your approval, and reshapes itself to fit you. This handbook takes you from first login to power user.
Welcome #
What FridayOS is, and how the pieces fit together.
Friday is the assistant you talk to. FridayOS is the whole system around it: a dashboard, an inbox, your calendar and tasks, your coding sessions, voice and phone calls, and a growing set of connected apps — all in one place, all reachable by just asking Friday in plain language.
The guiding idea is simple: you talk, Friday does the legwork, and nothing irreversible happens without your say-so. Friday reads freely, but every action that changes something — sending a message, editing a doc, scheduling a block — comes back to you as a one-tap proposal first.
One brain
A single assistant behind every surface — chat, voice, mobile, and your other apps all reach the same Friday, with shared memory.
Reads your world
Mail, calendar, tasks, code, and connected tools — Friday sees the context so you don't have to re-explain it.
Shapes to you
Ask it to rearrange your dashboard, recolour the app, or change its tone — no settings maze, no code.
Hosted or self-hosted
There are two ways to run FridayOS, and this handbook covers both:
- Hosted — sign up on the FridayOS site and get your own private instance in minutes. Voice, push, and calls are handled for you. Start free, no card required.
- Self-hosted Coming soon — run FridayOS on your own machine or server under the freeware license. You keep full control of your data; see Self-hosting.
New to this? Start with the hosted trial — it's the fastest way to see what Friday does. You can always move to self-hosting later.
Quick start #
From zero to a working assistant in about five minutes.
- Request access. On the FridayOS site, request a spot (name, email, a short note). FridayOS onboards gradually during early access — once you're admitted we email you a persistent private instance at your own URL and your login. Nothing to install.
- Sign in and set a password. The link in your welcome email opens sign-in with your email filled in — enter the one-time code we send. On first visit you set the one password that works across your dashboard, the mobile apps, and your account page.
- Finish setup. Your account page shows two steps: connect your AI (one of the engines below — a quick, one-time sign-in) and add a calendar in indrajaal. Your apps unlock as soon as both are done, and the checklist ticks itself.
- Say hello. Open the chat and ask Friday something real — "what's on my plate today?", "summarise my unread email". Watch it read your world and come back with proposals.
- Make it yours. Ask it to reshape your dashboard or recolour the app (see Adaptation). This is the moment FridayOS stops feeling generic.
Choosing an AI engine
Friday is powered by your AI subscription — it never resells you tokens. Pick whichever you already pay for:
| Engine | Runs on | Good for |
|---|---|---|
| Claude Default | Your Claude subscription | The default. Strongest all-round tool use and reasoning. |
| Codex | Your ChatGPT subscription | If you live in the OpenAI ecosystem. |
| Google Antigravity | Your Google account | If you prefer Google's models. |
Switch engines any time from your account or by asking Friday. Your usage for the connected engine shows up as a live pill in the app, with a deep link to the provider's own dashboard.
Your account #
One login, one password, everything connected.
Your account page is the control room for the whole system. From it you can:
- Sign in with a real password — one credential works across all your FridayOS surfaces.
- Change your password centrally — update it once and it propagates everywhere.
- Connect your AI — link (or re-link) your Claude / Codex / Google engine. Connecting here propagates the credentials to the rest of your instance automatically.
- Manage your plan — see Plans & billing, or upgrade.
- See your usage and storage — memory, disk, and what's taking space, measured inside your instance, so it goes back down when you delete things.
- Sign in on your iPhone — scan the QR code for each app; the TestFlight install link sits under each code (see Mobile & widgets).
- Link a browser or a coding environment — see Files & browser and Coding sessions.
Tip: connect your AI on the account page first — a lot of Friday's power is gated behind having an engine linked, and the account page is the one place that pushes those credentials across your whole instance.
Put Friday on your tailnet Optional
If you use Tailscale, your instance can join your tailnet as one of your devices. Friday can then see which of your devices are online, drop files onto your phone or laptop with Taildrop, and you can open it at its private tailnet name. Make an auth key at login.tailscale.com/admin/settings/keys and paste it in Friday → Settings → Tailscale. Your account page shows whether it's connected. Nothing else depends on it.
Meet Friday #
How you actually work with the assistant day to day.
Chat & threads
The main way in is chat. Every conversation is a thread that persists across your devices — start something on your laptop, pick it up on your phone. Friday remembers what matters between sessions, so you rarely have to set the scene twice.
Mission Control
Your home screen is Mission Control — a live feed of cards that surface what needs your attention: tasks, calendar, inbox, coding sessions, code changes, and git activity. It's the "what's going on right now" view, and it's fully reorderable (see Adaptation).
Propose-then-approve
This is the heart of how Friday stays safe to trust. Reads happen freely; writes become proposals. When Friday wants to send an email, edit a Notion page, push a change, or schedule a block, it shows you exactly what it will do as an editable proposal. You approve, edit, or decline. Nothing outward-facing happens behind your back.
If an approved action later fails, Friday tells you plainly instead of reporting a false "done" — you always get the true outcome.
Autonomy tiers
As you build trust, you can loosen the leash per class of action. Each kind of action can be set to Auto (just do it), Ask (propose first — the default), or Never. Friday learns from what you routinely approve and can suggest promoting an action to Auto — but you're always in charge of the dial.
Projects #
Keep each project's context to itself — no setup, no modes, no picker to learn.
Every chat starts on your general memory — everything Friday knows about you. Any time, you can scope the conversation to a project just by asking:
From then on, that thread runs in the project's world. The project's own notes take precedence where they conflict with your general memory — but everything the project doesn't override still applies.
How precedence works. Say your general memory has “I write Python.” Add a note to one project — “this one's Rust” — and Friday writes Rust in that project's threads and Python everywhere else. Projects layer on top of your general memory; they don't replace it.
Adding project facts
You build a project's context the same way — by just saying it. Anything you tell Friday “for this project” is saved to the project and follows only its threads; nothing bleeds into the rest of your world.
The idea is that you never manage “project mode” — you promote a conversation by asking, keep giving Friday context in plain language, and each project stays cleanly separate from the others.
Browse your projects
When you want the bird's-eye view, the Projects tab lists your projects and everything filed under each — the threads you've scoped to them and the notes you've added. On web and mobile.
Voice & calls #
Talk to Friday hands-free — and let it call you when it matters.
Talking to Friday
Tap the mic and speak. Friday transcribes what you say, thinks, and replies out loud in a natural, conversational voice — times and lists are spoken cleanly, not read like markup. It's built for the car and the walk between meetings.
Fast Voice
Hosted instances get Fast Voice included: your speech is transcribed on dedicated fast-voice hardware, so it lands in a fraction of a second. There's nothing to switch on — every hosted plan comes with it.
Included, not an add-on. Fast Voice comes with every hosted plan (trial, Pro, and Max). If you self-host, voice runs on your own machine by default — a little slower, but it still works.
Friday can call you
For something genuinely urgent — a failure that needs a decision now, an imminent deadline — Friday can ring your phone as a real incoming call, hands-free. You pick up and talk; the call becomes a normal thread. You decide what's call-worthy: tell Friday "call me for prod outages or flight changes, not routine stuff," and it remembers. Phone calls and push are part of the Push & Calls relay on hosted plans.
Proactivity #
Friday doesn't just wait to be asked.
The best assistant is one that notices things. FridayOS has a proactive layer that watches your world and reaches out when it's useful — never spammy, always something you'd actually want.
The morning brief
Start your day with a brief: today's schedule, what's due, anything that changed overnight, and a scan of your email. It's the first of the built-in flows.
When there's health data, the brief now opens with a quick body & energy read — and flags a real nutrition deficit or a muscle that's still sore — so the day gets planned around how you're actually doing. Only when there's something worth saying; no data, no noise.
Flows
Flows are Friday's proactive routines — scheduled or triggered prompts that run on their own. They live in Settings → Flows and are fully editable: change what the morning brief checks, add your own recurring nudges, or turn any off. No code, just plain-language prompts on a schedule.
Pings & initiative
Beyond schedules, Friday can notice a change to something you recently asked about and offer to help — the "prompt you didn't type." You'll see these on Mission Control and, if it's urgent, as a push or a call. Everything Friday raises this way is fresh and actionable, never stale.
Integrations #
Connect your tools by just asking.
Friday reaches your other apps through connectors. The magic is that you don't configure them by hand — you ask, and Friday walks the setup for you and starts pulling signals.
Say that, and Friday guides you through connecting the app, then starts working with its signals and can surface the updates you care about right on Mission Control. The same pattern works for a whole catalog of tools.
Chat & comms
Slack, Discord — read channels, catch up on threads, and (with approval) send messages as you.
Docs & knowledge
Notion, Google Drive, Gmail — read, search, and propose edits/replies.
Dev & issues
GitHub, Linear, Sentry — track work, read issues and errors, and act with approval.
Bring your own tools
Beyond the built-in list, there's an integrations area (Settings → Integrations) for connecting other services yourself. Many developer tools support an open standard called MCP that Friday speaks — if a tool supports it, you can add it here and Friday can use it. This one's aimed at more technical users; most people never need it.
Writes through any integration follow the same rule as everything else: Friday proposes, you approve. Reading is free; sending, editing, and posting are always confirmed.
Tasks & calendars #
Your schedule and to-dos, understood — not just stored.
FridayOS includes a full tasks-and-calendar layer that Friday reads and reasons over. It understands how your projects and tasks depend on each other, so Friday can tell you not just what's due, but what's actually next and what's blocking what.
Calendars
Connect the calendars you already use — iCloud, Google, and Outlook — plus read-only calendar subscriptions. Friday sees a unified view of your time and can find real availability, propose blocks, and route scheduled work to the right calendar. All times show in your own timezone.
Tasks & reminders
Capture tasks with importance, deadlines, scheduling, recurrence, and steps. On iPhone, tasks sync two-way with Apple Reminders, so what you jot in Reminders shows up for Friday and vice-versa.
Health & Body Stack #
A health & fitness layer on top of Apple Health — so Friday plans around how your body is actually doing.
Body Stack reads the health data you already have and turns it into things Friday can reason over: how recovered you are, how much hard work today can take, where your nutrition is short, and which muscles still need rest. It lives in indrajaal (bundled in every Friday), on the iOS app and the web.
Connect nothing. MacroFactor and Cronometer already write your nutrition — macros and micros — to Apple Health, and Body Stack reads it from there. No CSV, no API keys, no double-logging: your existing nutrition app just shows up.
Body score
One 0–100 read on whether anything's off today, measured against your own 90-day baseline — sleep, HRV, resting heart rate, steps, activity. Not a generic target; your normal.
Energy budget
A readiness band and how many hard / deep-work blocks the day can realistically support. Friday's day-planner respects it — a poor-sleep day gets planned lighter, on purpose.
Nutrition
Per-nutrient adequacy against Daily Values, with real deficits flagged. Pulled automatically from Apple Health — you just eat and log in the app you already use.
Muscle recovery
A recovery-coloured body map — per-muscle % recovered (rested / recovering / sore) — plus a weekly-volume verdict (under, productive, at cap or junk), from your logged workouts.
Where it shows up
On iOS and the web app there's a Health tab — a Volume / Recovery-map toggle plus your score, energy and nutrition cards. And Friday narrates it where it matters: in chat when you ask, and at the top of your morning brief when there's something worth knowing.
Your instance, your health data. Your phone reads Apple Health and sends it to your server and your Friday — it never touches ours. And it's guidance, not medical advice.
Coding sessions #
For the builders — Friday drives your coding agents.
If you use Claude Code sessions, FridayOS connects to them. Friday can search and pull your sessions, leave notes for them, and hand off build tasks with a full brief — decks, code, docs — then keep an eye on progress and report back.
Delegating work
Ask Friday to take on something buildable and it can spin up or drive a coding session toward a concrete goal, checking the output and steering — pausing to ask you whenever a real decision comes up. You approve the hand-off; Friday runs the loop.
Coding-environment hosting is a dedicated capability — you can link your own environment from the account page. Ask Friday or check Plans for what's available on your tier.
Files & browser #
Give Friday things to read, and let it browse the web for you.
Attachments
Drop a file into chat — a PDF, a doc, an image — and Friday reads it. Documents are pulled in as text; images are shown to Friday directly. Ask it to summarise a paper, pull the numbers out of a report, or describe a screenshot.
Your workspace
Friday has its own private, secure workspace where it can save and read files — notes, drafts, downloads. It's a real, lasting file space that stays inside your instance, and Friday can hand a file straight to one of your devices when it's done.
The browser
Friday can read the live web, including pages behind a login. For sites that need you signed in — a university portal, a work dashboard — you log in once through a secure session and Friday reads them for you afterward. Every instance ships with a built-in browser for this, zero-config — and if you self-host you can point Friday at your own (see Bring your own browser below).
Friday won't do the risky part. It reads pages and fills what you ask, but it never enters passwords or card numbers, completes CAPTCHAs, or clicks irreversible buttons without surfacing them to you first.
Bring your own browser Advanced
Friday drives a Chromium over CDP for all its web work — reading sites, the in-app live sign-in, and browser “hands” (click / type / fill forms). The built-in one is the default and needs no setup. If you self-host, you can swap in your own browser — for more resources, or to reuse a profile you’re already logged into.
Security first. --remote-debugging-address=0.0.0.0 hands full, unauthenticated control of that browser to anything that can reach the port. Only ever run it on your tailnet / VPN — never on a public IP.
Start Chromium with remote debugging and a persistent profile (so logins & 2FA survive restarts) — headless or headed, on any box your instance can reach:
chromium --remote-debugging-port=9222 \
--remote-debugging-address=0.0.0.0 \
--user-data-dir=~/friday-browserThen in Friday: Settings → Browser → “Link your own browser (CDP URL)” (the browser_cdp_url setting) pointed at http://<that-box>:9222. It reroutes the whole browser integration — reading the web, the in-app sign-in screencast (the Browser tab), and click/type/forms. Clear the field to fall back to the built-in browser.
Two things to know: browser downloads land on the box running that Chromium (not Friday’s workspace), and your Polymux sessions point at Friday’s browser separately — this setting only moves Friday’s own browser.
Adaptation & theming #
Reshape how FridayOS looks and behaves — just by asking. No settings maze, no code.
This is what makes your FridayOS yours. Everything below is driven by plain-language requests to Friday, and it sticks — your instance stays reshaped across every device.
Recolour the whole app
Ask Friday to change the look and it recolours the entire interface — background, panels, text, borders, and accent — coherently. You can set a single colour or paint a whole mood; Friday works out the matching shades.
Reshape your dashboard
Tell Friday which Mission Control cards matter and it pins, hides, and reorders them for you.
Density, theme, and tone
Go compact or comfortable, force light or dark, and shape how Friday talks — briefer or more detailed, calmer or more direct, more or less proactive.
Custom dashboards
Want a whole page of specific content — a focused view for a project, a morning cockpit? Ask for it and Friday builds you a custom dashboard, separate from the main Mission Control feed.
Let it learn
Opt in and Friday quietly adapts your dashboard over time to what you actually use — a gentle boost to the things you open most. It never overrides your explicit pins and hides, and you can turn it off any time.
Mobile & widgets #
FridayOS in your pocket.
FridayOS installs like a normal app on your phone and works even offline. On iPhone and iPad there are dedicated apps that plug deeper into the system.
Home-screen widgets
Your agenda, tasks, and a "today" glance — every size, updated in the background so the important stuff is on your home screen.
Live Activity
A live glance on the Lock Screen and Dynamic Island for what's happening now.
Siri & Shortcuts
Trigger Friday and your tasks by voice or from a Shortcut, hands-free.
Apple Reminders sync
Two-way sync so Reminders and FridayOS tasks stay in lockstep.
Projects tab
Browse your projects and everything filed under each — the threads you've scoped to them and the notes you've added.
The iOS apps connect to your instance. Install them from TestFlight (the join links are under the QR codes on your account page), then scan the QR code to sign in, with no server URL or password to type. Widgets and the watch share that sign-in. Self-hosting? Enter your server URL once on the connect screen instead.
Privacy & security #
Built so you can actually trust it with your life.
- Your instance is yours. Hosted instances are private to you. Self-hosted, your data never leaves your machine.
- Local-first data. Your tasks and calendar live in a local database and work fully offline; the core never phones home.
- Health data stays on your instance. Your phone reads Apple Health and sends it to your own server and Friday — Body Stack never routes it through us. Guidance, not medical advice.
- Propose-then-approve. Every outward or destructive action is confirmed by you first. Friday reads freely but never sends, posts, deletes, or pays on its own.
- Hard limits. Friday will not enter passwords or payment details, complete CAPTCHAs, or move money — it hands those back to you by design.
- Your own AI. Friday runs on your AI subscription and your connected accounts; there's no middleman reselling your data.
- Honest reporting. If something fails, you're told — no false "done."
Licensing
FridayOS is freeware: free to run on hardware you control, for personal or internal use. It is not open source — you may not redistribute, resell, or reverse-engineer it, or use it to build a competing service. The full terms ship with the software.
Plans & billing #
Start free. Upgrade when you're ready.
| Plan | Price | What you get |
|---|---|---|
| Trial Free | $0 | A persistent private hosted instance, no card required. Fast Voice included. The best way to try FridayOS. |
| Pro | $3/mo | The full hosted assistant for everyday use. Fast Voice (near-instant speech-to-text) included. |
| Max | $5/mo | Everything in Pro with more headroom. Inherits Fast Voice. |
| Push & Calls relay Coming soon | $2/mo | Real push notifications and phone calls to your devices — the hands-free "Friday rings you" experience. |
Fast Voice is included on every hosted plan — trial included. It used to be a separate add-on; now it just comes with hosting.
Manage everything — upgrade or downgrade — from your account page. Self-hosting FridayOS will be free under the freeware license, and is coming soon.
Self-hosting #
Run the whole thing on your own hardware.
Prefer to keep everything on your own box? FridayOS is becoming a free self-host bundle under the freeware license. Polymux is open and downloadable today; the full Friday + indrajaal app is coming soon — get notified from the self-host page. You bring your own AI subscription and your own hardware, and you get the same assistant with full control of your data.
Three ways to run it — and the trade-offs
FridayOS can run in a sealed space we manage, or on your own computer with as much access as you choose to give it. More access means more power and less separation — here's the plain version so you can pick what fits.
Hosted (we run it)
Lives in its own sealed space on our servers, walled off from everything else and from other people. Storage is set by your plan; voice, push, and calls are handled for you. It can't see your computer's files — it's a separate world you reach through the web. Best if you want it to just work, safely, with nothing to manage.
Self-host with Docker
Runs on your own machine in a tidy self-contained package. It uses your computer's own disk — no storage limit beyond the room your machine has — but it only sees the one project folder you point it at; anything outside stays invisible. Best if you want it on your own hardware, still fenced to just the code you choose.
Self-host directly
Runs straight on your machine as you, with access to whatever folders you allow — your whole Documents folder and every repo in it, if you like. The most powerful and least fenced: it can touch your real files the way you can. Best for power users who want the assistant across all their projects.
On access: self-hosting is meant to work with your real machine — that's the point of running it yourself — so it isn't the sealed sandbox the hosted version is. It defaults to your computer only; keep it that way unless you've put your own login in front of it. To let it work on the repos in your Documents folder, just point that folder in when you set it up.
Connect it to your tailnet
FridayOS can join your Tailscale network, so your instance and your devices talk privately over the tailnet with nothing exposed to the public internet. Connect, check status, and disconnect from within the app.
What differs from hosted
- Voice runs on your own machine by default — it still works, just not the near-instant speed hosted plans get.
- Push & phone calls rely on the hosted relay, so those are a hosted-tier convenience.
- Everything else — the assistant, integrations, tasks/calendars, adaptation, the browser — is yours to run.
Not sure which to pick? Trial the hosted version first to learn the ropes, then self-host once you know what you want.
Troubleshooting & FAQ #
Quick answers to the things testers ask most.
Friday says no AI is connected
Head to your account page and connect an engine (Claude, Codex, or Google). Connecting there pushes the credentials across your whole instance. This is the single most common first-run snag.
The mobile app can't reach my instance
On the connect screen, enter your instance's full URL exactly. If you're self-hosting on a tailnet, make sure your phone is on the same tailnet and the instance is connected (see Self-hosting).
Voice feels slow
On hosted plans, Fast Voice is on by default — if it feels slow, it's worth flagging. On self-hosted setups voice runs on your own machine, so it's naturally a bit slower.
Friday didn't do something I asked
Check for a pending proposal — actions that change things wait for your approval. If you want a class of action to run automatically, tell Friday to stop asking about it (see autonomy tiers).
How do I give feedback?
Use the in-app feedback option, or email support (below). As a tester, your feedback directly shapes how FridayOS behaves — it's genuinely wanted.
Still stuck? Email [email protected] — a real person reads it.
Ask-Friday phrasebook #
A menu of things to say. Friday understands plain language — these are just starting points.
| When you want to… | Try saying |
|---|---|
| See your day | "What's on my plate today?" |
| Triage email | "Summarise my unread email and flag anything urgent." |
| Draft a reply | "Draft a reply to the last message from my advisor." |
| Find time | "When's my next free two-hour block this week?" |
| Understand your work | "What's blocking the launch?" |
| Check your body | "How's my recovery today?" or "Am I short on protein this week?" |
| Plan around energy | "I slept badly — plan me a lighter day." |
| Scope a project | "Add this to my Apollo project." or "For this project, deploy to staging first." |
| Connect a tool | "Connect Discord." or "Connect Notion." |
| Recolour the app | "Make the background near-black with a teal accent." |
| Rearrange your home | "Put tasks and calendar at the top, hide the git cards." |
| Change its style | "Be more concise and a bit calmer." |
| Set up a routine | "Give me a morning brief at 7am with my calendar and unread email." |
| Delegate a build | "Spin up a session to build a deck from these notes." |
| Be called back | "Call me when the deploy finishes." |
| Read a file | "Summarise this PDF and pull out the key numbers." |
| Loosen the leash | "Stop asking before adding calendar blocks — just do it." |
Don't memorise these. Just talk to Friday the way you'd talk to a sharp assistant — if it can't do something, it'll tell you.