Atlas · The Personal AI Companion

Your life, remembered.
Your world, in reach.

Atlas is the AI companion that actually knows you. It remembers every conversation, reaches into your calendar and inbox, and works across every device — so you never start from scratch again.

Welcome

Once upon a time, you had to start every conversation from scratch.

Every chatbot you've ever used suffers from the same affliction: amnesia. You close the tab, and everything is gone. You open a new one, and you're a stranger again. You explain who you are, what you're working on, how you like things done — every single time.

Atlas was born from a simple question: what if your AI assistant actually remembered you? Not just your last message, but the full, rich tapestry of your life — your goals, your preferences, your past decisions, the documents you've been working on, the commitments you've made. What if it could reach into your calendar, read your inbox, and act on your behalf? What if it followed you across every device, always in sync, always ready?

This is the complete story of how Atlas works — told in plain language with warm, simple diagrams. Whether you're curious about the technology, assessing the privacy, or just want a brilliant assistant, you'll understand exactly what makes Atlas different.

✓ No training on your data✓ Your data is yours alone✓ Works on every device✓ Remembers you forever✓ Reaches into your life
01 · Big Picture

The 30-second map

Atlas is a personal AI companion you talk to like a friend. Five layers make it work: you (on any device) chat with the Atlas App, which hands your message to the AI Engine. The engine picks the best brain for the job (AI Provider), reads and writes to your private memory & vault, and reaches into your life through integrations and automations.

💬 In plain English
The analogy: Atlas is like a chief of staff who never sleeps. You talk, they think (using whichever brain is best for the job), they remember everything you've ever told them, and they can read your email, check your calendar, and file documents — all on your behalf, all locked to you.
🔧 How it works
The stack: A React + Tailwind shell you talk to; a single orchestration engine that manages direct provider calls with caching and failover; a secure database with row-level security holding your private memory, vault, and conversations; and OAuth connectors (Gmail, Calendar, Drive, Sheets) feeding scheduled and event-driven automations. Every layer is replaceable — no lock-in to any single AI provider, cloud, or framework.
Youphone + laptop
talk to
🧑‍💼
Atlas App
your interface
calls
🧠
AI Engine
the thinking core
routes to
⚡
AI Providers
OpenAI · Anthropic · Google
reads/writes
🔒
Your Memory & Vault
private · locked to you
connects to
🔌
Your Integrations
Gmail · Calendar · Drive
triggers
⏰
Automations
briefings · reminders · scans
02 · Core

How Atlas thinks: one message to one reply

When you send a message, Atlas doesn't fire it raw at an AI. A tier selector first decides how much brainpower your message deserves — a quick "thanks" needs almost nothing; "plan my week from my calendar and inbox" needs your full memory and vault. Atlas then assembles a package: its personality, your relevant memories, and any vault documents that might matter, and hands it to the orchestration engine, which calls the chosen provider and returns the reply.

💬 In plain English
The analogy: You're not shouting into a chatbot. There's a gatekeeper (the tier selector) deciding whether your question needs a quick answer or deep thought, a researcher pulling your relevant memories, and a speaker (the AI) who actually answers. Each step is cheap unless your question is hard.
🔧 How it works
The flow: Frontend hook → classifyTier() → memory + vault fetch → orchestration engine call with { messages, tier, context_mode } → provider API → reply. One call from the app; the engine owns provider selection, prompt caching, and automatic failover. The frontend never touches provider keys directly.
Yousend a message
1. send
🎚️
Tier Selector
light · standard · deep
2. pick brain size
📋
Atlas Personality
🧩
Your Memories
📚
Your Vault
3. assemble context
⚙️
Orchestration Engine
direct-to-provider · caching · failover
4. call provider
⚡
AI (OpenAI / Anthropic / Google)
5. reply
Youget an answer
03 · Efficiency

The right brain for every question

Not every message deserves the same brain. A two-word reply shouldn't cost the same as a 2,000-word life plan. The tier selector routes each message to one of three tiers — each with a different model, a different slice of your history, and a different price. This is what keeps Atlas affordable to run at scale, and fast enough to feel instant on every message.

