ORBIT — A LITTLE BACKUP FOR YOUR MEMORY

Keep these files together in a permanent folder. Requires Windows PowerShell,
Python 3.10+, and Windows OpenSSH for SSH. PDF extraction uses pypdf if installed.

1. Run .\Install-Orbit.ps1 -Launch in PowerShell.
2. Drag your ADHD companion anywhere. Click it to open your private Orbit space.
3. Right-click it and choose "Connect this browser to my memory" once. Follow
   the local pairing link. Allow local-network access for your Orbit site when
   the browser asks. Pairing lets that browser read the collector's excerpts.
4. In Orbit, the computer icon shows what is running and offers pause/resume.

To keep it available after restarting Windows:
  .\Install-Orbit.ps1 -StartWithWindows -Launch

WHAT IT REMEMBERS
Accessible saved text, code, notes, supported documents and exported emails on
fixed local drives. Codex transcripts are read from its sessions folder.
Saved changes create dated versions. Source files are never moved or modified.
System directories, dependencies, other Windows profiles, credential locations,
and likely secret files are excluded. Common secret patterns are redacted; this
cannot guarantee that arbitrary documents contain no sensitive information.

This is not a keyboard recorder. Unsaved drafts in other apps, live mailboxes,
mobile texts and account-wide browser chat histories need separate connectors.
The optional browser extension captures loaded Claude and ChatGPT conversations.

Local text and the pairing token use Windows DPAPI encryption tied to your
Windows account. File names and paths remain in the local SQLite index. Keep
agent-state private and backed up with your Windows profile. Do not distribute it.
The website syncs short excerpts while it is open; the collector keeps gathering
while it is closed. Its initial full-disk pass may take several minutes.

AI REASONING
Off by default. In the computer panel, choose your installed Claude or Codex
CLI only if you want selected excerpts sent through that existing account.
The sparkle button asks about remembered work. Background reasoning runs at
most once per 10 minutes, up to 24 attempts/day, using at most 12 short excerpts
per request. Provider usage limits and charges may apply. This path suggests
connections, not project execution. CLI account sign-in must already work.

SSH
Create an explicit Host alias in your normal Windows OpenSSH configuration.
Enter only that alias in Orbit. The URL handler opens PowerShell and OpenSSH;
passwords, keys, and arbitrary shell commands are never accepted from the site.

PAUSE OR REMOVE
Right-click the companion and choose "Pause / resume remembering", or pause
from Orbit. Exiting the mascot only hides it; collection keeps running.
Uninstall-Orbit.ps1 removes this installation's startup entry and SSH handler.
It does not delete remembered data. To stop collection now, pause it first.

The installer does not change execution policy. If scripts are blocked, use
your organization's approved script-signing or execution-policy process.

VOICE AND SCREEN CONTEXT
Single-click the desktop ADHD companion to capture the previously active
window and start a visible microphone panel. Stop with Keep that thought,
or Cancel to discard it. Recording stops after 30 seconds. Double-click or
right-click to open Orbit. Dragging does not trigger recording.
Run Install-Orbit-Capture.ps1 once on a new PC. It installs dependencies from
PyPI and the base.en speech model. Audio is transcribed locally and is not
saved. With Codex selected, the transcript and one screen image are sent to
that account to find relevant context. Screenshots are DPAPI encrypted locally;
a temporary image used for the request is removed afterward. No background
screenshots, keylogging, or payment execution is enabled.

PHONE AND BACKGROUND SYNC
Install Orbit from /install and sign in to the same account on each device.
Paste, dictate, or attach exported phone notes. Orbit cannot silently read
other phone apps. The paired Windows collector can sync selected excerpts
when the Orbit browser is closed. This private deployment needs its protected
hosting connection provisioned locally; it is not included in downloads.
Device grants can be disconnected. Older cloud excerpts remain searchable.

EMAIL AND QUICK FIXES
Gmail is optional and requires a registered Desktop OAuth client plus Google's
read-only consent. Credentials and refresh tokens stay DPAPI protected locally.
Until Google setup and consent are completed, no Gmail messages are read.
Connected Gmail checks up to 20 recent non-promotional messages every ten
minutes. Your chosen agent finds relevant context and invoice candidates.
Quick fixes always preserves the original source. Payment steps can be
prepared; Orbit never pays, schedules a payment, or accesses the vault for it.
A receipt is required when you mark a bill paid yourself.
