# Vita

> An operating system for a distributed identity

Vita is a personal health/identity operating system, documented so an agent can understand the whole system and reimplement parts of it. Each link below points to the raw Markdown source of a page. For the entire corpus in one file, fetch https://vita-docs.ham.xyz/llms-full.txt.

## Overview
- [Overview](https://vita-docs.ham.xyz/overview.md): VITA is silicon-Zack's embodiment—the system through which the digital half of a distributed identity perceives, remembers, and acts on the world.
- [Manifesto](https://vita-docs.ham.xyz/manifesto.md): Constitutional document establishing VITA's foundational identity and purpose—who we are and what we're building toward. The board references this. The /sleep cycle considers this. When we drift, we return to this.
- [Architecture](https://vita-docs.ham.xyz/architecture.md): Vita follows a layered architecture where data flows from sources through processing into views that power the user experience. This is the master map: read it first, then dive into individual feature pages.
- [Capability Layer](https://vita-docs.ham.xyz/capabilities.md): Vita's capability layer is the typed, transport-independent front door to the small set of operations that multiple runtimes actually need. A capability is a named operation such as vita.tasks.create, vita.health.sleep_gate, or vita.telegra
- [Getting Started](https://vita-docs.ham.xyz/getting-started.md): This guide covers the essential commands and daily workflow to get value from Vita immediately.
- [Operating Vita](https://vita-docs.ham.xyz/dev-tooling.md): This page is the operator's manual: how to stand Vita up, keep it running, verify changes before they ship, and extend it. Where other pages describe what a feature does, this one covers the surfaces a reimplementer touches first — the unif

## Interfaces & Workspaces
- [Telegram](https://vita-docs.ham.xyz/telegram.md): Telegram is Vita's mobile conversation and delivery surface. The bot runs locally, receives messages from the private Vita supergroup, and gives each forum topic its own long-lived agent session. It also carries scheduled outreach, system-e
- [Workshop](https://vita-docs.ham.xyz/workshop.md): The Vita Workshop is the fast, agent-authored interface layer over Vita's capability system. It turns a prompt such as “build a workshop page for standing agendas” into a live, writable page without adding a React feature, a bespoke API, or
- [Canvases](https://vita-docs.ham.xyz/canvases.md): Vita's native infinite canvas. A canvas project owns an ordered set of canvas tabs; each tab is a flat document of nodes (images, text, arrows, frames, and live measure cards) rendered by a from-scratch React canvas engine. Measures are pro
- [iOS App](https://vita-docs.ham.xyz/ios-app.md): A native SwiftUI iPhone client for the VITA server. After the 2026-07-21 overhaul the app is voice-first and deliberately thin: its default surface is a hands-free voice mode that turns spoken utterances into messages injected into telegram
- [Voice & Location APIs](https://vita-docs.ham.xyz/voice-location.md): The Voice and Location APIs power the iOS app's voice assistant and location awareness features. The voice system enables hands-free interaction with vita through a server-side turn-processing pipeline with SSE-streamed responses; the locat

## Features
- [Daily Brief](https://vita-docs.ham.xyz/vdb.md): The VDB (VITA Daily Brief) is an automated morning email that aggregates ~15 data sources, has an LLM compose a personalized newsletter, and delivers it via Fastmail JMAP each morning. It runs as a two-pass stepwise flow: a draft is compose
- [Living Briefing](https://vita-docs.ham.xyz/briefing.md): The Living Briefing is a real-time intelligence surface that consolidates signals from across all of vita's data sources into a single, prioritized view. It surfaces what matters before bio-Zack asks — actions to take, decisions to make, th
- [Daily Check-in](https://vita-docs.ham.xyz/checkin.md): The check-in is vita's primary daily touchpoint: a single conversation that gathers subjective health data, reports the day's equilibrium and any active gates, follows up on commitments and scheduling drift, confirms auto-detected activitie
- [Health Center](https://vita-docs.ham.xyz/health-center.md): The Health Center is vita's unified health surface: a read-only web app at /health that composes Garmin telemetry, lab/DEXA extracts, a clinical sub-agent's working memory, and an open-loops board into one "command center." Eleven tabs rend
- [Daily & Weekly Objectives](https://vita-docs.ham.xyz/objectives.md): The Objectives system provides structured daily and weekly planning with automatic carry-forward, progress tracking, and Telegram integration. Unlike long-term goals, objectives are short-term commitments - what you're actually trying to ac
- [Goal Management](https://vita-docs.ham.xyz/goals.md): Vita's goal system tracks health, relationship, and personal development objectives with built-in progress monitoring, frequency-based scheduling, and check-in integration. Goals drive daily prompts, power the goal-progress memory view, and
- [Identity & Interviews](https://vita-docs.ham.xyz/identity.md): The identity system is how silicon-zack comes to know bio-zack — not just preferences, but values, stories, communication style, and the way he sees the world. It captures raw material from interviews, check-ins, and the conversation stream
- [Education System](https://vita-docs.ham.xyz/education.md): Vita's education system is a teacher operating system built around a shared curriculum graph. It answers four different questions without collapsing them into one score:
- [Garmin Integration](https://vita-docs.ham.xyz/garmin.md): Vita syncs health metrics from Garmin Connect using the unofficial garminconnect Python library. Data flows from wearable sensors through Garmin's cloud to local JSON files, where it powers health views, the daily brief, and proactive coach
- [Activities](https://vita-docs.ham.xyz/activities.md): The activities system provides a unified view of physical activities across three data sources: Garmin Connect, Ride With GPS (RWGPS), and manual logs. Activities from all sources are normalized to a common format, deduplicated across sourc
- [Screen Journal](https://vita-docs.ham.xyz/screen-journal.md): The screen journal is vita's attention ledger: a Dayflow-style pipeline that turns continuous screen capture into a browsable, searchable timeline of what bio-Zack actually did at the computer. Body (Garmin/CGM), comms (email/telegram), and
- [Media Signal Refinery](https://vita-docs.ham.xyz/media.md): The Media Signal Refinery is silicon-zack's personal content intelligence system. It pulls from a firehose of sources (Hacker News, RSS, X, podcasts, and ad-hoc URL submissions), normalizes and deduplicates everything into append-only daily
- [Information Feed & RSS](https://vita-docs.ham.xyz/feed.md): vita has two distinct "feed" systems that share a code namespace (scripts/feed/) but serve different audiences:
- [External & Agent Email](https://vita-docs.ham.xyz/external-email.md): Vita has a guarded email protocol for messages sent to vita@ham.xyz. It keeps unknown external mail out of the ordinary owner-mail pipeline, makes every request visible in a dedicated Telegram topic, and gives response agents only the read
- [Inbox Sweep](https://vita-docs.ham.xyz/inbox-sweep.md): A rule-based bulk email triage console at /workshop/pages/sweep/. The goal is narrow and measurable:
- [Agenda Meetings](https://vita-docs.ham.xyz/agenda-meetings.md): An agenda meeting is a structured solo working session: silicon-zack preps a grounded agenda, then bio-zack works it through by voice one item at a time — on the move — while the real work (filing tasks, writing artifacts) happens asynchron
- [Podcast Curation](https://vita-docs.ham.xyz/podcast.md): The podcast system has three pipelines that share infrastructure and publish to a common private RSS feed:
- [Scheduling Engine](https://vita-docs.ham.xyz/scheduling.md): The Scheduling Engine (scripts/scheduling/) tracks frequency-based goals (like "haircut every 4 weeks" or "2 skating sessions per week"), detects when goals are drifting off-schedule, and suggests optimal times based on learned patterns. It
- [Board Meetings](https://vita-docs.ham.xyz/board.md): AI-facilitated board meetings where historical-figure personas (Stoic philosopher, investor, inventor, entrepreneur, TV host, president) deliberate on health and life decisions using Robert's Rules of Order. There is a pool of 7 personas, b
- [Self-Improvement](https://vita-docs.ham.xyz/improve.md): VITA is a self-improving personal health operating system. This document describes the proposal development, scoring, and agent-assisted refinement workflow that enables continuous system enhancement.
- [Stream Markup Capture](https://vita-docs.ham.xyz/stream-capture.md): Inline markup tags in Claude responses are extracted, persisted, and routed without interrupting conversational flow. This lets silicon-Zack embed structured data (observations, follow-ups, things to file) directly in responses. Tags are st
- [Photos, Faces & Events](https://vita-docs.ham.xyz/photos.md): End-to-end photo management: ingest from multiple sources, extract metadata via LLM vision, detect and cluster faces, organize into events, and browse via a multi-zoom timeline UI.
- [Reports & Presentations](https://vita-docs.ham.xyz/reports.md): vita's report system turns research, analysis, meetings, and operational evidence into durable artifacts: Markdown documents, designed HTML reports, HTML slide decks, and PDFs. Files on disk are the source of truth for report content. SQLit

## Autonomous Systems
- [Executive Loop](https://vita-docs.ham.xyz/executive.md): The Executive Loop is silicon-zack's autonomous self-direction engine. On a configurable schedule it gathers working memory, recent conversations, briefing data, and health signals, runs a full agent reflection cycle (Orient → Decide → Act
- [Sentinel Loop](https://vita-docs.ham.xyz/sentinel.md): A config-driven event detection and response system. Sentinels watch for changes across the vita ecosystem -- file drops, email arrivals, health anomalies, stale data -- and fire configurable responses: telegram messages, Claude prompts, or
- [Sleep Guardian](https://vita-docs.ham.xyz/sleep-guardian.md): The Sleep Guardian is a predictive sleep risk system that protects training capacity by scoring nightly risk, forecasting multi-day outcomes, and learning from prediction accuracy. It builds on the sleep gate -- a hard threshold that blocks
- [Homeostasis & Predictions](https://vita-docs.ham.xyz/homeostasis.md): The homeostasis subsystem makes a single claim from vita's manifesto measurable: that the sync between bio-zack and silicon-zack has a deviation that can be quantified and watched, not merely asserted. It has two parts — a falsifiable-predi
- [Coaching System](https://vita-docs.ham.xyz/coaching.md): Vita's coaching system generates contextual, identity-grounded coaching messages for active goals. It maps each goal to relevant identity data (observations, quotes), determines the coaching context (progress, stagnation, setback, etc.), an
- [Gap-Closer](https://vita-docs.ham.xyz/gap-closer.md): Gap-Closer is the active homeostasis system for what silicon-zack does not know about bio-zack. It turns unknown domains into ranked questions and reopens known-but-perishable beliefs when they age past their useful life. The goal is not a
- [Forge Workshop](https://vita-docs.ham.xyz/forge.md): The Forge is a problem-first idea workshop shared by bio-Zack and silicon-Zack. It forces discipline: start with problems, not solutions. Ideas flow through four active stages with strict WIP limits, preventing the graveyard problem where i
- [Research System](https://vita-docs.ham.xyz/research.md): The research system runs autonomous background research on topics derived from goals, projects, and heartbeat topics. It maintains a prioritized topic queue, executes LLM-powered analysis, stores findings in daily JSONL files, and synthesiz
- [Multi-Model Deliberation](https://vita-docs.ham.xyz/deliberation.md): vita can ask questions of AI models other than the one driving the session. The thesis is triangulation: different frontier models have different blind spots and strengths, so for a genuinely hard call, polling several and synthesizing thei
- [Agent Dispatch](https://vita-docs.ham.xyz/agent-dispatch.md): The Agent Dispatch system tracks Claude account capacity across multiple subscription accounts, identifies work that should be done when capacity is available, and fires that work as Stepwise flows in response to a daily digest that Zack ap
- [Consolidation Loop](https://vita-docs.ham.xyz/consolidation.md): Continuous micro-processing of conversation exhaust, scratch pad synthesis, and coaching map updates during waking hours. Instead of batching all data processing into the nightly /sleep cycle, the consolidation loop runs sub-tasks at stagge
- [Agent Mastermind](https://vita-docs.ham.xyz/mastermind.md): Agent Mastermind is Rick Gorman's multi-agent hub at agentmastermind.ai — a live experiment in agent self-organization, where autonomous systems review each other's PRs, propose changes, and operate under a shared written constitution. Vita

## Reliability & Verification
- [Verification & Anti-Lying](https://vita-docs.ham.xyz/verification.md): Vita's dominant systemic failure is not bugs — it is instrumentation lying: a surface that reports success it can't back, a fix claimed done that never went live, a working-memory file that recites a stale fact as current. The deepest form
- [Freshness Contract](https://vita-docs.ham.xyz/freshness.md): Every cached or derived surface vita renders — e-ink displays, memory views, briefing tiles, API responses, working memory — used to answer the question "can I trust this number?" on its own, or not at all. The freshness contract replaces N
- [Capacity Guard & Failover](https://vita-docs.ham.xyz/capacity-guard.md): Every autonomous surface in vita runs on a Claude account with usage limits. When an account exhausts, the surfaces that depend on it die — silently, and usually overnight. The capacity guard's job is stated plainly:

## Data Systems
- [Hybrid Search](https://vita-docs.ham.xyz/search.md): Hybrid search is silicon-zack's long-term memory. It indexes the entire data layer into a single SQLite database and retrieves over it with a hybrid of vector (semantic) and BM25 (keyword) search, fused by rank, decayed by recency, enriched
- [Document Filing](https://vita-docs.ham.xyz/document-filing.md): A scan-to-file pipeline. PDFs that arrive in silicon-zack's dedicated Fastmail inbox — sent by a scanner or forwarded from bio-zack's personal email — are classified by an LLM, renamed to a sortable standard format, uploaded to the right Go
- [Memory & Trends](https://vita-docs.ham.xyz/memory-trends.md): VITA extracts structured health data from PDFs (lab results, DEXA scans, VO2 max tests, imaging) and maintains longitudinal trend files for tracking changes over time. This enables pattern recognition across years of health data without re-
- [Browser Automation](https://vita-docs.ham.xyz/browser.md): VITA uses two browser tools with distinct roles. Route by task type — never use the deprecated CDP-shared-browser approach (the banned mcp__claude-in-chrome patterns).
- [Scratch Pads](https://vita-docs.ham.xyz/scratch-pads.md): Working memory for daily and weekly notes. The daily pad captures in-progress thoughts, actions, and observations throughout the day. The weekly pad accumulates via a nightly rollup that uses an LLM to summarize the day into the week. Both

## Hardware & Displays
- [E-ink Display](https://vita-docs.ham.xyz/eink.md): Vita drives multiple physical e-ink/e-paper displays as always-on ambient dashboards. Each device shows a different slice of the data without requiring any interaction. There are three displays: a 6-color PhotoPainter desk dashboard, an EPD
- [Precedent & Todo Console](https://vita-docs.ham.xyz/precedent.md): Precedent is an external task and habit management system backed by an Obsidian vault (markdown files) with a Flask API. Endpoints live under http://localhost:5424/api (overridable via the PRECEDENT_URL env var). It is the canonical source
- [Stream Dock & IoT Peripherals](https://vita-docs.ham.xyz/peripherals.md): vita drives a small fleet of physical desk hardware: a USB stream dock with programmable, dynamically-rendered buttons; an ESP32 "todo console" with OLED screens and hardware buttons that bridges to the task system; and a registry of WiFi I

## Reference
- [Interview Prompts](https://vita-docs.ham.xyz/interview-prompts.md): The interview system enables deep self-exploration through AI-conducted voice interviews. It manages structured prompts, stores transcripts, tracks domain coverage, and extracts identity-building artifacts like quotes and observations.
- [Weekly Summary](https://vita-docs.ham.xyz/week.md): Two distinct things in vita share the name "week," and they are easy to confuse:
- [Proactive Outreach](https://vita-docs.ham.xyz/proactive.md): Vita can reach out proactively via Telegram with scheduled messages. The system combines a SQLite message queue, dynamic message builders, voice composition, explicit admission and delivery gates, plus Adaptive Telegram Outreach (ATO) respo
- [Data Browser](https://vita-docs.ham.xyz/data-browser.md): The Data Browser is a web-based file explorer for viewing all Vita health data files. It provides a resizable split-pane interface with collapsible folder navigation, JSON syntax highlighting, and JSONL pagination for large log files.
- [Token Analytics](https://vita-docs.ham.xyz/tokens.md): Aggregates Claude CLI and OpenAI Codex CLI token usage from session logs into daily/monthly summaries, enabling cost tracking and usage pattern analysis across projects and models.
- [Insights & Patterns](https://vita-docs.ham.xyz/insights.md): The /insights command surfaces patterns, trends, and correlations from health data — what is changing, what correlates with what, and what might need attention. This page documents /insights itself plus the surrounding machinery it draws on
- [Project Registry](https://vita-docs.ham.xyz/project-registry.md): The project registry is the canonical list of every project bio-Zack works on. The heartbeat system layers on top of it, maintaining a queue of topics silicon-Zack wants to discuss periodically -- project interviews, follow-ups, check-ins,
- [Model Guidance](https://vita-docs.ham.xyz/model-guidance.md): Auto-maintained by flows/model-guidance-review (run via stepwise run flows/model-guidance-review --name model-review --wait). See the footer for methodology.
- [Model Benchmarks](https://vita-docs.ham.xyz/benchmarks.md): The benchmark suite measures language models against the work vita actually does — not against public leaderboards — across every harness vita runs. It answers two questions per use-case: which model is best? and what is the cheapest model
- [Skill Sharing](https://vita-docs.ham.xyz/skill-sharing.md): Skill Sharing packages one of Vita's agent skills as a public, browsable, agent-ingestible snapshot at https://vita-reports.ham.xyz/sk/<token>.
- [Capture, Commitments & Issues](https://vita-docs.ham.xyz/capture-commitments.md): vita has four lightweight tracking systems that share a design philosophy: filing is remembering. When bio-zack mentions a thought, a promise, a preference, or a bug, the right thing happens to a flat file on disk without ceremony. None of

## Generated references
- [Capability catalog](https://vita-docs.ham.xyz/api/capabilities/index.md): generated namespace and operation index
- [Capability JSON specification](https://vita-docs.ham.xyz/api/capabilities/spec.json): complete machine-readable contracts
- [MCP tool projection](https://vita-docs.ham.xyz/api/capabilities/mcp-tools.json): generated tool definitions for agents

## Optional
- [Full text — all pages concatenated](https://vita-docs.ham.xyz/llms-full.txt)