💬 In plain English
The analogy: Like a hospital triage. A paper cut gets a nurse (light, fast). A broken arm gets a doctor (standard). Heart surgery gets the chief surgeon (deep). You'd never call the surgeon for a paper cut — and Atlas makes sure it doesn't either. The result: quick answers feel instant, and hard problems get the depth they deserve.
🔧 How it works
The selector: A classification module inspects each message by keywords, length, and intent: greetings and acknowledgments → light; normal conversational turns → standard; long messages, attachments, or planning verbs ("plan", "draft", "analyze", "compare") → deep. The tier becomes a parameter on the orchestration call, selecting both the model and how much of your memory/vault to load.
LightGemini Flash / Haiku
📦 Context: Last 2 messages💬 When: "thanks", quick facts💰 ~$0.10 / 1M tokens🎚️ Tier 1
StandardSonnet / GPT-4o
📦 Context: Last 8 msgs + 3 memories💬 When: Most conversations💰 ~$3 / 1M tokens🎚️ Tier 2
DeepOpus / GPT-4o
📦 Context: Everything + vault + files💬 When: Planning, long analysis💰 ~$15 / 1M tokens🎚️ Tier 3
04 · The big lever

How long chats stay cheap

In a long conversation, your personality prompt and early messages are identical every turn. Without caching, you'd pay full price for them every time. With prompt caching, the provider stores that stable prefix once and reuses it — charging about 10% of normal for the cached portion. For a personal assistant that you chat with all day, this is the single biggest reason it's economically viable to offer unlimited conversations.

💬 In plain English
The analogy: Imagine reading a 200-page book to answer a question, then being asked a follow-up. Without caching, you re-read all 200 pages. With caching, you remember the first 199 and only read the new page. Same answer, a fraction of the effort — and a fraction of the cost.
🔧 How it works
The mechanism: Anthropic: explicit cache_control markers on the personality block and the last stable-history message. OpenAI: automatic prefix caching (≥1024 tokens). Google: no explicit caching in v1. The cache lives ~5 minutes; turns within that window are mostly cache reads. This is what makes a 50-message conversation cost the same as a 3-message one.
Turn 1 — fresh (cache write)
Personality
msg 1
msg 2
msg 3
breakpoint
new msg
💰 pay full price for the prefix · write cache
Turn 2 — prefix cached (cache read ≈ 90% off)
Personality
msg 1
msg 2
msg 3
msg 4
new breakpoint
new msg
💰 green = cache HIT (10% of price) · only the new turn is full price
05 · Resilience

Always on, even on a free tier

Atlas talks to three AI providers — OpenAI, Anthropic, and Google — each on its own account and billing. You might start on Google's free tier, add OpenAI's free credits, and upgrade to Anthropic later. The system handles all of that gracefully, which matters for a consumer product where reliability is everything.

Toggle: an admin can enable or disable any provider at any time. A provider is "available" only if enabled and its key is configured. Failover: if the chosen provider hits a quota or overload error, Atlas silently retries the next available one — so a free tier running dry mid-conversation self-heals instead of breaking. You never see an error. You never lose a thought.

💬 In plain English
The analogy: Three translators on call. One's on vacation (disabled), one just hit their daily limit (quota), one is fresh. Atlas skips the first, tries the second, and when they're full, seamlessly hands your letter to the third — you never notice the switch.
🔧 How it works
The logic: The engine builds an ordered candidate list (preferred provider first), filtered to enabled + keyed. The failover loop tries each; on a failover-eligible error (429/402/403/401/5xx) it continues to the next, on a hard error (400) it throws. The response includes the failover trail and the provider that served — for observability and A/B testing.
Youask Atlas
orchestration engine
🔴
Anthropic
disabled / no key
skip
🟡
OpenAI
free credits
429 quota!
🟢
Google
free tier ✓
serves the reply
Youseamless answer
Failover trail (in the response)
failover: [
  { provider: "OpenAI", status: 429, failover_eligible: true },
]
provider: "Google"   // ← who actually served it
06 · What makes it personal

Atlas remembers you

This is what separates Atlas from every generic chatbot. Atlas doesn't just remember your last message — it holds a structured, long-term model of you, and that model is what makes every reply feel like it's coming from someone who actually knows you.

