FAQ & help

Everything you'd want to know before depending on Founder OS.

Skip to the section you need, or ctrl-F. If your question isn't here, email support@askkira.com.

Getting started

What is Founder OS?

Founder OS is your personal operations cockpit — a single dashboard that coordinates AI agents working on relationship management, outreach drafting, research, networking, content, partnerships and more. Each agent is a specialist trained on its own domain; together they take care of the operational layer of running a business.

What does each agent do?

Emily (Relationship Manager) keeps your existing relationships warm. Robert (Miner) discovers and verifies new contacts. Dave (Sales Specialist) drafts cold outreach. Curie (Researcher) builds directories from the public web. Peter (Networking) sources events, conferences, NED roles. Iris (PR) sweeps press opportunities. Atlas (Strategic Partnerships) hunts partner organisations. Vincent (Investor & Funding) tracks investor signals. Sarah (Marketing) drafts content. Sage (Personal Dreams) keeps you on the long-arc goals. Hugo (Book Writer) drafts long-form. Cassandra (Competitor Intelligence) watches the market. Echo (Customer Signal) listens for buying intent. Jeremy (Librarian) is the directory keeper everyone else pulls from.

How do I sign in?

One password gates the whole app — set via the FOUNDEROS_PASSWORD environment variable. Five wrong attempts from your IP locks it out for 15 minutes. Sessions last 30 days unless you sign out.

What's the keyboard shortcut to jump around?

Ctrl + K (or Cmd + K on Mac) opens the command palette. Type the first letters of any agent name or page and hit Enter. It's the fastest way to navigate.

Your data and your IP

Where is my data stored?

On disk on the machine running Founder OS, under data/. In production this lives on AWS London (eu-west-2) with at-rest encryption. None of it ever leaves UK jurisdiction.

Are my contacts shared with anyone?

No. Founder OS is a single-user personal cockpit. Your contacts, drafts, pipeline and outcomes are visible only to whoever has your password. There is no analytics export, no sharing layer, no "anonymised insights".

Do you train AI models on my data?

No. Foundation models (Anthropic, Brave Search) are called via API under terms that explicitly prohibit training on your prompts. The text you type is sent only for the purpose of producing the response you asked for.

What happens to recipients of my agent's outreach?

Recipient details are written to disk so the agent can track responses. Anyone can be added to a do-not-contact list at /dnc — once on the DNC, every agent refuses to contact them again. Recipients exercising UK GDPR rights can email dpo@askkira.com.

Day-to-day operation

How do I approve a draft before it sends?

Drafts never auto-send. Open the agent (Sales Specialist, Relationship Manager, etc.), find the draft in the per-day list, click to inspect, then approve or edit. Approved drafts go to Gmail Drafts where you do the final review before pressing send manually.

What does the live activity strip show?

Which agents are actively running background work right now. A pulsing coral dot means "in progress". Click any active agent to see what stage they're in.

What if an agent fails or gets stuck?

Most agents have an "is_running" state in their scan_status file. If a thread hangs, restart Founder OS — the in-memory thread dict resets and the next run is fresh. Persisted state on disk is unaffected.

How do KPIs get calculated?

Per-agent KPIs are written to data/agents/<id>/kpis.json after each run. The dashboard's "Today:" line reads the per-day files (e.g. today_drafts_2026-05-11.json) and rolls them up. The "Database Total" and pipeline counters read the master files.

Security & rotation

What if I leak my password?

Edit .env, change FOUNDEROS_PASSWORD= to a new value, restart Founder OS. Every session becomes invalid; everyone signs back in with the new password.

How do I rotate the Anthropic / Brave keys?

At console.anthropic.com / api.search.brave.com, revoke the old key and create a new one. Paste the new value into .env on the line ANTHROPIC_API_KEY= or BRAVE_API_KEY=. Restart Founder OS.

Where can I see security incidents?

The audit log at data/audit.log records sign-in events, login failures, lockouts and sign-outs as newline-delimited JSON. No passwords are logged.

Troubleshooting

An Anthropic-backed agent isn't producing drafts

Check that ANTHROPIC_API_KEY is set in .env and that the value works. Agents fall back to template responses (less interesting) if the key is missing or rate-limited.

The Researcher agent finds nothing

Check that BRAVE_API_KEY is set in .env. Without it, Curie has no web-search capability and the queue stays empty.

I'm locked out

Wait 15 minutes — the lockout is per-IP and time-boxed. Or restart the server, which clears the in-memory lockout state immediately. If you've genuinely forgotten the password, edit FOUNDEROS_PASSWORD= in .env to a new value and restart.

Still stuck?
Email support@askkira.com — every message is read.