Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
PortOS Product Surface Map
PortOS is a local-first operating system for a developer's machines, work, and personal data. It unifies managed application lifecycles, autonomous agent delegation, a multi-modal creative production suite, personal knowledge and identity modeling, daily cognitive training, and federated peer operations into a single private-network platform.
This document is the canonical user-facing feature inventory for PortOS. It serves three primary functions:
- User & Contributor Orientation: A comprehensive map of every major surface, route, and capability in PortOS.
- Autonomous Repo-Study Reference: The canonical baseline consumed by the
repo-studytask (server/services/repoIntake.js) when studying external repositories (github.com / gitlab.com) to map new capabilities, enhancements, and UX patterns onto PortOS. - Architecture & Guide Index: Quick pointers to dedicated feature deep dives in
docs/features/and root architectural guides indocs/.
Operating Philosophy & Architecture Principles
- Local-First & Private Network: Every install runs locally behind a private network (Tailscale VPN) without public internet exposure. Mutual trust is scoped to authenticated tailnet peers.
- PostgreSQL as Primary Datastore: Mandatory local PostgreSQL with
pgvectorfor relational records, creative catalogs, and semantic embeddings. - No Cold-Bootstrap LLM Calls: PortOS never triggers unannounced AI provider calls on server boot or startup backfills. AI invocations require explicit user action, configured recurring schedules, or active CoS tasks.
- Deterministic & Local Model Acceleration: Heavy emphasis on local model execution (Ollama, LM Studio, vLLM, SGLang, llama.cpp) accelerated via speculative decoding (DSpark, DFlash 2, MTPLX) and local GPU/NPU utilization.
- Strict Privacy Boundaries: Sensitive identity records (PII Vault, Organizations, Data Brokers) remain strictly machine-local and never cross the federation layer or enter general LLM context prompts by default. Under an explicit double opt-in (
includePrivacyContext: trueplus fields flaggedshare_with_twin), permitted vault facts and organization/broker summaries are injected into the digital twin context for authorized Chief of Staff prompts.
1. Run and Manage Software (App Management & Dev Tools)
Manage local applications, terminal environments, system resources, and developer integrations.
| Surface / Page | Route(s) | Key Capabilities & Workflows | Related Guides |
|---|---|---|---|
| Dashboard | / |
System overview, active agent count, PM2 process vitals, Quick Capture widget, fast jump to recent projects. | ARCHITECTURE.md |
| Apps Manager | /apps, /apps/:id |
Managed app registry: launch, stop, restart processes, live process logs, environment variables, Git branch switcher, and per-app feature tabs. | PM2.md |
| App Templates & Scaffolding | /templates |
Pre-configured starter stacks (React, Vite, Node, Python) and interactive project scaffolding. | App Wizard |
| PortOS Submodules | /apps/portos-default/submodules, /devtools/submodules |
Git submodule management for PortOS and managed repositories, submodule update checks, and recursive synchronization. | CONTRIBUTING.md |
| Web Shell | /shell |
Browser-based interactive terminal multiplexer for host command execution and active debugging. | — |
| Process Manager | /devtools/processes |
Real-time PM2 process table, status inspection, memory/CPU usage, and manual process restarts. | PM2.md |
| System Resources & Health | /system-resources/overview, /system-resources |
Host-level operational signals, CPU/RAM utilization, disk thresholds, top processes, and running build/commit hash validation. | METRICS.md |
| Storage Report & Disk Cleanup | /system-resources/storage |
Comprehensive disk usage breakdown, cache directory inspection, AI-assisted cleanup triage, and temporary artifact removal. | STORAGE.md |
| Active Queues | /system-resources/queues |
Live inspection of background job queues (media renders, agent tasks, batch jobs), queue prioritization, and cancellation. | — |
| Uploads Staging | /uploads |
File upload manager and staging directory for media, documents, and datasets. | — |
| Activity & Action History | /devtools/history |
Historical audit log of user actions, system mutations, and automated tasks. | — |
| Code & Script Runner | /devtools/runner |
Ad-hoc code execution environment and script runner for quick operational utilities. | — |
| GitHub Integration | /devtools/github |
Pull request tracking, open issue triage, commit log browsing, branch switching, and upstream synchronization. | GITHUB_ACTIONS.md |
| JIRA Sprint Manager & Reports | /devtools/jira, /devtools/jira/reports |
JIRA sprint planning, active board triage, backlog management, velocity metrics, and sprint burndown reports. | JIRA Sprint Manager |
| DataDog Monitoring | /devtools/datadog |
APM dashboard, service error tracking, latency metrics, and synthetic monitoring. | — |
| GSD Project Planning | /cos/gsd, app tab |
"Get Stuff Done" hierarchical milestone tracking, project breakdown, and execution roadmaps. | — |
| Integration Flows | /devtools/flows |
Interactive visual architecture diagrams showing live data flows between PortOS subsystems and external services. | ARCHITECTURE.md |
| Browser Control | /browser |
Persistent managed Chrome instance over Chrome DevTools Protocol (CDP) for automated web extraction, UI testing, and assisted browsing. | Browser Management |
| Image Cleaner | /devtools/image-clean |
Strips metadata, C2PA, and Content Credentials from images; Sharp-based image optimization and denoising. | — |
| Video Downloader | /devtools/video-download |
Video and audio capture from YouTube, X.com, and web links via yt-dlp. |
— |
| Quota Burn Automation | /devtools/quota-burn |
Autonomous batch worker designed to consume subscription-backed AI CLI quotas (Claude Code, Codex, Grok, Antigravity) before reset windows expire. | QUOTA-BURN.md |
| Workspace Contexts | /workspace-contexts |
Fast workspace switcher restoring working Git branches, active shell sessions, task queues, and editor state. | — |
| API Explorer | /api-reference/catalog |
Native HTTP catalog, OpenAPI Internal/Exposed inventory, Socket.IO event catalog, and Agent Tools MCP semantic tool catalog. | API.md, API Tool Contract |
| Autofixer & Self-Healing | /settings/autofixer |
Background watchdog detecting PM2 process crash loops and executing self-healing diagnostic repair loops. | Autofixer, Error Handling |
2. Delegate Work to Agents (Chief of Staff & AI Delegation)
Submit tasks, manage durable autonomous agents, schedule recurring automations, and govern AI capabilities.
| Surface / Page | Route(s) | Key Capabilities & Workflows | Related Guides |
|---|---|---|---|
| Chief of Staff Tasks | /cos/tasks |
Task dispatch queue, priority scheduling (HIGH, MEDIUM, LOW), auto-execution vs user approval gates, task context preparation, and learning ETAs. | Chief of Staff, CoS Enhancement |
| Agent Runs & Feedback | /cos/agents |
Live streaming agent output, token counts, transcript inspection, and durable rating/feedback collection for continuous learning. | Agent Runner |
| Schedule Timeline & Workflows | /cos/workflow, /cos/schedule |
Visual Gantt-style schedule editor showing launch order, task dependencies, concurrency limits, and cron schedules. | Chief of Staff |
| Operational Briefings & Digest | /cos/briefing, /cos/digest |
Morning briefings of operational signals, system alerts, pending approvals, and end-of-day accomplishment rollups. | GOALS_OPERATIONAL.md |
| CoS Health & Diagnostics | /cos/health, /cos/jobs |
Agent runner daemon health, PM2 worker telemetry, background maintenance jobs, and queue diagnostics. | Agent Runner |
| Learning | /cos/learning |
Task duration models, success rate metrics, and category learning curves. | — |
| Persistent Mind | /cos/mind |
Resident long-term conversational AI agent with persistent context memory, annotation support, and continuous system oversight. | Agent Tools (MCP), Memory System |
| Mind Tools Governance | /cos/mind?panel=tools |
Fine-grained tool permission controls, MCP context disclosure settings (metadata-only vs redacted summaries), and semantic action grants. | Agent Tools (MCP), Agent Skills |
| Feature Agents | /feature-agents |
Durable, specialized agents assigned to specific feature domains or managed codebases. | — |
| Review Hub | /review |
Centralized triage inbox for agent-generated diffs, pull request reviews, approval requests, and code quality findings. | Review Queue Contract |
| Social Agents | /agents |
Autonomous agent personas for managing external social communications and community presence. | — |
| AI Providers & Model Runner | /ai |
Multi-provider configuration supporting CLI agents (Claude Code, Codex, Antigravity, OpenCode), cloud APIs (OpenAI, Anthropic, Gemini, Grok), and local endpoints (Ollama, LM Studio, vLLM, SGLang). | Claude on Ollama |
| Prompt Manager | /prompts |
Reusable prompt template library, variable substitution engine, prompt versioning, and auto-upgrade migrations. | Prompt Manager |
| Runs & Run Events Ledger | /cos/runs, /cos/run-events |
Comprehensive ledger of past and in-flight AI runs, lifecycle event replay, and orphaned process recovery. | — |
| Code Reviewers | /settings/code-reviewers |
Configurable multi-reviewer chain (Copilot, Claude, Antigravity, Codex, Grok, Cursor, OpenCode, Kimi, LM Studio, Ollama, MTPLX) with stop conditions, max rounds, per-reviewer model/effort pins, dispute workflows, and the goal-fidelity gate that re-reads a finished CoS run's diff against the task's stated objective (ship / fix-first / rethink) and can, on a finding, file an issue on the project's own tracker (GitHub / GitLab / JIRA, deduplicated by a key carried in the issue body) and/or queue an agent to reconcile it. That agent checks the finding first: when the objective turns out to have been delivered and the reviewer misjudged it, it reports which context the reviewer was missing instead of shipping a change, and PortOS queues a calibration task against its own repo to close that blind spot — deduped on the gap, so many false positives from one cause fold into one fix. |
— |
3. Create Stories, Media, Music, and Games (Create Suite)
An end-to-end creative production suite for authors, worldbuilders, filmmakers, musicians, and game developers.
| Surface / Page | Route(s) | Key Capabilities & Workflows | Related Guides |
|---|---|---|---|
| Start a Story | /start-story |
Creative onboarding on-ramp: choose between guided story building, Writers Room prose, FableLoom branching narrative, or manuscript import. | — |
| Story Builder | /story-builder |
Step-by-step guided story wizard: concept ideation, universe attachment, character arc design, reader emotional mapping, and episode outlines. | — |
| Writers Room | /writers-room |
Focused Markdown prose studio: version history, structural analysis, emotional roadmaps, and timed sprint exercises ("write for 10"). | Writers Room |
| Writers Room Guide | /writers-room/guide |
Craft reference guide: word count standards (flash fiction to epic novel), length targets, and narrative pacing rules. | Writers Room |
| Authors Management | /authors |
Author personas, bylines, pen names, distinct literary writing styles, and cover metadata. | — |
| FableLoom | /fableloom |
Interactive branching fiction engine: visual story graph editor, choice tree logic, intent routing, and node-based reader. | FableLoom |
| Manuscript Importer | /importer |
Ingests external manuscripts, screenplays, novels, and comic scripts to extract characters, locations, lore, and structural scenes. | — |
| Series Pipeline | /pipeline |
Multi-issue/episode production tracking, comic script staging, storyboard generation, and visual prompt conditioning. | — |
| Editorial Checks | /pipeline/editorial-checks |
Deterministic and LLM-assisted linting for exposition dumps, character naming collisions, pacing flaws, and continuity drift. | — |
| Series Continuity Bible | /pipeline |
Canon facts ledger, timeline verification, prop and wardrobe tracking, and character knowledge-leak prevention. | — |
| Voice Fingerprint | /pipeline |
Prose style analytics: sentence rhythm, syntactic complexity, register consistency, and vocabulary outlier detection across chapters. | — |
| Prose Series Export | /pipeline |
Compile engine outputting formatted ePub, trade paperback interior PDF (custom trim sizes, front matter, TOC), and print-ready bundles. | — |
| Universes & Canon | /universes, /universes/:id |
Worldbuilding bibles: sci-fi/fantasy lore, style templates, canon entries, characters, settings, and visual consistency anchors. | — |
| Creative Catalog | /catalog, /catalog?settings=1 |
Searchable relational entity database (characters, places, objects, lore, scenes) with vector search and taxonomy management. | STORAGE.md |
| Catalog Ingest | /catalog/ingest |
Paste unstructured scraps, scenes, or notes to automatically extract structured catalog ingredients. | — |
| Mood Boards | /mood-boards |
Visual pinboards and reference collections. Generate more writes 1–4 new image prompts with a selectable LLM from saved reference descriptions, then queues images through configured imagegen settings, with 16:9 defaults, progress and retries that preserve references. Each pin and the whole board can be turned into a prompt; the board composes those prompts into one style and can render it as a canonical poster on any configured image service. | — |
| Media Gen (Image & Video) | /media, /media/image, /media/video |
Local and federated text-to-image (Stable Diffusion, FLUX, MFLUX) and text-to-video (LTX-Video, MiniMax H3) generation. | Video Speed Profiles, Video Text Encoders |
| Media History & Timeline | /media/history, /media/timeline |
Asset gallery, multi-track video timeline editor, clip trimming, audio overlay, and video stitching. | — |
| Image Annotation | /media/annotate |
Canvas drawing, sketch-over, visual markup, and region labeling for image conditioning. | — |
| Media Collections | /media/collections |
Visual asset organization, project stacks, and media albums. | — |
| 3D Meshes & Three.js | /3d, /media/threejs |
Neural image-to-3D mesh generation (TRELLIS, Pixal3D) and procedural Three.js 3D model generation with interactive WebGL preview. | Three.js Models |
| Game Studio & Sprites | /game, /sprites |
2D game asset creation: 8-directional sprite sheets, animation tracks (walk cycles, idle, actions), atlas compilation, and game asset bundles. | Sprite Export Contract |
| Music Studio & Designer | /music, /music/generate |
Local and federated AI music synthesis (Ace-Step, AudioLDM, MusicGen), prompt enrichment, lyric generation, and reference-track style matching. | Music Renderer Benchmarks, Federated Media Providers |
| Music Catalog | /music/artists, /music/albums, /music/tracks |
Virtual artist personas, discographies, album cover art, tracklists, and audio streaming player. | — |
| Rounds & Rounds Guide | /rounds, /rounds/guide |
Composition and learning tool for a cappella musical rounds, multi-part vocal harmonies, lead sheets, and solfège notation. | — |
| SongBook | /songbook |
Interactive chord charts, guitar tablature, lyric repertoire, and auto-scrolling practice sheet music. | — |
| Creative Director | /creative-director |
Multi-scene episodic video production orchestrator: turn briefs into treatments, storyboards, render plans, and completed episodes. | — |
| Creative Commissions | /creative-commission |
Standing briefs and scheduled/nightly autonomous media generation aligning with personal taste profiles and feedback. A universe and/or mood board can be picked as the style source: each run loads its style tags and reference images as the Creative Director's art-direction base, attaches those images to vision scene evaluation, and conditions local image renders on them. | — |
| Music Video Studio | /music-video |
A project is six deep-linked steps (/music-video/:projectId/:stage — Song setup, Look cast-sets, Storyboard board, Make produce, Final render review, Publish publish; an old compose link opens Make), listed down the left with a state word and one fact each (a bottom icon bar on a phone). Each step opens with what "done" means and an always-visible checklist, and ends with its own approval (art on Look, the timed storyboard on Storyboard; an animated proof on Make is optional and never holds the final render). Approvals never require typed notes. A sticky header gives one status line ("Step 3 of 6: Storyboard needs you"), the one next action, an Autopilot button, paid-generation spend against the cap and Project settings — a drawer holding the render style and services, advanced audio tools, the autopilot brief and runs, and every development file, the external handoff and the making-of export; a Needs attention banner under that status line lists any state a half-finished workflow left on the server — an open revision, an interrupted Cast & Sets stage, an auto-review waiting for its revised sections, a final render nobody is watching — with its Resume / Continue / Cancel / Reattach inline, derived from the saved record so it survives a reload; a preview player is docked beside every step — the final render, the live composition document, each finished draft excerpt and, before anything is rendered, a storyboard animatic (the song under each shot's frame or card), picked from the dock (?play=) — and scene cards seek it. Audio-reactive video creation, beat-detection synchronization, scene choreography, tempo alignment, and audience-driven pre-production treatments that direct each shot. Scenes are cutaways or lip-synced performance shots; a performance shot renders only on a verified source-audio provider (fal.ai MiniMax H3 lip-sync, 5–14.8s song slices placed at an exact edit in-point, cut from an optional full-length vocal stem when one is attached — uploaded, or separated from the song with a locally installed demucs; or free on local LTX-2.5 / LTX-2.3 dgrauet audio-to-video, up to 20s per take, with the song slice held fixed through both denoise passes) — Grok video is cutaway-only. The autopilot kickoff analyzes the song, imports the linked track's lyric sheet (its [Verse]/[Chorus] headers and stage directions kept as lyric markers that name the analysis sections and steer shot framing), separates the vocal, aligns the known lyrics to the vocal stem with local MMS_FA CTC (downloaded on first use, a garbage token between lines absorbs instrumental gaps; standalone alignment asks for Demucs htdemucs_ft consent before creating a missing stem), builds a Cast & Sets check-in (one creative-direction call that interprets the song, then a canonical character sheet, expression and looks sheets, one empty plate per set and in-set tests on the image queue, each later image conditioned on the character sheet; assembled into a self-contained sheet saved as a development artifact), stops for the director's review unless the brief auto-approves it, then plans against the approved references. Development artifacts (check-in sheets, animatics, treatments, storyboards; HTML/Markdown/MP4/PNG/JPG) are versioned per project, reviewed with notes and approve/request-changes, and viewed in a sandboxed viewer at /music-video/:projectId/:stage/dev/:artifactId (the stage-less /music-video/:projectId/dev/:artifactId still opens it). Draft excerpts are reviewed and selectively revised by hand, or by an opt-in auto-review run bounded by director-set review and paid-generation limits (a frame-only look never passes motion or audio sync). A run started from the board generates its revised sections on the server too (#10014), routed from the project's saved image and video pins, so it completes with no tab open; a section that cannot be generated unattended (a synchronous image backend, a clip lane only the board can submit) parks the run as needing the director, with the reason named. A server-owned production run (/api/music-video/:id/production-runs, #9066) plans an empty board, generates missing frames and clips only on a director-allowed image/video provider+model pool, hands the continuous draft to auto-review and dispatches its revisions — within explicit generation, review and (priced routes only) dollar limits, without the browser open, and never resuming on its own after a restart; the song is the sole audio unless a sound-design bed is explicitly chosen to mix under it. A footage or composed render can intercut (#9290): shots are re-cut on the song's section energy (every 2 beats in the loudest quarter, up to every 8 in the quietest) and on sung word onsets, alternating the host shot — a lip-synced take stays in sync — with unshown footage from a cutaway in the same section, so the edit gets faster without generating more clips; an autopilot production run defaults to it unless the director chose one cut per shot. Lyric lines sung two or more times are hooks: the treatment's text cues give them a word-by-word build (#9291) — each word lands on its sung onset in heavy caps, the newest in the accent color. Draft excerpts can be re-framed as vertical or square social cuts with faded audio edges, from suggested hook windows (#9280). The Autonomous entry point (docs/features/music-video-autonomous.md) starts from one prompt instead of a chosen track: it writes the brief, lyrics and a mood board, makes the song in Suno through the PortOS Browser, and runs the production — with optional approval checkpoints, and a music-video-autopilot scheduled task that turns unused Brain ideas into videos. The Publish stage (#9281) builds a release kit from the final render: an X-sized 1080p, a 720p preview, a hook teaser, thumbnail candidates, lyric captions (SRT) and YouTube chapters. It also drafts every platform's copy in one director-triggered provider call from their own making-of notes, and every field stays editable. Posting (#9282) fills each platform's post (YouTube, Suno, an X thread, LinkedIn, Facebook, Shorts, TikTok, Instagram Reels, Reddit, Stacker News, Substack, DistroKid) in a new PortOS Browser tab with the director's signed-in sessions, shows a screenshot and summary of the filled draft, and posts only when the director presses Post for that draft; the posted links are kept on the project. Reddit defaults to a native video post in r/aivideo — title and flair, no body — through the new composer's own Video button (#9307). Platforms are opt-in (#9287): a "Where you post" list turns each one on (all start off) and optionally names the account posted as — X and Reddit drafts filled while signed in as someone else are refused. Copy is drafted and posts are offered only for enabled platforms. Each post (including one recorded by hand) can be rated good, mixed or poor with notes; ratings roll up per platform across projects and are passed to later copy drafts. |
— |
| Sharing & Conflict Resolution | /sharing, /sharing/duplicates, /sharing/conflicts |
Collaborative asset exchange via cloud storage buckets (Google Drive, Dropbox, iCloud, Syncthing) with duplicate reconciliation and conflict recovery journals. | — |
4. Personal Knowledge, Life Modeling, Identity, & Health
Capture thoughts, build personal memory graphs, model your identity and taste, protect private data, and monitor physical vitality.
| Surface / Page | Route(s) | Key Capabilities & Workflows | Related Guides |
|---|---|---|---|
| Brain Inbox & Notes | /brain/inbox, /brain/notes |
Universal thought capture, AI classification (People, Projects, Ideas, Admin), confidence scoring, note editor, and GTD reviews. | Brain System |
| Brain Links & Repo Ingest | /brain/links |
Link vault with automated malware scanning, web clipping, and repo study triggers. | Brain System |
| YouTube Transcripts & Ingest | /brain/config, /brain/youtube |
Captures YouTube video transcripts (collapsing auto-caption repetition), downloads audio/video, mirrors markdown to Obsidian, and syncs watch history. | Brain System |
| Feeds & RSS | /brain/feeds |
RSS/Atom feed reader, article capture, and knowledge extraction. | — |
| Knowledge Graph | /brain/graph, /wiki/graph |
Interactive visual graph of entities, tags, and cross-document semantic links. | — |
| Daily Log & Digest | /brain/daily-log, /brain/digest |
Daily markdown journaling, automated daily summaries, and weekly GTD-style reviews. | Brain System |
| Rapid Reader | /rapid-reader |
RSVP (Rapid Serial Visual Presentation) speed-reading engine with adjustable WPM and focal point markers. | — |
| Trust & Verification | /brain/trust |
Audit trail of AI classification decisions and source credibility records. | Brain System |
| Third-Party Import | /brain/import |
Ingests ChatGPT and OpenAI export archives into structured Brain memory. | — |
| Activity Timeline | /timeline |
Unified chronological human activity ledger aggregating events from iMessage, Signal, WhatsApp, Spotify, Discord, YouTube, and Calendar. | — |
| Tribe Relationship Manager | /tribe |
Dunbar-number social network management, relationship health scores, care cadence reminders, and contact resolution. | — |
| Multi-Scale Calendar | /calendar/* |
Time management across Agenda, Day, Week, Month, and Lifetime perspectives, periodic reflection reviews, external sync (iCal/CalDAV/Google), and a one-click Join meeting action on event details for Google Calendar events that carry a conference link. | — |
| Digital Twin Profile & Identity | /digital-twin/overview, /digital-twin/identity, /digital-twin/autobiography, /digital-twin/personas, /digital-twin/taste, /digital-twin/goals |
Core identity attributes, autobiography, dynamic personas (professional, casual, creative), quantified aesthetic taste, and personal goals. | Digital Twin, Identity System |
| Twin Presence & Avatars | /digital-twin/appearance, /digital-twin/avatar-bio, /digital-twin/voice |
Visual appearance reference photos, live avatar bios (HeyGen, Tavus, Simli, ElevenLabs), and comparative spoken-vs-written voice fingerprinting. | Digital Twin |
| Personality & Assessment | /digital-twin/personality, /digital-twin/test |
Big Five (OCEAN) quantitative trait scoring, values hierarchy, model sycophancy comparison radar, and automated behavioral test suites. | Digital Twin, Soul System |
| Knowledge Sources & Interviews | /digital-twin/documents, /digital-twin/interview, /digital-twin/enrich, /digital-twin/import, /digital-twin/accounts |
Soul document manager (SOUL.md, VALUES.md), interactive AI-driven life interviews, enrichment questionnaires, and external data imports (Goodreads, Spotify, Letterboxd, iCal). |
Soul System |
| Ask Yourself & Character Chat | /ask, /character |
Conversational reflection interface allowing you to chat directly with your modeled digital twin or authored characters. | Digital Twin |
| Legacy Bundle & Time Capsule | /digital-twin/legacy, /digital-twin/time-capsule, /digital-twin/export |
Portable, self-contained legacy archive bundle, time capsule snapshots, and PDF summaries. | Digital Twin |
| Privacy Center Overview | /privacy/overview |
PII exposure summary, personal data inventory, and strict machine-local isolation gates. | Privacy Center, Privacy ADR |
| PII Encrypted Vault | /privacy/vault |
Encrypted-at-rest vault for sensitive identity numbers (passports, SSNs, financial IDs, private addresses). | Privacy Center |
| Organizations Registry | /privacy/organizations |
Catalog of third-party institutions holding personal data, tracking data retention policies and account numbers. | Privacy Center |
| Changes Workflow | /privacy/changes |
Change-of-address and contact update tracking matrix across all registered organizations. | Privacy Center |
| Data Brokers Registry | /privacy/brokers |
Removal tracking and opt-out status for people-search sites and data aggregators (CCPA/GDPR). | Privacy Center |
| Cross-Domain Insights & Goals | /insights/*, /goals/list, /goals/tree |
Correlation engine linking genetics, chronotype, lifestyle, aesthetic taste, and hierarchical goal trees with alignment scorecards. | Identity System |
| Health & Biomarkers (MeatSpace) | /meatspace/* |
Personal vitals, blood biomarker panels, lifestyle tracking, biological age computation, substance logging (alcohol, nicotine), and 23andMe genomic marker analysis (117 curated SNPs across 32 categories). | POST |
| Clinician Health Export | /meatspace/export |
Generation of doctor-ready clinical PDF health summaries. | — |
| MortalLoom Sync | /settings/mortalloom |
Longevity modeling and iCloud HealthKit synchronization. | — |
5. Cognitive Training (POST — Power On Self Test)
A daily cognitive training and self-test system designed to build and measure cognitive endurance, verbal fluency, and executive control.
| Surface / Drill Domain | Route(s) | Key Capabilities & Workflows | Related Guides |
|---|---|---|---|
| POST Launcher & Library | /post/launcher, /post/explore, /post/plan |
5-minute daily training sessions, custom study curriculum, and exploratory drill catalog. | POST System |
| Mental Math | /post/launcher |
Timed mental arithmetic: doubling chains, serial subtraction, multiplication, powers, and numerical estimation. | POST System |
| Memory Builder & "The Elements" | /post/memory, /post/memory/elements/* |
Progressive recall training for structured texts and poetry; dedicated module for Tom Lehrer's "The Elements" (flash cards, lyric recall, and learn modes). | POST System |
| Morse Code (CW) Trainer | /post/morse/* |
Koch method audio decoding, audio-only head copy, straight-key keyboard transmission, and visual reference charts (binary tree, symbol length, alphabet table). | POST System |
| Rhetoric & Prose Meter | /post/rhetoric/* |
Iambic pentameter rhythm calibration, rhetorical figure generation (diacope, chiasmus, progressia), and divergent angle brainstorming. | POST System |
| Wordplay & Verbal Agility | /post/wordplay/* |
Compound word chains, linking bridge words, pun & double-meaning generation, and idiom domain-twisting. | POST System |
| Cognitive & Executive Control | /post/launcher |
Deterministically scored drills: N-back, digit span, Stroop effect, Schulte tables, mental rotation, reaction time, Task Switching, Go/No-Go inhibition, and Flanker control. | POST System |
| Progress & Session History | /post/progress, /post/progress/sessions |
Accuracy trends, response speed analytics, streak tracking, and session attempt logs. | POST System |
6. Communications, Voice, Social, & Spatial UI
Unified communication channels, local voice assistant, community stewardship, and 3D spatial navigation.
| Surface / Page | Route(s) | Key Capabilities & Workflows | Related Guides |
|---|---|---|---|
| Comms Inbox & Drafts | /messages/inbox, /messages/drafts, /messages/sync |
Centralized message triage, drafting assistant, and cross-channel message synchronization. | Messages Security |
| iMessage Sync & Contacts | /messages/imessage, /messages/contacts |
Local macOS chat.db SQLite ingestion, sender identity resolution, spam filtering, and address book contact merging. |
Messages Security |
| Signal Integration | /messages/signal |
Read-only SQLCipher snapshot of the local Signal Desktop database, including committed WAL messages, into Tribe and the activity timeline. Fails setup instead of ingesting a partial copy when the bundled driver cannot capture a consistent view. | Messages Security |
| Beeper Bridge | /messages/beeper, /messages/beeper?settings=1 |
Local Beeper Desktop bridge mirroring WhatsApp, Discord, Telegram, and other bridged networks into a machine-local store, with a human-gated one-message-at-a-time outbox; the settings drawer connects an account and configures scheduled sync. | Beeper |
| Telegram & X (Twitter) | /settings/telegram, /x |
Social channel monitoring, outreach staging, engagement diagnostics, and shadowban checks. | — |
| Stacker News Stewardship | /stacker-news |
Community territory moderation, Bitcoin Lightning tipping, post review, and encrypted credential storage. | Stacker News |
| OpenClaw Operator Chat | /openclaw |
Real-time interactive operator agent runtime with streaming sessions and persistent execution. | OpenClaw Operator Chat |
| Evergreen Personal Wiki | /wiki/* |
Curated personal knowledge base with markdown editing, link graphs, and full-text search. | — |
| Voice Mode | /settings/voice |
Hands-free voice assistant with continuous VAD (AudioWorklet), speech-to-text (Whisper local or Web Speech), local LLM orchestration, text-to-speech (Piper or Qwen3-TTS), barge-in support, and ui_navigate tool execution. |
Voice Mode |
| Ambient Display Mode | /ambient |
Fullscreen idle dashboard, ambient animations, system status ticker, and display screensaver. | — |
| Eidoverse Worlds | /eidoverse |
Private, install-local 3D world for the human and Persistent Mind/CoS agents, with durable name-based identity, world history, deterministic PortOS resource projection, and governed world augmentation. | Eidoverse Worlds |
| OpenWorld (retired compatibility surface) | /openworld, /city |
Historical Three.js / React Three Fiber world; legacy routes redirect to Eidoverse so existing bookmarks remain usable. | OpenWorld |
7. System Infrastructure, Local Models, & Federation
Local AI model acceleration, multi-machine peer federation, storage classification, backup, and security.
| Surface / Area | Route(s) | Key Capabilities & Workflows | Related Guides |
|---|---|---|---|
| Local LLM Runtimes | /models/llms-runtimes |
Management of local model servers: Ollama, LM Studio, llama.cpp / llama-server, MTPLX, and Slotstream (SSD-streaming MoE for checkpoints larger than RAM). vLLM and SGLang have no rows here — their setup and start controls live in the AI Providers readiness checklist. | Claude on Ollama, MTPLX, Slotstream |
| Model Library | /models/llms |
The Ollama / LM Studio weights catalog — find, install, compare, and remove models — plus the Abuse Guard classifier at /models/llms/abuse. |
Claude on Ollama |
| Speculative Decoding | /models/llms-runtimes |
Accelerated token generation using DSpark, DFlash 2, and MTPLX speculative drafting pairs. | DFlash2 & DSpark, MTPLX, RTX 3090 vLLM, SGLang Qwen |
| Embeddings Management | /models/embeddings |
Local text embedding models (Nomic, Ollama) and pgvector semantic index configuration. | STORAGE.md |
| LoRAs & Model Training | /models/loras, /models/training |
LoRA adapter discovery, Civitai downloads, image captioning, and local FLUX LoRA training dataset management. | — |
| Media Models Storage | /models/media |
Hugging Face cache management and storage inspection for image/video diffusion models. | — |
| Model Status & VRAM | /models/status |
Live resident VRAM/RAM inspection, model unloading, and memory optimization. | — |
| Performance Benchmarks | /models/performance |
Automated throughput measurement (tokens/sec, chars/sec, TTFT) across models and engines. | — |
| LLM Playground | /local-llm/playground |
Side-by-side prompt testing, latency benchmarking, and model evaluation. | — |
| 3D Neural Runtimes | /models/3d |
TRELLIS and Pixal3D image-to-3D on-device installation and diagnostics. | Three.js Models |
| Instances & Peer Federation | /instances, /settings/sharing |
Multi-install peer federation across Tailscale VPN, capability discovery, and federated media generation offloading. | FEDERATED_MEDIA_PROVIDERS.md |
| PostgreSQL Datastore | /settings/database |
Mandatory local PostgreSQL datastore with pgvector extension, migrations, and storage classification contract. | STORAGE.md, Postgres ADR |
| Backup & Restore | /settings/backup |
Automated filesystem rsync snapshots and database dumps with point-in-time restore. | BACKUP.md |
| Security & Trust Model | /settings/security, /security |
Opt-in instance password authentication, TLS certificates (setup:cert), Tailscale trust boundary, port allocation, and audit logs. |
SETUP.md, PORTS.md, REMOTE_DESKTOP.md |
8. Repo-Study Mapping Guide (for Agents & Contributors)
When performing a repo-study task (server/services/repoIntake.js) or proposing new integrations, map the external repository or concept to PortOS surfaces using the following matrix:
| External Repository Domain | Target PortOS Product Surface(s) | Primary Lens & Considerations |
|---|---|---|
| 3D Scenes, WebGL, Game Engines | Create → 3D & Sprites (/3d, /sprites, /game) or Main → Eidoverse Worlds (/eidoverse) |
Visual asset pipeline, procedural geometry, Three.js shaders, low-poly rendering, and install-local PortOS world projection. |
| Chatbots, Conversational LLMs, Assistants | Chief of Staff → Persistent Mind (/cos/mind) or Settings → Voice (/settings/voice) or Settings → OpenClaw (/openclaw) |
Context memory, MCP tool calling, speech-to-text/text-to-speech integration, barge-in support. |
| Note-Taking, Markdown Wikis, Second Brains | Brain → Inbox & Notes (/brain/*) or Brain → Wiki (/wiki/*) or Brain → Rapid Reader (/rapid-reader) |
Knowledge graphs, AI thought classification, RSVP speed-reading, Obsidian sync. |
| Writing Tools, Fiction Generators, Storyboarding | Create → Writers Room (/writers-room), Story Builder (/story-builder), or FableLoom (/fableloom) |
Prose editing, chapter versioning, interactive branching graphs, character consistency. |
| Comic & Series Pipelines, Script Analysis | Create → Series Pipeline (/pipeline) or Importer (/importer) |
Editorial linting, continuity bibles, voice fingerprinting, ePub/PDF compilation. |
| Music Synthesis, Audio Generation, Tablature | Create → Music (/music/*), Rounds (/rounds), or SongBook (/songbook) |
Model renderers (Ace-Step, AudioLDM), chord charts, vocal round harmony, lyrics conditioning. |
| Diffusion Models, Video Samplers, LoRAs | Create → Media Gen (/media/*), Creative Director (/creative-director), or Models (/models/*) |
Speed profiles, prompt conditioners, LoRA training datasets, multi-track timeline editing. |
| Quantified Self, Health, Biometrics, Habits | Health → MeatSpace (/meatspace/*) or Identity → Insights (/insights/*) |
Biomarker tracking, 23andMe genomic analysis, chronotypes, doctor-ready PDF exports. |
| Cognitive Drills, Flashcards, Brain Training | POST → Cognitive Training (/post/*) |
Spaced repetition, mental math, Morse code audio/keying, rhetorical exercises, executive control tests. |
| Task Queues, Autonomous Workflows, CRON | Chief of Staff → Tasks & Schedule (/cos/*) |
Priority dispatch, approval gates, Gantt schedule timeline, learning ETAs. |
| Terminal Multiplexers, Process Managers | Dev Tools → Shell & Processes (/shell, /devtools/processes) |
Web shell UX, PM2 telemetry, log streaming, autofixer repair loops. |
| PII Protection, Password Managers, Opt-Outs | Identity → Privacy Center (/privacy/*) |
Encrypted-at-rest Vault, organization registry, data broker removal tracking. |
| Social Media Tools, Community Platforms | Comms → Stacker News (/stacker-news), Messages (/messages/*), or X (/x) |
Community moderation, Lightning tipping, local SQLite message sync (iMessage, Signal). |
| Remote Companion Apps, Mobile UIs | Infrastructure & Companion API (docs/COMPANION_APP_API.md, docs/REMOTE_DESKTOP.md) |
PortDeck iOS companion API, VNC remote desktop broker, Bonjour discovery. |
Repo-Study Evaluation Principles:
- Identify the Core Surface: Ground every recommendation in PortOS's actual code and surfaces before filing.
- Clean-Room Reimplementation: Never copy code, prose, or assets from third-party repositories. Propose clean-room designs that integrate with PortOS's existing architecture.
- Respect Operational Constraints: PortOS is a single-user, private-network application. Do not propose multi-tenant SaaS features, rate limiting, or cold-bootstrap LLM calls.