The five memory types

Atlas stores five kinds of memory, each with a purpose. Facts are stable truths about you — your name, your role, your family. Preferences capture how you like things done — short emails, bullet points over prose, mornings for deep work. Goals are what you're working toward — the promotion, the side project, the trip. Summaries are condensed versions of past conversations so old chats aren't lost. Journal entries are things that happened to you — the meeting that went sideways, the win you landed. Every memory carries an importance score (1–5), searchable tags, and a source date so Atlas can weigh what matters most and what's still current.

How memories are born

You never have to explicitly "save" a memory. As you talk, an auto-summarizer runs in the background every ~10 user messages: it reads the recent thread, extracts anything worth remembering long-term, classifies it into one of the five types, scores its importance, tags it, and writes it to your private memory store. Trivial chatter is skipped; meaningful context is kept. The same pipeline powers briefing absorption — paste in notes or an exported conversation from another tool and Atlas extracts every useful memory from it in one pass.

How memories are retrieved

When you send a message, Atlas doesn't dump your entire memory into the prompt — that would be expensive and noisy. A relevance scorer ranks your memories against your message: title keywords, tag overlap, and content similarity. Only the top few (typically 3 for a standard turn, more for a deep turn) make it into the context window. This is why Atlas can hold thousands of memories and still respond in seconds — it loads the needle, not the haystack.

The three companion stores

Memory is only the beginning. Atlas also maintains three companion stores that turn memory into action. Open items are the things you've committed to — extracted from chat, tagged by life bucket, tracked to completion. Decisions log what you chose, the context, the alternatives, and (later) the outcome — so you can revisit why you picked a path. The vault holds your documents — drafts, plans, articles, spreadsheets — with full version history and sharing controls. Together, memory + open items + decisions + vault give Atlas a complete, living picture of your life.

Cross-device continuity

Every memory, vault doc, open item, decision, and conversation syncs across your devices in real time. Atlas subscribes to live changes on the backend, backfills on window focus, and runs a 60-second safety interval — so the thread you started on your laptop this morning is waiting on your phone this afternoon, complete with its full history. A daily briefing is generated each morning from your open items and overdue tasks, so Atlas greets you with what matters instead of a blank screen.

💬 In plain English
The analogy: A chatbot forgets you the moment you close the tab. Atlas is more like a lifelong assistant who's been with you for years — they know your kids' names, your current projects, the decision you made last month, and the document you were working on yesterday. And they're on every device you own, always in sync, never asking you to repeat yourself.
🔧 How it works
The mechanism: Memories, vault docs (with full version history), open items, and decisions are each their own secure entity, row-level-locked to you. Auto-summarization runs every ~10 user messages; relevance scoring uses tag + title + content matching. Cross-device sync uses realtime subscriptions + a 60s interval + window-focus backfill. The daily briefing is generated by a scheduled automation from your open items. Conversation messages are capped (40 msgs, 40K chars) to keep records manageable without losing recent context.
The five memory types
📌
Facts
who you are
⚙️
Preferences
how you like things
🎯
Goals
what you're chasing
📝
Summaries
what we discussed
📖
Journal
what happened
+ importance 1–5
+ tags · source date
written by
🧠
Auto-Summarizer
every 10 user messages
retrieved by
🔍
Relevance Scorer
tags + title + content match
fed into
⚙️
orchestration context
✅
Open Items
things to do
🎯
Decisions
what you chose & why
📚
Vault
your documents
Laptopmorning
Phoneafternoon
Tabletevening
All five memory types + the three stores sync across your devices in real time — pick up a conversation on your phone that you started on your laptop, it's already there.
07 · Trust

Your data is yours

A personal assistant that remembers everything about you is also a serious privacy responsibility. Atlas is built privacy-first — not as an afterthought, but as the foundation. Your data is yours: you control it, you can see it, you can delete it, and no one else can touch it.

Layer 1: Access control — your data is locked to you

Every record Atlas holds about you — every memory, every vault document, every conversation, every open item, every decision — is row-level secured. The rule is simple: only the user who created a record can read it. Even though every Atlas user's data lives in the same database, the database enforces that you only ever see your own. There is no "admin can see all user data" path for personal records — your memories are yours alone.

