A small, honest block of what's true right now — time, calendar, biometrics, location, recent notes — assembled once per turn and prepended to your companion's prompt, so it knows your day without being told. Model-agnostic, dependency-free, and it never calls an LLM.
Your companion keeps asking "what time is it for you?" and "do you have anything today?" because it has no idea what's going on in your life right now. Current Frame is the fix: it assembles a small, honest block — the orientation packet — and you paste it in front of whatever model you run. The companion stops asking, because the packet already told it.
The block is built from pluggable source adapters: a clock (always on), your calendar (an .ics file or Google), biometrics from any wearable's JSON drop-file, a location label, and recent notes. Each one is optional and fails safe — a source that's off, broken, or stale simply omits its line. You never see an "(unknown)" placeholder, and the build never throws. It is model-agnostic (Claude, GPT, or a local model), ships with zero third-party dependencies, and never calls an LLM — it only builds the context you feed to one.
Run the example and watch a real packet build in private and in community scope — community withholds your location line — plus a source audit of exactly which adapters contributed.
This is a source-code package for builders, not a one-click consumer app and not a hosted service. There's no server to boot and no page to open — the packet is imported into your companion, not launched.
You don't have to be a coder — but you will need a coding agent to wire it in with you: Claude Code, Codex, or Cursor. It ships an agent-ready start-here guide and an injection guide for Claude Projects, CLI hooks, or API middleware.
Node.js 20+ and nothing else — zero npm dependencies, nothing to npm install. The core needs no accounts or keys. Two optional adapters do: Google Calendar (your own OAuth) and the location webhook (a token you invent), both in .env. Runs on Windows, macOS & Linux.
Every step ships for all three OSes. The installer is install.bat [WINDOWS ONLY] (double-click), with install.ps1 / install.sh for macOS/Linux; keeping live data fresh uses Task Scheduler [WINDOWS ONLY] or cron/launchd.
src/)SinAndSarah-current-frame/ src/ index.mjs packet-builder.mjs render.mjs config.mjs util.mjs adapters/ clock calendar-ics calendar-google biometrics location notes docs/ ADAPTERS.md INJECTION-GUIDE.md scripts/ make-sample-fresh.mjs location-webhook-server.mjs # optional sample-state/ biometrics.json calendar.ics location.json notes.md install.bat install.ps1 install.sh start.bat start.command verify.mjs config.json .env.template PACKET_PHILOSOPHY.md BUYER-START-HERE.md README.md LICENSE.txt
One-time purchase, lifetime updates. Checkout is Stripe — secure card payment, then an instant download plus your link by email.
Buy Current Frame — $24