Passcode-locked conversations

Some conversations are more sensitive than others — a personal health matter, a financial decision, a difficult relationship. Atlas lets you passcode-lock any conversation so it's hidden behind a gate screen until you enter the code. The passcode is SHA-256 hashed before it's stored — the plaintext is never saved, not in the database, not in local storage. Even someone holding your unlocked phone can't read a locked conversation without the code. The hash is verified client-side, so the server never sees the plaintext passcode either.

The private vault

Your vault documents — drafts, plans, articles, spreadsheets — are also locked to you. Each document has full version history (every save creates a snapshot you can roll back to) and granular sharing controls: you can grant another Atlas user view, comment, or edit access to a specific document, and you can revoke it at any time. You always know who can see what.

Layer 2: Your rights — see, edit, delete

Privacy isn't just about keeping others out — it's about giving you control. You can see every memory Atlas holds about you. You can edit any memory to correct it. You can delete any memory, conversation, or vault document at any time. And if you delete your Atlas account, all your data is removed — the right to be forgotten is built in, not a support ticket.

What Atlas does NOT do

Atlas does not train AI models on your data. Your conversations and memories are not fed into a training pipeline. Atlas does not sell your data to third parties. Atlas does not show advertising — the subscription model means the user is the customer, not the product. Atlas does not share your data with other users — ever. Your memories, vault, and conversations are invisible to everyone but you.

Third-party AI providers

When Atlas thinks, it sends your message (plus the assembled context — personality, relevant memories, vault snippets) to an AI provider: OpenAI, Anthropic, or Google. Each provider has its own privacy policy governing how they handle API inputs. On the Free and Pro tiers, Atlas uses its own provider keys, so your prompts are sent under Atlas's API account. On the Enterprise tier, BYOK (Bring Your Own Key) lets your team supply its own provider keys — your prompts go directly to the provider under your own account, never touching Atlas's billing or infrastructure.

💬 In plain English
The analogy: Your data lives in a safe deposit box with a key only you hold. Other people's boxes are in the same vault, but yours stays locked to you. For your most private conversations, there's a second lock on top — a passcode only you know. You can open the box anytime to see what's inside, remove anything you don't want there, or take everything out and leave. And nobody — not Atlas, not other users, not advertisers — gets to look inside without your key.
🔧 How it works
The mechanism: Row-level security on every personal entity (read: only the creator). Passcode locks: SHA-256 hash, client-side verification, plaintext never stored. Vault sharing: granular access grants with view/comment/edit levels, revocable. BYOK: user-supplied provider keys passed directly to the provider (Enterprise tier). No model training on user data. TLS in transit, managed encryption at rest. GDPR/CCPA-aligned: access, rectification, erasure, portability all supported.
Youyour data
protected by
Layer 1 — Access control
🔐
Row-Level Security
Only you can read your records — your memories, vault, and conversations are invisible to every other user.
🔒
Passcode-Locked Chats
Sensitive conversations gated with a passcode — only a SHA-256 hash is stored, never the plaintext.
📚
Private Vault
Your documents have version history and granular sharing — view, comment, or edit grants you control.
plus
Layer 2 — Your rights
🗑️ Delete your data anytime
👁️ See everything stored
✏️ Edit any memory
🚫 No training on your data
📊 No advertising, ever
🔐 TLS in transit, encrypted at rest
and for teams
🗝️
BYOK (Enterprise)
Your team supplies its own AI keys — your prompts never touch our billing or infrastructure.
08 · Reach

Atlas in your life

Atlas connects to your Google workspace through OAuth — Gmail, Calendar, Drive, and Sheets. Once authorized, it can read your inbox for commitments, look at your calendar to plan your day, save the documents it drafts to your Drive, and sync your tasks to Sheets. This is what turns Atlas from a chat window into an assistant that's actually in your life.

💬 In plain English
The analogy: Without integrations, Atlas is a brilliant friend who can only talk. With them, Atlas can also read your mail, check your calendar, and file your paperwork — the difference between advice and action.
🔧 How it works
The layer: OAuth connectors (shared mode for now; app-user mode on the Enterprise roadmap) with webhook support. Automations fire on real-time events — a new email, a calendar change — and on schedules like the daily morning briefing. The orchestration engine holds the API call logic; the automation system holds the trigger-and-branch logic.
🔌
OAuth Connectors
✉️
Gmail
📅
Calendar
📁
Drive
📊
Sheets
Atlas can now
📧 Scan your inbox for commitments
📅 See your calendar & suggest the day
📁 Save documents to your Drive
📊 Sync tasks & notes to Sheets
09 · The difference

Why Atlas is not another chatbot

There are hundreds of AI assistants. Most are wrappers around a single model with a chat box. Atlas is fundamentally different — not in one way, but in eight. Each advantage below is structural, not cosmetic: it's how Atlas is built, not a feature bolted on. Together, they create a product that no generic chatbot can match today.

💬 In plain English
The short version: Other assistants are goldfish — they forget you instantly, live in one tab, and can't touch your life. Atlas is a lifelong companion with a perfect memory, the right brain for every question, automatic failover, privacy that's structural not promised, and hands that reach into your calendar, inbox, and files. It's the difference between a calculator and a chief of staff.
🔧 How it works
The architecture: Every advantage above is a consequence of the architecture in this document — tiered context routing, prompt caching, multi-provider failover, row-level-secured structured memory, OAuth integrations with webhook-driven automations, realtime cross-device sync, and BYOK. None of these are features; they're the system.
🧠
Permanent memoryirrefutable

Every other AI forgets you when you close the tab. Atlas remembers you forever — across every device, every conversation, every year.

How: Five-type structured memory (facts, preferences, goals, summaries, journal) with importance scoring, tag-based retrieval, and auto-summarization every 10 messages.
🎚️
Intelligent tieringirrefutable

Generic tools use one model for everything — you overpay for simple questions and underpower complex ones. Atlas matches the brain to the task.

How: Three-tier classifier routes by message intent: light (Flash/Haiku), standard (Sonnet/GPT-4o), deep (Opus/GPT-4o) — each with calibrated context window and memory load.
💰
Prompt cachingirrefutable

Long conversations on other platforms cost the same every turn. Atlas caches the stable prefix, cutting long-chat costs by ~90%.

How: Explicit cache_control markers (Anthropic) + automatic prefix caching (OpenAI). A 50-message conversation costs the same as a 3-message one.
🔄
Provider failoverirrefutable

When one AI provider goes down or hits a quota, other tools show you an error. Atlas silently switches to the next available brain.

How: Ordered candidate list filtered to enabled + keyed providers. On 429/402/403/5xx, automatic retry to next provider. The user never sees an error.
🔒
Privacy-first architectureirrefutable

Other assistants train on your data, show ads, or share it. Atlas locks everything to you, trains on nothing, and shows no ads — ever.

How: Row-level security on every personal entity. SHA-256 passcode hashing. No training pipeline. No ad layer. BYOK on Enterprise so prompts never touch our infrastructure.
🔌
Reaches into your lifeirrefutable

Chatbots live in a tab. Atlas reads your inbox, checks your calendar, saves to your Drive, and syncs tasks to Sheets — automatically.

How: OAuth connectors with webhook support. Real-time event triggers + scheduled automations. The daily briefing, email commitment scanning, and calendar-aware planning all run without you asking.
📱
True cross-device syncirrefutable

Most tools are device-bound or require manual sync. Atlas is real-time across phone, laptop, and tablet — pick up where you left off, anywhere.

How: Realtime subscriptions + 60s safety interval + window-focus backfill. Every memory, vault doc, open item, decision, and conversation is live-synced.
🗝️
Bring your own keysirrefutable

No other consumer AI assistant lets you use your own provider keys. On Enterprise, Atlas does — your prompts never touch our billing.

How: BYOK mode passes user-supplied provider keys directly to the AI API. The subscription becomes pure software revenue, insulated from high-usage customers.
10 · Plans

Simple, honest pricing

Atlas is commercialized on three tiers. Free runs on Google's free-tier AI to let people try it with zero friction. Pro unlocks the mid and premium brains, unlimited memory, all integrations, and cross-device sync — priced to cover the direct-API cost plus margin. Enterprise adds BYOK so teams bring their own AI keys, turning the subscription into pure software revenue insulated from high-usage customers.

💬 In plain English
The analogy: Free is the sample at the deli counter. Pro is the full meal — priced to cover ingredients and the chef. Enterprise is the private dining room — you bring your own wine, we just charge for the room and service.
🔧 How it works
The unit economics: Pro uses direct-API calls with prompt caching: a long chat that would cost ~$45/1M tokens on per-call credits costs ~$0.40 cached. Enterprise BYOK passes the user's provider key straight to the API, so the customer's token spend is on their own bill — our margin is fixed and safe regardless of how much they use.
Free
Get hooked$0
✓ Google free-tier AI✓ Limited memory✓ Basic chat✓ 1 device sync
Pro
Most popular$20/mo
✓ Mid + premium tiers✓ Unlimited memory & vault✓ All integrations✓ Cross-device sync✓ Passcode locks
Enterprise
For teamsCustom
✓ Everything in Pro✓ BYOK (your own AI keys)✓ Team shared memory✓ SSO + admin controls✓ SLA
The economics: Pro runs on direct-API wholesale rates + prompt caching (~90% off long chats). Enterprise BYOK means the customer's usage never touches our margin — the subscription is pure software revenue.
11 · In action

From a reminder to a full week plan

The same engine handles a one-line reminder and a full week-planning pipeline. The difference is which tier fires, how much of your memory is loaded, and how many calls chain together.

💬 In plain English
Simple: "Remind me to call mom" → a quick note. Light tier, almost no context, one fast call, Atlas creates an open item. A tenth of a cent.
💬 In plain English
Medium: "Draft a reply to Sarah about the project" → Atlas pulls your memories about Sarah and the project, uses the standard tier with caching, and drafts the email in your voice. About a fifth of a cent.
💬 In plain English
Complex: "Plan my week from my calendar and inbox" → Atlas scans your Gmail for commitments, pulls your calendar, runs the deep-tier brain to synthesize a week plan, creates open items for each commitment, and generates a Monday briefing. Three-plus calls, a few cents — all from one chat message.
Simple
"Remind me to call mom"→tier: light→Gemini Flash→1 call · ~$0.0001→→ open item created
Medium
"Draft a reply to Sarah about the project"→tier: standard + 2 memories→Sonnet (cached)→1 call · ~$0.002→→ email draft saved
Complex
"Plan my week from my calendar & inbox"→Gmail scan + Calendar fetch→tier: deep · Opus→3+ calls · ~$0.03→→ weekly plan + open items + briefing
12 · Putting it together

A day with Atlas

🌅
6:30 AMMorning briefing

You wake up. Atlas has already scanned your inbox and calendar overnight and generated a morning briefing — your commitments, your open items, and what matters today.

overnight automation→inbox + calendar scan→briefing ready
💬
8:00 AMA real conversation

You ask Atlas to help draft a tricky email to your landlord. Tier selector picks standard. Your memories about your housing situation are loaded. Atlas drafts it in your tone, cached.

tier: standard→memories loaded→Sonnet (cached)→draft saved
⚡
11:00 AMFree tier runs dry

A quick follow-up goes to Google (light tier), but the free tier just hit its per-minute limit — 429. Failover silently retries on OpenAI. You never see an error.

tier: light→Google 429→→ failover OpenAI→reply ✓
🧠
2:00 PMDeep planning

You ask Atlas to plan your week. Deep tier: Opus, your full memory, your calendar, your inbox scan. It creates open items for each commitment and a weekly plan in your vault.

tier: deep→Opus + integrations→open items created→vault doc saved
🔒
9:00 PMPrivate & cross-device

You open a passcode-locked conversation about something personal on your phone — the one you started on your laptop this morning. It's all there, instantly, and locked behind your code.

realtime sync→passcode gate→private thread ✓
End of the Atlas Story

Atlas is a personal AI companion built for everyone — not a feature of something else. Your life, remembered. Your world, in reach.