diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml
index 33ae094b..7611c254 100644
--- a/.github/ISSUE_TEMPLATE/bug-report.yml
+++ b/.github/ISSUE_TEMPLATE/bug-report.yml
@@ -8,21 +8,21 @@ body:
       value: |
         Thanks for reporting a bug. Keep it short — we only need enough to reproduce it.
 
-        If the desktop app starts, please consider attaching your OpenPets log. It is not required, but it is highly recommended because it often explains startup, tray, pet display, and integration issues.
+        If the desktop app starts, please consider attaching your FamiliarOS log. It is not required, but it is highly recommended because it often explains startup, tray, familiar display, and integration issues.
 
-        To find it: open OpenPets from the tray/menu bar, choose **Open Logs Folder**, then attach `openpets.log` to this issue. If OpenPets cannot start, check these folders manually:
-        - macOS: `~/Library/Application Support/OpenPets/logs/`
-        - Windows: `%APPDATA%\OpenPets\logs\`
-        - Linux: `~/.config/OpenPets/logs/`
+        To find it: open FamiliarOS from the tray/menu bar, choose **Open Logs Folder**, then attach `familiaros.log` to this issue. If FamiliarOS cannot start, check these folders manually:
+        - macOS: `~/Library/Application Support/FamiliarOS/logs/`
+        - Windows: `%APPDATA%\FamiliarOS\logs\`
+        - Linux: `~/.config/FamiliarOS/logs/`
 
-        If the problem happened before the latest restart, `openpets.previous.log` may also be useful.
+        If the problem happened before the latest restart, `familiaros.previous.log` may also be useful.
 
   - type: textarea
     id: what-happened
     attributes:
       label: What happened?
       description: Describe the bug. Include your OS/app version if you know it.
-      placeholder: "The desktop pet disappeared after..."
+      placeholder: "The desktop familiar disappeared after..."
     validations:
       required: true
 
@@ -30,7 +30,7 @@ body:
     id: logs
     attributes:
       label: Logs (optional, highly recommended)
-      description: Attach openpets.log if you can. If the app cannot start or you cannot find it, leave this blank.
-      placeholder: "Drag openpets.log here, or paste the most relevant lines."
+      description: Attach familiaros.log if you can. If the app cannot start or you cannot find it, leave this blank.
+      placeholder: "Drag familiaros.log here, or paste the most relevant lines."
     validations:
       required: false
diff --git a/.github/ISSUE_TEMPLATE/feature-request.yml b/.github/ISSUE_TEMPLATE/feature-request.yml
index beee65cf..20cb5e54 100644
--- a/.github/ISSUE_TEMPLATE/feature-request.yml
+++ b/.github/ISSUE_TEMPLATE/feature-request.yml
@@ -1,5 +1,5 @@
 name: Feature request
-description: Suggest an improvement for OpenPets.
+description: Suggest an improvement for FamiliarOS.
 title: "Feature: "
 labels: ["feature"]
 body:
@@ -13,7 +13,7 @@ body:
     attributes:
       label: What do you want?
       description: Describe the feature or change you would like to see.
-      placeholder: "I want OpenPets to..."
+      placeholder: "I want FamiliarOS to..."
     validations:
       required: true
 
diff --git a/.github/ISSUE_TEMPLATE/submit-pet.yml b/.github/ISSUE_TEMPLATE/submit-pet.yml
index 4b333ced..3d3f88c4 100644
--- a/.github/ISSUE_TEMPLATE/submit-pet.yml
+++ b/.github/ISSUE_TEMPLATE/submit-pet.yml
@@ -1,18 +1,18 @@
-name: Submit a pet
-description: Suggest a pet for the OpenPets gallery.
-title: "Pet submission: "
-labels: ["pet submission"]
+name: Submit a familiar
+description: Suggest a familiar for the FamiliarOS gallery.
+title: "Familiar submission: "
+labels: ["familiar submission"]
 body:
   - type: markdown
     attributes:
       value: |
-        Thanks for suggesting a pet. Keep it short — we only need the essentials.
+        Thanks for suggesting a familiar. Keep it short — we only need the essentials.
 
   - type: input
-    id: pet-idea
+    id: familiar-idea
     attributes:
-      label: Pet idea or name
-      description: What should the pet be called, and what is it?
+      label: Familiar idea or name
+      description: What should the familiar be called, and what is it?
       placeholder: "Pixel Penguin — a tiny penguin coding companion"
     validations:
       required: true
diff --git a/.slim/codemap.json b/.slim/codemap.json
index 3924058e..21f0cffd 100644
--- a/.slim/codemap.json
+++ b/.slim/codemap.json
@@ -2,7 +2,7 @@
   "metadata": {
     "version": "1.0.0",
     "last_run": "2026-05-24T09:29:48.346Z",
-    "root": "/Volumes/external/repos/pets",
+    "root": "/Volumes/external/repos/familiars",
     "include_patterns": [
       "apps/**/*.ts",
       "packages/**/*.ts",
@@ -32,21 +32,21 @@
     "apps/desktop/contracts/local-ipc-protocol.contract.ts": "76d45670b202ebd96cbee64d1e8e53ec",
     "apps/desktop/contracts/plugin-manifest.contract.ts": "2b0eaa64d1e02dce6b14cfee9c6d2b3d",
     "apps/desktop/package.json": "b83883566725e5c9a97fc9d7b5fd189a",
-    "apps/desktop/src/agent-pet-controller.ts": "179491dc5e838b5cf042b4630380d1e5",
+    "apps/desktop/src/agent-familiar-controller.ts": "179491dc5e838b5cf042b4630380d1e5",
     "apps/desktop/src/agent-setup.ts": "c2193dd06fa7686b4446ea7dc5686b92",
     "apps/desktop/src/app-state-core.ts": "9f4ea019ddb620bf8ad70dfe83f27496",
     "apps/desktop/src/app-state.ts": "89a68328e992076d114b90de5b8fbe1b",
     "apps/desktop/src/assets.ts": "d59129388a45ae10b5319242fd7a67ee",
-    "apps/desktop/src/built-in-pet.ts": "eff5b3375b2a9eccad401f6048c9c5f1",
+    "apps/desktop/src/built-in-familiar.ts": "eff5b3375b2a9eccad401f6048c9c5f1",
     "apps/desktop/src/catalog-validation.ts": "6bd6974357781c0f972ef2b2da76eb12",
     "apps/desktop/src/catalog.ts": "37fe90b36fa2eee976c3617fe1ee5989",
     "apps/desktop/src/check-cursor-desktop.ts": "80b0d5c1913a47143970447153762617",
     "apps/desktop/src/check-opencode-desktop-setup.ts": "08b86952c137b2e917d296c0c4590e5c",
     "apps/desktop/src/check-packaging-contract.ts": "c5f74134e8e5e98623e2c69e71a79eec",
     "apps/desktop/src/claude-memory.ts": "37f0a29734fad5e2bb5bd97110e7ddfa",
-    "apps/desktop/src/codex-pets-core.ts": "f20c529df55934b632ac8e02dec4df15",
-    "apps/desktop/src/codex-pets.ts": "885f214e14db799953b1ccf13a264478",
-    "apps/desktop/src/default-pet-controller.ts": "a46002d908de6596947cdaa1d122ea84",
+    "apps/desktop/src/codex-familiars-core.ts": "f20c529df55934b632ac8e02dec4df15",
+    "apps/desktop/src/codex-familiars.ts": "885f214e14db799953b1ccf13a264478",
+    "apps/desktop/src/default-familiar-controller.ts": "a46002d908de6596947cdaa1d122ea84",
     "apps/desktop/src/display.ts": "366ab73790c796771ee0df94affe0642",
     "apps/desktop/src/lease-manager.ts": "a8a84622bbd73a3b680a15b709c8dff0",
     "apps/desktop/src/lifecycle.ts": "a346d3ebe789e6d434858481af0757d0",
@@ -55,9 +55,9 @@
     "apps/desktop/src/local-ipc.ts": "a8f25fd0b47d560782f2332e30acc115",
     "apps/desktop/src/logger.ts": "a92e8de9ede984afc378d2d29d5fce0e",
     "apps/desktop/src/main.ts": "5678745b8ea5c311ada5259545bb694e",
-    "apps/desktop/src/pet-installation.ts": "79cdc67778448f2e3876d22194c1ada1",
-    "apps/desktop/src/pet-paths.ts": "73d7313fe19254ea0dcf24ab2f0929b3",
-    "apps/desktop/src/pet-window.ts": "5fafece7a49d2c43fa42d84f327c4a83",
+    "apps/desktop/src/familiar-installation.ts": "79cdc67778448f2e3876d22194c1ada1",
+    "apps/desktop/src/familiar-paths.ts": "73d7313fe19254ea0dcf24ab2f0929b3",
+    "apps/desktop/src/familiar-window.ts": "5fafece7a49d2c43fa42d84f327c4a83",
     "apps/desktop/src/plugin-catalog-validation.ts": "507deea55077a1130f9d4623a8fe8342",
     "apps/desktop/src/plugin-catalog.ts": "10cffa1505a621f2e4ec4d4e1379823c",
     "apps/desktop/src/plugin-config.ts": "4f1f0b6a83d6f705c7ef7b98b2412677",
@@ -66,7 +66,7 @@
     "apps/desktop/src/plugin-manifest-reader.ts": "2ba5d272ed3ae1b7e0131d2efdaf4caf",
     "apps/desktop/src/plugin-manifest.ts": "15fe4e34408053cebe8b1b42e84cc6e7",
     "apps/desktop/src/plugin-package.ts": "2aa09526568e4fd4f961d883ef373a38",
-    "apps/desktop/src/plugin-pet-api.ts": "b6d35ff512c9954462d82bf84dc50929",
+    "apps/desktop/src/plugin-familiar-api.ts": "b6d35ff512c9954462d82bf84dc50929",
     "apps/desktop/src/plugin-runtime.ts": "5065842b784ca91207bf8e6ce3d1fab5",
     "apps/desktop/src/plugin-sdk-bridge.ts": "a925bdd85834f00474e058e2c711d097",
     "apps/desktop/src/plugin-service.ts": "7a6ecfc1f62a35e5c6d440e876dac788",
@@ -110,9 +110,9 @@
     "packages/cursor/src/cursor-rules.ts": "a05f35efb92e61e2493ca122bcf42aab",
     "packages/cursor/src/cursor-status.ts": "c0d0a4dc377998336cf034c82d5bf56a",
     "packages/cursor/src/index.ts": "324347811550c7206820993f68651cba",
-    "packages/install-pet/package.json": "171c0fdaa8b13597c67c8c06be7adc6d",
-    "packages/install-pet/src/check-install-pet.ts": "de740e86393f3d7e4e30bf807c8e489c",
-    "packages/install-pet/src/index.ts": "04eaea5b38365061ae310c22626e077e",
+    "packages/install-familiar/package.json": "171c0fdaa8b13597c67c8c06be7adc6d",
+    "packages/install-familiar/src/check-install-familiar.ts": "de740e86393f3d7e4e30bf807c8e489c",
+    "packages/install-familiar/src/index.ts": "04eaea5b38365061ae310c22626e077e",
     "packages/mcp/package.json": "220512b0569b05ea9ec17950df4eb429",
     "packages/mcp/src/args.ts": "6b84e85ab049f35181294be5ad3efb7a",
     "packages/mcp/src/check-mcp-contract.ts": "0029e9dc79f600482b4c3d1ff1a0e630",
@@ -131,8 +131,8 @@
     "packages/opencode/src/opencode-project-setup.ts": "84b378ea0b22f9a99eced35edd5e584b",
     "packages/opencode/src/opencode-status.ts": "2640eed91327a35c57a7162ab6730ccc",
     "packages/opencode/src/plugin.ts": "8265624c6f4d87274928dde47405d893",
-    "packages/pet-format/package.json": "de5f4dee65e316fd9968a07928ec6558",
-    "packages/pet-format/src/index.ts": "6e94caf8463f6c6139f8f7364691f2e4",
+    "packages/familiar-format/package.json": "de5f4dee65e316fd9968a07928ec6558",
+    "packages/familiar-format/src/index.ts": "6e94caf8463f6c6139f8f7364691f2e4",
     "packages/pi/package.json": "e539f5df26ab1f7aabe73ef0f924ebb6",
     "packages/pi/src/check-pi-compat.ts": "e2f02e876e051e7f302f9ccf835953e3",
     "packages/pi/src/check-pi.ts": "47a4f7d28b07fffe130419975f1cc7a4",
@@ -161,14 +161,14 @@
     "packages/client/src": "a036a1f04099db816b2cd6b552fda034",
     "packages/cursor": "bc481b08e9fbe5e0464e6aef98f8c2ef",
     "packages/cursor/src": "e6ff31505d96d16dcbea0afcb680d2a3",
-    "packages/install-pet": "1ead7cc70de4c772c4c230c446d5e4ad",
-    "packages/install-pet/src": "5882ef53808f2a7d7152446d1d46e196",
+    "packages/install-familiar": "1ead7cc70de4c772c4c230c446d5e4ad",
+    "packages/install-familiar/src": "5882ef53808f2a7d7152446d1d46e196",
     "packages/mcp": "786e8bc32d478dbaa34bc3d1831cc6ec",
     "packages/mcp/src": "e89d476284c4ec2814c11a064fcb210b",
     "packages/opencode": "dd2382941a7bfe672b2f27dcbfa51e45",
     "packages/opencode/src": "ed024a6207b42efd076da44ab9587adb",
-    "packages/pet-format": "ca85af1412e98214135e22bdcba5f406",
-    "packages/pet-format/src": "e01c13d845950b7c825b8ecde0c12b80",
+    "packages/familiar-format": "ca85af1412e98214135e22bdcba5f406",
+    "packages/familiar-format/src": "e01c13d845950b7c825b8ecde0c12b80",
     "packages/pi": "df51ca2497141871a94e3383d042f051",
     "packages/pi/src": "2a70d56d1b7ce40ed8a0416141834dd4"
   }
diff --git a/AGENTS.md b/AGENTS.md
index 735768e0..16076b94 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -35,15 +35,15 @@ When plugin work is finished, update these docs if behavior, commands, manifests
 
 ## Logging for Fast DX
 
-When working on desktop UI, renderer, IPC, catalog, plugin, or pet-window behavior, add targeted logging as part of the implementation when it helps diagnose issues quickly.
+When working on desktop UI, renderer, IPC, catalog, plugin, or familiar-window behavior, add targeted logging as part of the implementation when it helps diagnose issues quickly.
 Prefer concise, scoped logs that capture data shape, selected IDs, load/error states, and boundary decisions.
-Route renderer diagnostics into the app log when possible so failures are visible in `openpets.log`, not only DevTools.
+Route renderer diagnostics into the app log when possible so failures are visible in `familiaros.log`, not only DevTools.
 Avoid noisy permanent logs, secrets, full payload dumps, or logging in tight animation/render loops.
 
 ## Control Center CSP
 
 When adding any renderer-visible URL scheme, image source, dev server endpoint, or internal protocol, update the Control Center CSP in both `apps/desktop/vite.config.ts` and `apps/desktop/src/renderer/index.html`.
-Common pet image protocols include `openpets-codex:`, `openpets-installed:`, and `openpets-pet-preview:`; forgetting CSP causes images to load as the default/fallback pet even when install/render logic is correct.
+Common familiar image protocols include `familiaros-codex:`, `familiaros-installed:`, and `familiaros-familiar-preview:`; forgetting CSP causes images to load as the default/fallback familiar even when install/render logic is correct.
 
 ## Ubuntu VMware Testing
 
@@ -51,16 +51,16 @@ An Ubuntu 24.04 ARM64 VMware/Vagrant development VM exists for Linux GUI testing
 
 - VM directory: `/Volumes/external/vmware/ubuntu24`
 - Provider: `vmware_desktop` / VMware Fusion on Apple Silicon
-- Guest OpenPets checkout: `/home/vagrant/src/openpets`
-- Guest helper aliases: `cdpets` and `openpets-dx`
+- Guest FamiliarOS checkout: `/home/vagrant/src/familiaros`
+- Guest helper aliases: `cdpets` and `familiaros-dx`
 
-Do not mount the macOS OpenPets checkout into Ubuntu for development. The macOS `node_modules` tree contains platform-specific packages and ownership metadata; using it from Linux can break local macOS development. Ubuntu testing should use the isolated guest clone and its own Linux `node_modules`.
+Do not mount the macOS FamiliarOS checkout into Ubuntu for development. The macOS `node_modules` tree contains platform-specific packages and ownership metadata; using it from Linux can break local macOS development. Ubuntu testing should use the isolated guest clone and its own Linux `node_modules`.
 
 For Linux GUI bug reproduction or Electron desktop testing:
 
 1. Start or inspect the VM from `/Volumes/external/vmware/ubuntu24` with `vagrant up` / `vagrant status`.
 2. SSH with `vagrant ssh`.
-3. In the guest, run `cdpets` then `openpets-dx` to update dependencies, fix Electron sandbox permissions, and launch OpenPets in the Ubuntu desktop session.
-4. Check guest logs at `~/.config/@open-pets/desktop/logs/openpets.log`.
+3. In the guest, run `cdpets` then `familiaros-dx` to update dependencies, fix Electron sandbox permissions, and launch FamiliarOS in the Ubuntu desktop session.
+4. Check guest logs at `~/.config/@familiaros/desktop/logs/familiaros.log`.
 
-The VM is configured to boot into the Ubuntu desktop (`graphical.target`) with GDM auto-login for the `vagrant` user. Prefer this VM when validating Linux-specific renderer, Electron, tray, pet-window, IPC, plugin, or packaging behavior.
+The VM is configured to boot into the Ubuntu desktop (`graphical.target`) with GDM auto-login for the `vagrant` user. Prefer this VM when validating Linux-specific renderer, Electron, tray, familiar-window, IPC, plugin, or packaging behavior.
diff --git a/DESIGN.md b/DESIGN.md
index 7ae02912..3bd360c2 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -1,12 +1,12 @@
-# OpenPets Control Center: Design System & Engineering Manual
+# FamiliarOS Control Center: Design System & Engineering Manual
 
-This document outlines the visual direction, component patterns, and front-end engineering guidelines for the OpenPets Control Center. It serves as a practical implementation guide for migrating existing views (Settings, Plugins, Integrations, Onboarding) and building new pages using a cohesive, high-fidelity tactile design system.
+This document outlines the visual direction, component patterns, and front-end engineering guidelines for the FamiliarOS Control Center. It serves as a practical implementation guide for migrating existing views (Settings, Plugins, Integrations, Onboarding) and building new pages using a cohesive, high-fidelity tactile design system.
 
 ---
 
 ## 1. Visual Direction & Heritage
 
-The OpenPets Control Center blends the nostalgic, playful charm of late-90s/early-2000s desktop pet managers with a modern, glassmorphic utility interface. 
+The FamiliarOS Control Center blends the nostalgic, playful charm of late-90s/early-2000s desktop familiar managers with a modern, glassmorphic utility interface. 
 
 - **The Core Tension**: Playful nostalgia meets crisp, modern desktop productivity.
 - **Atmospheric Depth**: Instead of flat, sterile surfaces, interfaces leverage rich color gradients, subtle mesh backdrops, structured panels, and tactile control elements.
@@ -43,7 +43,7 @@ Surfaces are layered to establish clear spatial hierarchy and keep the interface
 The desktop shell is designed to be self-contained, fitting exactly within the viewport height without scrolling the entire window.
 
 - **Page Shell**: Max-width of `1160px` centered, utilizing a full-height flexbox column (`h-screen p-6`).
-- **Hero Header**: A balanced layout placing title text and description on the left (`.hero-content`) and the wider brand artwork (`openpets.webp`) on the right (`.hero-logo-container`). Keep artwork large enough to feel intentional, use `object-contain`, and avoid rounded wrappers or distortion.
+- **Hero Header**: A balanced layout placing title text and description on the left (`.hero-content`) and the wider brand artwork (`familiaros.webp`) on the right (`.hero-logo-container`). Keep artwork large enough to feel intentional, use `object-contain`, and avoid rounded wrappers or distortion.
 - **Layout Split**: A clean grid split, typically:
   - **Left Gallery/List Panel**: `1.25fr` — for browsing, searching, and filtering.
   - **Right Detail/Action Panel**: `0.75fr` — for contextual inspection and heavy operations.
@@ -61,7 +61,7 @@ The desktop shell is designed to be self-contained, fitting exactly within the v
   - **Eyebrow / Section Header**: `text-xs font-bold uppercase tracking-[.18em] text-brand`
   - **Card Title**: `text-sm font-semibold text-navy`
   - **Metadata / Descriptions**: `text-xs text-slate-500`
-- **Copy Tone**: Conversational, clean, and helpful. Avoid overly dense technical jargon; explain state transitions clearly (e.g., *"Ready to become your default pet"* instead of *"State: INSTALLED, ACTIVE: FALSE"*).
+- **Copy Tone**: Conversational, clean, and helpful. Avoid overly dense technical jargon; explain state transitions clearly (e.g., *"Ready to become your default familiar"* instead of *"State: INSTALLED, ACTIVE: FALSE"*).
 
 ---
 
@@ -78,14 +78,14 @@ All colors are mapped to functional roles to ensure consistency across themes.
 | **Success / Ready** | `#059669` / `#34d399` | `emerald` | Active indicators, successfully installed badges |
 | **Warning / Import** | `#d97706` / `#fbbf24` | `amber` | Codex source indicators, imports, attention states |
 | **Featured** | `#7e22ce` / `#a855f7` | `purple` | Featured catalog filters and badges |
-| **Originals** | `#ca8a04` / `#facc15` | `yellow` | Original OpenPets catalog filters and badges |
+| **Originals** | `#ca8a04` / `#facc15` | `yellow` | Original FamiliarOS catalog filters and badges |
 | **Danger / Remove** | `#dc2626` / `#ff6b6b` | `red` | Destructive actions, broken states, error messages |
 
 ---
 
 ## 6. Tactile Button System
 
-Buttons are the core interactive elements. They reject flat modern trends in favor of a chunky, tangible 3D appearance inspired by physical pet hardware and OS controls.
+Buttons are the core interactive elements. They reject flat modern trends in favor of a chunky, tangible 3D appearance inspired by physical familiar hardware and OS controls.
 
 ### Visual Architecture
 - **Borders**: Darker semi-transparent bottom/side borders (`rgba(..., 0.32)`).
@@ -130,12 +130,12 @@ Buttons are the core interactive elements. They reject flat modern trends in fav
   - Amber/yellow-orange for `Originals`
 - Match catalog v3/web gallery taxonomy where possible: `Featured` excludes originals, and category filters like `Western`/`Asian` exclude featured and originals.
 
-### Pet Cards & Badges
+### Familiar Cards & Badges
 - Card grids need inner padding so selected rings and focus states are not clipped by the scroll container.
 - Use badges to expose catalog identity, not just install state:
-  - `Original` for original/OpenPets pets
-  - `Featured` for featured non-original catalog pets
-  - `Western` / `Asian` for standard category pets
+  - `Original` for original/FamiliarOS familiars
+  - `Featured` for featured non-original catalog familiars
+  - `Western` / `Asian` for standard category familiars
   - `Default`, `Installed`, and `Codex` for local state/source
 - Avoid low-value detail badges such as `Available`; reserve detail badges for meaningful state or catalog identity.
 
@@ -192,8 +192,8 @@ When refactoring other Control Center views, apply the following structural mapp
 
 ### B. Plugins Page
 - **Old Layout**: Flat list of available integrations.
-- **New Layout**: Grid-based layout matching the `.pets-grid` structure. 
-- **Cards**: Use the `.pet-card` styling with a thumbnail on the left, author/description text on the right, and semantic status pills (e.g., `.pill-green` for "Active", `.pill-slate` for "Disabled").
+- **New Layout**: Grid-based layout matching the `.familiars-grid` structure. 
+- **Cards**: Use the `.familiar-card` styling with a thumbnail on the left, author/description text on the right, and semantic status pills (e.g., `.pill-green` for "Active", `.pill-slate` for "Disabled").
 
 ### C. Onboarding
 - **Old Layout**: Full screen wizard.
diff --git a/FEATURES.md b/FEATURES.md
index b8761d0a..c28d376b 100644
--- a/FEATURES.md
+++ b/FEATURES.md
@@ -1,6 +1,6 @@
-# OpenPets Feature Inventory
+# FamiliarOS Feature Inventory
 
-This file is the current feature roll-up for this working fork of OpenPets.
+This file is the current feature roll-up for this working fork of FamiliarOS.
 It combines:
 
 - the shipped baseline described in `README.md`
@@ -15,34 +15,34 @@ It combines:
 ## Desktop Companion Core
 
 - Tray-first desktop companion app
-- Desktop pet that can idle, react, wave, move, and speak
-- Default pet plus installed non-default pets
-- Per-agent pet routing when integrations request a specific installed pet
-- Manual pet dismissal with lease-aware recovery rules
-- Native right-click pet context menu
-- Always-on-top pet window with click-through background behavior
+- Desktop familiar that can idle, react, wave, move, and speak
+- Default familiar plus installed non-default familiars
+- Per-agent familiar routing when integrations request a specific installed familiar
+- Manual familiar dismissal with lease-aware recovery rules
+- Native right-click familiar context menu
+- Always-on-top familiar window with click-through background behavior
 - Drag support with mouse passthrough recovery for Windows/Linux edge cases
-- Adaptive pet scale setting (continuous slider from 0.16x to 10x in Settings)
-- Reset default pet position
+- Adaptive familiar scale setting (continuous slider from 0.16x to 10x in Settings)
+- Reset default familiar position
 - Launch at login support where the platform allows it
 - Update checking against GitHub releases
 - Open logs folder from the app
 
-## Pet Packs And Gallery
+## Familiar Packs And Gallery
 
-- Built-in default pet
-- Installed pet pack loading
-- Local pet import from ZIP
-- Local pet import from folder
-- Codex pet import flow
-- Pet catalog browsing
-- Pet preview thumbnails and spritesheets
-- Default pet selection
-- Pet gallery linkout
+- Built-in default familiar
+- Installed familiar pack loading
+- Local familiar import from ZIP
+- Local familiar import from folder
+- Codex familiar import flow
+- Familiar catalog browsing
+- Familiar preview thumbnails and spritesheets
+- Default familiar selection
+- Familiar gallery linkout
 
 ## Reactions And Speech
 
-- Explicit pet speech bubbles
+- Explicit familiar speech bubbles
 - Reaction-only decorative bubble messages
 - Reaction animation mapping
 - User-configurable reaction-to-animation overrides
@@ -51,9 +51,9 @@ It combines:
 - Safer speech rules for agent-driven bubble content
 - Bubble behavior that avoids showing code, logs, URLs, paths, or secrets in normal integration speech
 
-## Pet Text-to-Speech (Phase 2)
+## Familiar Text-to-Speech (Phase 2)
 
-- Settings > **Text-to-Speech** panel controls voice output for the pet and floating chat.
+- Settings > **Text-to-Speech** panel controls voice output for the familiar and floating chat.
 - **System voice** uses the OS speech engine through the renderer (`window.speechSynthesis`) with optional voice-name matching and a 0.5×–2.0× speed multiplier.
 - **Cloud TTS providers**: OpenAI TTS, ElevenLabs, and an **OpenAI-compatible** preset for OpenRouter, LiteLLM, WaveSpeedAI, or a custom endpoint.
 - **Local TTS provider**: Piper (spawned as a local process) for fully offline speech.
@@ -61,25 +61,25 @@ It combines:
 - Per-provider model, voice, speed, endpoint preset, and custom endpoint controls.
 - Dynamic voice list fetching for ElevenLabs; static voice lists for OpenAI / OpenAI-compatible.
 - In-app **Test voice** and **Stop** buttons to preview the configured voice.
-- Assistant replies and other speech are spoken through the pet window renderer via a shared TTS service (`apps/desktop/src/tts-service.ts`).
+- Assistant replies and other speech are spoken through the familiar window renderer via a shared TTS service (`apps/desktop/src/tts-service.ts`).
 - Respects quiet-hours: speech is skipped while quiet hours are active.
 - Audio returned by cloud providers is validated (MP3/WAV magic bytes) and played through a renderer `<audio>` element.
 - Endpoint validation enforces HTTPS for cloud providers, allows `http://localhost` for local proxies, and blocks private IP endpoints for cloud providers.
 - Input capped at 2,000 characters; clear error messages when synthesis fails.
-- Plugin SDK bridge: plugins granted the `voice:speak` permission can ask the pet to speak text through the same TTS pipeline.
+- Plugin SDK bridge: plugins granted the `voice:speak` permission can ask the familiar to speak text through the same TTS pipeline.
 
-## Virtual Pet Care
+## Virtual Familiar Care
 
-- Bundled `openpets.virtual-pet` plugin tracks hunger, energy, happiness, and affection
-- Stats decay slowly while the app is running and recover when you feed, play, pet, or nap
-- Status values live in the right-click pet context menu (Virtual Pet ▸ Mood, Food, Energy, Play, Bond, Level); no on-pet HUD overlay
-- Single-click the pet to pet it (increases bond and happiness)
-- Feed, play, and nap actions are also available from the pet context menu
+- Bundled `familiaros.virtual-familiar` plugin tracks hunger, energy, happiness, and affection
+- Stats decay slowly while the app is running and recover when you feed, play, familiar, or nap
+- Status values live in the right-click familiar context menu (Virtual Familiar ▸ Mood, Food, Energy, Play, Bond, Level); no on-familiar HUD overlay
+- Single-click the familiar to familiar it (increases bond and happiness)
+- Feed, play, and nap actions are also available from the familiar context menu
 - Automatic nudges when a stat gets low
 
 ## Floating Chat Surface
 
-- Double-click the pet to open a floating prompt window
+- Double-click the familiar to open a floating prompt window
 - Floating prompt window stays always on top
 - Compact prompt-first mode at 96px height; expanded editor/history mode at 280px
 - Prompt bar is sized for 2–3 lines of text
@@ -103,9 +103,9 @@ It combines:
 
 - Full conversation history stored and persisted to disk across app restarts
 - History survives closing and reopening the floating chat window
-- History stays in the prompt/editor surface rather than in the pet bubble
-- Pet bubble only shows one assistant reply at a time
-- Per-entry styling with role badges (You / Pet / System / Error) and timestamps
+- History stays in the prompt/editor surface rather than in the familiar bubble
+- Familiar bubble only shows one assistant reply at a time
+- Per-entry styling with role badges (You / Familiar / System / Error) and timestamps
 - **Multi-conversation support**: each conversation is a separate thread with its own messages
 - **Conversation list** accessible from the History button in the floating chat window
 - **Editor button** shows the current conversation's message list
@@ -116,7 +116,7 @@ It combines:
 ## OpenAPI And BYOK Chat
 
 - Main-process OpenAPI chat service
-- User-entered prompt stays out of the pet renderer
+- User-entered prompt stays out of the familiar renderer
 - User-entered prompt stays out of logs unless logging is genuinely necessary elsewhere
 - API key or token entry in Settings
 - Secure storage with Electron `safeStorage` when available
@@ -141,12 +141,12 @@ It combines:
 - Custom local template
 - Generic HTTPS template
 
-## Pet Character And Personality
+## Familiar Character And Personality
 
-- System-prompt style pet character field in General Settings
+- System-prompt style familiar character field in General Settings
 - Character prompt persists in app state
 - Character prompt is applied on future assistant replies
-- Base instructions toggle — optionally include or exclude the default OpenPets behavior instructions in every chat
+- Base instructions toggle — optionally include or exclude the default FamiliarOS behavior instructions in every chat
 - Theme setting shared between control center and floating chat window
 - Auto theme mode
 - Light theme mode
@@ -155,7 +155,7 @@ It combines:
 
 ## Memory System
 
-- Local-first persistent OpenPets memory store
+- Local-first persistent FamiliarOS memory store
 - Main-process memory writer
 - In-memory retrieval during chat
 - On-disk persistence for durable memories
@@ -168,43 +168,43 @@ It combines:
 - Forget/delete support
 - In-app memory viewer in Settings with search, edit, and delete
 - **Chat history memory**: cross-conversation message search injects relevant past conversation excerpts into the system prompt
-- Two separate databases: explicit memories (`openpets-memory.json`) and chat history (`openpets-chat-history.json`)
+- Two separate databases: explicit memories (`familiaros-memory.json`) and chat history (`familiaros-chat-history.json`)
 
 ## Knowledge Store
 
 - Local-first file and memory knowledge repository for the desktop app
 - Store files from Settings or directly from floating-chat attachments
-- File metadata index persisted in `openpets-knowledge-store.json`
+- File metadata index persisted in `familiaros-knowledge-store.json`
 - Stored file contents copied to `userData/knowledge/files/` with sanitized names
 - Automatic UTF-8 text extraction from text-like files (TXT, MD, JSON, code files, CSV, YAML, etc.)
 - MIME type inference from file extension when not supplied
 - File search by token and phrase overlap across file names and extracted text
 - Relevance scoring with phrase bonus, recency weighting, and size penalty
 - Relevant file context injected into OpenAPI chat system instructions
-- Combined search across stored files and OpenPets memories
+- Combined search across stored files and FamiliarOS memories
 - Dedicated **Knowledge Store** tab in Settings with upload, search, list, and delete
 - Store attached prompt-window files into the Knowledge Store via toolbar button
 - File count cap (100 files) and per-file size cap (5 MB)
 - Invalid-file rejection: empty files, non-Buffer data, missing names, and path-traversal names
 - Electron-free core class (`knowledge-store-core.ts`) for deterministic Node unit tests
 
-## OpenPets MCP Server
+## FamiliarOS MCP Server
 
 - Local IPC discovery file and per-run token flow
-- MCP server for OpenPets desktop control
-- Explicit target-pet lease routing
-- Default-pet fallback when a requested pet is unavailable
-- `openpets_status`
-- `openpets_react`
-- `openpets_say`
-- `openpets_memory_list`
-- `openpets_memory_search`
-- `openpets_memory_store`
-- `openpets_memory_forget`
-- Central **OpenPets MCP Server** panel in Control Center → Integrations
+- MCP server for FamiliarOS desktop control
+- Explicit target-familiar lease routing
+- Default-familiar fallback when a requested familiar is unavailable
+- `familiaros_status`
+- `familiaros_react`
+- `familiaros_say`
+- `familiaros_memory_list`
+- `familiaros_memory_search`
+- `familiaros_memory_store`
+- `familiaros_memory_forget`
+- Central **FamiliarOS MCP Server** panel in Control Center → Integrations
 - Command mode selector (published / bundled / local) in one place
 - Node path override in the central panel
-- Pet routing selector in the central panel
+- Familiar routing selector in the central panel
 - One-click **Test Server** health check
 - One-click **Copy MCP JSON** for external hosts
 
@@ -223,10 +223,10 @@ It combines:
 - OpenCode plugin support
 - Cursor MCP config preview
 - Cursor rules preview
-- Pet routing centralized in the OpenPets MCP Server panel
-- Published package / bundled / local command modes centralized in the OpenPets MCP Server panel
+- Familiar routing centralized in the FamiliarOS MCP Server panel
+- Published package / bundled / local command modes centralized in the FamiliarOS MCP Server panel
 - Agent-specific command path overrides (Claude command, OpenCode command)
-- Node command path centralized in the OpenPets MCP Server panel
+- Node command path centralized in the FamiliarOS MCP Server panel
 
 ## MCP Tool Servers (Built-in Chat)
 
@@ -303,14 +303,14 @@ The control-center Integrations page now also includes a curated **Curated MCP T
 ## Dashboard And Control Center
 
 - Dashboard overview
-- Pet count
+- Familiar count
 - Plugin health summary
 - Update status summary
 - Reaction mix charting
 - Top companion activity
 - Activity counters
 - Settings view
-- Pets view
+- Familiars view
 - Plugins view
 - Integrations view
 - Persistent route handling inside the control center window
@@ -323,7 +323,7 @@ The control-center Integrations page now also includes a curated **Curated MCP T
 - Verbose dev logging toggle through environment
 - IPC request logging
 - Lease acquisition logging
-- Pet show lifecycle logging
+- Familiar show lifecycle logging
 - Renderer console logging capture
 
 ## Packaging And Distribution
@@ -332,15 +332,15 @@ The control-center Integrations page now also includes a curated **Curated MCP T
 - Windows packaging support
 - Linux AppImage packaging support
 - Additional Linux targets in config
-- Packaged preload scripts for control center, pet window, prompt window, and plugin surfaces
+- Packaged preload scripts for control center, familiar window, prompt window, and plugin surfaces
 - Packaged official plugins as extra resources
 - Packaging contract checks
 
 ## Safety And Boundary Rules
 
-- Prompt text is kept out of the pet renderer
+- Prompt text is kept out of the familiar renderer
 - Automatic agent speech is decorative and best effort
-- OpenPets speech bubbles are not meant to carry code, logs, URLs, file paths, or secrets
+- FamiliarOS speech bubbles are not meant to carry code, logs, URLs, file paths, or secrets
 - Tooling guidance in the MCP Toolkit emphasizes minimal permissions
 - Docker MCP Toolkit is recommended as an isolation layer when the third-party MCP ecosystem feels too uneven
 
@@ -348,6 +348,6 @@ The control-center Integrations page now also includes a curated **Curated MCP T
 
 This fork now gives you three layers at once:
 
-- a playful desktop pet
+- a playful desktop familiar
 - a floating always-on-top chat surface with BYOK and memory
-- a curated MCP/workbench surface for building a serious developer stack around the pet instead of only driving it from a terminal
+- a curated MCP/workbench surface for building a serious developer stack around the familiar instead of only driving it from a terminal
diff --git a/FEATURES_OUR_CHANGES.md b/FEATURES_OUR_CHANGES.md
index c45a06a4..48625158 100644
--- a/FEATURES_OUR_CHANGES.md
+++ b/FEATURES_OUR_CHANGES.md
@@ -1,10 +1,10 @@
-# OpenPets — Our Changes (Isolated Feature List)
+# FamiliarOS — Our Changes (Isolated Feature List)
 
 This document lists only the features, UI surfaces, and capabilities added by our working fork. It is intentionally separate from the upstream `README.md` and `FEATURES.md` so the original repo maintainer can choose whether to adopt these changes wholesale, partially, or not at all.
 
 ## Floating Chat Surface
 
-- Double-click the pet to open a frameless, always-on-top floating prompt window.
+- Double-click the familiar to open a frameless, always-on-top floating prompt window.
 - Compact prompt-first UX at a minimal 96px height; expanded editor/history mode at 280px.
 - Prompt bar sized for 2–3 lines of text.
 - Resizable with a corner grip; size is remembered per mode (compact/expanded).
@@ -14,11 +14,11 @@ This document lists only the features, UI surfaces, and capabilities added by ou
 ## Chat History List UI
 
 - Conversation history renders as a styled list of individual entries, not a raw textarea.
-- Per-entry role badges: You, Pet, System, Error.
+- Per-entry role badges: You, Familiar, System, Error.
 - Color-coded entry backgrounds per role.
 - Timestamps shown per entry.
 - Scrollable with automatic scroll-to-bottom on new messages.
-- Persists to disk across app restarts (`openpets-chat-history.json`).
+- Persists to disk across app restarts (`familiaros-chat-history.json`).
 
 ## OpenAPI BYOK Chat
 
@@ -29,15 +29,15 @@ This document lists only the features, UI surfaces, and capabilities added by ou
 - Built-in presets: OpenAI, OpenRouter, Azure template, LiteLLM, vLLM, Moonshot/Kimi, custom/local templates.
 - Localhost-only allowance for plain `http`.
 
-## Pet Character & Base Instructions
+## Familiar Character & Base Instructions
 
-- User-editable system-prompt style pet character field in General Settings.
+- User-editable system-prompt style familiar character field in General Settings.
 - Character prompt persists in app state and applies to future assistant replies.
-- Base instructions toggle to include/exclude the default OpenPets behavior instructions in every chat.
+- Base instructions toggle to include/exclude the default FamiliarOS behavior instructions in every chat.
 
-## Pet Text-to-Speech (Phase 2)
+## Familiar Text-to-Speech (Phase 2)
 
-- Settings > **Text-to-Speech** panel for the pet and floating chat.
+- Settings > **Text-to-Speech** panel for the familiar and floating chat.
 - **System voice** via the OS speech engine with voice matching and 0.5×–2.0× speed control.
 - **Cloud providers**: OpenAI TTS, ElevenLabs, OpenAI-compatible (OpenRouter / LiteLLM / WaveSpeedAI / custom).
 - **Local provider**: Piper for offline speech.
@@ -50,7 +50,7 @@ This document lists only the features, UI surfaces, and capabilities added by ou
 
 ## Memory System
 
-- Local-first durable OpenPets memory store.
+- Local-first durable FamiliarOS memory store.
 - Automatic memory capture from prompts (`remember that...`, `/remember`, `/memorize`, `/note`, `don't forget...`, `my name is...`, `my favorite...`, `I prefer...`, `I like/love/dislike/hate...`).
 - Specific memory kinds (identity, preference) take precedence over generic notes when the prompt matches both.
 - Relevance-based retrieval injected into future chat system prompts.
@@ -59,7 +59,7 @@ This document lists only the features, UI surfaces, and capabilities added by ou
 - In-app memory viewer in Settings with search, inline edit, and delete with confirmation.
 - Human-inspectable markdown mirror files on disk.
 - **Chat history memory**: cross-conversation message search that injects relevant past conversation excerpts into the system prompt.
-- Separate databases for explicit memories (`openpets-memory.json`) and chat history (`openpets-chat-history.json`).
+- Separate databases for explicit memories (`familiaros-memory.json`) and chat history (`familiaros-chat-history.json`).
 
 ## MCP Tool Servers (Built-in Chat)
 
@@ -71,12 +71,12 @@ This document lists only the features, UI surfaces, and capabilities added by ou
 - ReAct-style tool-calling loop (max 5 iterations) with responses/chat-completions integration.
 - Supported tools: filesystem, terminal/shell, memory, fetch-web, sequential-thinking, playwright, git, github, docker, sqlite.
 
-## OpenPets MCP Server (External-Agent Bridge)
+## FamiliarOS MCP Server (External-Agent Bridge)
 
-- Central **OpenPets MCP Server** panel in Control Center → Integrations.
+- Central **FamiliarOS MCP Server** panel in Control Center → Integrations.
 - Command mode selector (published / bundled / local) in one place.
 - Node path override in the central panel.
-- Pet routing selector in the central panel.
+- Familiar routing selector in the central panel.
 - One-click **Test Server** health check.
 - One-click **Copy MCP JSON** for external hosts.
 
@@ -100,21 +100,21 @@ This document lists only the features, UI surfaces, and capabilities added by ou
 - Text extraction from UTF-8 text-like files; MIME inference from extension.
 - Indexed metadata with file count cap (100) and per-file size cap (5 MB).
 - Relevance search across file names and extracted text; results injected into OpenAPI chat instructions.
-- Combined search across stored files and OpenPets memories.
+- Combined search across stored files and FamiliarOS memories.
 - Dedicated Settings tab for upload, search, list, and delete.
 - Toolbar button in the floating prompt window stores attachments into the Knowledge Store.
 - Electron-free core (`knowledge-store-core.ts`) + unit tests (`knowledge-store.test.ts`).
 
-## Pet Scale & Sizing
+## Familiar Scale & Sizing
 
-- Settings slider for pet scale from 0.16x up to 10x, large enough to fill the screen.
-- Pet window dynamically resizes to fit larger scales without clipping.
-- Speech bubbles grow with the pet and larger window sizes; long messages scroll instead of cutting off.
+- Settings slider for familiar scale from 0.16x up to 10x, large enough to fill the screen.
+- Familiar window dynamically resizes to fit larger scales without clipping.
+- Speech bubbles grow with the familiar and larger window sizes; long messages scroll instead of cutting off.
 
 ## Multi-Screen Support
 
-- Pet positioning uses `screen.getDisplayNearestPoint()` instead of always clamping to the primary display.
-- `clampToNearestWorkArea()` keeps the pet within the work area of the display it is currently on.
+- Familiar positioning uses `screen.getDisplayNearestPoint()` instead of always clamping to the primary display.
+- `clampToNearestWorkArea()` keeps the familiar within the work area of the display it is currently on.
 
 ## Multi-Conversation Chat
 
@@ -124,22 +124,22 @@ This document lists only the features, UI surfaces, and capabilities added by ou
 - Create, switch, and delete conversations from the floating chat window.
 - Editor button shows the current conversation's message list (unchanged).
 - New Chat button creates a fresh conversation (old conversations are preserved).
-- Conversation metadata stored in `openpets-chat-conversations.json`.
+- Conversation metadata stored in `familiaros-chat-conversations.json`.
 
 ## Settings & Control Center
 
 - Memory viewer section in Settings.
 - MCP Tool Servers panel in Integrations for built-in chat tool activation.
-- OpenPets MCP Server panel in Integrations for external-agent bridge configuration.
+- FamiliarOS MCP Server panel in Integrations for external-agent bridge configuration.
 - OpenAPI chat settings: endpoint, model, credential, theme, base instructions toggle.
 - Moonshot/Kimi API endpoint preset.
 
-## Virtual Pet Status HUD
+## Virtual Familiar Status HUD
 
-- Bundled `openpets.virtual-pet` plugin tracks hunger, energy, happiness, and affection.
-- Status values are shown as read-only labels inside the right-click pet context menu (Virtual Pet ▸ Mood, Food, Energy, Play, Bond, Level), so they never block pet clicks or double-click chat.
-- Single-click the pet to pet it (increases bond and happiness).
-- Feed / play / pet / nap commands live in the pet context menu.
+- Bundled `familiaros.virtual-familiar` plugin tracks hunger, energy, happiness, and affection.
+- Status values are shown as read-only labels inside the right-click familiar context menu (Virtual Familiar ▸ Mood, Food, Energy, Play, Bond, Level), so they never block familiar clicks or double-click chat.
+- Single-click the familiar to familiar it (increases bond and happiness).
+- Feed / play / familiar / nap commands live in the familiar context menu.
 - Low-stat nudges continue to work in the background.
 
 ## Build & Packaging
diff --git a/FEATURE_REGISTRY.md b/FEATURE_REGISTRY.md
index b92a6880..2bfa991f 100644
--- a/FEATURE_REGISTRY.md
+++ b/FEATURE_REGISTRY.md
@@ -1,6 +1,6 @@
-# OpenPets Feature Registry
+# FamiliarOS Feature Registry
 
-This is the canonical feature registry for the VectorShell working fork of OpenPets. It maps every user-facing capability to the files, branches/PRs, and commits that implement it. It is kept in addition to `FEATURES.md` and `FEATURES_OUR_CHANGES.md` so that feature ownership, status, and history can be traced quickly.
+This is the canonical feature registry for the VectorShell working fork of FamiliarOS. It maps every user-facing capability to the files, branches/PRs, and commits that implement it. It is kept in addition to `FEATURES.md` and `FEATURES_OUR_CHANGES.md` so that feature ownership, status, and history can be traced quickly.
 
 - **Current branch:** `v3.1.0-integrated`
 - **Current HEAD:** `bb758e9`
@@ -9,21 +9,21 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 
 ---
 
-## 1. Companion / Pet core
+## 1. Companion / Familiar core
 
 | Feature | Status | PR / Branch | Key commits | Key files | Notes |
 |---------|--------|-------------|-------------|-----------|-------|
 | Tray-first desktop companion | shipped | upstream | — | `apps/desktop/src/main.ts` | Baseline from upstream. |
-| Default + installed pets | shipped | upstream | — | `apps/desktop/src/pet-installation.ts` | Baseline. |
-| Always-on-top pet window | shipped | upstream | — | `apps/desktop/src/pet-window.ts` | Baseline. |
-| Drag with mouse passthrough | shipped | `fix/pet-window-stability` | `11ed7b3` | `apps/desktop/src/pet-window.ts`, `apps/desktop/pet-preload.cjs` | Removes post-drag resize jump; anchors resize around pet foot/center. |
-| Adaptive pet scale 0.16x–10x | shipped | `feat/scale-preset-dropdown` | `53b8435` | `apps/desktop/src/app-state-core.ts`, `apps/desktop/src/renderer/src/main.tsx` | Continuous slider + abbreviated preset dropdown. |
+| Default + installed familiars | shipped | upstream | — | `apps/desktop/src/familiar-installation.ts` | Baseline. |
+| Always-on-top familiar window | shipped | upstream | — | `apps/desktop/src/familiar-window.ts` | Baseline. |
+| Drag with mouse passthrough | shipped | `fix/familiar-window-stability` | `11ed7b3` | `apps/desktop/src/familiar-window.ts`, `apps/desktop/familiar-preload.cjs` | Removes post-drag resize jump; anchors resize around familiar foot/center. |
+| Adaptive familiar scale 0.16x–10x | shipped | `feat/scale-preset-dropdown` | `53b8435` | `apps/desktop/src/app-state-core.ts`, `apps/desktop/src/renderer/src/main.tsx` | Continuous slider + abbreviated preset dropdown. |
 | Scale slider draggable thumb | shipped | `pr/scale-slider-draggable` | `2472950` | `apps/desktop/src/renderer/src/main.tsx` | CSS thumb styling so slider is grabbable. |
-| Scale handle + keyboard nudges | **removed/replaced** | `fix/scale-handle-and-keyboard` | `be21907`, `26d446f` | `apps/desktop/src/pet-window.ts` | Handle added, then removed in favor of Settings `+`/`-` nudge buttons. |
-| Multi-screen positioning | shipped | main PR | `08eff41` | `apps/desktop/src/pet-window.ts` | Uses `screen.getDisplayNearestPoint()` / `clampToNearestWorkArea()`. |
-| Speech-bubble layout | shipped | main PR + OP2 | `08eff41`, `8648cad`, `f514960` | `apps/desktop/src/pet-window.ts` | Larger bubbles, top-of-screen flip, responsive max-width for large pets. |
-| Single-click petting | shipped | `pr/single-click-petting` | `46028c7`, refined `be580ba` | `apps/desktop/pet-preload.cjs`, `plugins/official/openpets.virtual-pet/index.js` | Single click emits `pet:clicked`; double click opens chat. **Not a v3.1.0 follow-up fix; pre-existing feature refined by OP1.** |
-| Virtual-pet context menu | shipped | `pr/virtual-pet-context-menu` + `refactor/virtual-pet-context-menu` | `98b7875`, `ab62d9c`, `35e4d74` | `plugins/official/openpets.virtual-pet/index.js`, `plugins/official/openpets.virtual-pet/locales/en.json` | HUD moved from triple-click overlay to right-click context menu; care actions reordered/renamed. |
+| Scale handle + keyboard nudges | **removed/replaced** | `fix/scale-handle-and-keyboard` | `be21907`, `26d446f` | `apps/desktop/src/familiar-window.ts` | Handle added, then removed in favor of Settings `+`/`-` nudge buttons. |
+| Multi-screen positioning | shipped | main PR | `08eff41` | `apps/desktop/src/familiar-window.ts` | Uses `screen.getDisplayNearestPoint()` / `clampToNearestWorkArea()`. |
+| Speech-bubble layout | shipped | main PR + OP2 | `08eff41`, `8648cad`, `f514960` | `apps/desktop/src/familiar-window.ts` | Larger bubbles, top-of-screen flip, responsive max-width for large familiars. |
+| Single-click petting | shipped | `pr/single-click-petting` | `46028c7`, refined `be580ba` | `apps/desktop/familiar-preload.cjs`, `plugins/official/familiaros.virtual-familiar/index.js` | Single click emits `familiar:clicked`; double click opens chat. **Not a v3.1.0 follow-up fix; pre-existing feature refined by OP1.** |
+| Virtual-familiar context menu | shipped | `pr/virtual-familiar-context-menu` + `refactor/virtual-familiar-context-menu` | `98b7875`, `ab62d9c`, `35e4d74` | `plugins/official/familiaros.virtual-familiar/index.js`, `plugins/official/familiaros.virtual-familiar/locales/en.json` | HUD moved from triple-click overlay to right-click context menu; care actions reordered/renamed. |
 
 ## 2. Floating chat / prompt window
 
@@ -45,20 +45,20 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 | OpenAPI chat service | shipped | main PR | `08eff41` | `apps/desktop/src/openapi-chat.ts` | Main-process chat with responses + chat/completions. |
 | Provider presets | shipped | main PR | `08eff41` | `apps/desktop/src/openapi-chat.ts`, `apps/desktop/src/renderer/src/main.tsx` | OpenAI, OpenRouter, Azure, LiteLLM, vLLM, Moonshot/Kimi, custom. |
 | Secure credential storage | shipped | main PR | `08eff41` | `apps/desktop/src/openapi-chat.ts` | `safeStorage` with plain fallback. |
-| Pet character / system prompt | shipped | main PR | `08eff41` | `apps/desktop/src/renderer/src/main.tsx` | User-editable character field. |
-| Base-instructions toggle | shipped | main PR | `08eff41` | `apps/desktop/src/renderer/src/main.tsx` | Include/exclude default OpenPets behavior instructions. |
+| Familiar character / system prompt | shipped | main PR | `08eff41` | `apps/desktop/src/renderer/src/main.tsx` | User-editable character field. |
+| Base-instructions toggle | shipped | main PR | `08eff41` | `apps/desktop/src/renderer/src/main.tsx` | Include/exclude default FamiliarOS behavior instructions. |
 | Knowledge context injection | shipped | `pr/knowledge-store-hardening` | `f514960` | `apps/desktop/src/openapi-chat.ts`, `apps/desktop/src/knowledge-store.ts` | Relevant stored files appended to system instructions. |
 
 ## 4. Memory system
 
 | Feature | Status | PR / Branch | Key commits | Key files | Notes |
 |---------|--------|-------------|-------------|-----------|-------|
-| Local memory engine | shipped | main PR | `08eff41` | `apps/desktop/src/openpets-memory.ts` | JSON store + markdown mirror. |
-| Memory capture patterns | shipped | main PR | `08eff41` | `apps/desktop/src/openpets-memory.ts` | `remember`, `my name is`, `I prefer`, etc. |
-| Memory kinds + importance + tags | shipped | main PR | `08eff41` | `apps/desktop/src/openpets-memory.ts` | preference, identity, fact, note. |
+| Local memory engine | shipped | main PR | `08eff41` | `apps/desktop/src/familiaros-memory.ts` | JSON store + markdown mirror. |
+| Memory capture patterns | shipped | main PR | `08eff41` | `apps/desktop/src/familiaros-memory.ts` | `remember`, `my name is`, `I prefer`, etc. |
+| Memory kinds + importance + tags | shipped | main PR | `08eff41` | `apps/desktop/src/familiaros-memory.ts` | preference, identity, fact, note. |
 | In-app memory viewer | shipped | main PR | `08eff41` | `apps/desktop/src/renderer/src/main.tsx` | Search, edit, delete. |
-| Memory hardening | shipped | `pr/memory-hardening` | `2de484d` | `apps/desktop/src/openapi-chat.ts`, `apps/desktop/src/openpets-memory.ts` | Capture logged + fails safely; recall-intent fallback. |
-| Chat-history memory | shipped | main PR | `08eff41` | `apps/desktop/src/openapi-chat.ts`, `apps/desktop/src/openpets-memory.ts` | Cross-conversation excerpts injected into prompt. |
+| Memory hardening | shipped | `pr/memory-hardening` | `2de484d` | `apps/desktop/src/openapi-chat.ts`, `apps/desktop/src/familiaros-memory.ts` | Capture logged + fails safely; recall-intent fallback. |
+| Chat-history memory | shipped | main PR | `08eff41` | `apps/desktop/src/openapi-chat.ts`, `apps/desktop/src/familiaros-memory.ts` | Cross-conversation excerpts injected into prompt. |
 
 ## 5. Knowledge Store
 
@@ -74,14 +74,14 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 
 ## 6. MCP edition
 
-### 6a. OpenPets MCP server
+### 6a. FamiliarOS MCP server
 
 | Feature | Status | PR / Branch | Key commits | Key files | Notes |
 |---------|--------|-------------|-------------|-----------|-------|
-| MCP server package | shipped | upstream / main PR | `3f8fa1a`+ | `packages/mcp/src/server.ts`, `packages/mcp/src/tools.ts` | `open-pets` MCP server. |
+| MCP server package | shipped | upstream / main PR | `3f8fa1a`+ | `packages/mcp/src/server.ts`, `packages/mcp/src/tools.ts` | `familiaros` MCP server. |
 | Status / react / say tools | shipped | upstream | — | `packages/mcp/src/tools.ts` | Baseline. |
 | Memory tools (list/search/store/forget) | shipped | upstream | — | `packages/mcp/src/tools.ts` | Baseline. |
-| Lease routing + default-pet fallback | shipped | upstream | — | `packages/mcp/src/server.ts` | Baseline. |
+| Lease routing + default-familiar fallback | shipped | upstream | — | `packages/mcp/src/server.ts` | Baseline. |
 
 ### 6b. MCP Tool Servers (built-in chat)
 
@@ -93,13 +93,13 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 | Supported tool servers | shipped | main PR | `08eff41` | `apps/desktop/src/mcp-chat-client.ts` | filesystem, terminal, memory, fetch-web, sequential-thinking, playwright, git, github, docker, sqlite. |
 | ReAct-style tool loop | shipped | main PR | `08eff41` | `apps/desktop/src/mcp-chat-client.ts`, `apps/desktop/src/openapi-chat.ts` | Max 5 iterations. |
 
-### 6c. OpenPets MCP Server (external-agent bridge)
+### 6c. FamiliarOS MCP Server (external-agent bridge)
 
 | Feature | Status | PR / Branch | Key commits | Key files | Notes |
 |---------|--------|-------------|-------------|-----------|-------|
-| Central "OpenPets MCP Server" panel | shipped | main PR | current | `apps/desktop/src/renderer/src/main.tsx`, `apps/desktop/src/agent-setup.ts` | Configures command mode, node path, pet routing, test server, and MCP JSON for external hosts. |
+| Central "FamiliarOS MCP Server" panel | shipped | main PR | current | `apps/desktop/src/renderer/src/main.tsx`, `apps/desktop/src/agent-setup.ts` | Configures command mode, node path, familiar routing, test server, and MCP JSON for external hosts. |
 | Server health test | shipped | main PR | current | `apps/desktop/src/agent-setup.ts`, `apps/desktop/src/windows.ts` | `--version` smoke test via IPC. |
-| MCP JSON copy | shipped | main PR | current | `apps/desktop/src/renderer/src/main.tsx` | One-click copy of the `mcpServers.openpets` entry. |
+| MCP JSON copy | shipped | main PR | current | `apps/desktop/src/renderer/src/main.tsx` | One-click copy of the `mcpServers.familiaros` entry. |
 
 ### 6d. Curated MCP Toolkit
 
@@ -124,21 +124,21 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 | Feature | Status | PR / Branch | Key commits | Key files | Notes |
 |---------|--------|-------------|-------------|-----------|-------|
 | Plugin catalog / install / enable | shipped | upstream | — | `apps/desktop/src/plugin-*.ts` | Baseline. |
-| Official plugin suite | shipped | upstream | — | `plugins/official/` | Baseline: focus-buddy, reminders, launch-buddy, water-reminder, mood-check-in, day-routine, magic-8-ball, fortune-cookie, virtual-pet. |
-| Virtual-pet plugin bundling | shipped | `pr/virtual-pet-context-menu` | `98b7875` | `plugins/official/openpets.virtual-pet/index.js` | Re-enabled after temporary disable. |
+| Official plugin suite | shipped | upstream | — | `plugins/official/` | Baseline: focus-buddy, reminders, launch-buddy, water-reminder, mood-check-in, day-routine, magic-8-ball, fortune-cookie, virtual-familiar. |
+| Virtual-familiar plugin bundling | shipped | `pr/virtual-familiar-context-menu` | `98b7875` | `plugins/official/familiaros.virtual-familiar/index.js` | Re-enabled after temporary disable. |
 
 ## 9. Text-to-Speech (Phase 2)
 
 | Feature | Status | PR / Branch | Key commits | Key files | Notes |
 |---------|--------|-------------|-------------|-----------|-------|
 | TTS settings panel | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/renderer/src/main.tsx` | Provider, voice, speed, model, endpoint preset, credential, and test/stop UI. |
-| System voice playback | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/pet-preload.cjs`, `apps/desktop/prompt-window-preload.cjs` | OS speech engine via Web Speech API; rate 0.5×–2.0× and voice-name matching. |
+| System voice playback | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/familiar-preload.cjs`, `apps/desktop/prompt-window-preload.cjs` | OS speech engine via Web Speech API; rate 0.5×–2.0× and voice-name matching. |
 | Cloud TTS providers | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/tts-engine.ts` | OpenAI TTS, ElevenLabs, and OpenAI-compatible endpoints. |
 | Piper local TTS | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/tts-engine.ts` | Spawns local `piper` binary; WAV magic-byte validation. |
 | Credential storage | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/tts-credentials.ts` | Per-provider API key stored with `safeStorage`; plain fallback. |
 | Endpoint presets | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/tts-catalog.ts` | OpenRouter, LiteLLM, WaveSpeedAI, Custom. |
 | TTS service & quiet hours | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/tts-service.ts` | Shared dispatcher; skips speech during quiet hours. |
-| TTS IPC handlers | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/windows.ts` | `openpets:get-tts-settings`, `openpets:get-tts-voices`, `openpets:save-tts-credential`, `openpets:test-tts`, `openpets:tts-stop`. |
+| TTS IPC handlers | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/windows.ts` | `familiaros:get-tts-settings`, `familiaros:get-tts-voices`, `familiaros:save-tts-credential`, `familiaros:test-tts`, `familiaros:tts-stop`. |
 | TTS engine tests | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/tests/tts-engine.test.ts` | Provider catalog, defaults, and preset validation. |
 | Plugin voice bridge | merged | TTS Phase 2 / `v3.1.0-integrated` | current | `apps/desktop/src/plugin-voice.ts` | `voice:speak` permission lets plugins speak through the same pipeline. |
 
@@ -150,7 +150,7 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 | asarUnpack for preloads | shipped | `pr/packaging-and-docs` | `743163d` | `apps/desktop/electron-builder.yml` | Preload scripts unpacked for sandboxed packaged builds. |
 | Packaging contract | shipped | `pr/packaging-and-docs` + `pr/knowledge-store-hardening` | `743163d`, `f514960` | `apps/desktop/src/check-packaging-contract.ts` | Assertions for preload presence, bubble CSS, etc. |
 | Windows code signing | shipped | TTS Phase 2 / `v3.1.0-integrated` | `bb758e9` build | `apps/desktop/dist-electron/` | Signed with host certificate via `signtool.exe`. |
-| Signed installer delivery | shipped | TTS Phase 2 / `v3.1.0-integrated` | `bb758e9` | `C:\openpets-build\apps\desktop\dist-electron\OpenPets-3.1.0-win-x64-setup.exe` | SHA256: `79b0c01b08d6121f54675c176a5d7c22d1f8e3591b191d760aae6d6300d4b5bb`. |
+| Signed installer delivery | shipped | TTS Phase 2 / `v3.1.0-integrated` | `bb758e9` | `C:\familiaros-build\apps\desktop\dist-electron\FamiliarOS-3.1.0-win-x64-setup.exe` | SHA256: `79b0c01b08d6121f54675c176a5d7c22d1f8e3591b191d760aae6d6300d4b5bb`. |
 
 ---
 
@@ -158,9 +158,9 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 
 | Capability | What happened | Replacement | Commits |
 |------------|---------------|-------------|---------|
-| On-pet drag-to-resize handle | Removed | Settings scale slider + `+`/`-` nudge buttons + keyboard arrows | `4aa60a3`, `be21907`, `26d446f` |
-| Virtual-pet triple-click HUD overlay | Removed | Right-click context menu **Pet Status** | `4aa60a3`, `98b7875` |
-| Triple-click pet action | Removed | Single-click petting + double-click chat | `46028c7` |
+| On-familiar drag-to-resize handle | Removed | Settings scale slider + `+`/`-` nudge buttons + keyboard arrows | `4aa60a3`, `be21907`, `26d446f` |
+| Virtual-familiar triple-click HUD overlay | Removed | Right-click context menu **Familiar Status** | `4aa60a3`, `98b7875` |
+| Triple-click familiar action | Removed | Single-click petting + double-click chat | `46028c7` |
 
 ---
 
@@ -173,11 +173,11 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 | `FEATURE_REGISTRY.md` | This file — feature-to-branch/commit/files mapping. |
 | `PULL_REQUEST.md` | Main PR description for the big feature set. |
 | `README_OUR_CHANGES.md` | Isolated user-facing README of additions. |
-| `docs/pull-requests/OPENPETS_3_1_0_FIXES_PULL_REQUESTS.md` | Categorized fix PRs for v3.1.0. |
-| `docs/pull-requests/OPENPETS_3_1_0_MOD_NICHE_PULL_REQUESTS.md` | Same fixes organized by mod niche. |
+| `docs/pull-requests/FAMILIAROS_3_1_0_FIXES_PULL_REQUESTS.md` | Categorized fix PRs for v3.1.0. |
+| `docs/pull-requests/FAMILIAROS_3_1_0_MOD_NICHE_PULL_REQUESTS.md` | Same fixes organized by mod niche. |
 | `docs/pull-requests/OP_1_6_PULL_REQUESTS.md` | OP1–OP6 user-reported tweak branches. |
 | `docs/pull-requests/PR_SINGLE_CLICK_PETTING.md` | Single-click petting PR (pre-v3.1.0). |
-| `docs/pull-requests/PR_VIRTUAL_PET_CONTEXT_MENU.md` | Virtual-pet context-menu PR (pre-v3.1.0). |
+| `docs/pull-requests/PR_VIRTUAL_PET_CONTEXT_MENU.md` | Virtual-familiar context-menu PR (pre-v3.1.0). |
 | `docs/pull-requests/PR_MEMORY_HARDENING.md` | Memory hardening PR. |
 | `docs/pull-requests/PR_BUBBLE_CLIP_FIX.md` | Bubble clip fix PR. |
 | `docs/pull-requests/PR_SCALE_SLIDER_DRAGGABLE.md` | Scale slider draggable thumb PR. |
@@ -192,7 +192,7 @@ This is the canonical feature registry for the VectorShell working fork of OpenP
 
 - `main` — upstream-aligned baseline.
 - `v3.1.0-integrated` — integration branch with all v3.1.0 work plus TTS Phase 2 (HEAD `bb758e9`).
-- `feat/scale-preset-dropdown`, `fix/pet-window-stability`, `fix/prompt-window-hardening`, `fix/prompt-window-signed-build`, `fix/scale-handle-and-keyboard`, `refactor/virtual-pet-context-menu` — topic branches from the six original PRs.
-- `op1/pet-drag-threshold` … `op6/chat-file-attachments` — user-reported tweak branches.
-- `pr/bubble-clip-fix`, `pr/memory-hardening`, `pr/packaging-and-docs`, `pr/scale-slider-draggable`, `pr/single-click-petting`, `pr/virtual-pet-context-menu` — PR branch pointers.
+- `feat/scale-preset-dropdown`, `fix/familiar-window-stability`, `fix/prompt-window-hardening`, `fix/prompt-window-signed-build`, `fix/scale-handle-and-keyboard`, `refactor/virtual-familiar-context-menu` — topic branches from the six original PRs.
+- `op1/familiar-drag-threshold` … `op6/chat-file-attachments` — user-reported tweak branches.
+- `pr/bubble-clip-fix`, `pr/memory-hardening`, `pr/packaging-and-docs`, `pr/scale-slider-draggable`, `pr/single-click-petting`, `pr/virtual-familiar-context-menu` — PR branch pointers.
 - `pr/knowledge-store-hardening` — Knowledge Store PR branch pointer (at `f514960`).
diff --git a/LICENSE b/LICENSE
index 950628f1..8a173802 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 OpenPets
+Copyright (c) 2026 FamiliarOS
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/PULL_REQUEST.md b/PULL_REQUEST.md
index 3d4aee32..8bd62373 100644
--- a/PULL_REQUEST.md
+++ b/PULL_REQUEST.md
@@ -1,6 +1,6 @@
-# Pull Request: Floating Chat, Memory, Knowledge Store, MCP Servers, Curated MCP Toolkit, TTS Phase 2 & Pet Sizing
+# Pull Request: Floating Chat, Memory, Knowledge Store, MCP Servers, Curated MCP Toolkit, TTS Phase 2 & Familiar Sizing
 
-**Title:** feat(desktop): add floating chat, local memory, Knowledge Store, MCP Tool Servers, OpenPets MCP Server panel, Curated MCP Toolkit, Text-to-Speech Phase 2, expanded pet sizing, and multi-screen support
+**Title:** feat(desktop): add floating chat, local memory, Knowledge Store, MCP Tool Servers, FamiliarOS MCP Server panel, Curated MCP Toolkit, Text-to-Speech Phase 2, expanded familiar sizing, and multi-screen support
 
 **Author:** VectorShell working fork
 **Base:** upstream `main` at `cba81b7`
@@ -10,47 +10,47 @@
 
 ## Summary
 
-This PR adds a complete in-app chat layer, a durable local memory system, interactive MCP tool activation, and several companion-quality improvements to the desktop pet. Every change is additive and preserves existing MCP/agent integration behavior.
+This PR adds a complete in-app chat layer, a durable local memory system, interactive MCP tool activation, and several companion-quality improvements to the desktop familiar. Every change is additive and preserves existing MCP/agent integration behavior.
 
 ## Motivation
 
-- Users wanted to chat with the pet without a terminal or external agent.
+- Users wanted to chat with the familiar without a terminal or external agent.
 - Long-running companions benefit from remembering facts, preferences, and identity.
 - A curated but practical MCP surface helps users adopt tools without unsafe one-click installs.
-- Pet sizing was limited to three presets with no continuous or interactive adjustment.
+- Familiar sizing was limited to three presets with no continuous or interactive adjustment.
 
 ## What changed
 
 ### New surfaces
 
 - **Floating Prompt Window** (`apps/desktop/src/prompt-window.ts`)
-  - Frameless, always-on-top chat UI opened by double-clicking the pet.
+  - Frameless, always-on-top chat UI opened by double-clicking the familiar.
   - Compact mode at 96px height; expanded editor/history mode at 280px.
   - Built as inline HTML/CSS/JS with a dedicated preload bridge.
 
 - **Chat History List UI**
   - Replaced plain-text history textarea with styled per-entry cards.
-  - Role badges (You / Pet / System / Error), color coding, timestamps.
-  - Persists to disk (`openpets-chat-history.json`).
+  - Role badges (You / Familiar / System / Error), color coding, timestamps.
+  - Persists to disk (`familiaros-chat-history.json`).
 
 - **Memory Viewer**
-  - New Settings section to search, edit, and delete OpenPets memories.
+  - New Settings section to search, edit, and delete FamiliarOS memories.
 
 - **MCP Tool Servers Panel**
   - New top-level Integrations card to activate MCP tools for the built-in floating chat.
   - Works without Claude, Cursor, OpenCode, or Pi installed.
   - Tiered chip selector (Starter / Terminal & Systems / Advanced).
 
-- **OpenPets MCP Server Panel**
+- **FamiliarOS MCP Server Panel**
   - New central Integrations card for the external-agent bridge.
-  - Command mode, node path, and pet routing in one place.
+  - Command mode, node path, and familiar routing in one place.
   - One-click server health test and MCP JSON copy.
 
 - **Text-to-Speech (Phase 2)**
   - Settings > **Text-to-Speech** panel with provider, voice, model, speed, endpoint, and credential controls.
   - Providers: system OS voice, OpenAI TTS, ElevenLabs, Piper (local), and OpenAI-compatible (OpenRouter / LiteLLM / WaveSpeedAI / custom).
   - Credentials stored with `safeStorage` (plain fallback) and tied to the selected provider.
-  - Shared TTS service (`tts-service.ts`) routes speech to the pet / floating-chat renderer via `openpets:tts-speak`, `openpets:tts-audio`, and `openpets:tts-stop` IPC.
+  - Shared TTS service (`tts-service.ts`) routes speech to the familiar / floating-chat renderer via `familiaros:tts-speak`, `familiaros:tts-audio`, and `familiaros:tts-stop` IPC.
   - Cloud audio validated for MP3/WAV; endpoints validated for HTTPS / localhost rules.
   - Skips speech during quiet hours.
 
@@ -58,10 +58,10 @@ This PR adds a complete in-app chat layer, a durable local memory system, intera
 
 - `apps/desktop/src/openapi-chat.ts` — OpenAPI BYOK chat with responses + chat/completions support.
 - `apps/desktop/src/mcp-chat-client.ts` — Internal stdio MCP client for floating chat tools.
-- `apps/desktop/src/openpets-memory.ts` — Local memory engine with JSON store and markdown mirror.
+- `apps/desktop/src/familiaros-memory.ts` — Local memory engine with JSON store and markdown mirror.
 - `apps/desktop/src/knowledge-store-core.ts` — Electron-free file + memory knowledge repository with search and context building.
 - `apps/desktop/src/knowledge-store.ts` — Electron wrapper that wires the core to `app.getPath('userData')`.
-- `apps/desktop/src/tts-service.ts` — Shared TTS dispatcher for pet / floating chat with quiet-hours check.
+- `apps/desktop/src/tts-service.ts` — Shared TTS dispatcher for familiar / floating chat with quiet-hours check.
 - `apps/desktop/src/tts-engine.ts` — Provider-specific synthesis and voice fetching (OpenAI, ElevenLabs, Piper, OpenAI-compatible).
 - `apps/desktop/src/tts-catalog.ts` — Provider catalog, defaults, and endpoint presets.
 - `apps/desktop/src/tts-credentials.ts` — Secure credential storage for TTS providers.
@@ -69,19 +69,19 @@ This PR adds a complete in-app chat layer, a durable local memory system, intera
 - `apps/desktop/src/renderer/src/mcp-toolkit-catalog.ts` — Catalog data for the toolkit UI.
 - `apps/desktop/prompt-window-preload.cjs` — Preload for the floating chat renderer.
 
-### Pet improvements
+### Familiar improvements
 
-- Continuous pet scale slider from 0.16x to 10x in Settings.
+- Continuous familiar scale slider from 0.16x to 10x in Settings.
 - Dynamic window sizing so larger scales are never clipped.
 - Multi-screen positioning (`clampToNearestWorkArea`).
-- Removed the on-pet drag-to-resize handle in favor of the Settings slider.
-- Virtual-pet status (`openpets.virtual-pet`) moved from an on-pet triple-click HUD overlay to the right-click pet context menu, so it never blocks chat clicks. Single-clicking the pet triggers the `pet()` care action.
+- Removed the on-familiar drag-to-resize handle in favor of the Settings slider.
+- Virtual-familiar status (`familiaros.virtual-familiar`) moved from an on-familiar triple-click HUD overlay to the right-click familiar context menu, so it never blocks chat clicks. Single-clicking the familiar triggers the `familiar()` care action.
 
 ### Settings additions
 
 - OpenAPI chat: endpoint preset, model, credential, theme, base-instructions toggle.
 - Moonshot/Kimi endpoint preset.
-- Pet character / system prompt field.
+- Familiar character / system prompt field.
 - Memory viewer with search/edit/delete.
 - **Knowledge Store** tab: upload files, search stored knowledge, delete files, and add manual memory entries.
 
@@ -100,12 +100,12 @@ This PR adds a complete in-app chat layer, a durable local memory system, intera
 
 ### Updated files
 
-- `README.md` — added floating chat, memory, MCP Tool Servers, OpenPets MCP Server, and Curated MCP Toolkit bullets.
+- `README.md` — added floating chat, memory, MCP Tool Servers, FamiliarOS MCP Server, and Curated MCP Toolkit bullets.
 - `FEATURES.md` — comprehensive inventory of new capabilities.
 - `docs/pr-chat-memory-mcp-toolkit.md` — implementation explainer.
-- `docs/phases/phase-14-pet-scale-setting.md` — expanded with new sizes and drag resize.
-- `apps/desktop/src/pet-window.ts` — removed scale handle; IPC handlers; dynamic window sizing.
-- `apps/desktop/pet-preload.cjs` — single/double-click detection; single-click emits `pet:clicked` for virtual-pet petting, double-click opens floating chat.
+- `docs/phases/phase-14-familiar-scale-setting.md` — expanded with new sizes and drag resize.
+- `apps/desktop/src/familiar-window.ts` — removed scale handle; IPC handlers; dynamic window sizing.
+- `apps/desktop/familiar-preload.cjs` — single/double-click detection; single-click emits `familiar:clicked` for virtual-familiar petting, double-click opens floating chat.
 - `apps/desktop/src/app-state-core.ts` — expanded scale range.
 - `apps/desktop/src/renderer/src/main.tsx` — Settings/Integrations UI additions.
 - `apps/desktop/src/windows.ts` — memory IPC, toolkit IPC, preference handling.
@@ -122,7 +122,7 @@ apps/desktop/prompt-window-preload.cjs
 apps/desktop/src/mcp-chat-client.ts
 apps/desktop/src/mcp-toolkit-installer.ts
 apps/desktop/src/openapi-chat.ts
-apps/desktop/src/openpets-memory.ts
+apps/desktop/src/familiaros-memory.ts
 apps/desktop/src/prompt-window.ts
 apps/desktop/src/renderer/src/mcp-toolkit-catalog.ts
 apps/desktop/src/knowledge-store-core.ts
@@ -139,25 +139,25 @@ apps/desktop/tests/tts-engine.test.ts
 
 ```bash
 pnpm install
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 All existing tests pass. Additional manual verification:
 
-1. Launch the desktop app and double-click the pet — floating chat should open.
+1. Launch the desktop app and double-click the familiar — floating chat should open.
 2. Add an OpenAI-compatible API key in Settings > OpenAPI Chat.
-3. Send a message; assistant reply should appear in the pet bubble and in the history list.
+3. Send a message; assistant reply should appear in the familiar bubble and in the history list.
 4. Say "remember that my favorite color is blue" — memory should be captured.
 5. Open Settings > Memory — the memory should be searchable, editable, and deletable.
 6. Open Integrations > MCP Tool Servers — activate Filesystem + Fetch/Web, then chat "list my home directory files" — tools should run.
-7. Open Integrations > OpenPets MCP Server — choose a command mode, click Test Server, and verify the server responds.
+7. Open Integrations > FamiliarOS MCP Server — choose a command mode, click Test Server, and verify the server responds.
 8. Open Integrations > Curated MCP Toolkit to browse copy-paste snippets and optional persistent bundles.
-9. Open Settings > Text-to-Speech, choose System voice, click **Speak** — the pet should speak the test phrase.
-10. Add an OpenAI TTS key, select a voice, click **Speak** — audio should play through the pet window.
+9. Open Settings > Text-to-Speech, choose System voice, click **Speak** — the familiar should speak the test phrase.
+10. Add an OpenAI TTS key, select a voice, click **Speak** — audio should play through the familiar window.
 11. Store a `.txt` file in Settings > Knowledge Store and ask the assistant about its content — the reply should reference the stored file.
-12. Right-click the pet → choose Virtual Pet ▸ Feed/Play/Pet/Nap; stats update and the context menu reflects the new values.
-13. Change display — pet should stay on the display it is currently near.
+12. Right-click the familiar → choose Virtual Familiar ▸ Feed/Play/Familiar/Nap; stats update and the context menu reflects the new values.
+13. Change display — familiar should stay on the display it is currently near.
 
 ## Backwards compatibility
 
@@ -176,5 +176,5 @@ All existing tests pass. Additional manual verification:
   1. Floating chat + OpenAPI BYOK
   2. Memory system + memory viewer
   3. Vanilla chat MCP tools
-  4. Pet sizing expansion + drag handle
+  4. Familiar sizing expansion + drag handle
   5. Multi-screen positioning
diff --git a/README.md b/README.md
index 32735a38..e24708ad 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="assets/openpets.png" alt="OpenPets - pixel art desktop companion" width="100%" />
+  <img src="assets/familiaros.png" alt="FamiliarOS - pixel art desktop companion" width="100%" />
 </p>
 
 <p align="center">
@@ -7,15 +7,15 @@
 </p>
 
 <p align="center">
-  A playful pet that lives on your desktop, keeps you company, and can grow with bundled abilities and developer integrations.
+  A playful familiar that lives on your desktop, keeps you company, and can grow with bundled abilities and developer integrations.
 </p>
 
 <p align="center">
-  <sub>This branch also includes a <strong>floating chat surface</strong>, <strong>local memory</strong>, <strong>Knowledge Store</strong>, <strong>MCP Tool Servers</strong>, an <strong>OpenPets MCP Server</strong> panel, a <strong>Curated MCP Toolkit</strong>, <strong>Text-to-Speech (Phase 2)</strong>, and <strong>expanded pet sizing</strong>. See <code>FEATURES.md</code>, <code>FEATURE_REGISTRY.md</code>, and <code>PULL_REQUEST.md</code> for details.</sub>
+  <sub>This branch also includes a <strong>floating chat surface</strong>, <strong>local memory</strong>, <strong>Knowledge Store</strong>, <strong>MCP Tool Servers</strong>, an <strong>FamiliarOS MCP Server</strong> panel, a <strong>Curated MCP Toolkit</strong>, <strong>Text-to-Speech (Phase 2)</strong>, and <strong>expanded familiar sizing</strong>. See <code>FEATURES.md</code>, <code>FEATURE_REGISTRY.md</code>, and <code>PULL_REQUEST.md</code> for details.</sub>
 </p>
 
 <p align="center">
-  <img src="assets/intro.png" alt="OpenPets reacting across multiple coding agent sessions" width="100%" />
+  <img src="assets/intro.png" alt="FamiliarOS reacting across multiple coding agent sessions" width="100%" />
 </p>
 
 <div align="center">
@@ -33,116 +33,116 @@
 
 ## 2-minute Quick Start
 
-Download and launch the desktop app from [OpenPets Releases](https://github.com/alvinunreal/openpets/releases/latest). A companion pet appears immediately; bundled abilities make it feel alive without requiring an agent setup.
+Download and launch the desktop app from [FamiliarOS Releases](https://github.com/alvinunreal/familiaros/releases/latest). A companion familiar appears immediately; bundled abilities make it feel alive without requiring an agent setup.
 
-If you also want coding-agent integration, install the OpenPets Agent Skill with [skills.sh](https://skills.sh/):
+If you also want coding-agent integration, install the FamiliarOS Agent Skill with [skills.sh](https://skills.sh/):
 
 ```bash
-npx skills add alvinunreal/openpets --skill openpets
+npx skills add alvinunreal/familiaros --skill familiaros
 ```
 
 Then open Claude Code, OpenCode, Codex, or another skill-aware agent and say:
 
 ```text
-Use the OpenPets skill. Install OpenPets for me, connect this agent, and verify the integration works.
+Use the FamiliarOS skill. Install FamiliarOS for me, connect this agent, and verify the integration works.
 ```
 
 For project setup, open your agent inside the repo and say:
 
 ```text
-Use the OpenPets skill. Help me choose or install a pet, configure it for this project, and verify the project integration.
+Use the FamiliarOS skill. Help me choose or install a familiar, configure it for this project, and verify the project integration.
 ```
 
 Useful prompts:
 
 ```text
-Use the OpenPets skill. Configure this project for Claude Code with a pet.
-Use the OpenPets skill. Configure this project for OpenCode with a pet.
-Use the OpenPets skill. Debug why openpets_status is unavailable.
+Use the FamiliarOS skill. Configure this project for Claude Code with a familiar.
+Use the FamiliarOS skill. Configure this project for OpenCode with a familiar.
+Use the FamiliarOS skill. Debug why familiaros_status is unavailable.
 ```
 
-## Star OpenPets
+## Star FamiliarOS
 
-Here is an extra GIF of me starring my own repo to encourage you to do the same. If OpenPets makes your coding setup a little more fun, please give the repo a star.
+Here is an extra GIF of me starring my own repo to encourage you to do the same. If FamiliarOS makes your coding setup a little more fun, please give the repo a star.
 
 <p align="center">
-  <img src="assets/star-repo.gif" alt="Starring the OpenPets repository" width="100%" />
+  <img src="assets/star-repo.gif" alt="Starring the FamiliarOS repository" width="100%" />
 </p>
 
-## What is OpenPets?
+## What is FamiliarOS?
 
-OpenPets is a tray-first desktop companion app. A pet appears on your desktop, keeps you company, and can use bundled abilities for ambient presence, breaks, playful actions, and focus sessions. Coding-agent integrations are still supported as an advanced developer layer.
+FamiliarOS is a tray-first desktop companion app. A familiar appears on your desktop, keeps you company, and can use bundled abilities for ambient presence, breaks, playful actions, and focus sessions. Coding-agent integrations are still supported as an advanced developer layer.
 
-- **Desktop companion** - a small pet that idles, reacts, and gives OpenPets a friendly presence even before developer tools are configured.
-- **Bundled abilities** - first-party plugins can add ambient check-ins, break nudges, playful pet actions, focus timers, safe little walks, and optional developer notifications.
-- **Developer integrations** - advanced setup for Claude Code, OpenCode, Cursor, Pi, and MCP-capable tools when you want coding activity to drive the pet.
-- **MCP ready** - any MCP-capable agent can send short safe speech bubbles and reactions through the OpenPets MCP server.
-- **Floating chat** - double-click the pet to open an always-on-top chat window with BYOK OpenAPI-compatible providers, conversation history, and optional MCP Tool Server activation.
-- **Virtual-pet status** - right-click the pet and open the Virtual Pet submenu to see hunger, energy, happiness, bond, mood, and level. No on-pet HUD overlay, so chat clicks stay unobstructed.
-- **Single-click petting** - click the pet once to pet it; the virtual-pet bond and happiness increase.
-- **Local memory** - the pet remembers facts, preferences, and notes across sessions.
-- **Text-to-Speech (Phase 2)** - configurable system, OpenAI, ElevenLabs, Piper, or OpenAI-compatible TTS for the pet and floating chat, with voice/model/speed controls and a test preview.
-- **Pet-pack friendly** - loads installed animated pet packs and can route a selected agent/project to its own pet window.
+- **Desktop companion** - a small familiar that idles, reacts, and gives FamiliarOS a friendly presence even before developer tools are configured.
+- **Bundled abilities** - first-party plugins can add ambient check-ins, break nudges, playful familiar actions, focus timers, safe little walks, and optional developer notifications.
+- **Developer integrations** - advanced setup for Claude Code, OpenCode, Cursor, Pi, and MCP-capable tools when you want coding activity to drive the familiar.
+- **MCP ready** - any MCP-capable agent can send short safe speech bubbles and reactions through the FamiliarOS MCP server.
+- **Floating chat** - double-click the familiar to open an always-on-top chat window with BYOK OpenAPI-compatible providers, conversation history, and optional MCP Tool Server activation.
+- **Virtual-familiar status** - right-click the familiar and open the Virtual Familiar submenu to see hunger, energy, happiness, bond, mood, and level. No on-familiar HUD overlay, so chat clicks stay unobstructed.
+- **Single-click petting** - click the familiar once to familiar it; the virtual-familiar bond and happiness increase.
+- **Local memory** - the familiar remembers facts, preferences, and notes across sessions.
+- **Text-to-Speech (Phase 2)** - configurable system, OpenAI, ElevenLabs, Piper, or OpenAI-compatible TTS for the familiar and floating chat, with voice/model/speed controls and a test preview.
+- **Familiar-pack friendly** - loads installed animated familiar packs and can route a selected agent/project to its own familiar window.
 - **Privacy-conscious by design** - automatic hook speech is static and local; prompts, code, logs, command output, URLs, paths, and secrets are not shown in bubbles.
 
-## Manage your pets
+## Manage your familiars
 
-Browse installed pets, preview their animations, and choose which companion should follow each coding agent from the OpenPets desktop app.
+Browse installed familiars, preview their animations, and choose which companion should follow each coding agent from the FamiliarOS desktop app.
 
 <p align="center">
-  <img src="assets/manage-pets.png" alt="Managing pets in the OpenPets desktop app" width="100%" />
+  <img src="assets/manage-familiars.png" alt="Managing familiars in the FamiliarOS desktop app" width="100%" />
 </p>
 
 ## Quick start
 
 Install the desktop app, then optionally connect your coding agent.
 
-### 1. Install OpenPets Desktop
+### 1. Install FamiliarOS Desktop
 
-Download the latest app from [OpenPets Releases](https://github.com/alvinunreal/openpets/releases/latest):
+Download the latest app from [FamiliarOS Releases](https://github.com/alvinunreal/familiaros/releases/latest):
 
-- **macOS Apple Silicon**: `OpenPets-*-mac-arm64.dmg`
-- **macOS Intel**: `OpenPets-*-mac-x64.dmg`
-- **Windows**: `OpenPets-*-win-x64-setup.exe`
-- **Linux**: `OpenPets-*-linux-x86_64.AppImage`
+- **macOS Apple Silicon**: `FamiliarOS-*-mac-arm64.dmg`
+- **macOS Intel**: `FamiliarOS-*-mac-x64.dmg`
+- **Windows**: `FamiliarOS-*-win-x64-setup.exe`
+- **Linux**: `FamiliarOS-*-linux-x86_64.AppImage`
 
-Launch OpenPets. You should see the desktop pet and the OpenPets tray/menu-bar icon.
+Launch FamiliarOS. You should see the desktop familiar and the FamiliarOS tray/menu-bar icon.
 
 > Current builds may be unsigned. macOS or Windows may show a security warning the first time you open the app.
 
 If macOS says the app is damaged or should be moved to Trash, remove the quarantine flag and open it again:
 
 ```bash
-xattr -dr com.apple.quarantine /Applications/OpenPets.app
-open /Applications/OpenPets.app
+xattr -dr com.apple.quarantine /Applications/FamiliarOS.app
+open /Applications/FamiliarOS.app
 ```
 
 ### 2. Optional: connect your agent
 
 Use the desktop **Integrations** screen for global setup when available:
 
-- **Claude Code** - installs OpenPets MCP, Claude memory instructions, and optional Claude hooks.
-- **OpenCode** - installs OpenPets MCP, an OpenCode instruction file, and the `@open-pets/opencode` plugin.
+- **Claude Code** - installs FamiliarOS MCP, Claude memory instructions, and optional Claude hooks.
+- **OpenCode** - installs FamiliarOS MCP, an OpenCode instruction file, and the `@familiaros/opencode` plugin.
 - **MCP Toolkit** - curated setup guidance for Filesystem, Git, GitHub, Playwright, Browser Use, Memory, Fetch, Docker, and adjacent terminal/system MCP layers.
 
 <p align="center">
-  <img src="assets/integrations.png" alt="OpenPets desktop integrations screen" width="100%" />
+  <img src="assets/integrations.png" alt="FamiliarOS desktop integrations screen" width="100%" />
 </p>
 
 For project-local setup, run the CLI from the project you want to configure:
 
 ```bash
-npx -y @open-pets/cli@latest configure --agent claude --pet <petId>
-npx -y @open-pets/cli@latest configure --agent opencode --pet <petId>
+npx -y @familiaros/cli@latest configure --agent claude --familiar <petId>
+npx -y @familiaros/cli@latest configure --agent opencode --familiar <petId>
 ```
 
-If you prefer a permanent `openpets` shell command, install the CLI once with `npm install -g @open-pets/cli` and replace `npx -y @open-pets/cli@latest` with `openpets`.
+If you prefer a permanent `familiaros` shell command, install the CLI once with `npm install -g @familiaros/cli` and replace `npx -y @familiaros/cli@latest` with `familiaros`.
 
-Project-local setup can create project files such as `.claude/settings.local.json` or `.opencode/opencode.jsonc`. Review them before committing because they may include the selected pet id.
+Project-local setup can create project files such as `.claude/settings.local.json` or `.opencode/opencode.jsonc`. Review them before committing because they may include the selected familiar id.
 
 ## Advanced: agent integrations
 
-OpenPets integrations have three layers:
+FamiliarOS integrations have three layers:
 
 1. **MCP tools** for explicit agent actions.
 2. **Agent instructions** so agents know when to use those tools.
@@ -152,21 +152,21 @@ OpenPets integrations have three layers:
 
 Claude Code integration supports:
 
-- `openpets` MCP setup via Claude Code.
-- Managed Claude memory instructions in `~/.claude/CLAUDE.md` and `~/.claude/openpets.md`.
+- `familiaros` MCP setup via Claude Code.
+- Managed Claude memory instructions in `~/.claude/CLAUDE.md` and `~/.claude/familiaros.md`.
 - Managed Claude hooks in `~/.claude/settings.json`.
-- Project-local setup through `npx -y @open-pets/cli@latest configure --agent claude --pet <petId>` or the optional global `openpets` CLI.
+- Project-local setup through `npx -y @familiaros/cli@latest configure --agent claude --familiar <petId>` or the optional global `familiaros` CLI.
 
 Typical global MCP command shape:
 
 ```bash
-claude mcp add --scope user openpets -- npx -y @open-pets/mcp@latest
+claude mcp add --scope user familiaros -- npx -y @familiaros/mcp@latest
 ```
 
-With a selected pet:
+With a selected familiar:
 
 ```bash
-claude mcp add --scope user openpets -- npx -y @open-pets/mcp@latest --pet <petId>
+claude mcp add --scope user familiaros -- npx -y @familiaros/mcp@latest --familiar <petId>
 ```
 
 See [`docs/claude-integration.md`](docs/claude-integration.md) for the full file layout, hook mapping, project-local behavior, and safety rules.
@@ -175,44 +175,44 @@ See [`docs/claude-integration.md`](docs/claude-integration.md) for the full file
 
 OpenCode integration supports:
 
-- An MCP entry using `@open-pets/cli mcp`.
-- A managed `openpets.md` instruction file.
-- The `@open-pets/opencode` plugin for automatic reactions.
+- An MCP entry using `@familiaros/cli mcp`.
+- A managed `familiaros.md` instruction file.
+- The `@familiaros/opencode` plugin for automatic reactions.
 - Global desktop setup and project-local `.opencode` setup.
 
 Project-local setup:
 
 ```bash
-npx -y @open-pets/cli@latest configure --agent opencode --pet <petId>
+npx -y @familiaros/cli@latest configure --agent opencode --familiar <petId>
 ```
 
 See [`docs/opencode.md`](docs/opencode.md) for global config selection, plugin behavior, project-local setup, and safety rules.
 
 ### Generic MCP clients
 
-Any MCP-capable editor or coding agent can talk to OpenPets through the MCP server while the desktop app is running.
+Any MCP-capable editor or coding agent can talk to FamiliarOS through the MCP server while the desktop app is running.
 
 ```json
 {
   "mcpServers": {
-    "openpets": {
+    "familiaros": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@open-pets/mcp@latest"]
+      "args": ["-y", "@familiaros/mcp@latest"]
     }
   }
 }
 ```
 
-To target a specific installed non-default pet:
+To target a specific installed non-default familiar:
 
 ```json
 {
   "mcpServers": {
-    "openpets": {
+    "familiaros": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@open-pets/mcp@latest", "--pet", "<petId>"]
+      "args": ["-y", "@familiaros/mcp@latest", "--familiar", "<petId>"]
     }
   }
 }
@@ -220,27 +220,27 @@ To target a specific installed non-default pet:
 
 Available MCP tools:
 
-- `openpets_status` - check whether OpenPets is reachable and which pet is targeted.
-- `openpets_react` - set a short reaction on the target pet.
-- `openpets_say` - show a short safe speech bubble, optionally with a reaction.
-- `openpets_memory_list` - list recent long-term memories stored by OpenPets.
-- `openpets_memory_search` - search pet memory for relevant facts, preferences, or notes.
-- `openpets_memory_store` - store a durable memory for the pet.
-- `openpets_memory_forget` - delete a stored memory by id.
+- `familiaros_status` - check whether FamiliarOS is reachable and which familiar is targeted.
+- `familiaros_react` - set a short reaction on the target familiar.
+- `familiaros_say` - show a short safe speech bubble, optionally with a reaction.
+- `familiaros_memory_list` - list recent long-term memories stored by FamiliarOS.
+- `familiaros_memory_search` - search familiar memory for relevant facts, preferences, or notes.
+- `familiaros_memory_store` - store a durable memory for the familiar.
+- `familiaros_memory_forget` - delete a stored memory by id.
 
-`openpets_say` messages must be short, single-line, and must not look like code, logs, secrets, URLs, or file paths.
+`familiaros_say` messages must be short, single-line, and must not look like code, logs, secrets, URLs, or file paths.
 
 ### MCP Tool Servers
 
-The desktop app includes a dedicated **MCP Tool Servers** panel under **Integrations** for the built-in floating chat. Activate tool servers such as filesystem, terminal, memory, fetch-web, sequential-thinking, playwright, git, github, docker, and sqlite so the pet can use them directly. This works independently of whether Claude, Cursor, OpenCode, or Pi are installed.
+The desktop app includes a dedicated **MCP Tool Servers** panel under **Integrations** for the built-in floating chat. Activate tool servers such as filesystem, terminal, memory, fetch-web, sequential-thinking, playwright, git, github, docker, and sqlite so the familiar can use them directly. This works independently of whether Claude, Cursor, OpenCode, or Pi are installed.
 
-### OpenPets MCP Server
+### FamiliarOS MCP Server
 
-A central **OpenPets MCP Server** panel under **Integrations** configures the external-agent bridge. It collects command mode (published / bundled / local), node path, and pet routing in one place, and provides a **Test Server** check and a **Copy MCP JSON** button for pasting into Claude Code, Cursor, Codex CLI, or any other MCP host.
+A central **FamiliarOS MCP Server** panel under **Integrations** configures the external-agent bridge. It collects command mode (published / bundled / local), node path, and familiar routing in one place, and provides a **Test Server** check and a **Copy MCP JSON** button for pasting into Claude Code, Cursor, Codex CLI, or any other MCP host.
 
 ### Curated MCP toolkit
 
-The desktop app also includes a manual-but-curated **Curated MCP Toolkit** panel under **Integrations**. It is there to help you build a practical broader stack without stuffing OpenPets full of unsafe one-click third-party installs.
+The desktop app also includes a manual-but-curated **Curated MCP Toolkit** panel under **Integrations**. It is there to help you build a practical broader stack without stuffing FamiliarOS full of unsafe one-click third-party installs.
 
 The toolkit offers two paths:
 
@@ -288,18 +288,18 @@ It also maps the next terminal-oriented layers that usually matter once your wor
 
 ```text
 Claude Code / OpenCode / Pi / MCP client
-  -> @open-pets/mcp, @open-pets/cli mcp, @open-pets/claude hook, @open-pets/opencode plugin, or @open-pets/pi extension
-  -> @open-pets/client
-  -> OpenPets desktop local IPC discovery file
-  -> OpenPets desktop IPC socket/pipe
-  -> default pet or selected agent pet window
+  -> @familiaros/mcp, @familiaros/cli mcp, @familiaros/claude hook, @familiaros/opencode plugin, or @familiaros/pi extension
+  -> @familiaros/client
+  -> FamiliarOS desktop local IPC discovery file
+  -> FamiliarOS desktop IPC socket/pipe
+  -> default familiar or selected agent familiar window
 ```
 
 The desktop app writes a local discovery file containing an IPC endpoint and a per-run token. Clients must send that token with every request.
 
 For Windows desktop + WSL agent setups, see [`docs/wsl-ipc.md`](docs/wsl-ipc.md) for the opt-in TCP transport.
 
-When an integration is configured with `--pet <petId>`, OpenPets asks the desktop app for a short-lived lease. Valid installed non-default pets open as explicit agent pet windows. Missing, invalid, broken, built-in, or default pet requests fall back to the desktop default pet.
+When an integration is configured with `--familiar <petId>`, FamiliarOS asks the desktop app for a short-lived lease. Valid installed non-default familiars open as explicit agent familiar windows. Missing, invalid, broken, built-in, or default familiar requests fall back to the desktop default familiar.
 
 ## Reactions and speech
 
@@ -320,14 +320,14 @@ Generic shell activity is intentionally quiet by default. Hook/plugin speech is
 
 ### Pi extension package
 
-OpenPets includes an experimental Pi extension package at `@open-pets/pi`. Pi support is extension-first rather than MCP-first: the extension listens to Pi lifecycle/tool events and sends local best-effort reactions through `@open-pets/client`.
+FamiliarOS includes an experimental Pi extension package at `@familiaros/pi`. Pi support is extension-first rather than MCP-first: the extension listens to Pi lifecycle/tool events and sends local best-effort reactions through `@familiaros/client`.
 
 ```bash
-pi install npm:@open-pets/pi
-pi install -l npm:@open-pets/pi
+pi install npm:@familiaros/pi
+pi install -l npm:@familiaros/pi
 ```
 
-Inside Pi, the extension registers `/openpets status`, `/openpets test`, `/openpets react <reaction>`, and `/openpets say <message>`. Automatic events do not forward prompts, assistant text, tool output, file contents, paths, URLs, or secrets. Real Pi CLI install validation is still required before marking the integration fully supported.
+Inside Pi, the extension registers `/familiaros status`, `/familiaros test`, `/familiaros react <reaction>`, and `/familiaros say <message>`. Automatic events do not forward prompts, assistant text, tool output, file contents, paths, URLs, or secrets. Real Pi CLI install validation is still required before marking the integration fully supported.
 
 ## Development
 
@@ -354,7 +354,7 @@ pnpm dev:desktop
 Equivalent package command:
 
 ```bash
-pnpm --filter @open-pets/desktop dev
+pnpm --filter @familiaros/desktop dev
 ```
 
 ### Checks
@@ -366,7 +366,7 @@ pnpm build
 pnpm test
 ```
 
-OpenPets currently uses lightweight Node contract checks instead of a full test framework. See [`docs/testing.md`](docs/testing.md).
+FamiliarOS currently uses lightweight Node contract checks instead of a full test framework. See [`docs/testing.md`](docs/testing.md).
 
 ### Package desktop builds
 
@@ -381,15 +381,15 @@ Release process details live in [`docs/release.md`](docs/release.md).
 
 ```text
 apps/desktop              Electron desktop app
-packages/client           @open-pets/client, local IPC client
-packages/mcp              @open-pets/mcp, MCP stdio server
-packages/claude           @open-pets/claude, Claude command and hook helpers
-packages/opencode         @open-pets/opencode, OpenCode config and plugin integration
-packages/pi               @open-pets/pi, Pi extension package
+packages/client           @familiaros/client, local IPC client
+packages/mcp              @familiaros/mcp, MCP stdio server
+packages/claude           @familiaros/claude, Claude command and hook helpers
+packages/opencode         @familiaros/opencode, OpenCode config and plugin integration
+packages/pi               @familiaros/pi, Pi extension package
 packages/agent-events     Shared safe agent event speech helpers
-packages/cli              @open-pets/cli, user-run CLI, plugin scaffolder/validator, MCP/hook entrypoints
-packages/sdk              @open-pets/plugin-sdk, plugin SDK v3 types + testing harness
-packages/pet-format       @open-pets/pet-format, pet/catalog format types
+packages/cli              @familiaros/cli, user-run CLI, plugin scaffolder/validator, MCP/hook entrypoints
+packages/sdk              @familiaros/plugin-sdk, plugin SDK v3 types + testing harness
+packages/familiar-format       @familiaros/familiar-format, familiar/catalog format types
 plugins/official          First-party plugin source (bundled + catalog)
 docs/                     Documentation
 ```
@@ -407,9 +407,9 @@ docs/                     Documentation
 
 ## Safety and privacy notes
 
-- OpenPets local IPC is local-only and protected by a per-run token.
+- FamiliarOS local IPC is local-only and protected by a per-run token.
 - Hook/plugin errors are swallowed unless debug logging is enabled.
 - Automatic speech is static and local; it does not include model-generated prompt text.
 - Tool inputs and command text are used only for coarse reaction classification.
-- Managed setup preserves unrelated user config and removes only OpenPets-managed entries.
+- Managed setup preserves unrelated user config and removes only FamiliarOS-managed entries.
 - Speech validation rejects code-like, secret-like, URL-like, path-like, or multiline messages.
diff --git a/README_OUR_CHANGES.md b/README_OUR_CHANGES.md
index 0c275a53..556820aa 100644
--- a/README_OUR_CHANGES.md
+++ b/README_OUR_CHANGES.md
@@ -1,10 +1,10 @@
-# OpenPets — Our Additions (Isolated README)
+# FamiliarOS — Our Additions (Isolated README)
 
 This README describes only the capabilities added by our fork. It is kept separate from the upstream `README.md` so the original maintainer can review and adopt changes independently.
 
 ## New: Floating Chat Window
 
-Double-click the desktop pet to open an always-on-top floating chat window.
+Double-click the desktop familiar to open an always-on-top floating chat window.
 
 - BYOK OpenAPI-compatible chat (OpenAI, OpenRouter, Moonshot/Kimi, LiteLLM, vLLM, Azure, custom).
 - Conversation history rendered as a styled list with role badges and timestamps.
@@ -16,13 +16,13 @@ Double-click the desktop pet to open an always-on-top floating chat window.
 
 ## New: Local Memory
 
-OpenPets now remembers things for you.
+FamiliarOS now remembers things for you.
 
 - Durable local memory store with automatic capture from chat prompts.
 - Relevance-based retrieval into future system prompts.
 - Memory kinds: preference, identity, fact, note.
 - In-app memory viewer in Settings for search, edit, and delete.
-- Also exposed through existing OpenPets MCP tools (`openpets_memory_*`).
+- Also exposed through existing FamiliarOS MCP tools (`familiaros_memory_*`).
 
 ## New: Knowledge Store
 
@@ -31,7 +31,7 @@ Store files and add manual knowledge entries that the assistant can reference du
 - Upload files from Settings > Knowledge Store or store attachments directly from the floating chat window.
 - Text-like files are indexed and searched by file name and extracted content.
 - Relevant files are injected into the assistant's system instructions automatically.
-- Combined search across stored files and OpenPets memories.
+- Combined search across stored files and FamiliarOS memories.
 
 ## New: MCP Tool Servers (Built-in Chat)
 
@@ -42,56 +42,56 @@ Activate MCP tool servers for the built-in floating chat, independently of exter
 - Tiered browser: Starter, Terminal & Systems, Advanced.
 - Tools run through an internal stdio MCP client in the main process.
 
-## New: OpenPets MCP Server Panel
+## New: FamiliarOS MCP Server Panel
 
 A central panel in Control Center → Integrations configures the external-agent bridge.
 
 - Command mode selector (published / bundled / local) in one place.
-- Node path override and pet routing in one place.
+- Node path override and familiar routing in one place.
 - One-click **Test Server** health check.
 - One-click **Copy MCP JSON** for Claude Code, Cursor, Codex CLI, or generic MCP hosts.
 
-## New: Pet Scale
+## New: Familiar Scale
 
 - Continuous scale slider from 0.16x to 10x in Settings.
-- Window dynamically resizes so the pet is never clipped.
+- Window dynamically resizes so the familiar is never clipped.
 
-## New: Virtual Pet Status
+## New: Virtual Familiar Status
 
-- Bundled virtual-pet plugin tracks hunger, energy, happiness, and affection.
-- Status values live in the right-click pet context menu (Virtual Pet ▸ Mood, Food, Energy, Play, Bond, Level) instead of an on-pet HUD overlay, so double-click chat stays unobstructed.
-- Feed, play, pet, and nap commands are available from the pet context menu.
+- Bundled virtual-familiar plugin tracks hunger, energy, happiness, and affection.
+- Status values live in the right-click familiar context menu (Virtual Familiar ▸ Mood, Food, Energy, Play, Bond, Level) instead of an on-familiar HUD overlay, so double-click chat stays unobstructed.
+- Feed, play, familiar, and nap commands are available from the familiar context menu.
 
-## New: Pet Character & Base Instructions
+## New: Familiar Character & Base Instructions
 
-- Give your pet a custom system-prompt style character in Settings.
-- Toggle whether the default OpenPets behavior instructions are included in every chat.
+- Give your familiar a custom system-prompt style character in Settings.
+- Toggle whether the default FamiliarOS behavior instructions are included in every chat.
 
 ## New: Text-to-Speech (Phase 2)
 
-The pet can now speak aloud using a configurable TTS provider.
+The familiar can now speak aloud using a configurable TTS provider.
 
 - Settings > **Text-to-Speech** chooses between system OS voice, OpenAI TTS, ElevenLabs, Piper (local), or an OpenAI-compatible endpoint.
 - Per-provider voice, model, speed, endpoint preset, and API-key storage.
 - Test and Stop buttons preview the voice in Settings.
 - Speech is skipped during quiet hours and uses the same safety boundaries as bubbles.
-- Plugins with the `voice:speak` permission can ask the pet to speak.
+- Plugins with the `voice:speak` permission can ask the familiar to speak.
 
 ## New: Multi-Screen Awareness
 
-The pet now stays on the display it is currently near, rather than always snapping to the primary display.
+The familiar now stays on the display it is currently near, rather than always snapping to the primary display.
 
 ## Installing these changes
 
-No additional setup is required beyond the normal OpenPets desktop app. The new surfaces appear automatically:
+No additional setup is required beyond the normal FamiliarOS desktop app. The new surfaces appear automatically:
 
-- Single-click the pet → pet the virtual pet.
-- Double-click the pet → floating chat.
-- Right-click the pet → Virtual Pet status and care commands.
+- Single-click the familiar → familiar the virtual familiar.
+- Double-click the familiar → floating chat.
+- Right-click the familiar → Virtual Familiar status and care commands.
 - Settings → OpenAPI Chat for model/credential setup.
 - Settings → Text-to-Speech for voice provider and test preview.
 - Settings → Memory for memory management.
 - Settings → Knowledge Store for file-based knowledge.
 - Integrations → MCP Tool Servers for built-in chat tool activation.
-- Integrations → OpenPets MCP Server for external-agent bridge configuration.
+- Integrations → FamiliarOS MCP Server for external-agent bridge configuration.
 - Integrations → Curated MCP Toolkit for optional persistent bundles and copy-paste snippets.
diff --git a/apps/codemap.md b/apps/codemap.md
index c62d8a7b..e191b278 100644
--- a/apps/codemap.md
+++ b/apps/codemap.md
@@ -2,27 +2,27 @@
 
 ## Responsibility
 
-Container for deployable application packages selected by the pnpm workspace `apps/*` glob. Currently hosts the OpenPets desktop Electron application, which integrates shared packages, local IPC, pet windows, and desktop plugin support into the user-facing app.
+Container for deployable application packages selected by the pnpm workspace `apps/*` glob. Currently hosts the FamiliarOS desktop Electron application, which integrates shared packages, local IPC, familiar windows, and desktop plugin support into the user-facing app.
 
 ## Design Patterns
 
 - **Workspace App Boundary**: `pnpm-workspace.yaml` includes `apps/*`, so each app directory is an independently buildable workspace package.
 - **Workspace Dependencies**: apps consume shared `packages/` modules through `workspace:*` dependencies.
 - **Electron-First Architecture**: the desktop app uses an Electron main process, tray-centric UX, and isolated renderer windows rather than a traditional main window.
-- **Service-Oriented Desktop Modules**: desktop features are split into main-process services for state, IPC, pet controllers, catalog installation, setup flows, and plugin management/runtime.
+- **Service-Oriented Desktop Modules**: desktop features are split into main-process services for state, IPC, familiar controllers, catalog installation, setup flows, and plugin management/runtime.
 - **Security-First Renderers**: CSP headers, sandboxed renderers, context isolation, and disabled `nodeIntegration` protect UI surfaces including plugin-related windows.
 
 ## Data & Control Flow
 
 1. Workspace tooling discovers application packages via the `apps/*` pnpm workspace glob.
 2. The desktop app bootstraps from `apps/desktop/src/main.ts`, initializes user data and app state, then creates tray and renderer windows.
-3. Agent commands flow through the local IPC server into lease-managed pet controllers and window updates.
-4. Pet assets flow from built-in assets, local development sources, or downloaded catalog packages into installation/state services and renderer windows.
-5. Desktop plugin manifests/configuration flow through plugin loader, package, catalog, state, service, and runtime modules before exposing controlled pet APIs and plugin UI.
+3. Agent commands flow through the local IPC server into lease-managed familiar controllers and window updates.
+4. Familiar assets flow from built-in assets, local development sources, or downloaded catalog packages into installation/state services and renderer windows.
+5. Desktop plugin manifests/configuration flow through plugin loader, package, catalog, state, service, and runtime modules before exposing controlled familiar APIs and plugin UI.
 
 ## Integration Points
 
-- **Workspace packages**: consumes `@open-pets/agent-events`, `@open-pets/claude`, `@open-pets/cli`, `@open-pets/cursor`, `@open-pets/mcp`, `@open-pets/opencode`, and IPC/client-facing shared APIs.
-- **Desktop submodules**: `apps/desktop/src/` provides lifecycle, state, tray/windows, setup integrations, pet installation, local IPC, and plugin runtime services.
-- **External services**: GitHub Releases API for update checks, `openpets.dev` for catalog data, and `zip.openpets.dev` for pet downloads.
+- **Workspace packages**: consumes `@familiaros/agent-events`, `@familiaros/claude`, `@familiaros/cli`, `@familiaros/cursor`, `@familiaros/mcp`, `@familiaros/opencode`, and IPC/client-facing shared APIs.
+- **Desktop submodules**: `apps/desktop/src/` provides lifecycle, state, tray/windows, setup integrations, familiar installation, local IPC, and plugin runtime services.
+- **External services**: GitHub Releases API for update checks, `familiaros.dev` for catalog data, and `zip.familiaros.dev` for familiar downloads.
 - **System surfaces**: Claude Code CLI, OpenCode CLI, OS tray/dock, renderer windows, and filesystem locations such as `userData`, `~/.codex`, and `~/.claude`.
diff --git a/apps/desktop/assets/default-pet-spritesheet.webp b/apps/desktop/assets/default-familiar-spritesheet.webp
similarity index 100%
rename from apps/desktop/assets/default-pet-spritesheet.webp
rename to apps/desktop/assets/default-familiar-spritesheet.webp
diff --git a/apps/desktop/assets/default-pet-thumbnail.png b/apps/desktop/assets/default-familiar-thumbnail.png
similarity index 100%
rename from apps/desktop/assets/default-pet-thumbnail.png
rename to apps/desktop/assets/default-familiar-thumbnail.png
diff --git a/apps/desktop/assets/openpets.webp b/apps/desktop/assets/familiaros.webp
similarity index 100%
rename from apps/desktop/assets/openpets.webp
rename to apps/desktop/assets/familiaros.webp
diff --git a/apps/desktop/assets/onboarding-pets.webp b/apps/desktop/assets/onboarding-familiars.webp
similarity index 100%
rename from apps/desktop/assets/onboarding-pets.webp
rename to apps/desktop/assets/onboarding-familiars.webp
diff --git a/apps/desktop/catalog.v2.fixture.json b/apps/desktop/catalog.v2.fixture.json
index e5d15db0..f1462165 100644
--- a/apps/desktop/catalog.v2.fixture.json
+++ b/apps/desktop/catalog.v2.fixture.json
@@ -1,41 +1,41 @@
 {
   "version": 2,
   "generatedAt": "2026-05-05T08:55:53.722Z",
-  "pets": [
+  "familiars": [
     {
       "id": "snoopy",
       "displayName": "Snoopy",
       "description": "A tiny black-and-white beagle with a red collar for calm coding sessions.",
-      "preview": "https://openpets.dev/pets/snoopy-23e05847/spritesheet.webp",
-      "zip": "https://zip.openpets.dev/pets/snoopy-23e05847/snoopy.zip"
+      "preview": "https://familiaros.dev/familiars/snoopy-23e05847/spritesheet.webp",
+      "zip": "https://zip.familiaros.dev/familiars/snoopy-23e05847/snoopy.zip"
     },
     {
       "id": "clippit",
       "displayName": "Clippy",
       "description": "A classic paperclip assistant rebuilt from Microsoft Agent animation frames.",
-      "preview": "https://openpets.dev/pets/clippit-904b393f/spritesheet.webp",
-      "zip": "https://zip.openpets.dev/pets/clippit-904b393f/clippit.zip"
+      "preview": "https://familiaros.dev/familiars/clippit-904b393f/spritesheet.webp",
+      "zip": "https://zip.familiaros.dev/familiars/clippit-904b393f/clippit.zip"
     },
     {
       "id": "tux",
       "displayName": "Tux",
       "description": "A tiny pixel-adjacent Linux mascot penguin for calm coding sessions.",
-      "preview": "https://openpets.dev/pets/tux-de2f300f/spritesheet.webp",
-      "zip": "https://zip.openpets.dev/pets/tux-de2f300f/tux.zip"
+      "preview": "https://familiaros.dev/familiars/tux-de2f300f/spritesheet.webp",
+      "zip": "https://zip.familiaros.dev/familiars/tux-de2f300f/tux.zip"
     },
     {
       "id": "wall-e",
       "displayName": "Wall-E",
       "description": "A tiny weathered trash-compactor robot companion with binocular eyes, treads, and a gentle waving arm.",
-      "preview": "https://openpets.dev/pets/wall-e-779d5202/spritesheet.webp",
-      "zip": "https://zip.openpets.dev/pets/wall-e-779d5202/wall-e.zip"
+      "preview": "https://familiaros.dev/familiars/wall-e-779d5202/spritesheet.webp",
+      "zip": "https://zip.familiaros.dev/familiars/wall-e-779d5202/wall-e.zip"
     },
     {
       "id": "dobby",
       "displayName": "Dobby",
-      "description": "An earnest, genuinely helpful tiny house-elf Codex pet with huge ears, wide kind eyes, and a simple worn tunic.",
-      "preview": "https://openpets.dev/pets/dobby-3f6746e0/spritesheet.webp",
-      "zip": "https://zip.openpets.dev/pets/dobby-3f6746e0/dobby.zip"
+      "description": "An earnest, genuinely helpful tiny house-elf Codex familiar with huge ears, wide kind eyes, and a simple worn tunic.",
+      "preview": "https://familiaros.dev/familiars/dobby-3f6746e0/spritesheet.webp",
+      "zip": "https://zip.familiaros.dev/familiars/dobby-3f6746e0/dobby.zip"
     }
   ]
 }
diff --git a/apps/desktop/codemap.md b/apps/desktop/codemap.md
index 50edfcc1..8c51b1bc 100644
--- a/apps/desktop/codemap.md
+++ b/apps/desktop/codemap.md
@@ -2,11 +2,11 @@
 
 ## Responsibility
 
-OpenPets desktop companion application. Tray-first Electron app providing animated desktop pets that react to coding agent events. Manages pet installations, the React/Tailwind Control Center, plugin automation/runtime, agent integrations (Claude Code, OpenCode, Cursor, Pi guidance), and local IPC for CLI communication.
+FamiliarOS desktop companion application. Tray-first Electron app providing animated desktop familiars that react to coding agent events. Manages familiar installations, the React/Tailwind Control Center, plugin automation/runtime, agent integrations (Claude Code, OpenCode, Cursor, Pi guidance), and local IPC for CLI communication.
 
 ## Design
 
-- **Tray-First UX**: No default main window; tray actions open the singleton React/Tailwind Control Center and route directly to Dashboard, Pets, Integrations, Plugins, and Settings.
+- **Tray-First UX**: No default main window; tray actions open the singleton React/Tailwind Control Center and route directly to Dashboard, Familiars, Integrations, Plugins, and Settings.
 - **Single Instance**: Uses `app.requestSingleInstanceLock()` with second-instance focusing
 - **Security Model**: 
   - Sandboxed renderers with contextIsolation
@@ -15,13 +15,13 @@ OpenPets desktop companion application. Tray-first Electron app providing animat
   - Mock keychain to prevent OS credential prompts
   - IPC network security: loopback/private address filtering for TCP mode
 - **State Management**: File-based JSON state with atomic writes (temp + rename)
-- **Pet Architecture**: 
-  - Default pet (always visible when enabled)
-  - Agent pets (lease-based, appear on explicit agent requests)
-  - Built-in fallback pet (bundled spritesheet)
+- **Familiar Architecture**: 
+  - Default familiar (always visible when enabled)
+  - Agent familiars (lease-based, appear on explicit agent requests)
+  - Built-in fallback familiar (bundled spritesheet)
   - Speech bubbles with reaction messages and status badges
   - User-configurable reaction-to-animation mapping
-- **Lease Manager**: 15s TTL leases for agent pet routing with heartbeat renewal
+- **Lease Manager**: 15s TTL leases for agent familiar routing with heartbeat renewal
 - **Logging**: Structured logging with scopes, log rotation (2MB max), and sensitive data redaction
 - **Plugin Subsystem**: Declarative manifest plugins and JavaScript plugin hosting with permission approval, config schemas, command/status surfaces, catalog/local installs, SDK bridge quotas, storage, schedules, restricted HTTPS fetch, and safe path/ZIP/manifest validation
 
@@ -29,33 +29,33 @@ OpenPets desktop companion application. Tray-first Electron app providing animat
 
 **Startup**: `main.ts` → `installAppLifecycle()` → `initializeAppState()` → `initializeLogger()` → `createAppTray()` → `startLocalIpcServer()` → initialize plugin service with JavaScript host/SDK bridge → optionally `showDefaultPet()`
 
-**Pet Display**: IPC Request → `local-ipc.ts` → `LeaseManager.acquire()` → `agent-pet-controller.ts` → `pet-window.ts` → HTML/CSS spritesheet animation with reaction-to-animation mapping
+**Familiar Display**: IPC Request → `local-ipc.ts` → `LeaseManager.acquire()` → `agent-familiar-controller.ts` → `familiar-window.ts` → HTML/CSS spritesheet animation with reaction-to-animation mapping
 
 **Installation**: Catalog fetch (V3 with pagination fallback to V2) → ZIP download → `yauzl` extraction → validation → state update → tray refresh
 
 **Agent Setup**: UI → `agent-setup.ts` → Claude/OpenCode/Cursor CLI detection → MCP config modification → hooks installation → memory file management
 
-**Control Center**: Tray route → `openControlCenterWindow(route)` → `windows.ts` loads Vite renderer and sends route events → `control-center-preload.cjs` exposes narrow page APIs → React Dashboard/Pets/Integrations/Plugins/Settings routes render snapshots and invoke actions.
+**Control Center**: Tray route → `openControlCenterWindow(route)` → `windows.ts` loads Vite renderer and sends route events → `control-center-preload.cjs` exposes narrow page APIs → React Dashboard/Familiars/Integrations/Plugins/Settings routes render snapshots and invoke actions.
 
-**Plugins**: Control Center plugins route → `plugin-service.ts` → catalog or local manifest/entry loader → permission approval/state update → `plugin-runtime.ts` schedules declarative timers or starts `plugin-js-host.ts` → `plugin-sdk-bridge.ts` applies approved SDK calls to pet/schedule/storage/command/status/network APIs
+**Plugins**: Control Center plugins route → `plugin-service.ts` → catalog or local manifest/entry loader → permission approval/state update → `plugin-runtime.ts` schedules declarative timers or starts `plugin-js-host.ts` → `plugin-sdk-bridge.ts` applies approved SDK calls to familiar/schedule/storage/command/status/network APIs
 
 ## Integration Points
 
-- **Workspace Packages**: `@open-pets/agent-events`, `@open-pets/claude`, `@open-pets/cli`, `@open-pets/cursor`, `@open-pets/mcp`, `@open-pets/opencode`
+- **Workspace Packages**: `@familiaros/agent-events`, `@familiaros/claude`, `@familiaros/cli`, `@familiaros/cursor`, `@familiaros/mcp`, `@familiaros/opencode`
 - **External Services**: 
-  - `https://openpets.dev/pets/catalog.v2.json` (pet catalog V2)
-  - `https://openpets.dev/pets/catalog.v3.json` (pet catalog V3 with pagination)
-  - `https://openpets.dev/plugins/catalog.v1.json` (plugin catalog V1)
-  - `https://zip.openpets.dev/pets/{id}.zip` (pet downloads)
-  - `https://zip.openpets.dev/plugins/{id}.zip` (plugin downloads)
+  - `https://familiaros.dev/familiars/catalog.v2.json` (familiar catalog V2)
+  - `https://familiaros.dev/familiars/catalog.v3.json` (familiar catalog V3 with pagination)
+  - `https://familiaros.dev/plugins/catalog.v1.json` (plugin catalog V1)
+  - `https://zip.familiaros.dev/familiars/{id}.zip` (familiar downloads)
+  - `https://zip.familiaros.dev/plugins/{id}.zip` (plugin downloads)
   - GitHub API (release checks)
 - **System Integration**:
   - Claude Code: `~/.claude/CLAUDE.md`, `~/.claude/settings.json`, `claude mcp` commands
   - OpenCode: `~/.opencode/config.json`
-  - Cursor: `~/.cursor/mcp.json`, `.cursor/rules/openpets.mdc`
-  - Codex: `~/.codex/pets/` (local pet development)
+  - Cursor: `~/.cursor/mcp.json`, `.cursor/rules/familiaros.mdc`
+  - Codex: `~/.codex/familiars/` (local familiar development)
   - IPC: Discovery file at platform-specific path, Unix socket/Windows named pipe/TCP
-  - Logs: `userData/logs/openpets.log`
+  - Logs: `userData/logs/familiaros.log`
 - **Build**: `electron-builder` with ASAR, cross-platform (macOS/Windows/Linux)
 
 ## Key Files
@@ -63,32 +63,32 @@ OpenPets desktop companion application. Tray-first Electron app providing animat
 - `main.ts`: Entry point, lifecycle coordination
 - `tray.ts`: System tray icon and menu
 - `windows.ts`: Control Center BrowserWindow management, Dashboard snapshot, route targeting, IPC handlers, and internal protocols
-- `renderer/`: React/Tailwind Control Center for Dashboard, Pets, Integrations, Plugins, and Settings
+- `renderer/`: React/Tailwind Control Center for Dashboard, Familiars, Integrations, Plugins, and Settings
 - `local-ipc.ts`: TCP/Unix socket server for CLI communication
-- `lease-manager.ts`: Pet routing lease lifecycle
-- `pet-window.ts`: Pet rendering (transparent frameless windows, CSS sprite animation, speech bubbles, status badges)
-- `default-pet-controller.ts`/`agent-pet-controller.ts`: Pet visibility/state management with transient displays
+- `lease-manager.ts`: Familiar routing lease lifecycle
+- `familiar-window.ts`: Familiar rendering (transparent frameless windows, CSS sprite animation, speech bubbles, status badges)
+- `default-familiar-controller.ts`/`agent-familiar-controller.ts`: Familiar visibility/state management with transient displays
 - `app-state.ts`: Persistent state management (JSON file)
 - `agent-setup.ts`: Claude/OpenCode/Cursor integration logic
 - `plugin-service.ts`: Plugin orchestration for snapshots, enable/config/reload, command execution, catalog install/update/uninstall, local loading, permission approval, JavaScript host wiring, and runtime reloads
-- `plugin-manifest.ts`: `openpets.plugin.json` v1/v2 schema/types/validator for declarative timer plugins and JavaScript SDK plugins, config fields, permissions, commands/status/network, and actions
-- `plugin-runtime.ts`: Runtime that compiles enabled declarative timers and starts JavaScript plugin hosts for approved pet/schedule/storage/command/status/network actions
+- `plugin-manifest.ts`: `familiaros.plugin.json` v1/v2 schema/types/validator for declarative timer plugins and JavaScript SDK plugins, config fields, permissions, commands/status/network, and actions
+- `plugin-runtime.ts`: Runtime that compiles enabled declarative timers and starts JavaScript plugin hosts for approved familiar/schedule/storage/command/status/network actions
 - `plugin-state.ts`: Atomic JSON state store for installed plugins, enabled flag, approved permissions, config, broken state, and update metadata
 - `plugin-config.ts`: Plugin default/effective config validation and config reference resolution
 - `plugin-catalog.ts`/`plugin-catalog-validation.ts`: Plugin catalog fetch/cache and strict catalog entry validation
 - `plugin-package.ts`: Catalog plugin ZIP download, SHA-256 verification, manifest extraction, install, and safe uninstall path resolution
 - `plugin-local-loader.ts`: Local developer plugin folder validation and manifest snapshotting into app data
 - `plugin-manifest-reader.ts`: Safe installed-manifest reader enforcing allowed roots, size limits, path containment, and expected id/version
-- `plugin-pet-api.ts`: Runtime bridge from plugin actions to default pet speech/reaction APIs
+- `plugin-familiar-api.ts`: Runtime bridge from plugin actions to default familiar speech/reaction APIs
 - `plugin-js-host.ts`: Hidden sandboxed BrowserWindow host for JavaScript plugin entry modules, SDK IPC tokening, session hardening, startup handshake, and teardown
 - `plugin-sdk-bridge.ts`: Permission-checked SDK API for JavaScript plugins with quotas, plugin storage, schedules, config listeners, commands/status, logs, and restricted HTTPS fetch
-- `pet-installation.ts`: Catalog ZIP download and extraction
-- `codex-pets.ts`: Local Codex pet import
+- `familiar-installation.ts`: Catalog ZIP download and extraction
+- `codex-familiars.ts`: Local Codex familiar import
 - `catalog.ts`: Remote catalog fetching with V3 pagination and fixture fallback
-- `logger.ts`: Structured logging with scopes (app, ipc, lease, pet, state, tray, ui)
+- `logger.ts`: Structured logging with scopes (app, ipc, lease, familiar, state, tray, ui)
 - `reaction-animation-mapping.ts`: Reaction-to-animation state mapping with user overrides
 - `reaction-messages.ts`: Message pools for each reaction type
-- `control-center-preload.cjs`/`pet-preload.cjs`/`plugin-sdk-preload.cjs`: Narrow contextBridge APIs for the Control Center, pet windows, and plugin SDK host; the legacy `preload.cjs` task-window bridge and `plugins-window.ts` UI have been removed
+- `control-center-preload.cjs`/`familiar-preload.cjs`/`plugin-sdk-preload.cjs`: Narrow contextBridge APIs for the Control Center, familiar windows, and plugin SDK host; the legacy `preload.cjs` task-window bridge and `plugins-window.ts` UI have been removed
 - `electron-builder.yml`: Packaging configuration
 - `scripts/release-local.mjs`: macOS-local release automation with GitHub draft creation
 - `contracts/catalog-fixture.contract.ts`: Catalog V2 validation contract tests against fixture data
@@ -97,7 +97,7 @@ OpenPets desktop companion application. Tray-first Electron app providing animat
 
 ## Test Structure
 
-- **Behavior tests** (`tests/*.test.ts`): Unit tests for lease manager, state management, version checking, ZIP safety, Codex pets, Claude memory, and reaction animation mapping. Compiled to `.test-dist/tests/`.
+- **Behavior tests** (`tests/*.test.ts`): Unit tests for lease manager, state management, version checking, ZIP safety, Codex familiars, Claude memory, and reaction animation mapping. Compiled to `.test-dist/tests/`.
 - **Contract tests** (`contracts/*.contract.ts`): Public API boundary validation for catalog fixtures, IPC protocol, and plugin manifest schema. Compiled to `.test-dist/contracts/`.
 - **Runtime checks** (`src/check-*.ts`): Remaining runtime validation checks compiled to `dist/`.
 - **Test runner** (`scripts/run-tests.mjs`): Orchestrates preload syntax checks → test compilation → behavior tests → contract tests → dist checks.
diff --git a/apps/desktop/contracts/catalog-fixture.contract.ts b/apps/desktop/contracts/catalog-fixture.contract.ts
index dc913761..e9ad4435 100644
--- a/apps/desktop/contracts/catalog-fixture.contract.ts
+++ b/apps/desktop/contracts/catalog-fixture.contract.ts
@@ -8,11 +8,11 @@ validateCatalogV2(fixture);
 const generatedAt = new Date().toISOString();
 
 const invalidCases: readonly unknown[] = [
-  { version: 2, generatedAt, pets: [{ id: "Bad ID", displayName: "Bad", description: "", preview: "https://openpets.dev/pets/x/spritesheet.webp", zip: "https://zip.openpets.dev/pets/x/x.zip" }] },
-  { version: 2, generatedAt, pets: [{ id: "dup", displayName: "Dup", description: "", preview: "https://openpets.dev/pets/x/spritesheet.webp", zip: "https://zip.openpets.dev/pets/x/x.zip" }, { id: "dup", displayName: "Dup 2", description: "", preview: "https://openpets.dev/pets/y/spritesheet.webp", zip: "https://zip.openpets.dev/pets/y/y.zip" }] },
-  { version: 2, generatedAt, pets: [{ id: "http", displayName: "Http", description: "", preview: "http://openpets.dev/pets/x/spritesheet.webp", zip: "https://zip.openpets.dev/pets/x/x.zip" }] },
-  { version: 2, generatedAt, pets: [{ id: "host", displayName: "Host", description: "", preview: "https://evil.example/pets/x/spritesheet.webp", zip: "https://zip.openpets.dev/pets/x/x.zip" }] },
-  { version: 2, generatedAt, pets: [{ id: "builtin", displayName: "Builtin", description: "", preview: "https://openpets.dev/pets/x/spritesheet.webp", zip: "https://zip.openpets.dev/pets/x/x.zip" }] },
+  { version: 2, generatedAt, familiars: [{ id: "Bad ID", displayName: "Bad", description: "", preview: "https://familiaros.dev/familiars/x/spritesheet.webp", zip: "https://zip.familiaros.dev/familiars/x/x.zip" }] },
+  { version: 2, generatedAt, familiars: [{ id: "dup", displayName: "Dup", description: "", preview: "https://familiaros.dev/familiars/x/spritesheet.webp", zip: "https://zip.familiaros.dev/familiars/x/x.zip" }, { id: "dup", displayName: "Dup 2", description: "", preview: "https://familiaros.dev/familiars/y/spritesheet.webp", zip: "https://zip.familiaros.dev/familiars/y/y.zip" }] },
+  { version: 2, generatedAt, familiars: [{ id: "http", displayName: "Http", description: "", preview: "http://familiaros.dev/familiars/x/spritesheet.webp", zip: "https://zip.familiaros.dev/familiars/x/x.zip" }] },
+  { version: 2, generatedAt, familiars: [{ id: "host", displayName: "Host", description: "", preview: "https://evil.example/familiars/x/spritesheet.webp", zip: "https://zip.familiaros.dev/familiars/x/x.zip" }] },
+  { version: 2, generatedAt, familiars: [{ id: "builtin", displayName: "Builtin", description: "", preview: "https://familiaros.dev/familiars/x/spritesheet.webp", zip: "https://zip.familiaros.dev/familiars/x/x.zip" }] },
 ];
 
 for (const invalidCase of invalidCases) {
diff --git a/apps/desktop/contracts/codemap.md b/apps/desktop/contracts/codemap.md
index 25e0d160..10cf9e48 100644
--- a/apps/desktop/contracts/codemap.md
+++ b/apps/desktop/contracts/codemap.md
@@ -2,7 +2,7 @@
 
 ## Responsibility
 
-Public API boundary contract tests for the OpenPets desktop application. These contracts validate that critical external-facing interfaces (catalog data, IPC protocol) conform to expected schemas and behavior. Contract tests are compiled to `.test-dist/contracts/` and executed during `pnpm test`.
+Public API boundary contract tests for the FamiliarOS desktop application. These contracts validate that critical external-facing interfaces (catalog data, IPC protocol) conform to expected schemas and behavior. Contract tests are compiled to `.test-dist/contracts/` and executed during `pnpm test`.
 
 ## Design Patterns
 
@@ -32,8 +32,8 @@ Test parseIpcRequest() with valid/invalid tokens, versions, methods
 
 **Plugin Manifest Contract** (`plugin-manifest.contract.ts`):
 ```
-Assert openpets.plugin.json filename constant
-→ Validate a declarative timer manifest with permissions, config schema, and pet actions
+Assert familiaros.plugin.json filename constant
+→ Validate a declarative timer manifest with permissions, config schema, and familiar actions
 → Test config references, unknown fields, runtime/permission constraints, deferred config types/features, defaults, options, timer intervals, and required permissions
 → Assert each invalid manifest reports the expected error code
 ```
diff --git a/apps/desktop/contracts/local-ipc-protocol.contract.ts b/apps/desktop/contracts/local-ipc-protocol.contract.ts
index 5f9438c0..e9fdebcf 100644
--- a/apps/desktop/contracts/local-ipc-protocol.contract.ts
+++ b/apps/desktop/contracts/local-ipc-protocol.contract.ts
@@ -12,10 +12,10 @@ const valid = {
 };
 
 parseIpcRequest(JSON.stringify(valid), token);
-parseIpcRequest(JSON.stringify({ ...valid, method: "pets.list" }), token);
+parseIpcRequest(JSON.stringify({ ...valid, method: "familiars.list" }), token);
 assert.throws(() => parseIpcRequest(JSON.stringify({ ...valid, token: "bad" }), token));
 assert.throws(() => parseIpcRequest(JSON.stringify({ ...valid, version: 2 }), token));
-assert.throws(() => parseIpcRequest(JSON.stringify({ ...valid, method: "pet.install" }), token));
+assert.throws(() => parseIpcRequest(JSON.stringify({ ...valid, method: "familiar.install" }), token));
 assert.throws(() => parseIpcRequest("not json", token));
 
 validateReaction("testing");
diff --git a/apps/desktop/contracts/plugin-manifest.contract.ts b/apps/desktop/contracts/plugin-manifest.contract.ts
index 9328fc43..50c92be3 100644
--- a/apps/desktop/contracts/plugin-manifest.contract.ts
+++ b/apps/desktop/contracts/plugin-manifest.contract.ts
@@ -1,6 +1,6 @@
 import { openPetsPluginManifestFilename, validatePluginManifest } from "../src/plugin-manifest.js";
 
-assertEqual(openPetsPluginManifestFilename, "openpets.plugin.json");
+assertEqual(openPetsPluginManifestFilename, "familiaros.plugin.json");
 
 const validManifest = {
   manifestVersion: 1,
@@ -8,7 +8,7 @@ const validManifest = {
   name: "Stretch Timer",
   version: "1.0.0",
   runtime: "declarative",
-  permissions: ["timer", "pet:speak", "pet:reaction"],
+  permissions: ["timer", "familiar:speak", "familiar:reaction"],
   configSchema: {
     intervalMinutes: { type: "number", label: "Interval", default: 15 },
     message: { type: "text", label: "Message", default: "Time to stretch!" },
@@ -24,8 +24,8 @@ const validManifest = {
       on: "timer",
       everyMinutes: { config: "intervalMinutes" },
       actions: [
-        { type: "pet.speak", message: "Time to stretch!" },
-        { type: "pet.react", reaction: "celebrating" },
+        { type: "familiar.speak", message: "Time to stretch!" },
+        { type: "familiar.react", reaction: "celebrating" },
       ],
     },
   ],
@@ -34,18 +34,18 @@ const validManifest = {
 assertValid(validManifest);
 assertValid({ ...validManifest, icon: "bell" });
 assertInvalid({ ...validManifest, icon: "https://example.com/icon.svg" }, "invalid_icon");
-assertValid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "javascript", icon: "github", sdkVersion: "1.0.0", entry: "dist/index.js", permissions: ["pet:speak", "network"], network: { hosts: ["api.example.com"] } });
-assertInvalid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "javascript", icon: "<svg>", sdkVersion: "1.0.0", entry: "dist/index.js", permissions: ["pet:speak"] }, "invalid_icon");
-assertInvalid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "declarative", sdkVersion: "1.0.0", entry: "dist/index.js", permissions: ["pet:speak"] }, "invalid_runtime");
-assertInvalid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "../index.js", permissions: ["pet:speak"] }, "invalid_entry");
+assertValid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "javascript", icon: "github", sdkVersion: "1.0.0", entry: "dist/index.js", permissions: ["familiar:speak", "network"], network: { hosts: ["api.example.com"] } });
+assertInvalid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "javascript", icon: "<svg>", sdkVersion: "1.0.0", entry: "dist/index.js", permissions: ["familiar:speak"] }, "invalid_icon");
+assertInvalid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "declarative", sdkVersion: "1.0.0", entry: "dist/index.js", permissions: ["familiar:speak"] }, "invalid_runtime");
+assertInvalid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "../index.js", permissions: ["familiar:speak"] }, "invalid_entry");
 assertInvalid({ manifestVersion: 2, id: "js-plugin", name: "JS Plugin", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["network"], network: { hosts: ["*.example.com"] } }, "invalid_network_host");
-assertValid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.speak", message: { config: "message" } }, { type: "pet.react", reaction: { config: "mood" } }] }] });
-assertInvalid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.speak", message: { config: "message", extra: true } }] }] }, "invalid_config_reference");
-assertInvalid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.speak", message: { config: "missing" } }] }] }, "invalid_config_reference");
-assertInvalid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.speak", message: { config: "mood" } }] }] }, "invalid_config_reference");
-assertInvalid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.react", reaction: { config: "message" } }] }] }, "invalid_config_reference");
-assertInvalid({ ...validManifest, configSchema: { mood: { type: "select", default: "celebrate", options: [{ label: "Celebrate", value: "celebrate" }] } }, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.react", reaction: { config: "mood" } }] }] }, "invalid_reaction_config_reference");
-assertInvalid({ ...validManifest, configSchema: { mood: { type: "select", options: [{ label: "Celebrate", value: "celebrating" }] } }, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.react", reaction: { config: "mood" } }] }] }, "invalid_reaction_config_reference");
+assertValid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.speak", message: { config: "message" } }, { type: "familiar.react", reaction: { config: "mood" } }] }] });
+assertInvalid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.speak", message: { config: "message", extra: true } }] }] }, "invalid_config_reference");
+assertInvalid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.speak", message: { config: "missing" } }] }] }, "invalid_config_reference");
+assertInvalid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.speak", message: { config: "mood" } }] }] }, "invalid_config_reference");
+assertInvalid({ ...validManifest, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.react", reaction: { config: "message" } }] }] }, "invalid_config_reference");
+assertInvalid({ ...validManifest, configSchema: { mood: { type: "select", default: "celebrate", options: [{ label: "Celebrate", value: "celebrate" }] } }, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.react", reaction: { config: "mood" } }] }] }, "invalid_reaction_config_reference");
+assertInvalid({ ...validManifest, configSchema: { mood: { type: "select", options: [{ label: "Celebrate", value: "celebrating" }] } }, triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.react", reaction: { config: "mood" } }] }] }, "invalid_reaction_config_reference");
 assertInvalid({ ...validManifest, extra: true }, "unknown_field");
 assertInvalid(
   {
@@ -64,7 +64,7 @@ assertInvalid(
 assertInvalid(
   {
     ...validManifest,
-    triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.speak", message: "Hi", unsafe: true }] }],
+    triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.speak", message: "Hi", unsafe: true }] }],
   },
   "unknown_field",
 );
@@ -77,7 +77,7 @@ assertInvalid(
 );
 assertInvalid({ ...validManifest, runtime: "javascript" }, "unsupported_runtime");
 assertInvalid({ ...validManifest, permissions: ["timer", "network"] }, "invalid_permission");
-assertInvalid({ ...validManifest, permissions: ["timer", "pet:speak", "timer", "pet:reaction"] }, "duplicate_permission");
+assertInvalid({ ...validManifest, permissions: ["timer", "familiar:speak", "timer", "familiar:reaction"] }, "duplicate_permission");
 assertInvalid(
   {
     ...validManifest,
@@ -96,7 +96,7 @@ assertInvalid(
 assertInvalid(
   {
     ...validManifest,
-    triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.badge", text: "Busy" }] }],
+    triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.badge", text: "Busy" }] }],
   },
   "invalid_action",
 );
@@ -175,7 +175,7 @@ assertInvalid(
 assertInvalid(
   {
     ...validManifest,
-    permissions: ["pet:speak", "pet:reaction"],
+    permissions: ["familiar:speak", "familiar:reaction"],
   },
   "missing_permission",
 );
@@ -183,7 +183,7 @@ assertInvalid(
 assertInvalid(
   {
     ...validManifest,
-    permissions: ["timer", "pet:reaction"],
+    permissions: ["timer", "familiar:reaction"],
   },
   "missing_permission",
 );
@@ -191,7 +191,7 @@ assertInvalid(
 assertInvalid(
   {
     ...validManifest,
-    permissions: ["timer", "pet:speak"],
+    permissions: ["timer", "familiar:speak"],
   },
   "missing_permission",
 );
diff --git a/apps/desktop/control-center-preload.cjs b/apps/desktop/control-center-preload.cjs
index 711ff045..21e0c7a0 100644
--- a/apps/desktop/control-center-preload.cjs
+++ b/apps/desktop/control-center-preload.cjs
@@ -1,82 +1,82 @@
 const { contextBridge, ipcRenderer } = require("electron");
 
 const api = {
-  getPetsState: () => ipcRenderer.invoke("openpets:get-pets-state"),
-  getDashboardSnapshot: () => ipcRenderer.invoke("openpets:get-dashboard-snapshot"),
-  getSettingsState: () => ipcRenderer.invoke("openpets:get-settings-state"),
-  getOpenApiChatSettings: () => ipcRenderer.invoke("openpets:get-openapi-chat-settings"),
-  getI18n: () => ipcRenderer.invoke("openpets:get-i18n"),
-  updatePreferences: (patch) => ipcRenderer.invoke("openpets:update-preferences", patch),
-  saveOpenApiCredential: (apiKey) => ipcRenderer.invoke("openpets:save-openapi-credential", apiKey),
-  clearOpenApiCredential: () => ipcRenderer.invoke("openpets:clear-openapi-credential"),
-  getReactionAnimationSettings: () => ipcRenderer.invoke("openpets:get-reaction-animation-settings"),
-  getLaunchAtLogin: () => ipcRenderer.invoke("openpets:get-launch-at-login"),
-  setLaunchAtLogin: (enabled) => ipcRenderer.invoke("openpets:set-launch-at-login", enabled),
-  getUpdateStatus: () => ipcRenderer.invoke("openpets:get-update-status"),
-  checkForUpdates: () => ipcRenderer.invoke("openpets:check-for-updates"),
-  openUpdateReleasePage: () => ipcRenderer.invoke("openpets:open-update-release-page"),
-  resetDefaultPetPosition: () => ipcRenderer.invoke("openpets:reset-default-pet-position"),
-  getPluginsSnapshot: () => ipcRenderer.invoke("openpets:plugins-snapshot"),
-  getPluginCatalogSnapshot: (refresh) => ipcRenderer.invoke("openpets:plugins-catalog-snapshot", refresh),
-  setPluginEnabled: (id, enabled) => ipcRenderer.invoke("openpets:plugins-set-enabled", id, enabled),
-  savePluginConfig: (id, config) => ipcRenderer.invoke("openpets:plugins-save-config", id, config),
-  pickPluginConfigSound: (id) => ipcRenderer.invoke("openpets:plugins-pick-config-sound", id),
-  reloadPlugin: (id) => ipcRenderer.invoke("openpets:plugins-reload", id),
-  executePluginCommand: (id, commandId, args) => ipcRenderer.invoke("openpets:plugins-execute-command", id, commandId, args),
-  loadLocalPlugin: () => ipcRenderer.invoke("openpets:plugins-load-local"),
-  installCatalogPlugin: (id) => ipcRenderer.invoke("openpets:plugins-install-catalog", id),
-  updateCatalogPlugin: (id) => ipcRenderer.invoke("openpets:plugins-update-catalog", id),
-  uninstallPlugin: (id) => ipcRenderer.invoke("openpets:plugins-uninstall", id),
-  getPluginInspector: (id) => ipcRenderer.invoke("openpets:plugins-inspector", id),
-  getPluginPlatformSettings: () => ipcRenderer.invoke("openpets:plugin-platform-settings-get"),
-  updatePluginPlatformSettings: (patch) => ipcRenderer.invoke("openpets:plugin-platform-settings-update", patch),
-  setPluginAiApiKey: (key) => ipcRenderer.invoke("openpets:plugin-platform-ai-key-set", key),
-  getPluginAiApiKeyStatus: () => ipcRenderer.invoke("openpets:plugin-platform-ai-key-status"),
-  getCatalog: () => ipcRenderer.invoke("openpets:get-catalog"),
-  getCatalogPage: (page) => ipcRenderer.invoke("openpets:get-catalog-page", page),
-  getCatalogSearch: () => ipcRenderer.invoke("openpets:get-catalog-search"),
-  getCodexPets: () => ipcRenderer.invoke("openpets:get-codex-pets"),
-  setDefaultPet: (petId) => ipcRenderer.invoke("openpets:set-default-pet", petId),
-  installPet: (petId) => ipcRenderer.invoke("openpets:install-pet", petId),
-  installLocalPet: () => ipcRenderer.invoke("openpets:install-local-pet"),
-  importCodexPet: (petId) => ipcRenderer.invoke("openpets:import-codex-pet", petId),
-  openGallery: () => ipcRenderer.invoke("openpets:open-gallery"),
-  removePet: (petId) => ipcRenderer.invoke("openpets:remove-pet", petId),
+  getPetsState: () => ipcRenderer.invoke("familiaros:get-familiars-state"),
+  getDashboardSnapshot: () => ipcRenderer.invoke("familiaros:get-dashboard-snapshot"),
+  getSettingsState: () => ipcRenderer.invoke("familiaros:get-settings-state"),
+  getOpenApiChatSettings: () => ipcRenderer.invoke("familiaros:get-openapi-chat-settings"),
+  getI18n: () => ipcRenderer.invoke("familiaros:get-i18n"),
+  updatePreferences: (patch) => ipcRenderer.invoke("familiaros:update-preferences", patch),
+  saveOpenApiCredential: (apiKey) => ipcRenderer.invoke("familiaros:save-openapi-credential", apiKey),
+  clearOpenApiCredential: () => ipcRenderer.invoke("familiaros:clear-openapi-credential"),
+  getReactionAnimationSettings: () => ipcRenderer.invoke("familiaros:get-reaction-animation-settings"),
+  getLaunchAtLogin: () => ipcRenderer.invoke("familiaros:get-launch-at-login"),
+  setLaunchAtLogin: (enabled) => ipcRenderer.invoke("familiaros:set-launch-at-login", enabled),
+  getUpdateStatus: () => ipcRenderer.invoke("familiaros:get-update-status"),
+  checkForUpdates: () => ipcRenderer.invoke("familiaros:check-for-updates"),
+  openUpdateReleasePage: () => ipcRenderer.invoke("familiaros:open-update-release-page"),
+  resetDefaultPetPosition: () => ipcRenderer.invoke("familiaros:reset-default-familiar-position"),
+  getPluginsSnapshot: () => ipcRenderer.invoke("familiaros:plugins-snapshot"),
+  getPluginCatalogSnapshot: (refresh) => ipcRenderer.invoke("familiaros:plugins-catalog-snapshot", refresh),
+  setPluginEnabled: (id, enabled) => ipcRenderer.invoke("familiaros:plugins-set-enabled", id, enabled),
+  savePluginConfig: (id, config) => ipcRenderer.invoke("familiaros:plugins-save-config", id, config),
+  pickPluginConfigSound: (id) => ipcRenderer.invoke("familiaros:plugins-pick-config-sound", id),
+  reloadPlugin: (id) => ipcRenderer.invoke("familiaros:plugins-reload", id),
+  executePluginCommand: (id, commandId, args) => ipcRenderer.invoke("familiaros:plugins-execute-command", id, commandId, args),
+  loadLocalPlugin: () => ipcRenderer.invoke("familiaros:plugins-load-local"),
+  installCatalogPlugin: (id) => ipcRenderer.invoke("familiaros:plugins-install-catalog", id),
+  updateCatalogPlugin: (id) => ipcRenderer.invoke("familiaros:plugins-update-catalog", id),
+  uninstallPlugin: (id) => ipcRenderer.invoke("familiaros:plugins-uninstall", id),
+  getPluginInspector: (id) => ipcRenderer.invoke("familiaros:plugins-inspector", id),
+  getPluginPlatformSettings: () => ipcRenderer.invoke("familiaros:plugin-platform-settings-get"),
+  updatePluginPlatformSettings: (patch) => ipcRenderer.invoke("familiaros:plugin-platform-settings-update", patch),
+  setPluginAiApiKey: (key) => ipcRenderer.invoke("familiaros:plugin-platform-ai-key-set", key),
+  getPluginAiApiKeyStatus: () => ipcRenderer.invoke("familiaros:plugin-platform-ai-key-status"),
+  getCatalog: () => ipcRenderer.invoke("familiaros:get-catalog"),
+  getCatalogPage: (page) => ipcRenderer.invoke("familiaros:get-catalog-page", page),
+  getCatalogSearch: () => ipcRenderer.invoke("familiaros:get-catalog-search"),
+  getCodexPets: () => ipcRenderer.invoke("familiaros:get-codex-familiars"),
+  setDefaultPet: (petId) => ipcRenderer.invoke("familiaros:set-default-familiar", petId),
+  installPet: (petId) => ipcRenderer.invoke("familiaros:install-familiar", petId),
+  installLocalPet: () => ipcRenderer.invoke("familiaros:install-local-familiar"),
+  importCodexPet: (petId) => ipcRenderer.invoke("familiaros:import-codex-familiar", petId),
+  openGallery: () => ipcRenderer.invoke("familiaros:open-gallery"),
+  removePet: (petId) => ipcRenderer.invoke("familiaros:remove-familiar", petId),
   onRouteChange: (callback) => {
     const listener = (_event, route) => callback(route);
-    ipcRenderer.on("openpets:control-center-route", listener);
-    return () => ipcRenderer.removeListener("openpets:control-center-route", listener);
+    ipcRenderer.on("familiaros:control-center-route", listener);
+    return () => ipcRenderer.removeListener("familiaros:control-center-route", listener);
   },
   onPluginsRefresh: (callback) => {
     const listener = () => callback();
-    ipcRenderer.on("openpets:plugins-refresh", listener);
-    return () => ipcRenderer.removeListener("openpets:plugins-refresh", listener);
+    ipcRenderer.on("familiaros:plugins-refresh", listener);
+    return () => ipcRenderer.removeListener("familiaros:plugins-refresh", listener);
   },
-  getIntegrationsState: (selectedPetId, commandMode) => ipcRenderer.invoke("openpets:agent-setup-snapshot", selectedPetId, commandMode),
-  runIntegrationAction: (action, selectedPetId, commandMode) => ipcRenderer.invoke("openpets:agent-setup-action", action, selectedPetId, commandMode),
-  updateIntegrationCommandPaths: (patch) => ipcRenderer.invoke("openpets:agent-setup-command-paths", patch),
-  getOpenPetsMcpServerPreview: (selectedPetId, commandMode) => ipcRenderer.invoke("openpets:openpets-mcp-server-preview", selectedPetId, commandMode),
-  testOpenPetsMcpServer: (selectedPetId, commandMode) => ipcRenderer.invoke("openpets:test-openpets-mcp-server", selectedPetId, commandMode),
-  getTtsSettings: () => ipcRenderer.invoke("openpets:get-tts-settings"),
-  getTtsVoices: (provider) => ipcRenderer.invoke("openpets:get-tts-voices", provider),
-  saveTtsCredential: (provider, credential) => ipcRenderer.invoke("openpets:save-tts-credential", provider, credential),
-  clearTtsCredential: (provider) => ipcRenderer.invoke("openpets:clear-tts-credential", provider),
-  testTtsSpeak: (text) => ipcRenderer.invoke("openpets:test-tts", text),
-  stopTts: () => ipcRenderer.invoke("openpets:tts-stop"),
-  copyText: (text) => ipcRenderer.invoke("openpets:copy-text", text),
-  openExternalUrl: (url) => ipcRenderer.invoke("openpets:open-external-url", url),
-  installMcpToolkit: (target) => ipcRenderer.invoke("openpets:install-mcp-toolkit", target),
-  getVanillaChatMcpTools: () => ipcRenderer.invoke("openpets:get-vanilla-chat-mcp-tools"),
-  setVanillaChatMcpTools: (toolIds) => ipcRenderer.invoke("openpets:set-vanilla-chat-mcp-tools", toolIds),
-  getMemories: (query, limit) => ipcRenderer.invoke("openpets:get-memories", query, limit),
-  storeMemory: (text, kind, tags, importance) => ipcRenderer.invoke("openpets:store-memory", text, kind, tags, importance),
-  updateMemory: (id, text, kind, tags, importance) => ipcRenderer.invoke("openpets:update-memory", id, text, kind, tags, importance),
-  deleteMemory: (id) => ipcRenderer.invoke("openpets:delete-memory", id),
-  knowledgeList: (limit) => ipcRenderer.invoke("openpets:knowledge-list", limit),
-  knowledgeSearch: (query, limit) => ipcRenderer.invoke("openpets:knowledge-search", query, limit),
-  knowledgeDeleteFile: (id) => ipcRenderer.invoke("openpets:knowledge-delete-file", id),
-  knowledgeAddMemory: (text, kind, tags, importance) => ipcRenderer.invoke("openpets:knowledge-add-memory", text, kind, tags, importance),
-  knowledgeStoreFile: () => ipcRenderer.invoke("openpets:knowledge-store-file"),
+  getIntegrationsState: (selectedPetId, commandMode) => ipcRenderer.invoke("familiaros:agent-setup-snapshot", selectedPetId, commandMode),
+  runIntegrationAction: (action, selectedPetId, commandMode) => ipcRenderer.invoke("familiaros:agent-setup-action", action, selectedPetId, commandMode),
+  updateIntegrationCommandPaths: (patch) => ipcRenderer.invoke("familiaros:agent-setup-command-paths", patch),
+  getFamiliarOSMcpServerPreview: (selectedPetId, commandMode) => ipcRenderer.invoke("familiaros:familiaros-mcp-server-preview", selectedPetId, commandMode),
+  testFamiliarOSMcpServer: (selectedPetId, commandMode) => ipcRenderer.invoke("familiaros:test-familiaros-mcp-server", selectedPetId, commandMode),
+  getTtsSettings: () => ipcRenderer.invoke("familiaros:get-tts-settings"),
+  getTtsVoices: (provider) => ipcRenderer.invoke("familiaros:get-tts-voices", provider),
+  saveTtsCredential: (provider, credential) => ipcRenderer.invoke("familiaros:save-tts-credential", provider, credential),
+  clearTtsCredential: (provider) => ipcRenderer.invoke("familiaros:clear-tts-credential", provider),
+  testTtsSpeak: (text) => ipcRenderer.invoke("familiaros:test-tts", text),
+  stopTts: () => ipcRenderer.invoke("familiaros:tts-stop"),
+  copyText: (text) => ipcRenderer.invoke("familiaros:copy-text", text),
+  openExternalUrl: (url) => ipcRenderer.invoke("familiaros:open-external-url", url),
+  installMcpToolkit: (target) => ipcRenderer.invoke("familiaros:install-mcp-toolkit", target),
+  getVanillaChatMcpTools: () => ipcRenderer.invoke("familiaros:get-vanilla-chat-mcp-tools"),
+  setVanillaChatMcpTools: (toolIds) => ipcRenderer.invoke("familiaros:set-vanilla-chat-mcp-tools", toolIds),
+  getMemories: (query, limit) => ipcRenderer.invoke("familiaros:get-memories", query, limit),
+  storeMemory: (text, kind, tags, importance) => ipcRenderer.invoke("familiaros:store-memory", text, kind, tags, importance),
+  updateMemory: (id, text, kind, tags, importance) => ipcRenderer.invoke("familiaros:update-memory", id, text, kind, tags, importance),
+  deleteMemory: (id) => ipcRenderer.invoke("familiaros:delete-memory", id),
+  knowledgeList: (limit) => ipcRenderer.invoke("familiaros:knowledge-list", limit),
+  knowledgeSearch: (query, limit) => ipcRenderer.invoke("familiaros:knowledge-search", query, limit),
+  knowledgeDeleteFile: (id) => ipcRenderer.invoke("familiaros:knowledge-delete-file", id),
+  knowledgeAddMemory: (text, kind, tags, importance) => ipcRenderer.invoke("familiaros:knowledge-add-memory", text, kind, tags, importance),
+  knowledgeStoreFile: () => ipcRenderer.invoke("familiaros:knowledge-store-file"),
 };
 
 contextBridge.exposeInMainWorld("openPetsControlCenter", api);
diff --git a/apps/desktop/electron-builder.yml b/apps/desktop/electron-builder.yml
index 4cc37d81..0b8cc2e0 100644
--- a/apps/desktop/electron-builder.yml
+++ b/apps/desktop/electron-builder.yml
@@ -1,17 +1,17 @@
-appId: dev.openpets.app
-productName: OpenPets
-executableName: openpets
-copyright: Copyright © 2026 OpenPets
+appId: dev.familiaros.app
+productName: FamiliarOS
+executableName: familiaros
+copyright: Copyright © 2026 FamiliarOS
 
 directories:
   output: dist-electron
 
-artifactName: OpenPets-${version}-${os}-${arch}.${ext}
+artifactName: FamiliarOS-${version}-${os}-${arch}.${ext}
 
 files:
   - dist/**
   - control-center-preload.cjs
-  - pet-preload.cjs
+  - familiar-preload.cjs
   - prompt-window-preload.cjs
   - plugin-sdk-preload.cjs
   - plugin-command-form-preload.cjs
@@ -27,7 +27,7 @@ asar: true
 asarUnpack:
   - node_modules/**
   - control-center-preload.cjs
-  - pet-preload.cjs
+  - familiar-preload.cjs
   - prompt-window-preload.cjs
   - plugin-sdk-preload.cjs
   - plugin-command-form-preload.cjs
@@ -59,13 +59,13 @@ win:
   verifyUpdateCodeSignature: false
 
 nsis:
-  artifactName: OpenPets-${version}-win-${arch}-setup.${ext}
+  artifactName: FamiliarOS-${version}-win-${arch}-setup.${ext}
   oneClick: false
   perMachine: false
   allowToChangeInstallationDirectory: true
 
 portable:
-  artifactName: OpenPets-${version}-win-${arch}-portable.${ext}
+  artifactName: FamiliarOS-${version}-win-${arch}-portable.${ext}
 
 linux:
   icon: assets/app-icon.png
@@ -75,4 +75,4 @@ linux:
     - rpm
     - tar.gz
   category: Utility
-  maintainer: OpenPets
+  maintainer: FamiliarOS
diff --git a/apps/desktop/pet-preload.cjs b/apps/desktop/familiar-preload.cjs
similarity index 85%
rename from apps/desktop/pet-preload.cjs
rename to apps/desktop/familiar-preload.cjs
index 720ba204..823d9098 100644
--- a/apps/desktop/pet-preload.cjs
+++ b/apps/desktop/familiar-preload.cjs
@@ -28,23 +28,23 @@ const dismissBubble = (event) => {
   bubble.remove();
 
   const newTarget = document.elementFromPoint(event.clientX, event.clientY);
-  const stillInteractive = Boolean(newTarget && newTarget.closest(".pet-hitbox, .pet-shell, .bubble")) || dragging || scaling;
+  const stillInteractive = Boolean(newTarget && newTarget.closest(".familiar-hitbox, .familiar-shell, .bubble")) || dragging || scaling;
   reportInteractiveHit(stillInteractive, "bubble-dismiss", true);
 
-  ipcRenderer.send("openpets:bubble-dismissed", dismissToken);
+  ipcRenderer.send("familiaros:bubble-dismissed", dismissToken);
 };
 
 const requestPromptWindow = (event) => {
   const target = event.target;
   if (!(target instanceof Element)) return;
   if (target.closest(".bubble")) return;
-  if (!target.closest(".pet-hitbox, .pet-shell")) return;
+  if (!target.closest(".familiar-hitbox, .familiar-shell")) return;
   event.preventDefault();
   event.stopPropagation();
-  ipcRenderer.send("openpets:pet-open-prompt");
+  ipcRenderer.send("familiaros:familiar-open-prompt");
 };
 
-ipcRenderer.on("openpets:pet-motion", (_event, state) => {
+ipcRenderer.on("familiaros:familiar-motion", (_event, state) => {
   if (!allowedMotionStates.has(state)) {
     return;
   }
@@ -60,7 +60,7 @@ ipcRenderer.on("openpets:pet-motion", (_event, state) => {
   }
 });
 
-ipcRenderer.on("openpets:pet-reaction-state", (_event, state) => {
+ipcRenderer.on("familiaros:familiar-reaction-state", (_event, state) => {
   if (!allowedReactionStates.has(state)) {
     return;
   }
@@ -76,7 +76,7 @@ ipcRenderer.on("openpets:pet-reaction-state", (_event, state) => {
   }
 });
 
-ipcRenderer.on("openpets:pet-content-state", (_event, state) => {
+ipcRenderer.on("familiaros:familiar-content-state", (_event, state) => {
   if (!state || typeof state.bodyHtml !== "string" || state.bodyHtml.length > 64 * 1024 || !allowedReactionStates.has(state.reactionState)) {
     return;
   }
@@ -95,13 +95,13 @@ ipcRenderer.on("openpets:pet-content-state", (_event, state) => {
 
 const getInteractiveTarget = (event) => {
   const target = document.elementFromPoint(event.clientX, event.clientY);
-  return target && target.closest(".pet-hitbox, .pet-shell, .bubble");
+  return target && target.closest(".familiar-hitbox, .familiar-shell, .bubble");
 };
 
 const reportInteractiveHit = (interactive, source, force = false) => {
   if (!force && lastInteractiveHit === interactive) return;
   lastInteractiveHit = interactive;
-  ipcRenderer.send("openpets:pet-hit-test", interactive, source);
+  ipcRenderer.send("familiaros:familiar-hit-test", interactive, source);
 };
 
 const setInteractiveHit = (interactive, source = "mouse") => {
@@ -129,15 +129,15 @@ const applyScalePreview = (scale) => {
 };
 
 const sendScalePreview = (scale) => {
-  ipcRenderer.send("openpets:pet-scale-preview", { scale });
+  ipcRenderer.send("familiaros:familiar-scale-preview", { scale });
 };
 
-ipcRenderer.on("openpets:pet-probe-hit-test", (_event, point) => {
+ipcRenderer.on("familiaros:familiar-probe-hit-test", (_event, point) => {
   if (!point || typeof point.clientX !== "number" || typeof point.clientY !== "number" || !Number.isFinite(point.clientX) || !Number.isFinite(point.clientY)) return;
   const clientX = point.clientX;
   const clientY = point.clientY;
   const target = document.elementFromPoint(clientX, clientY);
-  reportInteractiveHit(Boolean(target && target.closest(".pet-hitbox, .pet-shell, .bubble")) || dragging || scaling, typeof point.reason === "string" ? point.reason.slice(0, 80) : "probe", true);
+  reportInteractiveHit(Boolean(target && target.closest(".familiar-hitbox, .familiar-shell, .bubble")) || dragging || scaling, typeof point.reason === "string" ? point.reason.slice(0, 80) : "probe", true);
 });
 
 // --- Plugin bubble interactions (actions, inline inputs) -------------------
@@ -159,7 +159,7 @@ const handleBubbleInteraction = (event) => {
   if (actionButton) {
     event.preventDefault();
     event.stopPropagation();
-    ipcRenderer.send("openpets:bubble-action", actionButton.dataset.bubbleToken, actionButton.dataset.bubbleAction);
+    ipcRenderer.send("familiaros:bubble-action", actionButton.dataset.bubbleToken, actionButton.dataset.bubbleAction);
     return true;
   }
   const submitButton = target.closest("[data-bubble-submit]");
@@ -167,20 +167,20 @@ const handleBubbleInteraction = (event) => {
     event.preventDefault();
     event.stopPropagation();
     const bubble = submitButton.closest(".bubble");
-    ipcRenderer.send("openpets:bubble-submit", submitButton.dataset.bubbleSubmit, bubble ? collectBubbleInputValues(bubble) : {});
+    ipcRenderer.send("familiaros:bubble-submit", submitButton.dataset.bubbleSubmit, bubble ? collectBubbleInputValues(bubble) : {});
     return true;
   }
   if (target.closest(".bubble-input-control")) return true;
   return false;
 };
 
-// --- Pet senses: clicks, hover, drops ---------------------------------------
+// --- Familiar senses: clicks, hover, drops ---------------------------------------
 
 let lastHoverSentAt = 0;
 let suppressClickUntil = 0;
 
 const sendPetEvent = (name, payload) => {
-  ipcRenderer.send("openpets:pet-event", name, payload || {});
+  ipcRenderer.send("familiaros:familiar-event", name, payload || {});
 };
 
 const installPetSenses = () => {
@@ -198,9 +198,9 @@ const installPetSenses = () => {
   const flushClicks = () => {
     resetClickTimer();
     if (clickCount === 1) {
-      sendPetEvent("pet:clicked", {});
+      sendPetEvent("familiar:clicked", {});
     } else if (clickCount === 2 && firstClickEvent) {
-      sendPetEvent("pet:doubleClicked", {});
+      sendPetEvent("familiar:doubleClicked", {});
       requestPromptWindow(firstClickEvent);
     }
     clickCount = 0;
@@ -211,7 +211,7 @@ const installPetSenses = () => {
     if (event.button !== 0) return;
     const target = event.target;
     if (!(target instanceof Element)) return;
-    if (!target.closest(".pet-hitbox, .pet-shell")) return;
+    if (!target.closest(".familiar-hitbox, .familiar-shell")) return;
     if (Date.now() < suppressClickUntil) return;
 
     clickCount += 1;
@@ -225,22 +225,22 @@ const installPetSenses = () => {
 
   document.addEventListener("mouseover", (event) => {
     const target = event.target;
-    if (!(target instanceof Element) || !target.closest(".pet-hitbox, .pet-shell")) return;
+    if (!(target instanceof Element) || !target.closest(".familiar-hitbox, .familiar-shell")) return;
     const now = Date.now();
     if (now - lastHoverSentAt < 2000) return;
     lastHoverSentAt = now;
-    sendPetEvent("pet:hover", {});
+    sendPetEvent("familiar:hover", {});
   }, { passive: true });
 
   const maxDropTextBytes = 256 * 1024;
   const maxDropFileBytes = 5 * 1024 * 1024;
   document.addEventListener("dragover", (event) => {
     const target = event.target;
-    if (target instanceof Element && target.closest(".pet-hitbox, .pet-shell")) event.preventDefault();
+    if (target instanceof Element && target.closest(".familiar-hitbox, .familiar-shell")) event.preventDefault();
   });
   document.addEventListener("drop", (event) => {
     const target = event.target;
-    if (!(target instanceof Element) || !target.closest(".pet-hitbox, .pet-shell")) return;
+    if (!(target instanceof Element) || !target.closest(".familiar-hitbox, .familiar-shell")) return;
     event.preventDefault();
     const transfer = event.dataTransfer;
     if (!transfer) return;
@@ -251,19 +251,19 @@ const installPetSenses = () => {
         sizeBytes: file.size,
         text: file.size <= maxDropFileBytes ? await file.text().catch(() => "") : "",
         truncated: file.size > maxDropFileBytes,
-      }))).then((read) => sendPetEvent("pet:drop", { kind: "files", droppedFiles: read })).catch(() => undefined);
+      }))).then((read) => sendPetEvent("familiar:drop", { kind: "files", droppedFiles: read })).catch(() => undefined);
       return;
     }
     const text = String(transfer.getData("text/plain") || "").slice(0, maxDropTextBytes);
-    if (text) sendPetEvent("pet:drop", { kind: "text", text });
+    if (text) sendPetEvent("familiar:drop", { kind: "text", text });
   });
 };
 
 // --- Plugin sprite/scale overrides ------------------------------------------
 
 let spriteOverrideElement = null;
-ipcRenderer.on("openpets:pet-sprite-override", (_event, override) => {
-  const shell = document.querySelector(".pet-shell");
+ipcRenderer.on("familiaros:familiar-sprite-override", (_event, override) => {
+  const shell = document.querySelector(".familiar-shell");
   if (!shell) return;
   const base = shell.querySelector(".sprite, .installed-card");
   if (spriteOverrideElement) { spriteOverrideElement.remove(); spriteOverrideElement = null; }
@@ -293,14 +293,14 @@ ipcRenderer.on("openpets:pet-sprite-override", (_event, override) => {
   probe.src = override.fileUrl;
 });
 
-ipcRenderer.on("openpets:pet-scale-override", (_event, scale) => {
+ipcRenderer.on("familiaros:familiar-scale-override", (_event, scale) => {
   const value = Number(scale);
   if (!Number.isFinite(value) || value < 0.25 || value > 3) return;
   const sprite = document.querySelector(".sprite, .installed-sprite");
   if (sprite) sprite.style.transform = `scale(${value})`;
 });
 
-ipcRenderer.on("openpets:pet-bubble-layout", (_event, layout) => {
+ipcRenderer.on("familiaros:familiar-bubble-layout", (_event, layout) => {
   if (!layout || typeof layout !== "object") return;
   const root = document.documentElement;
   if (typeof layout.bubbleMaxHeight === "number") root.style.setProperty("--bubble-max-height", `${layout.bubbleMaxHeight}px`);
@@ -320,7 +320,7 @@ let activeAudioElements = [];
 const audioLog = (level, message, fields) => {
   try {
     const safeFields = fields && Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
-    const line = `[openpets:pet-audio] ${message}`;
+    const line = `[familiaros:familiar-audio] ${message}`;
     if (level === "warn") console.warn(line, safeFields || {});
     else console.debug(line, safeFields || {});
   } catch { /* diagnostics must never affect playback */ }
@@ -342,7 +342,7 @@ const namedSoundRecipes = {
   error: [{ freq: 311.13, type: "sine", start: 0, duration: 0.18 }, { freq: 233.08, type: "sine", start: 0.2, duration: 0.28 }],
 };
 
-ipcRenderer.on("openpets:play-audio", (_event, payload) => {
+ipcRenderer.on("familiaros:play-audio", (_event, payload) => {
   try {
     if (!payload) return;
     const volume = Math.min(1, Math.max(0, Number(payload.volume) || 0.6));
@@ -385,7 +385,7 @@ ipcRenderer.on("openpets:play-audio", (_event, payload) => {
   } catch (error) { audioLog("warn", "play request threw", { reason: error && error.message ? error.message : String(error) }); }
 });
 
-ipcRenderer.on("openpets:stop-audio", () => {
+ipcRenderer.on("familiaros:stop-audio", () => {
   audioLog("debug", "stop requested", { nodes: activeAudioNodes.length, elements: activeAudioElements.length });
   for (const node of activeAudioNodes) { try { node.stop(); } catch { /* already stopped */ } }
   activeAudioNodes = [];
@@ -397,7 +397,7 @@ ipcRenderer.on("openpets:stop-audio", () => {
 
 let currentTtsAudio = null;
 
-ipcRenderer.on("openpets:tts-speak", (_event, payload) => {
+ipcRenderer.on("familiaros:tts-speak", (_event, payload) => {
   try {
     stopCurrentTtsAudio();
     if (!payload || typeof payload.text !== "string" || !window.speechSynthesis) return;
@@ -411,7 +411,7 @@ ipcRenderer.on("openpets:tts-speak", (_event, payload) => {
   } catch { /* tts is best-effort */ }
 });
 
-ipcRenderer.on("openpets:tts-audio", (_event, payload) => {
+ipcRenderer.on("familiaros:tts-audio", (_event, payload) => {
   try {
     stopCurrentTtsAudio();
     if (!payload || !payload.audio || !payload.mimeType) return;
@@ -427,7 +427,7 @@ ipcRenderer.on("openpets:tts-audio", (_event, payload) => {
   } catch { /* tts is best-effort */ }
 });
 
-ipcRenderer.on("openpets:tts-stop", () => {
+ipcRenderer.on("familiaros:tts-stop", () => {
   try {
     stopCurrentTtsAudio();
     if (window.speechSynthesis) window.speechSynthesis.cancel();
@@ -459,7 +459,7 @@ const installMouseInterop = () => {
   document.addEventListener("mousemove", (event) => {
     updateInteractiveHit(event);
     if (dragging) {
-      ipcRenderer.send("openpets:pet-drag-move", { screenX: event.screenX, screenY: event.screenY });
+      ipcRenderer.send("familiaros:familiar-drag-move", { screenX: event.screenX, screenY: event.screenY });
     } else if (dragCandidate) {
       const dx = event.screenX - dragCandidate.screenX;
       const dy = event.screenY - dragCandidate.screenY;
@@ -468,7 +468,7 @@ const installMouseInterop = () => {
         dragStartPoint = { screenX: dragCandidate.screenX, screenY: dragCandidate.screenY };
         dragCandidate = null;
         setInteractiveHit(true);
-        ipcRenderer.send("openpets:pet-drag-start", { screenX: event.screenX, screenY: event.screenY });
+        ipcRenderer.send("familiaros:familiar-drag-start", { screenX: event.screenX, screenY: event.screenY });
       }
     }
     if (scaling) {
@@ -490,11 +490,11 @@ const installMouseInterop = () => {
       scaleStartY = event.screenY;
       scaleStartValue = getCurrentSpriteScale();
       setInteractiveHit(true);
-      ipcRenderer.send("openpets:pet-scale-start");
+      ipcRenderer.send("familiaros:familiar-scale-start");
       return;
     }
 
-    if (event.button !== 0 || !target?.closest(".pet-hitbox, .pet-shell")) return;
+    if (event.button !== 0 || !target?.closest(".familiar-hitbox, .familiar-shell")) return;
     event.preventDefault();
     dragCandidate = { screenX: event.screenX, screenY: event.screenY };
     dragStartPoint = null;
@@ -508,7 +508,7 @@ const installMouseInterop = () => {
       }
       dragStartPoint = null;
       dragCandidate = null;
-      ipcRenderer.send("openpets:pet-drag-end");
+      ipcRenderer.send("familiaros:familiar-drag-end");
     } else if (dragCandidate) {
       dragCandidate = null;
     }
@@ -516,7 +516,7 @@ const installMouseInterop = () => {
       scaling = false;
       const sprite = document.querySelector(".sprite, .installed-sprite");
       const finalScale = sprite ? getCurrentSpriteScale() : scaleStartValue;
-      ipcRenderer.send("openpets:pet-scale-end", { scale: finalScale });
+      ipcRenderer.send("familiaros:familiar-scale-end", { scale: finalScale });
     }
   });
 
@@ -532,7 +532,7 @@ const installMouseInterop = () => {
       scaleNudgeCommitTimer = null;
     }
     const finalScale = getCurrentSpriteScale();
-    ipcRenderer.send("openpets:pet-scale-end", { scale: finalScale });
+    ipcRenderer.send("familiaros:familiar-scale-end", { scale: finalScale });
   };
 
   window.addEventListener("keydown", (event) => {
@@ -544,13 +544,13 @@ const installMouseInterop = () => {
     const current = getCurrentSpriteScale();
     const delta = event.key === "ArrowUp" || event.key === "ArrowRight" ? scaleNudgeStep : -scaleNudgeStep;
     const next = applyScalePreview(current + delta);
-    ipcRenderer.send("openpets:pet-scale-preview", { scale: next });
+    ipcRenderer.send("familiaros:familiar-scale-preview", { scale: next });
     if (scaleNudgeCommitTimer) clearTimeout(scaleNudgeCommitTimer);
     scaleNudgeCommitTimer = setTimeout(commitScaleNudge, 250);
   });
 
   setInteractiveHit(false, "ready");
-  ipcRenderer.send("openpets:pet-ready");
+  ipcRenderer.send("familiaros:familiar-ready");
 };
 
 if (document.readyState === "loading") {
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
index 548d2136..827db89e 100644
--- a/apps/desktop/package.json
+++ b/apps/desktop/package.json
@@ -1,23 +1,23 @@
 {
-  "name": "@open-pets/desktop",
+  "name": "@familiaros/desktop",
   "version": "3.1.0",
   "private": true,
-  "description": "OpenPets tray-first desktop companion app.",
+  "description": "FamiliarOS tray-first desktop companion app.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "apps/desktop"
   },
-  "author": "OpenPets",
+  "author": "FamiliarOS",
   "type": "module",
   "main": "dist/main.js",
   "scripts": {
     "dev": "pnpm build && electron .",
     "dev:electron": "pnpm build:main && electron .",
-    "dev:control-center": "concurrently -k -n renderer,electron -c cyan,magenta \"pnpm dev:renderer\" \"wait-on http://127.0.0.1:5173 && cross-env OPENPETS_RENDERER_URL=http://127.0.0.1:5173 pnpm dev:electron\"",
-    "dev:plugins": "cross-env OPENPETS_DISABLE_PLUGIN_CATALOG=1 OPENPETS_DEV_PLUGIN_ROOTS=../../plugins/official pnpm dev",
-    "dev:debug": "OPENPETS_LOG_LEVEL=debug OPENPETS_LOG_CONSOLE=1 pnpm dev",
+    "dev:control-center": "concurrently -k -n renderer,electron -c cyan,magenta \"pnpm dev:renderer\" \"wait-on http://127.0.0.1:5173 && cross-env FAMILIAROS_RENDERER_URL=http://127.0.0.1:5173 pnpm dev:electron\"",
+    "dev:plugins": "cross-env FAMILIAROS_DISABLE_PLUGIN_CATALOG=1 FAMILIAROS_DEV_PLUGIN_ROOTS=../../plugins/official pnpm dev",
+    "dev:debug": "FAMILIAROS_LOG_LEVEL=debug FAMILIAROS_LOG_CONSOLE=1 pnpm dev",
     "package": "pnpm build && node scripts/clean-package-output.cjs && electron-builder",
     "package:dir": "pnpm build && node scripts/clean-package-output.cjs && electron-builder --dir && node dist/check-packaging-contract.js --output",
     "test": "node scripts/run-tests.mjs",
@@ -31,7 +31,7 @@
     "build": "pnpm build:main && pnpm build:renderer"
   },
   "devDependencies": {
-    "@open-pets/plugin-sdk": "workspace:*",
+    "@familiaros/plugin-sdk": "workspace:*",
     "@types/node": "^25.6.2",
     "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
@@ -50,12 +50,12 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@open-pets/agent-events": "workspace:*",
-    "@open-pets/claude": "workspace:*",
-    "@open-pets/cli": "workspace:*",
-    "@open-pets/cursor": "workspace:*",
-    "@open-pets/mcp": "workspace:*",
-    "@open-pets/opencode": "workspace:*",
+    "@familiaros/agent-events": "workspace:*",
+    "@familiaros/claude": "workspace:*",
+    "@familiaros/cli": "workspace:*",
+    "@familiaros/cursor": "workspace:*",
+    "@familiaros/mcp": "workspace:*",
+    "@familiaros/opencode": "workspace:*",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "sharp": "^0.34.5",
diff --git a/apps/desktop/panel-preload.cjs b/apps/desktop/panel-preload.cjs
index 8666d1d3..19c810bc 100644
--- a/apps/desktop/panel-preload.cjs
+++ b/apps/desktop/panel-preload.cjs
@@ -1,7 +1,7 @@
 const { contextBridge, ipcRenderer } = require("electron");
 
-const tokenArg = process.argv.find((arg) => arg.startsWith("--openpets-panel-token="));
-const channel = tokenArg ? `openpets:plugin-panel:${tokenArg.slice("--openpets-panel-token=".length)}` : "";
+const tokenArg = process.argv.find((arg) => arg.startsWith("--familiaros-panel-token="));
+const channel = tokenArg ? `familiaros:plugin-panel:${tokenArg.slice("--familiaros-panel-token=".length)}` : "";
 const handlers = new Set();
 
 ipcRenderer.on(`${channel}:message`, (_event, msg) => {
diff --git a/apps/desktop/plugin-sdk-preload.cjs b/apps/desktop/plugin-sdk-preload.cjs
index 16165652..b6efff8c 100644
--- a/apps/desktop/plugin-sdk-preload.cjs
+++ b/apps/desktop/plugin-sdk-preload.cjs
@@ -4,18 +4,18 @@ const { contextBridge, ipcRenderer } = require("electron");
 // conformance check extracts call()/callSync()/subscription() route literals
 // from this preload and compares them to the canonical route table.
 
-const tokenArg = process.argv.find((arg) => arg.startsWith("--openpets-plugin-token="));
-const channel = tokenArg ? `openpets:plugin-sdk:${tokenArg.slice("--openpets-plugin-token=".length)}` : "";
+const tokenArg = process.argv.find((arg) => arg.startsWith("--familiaros-plugin-token="));
+const channel = tokenArg ? `familiaros:plugin-sdk:${tokenArg.slice("--familiaros-plugin-token=".length)}` : "";
 let callbackId = 0;
 const callbacks = new Map();
 
 async function call(path, args) {
-  if (!channel) throw new Error("OpenPets plugin SDK is unavailable.");
+  if (!channel) throw new Error("FamiliarOS plugin SDK is unavailable.");
   return ipcRenderer.invoke(channel, path, normalizeForIpc(args));
 }
 
 function callSync(path, args) {
-  if (!channel) throw new Error("OpenPets plugin SDK is unavailable.");
+  if (!channel) throw new Error("FamiliarOS plugin SDK is unavailable.");
   const result = ipcRenderer.sendSync(channel, path, normalizeForIpc(args));
   if (result && typeof result === "object" && typeof result.__openPetsError === "string") throw new Error(result.__openPetsError);
   return result;
@@ -97,7 +97,7 @@ function wrapPickedFile(file) {
 }
 
 function wrapEventPayload(event, payload) {
-  if (event !== "pet:drop" || !payload || !Array.isArray(payload.files)) return payload;
+  if (event !== "familiar:drop" || !payload || !Array.isArray(payload.files)) return payload;
   return {
     ...payload,
     files: payload.files.map((file) => ({
@@ -111,35 +111,35 @@ function wrapEventPayload(event, payload) {
 function makePetHandle(petId) {
   return {
     id: String(petId),
-    speak: (spec) => call("pet.speak", [petId, spec]).then(makeBubbleHandle),
-    react: (reaction, options) => call("pet.react", [petId, reaction, options]),
-    setAnimation: (state) => call("pet.setAnimation", [petId, state]),
-    setScale: (scale) => call("pet.setScale", [petId, scale]),
-    setStatusReaction: (reaction) => call("pet.setStatusReaction", [petId, reaction]),
-    moveBy: (options) => call("pet.moveBy", [petId, options]),
-    wander: (options) => call("pet.wander", [petId, options]),
-    moveToHome: () => call("pet.moveToHome", [petId]),
-    moveTo: (point, opts) => call("pet.moveTo", [petId, point, opts]),
-    followCursor: (opts) => call("pet.followCursor", [petId, opts]),
-    physics: (opts) => call("pet.physics", [petId, opts]),
-    onTick: (fn) => subscription("pet.onTick", "pet.offTick", [petId], fn),
-    getState: () => call("pet.getState", [petId]),
-    show: () => call("pet.show", [petId]),
-    hide: () => call("pet.hide", [petId]),
-    close: () => call("pet.close", [petId]),
+    speak: (spec) => call("familiar.speak", [petId, spec]).then(makeBubbleHandle),
+    react: (reaction, options) => call("familiar.react", [petId, reaction, options]),
+    setAnimation: (state) => call("familiar.setAnimation", [petId, state]),
+    setScale: (scale) => call("familiar.setScale", [petId, scale]),
+    setStatusReaction: (reaction) => call("familiar.setStatusReaction", [petId, reaction]),
+    moveBy: (options) => call("familiar.moveBy", [petId, options]),
+    wander: (options) => call("familiar.wander", [petId, options]),
+    moveToHome: () => call("familiar.moveToHome", [petId]),
+    moveTo: (point, opts) => call("familiar.moveTo", [petId, point, opts]),
+    followCursor: (opts) => call("familiar.followCursor", [petId, opts]),
+    physics: (opts) => call("familiar.physics", [petId, opts]),
+    onTick: (fn) => subscription("familiar.onTick", "familiar.offTick", [petId], fn),
+    getState: () => call("familiar.getState", [petId]),
+    show: () => call("familiar.show", [petId]),
+    hide: () => call("familiar.hide", [petId]),
+    close: () => call("familiar.close", [petId]),
   };
 }
 
 const defaultPet = makePetHandle("default");
 
 const sdk = {
-  pet: defaultPet,
-  pets: {
+  familiar: defaultPet,
+  familiars: {
     default: defaultPet,
-    list: () => call("pets.list", []),
+    list: () => call("familiars.list", []),
     get: (petId) => makePetHandle(petId),
-    spawn: (spec) => call("pets.spawn", [spec]).then((result) => makePetHandle(result && result.petHandleId)),
-    onChange: (fn) => subscription("pets.onChange", "pets.offChange", [], fn),
+    spawn: (spec) => call("familiars.spawn", [spec]).then((result) => makePetHandle(result && result.petHandleId)),
+    onChange: (fn) => subscription("familiars.onChange", "familiars.offChange", [], fn),
   },
   ui: {
     bubble: (spec) => call("ui.bubble", [spec]).then(makeBubbleHandle),
diff --git a/apps/desktop/prompt-window-preload.cjs b/apps/desktop/prompt-window-preload.cjs
index a287a3eb..dc141ddf 100644
--- a/apps/desktop/prompt-window-preload.cjs
+++ b/apps/desktop/prompt-window-preload.cjs
@@ -1,17 +1,17 @@
 const { contextBridge, ipcRenderer } = require("electron");
 
 const api = {
-  getState: () => ipcRenderer.invoke("openpets:prompt-window-state"),
-  submitPrompt: (prompt) => ipcRenderer.invoke("openpets:prompt-window-submit", prompt),
-  resetConversation: () => ipcRenderer.invoke("openpets:prompt-window-reset-conversation"),
-  createConversation: () => ipcRenderer.invoke("openpets:prompt-window-create-conversation"),
-  switchConversation: (conversationId) => ipcRenderer.invoke("openpets:prompt-window-switch-conversation", conversationId),
-  deleteConversation: (conversationId) => ipcRenderer.invoke("openpets:prompt-window-delete-conversation", conversationId),
-  openSettings: () => ipcRenderer.invoke("openpets:prompt-window-open-settings"),
-  resizeWindow: (bounds) => ipcRenderer.invoke("openpets:prompt-window-resize", bounds),
-  close: () => ipcRenderer.invoke("openpets:prompt-window-close"),
-  storeKnowledgeFile: (file) => ipcRenderer.invoke("openpets:prompt-window-store-file", file),
-  log: (level, message) => ipcRenderer.send("openpets:prompt-window-log", level, message),
+  getState: () => ipcRenderer.invoke("familiaros:prompt-window-state"),
+  submitPrompt: (prompt) => ipcRenderer.invoke("familiaros:prompt-window-submit", prompt),
+  resetConversation: () => ipcRenderer.invoke("familiaros:prompt-window-reset-conversation"),
+  createConversation: () => ipcRenderer.invoke("familiaros:prompt-window-create-conversation"),
+  switchConversation: (conversationId) => ipcRenderer.invoke("familiaros:prompt-window-switch-conversation", conversationId),
+  deleteConversation: (conversationId) => ipcRenderer.invoke("familiaros:prompt-window-delete-conversation", conversationId),
+  openSettings: () => ipcRenderer.invoke("familiaros:prompt-window-open-settings"),
+  resizeWindow: (bounds) => ipcRenderer.invoke("familiaros:prompt-window-resize", bounds),
+  close: () => ipcRenderer.invoke("familiaros:prompt-window-close"),
+  storeKnowledgeFile: (file) => ipcRenderer.invoke("familiaros:prompt-window-store-file", file),
+  log: (level, message) => ipcRenderer.send("familiaros:prompt-window-log", level, message),
 };
 
 contextBridge.exposeInMainWorld("openPetsPromptWindow", api);
@@ -20,7 +20,7 @@ contextBridge.exposeInMainWorld("openPetsPromptWindow", api);
 
 let currentTtsAudio = null;
 
-ipcRenderer.on("openpets:tts-speak", (_event, payload) => {
+ipcRenderer.on("familiaros:tts-speak", (_event, payload) => {
   try {
     stopCurrentTtsAudio();
     if (!payload || typeof payload.text !== "string" || !window.speechSynthesis) return;
@@ -30,7 +30,7 @@ ipcRenderer.on("openpets:tts-speak", (_event, payload) => {
   } catch { /* tts is best-effort */ }
 });
 
-ipcRenderer.on("openpets:tts-audio", (_event, payload) => {
+ipcRenderer.on("familiaros:tts-audio", (_event, payload) => {
   try {
     stopCurrentTtsAudio();
     if (!payload || !payload.audio || !payload.mimeType) return;
@@ -46,7 +46,7 @@ ipcRenderer.on("openpets:tts-audio", (_event, payload) => {
   } catch { /* tts is best-effort */ }
 });
 
-ipcRenderer.on("openpets:tts-stop", () => {
+ipcRenderer.on("familiaros:tts-stop", () => {
   try {
     stopCurrentTtsAudio();
     if (window.speechSynthesis) window.speechSynthesis.cancel();
diff --git a/apps/desktop/scripts/build-deps.mjs b/apps/desktop/scripts/build-deps.mjs
index eff46175..4cd8c96f 100644
--- a/apps/desktop/scripts/build-deps.mjs
+++ b/apps/desktop/scripts/build-deps.mjs
@@ -11,16 +11,16 @@ import { fileURLToPath } from "node:url";
 const root = join(dirname(fileURLToPath(import.meta.url)), "..");
 
 const filters = [
-  "@open-pets/agent-events",
-  "@open-pets/client",
-  "@open-pets/claude",
-  "@open-pets/cli",
-  "@open-pets/cursor",
-  "@open-pets/mcp",
-  "@open-pets/opencode",
-  "@open-pets/pet-format",
-  "@open-pets/pi",
-  "@open-pets/plugin-sdk",
+  "@familiaros/agent-events",
+  "@familiaros/client",
+  "@familiaros/claude",
+  "@familiaros/cli",
+  "@familiaros/cursor",
+  "@familiaros/mcp",
+  "@familiaros/opencode",
+  "@familiaros/familiar-format",
+  "@familiaros/pi",
+  "@familiaros/plugin-sdk",
 ];
 
 const args = [];
diff --git a/apps/desktop/scripts/codemap.md b/apps/desktop/scripts/codemap.md
index cd097eee..4c39f11f 100644
--- a/apps/desktop/scripts/codemap.md
+++ b/apps/desktop/scripts/codemap.md
@@ -2,7 +2,7 @@
 
 ## Responsibility
 
-Build and release automation scripts for the OpenPets desktop application. Handles packaging cleanup and local release orchestration (macOS-focused).
+Build and release automation scripts for the FamiliarOS desktop application. Handles packaging cleanup and local release orchestration (macOS-focused).
 
 ## Design
 
@@ -37,7 +37,7 @@ Check preload syntax → Compile tests to .test-dist → Run behavior tests →
 
 - **File System**: `apps/desktop/dist-electron/` (build output), `apps/desktop/dist/` (compiled JS)
 - **Git**: Working tree status, remote sync verification, tag existence checks
-- **GitHub**: `gh release create`, `gh release upload` to `alvinunreal/openpets`
+- **GitHub**: `gh release create`, `gh release upload` to `alvinunreal/familiaros`
 - **Build Tools**: `pnpm`, `electron-builder`, `node --check`
 - **Node APIs**: `crypto` (SHA256), `fs`, `path`, `child_process.spawnSync`
 
diff --git a/apps/desktop/scripts/release-local.mjs b/apps/desktop/scripts/release-local.mjs
index 06080b07..eba7914a 100644
--- a/apps/desktop/scripts/release-local.mjs
+++ b/apps/desktop/scripts/release-local.mjs
@@ -9,7 +9,7 @@ const scriptsDir = dirname(fileURLToPath(import.meta.url));
 const desktopDir = resolve(scriptsDir, "..");
 const repoRoot = resolve(desktopDir, "../..");
 const outputDir = join(desktopDir, "dist-electron");
-const repository = "alvinunreal/openpets";
+const repository = "alvinunreal/familiaros";
 
 const allowedArgs = new Set([
   "--dry-run",
@@ -55,7 +55,7 @@ function main() {
   preflight();
   if (!skipChecks) {
     run("pnpm", ["build"], { cwd: repoRoot });
-    run("pnpm", ["--filter", "@open-pets/desktop", "check"], { cwd: repoRoot });
+    run("pnpm", ["--filter", "@familiaros/desktop", "check"], { cwd: repoRoot });
   }
 
   run("node", ["scripts/clean-package-output.cjs"], { cwd: desktopDir });
@@ -85,7 +85,7 @@ function main() {
   }
 
   const target = commandOutput("git", ["rev-parse", "HEAD"], { cwd: repoRoot }).trim();
-  run("gh", ["release", "create", tag, "--repo", repository, "--target", target, "--title", `OpenPets ${tag}`, "--notes", defaultReleaseNotes()], { cwd: repoRoot });
+  run("gh", ["release", "create", tag, "--repo", repository, "--target", target, "--title", `FamiliarOS ${tag}`, "--notes", defaultReleaseNotes()], { cwd: repoRoot });
   run("gh", ["release", "upload", tag, "--repo", repository, ...uploadArtifacts], { cwd: repoRoot });
   console.log(`\nPublished release created: https://github.com/${repository}/releases/tag/${tag}`);
   console.log("Published releases are visible to the app update checker.");
@@ -208,18 +208,18 @@ function run(command, args, options) {
 
 function defaultReleaseNotes() {
   return [
-    `OpenPets ${tag} ships the first official plugin release with polished desktop plugin management.`,
+    `FamiliarOS ${tag} ships the first official plugin release with polished desktop plugin management.`,
     "",
-    "## New: OpenPets Plugins",
+    "## New: FamiliarOS Plugins",
     "",
-    "OpenPets now includes a first-party plugin platform for bundled desktop companion behaviors.",
+    "FamiliarOS now includes a first-party plugin platform for bundled desktop companion behaviors.",
     "",
     "## Included plugins",
     "",
-    "- Ambient Companion — gentle idle check-ins and ambient pet moments, enabled by default.",
+    "- Ambient Companion — gentle idle check-ins and ambient familiar moments, enabled by default.",
     "- Break Buddy — friendly stretch, hydrate, and rest reminders, enabled by default.",
-    "- Pet Pal — playful pet interactions and quick companion actions, enabled by default.",
-    "- Focus Buddy — passive focus-session controls available from the pet menu, enabled by default.",
+    "- Familiar Pal — playful familiar interactions and quick companion actions, enabled by default.",
+    "- Focus Buddy — passive focus-session controls available from the familiar menu, enabled by default.",
     "- GitHub Notifications — developer/advanced public repository release and failed-workflow notifications, disabled by default. No GitHub login, token, or private repository access is used.",
     "",
     "## Plugin management",
@@ -227,7 +227,7 @@ function defaultReleaseNotes() {
     "- New polished Plugins window with install, enable, configure, update, reload, and uninstall actions.",
     "- Friendly plugin configuration UI; no JSON editing required.",
     "- Plugin permissions, network hosts, and official plugin icons are explicit.",
-    "- JavaScript plugins run in a sandboxed renderer with a narrow OpenPets SDK.",
+    "- JavaScript plugins run in a sandboxed renderer with a narrow FamiliarOS SDK.",
     "",
     "## Developer notes",
     "",
diff --git a/apps/desktop/scripts/run-tests.mjs b/apps/desktop/scripts/run-tests.mjs
index 8e421c7a..6b59d04a 100644
--- a/apps/desktop/scripts/run-tests.mjs
+++ b/apps/desktop/scripts/run-tests.mjs
@@ -11,16 +11,16 @@ import { dirname, join } from "node:path";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const rootDir = join(__dirname, "..");
 
-const preloadChecks = ["control-center-preload.cjs", "pet-preload.cjs", "plugin-sdk-preload.cjs", "panel-preload.cjs"];
+const preloadChecks = ["control-center-preload.cjs", "familiar-preload.cjs", "plugin-sdk-preload.cjs", "panel-preload.cjs"];
 const behaviorTests = [
   ".test-dist/tests/lease-manager.test.js",
-  ".test-dist/tests/default-pet-external-show.test.js",
+  ".test-dist/tests/default-familiar-external-show.test.js",
   ".test-dist/tests/onboarding-state.test.js",
   ".test-dist/tests/update-version.test.js",
   ".test-dist/tests/reaction-animation-mapping.test.js",
   ".test-dist/tests/zip-safety.test.js",
   ".test-dist/tests/tts-engine.test.js",
-  ".test-dist/tests/codex-pets.test.js",
+  ".test-dist/tests/codex-familiars.test.js",
   ".test-dist/tests/claude-memory.test.js",
   ".test-dist/tests/prompt-memory-extraction.test.js",
   ".test-dist/tests/knowledge-store.test.js",
@@ -49,7 +49,7 @@ function run(command, args = [], options = {}) {
     const child = spawn(command, args, {
       stdio: "inherit",
       cwd: rootDir,
-      env: { ...process.env, OPENPETS_DESKTOP_ROOT: rootDir },
+      env: { ...process.env, FAMILIAROS_DESKTOP_ROOT: rootDir },
       ...options,
     });
     child.on("close", (code) => {
diff --git a/apps/desktop/src/agent-pet-controller.ts b/apps/desktop/src/agent-familiar-controller.ts
similarity index 73%
rename from apps/desktop/src/agent-pet-controller.ts
rename to apps/desktop/src/agent-familiar-controller.ts
index f3be3617..64161373 100644
--- a/apps/desktop/src/agent-pet-controller.ts
+++ b/apps/desktop/src/agent-familiar-controller.ts
@@ -3,8 +3,8 @@ import { BrowserWindow } from "electron";
 import { getAppStateSnapshot, type PetScaleValue } from "./app-state.js";
 import { defaultPetWindowSize, getDefaultPetInitialPosition } from "./display.js";
 import { debug, info } from "./logger.js";
-import { transientDisplayMs, type OpenPetsReaction } from "./local-ipc-protocol.js";
-import { clearTransientReaction, createAgentPetWindow, getTransientDisplayDurationMs, getTransientReactionAnimationMs, loadExplicitPetContent, mergePetTransientDisplay, setPetReactionState, type PetStatusBadgeReaction, type PetTransientDisplay } from "./pet-window.js";
+import { transientDisplayMs, type FamiliarOSReaction } from "./local-ipc-protocol.js";
+import { clearTransientReaction, createAgentPetWindow, getTransientDisplayDurationMs, getTransientReactionAnimationMs, loadExplicitPetContent, mergePetTransientDisplay, setPetReactionState, type PetStatusBadgeReaction, type PetTransientDisplay } from "./familiar-window.js";
 
 const agentPetWindows = new Map<string, BrowserWindow>();
 const transientDisplays = new Map<string, PetTransientDisplay>();
@@ -18,11 +18,11 @@ const busyStatusBadgeMs = 120_000;
 
 export function showAgentPet(petId: string): boolean {
   if (dismissedAgentPets.has(petId)) {
-    info("pet.agent", "show skipped", { petId, reason: "dismissed", activeWindows: agentPetWindows.size });
+    info("familiar.agent", "show skipped", { petId, reason: "dismissed", activeWindows: agentPetWindows.size });
     return false;
   }
   const window = getOrCreateAgentPetWindow(petId);
-  info("pet.agent", "show requested", { petId, windowId: window.id, visible: window.isVisible(), minimized: window.isMinimized(), activeWindows: agentPetWindows.size });
+  info("familiar.agent", "show requested", { petId, windowId: window.id, visible: window.isVisible(), minimized: window.isMinimized(), activeWindows: agentPetWindows.size });
   if (window.isMinimized()) window.restore();
   window.showInactive();
   return true;
@@ -31,10 +31,10 @@ export function showAgentPet(petId: string): boolean {
 export function closeAgentPetIfOpen(petId: string): void {
   const window = agentPetWindows.get(petId);
   if (!window || window.isDestroyed()) {
-    debug("pet.agent", "close skipped", { petId, reason: "no-window", activeWindows: agentPetWindows.size });
+    debug("familiar.agent", "close skipped", { petId, reason: "no-window", activeWindows: agentPetWindows.size });
     return;
   }
-  info("pet.agent", "close requested", { petId, windowId: window.id, activeWindows: agentPetWindows.size });
+  info("familiar.agent", "close requested", { petId, windowId: window.id, activeWindows: agentPetWindows.size });
   agentPetWindows.delete(petId);
   clearAgentDisplay(petId);
   window.setIgnoreMouseEvents(false);
@@ -42,32 +42,32 @@ export function closeAgentPetIfOpen(petId: string): void {
 }
 
 export function dismissAgentPetForActiveLease(petId: string): void {
-  info("pet.agent", "dismiss requested", { petId });
+  info("familiar.agent", "dismiss requested", { petId });
   dismissedAgentPets.add(petId);
   closeAgentPetIfOpen(petId);
 }
 
 export function clearAgentPetDismissal(petId: string): void {
-  debug("pet.agent", "dismissal cleared", { petId, wasDismissed: dismissedAgentPets.has(petId) });
+  debug("familiar.agent", "dismissal cleared", { petId, wasDismissed: dismissedAgentPets.has(petId) });
   dismissedAgentPets.delete(petId);
 }
 
 export function clearAgentPetLeaseState(petId: string): void {
-  info("pet.agent", "lease state cleared", { petId, hadWindow: agentPetWindows.has(petId), wasDismissed: dismissedAgentPets.has(petId) });
+  info("familiar.agent", "lease state cleared", { petId, hadWindow: agentPetWindows.has(petId), wasDismissed: dismissedAgentPets.has(petId) });
   dismissedAgentPets.delete(petId);
   closeAgentPetIfOpen(petId);
   clearAgentDisplay(petId);
 }
 
-export function applyAgentPetReaction(petId: string, reaction: OpenPetsReaction): { readonly shown: boolean; readonly reason?: string } {
-  debug("pet.agent", "reaction apply", { petId, reaction });
+export function applyAgentPetReaction(petId: string, reaction: FamiliarOSReaction): { readonly shown: boolean; readonly reason?: string } {
+  debug("familiar.agent", "reaction apply", { petId, reaction });
   setAgentDisplay(petId, { reaction });
   const shown = showAgentPet(petId);
   return shown ? { shown } : { shown, reason: "dismissed" };
 }
 
-export function applyAgentPetSay(petId: string, message: string, reaction?: OpenPetsReaction): { readonly shown: boolean; readonly reason?: string } {
-  debug("pet.agent", "say apply", { petId, reaction, messageLength: message.length });
+export function applyAgentPetSay(petId: string, message: string, reaction?: FamiliarOSReaction): { readonly shown: boolean; readonly reason?: string } {
+  debug("familiar.agent", "say apply", { petId, reaction, messageLength: message.length });
   if (!reaction) clearStatusBadge(petId);
   setAgentDisplay(petId, { message, reaction });
   const shown = showAgentPet(petId);
@@ -75,7 +75,7 @@ export function applyAgentPetSay(petId: string, message: string, reaction?: Open
 }
 
 export function closeAllAgentPets(): void {
-  info("pet.agent", "close all requested", { activeWindows: agentPetWindows.size });
+  info("familiar.agent", "close all requested", { activeWindows: agentPetWindows.size });
   for (const petId of [...agentPetWindows.keys()]) {
     closeAgentPetIfOpen(petId);
   }
@@ -83,7 +83,7 @@ export function closeAllAgentPets(): void {
 }
 
 export function refreshAgentPetContent(): void {
-  debug("pet.agent", "refresh all content", { activeWindows: agentPetWindows.size, petIds: [...agentPetWindows.keys()] });
+  debug("familiar.agent", "refresh all content", { activeWindows: agentPetWindows.size, petIds: [...agentPetWindows.keys()] });
   const scale = getPreferredPetScale();
   for (const [petId, window] of agentPetWindows.entries()) {
     if (!window.isDestroyed()) {
@@ -96,9 +96,9 @@ export function refreshAgentPetContent(): void {
 
 function handleBubbleDismissed(petId: string, dismissToken: string): void {
   const currentGeneration = displayGenerations.get(petId) ?? 0;
-  debug("pet.agent", "bubble dismissed callback", { petId, windowId: agentPetWindows.get(petId)?.id, dismissToken, currentGeneration });
+  debug("familiar.agent", "bubble dismissed callback", { petId, windowId: agentPetWindows.get(petId)?.id, dismissToken, currentGeneration });
   if (dismissToken !== String(currentGeneration)) {
-    debug("pet.agent", "bubble dismissed stale token", { petId, dismissToken, currentGeneration });
+    debug("familiar.agent", "bubble dismissed stale token", { petId, dismissToken, currentGeneration });
     return;
   }
   clearAgentDisplay(petId);
@@ -111,21 +111,21 @@ function handleBubbleDismissed(petId: string, dismissToken: string): void {
 function getOrCreateAgentPetWindow(petId: string): BrowserWindow {
   const existing = agentPetWindows.get(petId);
   if (existing && !existing.isDestroyed()) {
-    debug("pet.agent", "reuse existing window", { petId, windowId: existing.id, activeWindows: agentPetWindows.size });
+    debug("familiar.agent", "reuse existing window", { petId, windowId: existing.id, activeWindows: agentPetWindows.size });
     return existing;
   }
 
   const state = getAppStateSnapshot();
   const scale = state.preferences.petScale as PetScaleValue;
-  const pet = state.pets.installed.find((candidate) => candidate.id === petId);
-  if (!pet) throw new Error(`Installed pet is unavailable: ${petId}`);
+  const familiar = state.familiars.installed.find((candidate) => candidate.id === petId);
+  if (!familiar) throw new Error(`Installed familiar is unavailable: ${petId}`);
   const offset = agentPetWindows.size + 1;
   const initial = getDefaultPetInitialPosition(defaultPetWindowSize);
   const display = transientDisplays.get(petId) ?? null;
   const badge = statusBadges.get(petId) ?? null;
   const window = createAgentPetWindow({
     petId,
-    displayName: pet.displayName,
+    displayName: familiar.displayName,
     scale,
     position: { x: initial.x - offset * 36, y: initial.y - offset * 24 },
     display,
@@ -137,17 +137,17 @@ function getOrCreateAgentPetWindow(petId: string): BrowserWindow {
   const windowId = window.id;
 
   window.on("closed", () => {
-    info("pet.agent", "closed", { petId, windowId, activeWindowsBeforeDelete: agentPetWindows.size });
+    info("familiar.agent", "closed", { petId, windowId, activeWindowsBeforeDelete: agentPetWindows.size });
     agentPetWindows.delete(petId);
     clearAgentDisplay(petId);
   });
   agentPetWindows.set(petId, window);
-  info("pet.agent", "created", { petId, windowId: window.id, offset, activeWindows: agentPetWindows.size, position: { x: initial.x - offset * 36, y: initial.y - offset * 24 } });
+  info("familiar.agent", "created", { petId, windowId: window.id, offset, activeWindows: agentPetWindows.size, position: { x: initial.x - offset * 36, y: initial.y - offset * 24 } });
   return window;
 }
 
 function setAgentDisplay(petId: string, display: PetTransientDisplay): void {
-  debug("pet.agent", "display set", { petId, reaction: display.reaction, hasMessage: Boolean(display.message), hasReactionMessage: Boolean(display.reactionMessage) });
+  debug("familiar.agent", "display set", { petId, reaction: display.reaction, hasMessage: Boolean(display.message), hasReactionMessage: Boolean(display.reactionMessage) });
   const nextGeneration = (displayGenerations.get(petId) ?? 0) + 1;
   displayGenerations.set(petId, nextGeneration);
   const preparedDisplay = mergePetTransientDisplay(transientDisplays.get(petId) ?? null, { ...display, dismissToken: String(nextGeneration) });
@@ -191,7 +191,7 @@ function setAgentDisplay(petId: string, display: PetTransientDisplay): void {
 }
 
 function clearAgentDisplay(petId: string): void {
-  debug("pet.agent", "display cleared", { petId, hadDisplay: transientDisplays.has(petId), hadBadge: statusBadges.has(petId) });
+  debug("familiar.agent", "display cleared", { petId, hadDisplay: transientDisplays.has(petId), hadBadge: statusBadges.has(petId) });
   const timer = transientTimers.get(petId);
   if (timer) clearTimeout(timer);
   const animationTimer = transientAnimationTimers.get(petId);
@@ -216,14 +216,14 @@ function clearAllAgentDisplayTimers(): void {
   statusBadges.clear();
 }
 
-function setStatusBadge(petId: string, reaction: OpenPetsReaction): void {
+function setStatusBadge(petId: string, reaction: FamiliarOSReaction): void {
   if (reaction === "idle") {
     clearStatusBadge(petId);
     return;
   }
 
   statusBadges.set(petId, reaction);
-  debug("pet.agent", "status badge set", { petId, reaction, durationMs: isBusyStatusBadgeReaction(reaction) ? busyStatusBadgeMs : transientDisplayMs });
+  debug("familiar.agent", "status badge set", { petId, reaction, durationMs: isBusyStatusBadgeReaction(reaction) ? busyStatusBadgeMs : transientDisplayMs });
   const existingTimer = statusBadgeTimers.get(petId);
   if (existingTimer) clearTimeout(existingTimer);
   const timer = setTimeout(() => {
@@ -238,14 +238,14 @@ function setStatusBadge(petId: string, reaction: OpenPetsReaction): void {
 }
 
 function clearStatusBadge(petId: string): void {
-  if (statusBadges.has(petId)) debug("pet.agent", "status badge cleared", { petId, reaction: statusBadges.get(petId) });
+  if (statusBadges.has(petId)) debug("familiar.agent", "status badge cleared", { petId, reaction: statusBadges.get(petId) });
   statusBadges.delete(petId);
   const timer = statusBadgeTimers.get(petId);
   if (timer) clearTimeout(timer);
   statusBadgeTimers.delete(petId);
 }
 
-function isBusyStatusBadgeReaction(reaction: OpenPetsReaction): boolean {
+function isBusyStatusBadgeReaction(reaction: FamiliarOSReaction): boolean {
   return reaction === "thinking" || reaction === "working" || reaction === "editing" || reaction === "running" || reaction === "testing" || reaction === "waiting";
 }
 
@@ -254,11 +254,11 @@ function getCurrentDismissToken(petId: string, display: PetTransientDisplay | nu
 }
 
 function handleAgentScaleChanged(scale: number): void {
-  debug("pet.agent", "scale changed", { scale });
+  debug("familiar.agent", "scale changed", { scale });
   import("./app-state.js").then(({ updatePreferences }) => {
     updatePreferences({ petScale: scale });
   }).catch((error) => {
-    console.error("Failed to update pet scale preference.", error);
+    console.error("Failed to update familiar scale preference.", error);
   });
 }
 
diff --git a/apps/desktop/src/agent-setup.ts b/apps/desktop/src/agent-setup.ts
index a41ec9b9..29af9638 100644
--- a/apps/desktop/src/agent-setup.ts
+++ b/apps/desktop/src/agent-setup.ts
@@ -4,13 +4,13 @@ import { dirname, isAbsolute, join } from "node:path";
 import { createRequire } from "node:module";
 
 import { app } from "electron";
-import { buildClaudeMcpGetCommand, buildClaudeMcpPreview, buildOpenPetsMcpServerCommand, classifyClaudeMcpStatus, createOpenPetsHookSettingsPreview, doctorClaudeHooks, formatCommandForDisplay, installClaudeHooks, mapAsarPathToUnpacked, uninstallClaudeHooks, type ClaudeCommandSpec, type ClaudeHookDoctorResult, type ClaudeMcpPreview, type OpenPetsCommandMode, type ParsedClaudeMcpEntry } from "@open-pets/claude";
-import { buildCursorRulesPreview, classifyCursorMcpStatus, executeCursorMcpWrite, getCursorGlobalMcpPath, planCursorMcpInstall, planCursorMcpRemove, planCursorMcpReplace, readCursorMcpConfig, type CursorMcpStatusResult } from "@open-pets/cursor";
-import { buildOpenPetsOnlyPreview, type RedactedPreview } from "@open-pets/cursor";
-import { doctorOpenCodeGlobalSetup, getGlobalOpenCodeConfigDir, parseOpenCodeConfig, prepareOpenCodeGlobalRemove, prepareOpenCodeGlobalSetup, writePreparedOpenCodeGlobalRemove, writePreparedOpenCodeGlobalSetup } from "@open-pets/opencode";
+import { buildClaudeMcpGetCommand, buildClaudeMcpPreview, buildFamiliarOSMcpServerCommand, classifyClaudeMcpStatus, createFamiliarOSHookSettingsPreview, doctorClaudeHooks, formatCommandForDisplay, installClaudeHooks, mapAsarPathToUnpacked, uninstallClaudeHooks, type ClaudeCommandSpec, type ClaudeHookDoctorResult, type ClaudeMcpPreview, type FamiliarOSCommandMode, type ParsedClaudeMcpEntry } from "@familiaros/claude";
+import { buildCursorRulesPreview, classifyCursorMcpStatus, executeCursorMcpWrite, getCursorGlobalMcpPath, planCursorMcpInstall, planCursorMcpRemove, planCursorMcpReplace, readCursorMcpConfig, type CursorMcpStatusResult } from "@familiaros/cursor";
+import { buildFamiliarOSOnlyPreview, type RedactedPreview } from "@familiaros/cursor";
+import { doctorOpenCodeGlobalSetup, getGlobalOpenCodeConfigDir, parseOpenCodeConfig, prepareOpenCodeGlobalRemove, prepareOpenCodeGlobalSetup, writePreparedOpenCodeGlobalRemove, writePreparedOpenCodeGlobalSetup } from "@familiaros/opencode";
 
-import { getAppStateSnapshot, updatePreferences, type InstalledPetState, type OpenPetsStateV1 } from "./app-state.js";
-import { doctorClaudeOpenPetsMemory, installClaudeOpenPetsMemory, uninstallClaudeOpenPetsMemory, type ClaudeOpenPetsMemoryStatus } from "./claude-memory.js";
+import { getAppStateSnapshot, updatePreferences, type InstalledPetState, type FamiliarOSStateV1 } from "./app-state.js";
+import { doctorClaudeFamiliarOSMemory, installClaudeFamiliarOSMemory, uninstallClaudeFamiliarOSMemory, type ClaudeFamiliarOSMemoryStatus } from "./claude-memory.js";
 
 export type AgentSetupAction = "configure" | "replace" | "remove" | "install-memory" | "doctor-hooks" | "install-hooks" | "uninstall-hooks" | "opencode-install" | "opencode-remove" | "cursor-install" | "cursor-replace" | "cursor-remove";
 export type JournalAction = "configure" | "update" | "replace" | "remove";
@@ -36,13 +36,13 @@ export interface ClaudeCodeStatus {
 
 export interface AgentSetupSnapshot {
   readonly selectedPetId?: string;
-  readonly commandMode: OpenPetsCommandMode;
+  readonly commandMode: FamiliarOSCommandMode;
   readonly localDevAvailable: boolean;
   readonly petOptions: readonly AgentSetupPetOption[];
   readonly preview: ClaudeMcpPreview;
   readonly status: ClaudeCodeStatus;
   readonly hookStatus: ClaudeHookDoctorResult;
-  readonly memoryStatus: ClaudeOpenPetsMemoryStatus;
+  readonly memoryStatus: ClaudeFamiliarOSMemoryStatus;
   readonly opencodeStatus: OpenCodeSetupStatus;
   readonly opencodePreview: OpenCodeSetupPreview;
   readonly cursorStatus: CursorSetupStatus;
@@ -136,7 +136,7 @@ export async function getAgentSetupSnapshot(selectedPetId?: unknown, commandMode
   const status = preview.error ? createBundledResourceErrorStatus(preview.error) : await detectClaudeCodeStatus(petId, commandMode);
   const rawHookStatus = preview.error ? createHookErrorStatus(preview.error) : safeDoctorClaudeHooks(commandMode, petId);
   const hookStatus = { ...rawHookStatus, settingsPath: formatUserPath(rawHookStatus.settingsPath) ?? rawHookStatus.settingsPath, backupPath: formatUserPath(rawHookStatus.backupPath) };
-  const rawMemoryStatus = doctorClaudeOpenPetsMemory(app.getPath("home"));
+  const rawMemoryStatus = doctorClaudeFamiliarOSMemory(app.getPath("home"));
   const memoryStatus = { ...rawMemoryStatus, claudeMdPath: formatUserPath(rawMemoryStatus.claudeMdPath) ?? rawMemoryStatus.claudeMdPath, openPetsMemoryPath: formatUserPath(rawMemoryStatus.openPetsMemoryPath) ?? rawMemoryStatus.openPetsMemoryPath };
   const opencode = await getOpenCodeSetup(commandMode, petId);
   const cursor = await getCursorSetup(commandMode, petId);
@@ -165,7 +165,7 @@ export function updateAgentSetupCommandPaths(patch: unknown): AgentSetupCommandP
   for (const key of Object.keys(patch)) {
     if (key !== "claude" && key !== "node" && key !== "opencode") throw new Error("Invalid command path setting.");
   }
-  const updates: Writable<Partial<OpenPetsStateV1["preferences"]>> = {};
+  const updates: Writable<Partial<FamiliarOSStateV1["preferences"]>> = {};
   if ("claude" in patch) updates.claudeCommandPath = normalizeOptionalCommandPath(patch.claude, "Claude");
   if ("node" in patch) updates.nodeCommandPath = normalizeOptionalCommandPath(patch.node, "Node.js");
   if ("opencode" in patch) updates.opencodeCommandPath = normalizeOptionalCommandPath(patch.opencode, "OpenCode");
@@ -201,30 +201,30 @@ export function sanitizeAgentSetupOutput(value: string): string {
     .slice(0, 500);
 }
 
-function safeBuildClaudeMcpPreview(selectedPetId: string | undefined, commandMode: OpenPetsCommandMode): { readonly preview: ClaudeMcpPreview; readonly error?: string } {
+function safeBuildClaudeMcpPreview(selectedPetId: string | undefined, commandMode: FamiliarOSCommandMode): { readonly preview: ClaudeMcpPreview; readonly error?: string } {
   try {
     return { preview: withPreferredClaudeCommand(buildClaudeMcpPreview(selectedPetId, commandMode, getPreferredNodeCommand())) };
   } catch (error) {
-    const message = error instanceof Error ? error.message : "Packaged OpenPets command resources are unavailable.";
+    const message = error instanceof Error ? error.message : "Packaged FamiliarOS command resources are unavailable.";
     return { preview: createErrorPreview(commandMode, message), error: message };
   }
 }
 
-function safeDoctorClaudeHooks(commandMode: OpenPetsCommandMode, selectedPetId: string | undefined): ClaudeHookDoctorResult {
+function safeDoctorClaudeHooks(commandMode: FamiliarOSCommandMode, selectedPetId: string | undefined): ClaudeHookDoctorResult {
   try {
     return doctorClaudeHooks(undefined, commandMode, selectedPetId, getPreferredNodeCommand());
   } catch (error) {
-    return createHookErrorStatus(error instanceof Error ? error.message : "Packaged OpenPets hook resources are unavailable.");
+    return createHookErrorStatus(error instanceof Error ? error.message : "Packaged FamiliarOS hook resources are unavailable.");
   }
 }
 
-function createErrorPreview(commandMode: OpenPetsCommandMode, message: string): ClaudeMcpPreview {
+function createErrorPreview(commandMode: FamiliarOSCommandMode, message: string): ClaudeMcpPreview {
   const claude = getPreferredClaudeCommand();
   return {
     commandMode,
     add: { command: claude, args: [] },
-    remove: { command: claude, args: ["mcp", "remove", "--scope", "user", "openpets"] },
-    mcpJson: { mcpServers: { openpets: { type: "stdio", command: "node", args: [] } } },
+    remove: { command: claude, args: ["mcp", "remove", "--scope", "user", "familiaros"] },
+    mcpJson: { mcpServers: { familiaros: { type: "stdio", command: "node", args: [] } } },
     displayCommand: message,
   };
 }
@@ -248,7 +248,7 @@ function createHookErrorStatus(message: string): ClaudeHookDoctorResult {
   return { status: "error", settingsPath: "~/.claude/settings.json", exists: false, valid: false, message, preview: {}, asyncSupported: false };
 }
 
-async function runAction(action: AgentSetupAction, selectedPetId: string | undefined, commandMode: OpenPetsCommandMode): Promise<AgentSetupActionResult> {
+async function runAction(action: AgentSetupAction, selectedPetId: string | undefined, commandMode: FamiliarOSCommandMode): Promise<AgentSetupActionResult> {
   if (action === "opencode-install") return installOpenCodeGlobal(selectedPetId, commandMode);
   if (action === "opencode-remove") return removeOpenCodeGlobal();
   if (action === "cursor-install") return installCursorGlobal(selectedPetId, commandMode);
@@ -264,10 +264,10 @@ async function runAction(action: AgentSetupAction, selectedPetId: string | undef
     try {
       result = uninstallClaudeHooks(undefined, commandMode);
     } catch (error) {
-      return { ok: false, action, message: error instanceof Error ? error.message : "OpenPets hook uninstall failed.", changed: false };
+      return { ok: false, action, message: error instanceof Error ? error.message : "FamiliarOS hook uninstall failed.", changed: false };
     }
-    const message = result.changed ? `Uninstalled OpenPets Claude hooks. Backup: ${formatUserPath(result.backupPath) ?? "not needed"}` : result.message;
-    writeActionJournal({ action: "remove", selectedPetId, command: ["open-pets-claude", "uninstall-hooks"], previousStatus: result.status, success: result.status !== "error", message });
+    const message = result.changed ? `Uninstalled FamiliarOS Claude hooks. Backup: ${formatUserPath(result.backupPath) ?? "not needed"}` : result.message;
+    writeActionJournal({ action: "remove", selectedPetId, command: ["familiaros-claude", "uninstall-hooks"], previousStatus: result.status, success: result.status !== "error", message });
     return { ok: result.status !== "error", action, message, changed: result.changed };
   }
   if (action === "install-memory") {
@@ -279,7 +279,7 @@ async function runAction(action: AgentSetupAction, selectedPetId: string | undef
   }
   if (commandMode === "bundled") {
     const node = await runCommand({ command: getPreferredNodeCommand(), args: ["--version"] });
-    if (!node.ok) return { ok: false, action, message: `Node.js is required for packaged OpenPets commands. Open Claude configuration, set the Node.js command path, then try again. ${summarizeCommandResult(node)}`, changed: false };
+    if (!node.ok) return { ok: false, action, message: `Node.js is required for packaged FamiliarOS commands. Open Claude configuration, set the Node.js command path, then try again. ${summarizeCommandResult(node)}`, changed: false };
   }
   const previewResult = safeBuildClaudeMcpPreview(selectedPetId, commandMode);
   if (previewResult.error) return { ok: false, action, message: previewResult.error, changed: false };
@@ -289,9 +289,9 @@ async function runAction(action: AgentSetupAction, selectedPetId: string | undef
     try {
       result = installClaudeHooks(undefined, commandMode, selectedPetId, getPreferredNodeCommand());
     } catch (error) {
-      return { ok: false, action, message: error instanceof Error ? error.message : "OpenPets hook install failed.", changed: false };
+      return { ok: false, action, message: error instanceof Error ? error.message : "FamiliarOS hook install failed.", changed: false };
     }
-    const message = result.changed ? `Installed OpenPets Claude hooks. Backup: ${formatUserPath(result.backupPath) ?? "not needed"}` : result.message;
+    const message = result.changed ? `Installed FamiliarOS Claude hooks. Backup: ${formatUserPath(result.backupPath) ?? "not needed"}` : result.message;
     writeActionJournal({ action: "update", selectedPetId, command: createHookJournalCommand("install-hooks", selectedPetId), previousStatus: result.status, success: result.status !== "error", message });
     return { ok: result.status !== "error", action, message, changed: result.changed };
   }
@@ -308,11 +308,11 @@ async function runAction(action: AgentSetupAction, selectedPetId: string | undef
   if (action === "configure") {
     if (detection.openPetsEntry.present && detection.openPetsEntry.verified && detection.openPetsEntry.matchesExpected) {
       const memoryResult = safeInstallClaudeMemory();
-      const message = `OpenPets MCP is already configured for Claude Code.${memoryResult.ok ? ` ${memoryResult.message}` : ` Claude instructions were not updated: ${memoryResult.message}`}`;
+      const message = `FamiliarOS MCP is already configured for Claude Code.${memoryResult.ok ? ` ${memoryResult.message}` : ` Claude instructions were not updated: ${memoryResult.message}`}`;
       return { ok: true, action, message, changed: memoryResult.ok && memoryResult.message.startsWith("Added") };
     }
     if (detection.openPetsEntry.present) {
-      return { ok: false, action, message: "Claude already has an openpets MCP entry. OpenPets will keep it as installed; use Replace only if you want to recreate it with the recommended command.", changed: false };
+      return { ok: false, action, message: "Claude already has an familiaros MCP entry. FamiliarOS will keep it as installed; use Replace only if you want to recreate it with the recommended command.", changed: false };
     }
     return runAdd(preview, selectedPetId, previousStatus, action);
   }
@@ -328,14 +328,14 @@ async function runAction(action: AgentSetupAction, selectedPetId: string | undef
     return {
       ok: false,
       action,
-      message: `${added.message} The previous openpets entry was removed; use this command to restore the intended entry: ${preview.displayCommand}`,
+      message: `${added.message} The previous familiaros entry was removed; use this command to restore the intended entry: ${preview.displayCommand}`,
       changed: true,
     };
   }
-  return { ok: true, action, message: `Replaced Claude Code OpenPets MCP entry.${summarizeMemoryMessages(removed.message, added.message)}`, changed: true };
+  return { ok: true, action, message: `Replaced Claude Code FamiliarOS MCP entry.${summarizeMemoryMessages(removed.message, added.message)}`, changed: true };
 }
 
-async function getOpenCodeSetup(commandMode: OpenPetsCommandMode, selectedPetId: string | undefined): Promise<{ readonly status: OpenCodeSetupStatus; readonly preview: OpenCodeSetupPreview }> {
+async function getOpenCodeSetup(commandMode: FamiliarOSCommandMode, selectedPetId: string | undefined): Promise<{ readonly status: OpenCodeSetupStatus; readonly preview: OpenCodeSetupPreview }> {
   const configDir = getGlobalOpenCodeConfigDir(process.env, app.getPath("home"), process.platform);
   const petId = selectedPetId || undefined;
   const cliVersion = getCliPackageVersion();
@@ -360,14 +360,14 @@ async function getOpenCodeSetup(commandMode: OpenPetsCommandMode, selectedPetId:
       configPath: prepared.ok ? (formatUserPath(prepared.configPath) ?? prepared.configPath) : "",
       cleanupConfigPaths: prepared.ok ? prepared.cleanupConfigPaths.map((path) => formatUserPath(path) ?? path) : [],
       mcpCommand: prepared.ok ? prepared.command : [],
-      plugin: prepared.ok ? prepared.plugin : (petId ? [`@open-pets/opencode@${pluginVersion}`, { pet: petId }] : `@open-pets/opencode@${pluginVersion}`),
+      plugin: prepared.ok ? prepared.plugin : (petId ? [`@familiaros/opencode@${pluginVersion}`, { familiar: petId }] : `@familiaros/opencode@${pluginVersion}`),
       instructionPath: prepared.ok ? (formatUserPath(prepared.instructionPath) ?? prepared.instructionPath) : "",
       configPreview: prepared.ok ? prepared.configPreview : {},
     },
   };
 }
 
-async function getCursorSetup(commandMode: OpenPetsCommandMode, selectedPetId: string | undefined): Promise<{ readonly status: CursorSetupStatus; readonly preview: CursorSetupPreview }> {
+async function getCursorSetup(commandMode: FamiliarOSCommandMode, selectedPetId: string | undefined): Promise<{ readonly status: CursorSetupStatus; readonly preview: CursorSetupPreview }> {
   const homeDir = app.getPath("home");
   const configPath = getCursorGlobalMcpPath(homeDir);
   const petId = selectedPetId || undefined;
@@ -393,8 +393,8 @@ async function getCursorSetup(commandMode: OpenPetsCommandMode, selectedPetId: s
     preview: {
       global: true,
       configPath: formatUserPath(configPath) ?? configPath,
-      mcpEntry: buildOpenPetsOnlyPreview({ mcpVersion, petId, commandMode: "published" }),
-      rulesPath: ".cursor/rules/openpets.mdc",
+      mcpEntry: buildFamiliarOSOnlyPreview({ mcpVersion, petId, commandMode: "published" }),
+      rulesPath: ".cursor/rules/familiaros.mdc",
       rulesContent: buildCursorRulesPreview(),
       commandMode: "published",
     },
@@ -480,29 +480,29 @@ function quoteCommandForDisplay(command: string): string {
   return /\s/.test(command) ? JSON.stringify(command) : command;
 }
 
-function safePrepareOpenCode(configDir: string, selectedPetId: string | undefined, cliVersion: string, pluginVersion: string, commandMode: OpenPetsCommandMode, cliEntryPath: string | undefined): { readonly ok: true; readonly command: readonly string[]; readonly configPath: string; readonly cleanupConfigPaths: readonly string[]; readonly instructionPath: string; readonly plugin: readonly unknown[] | string; readonly configPreview: Record<string, unknown> } | { readonly ok: false; readonly message: string } {
+function safePrepareOpenCode(configDir: string, selectedPetId: string | undefined, cliVersion: string, pluginVersion: string, commandMode: FamiliarOSCommandMode, cliEntryPath: string | undefined): { readonly ok: true; readonly command: readonly string[]; readonly configPath: string; readonly cleanupConfigPaths: readonly string[]; readonly instructionPath: string; readonly plugin: readonly unknown[] | string; readonly configPreview: Record<string, unknown> } | { readonly ok: false; readonly message: string } {
   try {
     const prepared = prepareOpenCodeGlobalSetup({ configDir, petId: selectedPetId || undefined, cliVersion, pluginVersion, commandMode, cliEntryPath });
     const parsed = parseOpenCodeConfig(prepared.configWrite.content);
     if (!parsed.ok) return { ok: false, message: parsed.message };
-    const config = parsed.value as { mcp?: { openpets?: { command?: readonly string[] } }; plugin?: readonly unknown[] };
+    const config = parsed.value as { mcp?: { familiaros?: { command?: readonly string[] } }; plugin?: readonly unknown[] };
     const plugin = Array.isArray(config.plugin) ? config.plugin[config.plugin.length - 1] : undefined;
-    return { ok: true, command: config.mcp?.openpets?.command ?? [], configPath: prepared.configPath, cleanupConfigPaths: prepared.cleanupConfigWrites.map((write) => write.targetPath), instructionPath: prepared.instructionPath, plugin: plugin === undefined ? [] : (plugin as readonly unknown[] | string), configPreview: parsed.value };
+    return { ok: true, command: config.mcp?.familiaros?.command ?? [], configPath: prepared.configPath, cleanupConfigPaths: prepared.cleanupConfigWrites.map((write) => write.targetPath), instructionPath: prepared.instructionPath, plugin: plugin === undefined ? [] : (plugin as readonly unknown[] | string), configPreview: parsed.value };
   } catch (error) {
     return { ok: false, message: error instanceof Error ? error.message : "OpenCode setup preview failed." };
   }
 }
 
-async function installOpenCodeGlobal(selectedPetId: string | undefined, commandMode: OpenPetsCommandMode): Promise<AgentSetupActionResult> {
+async function installOpenCodeGlobal(selectedPetId: string | undefined, commandMode: FamiliarOSCommandMode): Promise<AgentSetupActionResult> {
   if (commandMode === "bundled") {
     const node = await runCommand({ command: getPreferredNodeCommand(), args: ["--version"] });
-    if (!node.ok) return { ok: false, action: "opencode-install", message: `Node.js is required for packaged OpenPets commands. Open OpenCode configuration, set the Node.js command path, then try again. ${summarizeCommandResult(node)}`, changed: false };
+    if (!node.ok) return { ok: false, action: "opencode-install", message: `Node.js is required for packaged FamiliarOS commands. Open OpenCode configuration, set the Node.js command path, then try again. ${summarizeCommandResult(node)}`, changed: false };
   }
   try {
     const configDir = getGlobalOpenCodeConfigDir(process.env, app.getPath("home"), process.platform);
     const prepared = prepareOpenCodeGlobalSetup({ configDir, petId: selectedPetId || undefined, cliVersion: getCliPackageVersion(), pluginVersion: getOpenCodePackageVersion(), commandMode, cliEntryPath: commandMode === "published" ? undefined : getDesktopCliEntryPath(commandMode) });
     writePreparedOpenCodeGlobalSetup(prepared);
-    return { ok: true, action: "opencode-install", message: `Installed global OpenCode OpenPets setup. Config: ${formatUserPath(prepared.configPath) ?? prepared.configPath}. Instructions: ${formatUserPath(prepared.instructionPath) ?? prepared.instructionPath}.`, changed: true };
+    return { ok: true, action: "opencode-install", message: `Installed global OpenCode FamiliarOS setup. Config: ${formatUserPath(prepared.configPath) ?? prepared.configPath}. Instructions: ${formatUserPath(prepared.instructionPath) ?? prepared.instructionPath}.`, changed: true };
   } catch (error) {
     return { ok: false, action: "opencode-install", message: error instanceof Error ? error.message : "OpenCode setup failed.", changed: false };
   }
@@ -513,13 +513,13 @@ async function removeOpenCodeGlobal(): Promise<AgentSetupActionResult> {
     const configDir = getGlobalOpenCodeConfigDir(process.env, app.getPath("home"), process.platform);
     const prepared = prepareOpenCodeGlobalRemove(configDir);
     writePreparedOpenCodeGlobalRemove(prepared);
-    return { ok: true, action: "opencode-remove", message: prepared.configWrites.length > 0 ? "Removed global OpenCode OpenPets setup." : "Global OpenCode OpenPets setup was already absent.", changed: prepared.configWrites.length > 0 };
+    return { ok: true, action: "opencode-remove", message: prepared.configWrites.length > 0 ? "Removed global OpenCode FamiliarOS setup." : "Global OpenCode FamiliarOS setup was already absent.", changed: prepared.configWrites.length > 0 };
   } catch (error) {
     return { ok: false, action: "opencode-remove", message: error instanceof Error ? error.message : "OpenCode removal failed.", changed: false };
   }
 }
 
-async function installCursorGlobal(selectedPetId: string | undefined, commandMode: OpenPetsCommandMode): Promise<AgentSetupActionResult> {
+async function installCursorGlobal(selectedPetId: string | undefined, commandMode: FamiliarOSCommandMode): Promise<AgentSetupActionResult> {
   void commandMode;
   try {
     const homeDir = app.getPath("home");
@@ -532,7 +532,7 @@ async function installCursorGlobal(selectedPetId: string | undefined, commandMod
     if ("targetPath" in plan) {
       executeCursorMcpWrite(plan);
       const backupMsg = plan.backupPath ? ` Backup: ${formatUserPath(plan.backupPath) ?? plan.backupPath}.` : "";
-      return { ok: true, action: "cursor-install", message: `Installed Cursor OpenPets MCP config at ${formatUserPath(configPath) ?? configPath}.${backupMsg} Cursor may need to be restarted or reloaded.`, changed: true };
+      return { ok: true, action: "cursor-install", message: `Installed Cursor FamiliarOS MCP config at ${formatUserPath(configPath) ?? configPath}.${backupMsg} Cursor may need to be restarted or reloaded.`, changed: true };
     }
     return { ok: false, action: "cursor-install", message: "Failed to plan Cursor MCP install.", changed: false };
   } catch (error) {
@@ -540,7 +540,7 @@ async function installCursorGlobal(selectedPetId: string | undefined, commandMod
   }
 }
 
-async function replaceCursorGlobal(selectedPetId: string | undefined, commandMode: OpenPetsCommandMode): Promise<AgentSetupActionResult> {
+async function replaceCursorGlobal(selectedPetId: string | undefined, commandMode: FamiliarOSCommandMode): Promise<AgentSetupActionResult> {
   void commandMode;
   try {
     const homeDir = app.getPath("home");
@@ -553,7 +553,7 @@ async function replaceCursorGlobal(selectedPetId: string | undefined, commandMod
     if ("targetPath" in plan) {
       executeCursorMcpWrite(plan);
       const backupMsg = plan.backupPath ? ` Backup: ${formatUserPath(plan.backupPath) ?? plan.backupPath}.` : "";
-      return { ok: true, action: "cursor-replace", message: `Replaced Cursor OpenPets MCP config at ${formatUserPath(configPath) ?? configPath}.${backupMsg} Cursor may need to be restarted or reloaded.`, changed: true };
+      return { ok: true, action: "cursor-replace", message: `Replaced Cursor FamiliarOS MCP config at ${formatUserPath(configPath) ?? configPath}.${backupMsg} Cursor may need to be restarted or reloaded.`, changed: true };
     }
     return { ok: false, action: "cursor-replace", message: "Failed to plan Cursor MCP replace.", changed: false };
   } catch (error) {
@@ -571,7 +571,7 @@ async function removeCursorGlobal(): Promise<AgentSetupActionResult> {
     }
     if ("targetPath" in plan) {
       executeCursorMcpWrite(plan);
-      return { ok: true, action: "cursor-remove", message: `Removed Cursor OpenPets MCP config at ${formatUserPath(configPath) ?? configPath}. Cursor may need to be restarted or reloaded.`, changed: true };
+      return { ok: true, action: "cursor-remove", message: `Removed Cursor FamiliarOS MCP config at ${formatUserPath(configPath) ?? configPath}. Cursor may need to be restarted or reloaded.`, changed: true };
     }
     return { ok: false, action: "cursor-remove", message: "Failed to plan Cursor MCP remove.", changed: false };
   } catch (error) {
@@ -579,17 +579,17 @@ async function removeCursorGlobal(): Promise<AgentSetupActionResult> {
   }
 }
 
-function getDesktopCliEntryPath(commandMode: OpenPetsCommandMode): string {
-  const path = require.resolve("@open-pets/cli");
+function getDesktopCliEntryPath(commandMode: FamiliarOSCommandMode): string {
+  const path = require.resolve("@familiaros/cli");
   return commandMode === "bundled" ? mapAsarPathToUnpacked(path) : path;
 }
 
 function getCliPackageVersion(): string {
-  return getWorkspacePackageVersion("@open-pets/cli");
+  return getWorkspacePackageVersion("@familiaros/cli");
 }
 
 function getOpenCodePackageVersion(): string {
-  return getWorkspacePackageVersion("@open-pets/opencode");
+  return getWorkspacePackageVersion("@familiaros/opencode");
 }
 
 function getWorkspacePackageVersion(packageName: string): string {
@@ -604,17 +604,17 @@ function getWorkspacePackageVersion(packageName: string): string {
 }
 
 function getMcpPackageVersion(): string {
-  return getWorkspacePackageVersion("@open-pets/mcp");
+  return getWorkspacePackageVersion("@familiaros/mcp");
 }
 
-export interface OpenPetsMcpServerPreview {
-  readonly commandMode: OpenPetsCommandMode;
+export interface FamiliarOSMcpServerPreview {
+  readonly commandMode: FamiliarOSCommandMode;
   readonly command: string;
   readonly args: readonly string[];
   readonly displayCommand: string;
   readonly mcpJson: {
     readonly mcpServers: {
-      readonly openpets: {
+      readonly familiaros: {
         readonly type: "stdio";
         readonly command: string;
         readonly args: readonly string[];
@@ -623,15 +623,15 @@ export interface OpenPetsMcpServerPreview {
   };
 }
 
-export interface OpenPetsMcpServerHealth {
+export interface FamiliarOSMcpServerHealth {
   readonly ok: boolean;
   readonly output: string;
   readonly error?: string;
 }
 
-export function buildOpenPetsMcpServerPreview(selectedPetId: string | undefined, commandMode: OpenPetsCommandMode): OpenPetsMcpServerPreview {
+export function buildFamiliarOSMcpServerPreview(selectedPetId: string | undefined, commandMode: FamiliarOSCommandMode): FamiliarOSMcpServerPreview {
   const nodeCommand = getPreferredNodeCommand();
-  const { command, args } = buildOpenPetsMcpServerCommand(selectedPetId, commandMode, nodeCommand);
+  const { command, args } = buildFamiliarOSMcpServerCommand(selectedPetId, commandMode, nodeCommand);
   const displayCommand = formatCommandForDisplay({ command, args });
   return {
     commandMode,
@@ -640,15 +640,15 @@ export function buildOpenPetsMcpServerPreview(selectedPetId: string | undefined,
     displayCommand,
     mcpJson: {
       mcpServers: {
-        openpets: { type: "stdio", command, args },
+        familiaros: { type: "stdio", command, args },
       },
     },
   };
 }
 
-export async function testOpenPetsMcpServer(selectedPetId: string | undefined, commandMode: OpenPetsCommandMode): Promise<OpenPetsMcpServerHealth> {
+export async function testFamiliarOSMcpServer(selectedPetId: string | undefined, commandMode: FamiliarOSCommandMode): Promise<FamiliarOSMcpServerHealth> {
   const nodeCommand = getPreferredNodeCommand();
-  const { command, args } = buildOpenPetsMcpServerCommand(selectedPetId, commandMode, nodeCommand);
+  const { command, args } = buildFamiliarOSMcpServerCommand(selectedPetId, commandMode, nodeCommand);
   const result = await runCommand({ command, args: [...args, "--version"] });
   if (result.ok) {
     return { ok: true, output: result.stdout.trim() || "MCP server responded." };
@@ -658,19 +658,19 @@ export async function testOpenPetsMcpServer(selectedPetId: string | undefined, c
 }
 
 function summarizeMemoryMessages(...messages: readonly string[]): string {
-  const memoryMessages = messages.flatMap((message) => message.match(/Claude (?:OpenPets )?instructions[^.]*\./g) ?? []);
+  const memoryMessages = messages.flatMap((message) => message.match(/Claude (?:FamiliarOS )?instructions[^.]*\./g) ?? []);
   return memoryMessages.length > 0 ? ` ${memoryMessages.join(" ")}` : "";
 }
 
 function createHookJournalCommand(command: "doctor-hooks" | "install-hooks", selectedPetId: string | undefined): readonly string[] {
-  return selectedPetId ? ["open-pets-claude", command, "--pet", selectedPetId] : ["open-pets-claude", command];
+  return selectedPetId ? ["familiaros-claude", command, "--familiar", selectedPetId] : ["familiaros-claude", command];
 }
 
 async function runAdd(preview: ClaudeMcpPreview, selectedPetId: string | undefined, previousStatus: string, action: AgentSetupAction): Promise<AgentSetupActionResult> {
   const result = await runClaudeCommand(preview.add);
   const memoryResult = result.ok ? safeInstallClaudeMemory() : { ok: false as const, message: "" };
   const message = result.ok
-    ? `Configured Claude Code OpenPets MCP entry.${memoryResult.ok ? ` ${memoryResult.message}` : ` Claude instructions were not updated: ${memoryResult.message}`}`
+    ? `Configured Claude Code FamiliarOS MCP entry.${memoryResult.ok ? ` ${memoryResult.message}` : ` Claude instructions were not updated: ${memoryResult.message}`}`
     : `Claude MCP add failed: ${summarizeCommandResult(result)}`;
   writeActionJournal({ action: journalActionFor(action), selectedPetId, command: [preview.add.command, ...preview.add.args], previousStatus, success: result.ok, message });
   return { ok: result.ok, action, message, changed: result.ok };
@@ -680,7 +680,7 @@ async function runRemove(preview: ClaudeMcpPreview, selectedPetId: string | unde
   const result = await runClaudeCommand(preview.remove);
   const memoryResult = result.ok ? safeUninstallClaudeMemory() : { ok: false as const, message: "" };
   const message = result.ok
-    ? `Removed Claude Code OpenPets MCP entry.${memoryResult.ok ? ` ${memoryResult.message}` : ` Claude instructions were not updated: ${memoryResult.message}`}`
+    ? `Removed Claude Code FamiliarOS MCP entry.${memoryResult.ok ? ` ${memoryResult.message}` : ` Claude instructions were not updated: ${memoryResult.message}`}`
     : `Claude MCP remove failed: ${summarizeCommandResult(result)}`;
   writeActionJournal({ action: journalActionFor(action), selectedPetId, command: [preview.remove.command, ...preview.remove.args], previousStatus, success: result.ok, message });
   return { ok: result.ok, action, message, changed: result.ok };
@@ -688,8 +688,8 @@ async function runRemove(preview: ClaudeMcpPreview, selectedPetId: string | unde
 
 function safeInstallClaudeMemory(): { readonly ok: true; readonly message: string } | { readonly ok: false; readonly message: string } {
   try {
-    const result = installClaudeOpenPetsMemory(app.getPath("home"));
-    return { ok: true, message: result.changed ? "Added Claude OpenPets instructions." : "Claude OpenPets instructions already present." };
+    const result = installClaudeFamiliarOSMemory(app.getPath("home"));
+    return { ok: true, message: result.changed ? "Added Claude FamiliarOS instructions." : "Claude FamiliarOS instructions already present." };
   } catch (error) {
     return { ok: false, message: error instanceof Error ? error.message : "Unknown error." };
   }
@@ -697,17 +697,17 @@ function safeInstallClaudeMemory(): { readonly ok: true; readonly message: strin
 
 function safeUninstallClaudeMemory(): { readonly ok: true; readonly message: string } | { readonly ok: false; readonly message: string } {
   try {
-    const result = uninstallClaudeOpenPetsMemory(app.getPath("home"));
-    return { ok: true, message: result.changed ? "Removed Claude OpenPets instructions." : "Claude OpenPets instructions were already absent." };
+    const result = uninstallClaudeFamiliarOSMemory(app.getPath("home"));
+    return { ok: true, message: result.changed ? "Removed Claude FamiliarOS instructions." : "Claude FamiliarOS instructions were already absent." };
   } catch (error) {
     return { ok: false, message: error instanceof Error ? error.message : "Unknown error." };
   }
 }
 
-async function detectClaudeCodeStatus(selectedPetId: string | undefined, commandMode: OpenPetsCommandMode): Promise<ClaudeCodeStatus> {
+async function detectClaudeCodeStatus(selectedPetId: string | undefined, commandMode: FamiliarOSCommandMode): Promise<ClaudeCodeStatus> {
   if (commandMode === "bundled") {
     const node = await runCommand({ command: getPreferredNodeCommand(), args: ["--version"] });
-    if (!node.ok) return createStatus("error", "Node required", `Node.js is required for packaged OpenPets commands. Open Claude configuration, expand Advanced detection, set the Node.js command path, then try again. ${summarizeCommandResult(node)}`, undefined, node, { present: false, source: "none", verified: false, matchesExpected: false });
+    if (!node.ok) return createStatus("error", "Node required", `Node.js is required for packaged FamiliarOS commands. Open Claude configuration, expand Advanced detection, set the Node.js command path, then try again. ${summarizeCommandResult(node)}`, undefined, node, { present: false, source: "none", verified: false, matchesExpected: false });
   }
 
   const version = await runClaudeCommand({ command: "claude", args: ["--version"] });
@@ -728,10 +728,10 @@ async function detectClaudeCodeStatus(selectedPetId: string | undefined, command
     if (get.ok) entry = classifyClaudeMcpStatus(list.stdout, get.stdout, selectedPetId, commandMode, getPreferredNodeCommand());
   }
 
-  if (!entry.present) return createStatus("needs_setup", "Needs setup", "Claude Code is detected, but OpenPets MCP is not configured.", sanitizeAgentSetupOutput(version.stdout || version.stderr), list, entry);
-  if (entry.verified && entry.matchesExpected) return createStatus("configured", "Configured", "Claude Code has the expected OpenPets MCP entry.", sanitizeAgentSetupOutput(version.stdout || version.stderr), list, entry);
-  if (entry.verified) return createStatus("configured", "Installed — custom", "Claude Code has an openpets MCP entry with a custom command. OpenPets will leave it alone unless you choose Replace with recommended.", sanitizeAgentSetupOutput(version.stdout || version.stderr), list, entry);
-  return createStatus("configured", "Installed — unverified", "Claude Code lists an openpets MCP entry, but command details were not available. OpenPets will leave it alone unless you choose Replace with recommended.", sanitizeAgentSetupOutput(version.stdout || version.stderr), list, entry);
+  if (!entry.present) return createStatus("needs_setup", "Needs setup", "Claude Code is detected, but FamiliarOS MCP is not configured.", sanitizeAgentSetupOutput(version.stdout || version.stderr), list, entry);
+  if (entry.verified && entry.matchesExpected) return createStatus("configured", "Configured", "Claude Code has the expected FamiliarOS MCP entry.", sanitizeAgentSetupOutput(version.stdout || version.stderr), list, entry);
+  if (entry.verified) return createStatus("configured", "Installed — custom", "Claude Code has an familiaros MCP entry with a custom command. FamiliarOS will leave it alone unless you choose Replace with recommended.", sanitizeAgentSetupOutput(version.stdout || version.stderr), list, entry);
+  return createStatus("configured", "Installed — unverified", "Claude Code lists an familiaros MCP entry, but command details were not available. FamiliarOS will leave it alone unless you choose Replace with recommended.", sanitizeAgentSetupOutput(version.stdout || version.stderr), list, entry);
 }
 
 async function runClaudeCommandWithTimeoutRetry(spec: ClaudeCommandSpec): Promise<CommandResult> {
@@ -759,24 +759,24 @@ function createStatus(state: ClaudeCodeStatus["state"], label: string, details:
 
 function validateSelectedPetId(value: unknown): string | undefined {
   if (value === undefined || value === null || value === "") return undefined;
-  if (typeof value !== "string") throw new Error("Invalid selected pet id.");
-  const pet = getAppStateSnapshot().pets.installed.find((candidate) => candidate.id === value);
-  if (!pet || pet.broken) throw new Error("Selected pet is not installed or is broken.");
-  return pet.id;
+  if (typeof value !== "string") throw new Error("Invalid selected familiar id.");
+  const familiar = getAppStateSnapshot().familiars.installed.find((candidate) => candidate.id === value);
+  if (!familiar || familiar.broken) throw new Error("Selected familiar is not installed or is broken.");
+  return familiar.id;
 }
 
-function validateCommandMode(value: unknown): OpenPetsCommandMode {
+function validateCommandMode(value: unknown): FamiliarOSCommandMode {
   if (app.isPackaged) return "bundled";
   return value === "local" ? "local" : "published";
 }
 
 function getPetOptions(): readonly AgentSetupPetOption[] {
   const state = getAppStateSnapshot();
-  return state.pets.installed.filter(isUsablePet).map((pet) => ({ id: pet.id, displayName: pet.displayName, default: pet.id === state.preferences.defaultPetId }));
+  return state.familiars.installed.filter(isUsablePet).map((familiar) => ({ id: familiar.id, displayName: familiar.displayName, default: familiar.id === state.preferences.defaultPetId }));
 }
 
-function isUsablePet(pet: InstalledPetState): boolean {
-  return pet.installed && !pet.broken && !pet.builtIn;
+function isUsablePet(familiar: InstalledPetState): boolean {
+  return familiar.installed && !familiar.broken && !familiar.builtIn;
 }
 
 async function runClaudeCommand(spec: ClaudeCommandSpec): Promise<CommandResult> {
@@ -918,7 +918,7 @@ function writeActionJournal(entry: Omit<AgentSetupJournalEntry, "timestamp"> & {
     writeFileSync(tempPath, `${JSON.stringify(entries, null, 2)}\n`, "utf8");
     renameSync(tempPath, path);
   } catch (error) {
-    console.error("Failed to write OpenPets agent setup action journal.", error);
+    console.error("Failed to write FamiliarOS agent setup action journal.", error);
   }
 }
 
@@ -949,5 +949,5 @@ function journalActionFor(action: AgentSetupAction): JournalAction {
 
 export const agentSetupInternalsForChecks = {
   sanitizeAgentSetupOutput,
-  createOpenPetsHookSettingsPreview,
+  createFamiliarOSHookSettingsPreview,
 };
diff --git a/apps/desktop/src/app-state.ts b/apps/desktop/src/app-state.ts
index 049678e5..1d5378ca 100644
--- a/apps/desktop/src/app-state.ts
+++ b/apps/desktop/src/app-state.ts
@@ -4,11 +4,11 @@ import { dirname, isAbsolute, join } from "node:path";
 import { app } from "electron";
 
 import { defaultPetScale, markOnboardingCompleted, normalizeOnboardingCompleted, normalizePetScale, petScaleOptions, type PetScaleValue } from "./app-state-core.js";
-import { builtInPet } from "./built-in-pet.js";
+import { builtInPet } from "./built-in-familiar.js";
 import type { Point } from "./display.js";
 import { isSupportedLocale, type LocalePreference } from "./i18n/catalog.js";
-import { allowedReactions, type OpenPetsReaction } from "./local-ipc-protocol.js";
-import { assertSafePetId, getInstalledPetDir } from "./pet-paths.js";
+import { allowedReactions, type FamiliarOSReaction } from "./local-ipc-protocol.js";
+import { assertSafePetId, getInstalledPetDir } from "./familiar-paths.js";
 import { publishPluginAgentActivity } from "./plugin-events-source.js";
 import { normalizeReactionAnimationOverrides, type ReactionAnimationOverrides } from "./reaction-animation-mapping.js";
 
@@ -32,7 +32,7 @@ export interface InstalledPetState {
   readonly brokenReason?: string;
 }
 
-export interface OpenPetsStateV1 {
+export interface FamiliarOSStateV1 {
   readonly version: 1;
   readonly preferences: {
     readonly defaultPetId: string;
@@ -57,48 +57,77 @@ export interface OpenPetsStateV1 {
     readonly ttsModel?: string;
     readonly ttsEndpointPreset?: "openrouter" | "litellm" | "wavespeedai" | "custom";
     readonly ttsEndpoint?: string;
+    readonly familiarName?: string;
   };
-  readonly pets: {
+  readonly familiars: {
     readonly installed: readonly InstalledPetState[];
   };
   readonly defaultPet: {
     readonly position?: Point;
   };
-  readonly analytics: OpenPetsAnalyticsState;
+  readonly analytics: FamiliarOSAnalyticsState;
 }
 
-export interface OpenPetsAnalyticsState {
+export interface FamiliarOSAnalyticsState {
   readonly messagesSent: number;
   readonly reactionsSent: number;
-  readonly reactionCounts: Record<OpenPetsReaction, number>;
+  readonly reactionCounts: Record<FamiliarOSReaction, number>;
   readonly perPetActivityCounts: Record<string, number>;
   readonly lastActivityAt?: number;
 }
 
-export type OpenPetsActivityRecord =
-  | { readonly kind: "say"; readonly reaction?: OpenPetsReaction; readonly petId?: string }
-  | { readonly kind: "react"; readonly reaction: OpenPetsReaction; readonly petId?: string };
+export type FamiliarOSActivityRecord =
+  | { readonly kind: "say"; readonly reaction?: FamiliarOSReaction; readonly petId?: string }
+  | { readonly kind: "react"; readonly reaction: FamiliarOSReaction; readonly petId?: string };
 
 export { defaultPetScale, normalizePetScale, petScaleOptions, type PetScaleValue };
 
 export const defaultOpenApiChatEndpoint = "https://api.openai.com/v1/responses";
 
-const stateFileName = "openpets-state.json";
-const directInstallLockName = ".install-pet.lock";
+const stateFileName = "familiaros-state.json";
+const directInstallLockName = ".install-familiar.lock";
 const directInstallLockStaleMs = 10 * 60 * 1000;
 let statePath: string | null = null;
-let currentState: OpenPetsStateV1 | null = null;
+let currentState: FamiliarOSStateV1 | null = null;
 let startupInstallLockPath: string | null = null;
 
+const legacyFileMigrations: Record<string, string> = {
+  "openpets-state.json": "familiaros-state.json",
+  "openpets-openapi-chat.json": "familiaros-openapi-chat.json",
+  "openpets-openai-chat.json": "familiaros-openai-chat.json",
+  "openpets-chat-history.json": "familiaros-chat-history.json",
+  "openpets-chat-conversations.json": "familiaros-chat-conversations.json",
+  "openpets-memory.json": "familiaros-memory.json",
+  "openpets-plugin-platform.json": "familiaros-plugin-platform.json",
+  "openpets-plugin-state.json": "familiaros-plugin-state.json",
+  "openpets-tts-credential.json": "familiaros-tts-credential.json",
+};
+
+function migrateLegacyFilenames(userDataPath: string): void {
+  for (const [oldName, newName] of Object.entries(legacyFileMigrations)) {
+    const oldPath = join(userDataPath, oldName);
+    const newPath = join(userDataPath, newName);
+    if (existsSync(oldPath) && !existsSync(newPath)) {
+      try {
+        renameSync(oldPath, newPath);
+        console.log(`Migrated legacy state file: ${oldName} -> ${newName}`);
+      } catch (error) {
+        console.error(`Failed to migrate ${oldName}:`, error);
+      }
+    }
+  }
+}
+
 export function initializeAppState(): void {
   const userDataPath = app.getPath("userData");
+  migrateLegacyFilenames(userDataPath);
   startupInstallLockPath = acquireStartupInstallLock(userDataPath);
 
   statePath = join(userDataPath, stateFileName);
   const nextState = normalizeState(readStateFile(statePath));
   writeStateToDisk(nextState);
   currentState = nextState;
-  console.log(`OpenPets state initialized at ${statePath}.`);
+  console.log(`FamiliarOS state initialized at ${statePath}.`);
 }
 
 export function releaseStartupInstallLock(): void {
@@ -107,11 +136,11 @@ export function releaseStartupInstallLock(): void {
   if (lockPath) rmSync(lockPath, { recursive: true, force: true });
 }
 
-export function getAppStateSnapshot(): OpenPetsStateV1 {
+export function getAppStateSnapshot(): FamiliarOSStateV1 {
   return cloneState(getInitializedState());
 }
 
-export function updatePreferences(patch: Partial<OpenPetsStateV1["preferences"]>): OpenPetsStateV1 {
+export function updatePreferences(patch: Partial<FamiliarOSStateV1["preferences"]>): FamiliarOSStateV1 {
   const state = getInitializedState();
   const preferences = normalizePreferences({ ...state.preferences, ...patch });
 
@@ -128,23 +157,23 @@ export function isOnboardingCompleted(): boolean {
   return getInitializedState().preferences.onboardingCompleted;
 }
 
-export function completeOnboarding(): OpenPetsStateV1 {
+export function completeOnboarding(): FamiliarOSStateV1 {
   const state = getInitializedState();
   const nextState = normalizeState(markOnboardingCompleted(state));
   commitState(nextState);
   return getAppStateSnapshot();
 }
 
-export function setDefaultPet(defaultPetId: string): OpenPetsStateV1 {
+export function setDefaultPet(defaultPetId: string): FamiliarOSStateV1 {
   const state = getInitializedState();
-  const targetPet = state.pets.installed.find((pet) => pet.id === defaultPetId);
+  const targetPet = state.familiars.installed.find((familiar) => familiar.id === defaultPetId);
 
   if (!targetPet) {
-    throw new Error(`Cannot set unknown pet as default: ${defaultPetId}`);
+    throw new Error(`Cannot set unknown familiar as default: ${defaultPetId}`);
   }
 
   if (targetPet.broken) {
-    throw new Error(`Cannot set broken pet as default: ${defaultPetId}`);
+    throw new Error(`Cannot set broken familiar as default: ${defaultPetId}`);
   }
 
   const nextState = normalizeState({
@@ -159,7 +188,7 @@ export function setDefaultPet(defaultPetId: string): OpenPetsStateV1 {
   return getAppStateSnapshot();
 }
 
-export function setDefaultPetPosition(position: Point): OpenPetsStateV1 {
+export function setDefaultPetPosition(position: Point): FamiliarOSStateV1 {
   const state = getInitializedState();
 
   const nextState = normalizeState({
@@ -174,7 +203,7 @@ export function setDefaultPetPosition(position: Point): OpenPetsStateV1 {
   return getAppStateSnapshot();
 }
 
-export function resetDefaultPetPosition(position: Point): OpenPetsStateV1 {
+export function resetDefaultPetPosition(position: Point): FamiliarOSStateV1 {
   return setDefaultPetPosition(position);
 }
 
@@ -182,7 +211,7 @@ export function getDefaultPetPosition(): Point | undefined {
   return getInitializedState().defaultPet.position;
 }
 
-export function recordOpenPetsActivity(activity: OpenPetsActivityRecord, now: number = Date.now()): OpenPetsStateV1 {
+export function recordFamiliarOSActivity(activity: FamiliarOSActivityRecord, now: number = Date.now()): FamiliarOSStateV1 {
   publishPluginAgentActivity({ kind: activity.kind, reaction: activity.reaction });
   const state = getInitializedState();
   const analytics = state.analytics;
@@ -207,20 +236,20 @@ export function recordOpenPetsActivity(activity: OpenPetsActivityRecord, now: nu
   return getAppStateSnapshot();
 }
 
-export function installPetState(pet: Omit<InstalledPetState, "builtIn" | "protected" | "installed">): OpenPetsStateV1 {
+export function installPetState(familiar: Omit<InstalledPetState, "builtIn" | "protected" | "installed">): FamiliarOSStateV1 {
   const state = getInitializedState();
 
-  if (state.pets.installed.some((installedPet) => installedPet.id === pet.id)) {
-    throw new Error(`Pet is already installed: ${pet.id}`);
+  if (state.familiars.installed.some((installedPet) => installedPet.id === familiar.id)) {
+    throw new Error(`Familiar is already installed: ${familiar.id}`);
   }
 
   const nextState = normalizeState({
     ...state,
-    pets: {
+    familiars: {
       installed: [
-        ...state.pets.installed,
+        ...state.familiars.installed,
         {
-          ...pet,
+          ...familiar,
           builtIn: false,
           protected: false,
           installed: true,
@@ -233,16 +262,16 @@ export function installPetState(pet: Omit<InstalledPetState, "builtIn" | "protec
   return getAppStateSnapshot();
 }
 
-export function removePetState(petId: string): OpenPetsStateV1 {
+export function removePetState(petId: string): FamiliarOSStateV1 {
   if (petId === builtInPet.id) {
-    throw new Error("Built-in pet cannot be removed.");
+    throw new Error("Built-in familiar cannot be removed.");
   }
 
   const state = getInitializedState();
-  const existing = state.pets.installed.find((pet) => pet.id === petId);
+  const existing = state.familiars.installed.find((familiar) => familiar.id === petId);
 
   if (!existing) {
-    throw new Error(`Pet is not installed: ${petId}`);
+    throw new Error(`Familiar is not installed: ${petId}`);
   }
 
   const nextDefaultPetId = state.preferences.defaultPetId === petId ? builtInPet.id : state.preferences.defaultPetId;
@@ -253,8 +282,8 @@ export function removePetState(petId: string): OpenPetsStateV1 {
       ...state.preferences,
       defaultPetId: nextDefaultPetId,
     },
-    pets: {
-      installed: state.pets.installed.filter((pet) => pet.id !== petId),
+    familiars: {
+      installed: state.familiars.installed.filter((familiar) => familiar.id !== petId),
     },
   });
 
@@ -262,7 +291,7 @@ export function removePetState(petId: string): OpenPetsStateV1 {
   return getAppStateSnapshot();
 }
 
-export function markPetBroken(petId: string, brokenReason: string): OpenPetsStateV1 {
+export function markPetBroken(petId: string, brokenReason: string): FamiliarOSStateV1 {
   const state = getInitializedState();
 
   if (petId === builtInPet.id) {
@@ -275,8 +304,8 @@ export function markPetBroken(petId: string, brokenReason: string): OpenPetsStat
       ...state.preferences,
       defaultPetId: state.preferences.defaultPetId === petId ? builtInPet.id : state.preferences.defaultPetId,
     },
-    pets: {
-      installed: state.pets.installed.map((pet) => pet.id === petId ? { ...pet, broken: true, brokenReason } : pet),
+    familiars: {
+      installed: state.familiars.installed.map((familiar) => familiar.id === petId ? { ...familiar, broken: true, brokenReason } : familiar),
     },
   });
 
@@ -286,15 +315,15 @@ export function markPetBroken(petId: string, brokenReason: string): OpenPetsStat
 
 export function getStateFilePath(): string {
   if (!statePath) {
-    throw new Error("OpenPets app state has not been initialized.");
+    throw new Error("FamiliarOS app state has not been initialized.");
   }
 
   return statePath;
 }
 
-function getInitializedState(): OpenPetsStateV1 {
+function getInitializedState(): FamiliarOSStateV1 {
   if (!currentState) {
-    throw new Error("OpenPets app state has not been initialized.");
+    throw new Error("FamiliarOS app state has not been initialized.");
   }
 
   return currentState;
@@ -308,12 +337,12 @@ function readStateFile(path: string): unknown {
   try {
     return JSON.parse(readFileSync(path, "utf8")) as unknown;
   } catch (error) {
-    console.error(`Failed to read OpenPets state from ${path}; using defaults.`, error);
+    console.error(`Failed to read FamiliarOS state from ${path}; using defaults.`, error);
     return undefined;
   }
 }
 
-function normalizeState(value: unknown): OpenPetsStateV1 {
+function normalizeState(value: unknown): FamiliarOSStateV1 {
   const record = isRecord(value) ? value : {};
   const defaultPetRecord = isRecord(record.defaultPet) ? record.defaultPet : {};
   const preferencesRecord = isRecord(record.preferences) ? record.preferences : {};
@@ -321,7 +350,7 @@ function normalizeState(value: unknown): OpenPetsStateV1 {
   const position = normalizeMaybePosition(defaultPetRecord.position);
   const installedPets = normalizeInstalledPets(record);
   const defaultPetId = typeof preferencesRecord.defaultPetId === "string"
-    && installedPets.some((pet) => pet.id === preferencesRecord.defaultPetId && !pet.broken)
+    && installedPets.some((familiar) => familiar.id === preferencesRecord.defaultPetId && !familiar.broken)
     ? preferencesRecord.defaultPetId
     : builtInPet.id;
 
@@ -332,7 +361,7 @@ function normalizeState(value: unknown): OpenPetsStateV1 {
       ...preferencesRecord,
       defaultPetId,
     }),
-    pets: {
+    familiars: {
       installed: installedPets,
     },
     defaultPet: position ? { position } : {},
@@ -340,7 +369,7 @@ function normalizeState(value: unknown): OpenPetsStateV1 {
   };
 }
 
-function normalizeAnalytics(value: unknown): OpenPetsAnalyticsState {
+function normalizeAnalytics(value: unknown): FamiliarOSAnalyticsState {
   const record = isRecord(value) ? value : {};
   return {
     messagesSent: normalizeCount(record.messagesSent),
@@ -351,9 +380,9 @@ function normalizeAnalytics(value: unknown): OpenPetsAnalyticsState {
   };
 }
 
-function normalizeReactionCounts(value: unknown): Record<OpenPetsReaction, number> {
+function normalizeReactionCounts(value: unknown): Record<FamiliarOSReaction, number> {
   const record = isRecord(value) ? value : {};
-  const counts = {} as Record<OpenPetsReaction, number>;
+  const counts = {} as Record<FamiliarOSReaction, number>;
   for (const reaction of allowedReactions) {
     counts[reaction] = normalizeCount(record[reaction]);
   }
@@ -385,7 +414,7 @@ function normalizeTimestamp(value: unknown): number | undefined {
   return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : undefined;
 }
 
-function normalizePreferences(value: Partial<OpenPetsStateV1["preferences"]>): OpenPetsStateV1["preferences"] {
+function normalizePreferences(value: Partial<FamiliarOSStateV1["preferences"]>): FamiliarOSStateV1["preferences"] {
   const defaultState = createDefaultState();
   const legacyValue = value as Partial<{
     readonly openAiChatModel?: unknown;
@@ -413,15 +442,23 @@ function normalizePreferences(value: Partial<OpenPetsStateV1["preferences"]>): O
     opencodeCommandPath: normalizeCommandPath(value.opencodeCommandPath),
     vanillaChatMcpTools: normalizeVanillaChatMcpTools(value.vanillaChatMcpTools),
     openApiChatBaseInstructionsEnabled: typeof value.openApiChatBaseInstructionsEnabled === "boolean" ? value.openApiChatBaseInstructionsEnabled : true,
-    ttsProvider: ["system", "openai", "elevenlabs", "piper", "openai-compatible"].includes(value.ttsProvider as string) ? (value.ttsProvider as OpenPetsStateV1["preferences"]["ttsProvider"]) : "system",
+    ttsProvider: ["system", "openai", "elevenlabs", "piper", "openai-compatible"].includes(value.ttsProvider as string) ? (value.ttsProvider as FamiliarOSStateV1["preferences"]["ttsProvider"]) : "system",
     ttsVoice: typeof value.ttsVoice === "string" ? value.ttsVoice : undefined,
     ttsSpeed: typeof value.ttsSpeed === "number" && value.ttsSpeed >= 0.5 && value.ttsSpeed <= 2 ? value.ttsSpeed : 1,
     ttsModel: typeof value.ttsModel === "string" ? value.ttsModel : undefined,
-    ttsEndpointPreset: ["openrouter", "litellm", "wavespeedai", "custom"].includes(value.ttsEndpointPreset as string) ? (value.ttsEndpointPreset as OpenPetsStateV1["preferences"]["ttsEndpointPreset"]) : "openrouter",
+    ttsEndpointPreset: ["openrouter", "litellm", "wavespeedai", "custom"].includes(value.ttsEndpointPreset as string) ? (value.ttsEndpointPreset as FamiliarOSStateV1["preferences"]["ttsEndpointPreset"]) : "openrouter",
     ttsEndpoint: typeof value.ttsEndpoint === "string" ? value.ttsEndpoint : undefined,
+    familiarName: normalizeFamiliarName(value.familiarName),
   };
 }
 
+export function normalizeFamiliarName(value: unknown): string | undefined {
+  if (typeof value !== "string") return undefined;
+  const trimmed = value.trim().slice(0, 64);
+  if (!trimmed || /[\r\n\0\x01-\x1f\x7f]/.test(trimmed)) return undefined;
+  return trimmed;
+}
+
 function normalizeVanillaChatMcpTools(value: unknown): readonly string[] | undefined {
   if (!Array.isArray(value)) return undefined;
   const valid = value.filter((v): v is string => typeof v === "string" && /^[a-z0-9-]+$/.test(v));
@@ -498,13 +535,13 @@ function normalizeOpenApiChatTheme(value: unknown): "system" | "light" | "dark"
 }
 
 function normalizeInstalledPets(value: Record<string, unknown>): InstalledPetState[] {
-  const installed = isRecord(value.pets) && Array.isArray(value.pets.installed)
-    ? value.pets.installed
+  const installed = isRecord(value.familiars) && Array.isArray(value.familiars.installed)
+    ? value.familiars.installed
     : [];
 
   const normalized = installed
-    .map((pet) => normalizeInstalledPet(pet))
-    .filter((pet): pet is InstalledPetState => Boolean(pet && pet.id !== builtInPet.id));
+    .map((familiar) => normalizeInstalledPet(familiar))
+    .filter((familiar): familiar is InstalledPetState => Boolean(familiar && familiar.id !== builtInPet.id));
 
   return [builtInPet, ...normalized];
 }
@@ -535,7 +572,7 @@ function normalizeInstalledPet(value: unknown): InstalledPetState | null {
   };
 }
 
-function createDefaultState(): OpenPetsStateV1 {
+function createDefaultState(): FamiliarOSStateV1 {
   return {
     version: 1,
     preferences: {
@@ -561,8 +598,9 @@ function createDefaultState(): OpenPetsStateV1 {
       ttsModel: undefined,
       ttsEndpointPreset: "openrouter",
       ttsEndpoint: undefined,
+      familiarName: undefined,
     },
-    pets: {
+    familiars: {
       installed: [builtInPet],
     },
     defaultPet: {},
@@ -576,12 +614,12 @@ function createDefaultState(): OpenPetsStateV1 {
   };
 }
 
-function commitState(nextState: OpenPetsStateV1): void {
+function commitState(nextState: FamiliarOSStateV1): void {
   writeStateToDisk(nextState);
   currentState = nextState;
 }
 
-function writeStateToDisk(state: OpenPetsStateV1): void {
+function writeStateToDisk(state: FamiliarOSStateV1): void {
   const path = getStateFilePath();
 
   mkdirSync(dirname(path), { recursive: true });
@@ -593,7 +631,7 @@ function writeStateToDisk(state: OpenPetsStateV1): void {
 function validateInstalledPetFiles(petId: string): string | undefined {
   try {
     const dir = getInstalledPetDir(petId);
-    const petJsonPath = join(dir, "pet.json");
+    const petJsonPath = join(dir, "familiar.json");
     const spritesheetPath = join(dir, "spritesheet.webp");
     JSON.parse(readFileSync(petJsonPath, "utf8")) as unknown;
     const spritesheet = statSync(spritesheetPath);
@@ -602,7 +640,7 @@ function validateInstalledPetFiles(petId: string): string | undefined {
     if (spritesheet.size > 100 * 1024 * 1024) return "spritesheet.webp is too large.";
     return undefined;
   } catch (error) {
-    return error instanceof Error ? error.message : "Installed pet files are invalid.";
+    return error instanceof Error ? error.message : "Installed familiar files are invalid.";
   }
 }
 
@@ -648,8 +686,8 @@ function normalizePosition(value: Partial<Point>): Point | undefined {
   };
 }
 
-function cloneState(state: OpenPetsStateV1): OpenPetsStateV1 {
-  return structuredClone(state) as OpenPetsStateV1;
+function cloneState(state: FamiliarOSStateV1): FamiliarOSStateV1 {
+  return structuredClone(state) as FamiliarOSStateV1;
 }
 
 function acquireStartupInstallLock(userDataPath: string): string {
@@ -658,7 +696,7 @@ function acquireStartupInstallLock(userDataPath: string): string {
   for (let attempt = 0; attempt < 2; attempt += 1) {
     try {
       mkdirSync(lockPath, { mode: 0o700 });
-      writeFileSync(join(lockPath, "owner.json"), `${JSON.stringify({ pid: process.pid, createdAt: Date.now(), command: "openpets-startup" })}\n`, "utf8");
+      writeFileSync(join(lockPath, "owner.json"), `${JSON.stringify({ pid: process.pid, createdAt: Date.now(), command: "familiaros-startup" })}\n`, "utf8");
       return lockPath;
     } catch (error) {
       const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
@@ -667,10 +705,10 @@ function acquireStartupInstallLock(userDataPath: string): string {
         rmSync(lockPath, { recursive: true, force: true });
         continue;
       }
-      throw new Error("OpenPets cannot start while a direct pet install is in progress. Wait for install-pet to finish, then reopen OpenPets.");
+      throw new Error("FamiliarOS cannot start while a direct familiar install is in progress. Wait for install-familiar to finish, then reopen FamiliarOS.");
     }
   }
-  throw new Error("Could not acquire OpenPets startup lock.");
+  throw new Error("Could not acquire FamiliarOS startup lock.");
 }
 
 function isStaleInstallLock(lockPath: string): boolean {
diff --git a/apps/desktop/src/assets.ts b/apps/desktop/src/assets.ts
index 160f83bc..7f270d08 100644
--- a/apps/desktop/src/assets.ts
+++ b/apps/desktop/src/assets.ts
@@ -17,7 +17,7 @@ export function createAppIcon(): NativeImage {
     return cachedAppIcon;
   }
 
-  console.error(`OpenPets app icon asset could not be loaded from ${assetPath}; using generated fallback icon.`);
+  console.error(`FamiliarOS app icon asset could not be loaded from ${assetPath}; using generated fallback icon.`);
   cachedAppIcon = createFallbackTrayIcon();
   return cachedAppIcon;
 }
@@ -30,7 +30,7 @@ export function createTrayIcon(): NativeImage {
     return assetImage.resize({ width: 22, height: 22 });
   }
 
-  console.error(`OpenPets tray icon asset could not be loaded from ${assetPath}; using generated fallback icon.`);
+  console.error(`FamiliarOS tray icon asset could not be loaded from ${assetPath}; using generated fallback icon.`);
   return createFallbackTrayIcon();
 }
 
@@ -63,7 +63,7 @@ function createFallbackTrayIcon(): NativeImage {
   });
 
   if (image.isEmpty()) {
-    console.error("OpenPets tray icon creation produced an empty image.");
+    console.error("FamiliarOS tray icon creation produced an empty image.");
   }
 
   if (process.platform === "darwin") {
diff --git a/apps/desktop/src/built-in-pet.ts b/apps/desktop/src/built-in-familiar.ts
similarity index 75%
rename from apps/desktop/src/built-in-pet.ts
rename to apps/desktop/src/built-in-familiar.ts
index f2c5069f..79bebc41 100644
--- a/apps/desktop/src/built-in-pet.ts
+++ b/apps/desktop/src/built-in-familiar.ts
@@ -1,6 +1,6 @@
 export const builtInPet = {
   id: "builtin",
-  displayName: "Built-in Pet",
+  displayName: "Built-in Familiar",
   builtIn: true,
   protected: true,
   installed: true,
diff --git a/apps/desktop/src/catalog-validation.ts b/apps/desktop/src/catalog-validation.ts
index 08ae65dd..79ee7395 100644
--- a/apps/desktop/src/catalog-validation.ts
+++ b/apps/desktop/src/catalog-validation.ts
@@ -1,7 +1,7 @@
 export interface CatalogV2 {
   readonly version: 2;
   readonly generatedAt: string;
-  readonly pets: readonly CatalogPetV2[];
+  readonly familiars: readonly CatalogPetV2[];
 }
 
 export interface CatalogPetV2 {
@@ -41,7 +41,7 @@ export interface CatalogV3Page {
   readonly version: 3;
   readonly page: number;
   readonly pageSize: number;
-  readonly pets: readonly CatalogPetV3[];
+  readonly familiars: readonly CatalogPetV3[];
 }
 
 export interface CatalogV3SearchIndex {
@@ -56,7 +56,7 @@ export interface CatalogV3SearchPage {
   readonly version: 3;
   readonly page: number;
   readonly pageSize: number;
-  readonly pets: readonly CatalogV3SearchPet[];
+  readonly familiars: readonly CatalogV3SearchPet[];
 }
 
 export interface CatalogV3SearchPet {
@@ -86,16 +86,16 @@ export function validateCatalogV2(value: unknown): CatalogV2 {
   if (!isRecord(value)) throw new Error("Catalog must be an object.");
   if (value.version !== 2) throw new Error("Catalog version must be 2.");
   if (typeof value.generatedAt !== "string" || Number.isNaN(Date.parse(value.generatedAt))) throw new Error("Catalog generatedAt must be a valid date string.");
-  if (!Array.isArray(value.pets)) throw new Error("Catalog pets must be an array.");
-  if (value.pets.length > 1000) throw new Error("Catalog has too many pets.");
+  if (!Array.isArray(value.familiars)) throw new Error("Catalog familiars must be an array.");
+  if (value.familiars.length > 1000) throw new Error("Catalog has too many familiars.");
 
   const ids = new Set<string>();
-  const pets = value.pets.map((pet) => validateCatalogPet(pet, ids));
+  const familiars = value.familiars.map((familiar) => validateCatalogPet(familiar, ids));
 
   return {
     version: 2,
     generatedAt: value.generatedAt,
-    pets,
+    familiars,
   };
 }
 
@@ -133,16 +133,16 @@ export function validateCatalogV3Page(value: unknown, expectedPage: number): Cat
   if (value.version !== 3) throw new Error("Catalog v3 page version must be 3.");
   if (value.page !== expectedPage) throw new Error("Catalog v3 page index mismatch.");
   const pageSize = validateInteger(value.pageSize, "Catalog v3 pageSize", 1, 500);
-  if (!Array.isArray(value.pets)) throw new Error("Catalog v3 pets must be an array.");
-  if (value.pets.length > pageSize) throw new Error("Catalog v3 page has too many pets.");
+  if (!Array.isArray(value.familiars)) throw new Error("Catalog v3 familiars must be an array.");
+  if (value.familiars.length > pageSize) throw new Error("Catalog v3 page has too many familiars.");
   const ids = new Set<string>();
-  const pets = value.pets.map((pet) => validateCatalogV3Pet(pet, ids));
+  const familiars = value.familiars.map((familiar) => validateCatalogV3Pet(familiar, ids));
 
   return {
     version: 3,
     page: expectedPage,
     pageSize,
-    pets,
+    familiars,
   };
 }
 
@@ -169,21 +169,21 @@ export function validateCatalogV3SearchPage(value: unknown, expectedPage: number
   if (value.version !== 3) throw new Error("Catalog v3 search page version must be 3.");
   if (value.page !== expectedPage) throw new Error("Catalog v3 search page index mismatch.");
   const pageSize = validateInteger(value.pageSize, "Catalog v3 search pageSize", 1, 1000);
-  if (!Array.isArray(value.pets)) throw new Error("Catalog v3 search pets must be an array.");
-  if (value.pets.length > pageSize) throw new Error("Catalog v3 search page has too many pets.");
+  if (!Array.isArray(value.familiars)) throw new Error("Catalog v3 search familiars must be an array.");
+  if (value.familiars.length > pageSize) throw new Error("Catalog v3 search page has too many familiars.");
   return {
     version: 3,
     page: expectedPage,
     pageSize,
-    pets: value.pets.map((pet) => validateCatalogV3SearchPet(pet, catalogPageCount)),
+    familiars: value.familiars.map((familiar) => validateCatalogV3SearchPet(familiar, catalogPageCount)),
   };
 }
 
 function validateCatalogPet(value: unknown, ids: Set<string>): CatalogPetV2 {
-  if (!isRecord(value)) throw new Error("Catalog pet must be an object.");
+  if (!isRecord(value)) throw new Error("Catalog familiar must be an object.");
   const id = validateId(value.id);
 
-  if (ids.has(id)) throw new Error(`Duplicate catalog pet id: ${id}`);
+  if (ids.has(id)) throw new Error(`Duplicate catalog familiar id: ${id}`);
   ids.add(id);
 
   return {
@@ -196,9 +196,9 @@ function validateCatalogPet(value: unknown, ids: Set<string>): CatalogPetV2 {
 }
 
 function validateCatalogV3Pet(value: unknown, ids: Set<string>): CatalogPetV3 {
-  if (!isRecord(value)) throw new Error("Catalog v3 pet must be an object.");
+  if (!isRecord(value)) throw new Error("Catalog v3 familiar must be an object.");
   const id = validateId(value.id);
-  if (ids.has(id)) throw new Error(`Duplicate catalog v3 pet id on page: ${id}`);
+  if (ids.has(id)) throw new Error(`Duplicate catalog v3 familiar id on page: ${id}`);
   ids.add(id);
   const category = validateCategory(value.category);
   const entry: CatalogPetV3 = {
@@ -224,7 +224,7 @@ function validateCatalogV3Category(value: unknown): CatalogV3Category {
 }
 
 function validateCatalogV3SearchPet(value: unknown, catalogPageCount: number): CatalogV3SearchPet {
-  if (!isRecord(value)) throw new Error("Catalog v3 search pet must be an object.");
+  if (!isRecord(value)) throw new Error("Catalog v3 search familiar must be an object.");
   const catalogPage = validateInteger(value.catalogPage, "Catalog v3 search catalogPage", 0, Math.max(0, catalogPageCount - 1));
   return withCatalogMeta({
     id: validateId(value.id),
@@ -244,7 +244,7 @@ function withCatalogMeta<T extends object>(entry: T, value: Record<string, unkno
 }
 
 function validateBoolean(value: unknown, field: string): boolean {
-  if (typeof value !== "boolean") throw new Error(`Catalog pet ${field} must be a boolean.`);
+  if (typeof value !== "boolean") throw new Error(`Catalog familiar ${field} must be a boolean.`);
   return value;
 }
 
@@ -263,15 +263,15 @@ function validateInteger(value: unknown, field: string, min: number, max: number
 }
 
 function validateId(value: unknown): string {
-  if (typeof value !== "string") throw new Error("Catalog pet id must be a string.");
-  if (value === "builtin") throw new Error("Catalog pet id 'builtin' is reserved.");
-  if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(value)) throw new Error(`Invalid catalog pet id: ${value}`);
+  if (typeof value !== "string") throw new Error("Catalog familiar id must be a string.");
+  if (value === "builtin") throw new Error("Catalog familiar id 'builtin' is reserved.");
+  if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(value)) throw new Error(`Invalid catalog familiar id: ${value}`);
   return value;
 }
 
 function validateString(value: unknown, field: string, maxLength: number): string {
-  if (typeof value !== "string") throw new Error(`Catalog pet ${field} must be a string.`);
-  if (value.length > maxLength) throw new Error(`Catalog pet ${field} is too long.`);
+  if (typeof value !== "string") throw new Error(`Catalog familiar ${field} must be a string.`);
+  if (value.length > maxLength) throw new Error(`Catalog familiar ${field} is too long.`);
   return value;
 }
 
@@ -284,10 +284,10 @@ function validateCatalogUrl(value: unknown, field: "preview" | "zip" | "catalog"
   if (url.port) throw new Error(`${field} URL cannot include a custom port.`);
 
   if (field === "preview") {
-    if (url.hostname !== "openpets.dev" || !url.pathname.startsWith("/pets/")) throw new Error("Preview URL host/path is not allowed.");
+    if (url.hostname !== "familiaros.dev" || !url.pathname.startsWith("/familiars/")) throw new Error("Preview URL host/path is not allowed.");
   } else if (field === "catalog") {
-    if (url.hostname !== "openpets.dev" || !url.pathname.startsWith("/pets/catalog.v3/")) throw new Error("Catalog URL host/path is not allowed.");
-  } else if (url.hostname !== "zip.openpets.dev" || !url.pathname.startsWith("/pets/")) {
+    if (url.hostname !== "familiaros.dev" || !url.pathname.startsWith("/familiars/catalog.v3/")) throw new Error("Catalog URL host/path is not allowed.");
+  } else if (url.hostname !== "zip.familiaros.dev" || !url.pathname.startsWith("/familiars/")) {
     throw new Error("Zip URL host/path is not allowed.");
   }
 
diff --git a/apps/desktop/src/catalog.ts b/apps/desktop/src/catalog.ts
index 196e32bb..76fa7d3e 100644
--- a/apps/desktop/src/catalog.ts
+++ b/apps/desktop/src/catalog.ts
@@ -5,8 +5,8 @@ import { app } from "electron";
 
 import { validateCatalogV2, validateCatalogV3Index, validateCatalogV3Page, validateCatalogV3SearchIndex, validateCatalogV3SearchPage, type CatalogPetV2, type CatalogV2, type CatalogV3Index, type CatalogV3SearchPet } from "./catalog-validation.js";
 
-export const catalogUrl = "https://openpets.dev/pets/catalog.v2.json";
-export const catalogV3Url = "https://openpets.dev/pets/catalog.v3.json";
+export const catalogUrl = "https://familiaros.dev/familiars/catalog.v2.json";
+export const catalogV3Url = "https://familiaros.dev/familiars/catalog.v3.json";
 const fixtureRelativePath = "catalog.v2.fixture.json";
 const maxCatalogBytes = 1_000_000;
 const maxCatalogV3PageBytes = 256_000;
@@ -14,7 +14,7 @@ const fetchTimeoutMs = 5_000;
 
 export interface CatalogUiState {
   readonly source: "remote" | "fixture" | "error";
-  readonly pets: readonly CatalogPetV2[];
+  readonly familiars: readonly CatalogPetV2[];
   readonly generatedAt?: string;
   readonly error?: string;
   readonly version?: 2 | 3;
@@ -29,7 +29,7 @@ export interface CatalogUiState {
 
 export interface CatalogSearchUiState {
   readonly source: "remote" | "error";
-  readonly pets: readonly CatalogV3SearchPet[];
+  readonly familiars: readonly CatalogV3SearchPet[];
   readonly total?: number;
   readonly error?: string;
 }
@@ -47,7 +47,7 @@ export async function getCatalogUiState(): Promise<CatalogUiState> {
     if (!firstPage.ok) return await getV2OrFixtureCatalogUiState(`v3 page unavailable: ${firstPage.error}`);
     return {
       source: "remote",
-      pets: filterSurfaceablePets(firstPage.pets),
+      familiars: filterSurfaceablePets(firstPage.familiars),
       generatedAt: remoteV3.index.generatedAt,
       version: 3,
       total: surfaceableTotal(remoteV3.index),
@@ -66,14 +66,14 @@ export async function getCatalogUiState(): Promise<CatalogUiState> {
 export async function getCatalogPageUiState(page: number): Promise<CatalogUiState> {
   if (!Number.isInteger(page) || page < 0) throw new Error("Catalog page must be a non-negative integer.");
   const remoteV3 = await tryLoadRemoteCatalogV3Index();
-  if (!remoteV3.ok) return { source: "error", pets: [], error: remoteV3.error };
+  if (!remoteV3.ok) return { source: "error", familiars: [], error: remoteV3.error };
   if (page >= surfaceablePageCount(remoteV3.index)) throw new Error("Catalog page is out of range.");
   const pageResult = await tryLoadSurfaceableCatalogV3Page(page, remoteV3.index);
-  if (!pageResult.ok) return { source: "error", pets: [], error: pageResult.error };
+  if (!pageResult.ok) return { source: "error", familiars: [], error: pageResult.error };
 
   return {
     source: "remote",
-    pets: filterSurfaceablePets(pageResult.pets),
+    familiars: filterSurfaceablePets(pageResult.familiars),
     generatedAt: remoteV3.index.generatedAt,
     version: 3,
     total: surfaceableTotal(remoteV3.index),
@@ -88,13 +88,13 @@ export async function getCatalogPageUiState(page: number): Promise<CatalogUiStat
 
 export async function getCatalogSearchUiState(): Promise<CatalogSearchUiState> {
   const remoteV3 = await tryLoadRemoteCatalogV3Index();
-  if (!remoteV3.ok) return { source: "error", pets: [], error: remoteV3.error };
+  if (!remoteV3.ok) return { source: "error", familiars: [], error: remoteV3.error };
 
   try {
     const surfacedPets = getSurfaceableSearchPets(await getRemoteCatalogV3Search(remoteV3.index), remoteV3.index);
-    return { source: "remote", pets: surfacedPets, total: surfacedPets.length };
+    return { source: "remote", familiars: surfacedPets, total: surfacedPets.length };
   } catch (error) {
-    return { source: "error", pets: [], error: error instanceof Error ? error.message : "unknown error" };
+    return { source: "error", familiars: [], error: error instanceof Error ? error.message : "unknown error" };
   }
 }
 
@@ -104,26 +104,26 @@ export async function getCatalogPet(petId: string): Promise<CatalogPetV2> {
     let blockedHiddenV3Pet = false;
     try {
       const searchPets = await getRemoteCatalogV3Search(remoteV3.index);
-      const searchPet = searchPets.find((pet) => pet.id === petId);
+      const searchPet = searchPets.find((familiar) => familiar.id === petId);
       if (searchPet && !isSurfaceablePet(searchPet)) {
         blockedHiddenV3Pet = true;
-        throw new Error(`Pet is not available in the curated catalog: ${petId}`);
+        throw new Error(`Familiar is not available in the curated catalog: ${petId}`);
       }
       if (searchPet) {
         const page = await getRemoteCatalogV3Page(searchPet.catalogPage, remoteV3.index);
-        const pet = page.find((candidate) => candidate.id === petId);
-        if (pet && isSurfaceablePet(pet)) return pet;
+        const familiar = page.find((candidate) => candidate.id === petId);
+        if (familiar && isSurfaceablePet(familiar)) return familiar;
       }
     } catch (error) {
       if (blockedHiddenV3Pet) throw error;
-      // Fall through to v2/fixture so visible v2-compatible pets remain installable during partial v3 outages.
+      // Fall through to v2/fixture so visible v2-compatible familiars remain installable during partial v3 outages.
     }
   }
 
   const catalog = await getV2CatalogOrFixture();
-  const pet = filterSurfaceablePets(catalog.pets).find((candidate) => candidate.id === petId);
-  if (!pet) throw new Error(`Pet is not available in the validated catalog: ${petId}`);
-  return pet;
+  const familiar = filterSurfaceablePets(catalog.familiars).find((candidate) => candidate.id === petId);
+  if (!familiar) throw new Error(`Familiar is not available in the validated catalog: ${petId}`);
+  return familiar;
 }
 
 async function getV2OrFixtureCatalogUiState(remoteV3Error: string): Promise<CatalogUiState> {
@@ -133,10 +133,10 @@ async function getV2OrFixtureCatalogUiState(remoteV3Error: string): Promise<Cata
   if (remote.ok) {
     return {
       source: "remote",
-      pets: filterSurfaceablePets(remote.catalog.pets),
+      familiars: filterSurfaceablePets(remote.catalog.familiars),
       generatedAt: remote.catalog.generatedAt,
       version: 2,
-      total: filterSurfaceablePets(remote.catalog.pets).length,
+      total: filterSurfaceablePets(remote.catalog.familiars).length,
       supportsCategories: false,
     };
   }
@@ -146,33 +146,33 @@ async function getV2OrFixtureCatalogUiState(remoteV3Error: string): Promise<Cata
   if (fixture.ok) {
     return {
       source: "fixture",
-      pets: filterSurfaceablePets(fixture.catalog.pets),
+      familiars: filterSurfaceablePets(fixture.catalog.familiars),
       generatedAt: fixture.catalog.generatedAt,
       error: `Catalog unavailable: ${remoteV3Error}; v2 unavailable: ${remote.error}`,
       version: 2,
-      total: filterSurfaceablePets(fixture.catalog.pets).length,
+      total: filterSurfaceablePets(fixture.catalog.familiars).length,
       supportsCategories: false,
     };
   }
 
   return {
     source: "error",
-    pets: [],
+    familiars: [],
     error: `Catalog unavailable: ${remoteV3Error}; v2 unavailable: ${remote.error}. Fixture unavailable: ${fixture.error}`,
   };
 }
 
-function filterSurfaceablePets<T extends { readonly original?: boolean; readonly featured?: boolean }>(pets: readonly T[]): readonly T[] {
-  return pets.filter(isSurfaceablePet);
+function filterSurfaceablePets<T extends { readonly original?: boolean; readonly featured?: boolean }>(familiars: readonly T[]): readonly T[] {
+  return familiars.filter(isSurfaceablePet);
 }
 
-function isSurfaceablePet(pet: { readonly original?: boolean; readonly featured?: boolean }): boolean {
-  return pet.original === true || pet.featured === true;
+function isSurfaceablePet(familiar: { readonly original?: boolean; readonly featured?: boolean }): boolean {
+  return familiar.original === true || familiar.featured === true;
 }
 
-function getSurfaceableSearchPets(pets: readonly CatalogV3SearchPet[], index: CatalogV3Index): readonly CatalogV3SearchPet[] {
-  return filterSurfaceablePets(pets).map((pet, surfaceIndex) => ({
-    ...pet,
+function getSurfaceableSearchPets(familiars: readonly CatalogV3SearchPet[], index: CatalogV3Index): readonly CatalogV3SearchPet[] {
+  return filterSurfaceablePets(familiars).map((familiar, surfaceIndex) => ({
+    ...familiar,
     catalogPage: Math.floor(surfaceIndex / index.pageSize),
   }));
 }
@@ -194,23 +194,23 @@ async function tryLoadRemoteCatalogV3Index(): Promise<{ readonly ok: true; reado
   }
 }
 
-async function tryLoadRemoteCatalogV3Page(page: number, index: CatalogV3Index): Promise<{ readonly ok: true; readonly pets: readonly CatalogPetV2[] } | { readonly ok: false; readonly error: string }> {
+async function tryLoadRemoteCatalogV3Page(page: number, index: CatalogV3Index): Promise<{ readonly ok: true; readonly familiars: readonly CatalogPetV2[] } | { readonly ok: false; readonly error: string }> {
   try {
-    return { ok: true, pets: await getRemoteCatalogV3Page(page, index) };
+    return { ok: true, familiars: await getRemoteCatalogV3Page(page, index) };
   } catch (error) {
     return { ok: false, error: error instanceof Error ? error.message : "unknown error" };
   }
 }
 
-async function tryLoadSurfaceableCatalogV3Page(page: number, index: CatalogV3Index): Promise<{ readonly ok: true; readonly pets: readonly CatalogPetV2[] } | { readonly ok: false; readonly error: string }> {
+async function tryLoadSurfaceableCatalogV3Page(page: number, index: CatalogV3Index): Promise<{ readonly ok: true; readonly familiars: readonly CatalogPetV2[] } | { readonly ok: false; readonly error: string }> {
   try {
     const searchPets = filterSurfaceablePets(await getRemoteCatalogV3Search(index));
     const pageSearchPets = searchPets.slice(page * index.pageSize, (page + 1) * index.pageSize);
-    const ids = new Set(pageSearchPets.map((pet) => pet.id));
-    const catalogPageNumbers = [...new Set(pageSearchPets.map((pet) => pet.catalogPage))];
+    const ids = new Set(pageSearchPets.map((familiar) => familiar.id));
+    const catalogPageNumbers = [...new Set(pageSearchPets.map((familiar) => familiar.catalogPage))];
     const catalogPages = await Promise.all(catalogPageNumbers.map((catalogPage) => getRemoteCatalogV3Page(catalogPage, index)));
-    const petsById = new Map(catalogPages.flat().filter((pet) => ids.has(pet.id) && isSurfaceablePet(pet)).map((pet) => [pet.id, pet]));
-    return { ok: true, pets: pageSearchPets.map((pet) => petsById.get(pet.id)).filter((pet): pet is CatalogPetV2 => Boolean(pet)) };
+    const petsById = new Map(catalogPages.flat().filter((familiar) => ids.has(familiar.id) && isSurfaceablePet(familiar)).map((familiar) => [familiar.id, familiar]));
+    return { ok: true, familiars: pageSearchPets.map((familiar) => petsById.get(familiar.id)).filter((familiar): familiar is CatalogPetV2 => Boolean(familiar)) };
   } catch (error) {
     return { ok: false, error: error instanceof Error ? error.message : "unknown error" };
   }
@@ -227,38 +227,38 @@ async function getRemoteCatalogV3Page(page: number, index: CatalogV3Index): Prom
   const pageUrl = index.pages[page];
   if (!pageUrl) throw new Error("Catalog page is out of range.");
   const payload = validateCatalogV3Page(JSON.parse(await fetchLimitedText(pageUrl, maxCatalogV3PageBytes)) as unknown, page);
-  const pets = payload.pets.map(toCatalogPetV2Compat);
-  assertUniquePetIds(pets);
-  v3PageCache.set(page, pets);
-  return pets;
+  const familiars = payload.familiars.map(toCatalogPetV2Compat);
+  assertUniquePetIds(familiars);
+  v3PageCache.set(page, familiars);
+  return familiars;
 }
 
 async function getRemoteCatalogV3Search(index: CatalogV3Index): Promise<readonly CatalogV3SearchPet[]> {
   v3SearchPromise ||= Promise.resolve().then(async () => {
     const searchIndex = validateCatalogV3SearchIndex(JSON.parse(await fetchLimitedText(index.search, maxCatalogV3PageBytes)) as unknown);
     const pages = await Promise.all(searchIndex.pages.map(async (pageUrl, page) => validateCatalogV3SearchPage(JSON.parse(await fetchLimitedText(pageUrl, maxCatalogV3PageBytes)) as unknown, page, index.pages.length)));
-    const pets = pages.flatMap((page) => page.pets);
-    if (pets.length !== index.total) throw new Error("Catalog v3 search total does not match index total.");
-    return pets;
+    const familiars = pages.flatMap((page) => page.familiars);
+    if (familiars.length !== index.total) throw new Error("Catalog v3 search total does not match index total.");
+    return familiars;
   });
   return await v3SearchPromise;
 }
 
-function toCatalogPetV2Compat(pet: { readonly id: string; readonly displayName: string; readonly description: string; readonly thumbnail: string; readonly spritesheet: string; readonly zip: string; readonly category: "western" | "asian"; readonly subcategory?: string; readonly original?: boolean; readonly featured?: boolean }): CatalogPetV2 {
+function toCatalogPetV2Compat(familiar: { readonly id: string; readonly displayName: string; readonly description: string; readonly thumbnail: string; readonly spritesheet: string; readonly zip: string; readonly category: "western" | "asian"; readonly subcategory?: string; readonly original?: boolean; readonly featured?: boolean }): CatalogPetV2 {
   const entry: CatalogPetV2 = {
-    id: pet.id,
-    displayName: pet.displayName,
-    description: pet.description,
-    preview: pet.thumbnail,
-    spritesheet: pet.spritesheet,
-    zip: pet.zip,
-    category: pet.category,
+    id: familiar.id,
+    displayName: familiar.displayName,
+    description: familiar.description,
+    preview: familiar.thumbnail,
+    spritesheet: familiar.spritesheet,
+    zip: familiar.zip,
+    category: familiar.category,
   };
   return {
     ...entry,
-    ...(pet.subcategory ? { subcategory: pet.subcategory } : {}),
-    ...(pet.original === undefined ? {} : { original: pet.original }),
-    ...(pet.featured === undefined ? {} : { featured: pet.featured }),
+    ...(familiar.subcategory ? { subcategory: familiar.subcategory } : {}),
+    ...(familiar.original === undefined ? {} : { original: familiar.original }),
+    ...(familiar.featured === undefined ? {} : { featured: familiar.featured }),
   };
 }
 
@@ -349,10 +349,10 @@ function validateCatalogEndpoint(value: string, expected: string): void {
   if (url.href !== expected) throw new Error("Catalog final URL is not allowed.");
 }
 
-function assertUniquePetIds(pets: readonly CatalogPetV2[]): void {
+function assertUniquePetIds(familiars: readonly CatalogPetV2[]): void {
   const ids = new Set<string>();
-  for (const pet of pets) {
-    if (ids.has(pet.id)) throw new Error(`Duplicate catalog v3 pet id: ${pet.id}`);
-    ids.add(pet.id);
+  for (const familiar of familiars) {
+    if (ids.has(familiar.id)) throw new Error(`Duplicate catalog v3 familiar id: ${familiar.id}`);
+    ids.add(familiar.id);
   }
 }
diff --git a/apps/desktop/src/check-cursor-desktop.ts b/apps/desktop/src/check-cursor-desktop.ts
index cb5c5e04..d49a5e74 100644
--- a/apps/desktop/src/check-cursor-desktop.ts
+++ b/apps/desktop/src/check-cursor-desktop.ts
@@ -4,9 +4,9 @@ import { join } from "node:path";
 import { tmpdir } from "node:os";
 
 // Desktop-specific Cursor integration checks
-// These verify that the desktop app correctly uses the @open-pets/cursor package
+// These verify that the desktop app correctly uses the @familiaros/cursor package
 
-const root = realpathSync(mkdtempSync(join(tmpdir(), "openpets-cursor-desktop-")));
+const root = realpathSync(mkdtempSync(join(tmpdir(), "familiaros-cursor-desktop-")));
 
 try {
   // Test that desktop would use the correct global config path
@@ -29,10 +29,10 @@ try {
   const configPath = join(cursorDir, "mcp.json");
   const installedConfig = {
     mcpServers: {
-      openpets: {
+      familiaros: {
         type: "stdio",
         command: "npx",
-        args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"],
+        args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"],
       },
     },
   };
@@ -40,12 +40,12 @@ try {
   
   const content = readFileSync(configPath, "utf8");
   const parsed = JSON.parse(content);
-  assert.deepEqual(parsed.mcpServers.openpets, installedConfig.mcpServers.openpets);
+  assert.deepEqual(parsed.mcpServers.familiaros, installedConfig.mcpServers.familiaros);
 
   // Test that desktop would preserve unrelated servers during operations
   const multiServerConfig = {
     mcpServers: {
-      openpets: installedConfig.mcpServers.openpets,
+      familiaros: installedConfig.mcpServers.familiaros,
       other: { type: "stdio", command: "test", args: [] },
     },
     topLevelField: "preserve",
@@ -61,7 +61,7 @@ try {
   const publishedEntry = {
     type: "stdio",
     command: "npx",
-    args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "test"],
+    args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "test"],
   };
   assert.equal(publishedEntry.command, "npx");
   assert.ok(publishedEntry.args[1].includes("@"), "Published mode must use pinned version");
@@ -69,7 +69,7 @@ try {
   const localEntry = {
     type: "stdio",
     command: "node",
-    args: ["/absolute/path/to/mcp.js", "--pet", "test"],
+    args: ["/absolute/path/to/mcp.js", "--familiar", "test"],
   };
   assert.equal(localEntry.command, "node");
   assert.ok(localEntry.args[0].startsWith("/"), "Local mode must use absolute path");
@@ -113,24 +113,24 @@ try {
   // Test that desktop would create valid MCP preview
   const preview = {
     mcpServers: {
-      openpets: {
+      familiaros: {
         type: "stdio",
         command: "npx",
-        args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"],
+        args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"],
       },
     },
   };
-  assert.equal(preview.mcpServers.openpets.type, "stdio");
-  assert.equal(preview.mcpServers.openpets.command, "npx");
-  assert.ok(Array.isArray(preview.mcpServers.openpets.args));
+  assert.equal(preview.mcpServers.familiaros.type, "stdio");
+  assert.equal(preview.mcpServers.familiaros.command, "npx");
+  assert.ok(Array.isArray(preview.mcpServers.familiaros.args));
 
   // Test desktop Phase 2 rules posture: preview/copy only, no project writes
   const rulesPreview = {
-    rulesPath: ".cursor/rules/openpets.mdc",
-    rulesContent: "<!-- OPENPETS:CURSOR_RULES:START -->\nUse OpenPets sparingly.\n<!-- OPENPETS:CURSOR_RULES:END -->\n",
+    rulesPath: ".cursor/rules/familiaros.mdc",
+    rulesContent: "<!-- FAMILIAROS:CURSOR_RULES:START -->\nUse FamiliarOS sparingly.\n<!-- FAMILIAROS:CURSOR_RULES:END -->\n",
   };
-  assert.equal(rulesPreview.rulesPath, ".cursor/rules/openpets.mdc");
-  assert.match(rulesPreview.rulesContent, /OPENPETS:CURSOR_RULES:START/);
+  assert.equal(rulesPreview.rulesPath, ".cursor/rules/familiaros.mdc");
+  assert.match(rulesPreview.rulesContent, /FAMILIAROS:CURSOR_RULES:START/);
   assert.doesNotMatch(rulesPreview.rulesContent, /alwaysApply:\s*true/);
 
   console.error("Cursor desktop validation passed.");
diff --git a/apps/desktop/src/check-opencode-desktop-setup.ts b/apps/desktop/src/check-opencode-desktop-setup.ts
index 9c3aa079..71b275fd 100644
--- a/apps/desktop/src/check-opencode-desktop-setup.ts
+++ b/apps/desktop/src/check-opencode-desktop-setup.ts
@@ -3,14 +3,14 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 
-import { mapAsarPathToUnpacked } from "@open-pets/claude";
-import { doctorOpenCodeGlobalSetup, parseOpenCodeConfig, prepareOpenCodeGlobalRemove, prepareOpenCodeGlobalSetup, writePreparedOpenCodeGlobalRemove, writePreparedOpenCodeGlobalSetup } from "@open-pets/opencode";
+import { mapAsarPathToUnpacked } from "@familiaros/claude";
+import { doctorOpenCodeGlobalSetup, parseOpenCodeConfig, prepareOpenCodeGlobalRemove, prepareOpenCodeGlobalSetup, writePreparedOpenCodeGlobalRemove, writePreparedOpenCodeGlobalSetup } from "@familiaros/opencode";
 
-const root = mkdtempSync(join(tmpdir(), "openpets-desktop-opencode-"));
+const root = mkdtempSync(join(tmpdir(), "familiaros-desktop-opencode-"));
 
 try {
   const globalDir = join(root, "opencode-global");
-  const bundledCli = mapAsarPathToUnpacked(join(root, "OpenPets.app", "Contents", "Resources", "app.asar", "node_modules", "@open-pets", "cli", "dist", "index.js"));
+  const bundledCli = mapAsarPathToUnpacked(join(root, "FamiliarOS.app", "Contents", "Resources", "app.asar", "node_modules", "@familiaros", "cli", "dist", "index.js"));
 
   assert.equal(doctorOpenCodeGlobalSetup(globalDir).status, "not_installed");
 
@@ -24,20 +24,20 @@ try {
   });
 
   assert.equal(install.configPath, join(globalDir, "opencode.jsonc"));
-  assert.equal(install.instructionPath, join(globalDir, "openpets.md"));
+  assert.equal(install.instructionPath, join(globalDir, "familiaros.md"));
   assert.match(install.configWrite.content, /app\.asar\.unpacked/);
   assert.doesNotMatch(install.configWrite.content, /app\.asar(?!\.unpacked)/);
-  assert.match(install.configWrite.content, /@open-pets\/opencode@4\.5\.6/);
+  assert.match(install.configWrite.content, /@familiaros\/opencode@4\.5\.6/);
 
   const preview = parseOpenCodeConfig(install.configWrite.content);
   assert.equal(preview.ok, true, "desktop OpenCode preview must parse as JSONC without JSON.parse.");
-  const previewConfig = preview.value as { readonly mcp?: { readonly openpets?: { readonly command?: readonly string[] } }; readonly plugin?: readonly unknown[] };
-  assert.deepEqual(previewConfig.mcp?.openpets?.command, ["node", bundledCli, "mcp", "--pet", "fixer"]);
-  assert.deepEqual(previewConfig.plugin, [["@open-pets/opencode@4.5.6", { pet: "fixer" }]]);
+  const previewConfig = preview.value as { readonly mcp?: { readonly familiaros?: { readonly command?: readonly string[] } }; readonly plugin?: readonly unknown[] };
+  assert.deepEqual(previewConfig.mcp?.familiaros?.command, ["node", bundledCli, "mcp", "--familiar", "fixer"]);
+  assert.deepEqual(previewConfig.plugin, [["@familiaros/opencode@4.5.6", { familiar: "fixer" }]]);
 
   writePreparedOpenCodeGlobalSetup(install);
   assert.equal(doctorOpenCodeGlobalSetup(globalDir).status, "installed");
-  assert.match(readFileSync(join(globalDir, "openpets.md"), "utf8"), /OPENPETS:START/);
+  assert.match(readFileSync(join(globalDir, "familiaros.md"), "utf8"), /FAMILIAROS:START/);
 
   const remove = prepareOpenCodeGlobalRemove(globalDir);
   assert.equal(remove.configWrites.length, 1);
diff --git a/apps/desktop/src/check-packaging-contract.ts b/apps/desktop/src/check-packaging-contract.ts
index 30f3ad1d..ce619c9e 100644
--- a/apps/desktop/src/check-packaging-contract.ts
+++ b/apps/desktop/src/check-packaging-contract.ts
@@ -16,26 +16,26 @@ const workspaceConfig = readFileSync(join(repoRoot, "pnpm-workspace.yaml"), "utf
 const builderConfigPath = join(appDir, "electron-builder.yml");
 const builderConfig = readFileSync(builderConfigPath, "utf8");
 
-assert.equal(packageJson.description, "OpenPets tray-first desktop companion app.");
-assert.equal(packageJson.author, "OpenPets");
-assert.match(packageJson.scripts?.["dev:debug"] ?? "", /OPENPETS_LOG_LEVEL=debug OPENPETS_LOG_CONSOLE=1 pnpm dev/, "desktop debug dev script must enable verbose log mirroring.");
+assert.equal(packageJson.description, "FamiliarOS tray-first desktop companion app.");
+assert.equal(packageJson.author, "FamiliarOS");
+assert.match(packageJson.scripts?.["dev:debug"] ?? "", /FAMILIAROS_LOG_LEVEL=debug FAMILIAROS_LOG_CONSOLE=1 pnpm dev/, "desktop debug dev script must enable verbose log mirroring.");
 assert.match(packageJson.scripts?.package ?? "", /node scripts\/clean-package-output\.cjs && electron-builder/);
 assert.match(packageJson.scripts?.["package:dir"] ?? "", /node scripts\/clean-package-output\.cjs && electron-builder --dir/);
-assert.equal(rootPackageJson.scripts?.["package:desktop:dir"], "pnpm build && pnpm --filter @open-pets/desktop package:dir");
-assert.equal(packageJson.dependencies?.["@open-pets/claude"], "workspace:*");
-assert.equal(packageJson.dependencies?.["@open-pets/cli"], "workspace:*");
-assert.equal(packageJson.dependencies?.["@open-pets/cursor"], "workspace:*");
-assert.equal(packageJson.dependencies?.["@open-pets/mcp"], "workspace:*");
-assert.equal(packageJson.dependencies?.["@open-pets/opencode"], "workspace:*");
-assert.equal(packageJson.dependencies?.["@open-pets/agent-events"], "workspace:*");
+assert.equal(rootPackageJson.scripts?.["package:desktop:dir"], "pnpm build && pnpm --filter @familiaros/desktop package:dir");
+assert.equal(packageJson.dependencies?.["@familiaros/claude"], "workspace:*");
+assert.equal(packageJson.dependencies?.["@familiaros/cli"], "workspace:*");
+assert.equal(packageJson.dependencies?.["@familiaros/cursor"], "workspace:*");
+assert.equal(packageJson.dependencies?.["@familiaros/mcp"], "workspace:*");
+assert.equal(packageJson.dependencies?.["@familiaros/opencode"], "workspace:*");
+assert.equal(packageJson.dependencies?.["@familiaros/agent-events"], "workspace:*");
 assert.equal(packageJson.dependencies?.["@img/sharp-win32-x64"], undefined, "sharp platform binaries must stay optional transitive deps, not direct host-breaking dependencies.");
 assert.match(workspaceConfig, /supportedArchitectures:[\s\S]*?os:[\s\S]*?- darwin[\s\S]*?- win32[\s\S]*?- linux/, "pnpm must install optional sharp binaries for desktop release OS targets.");
 assert.match(workspaceConfig, /supportedArchitectures:[\s\S]*?cpu:[\s\S]*?- x64[\s\S]*?- arm64/, "pnpm must install optional sharp binaries for desktop release CPU targets.");
 assert.match(workspaceConfig, /supportedArchitectures:[\s\S]*?libc:[\s\S]*?- glibc/, "pnpm must install optional sharp binaries for Linux glibc release targets.");
 assert.match(packageJson.devDependencies?.["electron-builder"] ?? "", /^\^26\.(?:9|[1-9]\d)\./, "desktop AppImage packaging must use electron-builder 26.9+ for conditional Linux sandbox handling.");
-assert.match(builderConfig, /appId:\s*dev\.openpets\.app/);
-assert.match(builderConfig, /productName:\s*OpenPets/);
-assert.match(builderConfig, /executableName:\s*openpets/, "desktop packages must use a safe executable name for the stricter AppImage toolset.");
+assert.match(builderConfig, /appId:\s*dev\.familiaros\.app/);
+assert.match(builderConfig, /productName:\s*FamiliarOS/);
+assert.match(builderConfig, /executableName:\s*familiaros/, "desktop packages must use a safe executable name for the stricter AppImage toolset.");
 assert.match(builderConfig, /output:\s*dist-electron/);
 assert.match(builderConfig, /linux:[\s\S]*?target:[\s\S]*?- AppImage[\s\S]*?- deb[\s\S]*?- rpm[\s\S]*?- tar\.gz/, "desktop Linux packaging must include AppImage, deb, rpm, and tar.gz targets.");
 assert.match(builderConfig, /publish:\s*null/);
@@ -46,7 +46,7 @@ assert.match(builderConfig, /asarUnpack:/);
 assert.match(builderConfig, /node_modules\/\*\*/);
 assert.match(builderConfig, /dist\/\*\*/);
 assert.match(builderConfig, /control-center-preload\.cjs/);
-assert.match(builderConfig, /pet-preload\.cjs/);
+assert.match(builderConfig, /familiar-preload\.cjs/);
 assert.match(builderConfig, /prompt-window-preload\.cjs/);
 assert.match(builderConfig, /plugin-sdk-preload\.cjs/);
 assert.match(builderConfig, /plugin-command-form-preload\.cjs/);
@@ -55,23 +55,23 @@ assert.match(builderConfig, /extraResources:[\s\S]*from:\s*\.\.\/\.\.\/plugins\/
 assert.match(builderConfig, /icon:\s*assets\/app-icon\.icns/);
 
 assert.ok(existsSync(join(appDir, "control-center-preload.cjs")), "control-center-preload.cjs must exist for Control Center IPC.");
-assert.ok(existsSync(join(appDir, "pet-preload.cjs")), "pet-preload.cjs must exist for pet window motion state updates.");
+assert.ok(existsSync(join(appDir, "familiar-preload.cjs")), "familiar-preload.cjs must exist for familiar window motion state updates.");
 assert.ok(existsSync(join(appDir, "prompt-window-preload.cjs")), "prompt-window-preload.cjs must exist for the floating prompt window IPC.");
 assert.ok(existsSync(join(appDir, "plugin-sdk-preload.cjs")), "plugin-sdk-preload.cjs must exist for JavaScript plugin SDK hosting.");
 assert.ok(existsSync(join(appDir, "plugin-command-form-preload.cjs")), "plugin-command-form-preload.cjs must exist for plugin command forms.");
 assert.ok(existsSync(join(appDir, "assets", "tray-icon.png")), "tray icon must exist for packaging.");
 assert.ok(existsSync(join(appDir, "assets", "app-icon.icns")), "app icon must exist for packaging.");
 assert.ok(existsSync(join(appDir, "assets", "app-icon.ico")), "Windows app icon must exist for packaging.");
-assertNonEmptyFile(join(appDir, "assets", "default-pet-spritesheet.webp"), "default pet spritesheet must exist for packaging.");
-assertNonEmptyFile(join(appDir, "assets", "default-pet-thumbnail.png"), "default pet thumbnail must exist for Pet Manager preview.");
+assertNonEmptyFile(join(appDir, "assets", "default-familiar-spritesheet.webp"), "default familiar spritesheet must exist for packaging.");
+assertNonEmptyFile(join(appDir, "assets", "default-familiar-thumbnail.png"), "default familiar thumbnail must exist for Familiar Manager preview.");
 for (const icon of ["claude.svg", "cursor.svg", "opencode.svg", "pi.svg", "vscode.svg", "windsurf.svg", "zed.svg"]) {
   assertSafeBundledSvg(join(appDir, "assets", "integrations", icon), `integration icon must be safe and packaged: ${icon}`);
 }
 assert.match(readFileSync(join(appDir, "src", "assets.ts"), "utf8"), /assets["']?,\s*["']tray-icon\.png|join\("assets", "tray-icon\.png"\)/, "tray icon code must keep using assets/tray-icon.png.");
-const petWindowSource = readFileSync(join(appDir, "src", "pet-window.ts"), "utf8");
+const petWindowSource = readFileSync(join(appDir, "src", "familiar-window.ts"), "utf8");
 const controlCenterPreloadSource = readFileSync(join(appDir, "control-center-preload.cjs"), "utf8");
 const controlCenterRendererSource = readFileSync(join(appDir, "src", "renderer", "src", "main.tsx"), "utf8");
-const petPreloadSource = readFileSync(join(appDir, "pet-preload.cjs"), "utf8");
+const petPreloadSource = readFileSync(join(appDir, "familiar-preload.cjs"), "utf8");
 const promptWindowPreloadSource = readFileSync(join(appDir, "prompt-window-preload.cjs"), "utf8");
 const reactionMessagesSource = readFileSync(join(appDir, "src", "reaction-messages.ts"), "utf8");
 const displaySource = readFileSync(join(appDir, "src", "display.ts"), "utf8");
@@ -86,103 +86,103 @@ const mainSource = readFileSync(join(appDir, "src", "main.ts"), "utf8");
 const localIpcSourceForLogging = readFileSync(join(appDir, "src", "local-ipc.ts"), "utf8");
 const localIpcPathsSource = readFileSync(join(appDir, "src", "local-ipc-paths.ts"), "utf8");
 const leaseManagerSource = readFileSync(join(appDir, "src", "lease-manager.ts"), "utf8");
-const defaultPetControllerSource = readFileSync(join(appDir, "src", "default-pet-controller.ts"), "utf8");
-const agentPetControllerSourceForLogging = readFileSync(join(appDir, "src", "agent-pet-controller.ts"), "utf8");
+const defaultPetControllerSource = readFileSync(join(appDir, "src", "default-familiar-controller.ts"), "utf8");
+const agentPetControllerSourceForLogging = readFileSync(join(appDir, "src", "agent-familiar-controller.ts"), "utf8");
 const mappingDoc = readFileSync(join(repoRoot, "docs", "mapping.md"), "utf8");
-assert.match(loggerSource, /openpets\.log/, "desktop logger must write a user-sendable openpets.log file.");
-assert.match(loggerSource, /openpets\.previous\.log/, "desktop logger must retain a previous log file for bug reports.");
-assert.match(loggerSource, /OPENPETS_LOG_LEVEL/, "desktop logger must support verbose dev logging via environment.");
-assert.match(loggerSource, /normalizeLogLevel\(process\.env\.OPENPETS_LOG_LEVEL\) \?\? "debug"/, "desktop production logger must default to debug for user-sendable diagnostics.");
+assert.match(loggerSource, /familiaros\.log/, "desktop logger must write a user-sendable familiaros.log file.");
+assert.match(loggerSource, /familiaros\.previous\.log/, "desktop logger must retain a previous log file for bug reports.");
+assert.match(loggerSource, /FAMILIAROS_LOG_LEVEL/, "desktop logger must support verbose dev logging via environment.");
+assert.match(loggerSource, /normalizeLogLevel\(process\.env\.FAMILIAROS_LOG_LEVEL\) \?\? "debug"/, "desktop production logger must default to debug for user-sendable diagnostics.");
 assert.match(loggerSource, /redacted-token/, "desktop logger must redact token-looking values.");
 assert.match(mainSource, /initializeLogger\(\)/, "desktop startup must initialize logging before subsystem startup.");
-assert.match(mainSource, /process\.platform === "linux"[\s\S]*?appendSwitch\("ozone-platform", "x11"\)/, "Linux desktop pets must prefer X11/Xwayland because GNOME Wayland blocks always-on-top and programmatic window dragging.");
+assert.match(mainSource, /process\.platform === "linux"[\s\S]*?appendSwitch\("ozone-platform", "x11"\)/, "Linux desktop familiars must prefer X11/Xwayland because GNOME Wayland blocks always-on-top and programmatic window dragging.");
 assert.match(mainSource, /hasSwitch\("ozone-platform"\)/, "Linux X11 preference must let users override Electron's Ozone backend explicitly.");
 assert.match(traySource, /t\("tray\.openLogsFolder"\)/, "desktop tray must expose user-sendable logs for bug reports.");
 assert.match(enCatalogSource, /Open Logs Folder/, "English catalog must keep the user-sendable logs label.");
 assert.match(localIpcSourceForLogging, /request received/, "desktop IPC must log request methods for diagnostics.");
-assert.match(localIpcPathsSource, /OPENPETS_IPC_BIND[\s\S]*?OPENPETS_IPC_ENDPOINT[\s\S]*?validateBindHost[\s\S]*?validateAdvertisedHost/, "WSL NAT IPC must separate bind and advertised endpoints with validation.");
-assert.match(localIpcPathsSource, /OPENPETS_IPC_ENDPOINT only controls the advertised discovery endpoint[\s\S]*?OPENPETS_IPC_BIND to opt into TCP IPC listening/, "OPENPETS_IPC_ENDPOINT-only mode must not start TCP listening; OPENPETS_IPC_BIND is the explicit TCP opt-in.");
-assert.match(localIpcPathsSource, /OPENPETS_IPC_ENDPOINT must use the same port as OPENPETS_IPC_BIND unless OPENPETS_IPC_BIND uses port 0/, "WSL NAT advertised endpoint must not silently override mismatched ports.");
+assert.match(localIpcPathsSource, /FAMILIAROS_IPC_BIND[\s\S]*?FAMILIAROS_IPC_ENDPOINT[\s\S]*?validateBindHost[\s\S]*?validateAdvertisedHost/, "WSL NAT IPC must separate bind and advertised endpoints with validation.");
+assert.match(localIpcPathsSource, /FAMILIAROS_IPC_ENDPOINT only controls the advertised discovery endpoint[\s\S]*?FAMILIAROS_IPC_BIND to opt into TCP IPC listening/, "FAMILIAROS_IPC_ENDPOINT-only mode must not start TCP listening; FAMILIAROS_IPC_BIND is the explicit TCP opt-in.");
+assert.match(localIpcPathsSource, /FAMILIAROS_IPC_ENDPOINT must use the same port as FAMILIAROS_IPC_BIND unless FAMILIAROS_IPC_BIND uses port 0/, "WSL NAT advertised endpoint must not silently override mismatched ports.");
 assert.match(leaseManagerSource, /acquired/, "lease manager must log lease acquisition details.");
-assert.match(defaultPetControllerSource, /show requested/, "default pet controller must log show lifecycle events.");
-assert.match(agentPetControllerSourceForLogging, /show requested/, "agent pet controller must log show lifecycle events.");
-assert.ok(petWindowSource.includes("defaultPetSprite.frameWidth * defaultPetSprite.columns") && petWindowSource.includes("defaultPetSprite.frameHeight * defaultPetSprite.rows"), "pet renderer must derive universal spritesheet dimensions from frame size and row/column counts.");
+assert.match(defaultPetControllerSource, /show requested/, "default familiar controller must log show lifecycle events.");
+assert.match(agentPetControllerSourceForLogging, /show requested/, "agent familiar controller must log show lifecycle events.");
+assert.ok(petWindowSource.includes("defaultPetSprite.frameWidth * defaultPetSprite.columns") && petWindowSource.includes("defaultPetSprite.frameHeight * defaultPetSprite.rows"), "familiar renderer must derive universal spritesheet dimensions from frame size and row/column counts.");
 for (const reaction of ["idle", "thinking", "working", "editing", "running", "testing", "waiting", "waving", "success", "error", "celebrating"]) {
   assert.match(reactionMessagesSource, new RegExp(`${reaction}:\\s*\\[`), `reaction messages must define a pool for: ${reaction}`);
 }
-assert.match(reactionMessagesSource, /satisfies Record<OpenPetsReaction, readonly string\[\]>/, "reaction-only bubble message pools must be exhaustive over OpenPetsReaction.");
+assert.match(reactionMessagesSource, /satisfies Record<FamiliarOSReaction, readonly string\[\]>/, "reaction-only bubble message pools must be exhaustive over FamiliarOSReaction.");
 assert.match(petWindowSource, /pickReactionMessage\(display\.reaction\b/, "reaction-only bubbles must render randomized messages instead of raw lowercase reaction ids.");
 assert.match(petWindowSource, /function preparePetTransientDisplay/, "reaction-only bubbles must prepare a stable random message before rerenders.");
 assert.match(petWindowSource, /function mergePetTransientDisplay/, "reaction-only events must not replace an active explicit message bubble.");
 assert.match(petWindowSource, /return \{ \.\.\.current, reaction: next\.reaction, dismissToken: next\.dismissToken \?\? current\.dismissToken \}/, "reaction-only updates merged into an active message must carry the latest dismiss token.");
 assert.match(petWindowSource, /function getTransientDisplayDurationMs[\s\S]*?12_000[\s\S]*?message\.length \* 70/, "speech bubbles must stay visible longer for longer messages without becoming permanent.");
-assert.match(defaultPetControllerSource, /getTransientDisplayDurationMs\(transientDisplay\)/, "default pet speech bubble timeout must be length-aware.");
-assert.match(agentPetControllerSourceForLogging, /getTransientDisplayDurationMs\(preparedDisplay\)/, "agent pet speech bubble timeout must be length-aware.");
+assert.match(defaultPetControllerSource, /getTransientDisplayDurationMs\(transientDisplay\)/, "default familiar speech bubble timeout must be length-aware.");
+assert.match(agentPetControllerSourceForLogging, /getTransientDisplayDurationMs\(preparedDisplay\)/, "agent familiar speech bubble timeout must be length-aware.");
 assert.match(petWindowSource, /function getTransientReactionAnimationMs/, "finite reaction animations must expose their own shorter lifetime.");
 assert.match(petWindowSource, /function clearTransientReaction/, "finite reaction animations must be clearable while the bubble remains visible.");
-assert.match(petWindowSource, /webContents\.send\("openpets:pet-reaction-state"/, "finite reaction animations must clear sprite state without reloading the bubble.");
-assert.match(petPreloadSource, /openpets:pet-reaction-state/, "pet preload must accept in-place reaction state updates.");
-assert.match(petWindowSource, /const webContents = window\.webContents[\s\S]*?const removeListeners = \(\): void => \{[\s\S]*?if \(!webContents\.isDestroyed\(\)\)/, "pet window cleanup must capture webContents and avoid touching destroyed BrowserWindow objects.");
-assert.match(petWindowSource, /window\.on\("close", removeListeners\);\s*window\.once\("closed", removeListeners\);/, "pet window cleanup must run before and after close so agent lease release and Cmd/Ctrl+W are idempotent.");
-assert.match(displaySource, /width:\s*220/, "pet windows must stay tightly bounded around pet and bubble.");
-assert.match(displaySource, /height:\s*320/, "pet windows must be tall enough for adaptive long message bubbles at large pet scale without becoming a huge click shield.");
-assert.match(petWindowSource, /function getBubbleClassName/, "pet bubbles must classify explicit messages by length.");
-assert.match(petWindowSource, /is-long-message/, "pet bubbles must have a long-message layout.");
-assert.match(petWindowSource, /is-very-long-message/, "pet bubbles must have a very-long-message layout for 140-character say messages.");
-assert.match(petWindowSource, /body \{ -webkit-app-region: no-drag; pointer-events: none; \}/, "transparent pet window background must not capture clicks or drags.");
-assert.match(petWindowSource, /function installMousePassthroughAndDrag/, "pet windows must install real mouse passthrough and controlled drag behavior.");
-assert.match(petWindowSource, /setIgnoreMouseEvents\(true, \{ forward: true \}\)/, "transparent pet window background must use OS-level mouse passthrough.");
-assert.match(petWindowSource, /setIgnoreMouseEvents\(false\)/, "visible pet and bubble hit targets must re-enable mouse handling.");
-assert.match(petWindowSource, /openpets:pet-ready/, "pet windows must resync passthrough after each renderer reload.");
-assert.match(petWindowSource, /function installMousePassthroughAndDrag[\s\S]*?const rearmPassthrough[\s\S]*?process\.platform !== "win32"[\s\S]*?rearmWindowsMouseForwarding\(reason\)/, "Windows pet reloads must toggle forwarded mouse passthrough to re-register hover and drag tracking.");
-assert.match(petWindowSource, /scheduleWindowsMouseForwardingRearm\(`\$\{reason\}\+75ms`, 75\);[\s\S]*?scheduleWindowsMouseForwardingRearm\(`\$\{reason\}\+175ms`, 175\);/, "Windows pet reloads must retry mouse forwarding rearm after load settles.");
-assert.match(petWindowSource, /openpets:pet-probe-hit-test/, "Windows pet reloads must probe current cursor hit target when mousemove forwarding is stale.");
-assert.match(petWindowSource, /export function recoverPetMouseInterop/, "pet windows must expose a controlled mouse interop recovery hook for OS display and resume events.");
-assert.match(petWindowSource, /petMouseInteropRecovery\.set\(window, scheduleMouseInteropRecovery\)/, "pet windows must register their mouse interop recovery callback.");
-assert.match(petWindowSource, /function installMousePassthroughAndDrag[\s\S]*?scheduleWindowsForwardingWatch[\s\S]*?rearmWindowsMouseForwarding\(reason, false\)[\s\S]*?scheduleWindowsForwardingWatch\(reason\)/, "Windows pet passthrough must keep rearming while idle so hover and drag recover after pet reloads without noisy logs.");
-assert.match(petPreloadSource, /openpets:pet-probe-hit-test[\s\S]*?elementFromPoint\(clientX, clientY\)[\s\S]*?reportInteractiveHit/, "pet preload must answer main-process cursor hit-test probes.");
-assert.match(petWindowSource, /did-finish-load", rearmAfterLoad/, "pet windows must re-arm mouse passthrough after every content load.");
-assert.match(petWindowSource, /did-fail-load", handleLoadFailure/, "pet windows must restore passthrough after failed content loads.");
-assert.match(petWindowSource, /window\.setIgnoreMouseEvents\(false\);[\s\S]*?await window\.loadFile/, "pet reloads must reset OS mouse passthrough before navigation.");
-assert.match(petWindowSource, /function allocateWindowLoadSequence/, "pet content reloads must allocate request sequence before async rendering.");
-assert.match(petWindowSource, /tryUpdateLoadedPetContent\(window, render, "default", sequence\)/, "default pet transient updates must avoid BrowserWindow reloads when the pet document is already loaded.");
-assert.match(petPreloadSource, /openpets:pet-content-state[\s\S]*?document\.body\.innerHTML/, "pet preload must accept sanitized in-place content updates for transient bubbles and badges.");
-assert.match(petWindowSource, /windowLoadChains\.set\(window, next\)/, "pet content reloads must serialize loadFile calls per BrowserWindow.");
-assert.match(petWindowSource, /next\.catch\(\(\) => \{\}\)\.finally/, "pet content reload chain cleanup must not create unhandled rejections.");
-assert.match(petWindowSource, /destroyed-after-write/, "pet content reloads must re-check destroyed windows after writing HTML.");
-assert.match(petWindowSource, /process\.platform === "win32" \? "none" : "drop-shadow/, "Windows pet windows must avoid CSS drop-shadow on transparent layered windows.");
-assert.match(petWindowSource, /process\.platform === "win32" \? "none" : "blur\(10px\)"/, "Windows pet windows must avoid backdrop-filter on transparent layered windows.");
-assert.match(petWindowSource, /\.pet-shell[\s\S]*?-webkit-app-region: no-drag; cursor: grab;/, "pet dragging must avoid Electron draggable regions so right-click context menus work.");
-assert.match(petPreloadSource, /openpets:pet-hit-test/, "pet preload must report visible pet and bubble hit testing for passthrough.");
-assert.match(petPreloadSource, /openpets:pet-ready/, "pet preload must report readiness after installing mouse handlers.");
-assert.match(petPreloadSource, /openpets:pet-drag-start/, "pet preload must start controlled pet dragging from the sprite.");
-assert.match(petPreloadSource, /openpets:pet-open-prompt/, "pet preload must request the floating prompt window on double-click.");
-assert.match(defaultPetControllerSource, /powerMonitor\.on\("resume", recoverDefaultPetWindowAfterResume\)/, "default pet must recover mouse interop after Windows sleep or resume.");
-assert.match(defaultPetControllerSource, /recoverDefaultPetMouseInterop\("display-change"\)/, "default pet must recover mouse interop after monitor topology changes.");
-assert.match(windowsSource, /recoverDefaultPetMouseInterop\("default-pet-changed"\)/, "changing default pet must recover mouse interop for dragging without app restart.");
-assert.match(petWindowSource, /function installPetContextMenu/, "pet windows must install a native right-click context menu.");
-assert.match(petWindowSource, /webContents\.on\("context-menu"/, "pet context menu must be handled in the Electron main process.");
-assert.match(petWindowSource, /Menu\.buildFromTemplate/, "pet context menu must use a small native Electron menu.");
-assert.doesNotMatch(petPreloadSource, /setIgnoreMouseEvents/, "pet preload must not call Electron window APIs directly.");
-const agentPetControllerSource = readFileSync(join(appDir, "src", "agent-pet-controller.ts"), "utf8");
+assert.match(petWindowSource, /webContents\.send\("familiaros:familiar-reaction-state"/, "finite reaction animations must clear sprite state without reloading the bubble.");
+assert.match(petPreloadSource, /familiaros:familiar-reaction-state/, "familiar preload must accept in-place reaction state updates.");
+assert.match(petWindowSource, /const webContents = window\.webContents[\s\S]*?const removeListeners = \(\): void => \{[\s\S]*?if \(!webContents\.isDestroyed\(\)\)/, "familiar window cleanup must capture webContents and avoid touching destroyed BrowserWindow objects.");
+assert.match(petWindowSource, /window\.on\("close", removeListeners\);\s*window\.once\("closed", removeListeners\);/, "familiar window cleanup must run before and after close so agent lease release and Cmd/Ctrl+W are idempotent.");
+assert.match(displaySource, /width:\s*220/, "familiar windows must stay tightly bounded around familiar and bubble.");
+assert.match(displaySource, /height:\s*320/, "familiar windows must be tall enough for adaptive long message bubbles at large familiar scale without becoming a huge click shield.");
+assert.match(petWindowSource, /function getBubbleClassName/, "familiar bubbles must classify explicit messages by length.");
+assert.match(petWindowSource, /is-long-message/, "familiar bubbles must have a long-message layout.");
+assert.match(petWindowSource, /is-very-long-message/, "familiar bubbles must have a very-long-message layout for 140-character say messages.");
+assert.match(petWindowSource, /body \{ -webkit-app-region: no-drag; pointer-events: none; \}/, "transparent familiar window background must not capture clicks or drags.");
+assert.match(petWindowSource, /function installMousePassthroughAndDrag/, "familiar windows must install real mouse passthrough and controlled drag behavior.");
+assert.match(petWindowSource, /setIgnoreMouseEvents\(true, \{ forward: true \}\)/, "transparent familiar window background must use OS-level mouse passthrough.");
+assert.match(petWindowSource, /setIgnoreMouseEvents\(false\)/, "visible familiar and bubble hit targets must re-enable mouse handling.");
+assert.match(petWindowSource, /familiaros:familiar-ready/, "familiar windows must resync passthrough after each renderer reload.");
+assert.match(petWindowSource, /function installMousePassthroughAndDrag[\s\S]*?const rearmPassthrough[\s\S]*?process\.platform !== "win32"[\s\S]*?rearmWindowsMouseForwarding\(reason\)/, "Windows familiar reloads must toggle forwarded mouse passthrough to re-register hover and drag tracking.");
+assert.match(petWindowSource, /scheduleWindowsMouseForwardingRearm\(`\$\{reason\}\+75ms`, 75\);[\s\S]*?scheduleWindowsMouseForwardingRearm\(`\$\{reason\}\+175ms`, 175\);/, "Windows familiar reloads must retry mouse forwarding rearm after load settles.");
+assert.match(petWindowSource, /familiaros:familiar-probe-hit-test/, "Windows familiar reloads must probe current cursor hit target when mousemove forwarding is stale.");
+assert.match(petWindowSource, /export function recoverPetMouseInterop/, "familiar windows must expose a controlled mouse interop recovery hook for OS display and resume events.");
+assert.match(petWindowSource, /petMouseInteropRecovery\.set\(window, scheduleMouseInteropRecovery\)/, "familiar windows must register their mouse interop recovery callback.");
+assert.match(petWindowSource, /function installMousePassthroughAndDrag[\s\S]*?scheduleWindowsForwardingWatch[\s\S]*?rearmWindowsMouseForwarding\(reason, false\)[\s\S]*?scheduleWindowsForwardingWatch\(reason\)/, "Windows familiar passthrough must keep rearming while idle so hover and drag recover after familiar reloads without noisy logs.");
+assert.match(petPreloadSource, /familiaros:familiar-probe-hit-test[\s\S]*?elementFromPoint\(clientX, clientY\)[\s\S]*?reportInteractiveHit/, "familiar preload must answer main-process cursor hit-test probes.");
+assert.match(petWindowSource, /did-finish-load", rearmAfterLoad/, "familiar windows must re-arm mouse passthrough after every content load.");
+assert.match(petWindowSource, /did-fail-load", handleLoadFailure/, "familiar windows must restore passthrough after failed content loads.");
+assert.match(petWindowSource, /window\.setIgnoreMouseEvents\(false\);[\s\S]*?await window\.loadFile/, "familiar reloads must reset OS mouse passthrough before navigation.");
+assert.match(petWindowSource, /function allocateWindowLoadSequence/, "familiar content reloads must allocate request sequence before async rendering.");
+assert.match(petWindowSource, /tryUpdateLoadedPetContent\(window, render, "default", sequence\)/, "default familiar transient updates must avoid BrowserWindow reloads when the familiar document is already loaded.");
+assert.match(petPreloadSource, /familiaros:familiar-content-state[\s\S]*?document\.body\.innerHTML/, "familiar preload must accept sanitized in-place content updates for transient bubbles and badges.");
+assert.match(petWindowSource, /windowLoadChains\.set\(window, next\)/, "familiar content reloads must serialize loadFile calls per BrowserWindow.");
+assert.match(petWindowSource, /next\.catch\(\(\) => \{\}\)\.finally/, "familiar content reload chain cleanup must not create unhandled rejections.");
+assert.match(petWindowSource, /destroyed-after-write/, "familiar content reloads must re-check destroyed windows after writing HTML.");
+assert.match(petWindowSource, /process\.platform === "win32" \? "none" : "drop-shadow/, "Windows familiar windows must avoid CSS drop-shadow on transparent layered windows.");
+assert.match(petWindowSource, /process\.platform === "win32" \? "none" : "blur\(10px\)"/, "Windows familiar windows must avoid backdrop-filter on transparent layered windows.");
+assert.match(petWindowSource, /\.familiar-shell[\s\S]*?-webkit-app-region: no-drag; cursor: grab;/, "familiar dragging must avoid Electron draggable regions so right-click context menus work.");
+assert.match(petPreloadSource, /familiaros:familiar-hit-test/, "familiar preload must report visible familiar and bubble hit testing for passthrough.");
+assert.match(petPreloadSource, /familiaros:familiar-ready/, "familiar preload must report readiness after installing mouse handlers.");
+assert.match(petPreloadSource, /familiaros:familiar-drag-start/, "familiar preload must start controlled familiar dragging from the sprite.");
+assert.match(petPreloadSource, /familiaros:familiar-open-prompt/, "familiar preload must request the floating prompt window on double-click.");
+assert.match(defaultPetControllerSource, /powerMonitor\.on\("resume", recoverDefaultPetWindowAfterResume\)/, "default familiar must recover mouse interop after Windows sleep or resume.");
+assert.match(defaultPetControllerSource, /recoverDefaultPetMouseInterop\("display-change"\)/, "default familiar must recover mouse interop after monitor topology changes.");
+assert.match(windowsSource, /recoverDefaultPetMouseInterop\("default-familiar-changed"\)/, "changing default familiar must recover mouse interop for dragging without app restart.");
+assert.match(petWindowSource, /function installPetContextMenu/, "familiar windows must install a native right-click context menu.");
+assert.match(petWindowSource, /webContents\.on\("context-menu"/, "familiar context menu must be handled in the Electron main process.");
+assert.match(petWindowSource, /Menu\.buildFromTemplate/, "familiar context menu must use a small native Electron menu.");
+assert.doesNotMatch(petPreloadSource, /setIgnoreMouseEvents/, "familiar preload must not call Electron window APIs directly.");
+const agentPetControllerSource = readFileSync(join(appDir, "src", "agent-familiar-controller.ts"), "utf8");
 const localIpcSource = readFileSync(join(appDir, "src", "local-ipc.ts"), "utf8");
-assert.match(agentPetControllerSource, /dismissedAgentPets = new Set<string>/, "agent pets must remember manual close while leases remain active.");
-assert.match(agentPetControllerSource, /dismissAgentPetForActiveLease/, "agent pet context-menu close must dismiss the pet for the active lease.");
-assert.match(agentPetControllerSource, /dismissedAgentPets\.has\(petId\)/, "dismissed agent pets must not reopen on later same-lease reactions.");
-assert.match(agentPetControllerSource, /function clearAgentPetLeaseState/, "agent pet lease cleanup must clear dismissal, timers, and hidden transient state.");
-assert.match(localIpcSource, /handleLastExplicitLease/, "agent pet dismissal must clear when the explicit lease group ends.");
-assert.match(localIpcSource, /clearAgentPetLeaseState\(petId\)/, "last explicit lease cleanup must reset dismissed agent pet state.");
-assert.match(localIpcSource, /reason: applied\.reason/, "IPC responses must report dismissed explicit pet events as not shown.");
-assert.match(updateCheckerSource, /alvinunreal\/openpets/, "GitHub release notice must check the public OpenPets repository.");
+assert.match(agentPetControllerSource, /dismissedAgentPets = new Set<string>/, "agent familiars must remember manual close while leases remain active.");
+assert.match(agentPetControllerSource, /dismissAgentPetForActiveLease/, "agent familiar context-menu close must dismiss the familiar for the active lease.");
+assert.match(agentPetControllerSource, /dismissedAgentPets\.has\(petId\)/, "dismissed agent familiars must not reopen on later same-lease reactions.");
+assert.match(agentPetControllerSource, /function clearAgentPetLeaseState/, "agent familiar lease cleanup must clear dismissal, timers, and hidden transient state.");
+assert.match(localIpcSource, /handleLastExplicitLease/, "agent familiar dismissal must clear when the explicit lease group ends.");
+assert.match(localIpcSource, /clearAgentPetLeaseState\(petId\)/, "last explicit lease cleanup must reset dismissed agent familiar state.");
+assert.match(localIpcSource, /reason: applied\.reason/, "IPC responses must report dismissed explicit familiar events as not shown.");
+assert.match(updateCheckerSource, /alvinunreal\/familiaros/, "GitHub release notice must check the public FamiliarOS repository.");
 assert.match(updateCheckerSource, /api\.github\.com\/repos\/\$\{githubRepository\}\/releases\/latest/, "update checker must use GitHub latest release API.");
 assert.match(updateCheckerSource, /shell\.openExternal\(url\)/, "update action must open the GitHub release page externally.");
 assert.match(traySource, /t\("tray\.updateAvailable"/, "tray menu must surface available updates.");
 assert.match(enCatalogSource, /Update available:/, "English catalog must keep the update-available label.");
-assert.match(windowsSource, /openpets:check-for-updates/, "settings window must be able to trigger update checks.");
-assert.match(windowsSource, /openpets:get-reaction-animation-settings/, "settings window must be able to load reaction animation metadata.");
+assert.match(windowsSource, /familiaros:check-for-updates/, "settings window must be able to trigger update checks.");
+assert.match(windowsSource, /familiaros:get-reaction-animation-settings/, "settings window must be able to load reaction animation metadata.");
 assert.match(windowsSource, /reactionAnimationOverrides/, "settings window must be able to persist reaction animation overrides.");
-assert.match(windowsSource, /openpets-pet-preview/, "settings reaction preview must use a scoped internal pet preview protocol.");
-assert.match(windowsSource, /openpets:open-update-release-page/, "settings window must be able to open the release page.");
+assert.match(windowsSource, /familiaros-familiar-preview/, "settings reaction preview must use a scoped internal familiar preview protocol.");
+assert.match(windowsSource, /familiaros:open-update-release-page/, "settings window must be able to open the release page.");
 assert.match(controlCenterPreloadSource, /checkForUpdates/, "Control Center preload must expose update checks.");
 assert.match(controlCenterPreloadSource, /getReactionAnimationSettings/, "Control Center preload must expose reaction animation settings metadata.");
 assert.match(controlCenterPreloadSource, /saveOpenApiCredential/, "Control Center preload must expose OpenAPI chat credential management.");
@@ -191,22 +191,22 @@ assert.match(promptWindowSource, /sendOpenApiChatPrompt/, "Prompt window must su
 assert.match(promptWindowSource, /openControlCenterWindow\("settings"\)/, "Prompt window must be able to open Settings when the API key is missing.");
 assert.match(controlCenterRendererSource, /API key or token|OpenAI API key/, "Control Center settings must expose OpenAPI chat credential setup.");
 assert.match(controlCenterRendererSource, /function SettingsView\(/, "Control Center must include the settings page.");
-assert.match(controlCenterRendererSource, /getPetsState/, "Control Center must include the pets page data bridge.");
+assert.match(controlCenterRendererSource, /getPetsState/, "Control Center must include the familiars page data bridge.");
 assert.match(controlCenterRendererSource, /function IntegrationsView\(\)/, "Control Center must include the integrations page.");
-assert.match(petWindowSource, /--bubble-max-width:/, "pet window must define a scalable bubble max-width variable.");
-assert.match(petWindowSource, /\.bubble\.is-very-long-message \{[\s\S]*?max-width:\s*min\([^)]*var\(--bubble-max-width\)/, "very long message bubbles must stay capped within the pet window while allowing larger pets.");
+assert.match(petWindowSource, /--bubble-max-width:/, "familiar window must define a scalable bubble max-width variable.");
+assert.match(petWindowSource, /\.bubble\.is-very-long-message \{[\s\S]*?max-width:\s*min\([^)]*var\(--bubble-max-width\)/, "very long message bubbles must stay capped within the familiar window while allowing larger familiars.");
 assert.match(petWindowSource, /\.bubble-body \{[\s\S]*?overflow-y:\s*auto/, "bubble bodies must be scrollable for long messages.");
 assert.match(petWindowSource, /createSpriteStateCss\("\.sprite"\)/, "built-in sprite CSS must react to reaction state.");
 assert.match(petWindowSource, /createSpriteStateCss\("\.installed-sprite"\)/, "installed sprite CSS must react to reaction state.");
 assert.match(petWindowSource, /html\[data-motion-state=\"\$\{motion\}\"\] \$\{selector\}/, "sprite CSS must let drag motion override reaction state.");
 assert.match(petWindowSource, /\.sprite, \.installed-sprite, \.bubble/, "reduced-motion CSS must include built-in and installed sprites.");
-assert.match(petWindowSource, /function createAgentPetWindow[\s\S]*?installMotionStatePublisher\(window\)/, "agent pet windows must publish motion state so dragged non-default pets run.");
-assert.match(petWindowSource, /loadExplicitPetContent[\s\S]*?state\.preferences\.petScale/, "explicit agent pet windows must use the saved pet scale preference.");
-assert.match(petWindowSource, /interface AgentPetWindowOptions[\s\S]*?readonly scale: PetScaleValue/, "new agent pet windows must receive the current pet scale explicitly for their first render.");
-assert.match(petWindowSource, /loadExplicitPetContent\(window, options\.petId, options\.display, options\.badge, dismissToken, options\.scale\)/, "agent pet first render must not fall back to the medium default scale.");
-assert.match(agentPetControllerSourceForLogging, /function getPreferredPetScale\(\): PetScaleValue/, "agent pet reloads must share one explicit saved scale helper.");
-assert.match(agentPetControllerSourceForLogging, /loadExplicitPetContent\(window, petId, display, badge, getCurrentDismissToken\(petId, display, badge\), scale\)/, "agent pet refreshes must pass the saved pet scale explicitly.");
-assert.match(agentPetControllerSourceForLogging, /loadExplicitPetContent\(window, petId, preparedDisplay, statusBadges\.get\(petId\) \?\? null, preparedDisplay\.dismissToken, getPreferredPetScale\(\)\)/, "agent pet transient updates must pass the saved pet scale explicitly.");
+assert.match(petWindowSource, /function createAgentPetWindow[\s\S]*?installMotionStatePublisher\(window\)/, "agent familiar windows must publish motion state so dragged non-default familiars run.");
+assert.match(petWindowSource, /loadExplicitPetContent[\s\S]*?state\.preferences\.petScale/, "explicit agent familiar windows must use the saved familiar scale preference.");
+assert.match(petWindowSource, /interface AgentPetWindowOptions[\s\S]*?readonly scale: PetScaleValue/, "new agent familiar windows must receive the current familiar scale explicitly for their first render.");
+assert.match(petWindowSource, /loadExplicitPetContent\(window, options\.petId, options\.display, options\.badge, dismissToken, options\.scale\)/, "agent familiar first render must not fall back to the medium default scale.");
+assert.match(agentPetControllerSourceForLogging, /function getPreferredPetScale\(\): PetScaleValue/, "agent familiar reloads must share one explicit saved scale helper.");
+assert.match(agentPetControllerSourceForLogging, /loadExplicitPetContent\(window, petId, display, badge, getCurrentDismissToken\(petId, display, badge\), scale\)/, "agent familiar refreshes must pass the saved familiar scale explicitly.");
+assert.match(agentPetControllerSourceForLogging, /loadExplicitPetContent\(window, petId, preparedDisplay, statusBadges\.get\(petId\) \?\? null, preparedDisplay\.dismissToken, getPreferredPetScale\(\)\)/, "agent familiar transient updates must pass the saved familiar scale explicitly.");
 assert.match(mappingDoc, /\| 3 \| `waving` \| `waving`, Claude `Notification`\. \|/, "mapping docs must describe waving animation row and notification mapping.");
 assert.match(mappingDoc, /reaction-animation-mapping\.ts/, "mapping docs must reference the shared reaction animation mapping source of truth.");
 assert.match(mappingDoc, /overrid/i, "mapping docs must mention that reaction animation defaults can be overridden in Settings.");
@@ -228,15 +228,15 @@ assert.match(enCatalogSource, /OpenCode/, "Control Center integrations must incl
 assert.match(enCatalogSource, /Cursor/, "Control Center integrations must include Cursor.");
 assert.match(enCatalogSource, /Pi/, "Control Center integrations must include Pi.");
 assert.doesNotMatch(agentSetupSource, /JSON\.parse\(prepared\.configWrite\.content\)/, "OpenCode desktop preview must parse JSONC planned config safely, not JSON.parse.");
-assert.match(windowsSource, /refreshDefaultPetContent\(\);\s*refreshAgentPetContent\(\);/, "pet scale preference changes must refresh default and agent pet windows.");
+assert.match(windowsSource, /refreshDefaultPetContent\(\);\s*refreshAgentPetContent\(\);/, "familiar scale preference changes must refresh default and agent familiar windows.");
 assert.ok(existsSync(join(appDir, "scripts", "clean-package-output.cjs")), "package output cleanup helper must exist.");
 assert.ok(existsSync(join(distDir, "main.js")), "desktop main build output must exist before packaging checks run.");
-assert.ok(existsSync(join(repoRoot, "packages", "claude", "dist", "index.js")), "@open-pets/claude must be built before packaging.");
-assert.ok(existsSync(join(repoRoot, "packages", "client", "dist", "index.js")), "@open-pets/client must be built before packaging.");
-assert.ok(existsSync(join(repoRoot, "packages", "mcp", "dist", "index.js")), "@open-pets/mcp must be built before packaging.");
-assert.ok(existsSync(join(repoRoot, "packages", "cli", "dist", "index.js")), "@open-pets/cli must be built before packaging.");
-assert.ok(existsSync(join(repoRoot, "packages", "opencode", "dist", "plugin.js")), "@open-pets/opencode plugin must be built before packaging.");
-assert.ok(existsSync(join(repoRoot, "packages", "agent-events", "dist", "index.js")), "@open-pets/agent-events must be built before packaging.");
+assert.ok(existsSync(join(repoRoot, "packages", "claude", "dist", "index.js")), "@familiaros/claude must be built before packaging.");
+assert.ok(existsSync(join(repoRoot, "packages", "client", "dist", "index.js")), "@familiaros/client must be built before packaging.");
+assert.ok(existsSync(join(repoRoot, "packages", "mcp", "dist", "index.js")), "@familiaros/mcp must be built before packaging.");
+assert.ok(existsSync(join(repoRoot, "packages", "cli", "dist", "index.js")), "@familiaros/cli must be built before packaging.");
+assert.ok(existsSync(join(repoRoot, "packages", "opencode", "dist", "plugin.js")), "@familiaros/opencode plugin must be built before packaging.");
+assert.ok(existsSync(join(repoRoot, "packages", "agent-events", "dist", "index.js")), "@familiaros/agent-events must be built before packaging.");
 
 if (process.argv.includes("--output")) {
   checkPackageOutput();
@@ -258,19 +258,19 @@ function checkPackageOutput(): void {
   assertBundledOfficialPlugins(appResourceDir);
   const appContents = join(appResourceDir, "app.asar.unpacked");
   assert.ok(existsSync(appContents), "packaged app.asar.unpacked resources are missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "claude", "dist", "index.js")), "packaged @open-pets/claude runtime is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "claude", "dist", "cli.js")), "packaged @open-pets/claude CLI runtime is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "claude", "package.json")), "packaged @open-pets/claude package metadata is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "client", "dist", "index.js")), "packaged @open-pets/client runtime is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "client", "package.json")), "packaged @open-pets/client package metadata is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "mcp", "dist", "index.js")), "packaged @open-pets/mcp runtime is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "mcp", "package.json")), "packaged @open-pets/mcp package metadata is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "cli", "dist", "index.js")), "packaged @open-pets/cli runtime is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "opencode", "dist", "plugin.js")), "packaged @open-pets/opencode plugin runtime is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "opencode", "package.json")), "packaged @open-pets/opencode package metadata is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "cursor", "dist", "index.js")), "packaged @open-pets/cursor runtime is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "cursor", "package.json")), "packaged @open-pets/cursor package metadata is missing.");
-  assert.ok(existsSync(join(appContents, "node_modules", "@open-pets", "agent-events", "dist", "index.js")), "packaged @open-pets/agent-events runtime is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "claude", "dist", "index.js")), "packaged @familiaros/claude runtime is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "claude", "dist", "cli.js")), "packaged @familiaros/claude CLI runtime is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "claude", "package.json")), "packaged @familiaros/claude package metadata is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "client", "dist", "index.js")), "packaged @familiaros/client runtime is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "client", "package.json")), "packaged @familiaros/client package metadata is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "mcp", "dist", "index.js")), "packaged @familiaros/mcp runtime is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "mcp", "package.json")), "packaged @familiaros/mcp package metadata is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "cli", "dist", "index.js")), "packaged @familiaros/cli runtime is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "opencode", "dist", "plugin.js")), "packaged @familiaros/opencode plugin runtime is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "opencode", "package.json")), "packaged @familiaros/opencode package metadata is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "cursor", "dist", "index.js")), "packaged @familiaros/cursor runtime is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "cursor", "package.json")), "packaged @familiaros/cursor package metadata is missing.");
+  assert.ok(existsSync(join(appContents, "node_modules", "@familiaros", "agent-events", "dist", "index.js")), "packaged @familiaros/agent-events runtime is missing.");
   assert.ok(existsSync(join(appContents, "node_modules", "@modelcontextprotocol", "sdk")), "packaged MCP SDK runtime dependency is missing.");
   assert.ok(existsSync(join(appContents, "node_modules", "zod", "index.cjs")), "packaged zod runtime dependency is missing.");
   assert.ok(existsSync(join(appContents, "node_modules", "yauzl", "index.js")), "packaged yauzl runtime dependency is missing.");
@@ -281,10 +281,10 @@ function checkPackageOutput(): void {
   assert.ok(existsSync(join(appContents, "node_modules", "@img", "sharp-win32-x64", "lib", "sharp-win32-x64.node")), "packaged Windows x64 sharp native binary is missing.");
   assert.ok(existsSync(join(appContents, "node_modules", "@img", "sharp-linux-x64", "lib", "sharp-linux-x64.node")), "packaged Linux x64 sharp native binary is missing.");
   assert.ok(existsSync(join(appContents, "node_modules", "@img", "sharp-darwin-x64", "lib", "sharp-darwin-x64.node")), "packaged macOS x64 sharp native binary is missing.");
-  assertRegularNonSymlink(join(appContents, "node_modules", "@open-pets", "mcp", "dist", "index.js"));
-  assertRegularNonSymlink(join(appContents, "node_modules", "@open-pets", "cli", "dist", "index.js"));
-  assertRegularNonSymlink(join(appContents, "node_modules", "@open-pets", "opencode", "dist", "plugin.js"));
-  assertRegularNonSymlink(join(appContents, "node_modules", "@open-pets", "claude", "dist", "cli.js"));
+  assertRegularNonSymlink(join(appContents, "node_modules", "@familiaros", "mcp", "dist", "index.js"));
+  assertRegularNonSymlink(join(appContents, "node_modules", "@familiaros", "cli", "dist", "index.js"));
+  assertRegularNonSymlink(join(appContents, "node_modules", "@familiaros", "opencode", "dist", "plugin.js"));
+  assertRegularNonSymlink(join(appContents, "node_modules", "@familiaros", "claude", "dist", "cli.js"));
   assertCommandSmoke(appContents);
 }
 
@@ -349,7 +349,7 @@ function isInside(parent: string, child: string): boolean {
 }
 
 function checkCleanupHelper(): void {
-  const sentinel = join(appDir, "dist-electron", ".openpets-clean-sentinel");
+  const sentinel = join(appDir, "dist-electron", ".familiaros-clean-sentinel");
   mkdirSync(dirname(sentinel), { recursive: true });
   writeFileSync(sentinel, "stale", "utf8");
   const result = spawnSync(process.execPath, [join(appDir, "scripts", "clean-package-output.cjs")], { cwd: appDir, encoding: "utf8" });
@@ -370,9 +370,9 @@ function assertNonEmptyFile(path: string, message: string): void {
 }
 
 function assertBundledOfficialPlugins(resourceDir: string): void {
-  for (const id of ["openpets.reminders"]) {
+  for (const id of ["familiaros.reminders"]) {
     const dir = join(resourceDir, "plugins", "official", id);
-    const manifestPath = join(dir, "openpets.plugin.json");
+    const manifestPath = join(dir, "familiaros.plugin.json");
     assertNonEmptyFile(manifestPath, `packaged bundled plugin manifest is missing: ${id}`);
     const manifest = JSON.parse(readFileSync(manifestPath, "utf8")) as { entry?: string };
     if (manifest.entry) assertNonEmptyFile(join(dir, manifest.entry), `packaged bundled plugin entry is missing: ${id}`);
@@ -389,20 +389,20 @@ function assertSafeBundledSvg(path: string, message: string): void {
 }
 
 function assertCommandSmoke(appContents: string): void {
-  const mcpEntry = join(appContents, "node_modules", "@open-pets", "mcp", "dist", "index.js");
+  const mcpEntry = join(appContents, "node_modules", "@familiaros", "mcp", "dist", "index.js");
   const mcp = spawnSync(process.execPath, [mcpEntry, "--version"], { encoding: "utf8" });
   assert.equal(mcp.status, 0, `packaged MCP command smoke failed: ${mcp.stderr || mcp.stdout}`);
 
-  const hookEntry = join(appContents, "node_modules", "@open-pets", "claude", "dist", "cli.js");
-  const hook = spawnSync(process.execPath, [hookEntry, "hook", "--openpets-managed"], {
+  const hookEntry = join(appContents, "node_modules", "@familiaros", "claude", "dist", "cli.js");
+  const hook = spawnSync(process.execPath, [hookEntry, "hook", "--familiaros-managed"], {
     input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }),
     encoding: "utf8",
-    env: { ...process.env, OPENPETS_DISCOVERY_FILE: join(appContents, "missing-ipc.json") },
+    env: { ...process.env, FAMILIAROS_DISCOVERY_FILE: join(appContents, "missing-ipc.json") },
   });
   assert.equal(hook.status, 0, `packaged Claude hook command smoke failed: ${hook.stderr || hook.stdout}`);
   assert.equal(hook.stdout, "");
 
-  const opencodePlugin = join(appContents, "node_modules", "@open-pets", "opencode", "dist", "plugin.js");
+  const opencodePlugin = join(appContents, "node_modules", "@familiaros", "opencode", "dist", "plugin.js");
   const plugin = spawnSync(process.execPath, ["--input-type=module", "--eval", `const mod = await import(${JSON.stringify(`file://${opencodePlugin}`)}); if (!mod.default?.server || !mod.default?.id) process.exit(2);`], { encoding: "utf8" });
   assert.equal(plugin.status, 0, `packaged OpenCode plugin smoke failed: ${plugin.stderr || plugin.stdout}`);
 }
diff --git a/apps/desktop/src/check-plugin-sdk-conformance.ts b/apps/desktop/src/check-plugin-sdk-conformance.ts
index 200519d2..2a7f9144 100644
--- a/apps/desktop/src/check-plugin-sdk-conformance.ts
+++ b/apps/desktop/src/check-plugin-sdk-conformance.ts
@@ -1,13 +1,13 @@
 /**
  * Drift guard between the runtime plugin SDK and the published
- * `@open-pets/plugin-sdk` type contract.
+ * `@familiaros/plugin-sdk` type contract.
  *
  * These are compile-time assertions: if the runtime's plugin-facing surface
  * (namespaces) or the JavaScript permission set ever diverges from what the
  * published package promises authors, `tsc` fails here. Keep the package and
  * the bridge in lockstep.
  */
-import type { OpenPetsContext, OpenPetsPermission } from "@open-pets/plugin-sdk";
+import type { FamiliarOSContext, FamiliarOSPermission } from "@familiaros/plugin-sdk";
 import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -20,12 +20,12 @@ import { pluginSdkAsyncRoutes, pluginSdkSyncRoutes, type PluginSdkRoute } from "
 type Equal<A, B> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? true : false;
 type Expect<T extends true> = T;
 
-// Every namespace the published SDK exposes (ctx.pet, ctx.schedule, …) must
+// Every namespace the published SDK exposes (ctx.familiar, ctx.schedule, …) must
 // exist on the runtime API, and the runtime must expose nothing extra.
-type _NamespacesMatch = Expect<Equal<keyof PluginSdkApi, keyof OpenPetsContext>>;
+type _NamespacesMatch = Expect<Equal<keyof PluginSdkApi, keyof FamiliarOSContext>>;
 
 // The JavaScript plugin permission union must match the published contract.
-type _PermissionsMatch = Expect<Equal<PluginJavascriptPermission, OpenPetsPermission>>;
+type _PermissionsMatch = Expect<Equal<PluginJavascriptPermission, FamiliarOSPermission>>;
 type _HostRoutesMatch = Expect<Equal<keyof typeof sdkCallHandlers, PluginSdkRoute>>;
 
 // Reference the aliases so unused-type tooling never strips the guard.
diff --git a/apps/desktop/src/claude-memory.ts b/apps/desktop/src/claude-memory.ts
index e34048e8..3c130874 100644
--- a/apps/desktop/src/claude-memory.ts
+++ b/apps/desktop/src/claude-memory.ts
@@ -2,37 +2,37 @@ import { chmodSync, closeSync, existsSync, lstatSync, mkdirSync, openSync, readF
 import { dirname, join } from "node:path";
 import { randomUUID } from "node:crypto";
 
-export interface ClaudeOpenPetsMemoryResult {
+export interface ClaudeFamiliarOSMemoryResult {
   readonly changed: boolean;
   readonly claudeMdPath: string;
   readonly openPetsMemoryPath: string;
 }
 
-export interface ClaudeOpenPetsMemoryStatus {
+export interface ClaudeFamiliarOSMemoryStatus {
   readonly status: "installed" | "not_installed" | "error";
   readonly message: string;
   readonly claudeMdPath: string;
   readonly openPetsMemoryPath: string;
 }
 
-export const openPetsClaudeImportLine = "@~/.claude/openpets.md";
+export const openPetsClaudeImportLine = "@~/.claude/familiaros.md";
 
-const openPetsImportStart = "<!-- OPENPETS:IMPORT:START -->";
-const openPetsImportEnd = "<!-- OPENPETS:IMPORT:END -->";
-const openPetsMemoryStart = "<!-- OPENPETS:START -->";
-const openPetsMemoryEnd = "<!-- OPENPETS:END -->";
+const openPetsImportStart = "<!-- FAMILIAROS:IMPORT:START -->";
+const openPetsImportEnd = "<!-- FAMILIAROS:IMPORT:END -->";
+const openPetsMemoryStart = "<!-- FAMILIAROS:START -->";
+const openPetsMemoryEnd = "<!-- FAMILIAROS:END -->";
 const maxClaudeMemoryBytes = 1024 * 1024;
 
-export function installClaudeOpenPetsMemory(homeDir: string): ClaudeOpenPetsMemoryResult {
+export function installClaudeFamiliarOSMemory(homeDir: string): ClaudeFamiliarOSMemoryResult {
   const paths = getClaudeMemoryPaths(homeDir);
   assertSafeClaudeMemoryPaths(paths.claudeDir, paths.claudeMdPath, paths.openPetsMemoryPath);
   mkdirSync(paths.claudeDir, { recursive: true, mode: 0o700 });
   assertSafeClaudeMemoryPaths(paths.claudeDir, paths.claudeMdPath, paths.openPetsMemoryPath);
 
-  const currentOpenPetsMemory = readTextFile(paths.openPetsMemoryPath);
-  const nextOpenPetsMemory = upsertOpenPetsMemoryBlock(currentOpenPetsMemory, createOpenPetsMemoryBlock());
-  const openPetsChanged = currentOpenPetsMemory !== nextOpenPetsMemory;
-  if (openPetsChanged) writePrivateTextFile(paths.openPetsMemoryPath, nextOpenPetsMemory);
+  const currentFamiliarOSMemory = readTextFile(paths.openPetsMemoryPath);
+  const nextFamiliarOSMemory = upsertFamiliarOSMemoryBlock(currentFamiliarOSMemory, createFamiliarOSMemoryBlock());
+  const openPetsChanged = currentFamiliarOSMemory !== nextFamiliarOSMemory;
+  if (openPetsChanged) writePrivateTextFile(paths.openPetsMemoryPath, nextFamiliarOSMemory);
 
   const currentClaudeMd = readTextFile(paths.claudeMdPath);
   const nextClaudeMd = ensureManagedImport(currentClaudeMd);
@@ -42,7 +42,7 @@ export function installClaudeOpenPetsMemory(homeDir: string): ClaudeOpenPetsMemo
   return { changed: openPetsChanged || claudeMdChanged, claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
 }
 
-export function uninstallClaudeOpenPetsMemory(homeDir: string): ClaudeOpenPetsMemoryResult {
+export function uninstallClaudeFamiliarOSMemory(homeDir: string): ClaudeFamiliarOSMemoryResult {
   const paths = getClaudeMemoryPaths(homeDir);
   assertSafeClaudeMemoryPaths(paths.claudeDir, paths.claudeMdPath, paths.openPetsMemoryPath);
 
@@ -55,18 +55,18 @@ export function uninstallClaudeOpenPetsMemory(homeDir: string): ClaudeOpenPetsMe
     changed = true;
   }
 
-  const currentOpenPetsMemory = readTextFile(paths.openPetsMemoryPath);
-  if (currentOpenPetsMemory) {
-    const nextOpenPetsMemory = removeOpenPetsMemoryBlock(currentOpenPetsMemory);
-    if (nextOpenPetsMemory.trim().length === 0) {
+  const currentFamiliarOSMemory = readTextFile(paths.openPetsMemoryPath);
+  if (currentFamiliarOSMemory) {
+    const nextFamiliarOSMemory = removeFamiliarOSMemoryBlock(currentFamiliarOSMemory);
+    if (nextFamiliarOSMemory.trim().length === 0) {
       if (hasUserOwnedImport) {
         writePrivateTextFile(paths.openPetsMemoryPath, "");
       } else {
         rmSync(paths.openPetsMemoryPath, { force: true });
       }
       changed = true;
-    } else if (nextOpenPetsMemory !== currentOpenPetsMemory) {
-      writePrivateTextFile(paths.openPetsMemoryPath, nextOpenPetsMemory);
+    } else if (nextFamiliarOSMemory !== currentFamiliarOSMemory) {
+      writePrivateTextFile(paths.openPetsMemoryPath, nextFamiliarOSMemory);
       changed = true;
     }
   }
@@ -74,26 +74,26 @@ export function uninstallClaudeOpenPetsMemory(homeDir: string): ClaudeOpenPetsMe
   return { changed, claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
 }
 
-export function doctorClaudeOpenPetsMemory(homeDir: string): ClaudeOpenPetsMemoryStatus {
+export function doctorClaudeFamiliarOSMemory(homeDir: string): ClaudeFamiliarOSMemoryStatus {
   const paths = getClaudeMemoryPaths(homeDir);
   try {
     assertSafeClaudeMemoryPaths(paths.claudeDir, paths.claudeMdPath, paths.openPetsMemoryPath);
     const claudeMd = readTextFile(paths.claudeMdPath);
     const openPetsMemory = readTextFile(paths.openPetsMemoryPath);
     const hasImport = hasManagedImport(claudeMd) || hasImportLineOutsideManagedBlock(claudeMd);
-    const hasInstructions = createOpenPetsBlockPattern().test(openPetsMemory) || /openpets_say|OpenPets MCP/i.test(openPetsMemory);
+    const hasInstructions = createFamiliarOSBlockPattern().test(openPetsMemory) || /familiaros_say|FamiliarOS MCP/i.test(openPetsMemory);
     if (hasImport && hasInstructions) {
-      return { status: "installed", message: "Claude will load OpenPets instructions from ~/.claude/openpets.md.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
+      return { status: "installed", message: "Claude will load FamiliarOS instructions from ~/.claude/familiaros.md.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
     }
     if (hasImport) {
-      return { status: "not_installed", message: "Claude imports OpenPets instructions, but the OpenPets memory file is missing or incomplete.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
+      return { status: "not_installed", message: "Claude imports FamiliarOS instructions, but the FamiliarOS memory file is missing or incomplete.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
     }
     if (hasInstructions) {
-      return { status: "not_installed", message: "OpenPets instructions exist, but Claude is not importing them yet.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
+      return { status: "not_installed", message: "FamiliarOS instructions exist, but Claude is not importing them yet.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
     }
-    return { status: "not_installed", message: "Claude OpenPets instructions are not installed.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
+    return { status: "not_installed", message: "Claude FamiliarOS instructions are not installed.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
   } catch (error) {
-    return { status: "error", message: error instanceof Error ? error.message : "Claude OpenPets instruction status is unavailable.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
+    return { status: "error", message: error instanceof Error ? error.message : "Claude FamiliarOS instruction status is unavailable.", claudeMdPath: paths.claudeMdPath, openPetsMemoryPath: paths.openPetsMemoryPath };
   }
 }
 
@@ -102,12 +102,12 @@ export function getClaudeMemoryPaths(homeDir: string): { readonly claudeDir: str
   return {
     claudeDir,
     claudeMdPath: join(claudeDir, "CLAUDE.md"),
-    openPetsMemoryPath: join(claudeDir, "openpets.md"),
+    openPetsMemoryPath: join(claudeDir, "familiaros.md"),
   };
 }
 
-export function createOpenPetsMemoryBlock(): string {
-  return `${openPetsMemoryStart}\n## OpenPets\n\nOpenPets MCP tools may be available.\n\nUse OpenPets as a short visible status channel for meaningful coding progress:\n- Use \`openpets_say\` when starting, completing, blocking, or needing review on non-trivial work.\n- Keep messages brief, user-facing, and non-sensitive.\n- Do not include code, logs, secrets, URLs, or file paths.\n- Use \`openpets_react\` for small visual or emotional feedback.\n- Use \`openpets_status\` only when checking availability or the targeted pet.\n- Do not spam every internal step.\n${openPetsMemoryEnd}\n`;
+export function createFamiliarOSMemoryBlock(): string {
+  return `${openPetsMemoryStart}\n## FamiliarOS\n\nFamiliarOS MCP tools may be available.\n\nUse FamiliarOS as a short visible status channel for meaningful coding progress:\n- Use \`familiaros_say\` when starting, completing, blocking, or needing review on non-trivial work.\n- Keep messages brief, user-facing, and non-sensitive.\n- Do not include code, logs, secrets, URLs, or file paths.\n- Use \`familiaros_react\` for small visual or emotional feedback.\n- Use \`familiaros_status\` only when checking availability or the targeted familiar.\n- Do not spam every internal step.\n${openPetsMemoryEnd}\n`;
 }
 
 export function ensureImportLine(source: string, importLine: string): string {
@@ -139,17 +139,17 @@ export function removeImportLine(source: string, importLine: string): string {
     .replace(/\s*$/u, (match) => (match.includes("\n") ? "\n" : ""));
 }
 
-export function upsertOpenPetsMemoryBlock(source: string, block: string): string {
-  const withoutBlocks = source.replace(createOpenPetsBlockPattern(), "").replace(/\n{3,}/g, "\n\n").replace(/\s*$/u, "");
+export function upsertFamiliarOSMemoryBlock(source: string, block: string): string {
+  const withoutBlocks = source.replace(createFamiliarOSBlockPattern(), "").replace(/\n{3,}/g, "\n\n").replace(/\s*$/u, "");
   return withoutBlocks ? `${withoutBlocks}\n\n${block}` : block;
 }
 
-export function removeOpenPetsMemoryBlock(source: string): string {
-  const withoutBlock = source.replace(createOpenPetsBlockPattern(), "").replace(/\n{3,}/g, "\n\n").trim();
+export function removeFamiliarOSMemoryBlock(source: string): string {
+  const withoutBlock = source.replace(createFamiliarOSBlockPattern(), "").replace(/\n{3,}/g, "\n\n").trim();
   return withoutBlock ? `${withoutBlock}\n` : "";
 }
 
-function createOpenPetsBlockPattern(): RegExp {
+function createFamiliarOSBlockPattern(): RegExp {
   return new RegExp(`${escapeRegExp(openPetsMemoryStart)}[\\s\\S]*?${escapeRegExp(openPetsMemoryEnd)}\\n?`, "g");
 }
 
@@ -174,7 +174,7 @@ function assertSafeClaudeMemoryPaths(claudeDir: string, claudeMdPath: string, op
     if (!existsSync(path)) continue;
     const stat = lstatSync(path);
     if (stat.isSymbolicLink() || !stat.isFile()) throw new Error("Claude memory file is not a safe regular file.");
-    if (stat.size > maxClaudeMemoryBytes) throw new Error("Claude memory file is too large for OpenPets to update safely.");
+    if (stat.size > maxClaudeMemoryBytes) throw new Error("Claude memory file is too large for FamiliarOS to update safely.");
   }
 }
 
@@ -202,7 +202,7 @@ function assertSafeWriteTarget(path: string): void {
   if (!existsSync(path)) return;
   const stat = lstatSync(path);
   if (stat.isSymbolicLink() || !stat.isFile()) throw new Error("Claude memory file is not a safe regular file.");
-  if (stat.size > maxClaudeMemoryBytes) throw new Error("Claude memory file is too large for OpenPets to update safely.");
+  if (stat.size > maxClaudeMemoryBytes) throw new Error("Claude memory file is too large for FamiliarOS to update safely.");
 }
 
 function escapeRegExp(value: string): string {
diff --git a/apps/desktop/src/codemap.md b/apps/desktop/src/codemap.md
index a24c8065..8e4c923a 100644
--- a/apps/desktop/src/codemap.md
+++ b/apps/desktop/src/codemap.md
@@ -2,17 +2,17 @@
 
 ## Responsibility
 
-Core TypeScript source for the OpenPets desktop application. Organized into: lifecycle management, state persistence, Control Center and pet windows, IPC server, agent integrations, pet installation/management, and declarative plus JavaScript plugin runtimes.
+Core TypeScript source for the FamiliarOS desktop application. Organized into: lifecycle management, state persistence, Control Center and familiar windows, IPC server, agent integrations, familiar installation/management, and declarative plus JavaScript plugin runtimes.
 
 ## Design
 
-- **Modular Controllers**: Separate controllers for default pet vs agent pets (lease-based)
+- **Modular Controllers**: Separate controllers for default familiar vs agent familiars (lease-based)
 - **Protocol-First IPC**: Versioned JSON protocol over TCP/Unix sockets with token auth
 - **Defensive I/O**: All file operations use temp+rename for atomicity, path traversal validation, symlink checks
-- **Validation at Boundaries**: Catalog, ZIP entries, pet metadata, and IPC params all strictly validated
-- **Lease Pattern**: Agent pets use expiring leases (15s TTL) with heartbeats; default pet is persistent
-- **Sandboxed Renderers**: Control Center loads the Vite React/Tailwind bundle through a hardened BrowserWindow and narrow preload bridge; transparent pet windows and plugin SDK host windows stay separate
-- **Structured Logging**: Scoped logging (app, ipc, lease, pet.*, state, tray, ui) with log rotation and redaction
+- **Validation at Boundaries**: Catalog, ZIP entries, familiar metadata, and IPC params all strictly validated
+- **Lease Pattern**: Agent familiars use expiring leases (15s TTL) with heartbeats; default familiar is persistent
+- **Sandboxed Renderers**: Control Center loads the Vite React/Tailwind bundle through a hardened BrowserWindow and narrow preload bridge; transparent familiar windows and plugin SDK host windows stay separate
+- **Structured Logging**: Scoped logging (app, ipc, lease, familiar.*, state, tray, ui) with log rotation and redaction
 - **Reaction Animation Mapping**: User-configurable mapping from reaction types to sprite animation states
 - **Plugin Runtimes**: Plugins use validated manifests, approved permissions, persisted config, safe path checks, declarative timer-triggered actions, or sandboxed JavaScript entry modules through the SDK bridge.
 
@@ -33,25 +33,25 @@ main.ts
 **IPC Request Flow**:
 ```
 local-ipc.ts → parseIpcRequest() → handleRequest()
-├── hello/status/pets.list/pets.install
+├── hello/status/familiars.list/familiars.install
 └── lease.acquire/heartbeat/release
     └── lease-manager.ts
-        ├── resolveTarget() (default vs explicit pet)
-        ├── onFirstExplicitLease → agent-pet-controller.showAgentPet()
-        └── onLastExplicitLease → agent-pet-controller.closeAgentPetIfOpen()
+        ├── resolveTarget() (default vs explicit familiar)
+        ├── onFirstExplicitLease → agent-familiar-controller.showAgentPet()
+        └── onLastExplicitLease → agent-familiar-controller.closeAgentPetIfOpen()
         └── Logging via logger.ts (ipc, lease scopes)
 ```
 
-**Pet Display Flow**:
+**Familiar Display Flow**:
 ```
-pet-window.ts
+familiar-window.ts
 ├── createDefaultPetWindow() / createAgentPetWindow()
 ├── loadDefaultPetContent() / loadExplicitPetContent()
 │   ├── HTML generation with CSS sprite animation
 │   ├── reaction-animation-mapping.ts (resolveReactionSpriteState)
 │   ├── reaction-messages.ts (pickReactionMessage for bubbles)
 │   └── Speech bubbles with status badges
-└── pet-preload.cjs (renderer IPC for drag/click-through)
+└── familiar-preload.cjs (renderer IPC for drag/click-through)
 ```
 
 **Agent Setup Flow**:
@@ -62,20 +62,20 @@ windows.ts (IPC handlers)
     ├── runAgentSetupAction()
     │   ├── configure/replace/remove (MCP commands)
     │   ├── install-memory (claude-memory.ts)
-    │   └── install-hooks/uninstall-hooks/doctor-hooks (@open-pets/claude)
-    ├── OpenCode global config management (@open-pets/opencode)
-    └── Cursor global MCP config management (@open-pets/cursor)
+    │   └── install-hooks/uninstall-hooks/doctor-hooks (@familiaros/claude)
+    ├── OpenCode global config management (@familiaros/opencode)
+    └── Cursor global MCP config management (@familiaros/cursor)
 ```
 
-**Pet Installation Flow**:
+**Familiar Installation Flow**:
 ```
-pet-installation.ts
+familiar-installation.ts
 ├── installPet()
 │   ├── getCatalogPet() → catalog.ts
 │   ├── downloadPetZip() → validate ZIP magic
 │   ├── extractPetZip() → yauzl with entry validation
 │   └── installPetState() → app-state.ts
-└── importCodexPet() → codex-pets.ts
+└── importCodexPet() → codex-familiars.ts
 ```
 
 **Control Center Flow**:
@@ -83,77 +83,77 @@ pet-installation.ts
 tray.ts → openControlCenterWindow(route) → windows.ts
 ├── hardened BrowserWindow loads Vite renderer or packaged dist/renderer/index.html
 ├── control-center-preload.cjs exposes page-specific APIs
-├── Dashboard snapshot: default pet, catalog, plugin health, update status, activity
-└── renderer/src/main.tsx routes Dashboard/Pets/Integrations/Plugins/Settings
+├── Dashboard snapshot: default familiar, catalog, plugin health, update status, activity
+└── renderer/src/main.tsx routes Dashboard/Familiars/Integrations/Plugins/Settings
 ```
 
 **Plugin Flow**:
 ```
 main.ts → initializePluginService(userData, defaultPluginPetApi, appVersion, ElectronPluginJsHost).start()
-├── plugin-state.ts reads/writes userData/openpets-plugin-state.json
+├── plugin-state.ts reads/writes userData/familiaros-plugin-state.json
 ├── plugin-runtime.ts reloads enabled manifests
 │   ├── declarative runtime schedules timer triggers
 │   ├── plugin-js-host.ts starts hidden sandboxed BrowserWindow hosts for JavaScript plugins
-│   └── plugin-sdk-bridge.ts → plugin-pet-api.ts/default-pet-controller plus schedules, storage, commands, status, logs, and restricted network
+│   └── plugin-sdk-bridge.ts → plugin-familiar-api.ts/default-familiar-controller plus schedules, storage, commands, status, logs, and restricted network
 ├── plugin-service.ts orchestrates UI actions, permission confirmation, config validation, install/update/uninstall/load-local, and runtime reloads
 └── lifecycle.ts → stopPluginService() on quit
 
 Control Center plugins route:
 tray.ts → openControlCenterWindow("plugins") → windows.ts → renderer React app
-└── openpets:plugins-* IPC handlers call PluginService methods
+└── familiaros:plugins-* IPC handlers call PluginService methods
 
 Catalog install/update:
 plugin-catalog.ts → plugin-catalog-validation.ts
 └── plugin-package.ts downloads HTTPS ZIP, validates SHA-256, extracts root manifest only, and installs to userData/plugins/{id}
 
 Local development load:
-plugin-local-loader.ts validates selected folder manifest and snapshots only openpets.plugin.json to userData/plugins-dev/{id}
+plugin-local-loader.ts validates selected folder manifest and snapshots only familiaros.plugin.json to userData/plugins-dev/{id}
 ```
 
 ## Integration Points
 
 - **Within src/**:
   - `main.ts` → all modules (orchestrator), including `ElectronPluginJsHost` for JavaScript plugins
-  - `local-ipc.ts` ↔ `lease-manager.ts` ↔ `agent-pet-controller.ts`
-  - `windows.ts` ↔ `app-state.ts`, `agent-setup.ts`, `catalog.ts`, `codex-pets.ts`, `update-checker.ts` for Control Center route snapshots/actions
+  - `local-ipc.ts` ↔ `lease-manager.ts` ↔ `agent-familiar-controller.ts`
+  - `windows.ts` ↔ `app-state.ts`, `agent-setup.ts`, `catalog.ts`, `codex-familiars.ts`, `update-checker.ts` for Control Center route snapshots/actions
   - `windows.ts` ↔ `plugin-service.ts` for Control Center plugin UI IPC, plugin commands, and Dashboard plugin health
-  - `pet-window.ts` ↔ `default-pet-controller.ts`, `agent-pet-controller.ts`
-  - `pet-installation.ts` ↔ `app-state.ts`, `catalog.ts`, `zip-safety.ts`
+  - `familiar-window.ts` ↔ `default-familiar-controller.ts`, `agent-familiar-controller.ts`
+  - `familiar-installation.ts` ↔ `app-state.ts`, `catalog.ts`, `zip-safety.ts`
   - `plugin-service.ts` ↔ `plugin-state.ts`, `plugin-runtime.ts`, `plugin-catalog.ts`, `plugin-package.ts`, `plugin-local-loader.ts`, `plugin-js-host.ts`, `plugin-sdk-bridge.ts`
 
 - **To packages/**:
-  - `@open-pets/claude`: `buildClaudeMcpPreview`, `installClaudeHooks`, `doctorClaudeHooks`, etc.
-  - `@open-pets/opencode`: `prepareOpenCodeGlobalSetup`, `doctorOpenCodeGlobalSetup`
-  - `@open-pets/cursor`: `planCursorMcpInstall`, `executeCursorMcpWrite`, `buildCursorRulesPreview`, etc.
-  - `@open-pets/cli`: Version lookup for bundled mode
+  - `@familiaros/claude`: `buildClaudeMcpPreview`, `installClaudeHooks`, `doctorClaudeHooks`, etc.
+  - `@familiaros/opencode`: `prepareOpenCodeGlobalSetup`, `doctorOpenCodeGlobalSetup`
+  - `@familiaros/cursor`: `planCursorMcpInstall`, `executeCursorMcpWrite`, `buildCursorRulesPreview`, etc.
+  - `@familiaros/cli`: Version lookup for bundled mode
 
 - **To System**:
-  - File system: `app.getPath("userData")`, `userData/plugins/`, `userData/plugins-dev/`, plugin storage JSON, `~/.codex/pets/`, `~/.claude/`, `~/.opencode/`
-  - Network: `fetch()` to openpets.dev, GitHub API, plugin catalog at `https://openpets.dev/plugins/catalog.v1.json`, plugin ZIPs restricted to `https://zip.openpets.dev/plugins/`
+  - File system: `app.getPath("userData")`, `userData/plugins/`, `userData/plugins-dev/`, plugin storage JSON, `~/.codex/familiars/`, `~/.claude/`, `~/.opencode/`
+  - Network: `fetch()` to familiaros.dev, GitHub API, plugin catalog at `https://familiaros.dev/plugins/catalog.v1.json`, plugin ZIPs restricted to `https://zip.familiaros.dev/plugins/`
   - Processes: `spawn()` for `claude`, `opencode`, `node`
 
 ## Key Modules
 
 **Core**:
 - `main.ts`: Entry, single-instance lock, bootstrap sequence, JavaScript plugin host construction
-- `lifecycle.ts`: App event handlers (quit, window-all-closed, second-instance) with logging; stops plugin service, IPC, and pet windows on quit
+- `lifecycle.ts`: App event handlers (quit, window-all-closed, second-instance) with logging; stops plugin service, IPC, and familiar windows on quit
 - `state.ts`: Simple shell pause state
 - `app-state.ts`: Persistent JSON state with V1 schema, atomic writes, reaction animation overrides
-- `app-state-core.ts`: Pet scale options, onboarding normalization
-- `logger.ts`: Structured logging with scopes (app, ipc, lease, pet.default, pet.agent, pet.window, state, tray, ui), log rotation, redaction
+- `app-state-core.ts`: Familiar scale options, onboarding normalization
+- `logger.ts`: Structured logging with scopes (app, ipc, lease, familiar.default, familiar.agent, familiar.window, state, tray, ui), log rotation, redaction
 
 **UI**:
 - `tray.ts`: Tray icon (nativeImage), context menu builder, update status integration, route-targeted Control Center entries, logs folder
-- `windows.ts`: Control Center BrowserWindow factory, Dashboard snapshot, IPC handler registration, route targeting, reaction animation settings, plugin/integration/pet/settings UI IPC endpoints, and scoped internal protocols
+- `windows.ts`: Control Center BrowserWindow factory, Dashboard snapshot, IPC handler registration, route targeting, reaction animation settings, plugin/integration/familiar/settings UI IPC endpoints, and scoped internal protocols
 - `assets.ts`: Tray icon loading with generated fallback
-- `display.ts`: Screen geometry helpers, pet window positioning
-- `renderer/`: Vite React/Tailwind Control Center shell for Dashboard, Pets, Integrations, Plugins, and Settings.
+- `display.ts`: Screen geometry helpers, familiar window positioning
+- `renderer/`: Vite React/Tailwind Control Center shell for Dashboard, Familiars, Integrations, Plugins, and Settings.
 
-**Pets**:
-- `pet-window.ts`: Window creation (transparent, frameless, always-on-top), HTML/CSS generation, sprite animation states, speech bubbles, status badges, transient displays
-- `default-pet-controller.ts`: Default pet visibility, position persistence, transient reactions, status badges, logging
-- `agent-pet-controller.ts`: Lease-triggered pet windows, dismissal tracking, transient displays, status badges, logging
-- `built-in-pet.ts`: Built-in pet constant
+**Familiars**:
+- `familiar-window.ts`: Window creation (transparent, frameless, always-on-top), HTML/CSS generation, sprite animation states, speech bubbles, status badges, transient displays
+- `default-familiar-controller.ts`: Default familiar visibility, position persistence, transient reactions, status badges, logging
+- `agent-familiar-controller.ts`: Lease-triggered familiar windows, dismissal tracking, transient displays, status badges, logging
+- `built-in-familiar.ts`: Built-in familiar constant
 - `reaction-messages.ts`: Message pools for each reaction type
 - `reaction-animation-mapping.ts`: Reaction-to-animation state mapping, user-configurable overrides, sprite state definitions
 
@@ -164,32 +164,32 @@ plugin-local-loader.ts validates selected folder manifest and snapshots only ope
 - `lease-manager.ts`: Lease lifecycle (acquire, heartbeat, release, cleanup), target resolution
 
 **Installation**:
-- `pet-installation.ts`: ZIP download, yauzl extraction with safety limits, pet validation
-- `pet-paths.ts`: Safe path resolution for pet directories
-- `codex-pets.ts`: Import from `~/.codex/pets/` with validation
-- `codex-pets-core.ts`: Codex metadata validation constants
+- `familiar-installation.ts`: ZIP download, yauzl extraction with safety limits, familiar validation
+- `familiar-paths.ts`: Safe path resolution for familiar directories
+- `codex-familiars.ts`: Import from `~/.codex/familiars/` with validation
+- `codex-familiars-core.ts`: Codex metadata validation constants
 - `catalog.ts`: Remote catalog fetch with V3 pagination support, search, fixture fallback
 - `catalog-validation.ts`: CatalogV2/V3 schema validation
 - `zip-safety.ts`: ZIP entry path validation (traversal prevention, case collision detection)
 
 **Plugins**:
-- `plugin-manifest.ts`: Manifest V1/V2 schema/types and validation for declarative and JavaScript runtimes, permissions (`timer`/`schedule`, `pet:speak`, `pet:reaction`, `storage`, `status`, `commands`, `network`), config schema, timer triggers, entry files, and pet actions.
+- `plugin-manifest.ts`: Manifest V1/V2 schema/types and validation for declarative and JavaScript runtimes, permissions (`timer`/`schedule`, `familiar:speak`, `familiar:reaction`, `storage`, `status`, `commands`, `network`), config schema, timer triggers, entry files, and familiar actions.
 - `plugin-manifest-reader.ts`: Safe manifest reader with realpath/allowed-root checks, root filename enforcement, size limit, and expected id/version matching.
 - `plugin-config.ts`: Config defaulting, replacement validation, and runtime resolution for string/number config references.
-- `plugin-state.ts`: Persistent plugin state store (`openpets-plugin-state.json`) with atomic temp+rename writes, normalized records, approved permissions, config, source, and broken reason.
+- `plugin-state.ts`: Persistent plugin state store (`familiaros-plugin-state.json`) with atomic temp+rename writes, normalized records, approved permissions, config, source, and broken reason.
 - `plugin-runtime.ts`: Runtime that compiles enabled declarative timer triggers, starts/stops JavaScript plugin hosts, verifies approved permissions, exposes public command/status state, validates actions, schedules cancellable timers, and marks broken plugins on validation/action failure.
-- `plugin-pet-api.ts`: Narrow adapter from plugin actions to default pet external `say`/`react` controller calls.
+- `plugin-familiar-api.ts`: Narrow adapter from plugin actions to default familiar external `say`/`react` controller calls.
 - `plugin-service.ts`: Application-facing plugin orchestrator for safe snapshots, enable/disable, config save, command execution, reload, catalog install/update, local load, uninstall, permission prompts, compatibility checks, JavaScript host/SDK bridge integration, and runtime reloads.
 - `plugin-catalog.ts`: Remote plugin catalog fetch with timeout, redirect rejection, response size cap, cache, and refresh support.
-- `plugin-catalog-validation.ts`: Catalog V1 schema validation, duplicate id checks, semver/SHA fields, permissions canonicalization, and optional minimum OpenPets version.
+- `plugin-catalog-validation.ts`: Catalog V1 schema validation, duplicate id checks, semver/SHA fields, permissions canonicalization, and optional minimum FamiliarOS version.
 - `plugin-package.ts`: Catalog plugin package download/install with HTTPS host/path allowlist, SHA-256 verification, ZIP size/entry restrictions, manifest/catalog consistency checks, and safe uninstall path resolution.
 - `plugin-local-loader.ts`: Developer loader that validates a selected local folder and snapshots only the manifest into `plugins-dev` with symlink/path/size protections.
 - `plugin-js-host.ts`: Sandboxed hidden BrowserWindow host for JavaScript plugin entry modules with per-plugin session partitioning, navigation/window-open hardening, SDK IPC tokening, registration handshake, config listener cleanup, and teardown.
-- `plugin-sdk-bridge.ts`: Permission-checked JavaScript plugin SDK for pet speech/reactions, one-shot/repeating/daily schedules, storage with quotas, config listeners, commands, status, logs, and HTTPS-only public-host fetch.
+- `plugin-sdk-bridge.ts`: Permission-checked JavaScript plugin SDK for familiar speech/reactions, one-shot/repeating/daily schedules, storage with quotas, config listeners, commands, status, logs, and HTTPS-only public-host fetch.
 
 **Agent Integration**:
 - `agent-setup.ts`: Claude/OpenCode/Cursor detection, MCP configuration, hooks management, action journaling
-- `claude-memory.ts`: Claude instructions file management (`~/.claude/openpets.md`)
+- `claude-memory.ts`: Claude instructions file management (`~/.claude/familiaros.md`)
 - `update-checker.ts`: GitHub release polling, update status
 - `update-version.ts`: Version parsing and comparison
 
@@ -203,16 +203,16 @@ plugin-local-loader.ts validates selected folder manifest and snapshots only ope
 | Source | Destination | Data |
 |--------|-------------|------|
 | Catalog API | `catalog.ts` | `CatalogV2/V3` JSON with pagination |
-| ZIP Download | `pet-installation.ts` | Extracted to `userData/pets/{id}/` |
-| `app-state.ts` | `userData/openpets-state.json` | Atomic JSON writes with reaction animation overrides |
-| CLI via IPC | `local-ipc.ts` | `pet.react`, `pet.say`, `lease.*` |
-| `lease-manager.ts` | `agent-pet-controller.ts` | Show/close agent pets |
+| ZIP Download | `familiar-installation.ts` | Extracted to `userData/familiars/{id}/` |
+| `app-state.ts` | `userData/familiaros-state.json` | Atomic JSON writes with reaction animation overrides |
+| CLI via IPC | `local-ipc.ts` | `familiar.react`, `familiar.say`, `lease.*` |
+| `lease-manager.ts` | `agent-familiar-controller.ts` | Show/close agent familiars |
 | `windows.ts` | Renderer | State snapshots via IPC invoke |
 | `agent-setup.ts` | Claude/OpenCode/Cursor CLI | MCP add/remove, config writes |
-| All modules | `logger.ts` | Structured logs to `userData/logs/openpets.log` |
+| All modules | `logger.ts` | Structured logs to `userData/logs/familiaros.log` |
 | Plugin catalog | `plugin-catalog.ts`/`plugin-service.ts` | Discoverable plugin metadata filtered by app version and install state |
 | Plugin ZIP/local folder | `plugin-package.ts`/`plugin-local-loader.ts` | Validated manifest snapshot installed under `userData/plugins*` |
-| `plugin-state.ts` | `userData/openpets-plugin-state.json` | Installed plugins, enabled flag, approved permissions, config, broken status |
-| Control Center renderer | `control-center-preload.cjs`/`windows.ts` | Narrow Dashboard/Pets/Integrations/Plugins/Settings snapshots and route-targeted actions |
-| `plugin-runtime.ts` | `plugin-pet-api.ts`/`plugin-js-host.ts`/`plugin-sdk-bridge.ts` | Declarative timers and JavaScript SDK actions on default pet, schedules, storage, commands, status, logs, and network |
+| `plugin-state.ts` | `userData/familiaros-plugin-state.json` | Installed plugins, enabled flag, approved permissions, config, broken status |
+| Control Center renderer | `control-center-preload.cjs`/`windows.ts` | Narrow Dashboard/Familiars/Integrations/Plugins/Settings snapshots and route-targeted actions |
+| `plugin-runtime.ts` | `plugin-familiar-api.ts`/`plugin-js-host.ts`/`plugin-sdk-bridge.ts` | Declarative timers and JavaScript SDK actions on default familiar, schedules, storage, commands, status, logs, and network |
 | Plugins renderer | `windows.ts`/`plugin-service.ts` | Snapshot, enable, config, command, reload, install/update/uninstall, local-load operations |
diff --git a/apps/desktop/src/codex-pets-core.ts b/apps/desktop/src/codex-familiars-core.ts
similarity index 72%
rename from apps/desktop/src/codex-pets-core.ts
rename to apps/desktop/src/codex-familiars-core.ts
index e3d28396..016109d0 100644
--- a/apps/desktop/src/codex-pets-core.ts
+++ b/apps/desktop/src/codex-familiars-core.ts
@@ -11,13 +11,13 @@ export interface CodexPetMetadata {
 }
 
 export function validateCodexPetMetadata(value: unknown, folderName: string): CodexPetMetadata {
-  if (!isSafeCodexPetId(folderName)) throw new Error("Codex pet folder name is invalid.");
-  if (!isRecord(value)) throw new Error("pet.json must be an object.");
-  if (value.id !== folderName || typeof value.id !== "string") throw new Error("Codex pet id must match its folder name.");
-  if (!isSafeCodexPetId(value.id)) throw new Error("Codex pet id is invalid.");
-  if (typeof value.displayName !== "string" || value.displayName.trim().length === 0 || value.displayName.length > 80) throw new Error("Codex pet displayName is invalid.");
-  if (typeof value.description !== "string" || value.description.trim().length === 0 || value.description.length > 500) throw new Error("Codex pet description is invalid.");
-  if (value.spritesheetPath !== "spritesheet.webp") throw new Error("Codex pet spritesheetPath must be spritesheet.webp.");
+  if (!isSafeCodexPetId(folderName)) throw new Error("Codex familiar folder name is invalid.");
+  if (!isRecord(value)) throw new Error("familiar.json must be an object.");
+  if (value.id !== folderName || typeof value.id !== "string") throw new Error("Codex familiar id must match its folder name.");
+  if (!isSafeCodexPetId(value.id)) throw new Error("Codex familiar id is invalid.");
+  if (typeof value.displayName !== "string" || value.displayName.trim().length === 0 || value.displayName.length > 80) throw new Error("Codex familiar displayName is invalid.");
+  if (typeof value.description !== "string" || value.description.trim().length === 0 || value.description.length > 500) throw new Error("Codex familiar description is invalid.");
+  if (value.spritesheetPath !== "spritesheet.webp") throw new Error("Codex familiar spritesheetPath must be spritesheet.webp.");
   return {
     id: value.id,
     displayName: value.displayName.trim(),
diff --git a/apps/desktop/src/codex-pets.ts b/apps/desktop/src/codex-familiars.ts
similarity index 76%
rename from apps/desktop/src/codex-pets.ts
rename to apps/desktop/src/codex-familiars.ts
index a3f1189d..529b2a06 100644
--- a/apps/desktop/src/codex-pets.ts
+++ b/apps/desktop/src/codex-familiars.ts
@@ -3,18 +3,18 @@ import { lstat, mkdir, mkdtemp, open, readdir, realpath, rename, rm, writeFile }
 import { homedir } from "node:os";
 import { basename, join, resolve, sep } from "node:path";
 
-import { getAppStateSnapshot, installPetState, type OpenPetsStateV1 } from "./app-state.js";
-import { maxCodexPetJsonBytes, maxCodexPets, maxCodexSpritesheetBytes, maxCodexThumbnailSourceBytes, validateCodexPetMetadata, type CodexPetMetadata } from "./codex-pets-core.js";
-import { withPetOperation } from "./pet-installation.js";
-import { assertInsideRoot, assertSafePetId, getInstalledPetDir, getPetsRoot } from "./pet-paths.js";
+import { getAppStateSnapshot, installPetState, type FamiliarOSStateV1 } from "./app-state.js";
+import { maxCodexPetJsonBytes, maxCodexPets, maxCodexSpritesheetBytes, maxCodexThumbnailSourceBytes, validateCodexPetMetadata, type CodexPetMetadata } from "./codex-familiars-core.js";
+import { withPetOperation } from "./familiar-installation.js";
+import { assertInsideRoot, assertSafePetId, getInstalledPetDir, getPetsRoot } from "./familiar-paths.js";
 
-const codexPetsRoot = join(homedir(), ".codex", "pets");
+const codexPetsRoot = join(homedir(), ".codex", "familiars");
 const codexThumbnailCache = new Map<string, string>();
 let sharpFactoryPromise: Promise<any | null> | null = null;
 
 export interface CodexPetUiState {
   readonly source: "codex";
-  readonly pets: readonly CodexPetUiItem[];
+  readonly familiars: readonly CodexPetUiItem[];
   readonly error?: string;
 }
 
@@ -30,32 +30,32 @@ export async function getCodexPetsUiState(): Promise<CodexPetUiState> {
   try {
     const root = await validateCodexRoot();
     const entries = (await readdir(codexPetsRoot, { withFileTypes: true })).sort((left, right) => left.name.localeCompare(right.name));
-    const pets: CodexPetUiItem[] = [];
+    const familiars: CodexPetUiItem[] = [];
     let attemptedDirectories = 0;
 
     for (const entry of entries) {
       if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
       attemptedDirectories += 1;
       if (attemptedDirectories > maxCodexPets) break;
-      const pet = await tryReadCodexPet(root, join(root, entry.name), entry.name);
-      if (pet) {
-        pets.push(pet);
+      const familiar = await tryReadCodexPet(root, join(root, entry.name), entry.name);
+      if (familiar) {
+        familiars.push(familiar);
       }
     }
 
-    pets.sort((left, right) => left.displayName.localeCompare(right.displayName));
-    return { source: "codex", pets };
+    familiars.sort((left, right) => left.displayName.localeCompare(right.displayName));
+    return { source: "codex", familiars };
   } catch (error) {
-    if (isNodeError(error) && error.code === "ENOENT") return { source: "codex", pets: [] };
-    return { source: "codex", pets: [], error: error instanceof Error ? error.message : "Codex pets unavailable." };
+    if (isNodeError(error) && error.code === "ENOENT") return { source: "codex", familiars: [] };
+    return { source: "codex", familiars: [], error: error instanceof Error ? error.message : "Codex familiars unavailable." };
   }
 }
 
-export async function importCodexPet(petId: string): Promise<OpenPetsStateV1> {
+export async function importCodexPet(petId: string): Promise<FamiliarOSStateV1> {
   return withPetOperation(petId, async () => {
     assertSafePetId(petId);
-    if (getAppStateSnapshot().pets.installed.some((pet) => pet.id === petId)) {
-      throw new Error(`Pet is already installed: ${petId}`);
+    if (getAppStateSnapshot().familiars.installed.some((familiar) => familiar.id === petId)) {
+      throw new Error(`Familiar is already installed: ${petId}`);
     }
 
     const root = await validateCodexRoot();
@@ -73,13 +73,13 @@ export async function importCodexPet(petId: string): Promise<OpenPetsStateV1> {
     try {
       assertInsideRoot(petsRoot, tempDir);
       await writeFile(join(tempDir, "spritesheet.webp"), spritesheet, { mode: 0o600, flag: "wx" });
-      await writeFile(join(tempDir, "pet.json"), `${JSON.stringify(metadata, null, 2)}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
+      await writeFile(join(tempDir, "familiar.json"), `${JSON.stringify(metadata, null, 2)}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
       await rm(finalDir, { recursive: true, force: true });
       await rename(tempDir, finalDir);
 
       try {
         await validateInstalledRegularFile(join(finalDir, "spritesheet.webp"));
-        await validateInstalledRegularFile(join(finalDir, "pet.json"));
+        await validateInstalledRegularFile(join(finalDir, "familiar.json"));
         return installPetState({
           id: metadata.id,
           displayName: metadata.displayName,
@@ -108,10 +108,10 @@ async function tryReadCodexPet(root: string, dir: string, folderName: string): P
       displayName: metadata.displayName,
       description: metadata.description,
       preview,
-      spritesheet: `openpets-codex://spritesheet/${encodeURIComponent(metadata.id)}`,
+      spritesheet: `familiaros-codex://spritesheet/${encodeURIComponent(metadata.id)}`,
     };
   } catch (error) {
-    console.error(`Skipping invalid Codex pet at ${dir}.`, error);
+    console.error(`Skipping invalid Codex familiar at ${dir}.`, error);
     return null;
   }
 }
@@ -127,8 +127,8 @@ export async function readCodexPetSpritesheet(petId: string): Promise<Buffer> {
 async function readCodexPetMetadata(root: string, dir: string, folderName: string): Promise<CodexPetMetadata> {
   await assertCodexPetDirectory(root, dir);
   assertSafePetId(folderName);
-  const petJson = join(dir, "pet.json");
-  const parsed = JSON.parse((await readRegularFile(petJson, maxCodexPetJsonBytes, "pet.json")).toString("utf8")) as unknown;
+  const petJson = join(dir, "familiar.json");
+  const parsed = JSON.parse((await readRegularFile(petJson, maxCodexPetJsonBytes, "familiar.json")).toString("utf8")) as unknown;
   const metadata = validateCodexPetMetadata(parsed, folderName);
   assertSafePetId(metadata.id);
   return metadata;
@@ -181,23 +181,23 @@ async function loadSharpFactory(): Promise<any | null> {
 async function validateCodexRoot(): Promise<string> {
   const root = resolve(codexPetsRoot);
   const rootStats = await lstat(root);
-  if (rootStats.isSymbolicLink()) throw new Error("Codex pets root cannot be a symlink.");
-  if (!rootStats.isDirectory()) throw new Error("Codex pets path is not a directory.");
+  if (rootStats.isSymbolicLink()) throw new Error("Codex familiars root cannot be a symlink.");
+  if (!rootStats.isDirectory()) throw new Error("Codex familiars path is not a directory.");
   const realRoot = await realpath(root);
-  if (realRoot !== root) throw new Error("Codex pets root path is not canonical.");
+  if (realRoot !== root) throw new Error("Codex familiars root path is not canonical.");
   return root;
 }
 
 async function assertCodexPetDirectory(root: string, target: string): Promise<void> {
   const resolvedTarget = resolve(target);
   if (resolvedTarget === root || !resolvedTarget.startsWith(`${root}${sep}`) || basename(resolvedTarget).startsWith(".")) {
-    throw new Error("Resolved path escapes Codex pets directory.");
+    throw new Error("Resolved path escapes Codex familiars directory.");
   }
   const dirStats = await lstat(resolvedTarget);
-  if (dirStats.isSymbolicLink()) throw new Error("Codex pet directory cannot be a symlink.");
-  if (!dirStats.isDirectory()) throw new Error("Codex pet path must be a directory.");
+  if (dirStats.isSymbolicLink()) throw new Error("Codex familiar directory cannot be a symlink.");
+  if (!dirStats.isDirectory()) throw new Error("Codex familiar path must be a directory.");
   const realTarget = await realpath(resolvedTarget);
-  if (!realTarget.startsWith(`${root}${sep}`)) throw new Error("Codex pet directory escapes Codex pets root.");
+  if (!realTarget.startsWith(`${root}${sep}`)) throw new Error("Codex familiar directory escapes Codex familiars root.");
 }
 
 async function readRegularFile(path: string, maxBytes: number, label: string): Promise<Buffer> {
@@ -218,8 +218,8 @@ async function readRegularFile(path: string, maxBytes: number, label: string): P
 
 async function validateInstalledRegularFile(path: string): Promise<void> {
   const stats = await lstat(path);
-  if (stats.isSymbolicLink()) throw new Error("Imported pet file cannot be a symlink.");
-  if (!stats.isFile()) throw new Error("Imported pet file must be a regular file.");
+  if (stats.isSymbolicLink()) throw new Error("Imported familiar file cannot be a symlink.");
+  if (!stats.isFile()) throw new Error("Imported familiar file must be a regular file.");
 }
 
 function isNodeError(error: unknown): error is NodeJS.ErrnoException {
diff --git a/apps/desktop/src/default-pet-controller.ts b/apps/desktop/src/default-familiar-controller.ts
similarity index 80%
rename from apps/desktop/src/default-pet-controller.ts
rename to apps/desktop/src/default-familiar-controller.ts
index 9048a74a..b67a5c6e 100644
--- a/apps/desktop/src/default-pet-controller.ts
+++ b/apps/desktop/src/default-familiar-controller.ts
@@ -4,8 +4,8 @@ import { getAppStateSnapshot, getDefaultPetPosition, resetDefaultPetPosition, se
 import { shouldShowDefaultPetForExternalEvent } from "./app-state-core.js";
 import { defaultPetWindowSize, getDefaultPetInitialPosition } from "./display.js";
 import { debug, info } from "./logger.js";
-import { transientDisplayMs, type OpenPetsReaction } from "./local-ipc-protocol.js";
-import { clearTransientReaction, createDefaultPetWindow, getSafeDefaultPetPosition, getTransientDisplayDurationMs, getTransientReactionAnimationMs, isPetWindowDragging, loadDefaultPetContent, mergePetTransientDisplay, readWindowPosition, recoverPetMouseInterop, setPetReactionState, type PetPluginBubbles, type PetStatusBadgeReaction, type PetTransientDisplay } from "./pet-window.js";
+import { transientDisplayMs, type FamiliarOSReaction } from "./local-ipc-protocol.js";
+import { clearTransientReaction, createDefaultPetWindow, getSafeDefaultPetPosition, getTransientDisplayDurationMs, getTransientReactionAnimationMs, isPetWindowDragging, loadDefaultPetContent, mergePetTransientDisplay, readWindowPosition, recoverPetMouseInterop, setPetReactionState, type PetPluginBubbles, type PetStatusBadgeReaction, type PetTransientDisplay } from "./familiar-window.js";
 import { PetBubbleArbiter, type ActiveBubble, type PetBubbleSink } from "./plugin-bubble-arbiter.js";
 import { publishPluginPetEvent } from "./plugin-events-source.js";
 
@@ -27,7 +27,7 @@ let promptRequestHandler: (() => void) | undefined;
 export type PetMoveOptions = { readonly x: number; readonly y: number; readonly durationMs?: number };
 export type PetWanderOptions = { readonly distance?: number; readonly durationMs?: number };
 export type InternalPetMessageOptions = {
-  readonly reaction?: OpenPetsReaction;
+  readonly reaction?: FamiliarOSReaction;
   readonly fullMessage?: boolean;
   readonly sticky?: boolean;
 };
@@ -35,7 +35,7 @@ export type InternalPetMessageOptions = {
 export type PetReactionOptions = { readonly showMessage?: boolean };
 
 // Plugin bubble slots (SDK v3): the arbiter decides what each slot shows; the
-// sink merges its decisions into the default pet render.
+// sink merges its decisions into the default familiar render.
 let pluginTransientBubble: ActiveBubble | null = null;
 let pluginPinnedBubble: ActiveBubble | null = null;
 
@@ -43,13 +43,13 @@ const defaultPetBubbleSink: PetBubbleSink = {
   present(slot, content) {
     if (slot === "pinned") pluginPinnedBubble = content;
     else pluginTransientBubble = content;
-    debug("pet.default", "plugin bubble slot", { slot, token: content?.token ?? null, pluginId: content?.pluginId });
+    debug("familiar.default", "plugin bubble slot", { slot, token: content?.token ?? null, pluginId: content?.pluginId });
     if (content) showDefaultPetForExternalEvent();
     refreshDefaultPetContent();
   },
 };
 
-/** The default pet's bubble arbiter — the Electron bubbles capability targets this. */
+/** The default familiar's bubble arbiter — the Electron bubbles capability targets this. */
 export const defaultPetBubbleArbiter = new PetBubbleArbiter(defaultPetBubbleSink);
 
 export function getDefaultPetPluginBubbles(): PetPluginBubbles | null {
@@ -64,7 +64,7 @@ export function showDefaultPet(): void {
 
 function showDefaultPetWindow(source: "user" | "external-event"): void {
   const window = getOrCreateDefaultPetWindow();
-  info("pet.default", "show requested", { source, windowId: window.id, visible: window.isVisible(), minimized: window.isMinimized(), paused, petId: getAppStateSnapshot().preferences.defaultPetId });
+  info("familiar.default", "show requested", { source, windowId: window.id, visible: window.isVisible(), minimized: window.isMinimized(), paused, petId: getAppStateSnapshot().preferences.defaultPetId });
 
   if (window.isMinimized()) {
     window.restore();
@@ -77,11 +77,11 @@ export function hideDefaultPet(): void {
   updatePreferences({ openDefaultPetOnLaunch: false });
 
   if (!defaultPetWindow || defaultPetWindow.isDestroyed()) {
-    debug("pet.default", "hide skipped", { reason: "no-window" });
+    debug("familiar.default", "hide skipped", { reason: "no-window" });
     return;
   }
 
-  info("pet.default", "hide requested", { windowId: defaultPetWindow.id, position: readWindowPosition(defaultPetWindow), petId: getAppStateSnapshot().preferences.defaultPetId });
+  info("familiar.default", "hide requested", { windowId: defaultPetWindow.id, position: readWindowPosition(defaultPetWindow), petId: getAppStateSnapshot().preferences.defaultPetId });
   setDefaultPetPosition(readWindowPosition(defaultPetWindow));
   defaultPetWindow.hide();
 }
@@ -92,7 +92,7 @@ export function isDefaultPetVisible(): boolean {
 
 export function setDefaultPetPaused(nextPaused: boolean): void {
   paused = nextPaused;
-  info("pet.default", "pause changed", { paused });
+  info("familiar.default", "pause changed", { paused });
 
   if (!defaultPetWindow || defaultPetWindow.isDestroyed()) {
     return;
@@ -111,25 +111,25 @@ export function getDefaultPetWindowForPlugins(): BrowserWindow | null {
 
 export function refreshDefaultPetContent(): void {
   if (!defaultPetWindow || defaultPetWindow.isDestroyed()) {
-    debug("pet.default", "refresh skipped", { reason: "no-window" });
+    debug("familiar.default", "refresh skipped", { reason: "no-window" });
     return;
   }
 
-  debug("pet.default", "refresh content", { windowId: defaultPetWindow.id, paused, hasDisplay: Boolean(transientDisplay), badge: statusBadge, petId: getAppStateSnapshot().preferences.defaultPetId });
+  debug("familiar.default", "refresh content", { windowId: defaultPetWindow.id, paused, hasDisplay: Boolean(transientDisplay), badge: statusBadge, petId: getAppStateSnapshot().preferences.defaultPetId });
   void loadDefaultPetContent(defaultPetWindow, paused, transientDisplay, statusBadge, getCurrentDismissToken(), getDefaultPetPluginBubbles());
 }
 
 export function recoverDefaultPetMouseInterop(reason: string): void {
   if (!defaultPetWindow || defaultPetWindow.isDestroyed()) {
-    debug("pet.default", "mouse interop recovery skipped", { reason, skippedReason: "no-window" });
+    debug("familiar.default", "mouse interop recovery skipped", { reason, skippedReason: "no-window" });
     return;
   }
 
-  debug("pet.default", "mouse interop recovery requested", { windowId: defaultPetWindow.id, reason, petId: getAppStateSnapshot().preferences.defaultPetId });
+  debug("familiar.default", "mouse interop recovery requested", { windowId: defaultPetWindow.id, reason, petId: getAppStateSnapshot().preferences.defaultPetId });
   recoverPetMouseInterop(defaultPetWindow, reason);
 }
 
-export function applyExternalPetReaction(reaction: OpenPetsReaction, options: PetReactionOptions = {}): { readonly shown: boolean; readonly reason?: string } {
+export function applyExternalPetReaction(reaction: FamiliarOSReaction, options: PetReactionOptions = {}): { readonly shown: boolean; readonly reason?: string } {
   if (paused) {
     return { shown: false, reason: "paused" };
   }
@@ -139,7 +139,7 @@ export function applyExternalPetReaction(reaction: OpenPetsReaction, options: Pe
   return { shown: isDefaultPetVisible() };
 }
 
-export function applyExternalPetSay(message: string, reaction?: OpenPetsReaction): { readonly shown: boolean; readonly reason?: string } {
+export function applyExternalPetSay(message: string, reaction?: FamiliarOSReaction): { readonly shown: boolean; readonly reason?: string } {
   if (paused) {
     return { shown: false, reason: "paused" };
   }
@@ -166,7 +166,7 @@ export function applyInternalPetMessage(message: string, options: InternalPetMes
   return { shown: isDefaultPetVisible() };
 }
 
-export function applyExternalPetStatusReaction(reaction: OpenPetsReaction | null): void {
+export function applyExternalPetStatusReaction(reaction: FamiliarOSReaction | null): void {
   if (reaction === null || reaction === "idle") clearStatusBadge();
   else setStatusBadge(reaction);
   refreshDefaultPetContent();
@@ -193,12 +193,12 @@ export function destroyDefaultPet(): void {
   clearDefaultPetDisplayTimers();
 
   if (!defaultPetWindow || defaultPetWindow.isDestroyed()) {
-    debug("pet.default", "destroy skipped", { reason: "no-window" });
+    debug("familiar.default", "destroy skipped", { reason: "no-window" });
     defaultPetWindow = null;
     return;
   }
 
-  info("pet.default", "destroy requested", { windowId: defaultPetWindow.id, position: readWindowPosition(defaultPetWindow), petId: getAppStateSnapshot().preferences.defaultPetId });
+  info("familiar.default", "destroy requested", { windowId: defaultPetWindow.id, position: readWindowPosition(defaultPetWindow), petId: getAppStateSnapshot().preferences.defaultPetId });
   setDefaultPetPosition(readWindowPosition(defaultPetWindow));
   const window = defaultPetWindow;
   defaultPetWindow = null;
@@ -220,13 +220,13 @@ export function getDefaultPetWindowBounds(): Electron.Rectangle | null {
 }
 
 function handleBubbleDismissed(dismissToken: string): void {
-  debug("pet.default", "bubble dismissed callback", { windowId: defaultPetWindow?.id, dismissToken, currentGeneration: displayGeneration });
+  debug("familiar.default", "bubble dismissed callback", { windowId: defaultPetWindow?.id, dismissToken, currentGeneration: displayGeneration });
   if (PetBubbleArbiter.isArbiterToken(dismissToken)) {
     defaultPetBubbleArbiter.handleDismissed(dismissToken);
     return;
   }
   if (dismissToken !== String(displayGeneration)) {
-    debug("pet.default", "bubble dismissed stale token", { dismissToken, currentGeneration: displayGeneration });
+    debug("familiar.default", "bubble dismissed stale token", { dismissToken, currentGeneration: displayGeneration });
     return;
   }
   clearDefaultPetDisplayTimers();
@@ -236,11 +236,11 @@ function handleBubbleDismissed(dismissToken: string): void {
 }
 
 function handleScaleChanged(scale: number): void {
-  debug("pet.default", "scale changed", { scale });
+  debug("familiar.default", "scale changed", { scale });
   import("./app-state.js").then(({ updatePreferences }) => {
     updatePreferences({ petScale: scale });
   }).catch((error) => {
-    console.error("Failed to update pet scale preference.", error);
+    console.error("Failed to update familiar scale preference.", error);
   });
 }
 
@@ -267,10 +267,10 @@ function getOrCreateDefaultPetWindow(): BrowserWindow {
     onPetEvent: (name, payload) => publishPluginPetEvent("default", name, payload),
   }, getCurrentDismissToken());
   const windowId = defaultPetWindow.id;
-  info("pet.default", "created", { windowId, position, paused, petId: getAppStateSnapshot().preferences.defaultPetId });
+  info("familiar.default", "created", { windowId, position, paused, petId: getAppStateSnapshot().preferences.defaultPetId });
 
   defaultPetWindow.on("closed", () => {
-    info("pet.default", "closed", { windowId });
+    info("familiar.default", "closed", { windowId });
     defaultPetWindow = null;
   });
 
@@ -278,7 +278,7 @@ function getOrCreateDefaultPetWindow(): BrowserWindow {
 }
 
 function setTransientDisplay(display: PetTransientDisplay): void {
-  debug("pet.default", "transient display set", { reaction: display.reaction, hasMessage: Boolean(display.message), hasReactionMessage: Boolean(display.reactionMessage) });
+  debug("familiar.default", "transient display set", { reaction: display.reaction, hasMessage: Boolean(display.message), hasReactionMessage: Boolean(display.reactionMessage) });
   displayGeneration++;
   transientDisplay = mergePetTransientDisplay(transientDisplay, { ...display, dismissToken: String(displayGeneration) });
   if (display.reaction) setStatusBadge(display.reaction);
@@ -321,7 +321,7 @@ function showDefaultPetForExternalEvent(): void {
   const state = getAppStateSnapshot();
   const visible = isDefaultPetVisible();
   if (!shouldShowDefaultPetForExternalEvent(visible, state.preferences.openDefaultPetOnLaunch, paused)) {
-    debug("pet.default", "external show skipped", { reason: "paused", visible, openDefaultPetOnLaunch: state.preferences.openDefaultPetOnLaunch });
+    debug("familiar.default", "external show skipped", { reason: "paused", visible, openDefaultPetOnLaunch: state.preferences.openDefaultPetOnLaunch });
     return;
   }
 
@@ -333,7 +333,7 @@ async function moveDefaultPetBy(rawX: number, rawY: number, rawDurationMs: unkno
   const window = defaultPetWindow;
   const blockedReason = getMovementBlockedReason(window);
   if (blockedReason) {
-    debug("pet.default", "move skipped", { reason: blockedReason });
+    debug("familiar.default", "move skipped", { reason: blockedReason });
     return { moved: false, reason: blockedReason };
   }
   const current = readWindowPosition(window);
@@ -344,7 +344,7 @@ async function moveDefaultPetBy(rawX: number, rawY: number, rawDurationMs: unkno
   const durationMs = clampNumber(Number(rawDurationMs ?? 700), minPluginMoveDurationMs, maxPluginMoveDurationMs);
   const steps = Math.max(8, Math.min(16, Math.round(durationMs / 100)));
   movementInProgress = true;
-  debug("pet.default", "move start", { windowId: window.id, from: current, target, durationMs, steps });
+  debug("familiar.default", "move start", { windowId: window.id, from: current, target, durationMs, steps });
   try {
     for (let step = 1; step <= steps; step += 1) {
       if (window.isDestroyed()) return { moved: false, reason: "destroyed" };
@@ -356,7 +356,7 @@ async function moveDefaultPetBy(rawX: number, rawY: number, rawDurationMs: unkno
     }
     window.setPosition(target.x, target.y, false);
     setDefaultPetPosition(target);
-    debug("pet.default", "move finished", { windowId: window.id, target });
+    debug("familiar.default", "move finished", { windowId: window.id, target });
     return { moved: true };
   } finally {
     movementInProgress = false;
@@ -382,14 +382,14 @@ function delay(ms: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-function setStatusBadge(reaction: OpenPetsReaction): void {
+function setStatusBadge(reaction: FamiliarOSReaction): void {
   if (reaction === "idle") {
     clearStatusBadge();
     return;
   }
 
   statusBadge = reaction;
-  debug("pet.default", "status badge set", { reaction, durationMs: isBusyStatusBadgeReaction(reaction) ? busyStatusBadgeMs : transientDisplayMs });
+  debug("familiar.default", "status badge set", { reaction, durationMs: isBusyStatusBadgeReaction(reaction) ? busyStatusBadgeMs : transientDisplayMs });
   if (statusBadgeTimeout) clearTimeout(statusBadgeTimeout);
   statusBadgeTimeout = setTimeout(() => {
     clearStatusBadge();
@@ -398,7 +398,7 @@ function setStatusBadge(reaction: OpenPetsReaction): void {
 }
 
 function clearStatusBadge(): void {
-  if (statusBadge) debug("pet.default", "status badge cleared", { reaction: statusBadge });
+  if (statusBadge) debug("familiar.default", "status badge cleared", { reaction: statusBadge });
   statusBadge = null;
   if (statusBadgeTimeout) clearTimeout(statusBadgeTimeout);
   statusBadgeTimeout = null;
@@ -419,7 +419,7 @@ function getCurrentDismissToken(): string | undefined {
   return transientDisplay?.dismissToken ?? (statusBadge ? String(displayGeneration) : undefined);
 }
 
-function isBusyStatusBadgeReaction(reaction: OpenPetsReaction): boolean {
+function isBusyStatusBadgeReaction(reaction: FamiliarOSReaction): boolean {
   return reaction === "thinking" || reaction === "working" || reaction === "editing" || reaction === "running" || reaction === "testing" || reaction === "waiting";
 }
 
@@ -429,7 +429,7 @@ function reclampDefaultPetWindow(): void {
   }
 
   const safePosition = readWindowPosition(defaultPetWindow);
-  info("pet.default", "reclamp position", { windowId: defaultPetWindow.id, position: safePosition });
+  info("familiar.default", "reclamp position", { windowId: defaultPetWindow.id, position: safePosition });
   defaultPetWindow.setPosition(safePosition.x, safePosition.y, false);
   setDefaultPetPosition(safePosition);
   recoverDefaultPetMouseInterop("display-change");
diff --git a/apps/desktop/src/display.ts b/apps/desktop/src/display.ts
index 7c875b4d..64447efd 100644
--- a/apps/desktop/src/display.ts
+++ b/apps/desktop/src/display.ts
@@ -27,8 +27,8 @@ export function getDefaultPetInitialPosition(size: WindowSize = defaultPetWindow
 }
 
 export function clampToVisibleWorkArea(position: Point, size: WindowSize = defaultPetWindowSize): Point {
-  // Clamp to the display the pet currently lives on (the one nearest its centre),
-  // not the primary display — otherwise a pet on an external monitor gets yanked
+  // Clamp to the display the familiar currently lives on (the one nearest its centre),
+  // not the primary display — otherwise a familiar on an external monitor gets yanked
   // back to the built-in screen whenever its position is read, saved, or restored.
   const centre = { x: position.x + size.width / 2, y: position.y + size.height / 2 };
   const { workArea } = screen.getDisplayNearestPoint(centre);
diff --git a/apps/desktop/src/pet-installation.ts b/apps/desktop/src/familiar-installation.ts
similarity index 82%
rename from apps/desktop/src/pet-installation.ts
rename to apps/desktop/src/familiar-installation.ts
index 7c2488fe..cc372e1a 100644
--- a/apps/desktop/src/pet-installation.ts
+++ b/apps/desktop/src/familiar-installation.ts
@@ -7,11 +7,11 @@ import { Transform } from "node:stream";
 import yauzl from "yauzl";
 import type { Entry, ZipFile } from "yauzl";
 
-import { getAppStateSnapshot, installPetState, removePetState, setDefaultPet, type OpenPetsStateV1 } from "./app-state.js";
+import { getAppStateSnapshot, installPetState, removePetState, setDefaultPet, type FamiliarOSStateV1 } from "./app-state.js";
 import { getCatalogPet } from "./catalog.js";
-import { maxCodexPetJsonBytes, maxCodexSpritesheetBytes, validateCodexPetMetadata, type CodexPetMetadata } from "./codex-pets-core.js";
-import { builtInPet } from "./built-in-pet.js";
-import { assertInsideRoot, assertSafePetId, getInstalledPetDir, getPetsRoot } from "./pet-paths.js";
+import { maxCodexPetJsonBytes, maxCodexSpritesheetBytes, validateCodexPetMetadata, type CodexPetMetadata } from "./codex-familiars-core.js";
+import { builtInPet } from "./built-in-familiar.js";
+import { assertInsideRoot, assertSafePetId, getInstalledPetDir, getPetsRoot } from "./familiar-paths.js";
 import { assertOutputPathInside, hasSupportedZipMagic, ZipEntryPathTracker } from "./zip-safety.js";
 
 const maxZipDownloadBytes = 50 * 1024 * 1024;
@@ -22,12 +22,12 @@ const downloadTimeoutMs = 30_000;
 
 const operations = new Set<string>();
 
-export async function installPet(petId: string): Promise<OpenPetsStateV1> {
+export async function installPet(petId: string): Promise<FamiliarOSStateV1> {
   return withPetOperation(petId, async () => {
     assertSafePetId(petId);
 
-    if (getAppStateSnapshot().pets.installed.some((pet) => pet.id === petId)) {
-      throw new Error(`Pet is already installed: ${petId}`);
+    if (getAppStateSnapshot().familiars.installed.some((familiar) => familiar.id === petId)) {
+      throw new Error(`Familiar is already installed: ${petId}`);
     }
 
     const catalogPet = await getCatalogPet(petId);
@@ -43,7 +43,7 @@ export async function installPet(petId: string): Promise<OpenPetsStateV1> {
       await extractPetZip(zip, tempDir);
       const metadata = await validateExtractedPet(tempDir);
       if (metadata.id !== petId || metadata.id !== catalogPet.id) {
-        throw new Error("Catalog pet package id does not match the requested pet.");
+        throw new Error("Catalog familiar package id does not match the requested familiar.");
       }
       await rm(finalDir, { recursive: true, force: true });
       await rename(tempDir, finalDir);
@@ -70,9 +70,9 @@ export async function installPet(petId: string): Promise<OpenPetsStateV1> {
   });
 }
 
-export async function installPetFromZipFile(zipPath: string): Promise<OpenPetsStateV1> {
+export async function installPetFromZipFile(zipPath: string): Promise<FamiliarOSStateV1> {
   return withPetOperation("local-import", async () => {
-    const zip = await readRegularFile(zipPath, maxZipDownloadBytes, "pet zip");
+    const zip = await readRegularFile(zipPath, maxZipDownloadBytes, "familiar zip");
     validateZipMagic(zip);
     const petsRoot = getPetsRoot();
     await mkdir(petsRoot, { recursive: true, mode: 0o700 });
@@ -90,18 +90,18 @@ export async function installPetFromZipFile(zipPath: string): Promise<OpenPetsSt
   });
 }
 
-export async function installPetFromFolder(folderPath: string): Promise<OpenPetsStateV1> {
+export async function installPetFromFolder(folderPath: string): Promise<FamiliarOSStateV1> {
   return withPetOperation("local-import", async () => {
     const sourceDir = resolve(folderPath);
     const sourceStats = await lstat(sourceDir);
-    if (sourceStats.isSymbolicLink()) throw new Error("Pet folder cannot be a symlink.");
-    if (!sourceStats.isDirectory()) throw new Error("Pet folder must be a directory.");
-    if (await realpath(sourceDir) !== sourceDir) throw new Error("Pet folder path is not canonical.");
-    const parsed = JSON.parse((await readRegularFile(join(sourceDir, "pet.json"), maxCodexPetJsonBytes, "pet.json")).toString("utf8")) as unknown;
+    if (sourceStats.isSymbolicLink()) throw new Error("Familiar folder cannot be a symlink.");
+    if (!sourceStats.isDirectory()) throw new Error("Familiar folder must be a directory.");
+    if (await realpath(sourceDir) !== sourceDir) throw new Error("Familiar folder path is not canonical.");
+    const parsed = JSON.parse((await readRegularFile(join(sourceDir, "familiar.json"), maxCodexPetJsonBytes, "familiar.json")).toString("utf8")) as unknown;
     const parsedId = isRecord(parsed) && typeof parsed.id === "string" ? parsed.id : basename(sourceDir);
     const metadata = validateCodexPetMetadata(parsed, parsedId);
     assertSafePetId(metadata.id);
-    if (getAppStateSnapshot().pets.installed.some((pet) => pet.id === metadata.id)) throw new Error(`Pet is already installed: ${metadata.id}`);
+    if (getAppStateSnapshot().familiars.installed.some((familiar) => familiar.id === metadata.id)) throw new Error(`Familiar is already installed: ${metadata.id}`);
     const spritesheet = await readRegularFile(join(sourceDir, metadata.spritesheetPath), maxCodexSpritesheetBytes, "spritesheet.webp");
     const petsRoot = getPetsRoot();
     await mkdir(petsRoot, { recursive: true, mode: 0o700 });
@@ -109,7 +109,7 @@ export async function installPetFromFolder(folderPath: string): Promise<OpenPets
     try {
       assertInsideRoot(petsRoot, tempDir);
       await writeFile(join(tempDir, "spritesheet.webp"), spritesheet, { mode: 0o600, flag: "wx" });
-      await writeFile(join(tempDir, "pet.json"), `${JSON.stringify(metadata, null, 2)}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
+      await writeFile(join(tempDir, "familiar.json"), `${JSON.stringify(metadata, null, 2)}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
       await finalizeLocalPetInstall(metadata, tempDir);
       return installLocalPetState(metadata);
     } catch (error) {
@@ -119,10 +119,10 @@ export async function installPetFromFolder(folderPath: string): Promise<OpenPets
   });
 }
 
-export async function removePet(petId: string): Promise<OpenPetsStateV1> {
+export async function removePet(petId: string): Promise<FamiliarOSStateV1> {
   return withPetOperation(petId, async () => {
     if (petId === builtInPet.id) {
-      throw new Error("Built-in pet cannot be removed.");
+      throw new Error("Built-in familiar cannot be removed.");
     }
     assertSafePetId(petId);
     const dir = getInstalledPetDir(petId);
@@ -130,13 +130,13 @@ export async function removePet(petId: string): Promise<OpenPetsStateV1> {
     try {
       await rm(dir, { recursive: true, force: true });
     } catch (error) {
-      throw new Error(`Pet was removed from OpenPets state, but local files could not be deleted from ${dir}. You may need to remove them manually. ${error instanceof Error ? error.message : ""}`.trim());
+      throw new Error(`Familiar was removed from FamiliarOS state, but local files could not be deleted from ${dir}. You may need to remove them manually. ${error instanceof Error ? error.message : ""}`.trim());
     }
     return state;
   });
 }
 
-export async function setDefaultInstalledPet(petId: string): Promise<OpenPetsStateV1> {
+export async function setDefaultInstalledPet(petId: string): Promise<FamiliarOSStateV1> {
   return withPetOperation(petId, async () => {
     if (petId !== builtInPet.id) {
       assertSafePetId(petId);
@@ -147,7 +147,7 @@ export async function setDefaultInstalledPet(petId: string): Promise<OpenPetsSta
 
 export async function withPetOperation<T>(key: string, callback: () => Promise<T>): Promise<T> {
   if (operations.has(key)) {
-    throw new Error("An operation for this pet is already in progress.");
+    throw new Error("An operation for this familiar is already in progress.");
   }
 
   operations.add(key);
@@ -185,8 +185,8 @@ async function downloadPetZip(zipUrl: string): Promise<Buffer> {
 function validateZipUrl(value: string): void {
   const url = new URL(value);
   if (url.protocol !== "https:") throw new Error("Zip URL must use https.");
-  if (url.hostname !== "zip.openpets.dev") throw new Error("Zip URL host is not allowed.");
-  if (!url.pathname.startsWith("/pets/")) throw new Error("Zip URL path is not allowed.");
+  if (url.hostname !== "zip.familiaros.dev") throw new Error("Zip URL host is not allowed.");
+  if (!url.pathname.startsWith("/familiars/")) throw new Error("Zip URL path is not allowed.");
   if (url.username || url.password) throw new Error("Zip URL cannot include credentials.");
   if (url.port) throw new Error("Zip URL cannot include a custom port.");
 }
@@ -260,7 +260,7 @@ async function extractPetZip(zip: Buffer, tempDir: string): Promise<void> {
 
         fileCount += 1;
         if (fileCount > maxFiles) throw new Error("Zip contains too many files.");
-        if (safePath.relativeOutputPath === "pet.json" && entry.uncompressedSize > maxCodexPetJsonBytes) throw new Error("pet.json is too large.");
+        if (safePath.relativeOutputPath === "familiar.json" && entry.uncompressedSize > maxCodexPetJsonBytes) throw new Error("familiar.json is too large.");
         if (entry.uncompressedSize > maxIndividualFileBytes) throw new Error("Zip entry is too large.");
         extractedTotal += entry.uncompressedSize;
         if (extractedTotal > maxExtractedTotalBytes) throw new Error("Zip extracted total is too large.");
@@ -268,7 +268,7 @@ async function extractPetZip(zip: Buffer, tempDir: string): Promise<void> {
         const outputPath = resolve(tempDir, safePath.relativeOutputPath);
         assertOutputPathInside(tempDir, outputPath);
         seenRequired.add(safePath.relativeOutputPath);
-        await writeEntry(entry, zipFile, outputPath, entry.uncompressedSize, safePath.relativeOutputPath === "pet.json" ? maxCodexPetJsonBytes : maxIndividualFileBytes);
+        await writeEntry(entry, zipFile, outputPath, entry.uncompressedSize, safePath.relativeOutputPath === "familiar.json" ? maxCodexPetJsonBytes : maxIndividualFileBytes);
       };
 
       zipFile.readEntry();
@@ -277,8 +277,8 @@ async function extractPetZip(zip: Buffer, tempDir: string): Promise<void> {
     zipFile.close();
   }
 
-  if (!seenRequired.has("pet.json") || !seenRequired.has("spritesheet.webp")) {
-    throw new Error("Zip must contain pet.json and spritesheet.webp.");
+  if (!seenRequired.has("familiar.json") || !seenRequired.has("spritesheet.webp")) {
+    throw new Error("Zip must contain familiar.json and spritesheet.webp.");
   }
 }
 
@@ -368,12 +368,12 @@ function writeEntry(entry: Entry, zipFile: ZipFile, outputPath: string, expected
 }
 
 async function validateExtractedPet(tempDir: string): Promise<CodexPetMetadata> {
-  const petJsonPath = join(tempDir, "pet.json");
+  const petJsonPath = join(tempDir, "familiar.json");
   const spritesheetPath = join(tempDir, "spritesheet.webp");
   assertOutputPathInside(tempDir, petJsonPath);
   assertOutputPathInside(tempDir, spritesheetPath);
 
-  const parsed = JSON.parse((await readRegularFile(petJsonPath, maxCodexPetJsonBytes, "pet.json")).toString("utf8")) as unknown;
+  const parsed = JSON.parse((await readRegularFile(petJsonPath, maxCodexPetJsonBytes, "familiar.json")).toString("utf8")) as unknown;
   const parsedId = isRecord(parsed) && typeof parsed.id === "string" ? parsed.id : basename(tempDir);
   const metadata = validateCodexPetMetadata(parsed, parsedId);
   assertSafePetId(metadata.id);
@@ -386,7 +386,7 @@ async function validateExtractedPet(tempDir: string): Promise<CodexPetMetadata>
 }
 
 async function finalizeLocalPetInstall(metadata: CodexPetMetadata, tempDir: string): Promise<void> {
-  if (getAppStateSnapshot().pets.installed.some((pet) => pet.id === metadata.id)) throw new Error(`Pet is already installed: ${metadata.id}`);
+  if (getAppStateSnapshot().familiars.installed.some((familiar) => familiar.id === metadata.id)) throw new Error(`Familiar is already installed: ${metadata.id}`);
   const petsRoot = getPetsRoot();
   const finalDir = getInstalledPetDir(metadata.id);
   assertInsideRoot(petsRoot, finalDir);
@@ -394,7 +394,7 @@ async function finalizeLocalPetInstall(metadata: CodexPetMetadata, tempDir: stri
   await rename(tempDir, finalDir);
   try {
     await validateInstalledRegularFile(join(finalDir, "spritesheet.webp"));
-    await validateInstalledRegularFile(join(finalDir, "pet.json"));
+    await validateInstalledRegularFile(join(finalDir, "familiar.json"));
   } catch (error) {
     await rm(finalDir, { recursive: true, force: true });
     throw error;
@@ -420,17 +420,17 @@ async function readRegularFile(path: string, maxBytes: number, label: string): P
 async function validateInstalledRegularFile(path: string): Promise<void> {
   const resolved = resolve(path);
   const root = getPetsRoot();
-  if (resolved !== root && !resolved.startsWith(`${root}${sep}`)) throw new Error("Installed pet file escapes pets root.");
+  if (resolved !== root && !resolved.startsWith(`${root}${sep}`)) throw new Error("Installed familiar file escapes familiars root.");
   const stats = await lstat(resolved);
-  if (stats.isSymbolicLink()) throw new Error("Imported pet file cannot be a symlink.");
-  if (!stats.isFile()) throw new Error("Imported pet file must be a regular file.");
+  if (stats.isSymbolicLink()) throw new Error("Imported familiar file cannot be a symlink.");
+  if (!stats.isFile()) throw new Error("Imported familiar file must be a regular file.");
 }
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null;
 }
 
-async function installLocalPetState(metadata: CodexPetMetadata): Promise<OpenPetsStateV1> {
+async function installLocalPetState(metadata: CodexPetMetadata): Promise<FamiliarOSStateV1> {
   try {
     return installPetState({ id: metadata.id, displayName: metadata.displayName, description: metadata.description });
   } catch (error) {
diff --git a/apps/desktop/src/pet-motion-engine.ts b/apps/desktop/src/familiar-motion-engine.ts
similarity index 96%
rename from apps/desktop/src/pet-motion-engine.ts
rename to apps/desktop/src/familiar-motion-engine.ts
index 06c57990..fe579d80 100644
--- a/apps/desktop/src/pet-motion-engine.ts
+++ b/apps/desktop/src/familiar-motion-engine.ts
@@ -1,12 +1,12 @@
 import { BrowserWindow, screen } from "electron";
 
 import { clampToVisibleWorkArea, defaultPetWindowSize, type Point } from "./display.js";
-import { isPetWindowDragging } from "./pet-window.js";
+import { isPetWindowDragging } from "./familiar-window.js";
 
 /**
  * Liveness motion primitives (§13.6): animated absolute moves, continuous
  * cursor following with lag, and lightweight gravity/bounce physics. Operates
- * on any pet window through an accessor (windows can be recreated), one loop
+ * on any familiar window through an accessor (windows can be recreated), one loop
  * per surface, paused while hidden or being dragged.
  */
 
@@ -96,7 +96,7 @@ function syncLoop(petHandleId: string, accessor: WindowAccessor, state: MotionSt
     let nextY = y;
     if (state.follow) {
       const cursor = screen.getCursorScreenPoint();
-      // Aim the pet's bottom-center near the cursor; lag controls smoothing.
+      // Aim the familiar's bottom-center near the cursor; lag controls smoothing.
       const targetX = cursor.x - Math.round(defaultPetWindowSize.width / 2);
       const targetY = cursor.y - Math.round(defaultPetWindowSize.height * 0.7);
       const smoothing = 1 - state.follow.lag;
diff --git a/apps/desktop/src/pet-paths.ts b/apps/desktop/src/familiar-paths.ts
similarity index 78%
rename from apps/desktop/src/pet-paths.ts
rename to apps/desktop/src/familiar-paths.ts
index 48b5f0e7..5812108b 100644
--- a/apps/desktop/src/pet-paths.ts
+++ b/apps/desktop/src/familiar-paths.ts
@@ -3,7 +3,7 @@ import { join, resolve, sep } from "node:path";
 import { app } from "electron";
 
 export function getPetsRoot(): string {
-  return join(app.getPath("userData"), "pets");
+  return join(app.getPath("userData"), "familiars");
 }
 
 export function getInstalledPetDir(petId: string): string {
@@ -16,7 +16,7 @@ export function getInstalledPetDir(petId: string): string {
 
 export function assertSafePetId(petId: string): void {
   if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(petId) || petId === "builtin") {
-    throw new Error(`Invalid installed pet id: ${petId}`);
+    throw new Error(`Invalid installed familiar id: ${petId}`);
   }
 }
 
@@ -25,6 +25,6 @@ export function assertInsideRoot(root: string, target: string): void {
   const resolvedTarget = resolve(target);
 
   if (resolvedTarget !== resolvedRoot && !resolvedTarget.startsWith(`${resolvedRoot}${sep}`)) {
-    throw new Error("Resolved path escapes OpenPets pets directory.");
+    throw new Error("Resolved path escapes FamiliarOS familiars directory.");
   }
 }
diff --git a/apps/desktop/src/pet-window.ts b/apps/desktop/src/familiar-window.ts
similarity index 86%
rename from apps/desktop/src/pet-window.ts
rename to apps/desktop/src/familiar-window.ts
index 211353db..707631cf 100644
--- a/apps/desktop/src/pet-window.ts
+++ b/apps/desktop/src/familiar-window.ts
@@ -6,10 +6,10 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 
 import { getAppStateSnapshot, markPetBroken, type PetScaleValue } from "./app-state.js";
 import { clampToVisibleWorkArea, defaultPetWindowSize, getDefaultPetInitialPosition, type Point } from "./display.js";
-import { builtInPet } from "./built-in-pet.js";
-import { getInstalledPetDir } from "./pet-paths.js";
+import { builtInPet } from "./built-in-familiar.js";
+import { getInstalledPetDir } from "./familiar-paths.js";
 import { getActiveLocale, getActiveLocaleLang, t } from "./i18n/index.js";
-import type { OpenPetsReaction } from "./local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "./local-ipc-protocol.js";
 import { pickReactionMessage } from "./reaction-messages.js";
 import { debug, error as logError, info, warn } from "./logger.js";
 import { executeDefaultPetPluginCommand, executeDefaultPetPluginMenuSelect, getDefaultPetPluginCommands, getDefaultPetPluginMenuItems } from "./plugin-service.js";
@@ -53,18 +53,18 @@ export interface AgentPetWindowOptions extends PetWindowInteractionHooks {
   readonly display: PetTransientDisplay | null;
   readonly badge: PetStatusBadgeReaction | null;
   readonly onCloseRequested: () => void;
-  /** Skip the right-click plugin command section (plugin-spawned pets). */
+  /** Skip the right-click plugin command section (plugin-spawned familiars). */
   readonly plainContextMenu?: boolean;
 }
 
-/** Plugin-arbiter bubble content for one pet surface (both slots). */
+/** Plugin-arbiter bubble content for one familiar surface (both slots). */
 export interface PetPluginBubbles {
   readonly transient: ActiveBubble | null;
   readonly pinned: ActiveBubble | null;
 }
 
 export interface PetTransientDisplay {
-  readonly reaction?: OpenPetsReaction;
+  readonly reaction?: FamiliarOSReaction;
   readonly message?: string;
   readonly reactionMessage?: string;
   readonly suppressReactionMessage?: boolean;
@@ -73,7 +73,7 @@ export interface PetTransientDisplay {
   readonly sticky?: boolean;
 }
 
-export type PetStatusBadgeReaction = Exclude<OpenPetsReaction, "idle">;
+export type PetStatusBadgeReaction = Exclude<FamiliarOSReaction, "idle">;
 
 interface PetContentRender {
   readonly html: string;
@@ -99,11 +99,11 @@ export function isPetWindowScaling(window: BrowserWindow): boolean {
 }
 
 export function createDefaultPetWindow(options: DefaultPetWindowOptions, dismissToken?: string): BrowserWindow {
-  const window = createBasePetWindow("OpenPets — Default Pet", options.position);
-  info("pet.window", "default window create", { windowId: window.id, position: options.position, paused: options.paused, hasDisplay: Boolean(options.display), badge: options.badge });
+  const window = createBasePetWindow("FamiliarOS — Default Familiar", options.position);
+  info("familiar.window", "default window create", { windowId: window.id, position: options.position, paused: options.paused, hasDisplay: Boolean(options.display), badge: options.badge });
   installMousePassthroughAndDrag(window, options);
   installMotionStatePublisher(window);
-  installPetContextMenu(window, { label: t("pet.menu.hidePet"), click: options.onHideRequested, defaultPet: true });
+  installPetContextMenu(window, { label: t("familiar.menu.hidePet"), click: options.onHideRequested, defaultPet: true });
 
   const savePosition = debounce(() => {
     if (window.isDestroyed()) {
@@ -116,7 +116,7 @@ export function createDefaultPetWindow(options: DefaultPetWindowOptions, dismiss
   window.on("move", savePosition);
   window.on("moved", savePosition);
   window.on("close", () => {
-    info("pet.window", "default window close", { windowId: window.id, position: readWindowPosition(window) });
+    info("familiar.window", "default window close", { windowId: window.id, position: readWindowPosition(window) });
     options.onPositionChanged(readWindowPosition(window));
   });
 
@@ -126,11 +126,11 @@ export function createDefaultPetWindow(options: DefaultPetWindowOptions, dismiss
 }
 
 export function createAgentPetWindow(options: AgentPetWindowOptions, dismissToken?: string): BrowserWindow {
-  const window = createBasePetWindow(`OpenPets — ${options.displayName}`, options.position);
-  info("pet.window", "agent window create", { windowId: window.id, petId: options.petId, displayName: options.displayName, position: options.position, hasDisplay: Boolean(options.display), badge: options.badge });
+  const window = createBasePetWindow(`FamiliarOS — ${options.displayName}`, options.position);
+  info("familiar.window", "agent window create", { windowId: window.id, petId: options.petId, displayName: options.displayName, position: options.position, hasDisplay: Boolean(options.display), badge: options.badge });
   installMousePassthroughAndDrag(window, options);
   installMotionStatePublisher(window);
-  installPetContextMenu(window, { label: t("pet.menu.closePet"), click: options.onCloseRequested });
+  installPetContextMenu(window, { label: t("familiar.menu.closePet"), click: options.onCloseRequested });
   void loadExplicitPetContent(window, options.petId, options.display, options.badge, dismissToken, options.scale);
   return window;
 }
@@ -143,7 +143,7 @@ export function recoverPetMouseInterop(window: BrowserWindow, reason: string): v
     return;
   }
 
-  debug("pet.window", "mouse interop recovery skipped", { windowId: window.id, reason, skippedReason: "unregistered-window" });
+  debug("familiar.window", "mouse interop recovery skipped", { windowId: window.id, reason, skippedReason: "unregistered-window" });
 }
 
 function installPetContextMenu(window: BrowserWindow, action: { readonly label: string; readonly click: () => void; readonly defaultPet?: boolean }): void {
@@ -151,7 +151,7 @@ function installPetContextMenu(window: BrowserWindow, action: { readonly label:
   const handleContextMenu = (event: Electron.Event): void => {
     event.preventDefault();
     if (window.isDestroyed()) return;
-    void buildPetContextMenuTemplate(action).then((template) => Menu.buildFromTemplate(template).popup({ window })).catch((error) => { logError("pet.window", "context menu build failed", error); Menu.buildFromTemplate([{ label: action.label, click: action.click }]).popup({ window }); });
+    void buildPetContextMenuTemplate(action).then((template) => Menu.buildFromTemplate(template).popup({ window })).catch((error) => { logError("familiar.window", "context menu build failed", error); Menu.buildFromTemplate([{ label: action.label, click: action.click }]).popup({ window }); });
   };
   webContents.on("context-menu", handleContextMenu);
   window.once("closed", () => {
@@ -167,7 +167,7 @@ async function buildPetContextMenuTemplate(action: { readonly label: string; rea
   const plugins = new Map<string, { name: string; commands: Electron.MenuItemConstructorOptions[]; menuItems: Electron.MenuItemConstructorOptions[] }>();
   const sorted = [...commands].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
   for (const command of sorted) {
-    const item: Electron.MenuItemConstructorOptions = { label: command.commandTitle, click: () => { if (command.form) openPluginCommandForm(command).catch((error) => logError("pet.window", "plugin command form failed", error)); else executeDefaultPetPluginCommand(command.pluginId, command.commandId).catch((error) => logError("pet.window", "plugin command failed", error)); } };
+    const item: Electron.MenuItemConstructorOptions = { label: command.commandTitle, click: () => { if (command.form) openPluginCommandForm(command).catch((error) => logError("familiar.window", "plugin command form failed", error)); else executeDefaultPetPluginCommand(command.pluginId, command.commandId).catch((error) => logError("familiar.window", "plugin command failed", error)); } };
     if (command.placement === "top" || command.featured) {
       if (command.commandId === "status") {
         topLevelStatus.push(item);
@@ -184,7 +184,7 @@ async function buildPetContextMenuTemplate(action: { readonly label: string; rea
   const menuItems = await getDefaultPetPluginMenuItems();
   for (const item of menuItems) {
     const group = plugins.get(item.pluginId) ?? { name: item.pluginName, commands: [], menuItems: [] };
-    group.menuItems.push({ label: item.title, enabled: item.enabled !== false, type: item.checked === true ? "checkbox" : "normal", checked: item.checked === true ? true : undefined, click: () => { executeDefaultPetPluginMenuSelect(item.pluginId, item.itemId).catch((error) => logError("pet.window", "plugin menu select failed", error)); } });
+    group.menuItems.push({ label: item.title, enabled: item.enabled !== false, type: item.checked === true ? "checkbox" : "normal", checked: item.checked === true ? true : undefined, click: () => { executeDefaultPetPluginMenuSelect(item.pluginId, item.itemId).catch((error) => logError("familiar.window", "plugin menu select failed", error)); } });
     plugins.set(item.pluginId, group);
   }
 
@@ -196,8 +196,8 @@ async function buildPetContextMenuTemplate(action: { readonly label: string; rea
     return { label: plugin.name, submenu };
   };
 
-  // Place the virtual-pet stats submenu directly under its top-level status command.
-  const statsPluginId = "openpets.virtual-pet";
+  // Place the virtual-familiar stats submenu directly under its top-level status command.
+  const statsPluginId = "familiaros.virtual-familiar";
   const statsGroup = plugins.get(statsPluginId);
   const statsSubmenu = statsGroup && statsGroup.menuItems.length > 0 ? buildPluginSubmenu(statsGroup) : undefined;
   if (statsGroup) plugins.delete(statsPluginId);
@@ -214,7 +214,7 @@ async function buildPetContextMenuTemplate(action: { readonly label: string; rea
     template.push(...[...plugins.values()].map(buildPluginSubmenu));
   }
   if (template.length > 0) template.push({ type: "separator" });
-  template.push({ label: t("pet.menu.openControlCenter"), click: () => { import("./windows.js").then(({ openControlCenterWindow }) => openControlCenterWindow()).catch((error) => logError("pet.window", "open control center failed", error)); } }, { label: action.label, click: action.click });
+  template.push({ label: t("familiar.menu.openControlCenter"), click: () => { import("./windows.js").then(({ openControlCenterWindow }) => openControlCenterWindow()).catch((error) => logError("familiar.window", "open control center failed", error)); } }, { label: action.label, click: action.click });
   return template;
 }
 
@@ -308,7 +308,7 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     rendererReady = false;
     lastInteractive = false;
     clearRearmTimers();
-    debug("pet.window", "mouse interop recovery", { windowId, reason });
+    debug("familiar.window", "mouse interop recovery", { windowId, reason });
     setPassthrough(false);
     if (process.platform === "win32") {
       requestCursorHitTestProbe(reason);
@@ -328,7 +328,7 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     if (process.platform === "linux") {
       // Electron does not support forwarded mouse events on Linux, so ignored
       // windows cannot receive the renderer events required to start dragging.
-      // Keep Linux pet windows interactive; this trades click-through for reliable drag.
+      // Keep Linux familiar windows interactive; this trades click-through for reliable drag.
       window.setIgnoreMouseEvents(false);
       return;
     }
@@ -366,18 +366,18 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
   const requestCursorHitTestProbe = (reason: string, logProbe = true): void => {
     if (window.isDestroyed() || webContents.isDestroyed()) return;
     const probe = getCursorProbe();
-    if (logProbe) debug("pet.window", "cursor hit-test probe", { windowId, reason, inside: probe.inside, cursor: probe.cursor, bounds: probe.bounds });
+    if (logProbe) debug("familiar.window", "cursor hit-test probe", { windowId, reason, inside: probe.inside, cursor: probe.cursor, bounds: probe.bounds });
     if (!probe.inside) return;
-    webContents.send("openpets:pet-probe-hit-test", { clientX: probe.clientX, clientY: probe.clientY, reason });
+    webContents.send("familiaros:familiar-probe-hit-test", { clientX: probe.clientX, clientY: probe.clientY, reason });
   };
 
   const rearmWindowsMouseForwarding = (reason: string, logRearm = true): void => {
     if (window.isDestroyed()) return;
     if (dragging || lastInteractive) {
-      if (logRearm) debug("pet.window", "windows mouse forwarding rearm skipped", { windowId, reason, dragging: Boolean(dragging), interactive: lastInteractive });
+      if (logRearm) debug("familiar.window", "windows mouse forwarding rearm skipped", { windowId, reason, dragging: Boolean(dragging), interactive: lastInteractive });
       return;
     }
-    if (logRearm) debug("pet.window", "windows mouse forwarding rearm", { windowId, reason });
+    if (logRearm) debug("familiar.window", "windows mouse forwarding rearm", { windowId, reason });
     window.setIgnoreMouseEvents(false);
     window.setIgnoreMouseEvents(true, { forward: true });
     requestCursorHitTestProbe(reason, logRearm);
@@ -409,7 +409,7 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
       return;
     }
 
-    // On Windows, rapid pet HTML reloads can leave Chromium's forwarded mouse
+    // On Windows, rapid familiar HTML reloads can leave Chromium's forwarded mouse
     // tracking stale while the cursor is already over the transparent window.
     // Toggle immediately, probe the current cursor hit target, then repeat the
     // toggle shortly after load because Windows sometimes re-registers mouse
@@ -428,7 +428,7 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     rendererReady = true;
     lastInteractive = Boolean(interactive);
     const sourceName = typeof source === "string" ? source : undefined;
-    if (sourceName !== "idle-forwarding-watch" || lastInteractive) debug("pet.window", "hit test", { windowId, interactive: lastInteractive, dragging, source: sourceName });
+    if (sourceName !== "idle-forwarding-watch" || lastInteractive) debug("familiar.window", "hit test", { windowId, interactive: lastInteractive, dragging, source: sourceName });
     setPassthrough(!lastInteractive && !dragging);
     if (lastInteractive || dragging) clearWindowsForwardingWatch();
     else scheduleWindowsForwardingWatch("idle-forwarding-watch");
@@ -445,10 +445,10 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     const startBounds = window.getBounds();
     dragging = { startScreenX: point.screenX, startScreenY: point.screenY, startWindowX: startBounds.x, startWindowY: startBounds.y, width: startBounds.width, height: startBounds.height };
     petWindowDragging.set(window, true);
-    debug("pet.window", "drag start", { windowId, point, startBounds });
+    debug("familiar.window", "drag start", { windowId, point, startBounds });
     clearWindowsForwardingWatch();
     setPassthrough(false);
-    onPetEvent?.("pet:dragStart", {});
+    onPetEvent?.("familiar:dragStart", {});
   };
 
   const handleDragMove = (event: IpcMainEvent, point: unknown): void => {
@@ -463,27 +463,27 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     const wasDragging = dragging !== null;
     dragging = null;
     petWindowDragging.set(window, false);
-    debug("pet.window", "drag end", { windowId, position: window.isDestroyed() ? null : readWindowPosition(window) });
+    debug("familiar.window", "drag end", { windowId, position: window.isDestroyed() ? null : readWindowPosition(window) });
     // Do not resize/re-anchor after a drag — the user already positioned the window.
-    if (wasDragging) onPetEvent?.("pet:dragEnd", {});
+    if (wasDragging) onPetEvent?.("familiar:dragEnd", {});
   };
 
   const handleBubbleDismissed = (event: IpcMainEvent, dismissToken: unknown): void => {
     if (!isFromWindow(event)) return;
-    debug("pet.window", "bubble dismissed", { windowId, dismissToken });
+    debug("familiar.window", "bubble dismissed", { windowId, dismissToken });
     if (typeof dismissToken === "string") onBubbleDismissed?.(dismissToken);
   };
 
   const handlePromptRequested = (event: IpcMainEvent): void => {
     if (!isFromWindow(event)) return;
-    debug("pet.window", "prompt requested", { windowId });
+    debug("familiar.window", "prompt requested", { windowId });
     onPromptRequested?.();
   };
 
   const handleScaleStart = (event: IpcMainEvent): void => {
     if (!isFromWindow(event) || window.isDestroyed()) return;
     petWindowScaling.set(window, true);
-    debug("pet.window", "scale start", { windowId });
+    debug("familiar.window", "scale start", { windowId });
     setPassthrough(false);
   };
 
@@ -498,7 +498,7 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     if (!isFromWindow(event)) return;
     petWindowScaling.set(window, false);
     const scale = isRecord(payload) && typeof payload.scale === "number" ? payload.scale : undefined;
-    debug("pet.window", "scale end", { windowId, scale });
+    debug("familiar.window", "scale end", { windowId, scale });
     if (scale !== undefined && Number.isFinite(scale)) {
       onScaleChanged?.(scale);
     }
@@ -507,13 +507,13 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
 
   const handleBubbleAction = (event: IpcMainEvent, dismissToken: unknown, actionId: unknown): void => {
     if (!isFromWindow(event)) return;
-    debug("pet.window", "bubble action", { windowId, dismissToken, actionId });
+    debug("familiar.window", "bubble action", { windowId, dismissToken, actionId });
     if (typeof dismissToken === "string" && typeof actionId === "string" && actionId.length <= 64) onBubbleAction?.(dismissToken, actionId);
   };
 
   const handleBubbleSubmit = (event: IpcMainEvent, dismissToken: unknown, values: unknown): void => {
     if (!isFromWindow(event)) return;
-    debug("pet.window", "bubble submit", { windowId, dismissToken });
+    debug("familiar.window", "bubble submit", { windowId, dismissToken });
     if (typeof dismissToken !== "string" || typeof values !== "object" || values === null) return;
     const out: Record<string, string | number> = {};
     for (const [key, value] of Object.entries(values as Record<string, unknown>).slice(0, 8)) {
@@ -523,12 +523,12 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     onBubbleSubmit?.(dismissToken, out);
   };
 
-  const allowedPetEventNames = new Set(["pet:clicked", "pet:doubleClicked", "pet:hover", "pet:drop"]);
+  const allowedPetEventNames = new Set(["familiar:clicked", "familiar:doubleClicked", "familiar:hover", "familiar:drop"]);
   const handlePetEvent = (event: IpcMainEvent, name: unknown, payload: unknown): void => {
     if (!isFromWindow(event)) return;
     if (typeof name !== "string" || !allowedPetEventNames.has(name)) return;
     const data = typeof payload === "object" && payload !== null && !Array.isArray(payload) ? payload as Record<string, unknown> : {};
-    if (name !== "pet:hover") debug("pet.window", "pet event", { windowId, name });
+    if (name !== "familiar:hover") debug("familiar.window", "familiar event", { windowId, name });
     onPetEvent?.(name, data);
   };
 
@@ -538,7 +538,7 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     rendererReady = false;
     lastInteractive = false;
     clearRearmTimers();
-    debug("pet.window", "navigation reset passthrough", { windowId });
+    debug("familiar.window", "navigation reset passthrough", { windowId });
     setPassthrough(false);
   };
 
@@ -546,7 +546,7 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
     dragging = null;
     petWindowDragging.set(window, false);
     lastInteractive = false;
-    debug("pet.window", "load rearm passthrough", { windowId });
+    debug("familiar.window", "load rearm passthrough", { windowId });
     rearmPassthroughAfterLoad();
   };
 
@@ -557,26 +557,26 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
   const handleLoadFailure = (): void => {
     dragging = null;
     lastInteractive = false;
-    debug("pet.window", "load failure rearm passthrough", { windowId });
+    debug("familiar.window", "load failure rearm passthrough", { windowId });
     setPassthrough(true);
   };
 
   const removeListeners = (): void => {
     if (listenersRemoved) return;
     listenersRemoved = true;
-    ipcMain.off("openpets:pet-ready", handleReady);
-    ipcMain.off("openpets:pet-hit-test", handleHitTest);
-    ipcMain.off("openpets:pet-drag-start", handleDragStart);
-    ipcMain.off("openpets:pet-drag-move", handleDragMove);
-    ipcMain.off("openpets:pet-drag-end", handleDragEnd);
-    ipcMain.off("openpets:bubble-dismissed", handleBubbleDismissed);
-    ipcMain.off("openpets:pet-open-prompt", handlePromptRequested);
-    ipcMain.off("openpets:pet-scale-start", handleScaleStart);
-    ipcMain.off("openpets:pet-scale-preview", handleScalePreview);
-    ipcMain.off("openpets:pet-scale-end", handleScaleEnd);
-    ipcMain.off("openpets:bubble-action", handleBubbleAction);
-    ipcMain.off("openpets:bubble-submit", handleBubbleSubmit);
-    ipcMain.off("openpets:pet-event", handlePetEvent);
+    ipcMain.off("familiaros:familiar-ready", handleReady);
+    ipcMain.off("familiaros:familiar-hit-test", handleHitTest);
+    ipcMain.off("familiaros:familiar-drag-start", handleDragStart);
+    ipcMain.off("familiaros:familiar-drag-move", handleDragMove);
+    ipcMain.off("familiaros:familiar-drag-end", handleDragEnd);
+    ipcMain.off("familiaros:bubble-dismissed", handleBubbleDismissed);
+    ipcMain.off("familiaros:familiar-open-prompt", handlePromptRequested);
+    ipcMain.off("familiaros:familiar-scale-start", handleScaleStart);
+    ipcMain.off("familiaros:familiar-scale-preview", handleScalePreview);
+    ipcMain.off("familiaros:familiar-scale-end", handleScaleEnd);
+    ipcMain.off("familiaros:bubble-action", handleBubbleAction);
+    ipcMain.off("familiaros:bubble-submit", handleBubbleSubmit);
+    ipcMain.off("familiaros:familiar-event", handlePetEvent);
     clearRearmTimers();
     clearWindowsForwardingWatch();
     petMouseInteropRecovery.delete(window);
@@ -593,19 +593,19 @@ function installMousePassthroughAndDrag(window: BrowserWindow, hooks: PetWindowI
 
   petMouseInteropRecovery.set(window, scheduleMouseInteropRecovery);
 
-  ipcMain.on("openpets:pet-ready", handleReady);
-  ipcMain.on("openpets:pet-hit-test", handleHitTest);
-  ipcMain.on("openpets:pet-drag-start", handleDragStart);
-  ipcMain.on("openpets:pet-drag-move", handleDragMove);
-  ipcMain.on("openpets:pet-drag-end", handleDragEnd);
-  ipcMain.on("openpets:bubble-dismissed", handleBubbleDismissed);
-  ipcMain.on("openpets:pet-open-prompt", handlePromptRequested);
-  ipcMain.on("openpets:pet-scale-start", handleScaleStart);
-  ipcMain.on("openpets:pet-scale-preview", handleScalePreview);
-  ipcMain.on("openpets:pet-scale-end", handleScaleEnd);
-  ipcMain.on("openpets:bubble-action", handleBubbleAction);
-  ipcMain.on("openpets:bubble-submit", handleBubbleSubmit);
-  ipcMain.on("openpets:pet-event", handlePetEvent);
+  ipcMain.on("familiaros:familiar-ready", handleReady);
+  ipcMain.on("familiaros:familiar-hit-test", handleHitTest);
+  ipcMain.on("familiaros:familiar-drag-start", handleDragStart);
+  ipcMain.on("familiaros:familiar-drag-move", handleDragMove);
+  ipcMain.on("familiaros:familiar-drag-end", handleDragEnd);
+  ipcMain.on("familiaros:bubble-dismissed", handleBubbleDismissed);
+  ipcMain.on("familiaros:familiar-open-prompt", handlePromptRequested);
+  ipcMain.on("familiaros:familiar-scale-start", handleScaleStart);
+  ipcMain.on("familiaros:familiar-scale-preview", handleScalePreview);
+  ipcMain.on("familiaros:familiar-scale-end", handleScaleEnd);
+  ipcMain.on("familiaros:bubble-action", handleBubbleAction);
+  ipcMain.on("familiaros:bubble-submit", handleBubbleSubmit);
+  ipcMain.on("familiaros:familiar-event", handlePetEvent);
   webContents.on("did-start-navigation", resetForNavigation);
   webContents.on("did-start-loading", resetForNavigation);
   webContents.on("did-finish-load", rearmAfterLoad);
@@ -641,7 +641,7 @@ function createBasePetWindow(title: string, position: Point): BrowserWindow {
       nodeIntegration: false,
       contextIsolation: true,
       sandbox: true,
-      preload: resolvePreloadPath("pet-preload.cjs"),
+      preload: resolvePreloadPath("familiar-preload.cjs"),
     },
   });
 
@@ -650,7 +650,7 @@ function createBasePetWindow(title: string, position: Point): BrowserWindow {
   window.on("show", () => applyPetAlwaysOnTop(window));
   window.on("restore", () => applyPetAlwaysOnTop(window));
 
-  // Show the pet window on all macOS Spaces (desktop workspaces).
+  // Show the familiar window on all macOS Spaces (desktop workspaces).
   // Without this, the window is bound to the Space where it was created
   // and disappears when the user switches to another Space.
   if (process.platform === "darwin") {
@@ -666,18 +666,18 @@ function createBasePetWindow(title: string, position: Point): BrowserWindow {
     event.preventDefault();
   });
   window.webContents.on("did-fail-load", (_event, errorCode, errorDescription) => {
-    logError("pet.window", "renderer load failed", { windowId: window.id, errorCode, errorDescription });
-    console.error("Failed to load default pet window.", { errorCode, errorDescription });
+    logError("familiar.window", "renderer load failed", { windowId: window.id, errorCode, errorDescription });
+    console.error("Failed to load default familiar window.", { errorCode, errorDescription });
   });
   window.webContents.on("console-message", (_event, level, message, line, sourceId) => {
     const fields = { windowId: window.id, level, line, sourceId, message };
-    if (level >= 3) logError("pet.window", "renderer console", fields);
-    else if (level === 2) warn("pet.window", "renderer console", fields);
-    else debug("pet.window", "renderer console", fields);
+    if (level >= 3) logError("familiar.window", "renderer console", fields);
+    else if (level === 2) warn("familiar.window", "renderer console", fields);
+    else debug("familiar.window", "renderer console", fields);
   });
   window.webContents.on("render-process-gone", (_event, details) => {
-    logError("pet.window", "renderer process gone", { windowId: window.id, details });
-    console.error("Default pet renderer process gone.", details);
+    logError("familiar.window", "renderer process gone", { windowId: window.id, details });
+    console.error("Default familiar renderer process gone.", details);
   });
 
   return window;
@@ -698,7 +698,7 @@ export async function loadDefaultPetContent(window: BrowserWindow, paused: boole
   const scale = getAppStateSnapshot().preferences.petScale as PetScaleValue;
   petWindowLastDisplay.set(window, display);
   resizePetWindowForDisplay(window, scale, display);
-  debug("pet.window", "default content render begin", { windowId: window.id, sequence, paused, hasDisplay: Boolean(display), reaction: display?.reaction, hasMessage: Boolean(display?.message), fullMessage: display?.fullMessage === true, badge, hasPluginBubble: Boolean(pluginBubbles?.transient), hasPinned: Boolean(pluginBubbles?.pinned), defaultPetId: getAppStateSnapshot().preferences.defaultPetId });
+  debug("familiar.window", "default content render begin", { windowId: window.id, sequence, paused, hasDisplay: Boolean(display), reaction: display?.reaction, hasMessage: Boolean(display?.message), fullMessage: display?.fullMessage === true, badge, hasPluginBubble: Boolean(pluginBubbles?.transient), hasPinned: Boolean(pluginBubbles?.pinned), defaultPetId: getAppStateSnapshot().preferences.defaultPetId });
   const render = await createDefaultPetRender(paused, display, badge, dismissToken, pluginBubbles);
   applyLinuxPetWindowShape(window, scale, Boolean(display?.message || display?.reactionMessage || display?.reaction || badge || paused || pluginBubbles?.transient || pluginBubbles?.pinned));
   if (tryUpdateLoadedPetContent(window, render, "default", sequence)) return;
@@ -706,8 +706,8 @@ export async function loadDefaultPetContent(window: BrowserWindow, paused: boole
     petWindowRenderCache.set(window, render.cacheKey);
     sendBubbleLayout(window, getPetWindowSize(window, scale, display));
   }).catch((error: unknown) => {
-    logError("pet.window", "default content load failed", error instanceof Error ? error : { error });
-    console.error("Failed to load default pet URL.", error);
+    logError("familiar.window", "default content load failed", error instanceof Error ? error : { error });
+    console.error("Failed to load default familiar URL.", error);
   });
 }
 
@@ -716,22 +716,22 @@ export async function loadExplicitPetContent(window: BrowserWindow, petId: strin
   petWindowLastDisplay.set(window, display);
   try {
     const state = getAppStateSnapshot();
-    const pet = state.pets.installed.find((candidate) => candidate.id === petId);
-    if (!pet || pet.broken || pet.id === builtInPet.id) {
-      throw new Error(`Cannot render explicit pet: ${petId}`);
+    const familiar = state.familiars.installed.find((candidate) => candidate.id === petId);
+    if (!familiar || familiar.broken || familiar.id === builtInPet.id) {
+      throw new Error(`Cannot render explicit familiar: ${petId}`);
     }
-    debug("pet.window", "explicit content render begin", { windowId: window.id, sequence, petId, displayName: pet.displayName, hasDisplay: Boolean(display), reaction: display?.reaction, hasMessage: Boolean(display?.message), fullMessage: display?.fullMessage === true, badge });
+    debug("familiar.window", "explicit content render begin", { windowId: window.id, sequence, petId, displayName: familiar.displayName, hasDisplay: Boolean(display), reaction: display?.reaction, hasMessage: Boolean(display?.message), fullMessage: display?.fullMessage === true, badge });
     const scale = scaleOverride ?? state.preferences.petScale as PetScaleValue;
     resizePetWindowForDisplay(window, scale, display);
-    const render = await createInstalledPetRender(pet.id, pet.displayName, false, display, scale, badge, `explicit:${pet.id}`, dismissToken, pluginBubbles);
+    const render = await createInstalledPetRender(familiar.id, familiar.displayName, false, display, scale, badge, `explicit:${familiar.id}`, dismissToken, pluginBubbles);
     applyLinuxPetWindowShape(window, scale, Boolean(display?.message || display?.reactionMessage || display?.reaction || badge || pluginBubbles?.transient || pluginBubbles?.pinned));
-    if (tryUpdateLoadedPetContent(window, render, `explicit-${pet.id}`, sequence)) return;
-    await loadPetHtmlFile(window, render.html, `explicit-${pet.id}`, sequence);
+    if (tryUpdateLoadedPetContent(window, render, `explicit-${familiar.id}`, sequence)) return;
+    await loadPetHtmlFile(window, render.html, `explicit-${familiar.id}`, sequence);
     petWindowRenderCache.set(window, render.cacheKey);
     sendBubbleLayout(window, getPetWindowSize(window, scale, display));
   } catch (error: unknown) {
-    logError("pet.window", "explicit content load failed", error instanceof Error ? error : { petId, error });
-    console.error(`Failed to load explicit pet ${petId} URL.`, error);
+    logError("familiar.window", "explicit content load failed", error instanceof Error ? error : { petId, error });
+    console.error(`Failed to load explicit familiar ${petId} URL.`, error);
   }
 }
 
@@ -768,43 +768,43 @@ export function clearTransientReaction(display: PetTransientDisplay): PetTransie
 
 export function setPetReactionState(window: BrowserWindow, state: UniversalSpriteState): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:pet-reaction-state", state);
+  window.webContents.send("familiaros:familiar-reaction-state", state);
 }
 
-/** Override the pet sprite with a plugin-bundled spritesheet strip (§5), or clear with null. */
+/** Override the familiar sprite with a plugin-bundled spritesheet strip (§5), or clear with null. */
 export function setPetSpriteOverride(window: BrowserWindow, override: { readonly filePath: string; readonly fps: number; readonly loop: boolean } | null): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:pet-sprite-override", override ? { fileUrl: pathToFileURL(override.filePath).toString(), fps: override.fps, loop: override.loop } : null);
+  window.webContents.send("familiaros:familiar-sprite-override", override ? { fileUrl: pathToFileURL(override.filePath).toString(), fps: override.fps, loop: override.loop } : null);
 }
 
-/** Scale override for a single pet window (plugin setScale). */
+/** Scale override for a single familiar window (plugin setScale). */
 export function setPetWindowScale(window: BrowserWindow, scale: number): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:pet-scale-override", scale);
+  window.webContents.send("familiaros:familiar-scale-override", scale);
 }
 
 export type PetWindowAudioPayload = { readonly kind: "named"; readonly name: string; readonly volume: number } | { readonly kind: "data"; readonly dataUrl: string; readonly volume: number };
 
-/** Play a sound through the pet window's WebAudio pipeline. */
+/** Play a sound through the familiar window's WebAudio pipeline. */
 export function playPetWindowAudio(window: BrowserWindow, payload: PetWindowAudioPayload): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:play-audio", payload);
+  window.webContents.send("familiaros:play-audio", payload);
 }
 
 export function stopPetWindowAudio(window: BrowserWindow): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:stop-audio");
+  window.webContents.send("familiaros:stop-audio");
 }
 
 /** Speak text via the renderer speechSynthesis voice (plugin voice.speak). */
 export function speakPetWindowTts(window: BrowserWindow, text: string, opts: { readonly voice?: string; readonly rate?: number }): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:tts-speak", { text, voice: opts.voice, rate: opts.rate });
+  window.webContents.send("familiaros:tts-speak", { text, voice: opts.voice, rate: opts.rate });
 }
 
 export function stopPetWindowTts(window: BrowserWindow): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:tts-stop");
+  window.webContents.send("familiaros:tts-stop");
 }
 
 function tryUpdateLoadedPetContent(window: BrowserWindow, render: PetContentRender, name: string, sequence: number): boolean {
@@ -812,8 +812,8 @@ function tryUpdateLoadedPetContent(window: BrowserWindow, render: PetContentRend
   if (petWindowRenderCache.get(window) !== render.cacheKey) return false;
   const url = window.webContents.getURL();
   if (!isAllowedPetDocumentUrl(url)) return false;
-  debug("pet.window", "content update in place", { windowId: window.id, name, sequence, reactionState: render.reactionState });
-  window.webContents.send("openpets:pet-content-state", { bodyHtml: render.bodyHtml, reactionState: render.reactionState });
+  debug("familiar.window", "content update in place", { windowId: window.id, name, sequence, reactionState: render.reactionState });
+  window.webContents.send("familiaros:familiar-content-state", { bodyHtml: render.bodyHtml, reactionState: render.reactionState });
   return true;
 }
 
@@ -868,9 +868,9 @@ function applyLinuxPetWindowShape(window: BrowserWindow, scale: PetScaleValue, h
 
   try {
     window.setShape(shape);
-    debug("pet.window", "linux window shape applied", { windowId: window.id, scale, hasBubble, shape });
+    debug("familiar.window", "linux window shape applied", { windowId: window.id, scale, hasBubble, shape });
   } catch (error) {
-    logError("pet.window", "linux window shape failed", error instanceof Error ? error : { error });
+    logError("familiar.window", "linux window shape failed", error instanceof Error ? error : { error });
   }
 }
 
@@ -882,7 +882,7 @@ async function createDefaultPetRender(paused: boolean, display: PetTransientDisp
 
   const spriteUrl = pathToFileURL(join(app.getAppPath(), "assets", defaultPetSprite.fileName)).toString();
   const hasPinned = Boolean(pluginBubbles?.pinned);
-  const bodyHtml = createPetBodyMarkup("OpenPets default pet", createBubbleMarkup(display, paused, badge, dismissToken, pluginBubbles), `<div class="sprite" role="img" aria-label="Claude animated default pet"></div>`, createPinnedBubbleMarkup(pluginBubbles), hasPinned);
+  const bodyHtml = createPetBodyMarkup("FamiliarOS default familiar", createBubbleMarkup(display, paused, badge, dismissToken, pluginBubbles), `<div class="sprite" role="img" aria-label="Claude animated default familiar"></div>`, createPinnedBubbleMarkup(pluginBubbles), hasPinned);
   const reactionState = getReactionSpriteState(display?.reaction);
   const stateRows = defaultPetSprite.states;
   const scale = getAppStateSnapshot().preferences.petScale as PetScaleValue;
@@ -897,7 +897,7 @@ async function createDefaultPetRender(paused: boolean, display: PetTransientDisp
         <meta charset="utf-8" />
         <meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src file: data:; style-src 'unsafe-inline'; base-uri 'none'; form-action 'none'; frame-src 'none'" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>OpenPets Default Pet</title>
+        <title>FamiliarOS Default Familiar</title>
         <style>
           ${createPetWindowCss(paused, scale)}
           .sprite {
@@ -911,13 +911,13 @@ async function createDefaultPetRender(paused: boolean, display: PetTransientDisp
             --sprite-duration: ${stateRows.idle.durationMs}ms;
             --sprite-iterations: ${stateRows.idle.iterations};
             background-position: 0 var(--sprite-row-y);
-            animation: pet-frames var(--sprite-duration) steps(var(--sprite-frames)) var(--sprite-iterations);
+            animation: familiar-frames var(--sprite-duration) steps(var(--sprite-frames)) var(--sprite-iterations);
             animation-play-state: var(--play-state);
             transform: scale(${scale});
             transform-origin: top left;
           }
           ${createSpriteStateCss(".sprite")}
-          @keyframes pet-frames {
+          @keyframes familiar-frames {
             from { background-position: 0 var(--sprite-row-y); }
             to { background-position: calc(-${defaultPetSprite.frameWidth}px * var(--sprite-frames)) var(--sprite-row-y); }
           }
@@ -932,7 +932,7 @@ async function createDefaultPetRender(paused: boolean, display: PetTransientDisp
 
 async function tryCreateInstalledPetRender(paused: boolean, display: PetTransientDisplay | null, badge: PetStatusBadgeReaction | null, dismissToken?: string, pluginBubbles: PetPluginBubbles | null = null): Promise<PetContentRender | null> {
   const state = getAppStateSnapshot();
-  const selected = state.pets.installed.find((pet) => pet.id === state.preferences.defaultPetId);
+  const selected = state.familiars.installed.find((familiar) => familiar.id === state.preferences.defaultPetId);
 
   if (!selected || selected.id === builtInPet.id || selected.broken) {
     return null;
@@ -941,11 +941,11 @@ async function tryCreateInstalledPetRender(paused: boolean, display: PetTransien
   try {
     return await createInstalledPetRender(selected.id, selected.displayName, paused, display, state.preferences.petScale as PetScaleValue, badge, `default:${selected.id}`, dismissToken, pluginBubbles);
   } catch (error) {
-    console.error(`Failed to render installed default pet ${selected.id}; falling back to built-in pet.`, error);
+    console.error(`Failed to render installed default familiar ${selected.id}; falling back to built-in familiar.`, error);
     try {
-      markPetBroken(selected.id, error instanceof Error ? error.message : "Installed pet rendering failed.");
+      markPetBroken(selected.id, error instanceof Error ? error.message : "Installed familiar rendering failed.");
     } catch (markError) {
-      console.error(`Failed to mark installed pet ${selected.id} broken.`, markError);
+      console.error(`Failed to mark installed familiar ${selected.id} broken.`, markError);
     }
     return null;
   }
@@ -955,7 +955,7 @@ async function createInstalledPetRender(petId: string, displayName: string, paus
   const spritesheetPath = join(getInstalledPetDir(petId), "spritesheet.webp");
   const spritesheet = await stat(spritesheetPath);
   if (!spritesheet.isFile() || spritesheet.size <= 0 || spritesheet.size > 100 * 1024 * 1024) {
-    throw new Error("Installed pet spritesheet is missing or too large.");
+    throw new Error("Installed familiar spritesheet is missing or too large.");
   }
 
   const imageUrl = pathToFileURL(spritesheetPath).toString();
@@ -974,7 +974,7 @@ async function createInstalledPetRender(petId: string, displayName: string, paus
           <meta charset="utf-8" />
           <meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src file: data:; style-src 'unsafe-inline'; base-uri 'none'; form-action 'none'; frame-src 'none'" />
           <meta name="viewport" content="width=device-width, initial-scale=1" />
-          <title>OpenPets Default Pet</title>
+          <title>FamiliarOS Default Familiar</title>
           <style>
             ${createPetWindowCss(paused, scale)}
             .installed-card { width: ${Math.ceil(defaultPetSprite.frameWidth * scale)}px; height: ${Math.ceil(defaultPetSprite.frameHeight * scale)}px; overflow: visible; position: relative; }
@@ -992,13 +992,13 @@ async function createInstalledPetRender(petId: string, displayName: string, paus
               --sprite-duration: ${stateRows.idle.durationMs}ms;
               --sprite-iterations: ${stateRows.idle.iterations};
               background-position: 0 var(--sprite-row-y);
-              animation: pet-frames var(--sprite-duration) steps(var(--sprite-frames)) var(--sprite-iterations);
+              animation: familiar-frames var(--sprite-duration) steps(var(--sprite-frames)) var(--sprite-iterations);
               animation-play-state: var(--play-state);
               transform: scale(${scale});
               transform-origin: top left;
             }
             ${createSpriteStateCss(".installed-sprite")}
-            @keyframes pet-frames {
+            @keyframes familiar-frames {
               from { background-position: 0 var(--sprite-row-y); }
               to { background-position: calc(-${defaultPetSprite.frameWidth}px * var(--sprite-frames)) var(--sprite-row-y); }
             }
@@ -1015,8 +1015,8 @@ function createPetBodyMarkup(stageLabel: string, bubble: string, spriteMarkup: s
   return `<div class="stage${hasPinned ? " has-pinned" : ""}" aria-label="${stageLabel}">
     ${pinnedBubble}
     ${bubble}
-    <div class="pet-hitbox" aria-hidden="true">
-      <div class="pet-shell">
+    <div class="familiar-hitbox" aria-hidden="true">
+      <div class="familiar-shell">
         ${spriteMarkup}
       </div>
     </div>
@@ -1044,13 +1044,13 @@ function createPetWindowCss(paused: boolean, scale: PetScaleValue, layout?: Part
       --bubble-max-height-long: ${bubbleMaxHeightLong}px;
       --bubble-max-height-very-long: ${bubbleMaxHeightVeryLong}px;
     }
-    :root { color-scheme: dark; --pet-opacity: ${opacity}; --play-state: ${playState}; }
+    :root { color-scheme: dark; --familiar-opacity: ${opacity}; --play-state: ${playState}; }
     html, body { width: 100%; height: 100%; margin: 0; overflow: hidden; background: transparent; user-select: none; -webkit-font-smoothing: antialiased; }
     html { color: #172033; }
     body { -webkit-app-region: no-drag; pointer-events: none; }
     .stage { width: 100%; height: 100%; position: relative; box-sizing: border-box; overflow: visible; }
-    .pet-hitbox { position: absolute; left: 50%; bottom: ${Math.max(0, petBottom - hitPadding)}px; z-index: 1; width: ${scaledWidth + hitPadding * 2}px; height: ${scaledHeight + hitPadding * 2}px; display: grid; place-items: center; transform: translateX(-50%); pointer-events: auto; -webkit-app-region: no-drag; cursor: grab; }
-    .pet-shell { position: relative; width: ${scaledWidth}px; height: ${scaledHeight}px; display: block; opacity: var(--pet-opacity); filter: ${petShellFilter}; transition-property: opacity, filter; transition-duration: 180ms; transition-timing-function: cubic-bezier(0.2, 0, 0, 1); pointer-events: auto; -webkit-app-region: no-drag; cursor: grab; }
+    .familiar-hitbox { position: absolute; left: 50%; bottom: ${Math.max(0, petBottom - hitPadding)}px; z-index: 1; width: ${scaledWidth + hitPadding * 2}px; height: ${scaledHeight + hitPadding * 2}px; display: grid; place-items: center; transform: translateX(-50%); pointer-events: auto; -webkit-app-region: no-drag; cursor: grab; }
+    .familiar-shell { position: relative; width: ${scaledWidth}px; height: ${scaledHeight}px; display: block; opacity: var(--familiar-opacity); filter: ${petShellFilter}; transition-property: opacity, filter; transition-duration: 180ms; transition-timing-function: cubic-bezier(0.2, 0, 0, 1); pointer-events: auto; -webkit-app-region: no-drag; cursor: grab; }
     .bubble { position: absolute; left: 50%; bottom: ${bubbleBottom}px; z-index: 4; box-sizing: border-box; display: inline-flex; flex-direction: column; width: fit-content; min-width: 92px; max-width: min(var(--bubble-max-width), calc(100vw - 24px)); max-height: min(var(--bubble-max-height), calc(100vh - ${bubbleBottom + 16}px)); padding: 10px 12px; background: linear-gradient(135deg, rgba(239, 246, 255, 0.97), rgba(237, 233, 254, 0.96)); color: #172033; font: 760 11px/14px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; text-align: left; border: 1px solid rgba(255, 255, 255, 0.78); border-radius: 14px; box-shadow: 0 12px 24px rgba(15, 23, 42, 0.16), 0 2px 5px rgba(15, 23, 42, 0.12), inset 0 1px 0 rgba(255, 255, 255, 0.82); white-space: normal; overflow-wrap: break-word; word-break: normal; overflow: visible; pointer-events: auto; -webkit-app-region: no-drag; opacity: 1; backdrop-filter: ${bubbleBackdropFilter}; transform: translateX(-50%); transform-origin: 64% 100%; animation: bubble-in 180ms cubic-bezier(0.2, 0, 0, 1); }
     .bubble.is-below { bottom: auto; top: ${bubbleTop}px; transform-origin: 64% 0; }
     .bubble.is-below::after { top: -7px; bottom: auto; border: none; border-top: 1px solid rgba(255, 255, 255, 0.56); border-left: 1px solid rgba(255, 255, 255, 0.56); border-bottom-right-radius: 0; border-top-left-radius: 3px; transform: translateX(-50%) rotate(45deg); }
@@ -1144,7 +1144,7 @@ function createPetWindowCss(paused: boolean, scale: PetScaleValue, layout?: Part
     .bubble.is-pinned.accent-red { background: linear-gradient(135deg, rgba(254, 226, 226, 0.94), rgba(254, 202, 202, 0.92)); }
     .bubble.is-pinned.accent-pink { background: linear-gradient(135deg, rgba(252, 231, 243, 0.94), rgba(251, 207, 232, 0.92)); }
     .bubble.is-pinned.accent-slate { background: linear-gradient(135deg, rgba(241, 245, 249, 0.94), rgba(226, 232, 240, 0.92)); }
-    .stage.has-pinned .pet-hitbox { bottom: ${Math.max(0, petBottom - hitPadding) + 28}px; }
+    .stage.has-pinned .familiar-hitbox { bottom: ${Math.max(0, petBottom - hitPadding) + 28}px; }
     .stage.has-pinned .bubble:not(.is-pinned) { bottom: ${bubbleBottom + 28}px; }
     .bubble.is-plugin.accent-blue { background: linear-gradient(135deg, rgba(219, 234, 254, 0.97), rgba(191, 219, 254, 0.94)); }
     .bubble.is-plugin.accent-purple { background: linear-gradient(135deg, rgba(237, 233, 254, 0.97), rgba(221, 214, 254, 0.94)); }
@@ -1253,7 +1253,7 @@ function createSpriteRule(selector: string, state: UniversalSpriteState): string
   return `${selector} { --sprite-row-y: -${row.row * defaultPetSprite.frameHeight}px; --sprite-frames: ${row.frames}; --sprite-duration: ${row.durationMs}ms; --sprite-iterations: ${iterations}; }`;
 }
 
-function getReactionSpriteState(reaction: OpenPetsReaction | undefined): UniversalSpriteState {
+function getReactionSpriteState(reaction: FamiliarOSReaction | undefined): UniversalSpriteState {
   return resolveReactionSpriteState(reaction, getAppStateSnapshot().preferences.reactionAnimationOverrides);
 }
 
@@ -1375,7 +1375,7 @@ export function pluginBubblesCacheKey(pluginBubbles: PetPluginBubbles | null): s
 function createBubbleMarkup(display: PetTransientDisplay | null, paused: boolean, badgeReaction: PetStatusBadgeReaction | null, dismissToken?: string, pluginBubbles: PetPluginBubbles | null = null): string {
   if (pluginBubbles?.transient) return createPluginBubbleMarkup(pluginBubbles.transient, false);
   const suppressReactionMessage = display?.suppressReactionMessage === true;
-  const text = display?.message ?? display?.reactionMessage ?? (!suppressReactionMessage && display?.reaction ? pickReactionMessage(display.reaction, Math.random, getActiveLocale()) : undefined) ?? (paused ? t("pet.paused") : "");
+  const text = display?.message ?? display?.reactionMessage ?? (!suppressReactionMessage && display?.reaction ? pickReactionMessage(display.reaction, Math.random, getActiveLocale()) : undefined) ?? (paused ? t("familiar.paused") : "");
   const status = !paused && !suppressReactionMessage && badgeReaction ? getStatusBadge(badgeReaction) : null;
   if (!text && !status) return "";
   const isExplicitMessage = Boolean(display?.message && !display?.reactionMessage);
@@ -1396,14 +1396,14 @@ const statusBadgeIcons = {
 } as const;
 
 function getStatusBadge(reaction: PetStatusBadgeReaction): { readonly className: string; readonly icon?: string; readonly iconSvg?: string; readonly label: string } | null {
-  if (reaction === "thinking") return { className: "is-busy", icon: "", label: t("pet.status.thinking") };
-  if (reaction === "working" || reaction === "running") return { className: "is-busy", icon: "", label: t("pet.status.working") };
-  if (reaction === "editing") return { className: "is-busy", icon: "", label: t("pet.status.editing") };
-  if (reaction === "testing") return { className: "is-busy", icon: "", label: t("pet.status.testing") };
-  if (reaction === "waiting") return { className: "is-waiting", icon: "", label: t("pet.status.waiting") };
-  if (reaction === "success" || reaction === "celebrating") return { className: "is-success", iconSvg: statusBadgeIcons.check, label: t("pet.status.done") };
-  if (reaction === "error") return { className: "is-error", iconSvg: statusBadgeIcons.alert, label: t("pet.status.oops") };
-  if (reaction === "waving") return { className: "is-info", iconSvg: statusBadgeIcons.wavingHand, label: t("pet.status.hi") };
+  if (reaction === "thinking") return { className: "is-busy", icon: "", label: t("familiar.status.thinking") };
+  if (reaction === "working" || reaction === "running") return { className: "is-busy", icon: "", label: t("familiar.status.working") };
+  if (reaction === "editing") return { className: "is-busy", icon: "", label: t("familiar.status.editing") };
+  if (reaction === "testing") return { className: "is-busy", icon: "", label: t("familiar.status.testing") };
+  if (reaction === "waiting") return { className: "is-waiting", icon: "", label: t("familiar.status.waiting") };
+  if (reaction === "success" || reaction === "celebrating") return { className: "is-success", iconSvg: statusBadgeIcons.check, label: t("familiar.status.done") };
+  if (reaction === "error") return { className: "is-error", iconSvg: statusBadgeIcons.alert, label: t("familiar.status.oops") };
+  if (reaction === "waving") return { className: "is-info", iconSvg: statusBadgeIcons.wavingHand, label: t("familiar.status.hi") };
   return null;
 }
 
@@ -1445,7 +1445,7 @@ function installMotionStatePublisher(window: BrowserWindow): void {
   const sendMotionState = (state: PetMotionState): void => {
     if (window.isDestroyed() || lastSent === state) return;
     lastSent = state;
-    window.webContents.send("openpets:pet-motion", state);
+    window.webContents.send("familiaros:familiar-motion", state);
   };
 
   const scheduleIdle = (): void => {
@@ -1472,7 +1472,7 @@ function installMotionStatePublisher(window: BrowserWindow): void {
   window.on("moved", handleMove);
   window.webContents.on("did-finish-load", () => {
     lastSent = "idle";
-    window.webContents.send("openpets:pet-motion", "idle");
+    window.webContents.send("familiaros:familiar-motion", "idle");
   });
   window.on("closed", () => {
     if (idleTimer) clearTimeout(idleTimer);
@@ -1491,7 +1491,7 @@ function allocateWindowLoadSequence(window: BrowserWindow): number {
 
 function sendBubbleLayout(window: BrowserWindow, layout: PetWindowBubbleLayout): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:pet-bubble-layout", {
+  window.webContents.send("familiaros:familiar-bubble-layout", {
     bubbleMaxHeight: layout.bubbleMaxHeight,
     bubbleMaxHeightLong: layout.bubbleMaxHeightLong,
     bubbleMaxHeightVeryLong: layout.bubbleMaxHeightVeryLong,
@@ -1634,39 +1634,39 @@ function estimateWrappedLineCount(message: string, charsPerLine: number): number
 }
 
 async function loadPetHtmlFile(window: BrowserWindow, html: string, name: string, sequence: number): Promise<void> {
-  const safeName = name.replace(/[^a-z0-9_-]/gi, "-").slice(0, 80) || "pet";
+  const safeName = name.replace(/[^a-z0-9_-]/gi, "-").slice(0, 80) || "familiar";
 
   const previous = windowLoadChains.get(window) ?? Promise.resolve();
   const next = previous.catch(() => {}).then(async () => {
     if (window.isDestroyed()) {
-      debug("pet.window", "load skipped", { windowId: window.id, name: safeName, sequence, reason: "destroyed" });
+      debug("familiar.window", "load skipped", { windowId: window.id, name: safeName, sequence, reason: "destroyed" });
       return;
     }
 
     if (windowLoadSequences.get(window) !== sequence) {
-      debug("pet.window", "load skipped", { windowId: window.id, name: safeName, sequence, latestSequence: windowLoadSequences.get(window), reason: "superseded" });
+      debug("familiar.window", "load skipped", { windowId: window.id, name: safeName, sequence, latestSequence: windowLoadSequences.get(window), reason: "superseded" });
       return;
     }
 
-    const dir = join(app.getPath("userData"), "rendered-pets");
+    const dir = join(app.getPath("userData"), "rendered-familiars");
     await mkdir(dir, { recursive: true });
     const filePath = join(dir, `${safeName}.html`);
     await writeFile(filePath, html, "utf8");
     if (window.isDestroyed()) {
-      debug("pet.window", "load skipped", { windowId: window.id, name: safeName, sequence, reason: "destroyed-after-write" });
+      debug("familiar.window", "load skipped", { windowId: window.id, name: safeName, sequence, reason: "destroyed-after-write" });
       return;
     }
-    debug("pet.window", "load file begin", { windowId: window.id, name: safeName, sequence, filePath });
+    debug("familiar.window", "load file begin", { windowId: window.id, name: safeName, sequence, filePath });
     window.setIgnoreMouseEvents(false);
     try {
       await window.loadFile(filePath);
-      debug("pet.window", "load file complete", { windowId: window.id, name: safeName, sequence, url: window.webContents.getURL() });
+      debug("familiar.window", "load file complete", { windowId: window.id, name: safeName, sequence, url: window.webContents.getURL() });
     } catch (error) {
       if (!window.isDestroyed()) {
         if (process.platform === "linux") window.setIgnoreMouseEvents(false);
         else window.setIgnoreMouseEvents(true, { forward: true });
       }
-      logError("pet.window", "load file rejected", error instanceof Error ? error : { windowId: window.id, name: safeName, sequence, error });
+      logError("familiar.window", "load file rejected", error instanceof Error ? error : { windowId: window.id, name: safeName, sequence, error });
       throw error;
     }
   });
diff --git a/apps/desktop/src/openpets-memory.ts b/apps/desktop/src/familiaros-memory.ts
similarity index 85%
rename from apps/desktop/src/openpets-memory.ts
rename to apps/desktop/src/familiaros-memory.ts
index 5da7738e..9da423af 100644
--- a/apps/desktop/src/openpets-memory.ts
+++ b/apps/desktop/src/familiaros-memory.ts
@@ -4,13 +4,13 @@ import { dirname, join } from "node:path";
 
 import { app } from "electron";
 
-import type { OpenPetsMemoryKind } from "./local-ipc-protocol.js";
+import type { FamiliarOSMemoryKind } from "./local-ipc-protocol.js";
 import { extractPromptMemoryCandidates } from "./prompt-memory-extraction.js";
 
-export interface OpenPetsMemoryEntry {
+export interface FamiliarOSMemoryEntry {
   readonly id: string;
   readonly text: string;
-  readonly kind: OpenPetsMemoryKind;
+  readonly kind: FamiliarOSMemoryKind;
   readonly tags: readonly string[];
   readonly importance: number;
   readonly createdAt: number;
@@ -20,19 +20,19 @@ export interface OpenPetsMemoryEntry {
   readonly source: "chat" | "mcp";
 }
 
-export interface OpenPetsMemorySearchHit {
-  readonly entry: OpenPetsMemoryEntry;
+export interface FamiliarOSMemorySearchHit {
+  readonly entry: FamiliarOSMemoryEntry;
   readonly score: number;
 }
 
-interface StoredOpenPetsMemoryV1 {
+interface StoredFamiliarOSMemoryV1 {
   readonly version: 1;
-  readonly entries: readonly OpenPetsMemoryEntry[];
+  readonly entries: readonly FamiliarOSMemoryEntry[];
 }
 
 interface StoreMemoryInput {
   readonly text: string;
-  readonly kind?: OpenPetsMemoryKind;
+  readonly kind?: FamiliarOSMemoryKind;
   readonly tags?: readonly string[];
   readonly importance?: number;
   readonly source?: "chat" | "mcp";
@@ -40,13 +40,13 @@ interface StoreMemoryInput {
 
 interface ExtractedMemoryCandidate {
   readonly text: string;
-  readonly kind: OpenPetsMemoryKind;
+  readonly kind: FamiliarOSMemoryKind;
   readonly tags: readonly string[];
   readonly importance: number;
 }
 
-const memoryStoreFileName = "openpets-memory.json";
-const memoryMarkdownMirrorFileName = "openpets-memory.md";
+const memoryStoreFileName = "familiaros-memory.json";
+const memoryMarkdownMirrorFileName = "familiaros-memory.md";
 const maxMemoryEntries = 200;
 const maxMemoryTextChars = 480;
 const maxMemoryTags = 8;
@@ -54,9 +54,9 @@ const defaultMemoryImportance = 3;
 const maxRelevantMemoryChars = 1_600;
 const maxRelevantMemoryItems = 6;
 
-let cachedMemoryStore: StoredOpenPetsMemoryV1 | null = null;
+let cachedMemoryStore: StoredFamiliarOSMemoryV1 | null = null;
 
-export function listOpenPetsMemories(limit = 20): readonly OpenPetsMemoryEntry[] {
+export function listFamiliarOSMemories(limit = 20): readonly FamiliarOSMemoryEntry[] {
   const nextLimit = clampMemoryLimit(limit, 20);
   const entries = [...getMemoryStore().entries]
     .sort((left, right) => right.lastAccessedAt - left.lastAccessedAt || right.updatedAt - left.updatedAt || right.importance - left.importance || left.id.localeCompare(right.id))
@@ -64,11 +64,11 @@ export function listOpenPetsMemories(limit = 20): readonly OpenPetsMemoryEntry[]
   return entries.map(cloneMemoryEntry);
 }
 
-export function searchOpenPetsMemories(query: string, limit = 8): readonly OpenPetsMemorySearchHit[] {
+export function searchFamiliarOSMemories(query: string, limit = 8): readonly FamiliarOSMemorySearchHit[] {
   const trimmedQuery = normalizeMemoryText(query);
   const nextLimit = clampMemoryLimit(limit, 8);
   if (!trimmedQuery) {
-    return listOpenPetsMemories(nextLimit).map((entry) => ({ entry, score: 0 }));
+    return listFamiliarOSMemories(nextLimit).map((entry) => ({ entry, score: 0 }));
   }
 
   const now = Date.now();
@@ -128,7 +128,7 @@ function scoreChatHistoryEntry(entry: ChatHistorySearchEntry, queryTokens: Set<s
   return tokenOverlap * 0.6 + exactMatchBonus + lengthPenalty * 0.2 + recencyBonus;
 }
 
-export function storeOpenPetsMemory(input: StoreMemoryInput): OpenPetsMemoryEntry {
+export function storeFamiliarOSMemory(input: StoreMemoryInput): FamiliarOSMemoryEntry {
   const text = normalizeMemoryText(input.text);
   if (!text) {
     throw new Error("Memory text cannot be empty.");
@@ -143,7 +143,7 @@ export function storeOpenPetsMemory(input: StoreMemoryInput): OpenPetsMemoryEntr
   const store = getMemoryStore();
   const existing = store.entries.find((entry) => normalizeMemoryComparisonValue(entry.text) === normalizedText);
   if (existing) {
-    const mergedEntry: OpenPetsMemoryEntry = {
+    const mergedEntry: FamiliarOSMemoryEntry = {
       ...existing,
       text,
       kind: pickPreferredMemoryKind(existing.kind, kind),
@@ -161,7 +161,7 @@ export function storeOpenPetsMemory(input: StoreMemoryInput): OpenPetsMemoryEntr
     return cloneMemoryEntry(mergedEntry);
   }
 
-  const nextEntry: OpenPetsMemoryEntry = {
+  const nextEntry: FamiliarOSMemoryEntry = {
     id: `mem-${randomUUID()}`,
     text,
     kind,
@@ -180,7 +180,7 @@ export function storeOpenPetsMemory(input: StoreMemoryInput): OpenPetsMemoryEntr
   return cloneMemoryEntry(nextEntry);
 }
 
-export function updateOpenPetsMemory(id: string, input: StoreMemoryInput): OpenPetsMemoryEntry | null {
+export function updateFamiliarOSMemory(id: string, input: StoreMemoryInput): FamiliarOSMemoryEntry | null {
   const trimmedId = typeof id === "string" ? id.trim() : "";
   if (!trimmedId) {
     throw new Error("Memory id cannot be empty.");
@@ -196,7 +196,7 @@ export function updateOpenPetsMemory(id: string, input: StoreMemoryInput): OpenP
   const index = store.entries.findIndex((entry) => entry.id === trimmedId);
   if (index < 0) return null;
   const existing = store.entries[index];
-  const updated: OpenPetsMemoryEntry = {
+  const updated: FamiliarOSMemoryEntry = {
     ...existing,
     text,
     kind,
@@ -211,7 +211,7 @@ export function updateOpenPetsMemory(id: string, input: StoreMemoryInput): OpenP
   return cloneMemoryEntry(updated);
 }
 
-export function forgetOpenPetsMemory(id: string): boolean {
+export function forgetFamiliarOSMemory(id: string): boolean {
   const trimmedId = typeof id === "string" ? id.trim() : "";
   if (!trimmedId) {
     throw new Error("Memory id cannot be empty.");
@@ -237,14 +237,14 @@ export interface ChatHistorySearchEntry {
 const recallIntentPattern = /(^|[^a-z0-9])(remember|recall|what do you know|who am i|what is my name|what's my name|tell me about me|about myself|myself|do you remember)($|[^a-z0-9])/i;
 
 export function buildRelevantMemoryContext(prompt: string, chatHistory?: readonly ChatHistorySearchEntry[]): string | undefined {
-  const memoryHits = searchOpenPetsMemories(prompt, maxRelevantMemoryItems);
+  const memoryHits = searchFamiliarOSMemories(prompt, maxRelevantMemoryItems);
   const chatHits = chatHistory && chatHistory.length > 0
     ? searchChatHistory(prompt, chatHistory, maxRelevantMemoryItems)
     : [];
 
   const hasRecallIntent = recallIntentPattern.test(normalizeMemoryComparisonValue(prompt));
   const fallbackMemories = memoryHits.length === 0 || hasRecallIntent
-    ? listOpenPetsMemories(3).filter((entry) => !memoryHits.some((hit) => hit.entry.id === entry.id))
+    ? listFamiliarOSMemories(3).filter((entry) => !memoryHits.some((hit) => hit.entry.id === entry.id))
     : [];
 
   if (memoryHits.length === 0 && chatHits.length === 0 && fallbackMemories.length === 0) {
@@ -297,15 +297,15 @@ export function buildRelevantMemoryContext(prompt: string, chatHistory?: readonl
 
 export { extractPromptMemoryCandidates };
 
-export function capturePromptMemories(prompt: string): readonly OpenPetsMemoryEntry[] {
+export function capturePromptMemories(prompt: string): readonly FamiliarOSMemoryEntry[] {
   const candidates = extractPromptMemoryCandidates(prompt);
   if (candidates.length === 0) {
     return [];
   }
-  return candidates.map((candidate) => storeOpenPetsMemory({ ...candidate, source: "chat" }));
+  return candidates.map((candidate) => storeFamiliarOSMemory({ ...candidate, source: "chat" }));
 }
 
-function getMemoryStore(): StoredOpenPetsMemoryV1 {
+function getMemoryStore(): StoredFamiliarOSMemoryV1 {
   if (cachedMemoryStore) {
     return cachedMemoryStore;
   }
@@ -319,7 +319,7 @@ function getMemoryStore(): StoredOpenPetsMemoryV1 {
   return cachedMemoryStore;
 }
 
-function commitMemoryStore(store: StoredOpenPetsMemoryV1): void {
+function commitMemoryStore(store: StoredFamiliarOSMemoryV1): void {
   cachedMemoryStore = {
     version: 1,
     entries: store.entries.map(cloneMemoryEntry),
@@ -335,7 +335,7 @@ function getMemoryMarkdownMirrorPath(): string {
   return join(app.getPath("userData"), memoryMarkdownMirrorFileName);
 }
 
-function writeMemoryStoreToDisk(store: StoredOpenPetsMemoryV1): void {
+function writeMemoryStoreToDisk(store: StoredFamiliarOSMemoryV1): void {
   const path = getMemoryStorePath();
   mkdirSync(dirname(path), { recursive: true });
   const tempPath = `${path}.${process.pid}.tmp`;
@@ -348,11 +348,11 @@ function writeMemoryStoreToDisk(store: StoredOpenPetsMemoryV1): void {
   renameSync(markdownTempPath, markdownPath);
 }
 
-function buildMemoryMarkdownMirror(store: StoredOpenPetsMemoryV1): string {
+function buildMemoryMarkdownMirror(store: StoredFamiliarOSMemoryV1): string {
   const lines = [
-    "# OpenPets Memory",
+    "# FamiliarOS Memory",
     "",
-    "This file mirrors the local OpenPets memory store for inspection and backup.",
+    "This file mirrors the local FamiliarOS memory store for inspection and backup.",
     "",
   ];
 
@@ -377,10 +377,10 @@ function buildMemoryMarkdownMirror(store: StoredOpenPetsMemoryV1): string {
   return `${lines.join("\n")}\n`;
 }
 
-function normalizeStoredMemory(value: unknown): StoredOpenPetsMemoryV1 {
+function normalizeStoredMemory(value: unknown): StoredFamiliarOSMemoryV1 {
   const record = isRecord(value) ? value : {};
   const entries = Array.isArray(record.entries)
-    ? record.entries.map((entry) => normalizeStoredMemoryEntry(entry)).filter((entry): entry is OpenPetsMemoryEntry => Boolean(entry))
+    ? record.entries.map((entry) => normalizeStoredMemoryEntry(entry)).filter((entry): entry is FamiliarOSMemoryEntry => Boolean(entry))
     : [];
   return {
     version: 1,
@@ -388,7 +388,7 @@ function normalizeStoredMemory(value: unknown): StoredOpenPetsMemoryV1 {
   };
 }
 
-function normalizeStoredMemoryEntry(value: unknown): OpenPetsMemoryEntry | undefined {
+function normalizeStoredMemoryEntry(value: unknown): FamiliarOSMemoryEntry | undefined {
   if (!isRecord(value) || typeof value.id !== "string") {
     return undefined;
   }
@@ -438,7 +438,7 @@ function normalizeMemoryText(value: unknown): string | undefined {
   return normalized;
 }
 
-function normalizeMemoryKind(value: unknown): OpenPetsMemoryKind {
+function normalizeMemoryKind(value: unknown): FamiliarOSMemoryKind {
   return value === "identity" || value === "preference" || value === "fact" ? value : "note";
 }
 
@@ -481,7 +481,7 @@ function clampMemoryLimit(value: number, fallback: number): number {
   return Math.min(Math.max(Math.round(value), 1), 25);
 }
 
-function pruneMemoryEntries(entries: readonly OpenPetsMemoryEntry[]): readonly OpenPetsMemoryEntry[] {
+function pruneMemoryEntries(entries: readonly FamiliarOSMemoryEntry[]): readonly FamiliarOSMemoryEntry[] {
   if (entries.length <= maxMemoryEntries) {
     return [...entries];
   }
@@ -491,12 +491,12 @@ function pruneMemoryEntries(entries: readonly OpenPetsMemoryEntry[]): readonly O
     .slice(0, maxMemoryEntries);
 }
 
-function scoreRetentionPriority(entry: OpenPetsMemoryEntry, now: number): number {
+function scoreRetentionPriority(entry: FamiliarOSMemoryEntry, now: number): number {
   const ageDays = Math.max(0, (now - entry.updatedAt) / 86_400_000);
   return entry.importance * 5 + Math.min(entry.accessCount, 10) * 1.5 - ageDays / 21;
 }
 
-function scoreMemoryEntry(entry: OpenPetsMemoryEntry, queryTokens: ReadonlySet<string>, normalizedQuery: string, now: number): number {
+function scoreMemoryEntry(entry: FamiliarOSMemoryEntry, queryTokens: ReadonlySet<string>, normalizedQuery: string, now: number): number {
   const normalizedText = normalizeMemoryComparisonValue(entry.text);
   const entryTokens = tokenize(`${entry.text} ${entry.tags.join(" ")}`);
   let overlapCount = 0;
@@ -541,11 +541,11 @@ function touchMemoryEntries(ids: readonly string[], now: number): void {
   }
 }
 
-function getMemoryEntryById(id: string): OpenPetsMemoryEntry | undefined {
+function getMemoryEntryById(id: string): FamiliarOSMemoryEntry | undefined {
   return getMemoryStore().entries.find((entry) => entry.id === id);
 }
 
-function cloneMemoryEntry(entry: OpenPetsMemoryEntry): OpenPetsMemoryEntry {
+function cloneMemoryEntry(entry: FamiliarOSMemoryEntry): FamiliarOSMemoryEntry {
   return {
     ...entry,
     tags: [...entry.tags],
@@ -556,8 +556,8 @@ function mergeMemoryTags(left: readonly string[], right: readonly string[]): rea
   return normalizeMemoryTags([...left, ...right]);
 }
 
-function pickPreferredMemoryKind(left: OpenPetsMemoryKind, right: OpenPetsMemoryKind): OpenPetsMemoryKind {
-  const rank = { note: 0, fact: 1, preference: 2, identity: 3 } satisfies Record<OpenPetsMemoryKind, number>;
+function pickPreferredMemoryKind(left: FamiliarOSMemoryKind, right: FamiliarOSMemoryKind): FamiliarOSMemoryKind {
+  const rank = { note: 0, fact: 1, preference: 2, identity: 3 } satisfies Record<FamiliarOSMemoryKind, number>;
   return rank[right] >= rank[left] ? right : left;
 }
 
diff --git a/apps/desktop/src/i18n/index.ts b/apps/desktop/src/i18n/index.ts
index 9879ff56..7cf8b754 100644
--- a/apps/desktop/src/i18n/index.ts
+++ b/apps/desktop/src/i18n/index.ts
@@ -1,7 +1,7 @@
 // Main-process i18n facade: holds the active locale (derived from the user's
 // stored preference + the OS locale) and exposes `t()` for main-process call
 // sites such as the tray. Renderer windows do not import this; they receive a
-// resolved message map over IPC (see windows.ts `openpets:get-i18n`).
+// resolved message map over IPC (see windows.ts `familiaros:get-i18n`).
 //
 // `electron` is loaded lazily (via createRequire, inside `systemLocale()`)
 // rather than imported at module scope: this facade is pulled into the plugin
diff --git a/apps/desktop/src/i18n/locales/en.ts b/apps/desktop/src/i18n/locales/en.ts
index 0326563b..bb247f1e 100644
--- a/apps/desktop/src/i18n/locales/en.ts
+++ b/apps/desktop/src/i18n/locales/en.ts
@@ -7,38 +7,38 @@
 export const en = {
   // --- Tray menu (main process, src/tray.ts) ---
   "tray.updateAvailable": "Update available: {version}...",
-  "tray.defaultPet": "Default Pet: {name}",
-  "tray.toggleDefaultPet.show": "Show Default Pet",
-  "tray.toggleDefaultPet.hide": "Hide Default Pet",
-  "tray.pauseAllPets": "Pause All Pets",
-  "tray.resumeAllPets": "Resume All Pets",
-  "tray.managePets": "Manage Pets...",
+  "tray.defaultPet": "Default Familiar: {name}",
+  "tray.toggleDefaultPet.show": "Show Default Familiar",
+  "tray.toggleDefaultPet.hide": "Hide Default Familiar",
+  "tray.pauseAllPets": "Pause All Familiars",
+  "tray.resumeAllPets": "Resume All Familiars",
+  "tray.managePets": "Manage Familiars...",
   "tray.controlCenter": "Control Center...",
   "tray.website": "Website...",
   "tray.integrations": "Integrations...",
   "tray.plugins": "Plugins...",
   "tray.settings": "Settings...",
   "tray.openLogsFolder": "Open Logs Folder...",
-  "tray.quit": "Quit OpenPets",
+  "tray.quit": "Quit FamiliarOS",
 
   // --- Shared ---
   "common.latest": "latest",
-  "common.builtInPet": "Built-in Pet",
+  "common.builtInPet": "Built-in Familiar",
   "common.cancel": "Cancel",
 
-  // --- Pet window (main process, src/pet-window.ts) ---
-  "pet.paused": "Paused",
-  "pet.status.thinking": "Thinking",
-  "pet.status.working": "Working",
-  "pet.status.editing": "Editing",
-  "pet.status.testing": "Testing",
-  "pet.status.waiting": "Waiting",
-  "pet.status.done": "Done",
-  "pet.status.oops": "Oops",
-  "pet.status.hi": "Hi",
-  "pet.menu.hidePet": "Hide Pet",
-  "pet.menu.closePet": "Close pet",
-  "pet.menu.openControlCenter": "Open Control Center",
+  // --- Familiar window (main process, src/familiar-window.ts) ---
+  "familiar.paused": "Paused",
+  "familiar.status.thinking": "Thinking",
+  "familiar.status.working": "Working",
+  "familiar.status.editing": "Editing",
+  "familiar.status.testing": "Testing",
+  "familiar.status.waiting": "Waiting",
+  "familiar.status.done": "Done",
+  "familiar.status.oops": "Oops",
+  "familiar.status.hi": "Hi",
+  "familiar.menu.hidePet": "Hide Familiar",
+  "familiar.menu.closePet": "Close familiar",
+  "familiar.menu.openControlCenter": "Open Control Center",
 
   // --- Common (renderer, shared across views) ---
   "common.retry": "Retry",
@@ -48,7 +48,7 @@ export const en = {
 
   // --- Navigation tabs (renderer) ---
   "nav.dashboard": "Dashboard",
-  "nav.pets": "Pets",
+  "nav.familiars": "Familiars",
   "nav.settings": "Settings",
   "nav.plugins": "Plugins",
   "nav.integrations": "Integrations",
@@ -56,8 +56,8 @@ export const en = {
   // --- Route metadata (renderer hero header) ---
   "route.dashboard.title": "Dashboard",
   "route.dashboard.description": "Overview of your active companions, status, and system metrics.",
-  "route.pets.title": "Pets",
-  "route.pets.description": "Install, import, preview, and choose your default desktop companion.",
+  "route.familiars.title": "Familiars",
+  "route.familiars.description": "Install, import, preview, and choose your default desktop companion.",
   "route.settings.title": "Settings",
   "route.settings.description": "Configure startup behaviors, scale preferences, and animation settings.",
   "route.plugins.title": "Plugins",
@@ -67,13 +67,13 @@ export const en = {
 
   // --- App shell (renderer) ---
   "app.controlCenter": "Control Center",
-  "app.logo.alt": "OpenPets",
+  "app.logo.alt": "FamiliarOS",
 
   // --- Dashboard (renderer) ---
   "dashboard.loading": "Gathering companion metrics...",
   "dashboard.hero.eyebrow": "Primary Companion",
   "dashboard.hero.desc": "Ready for your next coding session.",
-  "dashboard.hero.changePet": "Change Pet",
+  "dashboard.hero.changePet": "Change Familiar",
   "dashboard.lastActive.none": "No activity yet",
   "dashboard.update.available": "Update available",
   "dashboard.update.error": "Check failed",
@@ -85,7 +85,7 @@ export const en = {
   "dashboard.stat.reactions": "Reactions",
   "dashboard.stat.reactions.footer": "Total animations triggered",
   "dashboard.stat.topCompanion": "Top Companion",
-  "dashboard.stat.topCompanion.footer": "Most active pet lately",
+  "dashboard.stat.topCompanion.footer": "Most active familiar lately",
   "dashboard.activity.title": "Activity Overview",
   "dashboard.activity.topReactions": "Top Reactions",
   "dashboard.activity.noReactions": "No reactions recorded yet. Start coding!",
@@ -96,17 +96,17 @@ export const en = {
   "dashboard.reactionMix.reactions": "reactions",
   "dashboard.reactionMix.empty": "No reaction mix yet.",
   "dashboard.companions.title": "Top Companions",
-  "dashboard.companions.subtitle": "Most active pets",
+  "dashboard.companions.subtitle": "Most active familiars",
   "dashboard.companions.empty": "No companion activity yet.",
   "dashboard.lastActive.label": "Last active: ",
   "dashboard.system.title": "System Health",
-  "dashboard.system.pets": "Pets",
-  "dashboard.system.pets.value": "{count} installed",
+  "dashboard.system.familiars": "Familiars",
+  "dashboard.system.familiars.value": "{count} installed",
   "dashboard.system.plugins": "Plugins",
   "dashboard.system.plugins.enabled": "{count} enabled",
   "dashboard.system.catalog": "Catalog",
   "dashboard.system.catalog.offline": "Offline",
-  "dashboard.system.catalog.pets": "{count} pets",
+  "dashboard.system.catalog.familiars": "{count} familiars",
   "dashboard.system.catalog.ready": "Ready",
   "dashboard.system.updates": "Updates",
   "dashboard.system.version": "Version",
@@ -114,77 +114,77 @@ export const en = {
   // --- Placeholder view (renderer) ---
   "placeholder.comingSoon": "Coming Soon • Next Migration Target",
 
-  // --- Pets filters (renderer) ---
-  "pets.filter.all": "All",
-  "pets.filter.installed": "Installed",
-  "pets.filter.featured": "Featured",
-  "pets.filter.originals": "Originals",
-  "pets.filter.codex": "Codex",
-  "pets.search.placeholder": "Search pets...",
-  "pets.import": "Import pet",
-  "pets.gallery": "Gallery",
+  // --- Familiars filters (renderer) ---
+  "familiars.filter.all": "All",
+  "familiars.filter.installed": "Installed",
+  "familiars.filter.featured": "Featured",
+  "familiars.filter.originals": "Originals",
+  "familiars.filter.codex": "Codex",
+  "familiars.search.placeholder": "Search familiars...",
+  "familiars.import": "Import familiar",
+  "familiars.gallery": "Gallery",
 
-  // --- Pets card badges/actions (renderer) ---
-  "pets.badge.default": "Default",
-  "pets.badge.original": "Original",
-  "pets.badge.featured": "Featured",
-  "pets.badge.installed": "Installed",
-  "pets.badge.codex": "Codex",
-  "pets.badge.broken": "Broken",
-  "pets.badge.ready": "Ready",
-  "pets.badge.originals": "Originals",
-  "pets.action.viewPet": "View pet",
-  "pets.action.install": "Install",
-  "pets.action.import": "Import",
-  "pets.action.default": "Default",
-  "pets.action.remove": "Remove",
-  "pets.action.refresh": "Refresh",
-  "pets.aria.view": "View {name}",
-  "pets.aria.install": "Install {name}",
-  "pets.aria.import": "Import {name} from Codex",
-  "pets.aria.setDefault": "Set {name} as default",
-  "pets.aria.remove": "Remove {name}",
-  "pets.busy.installing": "Installing",
-  "pets.busy.importing": "Importing",
-  "pets.busy.settingDefault": "Setting default",
-  "pets.busy.removing": "Removing",
-  "pets.busy.loadingPage": "Loading page",
+  // --- Familiars card badges/actions (renderer) ---
+  "familiars.badge.default": "Default",
+  "familiars.badge.original": "Original",
+  "familiars.badge.featured": "Featured",
+  "familiars.badge.installed": "Installed",
+  "familiars.badge.codex": "Codex",
+  "familiars.badge.broken": "Broken",
+  "familiars.badge.ready": "Ready",
+  "familiars.badge.originals": "Originals",
+  "familiars.action.viewPet": "View familiar",
+  "familiars.action.install": "Install",
+  "familiars.action.import": "Import",
+  "familiars.action.default": "Default",
+  "familiars.action.remove": "Remove",
+  "familiars.action.refresh": "Refresh",
+  "familiars.aria.view": "View {name}",
+  "familiars.aria.install": "Install {name}",
+  "familiars.aria.import": "Import {name} from Codex",
+  "familiars.aria.setDefault": "Set {name} as default",
+  "familiars.aria.remove": "Remove {name}",
+  "familiars.busy.installing": "Installing",
+  "familiars.busy.importing": "Importing",
+  "familiars.busy.settingDefault": "Setting default",
+  "familiars.busy.removing": "Removing",
+  "familiars.busy.loadingPage": "Loading page",
 
-  // --- Pets pager (renderer) ---
-  "pets.pager.prev": "Prev",
-  "pets.pager.next": "Next",
-  "pets.pager.count": "{count} pets",
-  "pets.pager.page": " · Page {page} of {pageCount}",
+  // --- Familiars pager (renderer) ---
+  "familiars.pager.prev": "Prev",
+  "familiars.pager.next": "Next",
+  "familiars.pager.count": "{count} familiars",
+  "familiars.pager.page": " · Page {page} of {pageCount}",
 
-  // --- Pet detail dialog (renderer) ---
-  "pets.detail.ariaLabel": "{name} pet details",
-  "pets.detail.closeAria": "Close pet details",
-  "pets.detail.eyebrow": "Pet detail",
-  "pets.detail.previewAnimations": "Preview Animations",
-  "pets.detail.preview.idle": "Idle",
-  "pets.detail.preview.thinking": "Thinking",
-  "pets.detail.preview.happy": "Happy",
-  "pets.detail.preview.wave": "Wave",
-  "pets.detail.installPet": "Install Pet",
-  "pets.detail.importCodexPet": "Import Codex Pet",
-  "pets.detail.setDefaultPet": "Set Default Pet",
-  "pets.detail.remove": "Remove",
-  "pets.detail.refresh": "Refresh",
+  // --- Familiar detail dialog (renderer) ---
+  "familiars.detail.ariaLabel": "{name} familiar details",
+  "familiars.detail.closeAria": "Close familiar details",
+  "familiars.detail.eyebrow": "Familiar detail",
+  "familiars.detail.previewAnimations": "Preview Animations",
+  "familiars.detail.preview.idle": "Idle",
+  "familiars.detail.preview.thinking": "Thinking",
+  "familiars.detail.preview.happy": "Happy",
+  "familiars.detail.preview.wave": "Wave",
+  "familiars.detail.installPet": "Install Familiar",
+  "familiars.detail.importCodexPet": "Import Codex Familiar",
+  "familiars.detail.setDefaultPet": "Set Default Familiar",
+  "familiars.detail.remove": "Remove",
+  "familiars.detail.refresh": "Refresh",
 
-  // --- Pet detail status text (renderer) ---
-  "pets.status.broken": "This installed pet is broken and cannot be selected as default.",
-  "pets.status.defaultProtected": "Default built-in pet. Protected from removal.",
-  "pets.status.default": "Default pet.",
-  "pets.status.installedCodex": "Installed and ready to become your default pet. Also found in ~/.codex/pets.",
-  "pets.status.installed": "Installed and ready to become your default pet.",
-  "pets.status.availableCodex": "Available to import from ~/.codex/pets.",
-  "pets.status.availableCatalog": "Available to install from the catalog.",
+  // --- Familiar detail status text (renderer) ---
+  "familiars.status.broken": "This installed familiar is broken and cannot be selected as default.",
+  "familiars.status.defaultProtected": "Default built-in familiar. Protected from removal.",
+  "familiars.status.default": "Default familiar.",
+  "familiars.status.installedCodex": "Installed and ready to become your default familiar. Also found in ~/.codex/familiars.",
+  "familiars.status.installed": "Installed and ready to become your default familiar.",
+  "familiars.status.availableCodex": "Available to import from ~/.codex/familiars.",
+  "familiars.status.availableCatalog": "Available to install from the catalog.",
 
-  // --- Pet labels for SpriteFrame/PetImage (renderer) ---
-  "pets.spriteLabel.thumbnail": "{name} thumbnail",
-  "pets.spriteLabel.thumb": "{name} thumb",
-  "pets.spriteLabel.animatedPreview": "{name} animated preview",
-  "pets.spriteLabel.statePreview": "{name} {state} preview",
+  // --- Familiar labels for SpriteFrame/PetImage (renderer) ---
+  "familiars.spriteLabel.thumbnail": "{name} thumbnail",
+  "familiars.spriteLabel.thumb": "{name} thumb",
+  "familiars.spriteLabel.animatedPreview": "{name} animated preview",
+  "familiars.spriteLabel.statePreview": "{name} {state} preview",
 
   // --- Settings: general (renderer) ---
   "settings.nav.general": "General",
@@ -192,22 +192,25 @@ export const en = {
   "settings.nav.plugins": "Plugin Platform",
   "settings.general.eyebrow": "Environment",
   "settings.general.title": "General Settings",
-  "settings.general.showOnLaunch.title": "Show pet on launch",
-  "settings.general.showOnLaunch.description": "Keep OpenPets in the tray but hide the pet until requested.",
+  "settings.general.showOnLaunch.title": "Show familiar on launch",
+  "settings.general.showOnLaunch.description": "Keep FamiliarOS in the tray but hide the familiar until requested.",
   "settings.general.launchAtLogin.title": "Launch at login",
-  "settings.general.launchAtLogin.supported": "Start OpenPets automatically when your computer starts.",
+  "settings.general.launchAtLogin.supported": "Start FamiliarOS automatically when your computer starts.",
   "settings.general.launchAtLogin.unsupported": "Not supported on this platform.",
-  "settings.general.petScale.title": "Pet scale",
-  "settings.general.petScale.description": "Adjust how large the default desktop pet appears.",
-  "settings.general.resetPosition": "Reset Pet Position",
+  "settings.general.petScale.title": "Familiar scale",
+  "settings.general.petScale.description": "Adjust how large the default desktop familiar appears.",
+  "settings.general.familiarName.title": "Familiar name",
+  "settings.general.familiarName.description": "Give your default Familiar a custom name.",
+  "settings.general.resetPosition": "Reset Familiar Position",
   "settings.general.systemStatus": "System Status",
   "settings.general.updateAvailable": "Update Available",
   "settings.general.checking": "Checking…",
   "settings.general.checkForUpdates": "Check for Updates",
   "settings.toast.startupSaved": "Startup preference saved.",
   "settings.toast.loginStartupSaved": "Login startup preference saved.",
-  "settings.toast.petScaleSaved": "Pet scale saved.",
-  "settings.toast.positionReset": "Default pet position reset.",
+  "settings.toast.petScaleSaved": "Familiar scale saved.",
+  "settings.toast.familiarNameSaved": "Familiar name saved.",
+  "settings.toast.positionReset": "Default familiar position reset.",
   "settings.busy.saving": "Saving",
   "settings.busy.resetting": "Resetting",
   "settings.busy.opening": "Opening",
@@ -225,7 +228,7 @@ export const en = {
   "settings.reactions.eyebrow": "Behavior",
   "settings.reactions.title": "Reaction Mapping",
   "settings.reactions.resetDefaults": "Reset to Defaults",
-  "settings.reactions.description": "Customize which animation plays for each agent reaction. Previews use the default pet.",
+  "settings.reactions.description": "Customize which animation plays for each agent reaction. Previews use the default familiar.",
   "settings.reactions.previewAria": "Animation: {state}",
   "settings.toast.reactionsReset": "Reaction animations reset.",
   "settings.toast.reactionSaved": "Reaction animation saved.",
@@ -258,7 +261,7 @@ export const en = {
   "settings.reaction.waiting.label": "Waiting",
   "settings.reaction.waiting.description": "Agent is blocked or waiting for permission.",
   "settings.reaction.waving.label": "Waving",
-  "settings.reaction.waving.description": "Pet is greeting or getting attention.",
+  "settings.reaction.waving.description": "Familiar is greeting or getting attention.",
   "settings.reaction.success.label": "Success",
   "settings.reaction.success.description": "Task completed successfully.",
   "settings.reaction.error.label": "Error",
@@ -275,10 +278,10 @@ export const en = {
   "settings.ai.description": "Model, endpoint, and system instructions used by the built-in floating chat.",
   "settings.tts.eyebrow": "Voice",
   "settings.tts.title": "Text-to-Speech",
-  "settings.tts.description": "Voice provider and controls for the pet and floating chat.",
+  "settings.tts.description": "Voice provider and controls for the familiar and floating chat.",
   "settings.tts.placeholder": "TTS provider settings will appear here in the next build step.",
   "settings.tts.provider.title": "Provider",
-  "settings.tts.provider.description": "Voice engine used by the pet and floating chat.",
+  "settings.tts.provider.description": "Voice engine used by the familiar and floating chat.",
   "settings.tts.voice.title": "Voice",
   "settings.tts.voice.description": "Select a voice for the current provider.",
   "settings.tts.speed.title": "Speed",
@@ -310,7 +313,7 @@ export const en = {
   "settings.plugins.audio.description": "Allow plugin chimes, alerts, and bundled sounds.",
   "settings.plugins.voice.title": "Plugins may speak (voice)",
   "settings.plugins.voice.description": "Allow text-to-speech through the system voice.",
-  "settings.plugins.dynamicSpeech.title": "Allow AI-generated pet speech",
+  "settings.plugins.dynamicSpeech.title": "Allow AI-generated familiar speech",
   "settings.plugins.dynamicSpeech.description": "Sensitive: lets approved plugins show model-generated bubbles.",
   "settings.plugins.microphone.title": "Allow microphone (push-to-talk)",
   "settings.plugins.microphone.description": "Sensitive: lets approved plugins capture one-shot voice input.",
@@ -438,22 +441,22 @@ export const en = {
   "plugins.busy.uninstalling": "Uninstalling",
 
   // --- Plugin permission labels (renderer) ---
-  "plugins.permission.pet:speak": "Speech",
-  "plugins.permission.pet:reaction": "Reactions",
-  "plugins.permission.pet:move": "Movement",
+  "plugins.permission.familiar:speak": "Speech",
+  "plugins.permission.familiar:reaction": "Reactions",
+  "plugins.permission.familiar:move": "Movement",
   "plugins.permission.timer": "Timers",
   "plugins.permission.schedule": "Schedule",
   "plugins.permission.storage": "Storage",
   "plugins.permission.status": "Status",
   "plugins.permission.commands": "Commands",
   "plugins.permission.network": "Network",
-  "plugins.permission.pet:interact": "Bubble buttons",
-  "plugins.permission.pet:pin": "Pinned bubble",
-  "plugins.permission.pet:animate": "Custom animation",
-  "plugins.permission.pet:speak:dynamic": "AI speech",
-  "plugins.permission.pet:drop": "Drag & drop",
-  "plugins.permission.pets:read": "Read pets",
-  "plugins.permission.pets:manage": "Manage pets",
+  "plugins.permission.familiar:interact": "Bubble buttons",
+  "plugins.permission.familiar:pin": "Pinned bubble",
+  "plugins.permission.familiar:animate": "Custom animation",
+  "plugins.permission.familiar:speak:dynamic": "AI speech",
+  "plugins.permission.familiar:drop": "Drag & drop",
+  "plugins.permission.familiars:read": "Read familiars",
+  "plugins.permission.familiars:manage": "Manage familiars",
   "plugins.permission.audio": "Sound",
   "plugins.permission.events": "Events",
   "plugins.permission.ui:toast": "Toasts",
@@ -477,14 +480,14 @@ export const en = {
   "integrations.commandMode.local": "Local development",
   "integrations.loading": "Loading integrations…",
   "integrations.claude.name": "Claude Code",
-  "integrations.claude.description": "Connect Claude Code to your OpenPets companion.",
+  "integrations.claude.description": "Connect Claude Code to your FamiliarOS companion.",
   "integrations.opencode.name": "OpenCode",
-  "integrations.opencode.description": "Connect OpenCode globally to your OpenPets companion.",
+  "integrations.opencode.description": "Connect OpenCode globally to your FamiliarOS companion.",
   "integrations.cursor.name": "Cursor",
-  "integrations.cursor.description": "Connect Cursor to your OpenPets companion via global MCP config.",
+  "integrations.cursor.description": "Connect Cursor to your FamiliarOS companion via global MCP config.",
   "integrations.pi.name": "Pi",
   "integrations.pi.status": "Manual",
-  "integrations.pi.description": "Connect Pi coding-agent activity through the OpenPets Pi extension package.",
+  "integrations.pi.description": "Connect Pi coding-agent activity through the FamiliarOS Pi extension package.",
   "integrations.soon.vscode": "VS Code",
   "integrations.soon.windsurf": "Windsurf",
   "integrations.soon.zed": "Zed",
@@ -500,13 +503,13 @@ export const en = {
   "integrations.commandSource": "Command Source",
   "integrations.cliMode": "CLI mode",
   "integrations.localUnavailable": " unavailable",
-  "integrations.commandModeHelp": "Use the published package for normal setup, bundled for the desktop app build, or local while developing OpenPets.",
+  "integrations.commandModeHelp": "Use the published package for normal setup, bundled for the desktop app build, or local while developing FamiliarOS.",
   "integrations.connection": "Connection",
   "integrations.statusRouting": "Status & Routing",
   "integrations.globalSetup": "Global Setup",
   "integrations.globalMcp": "Global MCP",
-  "integrations.petRouting": "Pet Routing",
-  "integrations.defaultPet": "Default Pet",
+  "integrations.petRouting": "Familiar Routing",
+  "integrations.defaultPet": "Default Familiar",
   "integrations.configuration": "Configuration",
   "integrations.commandPaths": "Command Paths",
   "integrations.claudeCommand": "Claude Command",
@@ -534,12 +537,12 @@ export const en = {
   "integrations.rulesPreview": "Rules Preview",
   "integrations.pi.manualSetup": "Manual Setup",
   "integrations.pi.extension": "Pi Extension",
-  "integrations.pi.intro": "Install the OpenPets Pi extension from Pi, then use the slash commands inside a Pi session.",
+  "integrations.pi.intro": "Install the FamiliarOS Pi extension from Pi, then use the slash commands inside a Pi session.",
   "integrations.pi.globalInstall": "Global install",
   "integrations.pi.projectInstall": "Project install",
   "integrations.pi.remove": "Remove",
   "integrations.pi.slashCommands": "Slash commands",
-  "integrations.pi.outro": "Use global install for all Pi workspaces, or project install when you only want OpenPets in the current project.",
+  "integrations.pi.outro": "Use global install for all Pi workspaces, or project install when you only want FamiliarOS in the current project.",
   "integrations.toast.pathSaved": "Path saved.",
   "integrations.busy.installing": "Installing",
   "integrations.busy.replacing": "Replacing",
@@ -554,21 +557,21 @@ export const en = {
   "integrations.mcpToolServers.noTools": "None active",
   "integrations.mcpToolServers.builtInChat": "Built-in Chat",
   "integrations.mcpToolServers.saved": "Saved {count} tool server(s).",
-  "integrations.openpetsMcpServer.name": "OpenPets MCP Server",
-  "integrations.openpetsMcpServer.description": "External-agent bridge that exposes your pet to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
-  "integrations.openpetsMcpServer.commandModeHelp": "Choose how the OpenPets MCP server is launched for external hosts.",
-  "integrations.openpetsMcpServer.testServer": "Test Server",
-  "integrations.openpetsMcpServer.testBusy": "Testing server…",
-  "integrations.openpetsMcpServer.testOk": "Server responded: {output}",
-  "integrations.openpetsMcpServer.testError": "Server test failed: {error}",
-  "integrations.openpetsMcpServer.copyMcpJson": "Copy MCP JSON",
-  "integrations.openpetsMcpServer.status": "Ready",
+  "integrations.familiarosMcpServer.name": "FamiliarOS MCP Server",
+  "integrations.familiarosMcpServer.description": "External-agent bridge that exposes your familiar to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
+  "integrations.familiarosMcpServer.commandModeHelp": "Choose how the FamiliarOS MCP server is launched for external hosts.",
+  "integrations.familiarosMcpServer.testServer": "Test Server",
+  "integrations.familiarosMcpServer.testBusy": "Testing server…",
+  "integrations.familiarosMcpServer.testOk": "Server responded: {output}",
+  "integrations.familiarosMcpServer.testError": "Server test failed: {error}",
+  "integrations.familiarosMcpServer.copyMcpJson": "Copy MCP JSON",
+  "integrations.familiarosMcpServer.status": "Ready",
   "integrations.curatedToolkit.name": "Curated MCP Toolkit",
   "integrations.curatedToolkit.description": "Starter stack for filesystem, Git, browser use, memory, databases, Docker, and terminal-oriented MCP lanes.",
-  "integrations.linkToCentralPanel": "Configure in the OpenPets MCP Server panel above.",
+  "integrations.linkToCentralPanel": "Configure in the FamiliarOS MCP Server panel above.",
 
   // --- Settings: Language section (renderer) ---
   "settings.language.title": "Language",
-  "settings.language.description": "Display language for OpenPets menus and windows.",
+  "settings.language.description": "Display language for FamiliarOS menus and windows.",
   "settings.language.system": "System default",
 } as const;
diff --git a/apps/desktop/src/i18n/locales/es-419.ts b/apps/desktop/src/i18n/locales/es-419.ts
index befec9e0..03a79124 100644
--- a/apps/desktop/src/i18n/locales/es-419.ts
+++ b/apps/desktop/src/i18n/locales/es-419.ts
@@ -4,38 +4,38 @@ import type { Messages } from "../catalog.js";
 export const es419: Partial<Messages> = {
   // --- Tray menu (main process, src/tray.ts) ---
   "tray.updateAvailable": "Actualización disponible: {version}...",
-  "tray.defaultPet": "Mascota predeterminada: {name}",
-  "tray.toggleDefaultPet.show": "Mostrar mascota predeterminada",
-  "tray.toggleDefaultPet.hide": "Ocultar mascota predeterminada",
-  "tray.pauseAllPets": "Pausar todas las mascotas",
-  "tray.resumeAllPets": "Reanudar todas las mascotas",
-  "tray.managePets": "Administrar mascotas...",
+  "tray.defaultPet": "Familiar predeterminada: {name}",
+  "tray.toggleDefaultPet.show": "Mostrar Familiar predeterminada",
+  "tray.toggleDefaultPet.hide": "Ocultar Familiar predeterminada",
+  "tray.pauseAllPets": "Pausar todas las Familiars",
+  "tray.resumeAllPets": "Reanudar todas las Familiars",
+  "tray.managePets": "Administrar Familiars...",
   "tray.controlCenter": "Centro de control...",
   "tray.website": "Sitio web...",
   "tray.integrations": "Integraciones...",
   "tray.plugins": "Complementos...",
   "tray.settings": "Configuración...",
   "tray.openLogsFolder": "Abrir carpeta de registros...",
-  "tray.quit": "Salir de OpenPets",
+  "tray.quit": "Salir de FamiliarOS",
 
   // --- Shared ---
   "common.latest": "más reciente",
-  "common.builtInPet": "Mascota integrada",
+  "common.builtInPet": "Familiar integrada",
   "common.cancel": "Cancelar",
 
-  // --- Pet window (main process, src/pet-window.ts) ---
-  "pet.paused": "En pausa",
-  "pet.status.thinking": "Pensando",
-  "pet.status.working": "Trabajando",
-  "pet.status.editing": "Editando",
-  "pet.status.testing": "Probando",
-  "pet.status.waiting": "Esperando",
-  "pet.status.done": "Listo",
-  "pet.status.oops": "Ups",
-  "pet.status.hi": "Hola",
-  "pet.menu.hidePet": "Ocultar mascota",
-  "pet.menu.closePet": "Cerrar mascota",
-  "pet.menu.openControlCenter": "Abrir Centro de control",
+  // --- Familiar window (main process, src/familiar-window.ts) ---
+  "familiar.paused": "En pausa",
+  "familiar.status.thinking": "Pensando",
+  "familiar.status.working": "Trabajando",
+  "familiar.status.editing": "Editando",
+  "familiar.status.testing": "Probando",
+  "familiar.status.waiting": "Esperando",
+  "familiar.status.done": "Listo",
+  "familiar.status.oops": "Ups",
+  "familiar.status.hi": "Hola",
+  "familiar.menu.hidePet": "Ocultar Familiar",
+  "familiar.menu.closePet": "Cerrar Familiar",
+  "familiar.menu.openControlCenter": "Abrir Centro de control",
 
   // --- Common (renderer, shared across views) ---
   "common.retry": "Reintentar",
@@ -45,7 +45,7 @@ export const es419: Partial<Messages> = {
 
   // --- Navigation tabs (renderer) ---
   "nav.dashboard": "Panel",
-  "nav.pets": "Mascotas",
+  "nav.familiars": "Familiars",
   "nav.settings": "Configuración",
   "nav.plugins": "Complementos",
   "nav.integrations": "Integraciones",
@@ -53,8 +53,8 @@ export const es419: Partial<Messages> = {
   // --- Route metadata (renderer hero header) ---
   "route.dashboard.title": "Panel",
   "route.dashboard.description": "Resumen de tus compañeros activos, su estado y las métricas del sistema.",
-  "route.pets.title": "Mascotas",
-  "route.pets.description": "Instala, importa, previsualiza y elige tu compañero de escritorio predeterminado.",
+  "route.familiars.title": "Familiars",
+  "route.familiars.description": "Instala, importa, previsualiza y elige tu compañero de escritorio predeterminado.",
   "route.settings.title": "Configuración",
   "route.settings.description": "Configura los comportamientos de inicio, las preferencias de escala y los ajustes de animación.",
   "route.plugins.title": "Complementos",
@@ -64,13 +64,13 @@ export const es419: Partial<Messages> = {
 
   // --- App shell (renderer) ---
   "app.controlCenter": "Centro de control",
-  "app.logo.alt": "OpenPets",
+  "app.logo.alt": "FamiliarOS",
 
   // --- Dashboard (renderer) ---
   "dashboard.loading": "Recopilando métricas del compañero...",
   "dashboard.hero.eyebrow": "Compañero principal",
   "dashboard.hero.desc": "Listo para tu próxima sesión de programación.",
-  "dashboard.hero.changePet": "Cambiar mascota",
+  "dashboard.hero.changePet": "Cambiar Familiar",
   "dashboard.lastActive.none": "Aún sin actividad",
   "dashboard.update.available": "Actualización disponible",
   "dashboard.update.error": "Falló la verificación",
@@ -82,7 +82,7 @@ export const es419: Partial<Messages> = {
   "dashboard.stat.reactions": "Reacciones",
   "dashboard.stat.reactions.footer": "Total de animaciones activadas",
   "dashboard.stat.topCompanion": "Compañero destacado",
-  "dashboard.stat.topCompanion.footer": "Mascota más activa últimamente",
+  "dashboard.stat.topCompanion.footer": "Familiar más activa últimamente",
   "dashboard.activity.title": "Resumen de actividad",
   "dashboard.activity.topReactions": "Reacciones principales",
   "dashboard.activity.noReactions": "Aún no se registran reacciones. ¡Empieza a programar!",
@@ -93,17 +93,17 @@ export const es419: Partial<Messages> = {
   "dashboard.reactionMix.reactions": "reacciones",
   "dashboard.reactionMix.empty": "Aún no hay mezcla de reacciones.",
   "dashboard.companions.title": "Compañeros principales",
-  "dashboard.companions.subtitle": "Mascotas más activas",
+  "dashboard.companions.subtitle": "Familiars más activas",
   "dashboard.companions.empty": "Aún no hay actividad de compañeros.",
   "dashboard.lastActive.label": "Última actividad: ",
   "dashboard.system.title": "Estado del sistema",
-  "dashboard.system.pets": "Mascotas",
-  "dashboard.system.pets.value": "{count} instaladas",
+  "dashboard.system.familiars": "Familiars",
+  "dashboard.system.familiars.value": "{count} instaladas",
   "dashboard.system.plugins": "Complementos",
   "dashboard.system.plugins.enabled": "{count} habilitados",
   "dashboard.system.catalog": "Catálogo",
   "dashboard.system.catalog.offline": "Sin conexión",
-  "dashboard.system.catalog.pets": "{count} mascotas",
+  "dashboard.system.catalog.familiars": "{count} Familiars",
   "dashboard.system.catalog.ready": "Listo",
   "dashboard.system.updates": "Actualizaciones",
   "dashboard.system.version": "Versión",
@@ -111,77 +111,77 @@ export const es419: Partial<Messages> = {
   // --- Placeholder view (renderer) ---
   "placeholder.comingSoon": "Próximamente • Siguiente objetivo de migración",
 
-  // --- Pets filters (renderer) ---
-  "pets.filter.all": "Todas",
-  "pets.filter.installed": "Instaladas",
-  "pets.filter.featured": "Destacadas",
-  "pets.filter.originals": "Originales",
-  "pets.filter.codex": "Codex",
-  "pets.search.placeholder": "Buscar mascotas...",
-  "pets.import": "Importar mascota",
-  "pets.gallery": "Galería",
+  // --- Familiars filters (renderer) ---
+  "familiars.filter.all": "Todas",
+  "familiars.filter.installed": "Instaladas",
+  "familiars.filter.featured": "Destacadas",
+  "familiars.filter.originals": "Originales",
+  "familiars.filter.codex": "Codex",
+  "familiars.search.placeholder": "Buscar Familiars...",
+  "familiars.import": "Importar Familiar",
+  "familiars.gallery": "Galería",
 
-  // --- Pets card badges/actions (renderer) ---
-  "pets.badge.default": "Predeterminada",
-  "pets.badge.original": "Original",
-  "pets.badge.featured": "Destacada",
-  "pets.badge.installed": "Instalada",
-  "pets.badge.codex": "Codex",
-  "pets.badge.broken": "Dañada",
-  "pets.badge.ready": "Lista",
-  "pets.badge.originals": "Originales",
-  "pets.action.viewPet": "Ver mascota",
-  "pets.action.install": "Instalar",
-  "pets.action.import": "Importar",
-  "pets.action.default": "Predeterminada",
-  "pets.action.remove": "Quitar",
-  "pets.action.refresh": "Actualizar",
-  "pets.aria.view": "Ver {name}",
-  "pets.aria.install": "Instalar {name}",
-  "pets.aria.import": "Importar {name} desde Codex",
-  "pets.aria.setDefault": "Establecer {name} como predeterminada",
-  "pets.aria.remove": "Quitar {name}",
-  "pets.busy.installing": "Instalando",
-  "pets.busy.importing": "Importando",
-  "pets.busy.settingDefault": "Estableciendo predeterminada",
-  "pets.busy.removing": "Quitando",
-  "pets.busy.loadingPage": "Cargando página",
+  // --- Familiars card badges/actions (renderer) ---
+  "familiars.badge.default": "Predeterminada",
+  "familiars.badge.original": "Original",
+  "familiars.badge.featured": "Destacada",
+  "familiars.badge.installed": "Instalada",
+  "familiars.badge.codex": "Codex",
+  "familiars.badge.broken": "Dañada",
+  "familiars.badge.ready": "Lista",
+  "familiars.badge.originals": "Originales",
+  "familiars.action.viewPet": "Ver Familiar",
+  "familiars.action.install": "Instalar",
+  "familiars.action.import": "Importar",
+  "familiars.action.default": "Predeterminada",
+  "familiars.action.remove": "Quitar",
+  "familiars.action.refresh": "Actualizar",
+  "familiars.aria.view": "Ver {name}",
+  "familiars.aria.install": "Instalar {name}",
+  "familiars.aria.import": "Importar {name} desde Codex",
+  "familiars.aria.setDefault": "Establecer {name} como predeterminada",
+  "familiars.aria.remove": "Quitar {name}",
+  "familiars.busy.installing": "Instalando",
+  "familiars.busy.importing": "Importando",
+  "familiars.busy.settingDefault": "Estableciendo predeterminada",
+  "familiars.busy.removing": "Quitando",
+  "familiars.busy.loadingPage": "Cargando página",
 
-  // --- Pets pager (renderer) ---
-  "pets.pager.prev": "Anterior",
-  "pets.pager.next": "Siguiente",
-  "pets.pager.count": "{count} mascotas",
-  "pets.pager.page": " · Página {page} de {pageCount}",
+  // --- Familiars pager (renderer) ---
+  "familiars.pager.prev": "Anterior",
+  "familiars.pager.next": "Siguiente",
+  "familiars.pager.count": "{count} Familiars",
+  "familiars.pager.page": " · Página {page} de {pageCount}",
 
-  // --- Pet detail dialog (renderer) ---
-  "pets.detail.ariaLabel": "Detalles de la mascota {name}",
-  "pets.detail.closeAria": "Cerrar detalles de la mascota",
-  "pets.detail.eyebrow": "Detalle de la mascota",
-  "pets.detail.previewAnimations": "Previsualizar animaciones",
-  "pets.detail.preview.idle": "Inactiva",
-  "pets.detail.preview.thinking": "Pensando",
-  "pets.detail.preview.happy": "Feliz",
-  "pets.detail.preview.wave": "Saludo",
-  "pets.detail.installPet": "Instalar mascota",
-  "pets.detail.importCodexPet": "Importar mascota de Codex",
-  "pets.detail.setDefaultPet": "Establecer como predeterminada",
-  "pets.detail.remove": "Quitar",
-  "pets.detail.refresh": "Actualizar",
+  // --- Familiar detail dialog (renderer) ---
+  "familiars.detail.ariaLabel": "Detalles de la Familiar {name}",
+  "familiars.detail.closeAria": "Cerrar detalles de la Familiar",
+  "familiars.detail.eyebrow": "Detalle de la Familiar",
+  "familiars.detail.previewAnimations": "Previsualizar animaciones",
+  "familiars.detail.preview.idle": "Inactiva",
+  "familiars.detail.preview.thinking": "Pensando",
+  "familiars.detail.preview.happy": "Feliz",
+  "familiars.detail.preview.wave": "Saludo",
+  "familiars.detail.installPet": "Instalar Familiar",
+  "familiars.detail.importCodexPet": "Importar Familiar de Codex",
+  "familiars.detail.setDefaultPet": "Establecer como predeterminada",
+  "familiars.detail.remove": "Quitar",
+  "familiars.detail.refresh": "Actualizar",
 
-  // --- Pet detail status text (renderer) ---
-  "pets.status.broken": "Esta mascota instalada está dañada y no se puede seleccionar como predeterminada.",
-  "pets.status.defaultProtected": "Mascota integrada predeterminada. Protegida contra eliminación.",
-  "pets.status.default": "Mascota predeterminada.",
-  "pets.status.installedCodex": "Instalada y lista para convertirse en tu mascota predeterminada. También se encuentra en ~/.codex/pets.",
-  "pets.status.installed": "Instalada y lista para convertirse en tu mascota predeterminada.",
-  "pets.status.availableCodex": "Disponible para importar desde ~/.codex/pets.",
-  "pets.status.availableCatalog": "Disponible para instalar desde el catálogo.",
+  // --- Familiar detail status text (renderer) ---
+  "familiars.status.broken": "Esta Familiar instalada está dañada y no se puede seleccionar como predeterminada.",
+  "familiars.status.defaultProtected": "Familiar integrada predeterminada. Protegida contra eliminación.",
+  "familiars.status.default": "Familiar predeterminada.",
+  "familiars.status.installedCodex": "Instalada y lista para convertirse en tu Familiar predeterminada. También se encuentra en ~/.codex/familiars.",
+  "familiars.status.installed": "Instalada y lista para convertirse en tu Familiar predeterminada.",
+  "familiars.status.availableCodex": "Disponible para importar desde ~/.codex/familiars.",
+  "familiars.status.availableCatalog": "Disponible para instalar desde el catálogo.",
 
-  // --- Pet labels for SpriteFrame/PetImage (renderer) ---
-  "pets.spriteLabel.thumbnail": "Miniatura de {name}",
-  "pets.spriteLabel.thumb": "Miniatura de {name}",
-  "pets.spriteLabel.animatedPreview": "Vista previa animada de {name}",
-  "pets.spriteLabel.statePreview": "Vista previa de {name} en estado {state}",
+  // --- Familiar labels for SpriteFrame/PetImage (renderer) ---
+  "familiars.spriteLabel.thumbnail": "Miniatura de {name}",
+  "familiars.spriteLabel.thumb": "Miniatura de {name}",
+  "familiars.spriteLabel.animatedPreview": "Vista previa animada de {name}",
+  "familiars.spriteLabel.statePreview": "Vista previa de {name} en estado {state}",
 
   // --- Settings: general (renderer) ---
   "settings.nav.general": "General",
@@ -189,22 +189,22 @@ export const es419: Partial<Messages> = {
   "settings.nav.plugins": "Plataforma de complementos",
   "settings.general.eyebrow": "Entorno",
   "settings.general.title": "Configuración general",
-  "settings.general.showOnLaunch.title": "Mostrar la mascota al iniciar",
-  "settings.general.showOnLaunch.description": "Mantén OpenPets en la bandeja pero oculta la mascota hasta que la solicites.",
+  "settings.general.showOnLaunch.title": "Mostrar la Familiar al iniciar",
+  "settings.general.showOnLaunch.description": "Mantén FamiliarOS en la bandeja pero oculta la Familiar hasta que la solicites.",
   "settings.general.launchAtLogin.title": "Iniciar al iniciar sesión",
-  "settings.general.launchAtLogin.supported": "Inicia OpenPets automáticamente cuando se enciende tu computadora.",
+  "settings.general.launchAtLogin.supported": "Inicia FamiliarOS automáticamente cuando se enciende tu computadora.",
   "settings.general.launchAtLogin.unsupported": "No es compatible con esta plataforma.",
-  "settings.general.petScale.title": "Escala de la mascota",
-  "settings.general.petScale.description": "Ajusta el tamaño con el que aparece la mascota de escritorio predeterminada.",
-  "settings.general.resetPosition": "Restablecer posición de la mascota",
+  "settings.general.petScale.title": "Escala de la Familiar",
+  "settings.general.petScale.description": "Ajusta el tamaño con el que aparece la Familiar de escritorio predeterminada.",
+  "settings.general.resetPosition": "Restablecer posición de la Familiar",
   "settings.general.systemStatus": "Estado del sistema",
   "settings.general.updateAvailable": "Actualización disponible",
   "settings.general.checking": "Verificando…",
   "settings.general.checkForUpdates": "Buscar actualizaciones",
   "settings.toast.startupSaved": "Preferencia de inicio guardada.",
   "settings.toast.loginStartupSaved": "Preferencia de inicio de sesión guardada.",
-  "settings.toast.petScaleSaved": "Escala de la mascota guardada.",
-  "settings.toast.positionReset": "Posición de la mascota predeterminada restablecida.",
+  "settings.toast.petScaleSaved": "Escala de la Familiar guardada.",
+  "settings.toast.positionReset": "Posición de la Familiar predeterminada restablecida.",
   "settings.busy.saving": "Guardando",
   "settings.busy.resetting": "Restableciendo",
   "settings.busy.opening": "Abriendo",
@@ -222,7 +222,7 @@ export const es419: Partial<Messages> = {
   "settings.reactions.eyebrow": "Comportamiento",
   "settings.reactions.title": "Asignación de reacciones",
   "settings.reactions.resetDefaults": "Restablecer valores predeterminados",
-  "settings.reactions.description": "Personaliza qué animación se reproduce para cada reacción del agente. Las vistas previas usan la mascota predeterminada.",
+  "settings.reactions.description": "Personaliza qué animación se reproduce para cada reacción del agente. Las vistas previas usan la Familiar predeterminada.",
   "settings.reactions.previewAria": "Animación: {state}",
   "settings.toast.reactionsReset": "Animaciones de reacción restablecidas.",
   "settings.toast.reactionSaved": "Animación de reacción guardada.",
@@ -255,7 +255,7 @@ export const es419: Partial<Messages> = {
   "settings.reaction.waiting.label": "Esperando",
   "settings.reaction.waiting.description": "El agente está bloqueado o esperando permisos.",
   "settings.reaction.waving.label": "Saludando",
-  "settings.reaction.waving.description": "La mascota saluda o llama la atención.",
+  "settings.reaction.waving.description": "La Familiar saluda o llama la atención.",
   "settings.reaction.success.label": "Éxito",
   "settings.reaction.success.description": "La tarea se completó correctamente.",
   "settings.reaction.error.label": "Error",
@@ -272,13 +272,13 @@ export const es419: Partial<Messages> = {
   "settings.ai.description": "Model, endpoint, and system instructions used by the built-in floating chat.",
   "settings.tts.eyebrow": "Voice",
   "settings.tts.title": "Text-to-Speech",
-  "settings.tts.description": "Voice provider and controls for the pet and floating chat.",
+  "settings.tts.description": "Voice provider and controls for the familiar and floating chat.",
   "settings.tts.placeholder": "TTS provider settings will appear here in the next build step.",
   "settings.plugins.audio.title": "Los complementos pueden reproducir sonido",
   "settings.plugins.audio.description": "Permite tonos, alertas y sonidos incluidos de los complementos.",
   "settings.plugins.voice.title": "Los complementos pueden hablar (voz)",
   "settings.plugins.voice.description": "Permite la conversión de texto a voz mediante la voz del sistema.",
-  "settings.plugins.dynamicSpeech.title": "Permitir habla de la mascota generada por IA",
+  "settings.plugins.dynamicSpeech.title": "Permitir habla de la Familiar generada por IA",
   "settings.plugins.dynamicSpeech.description": "Sensible: permite que los complementos aprobados muestren globos generados por el modelo.",
   "settings.plugins.microphone.title": "Permitir micrófono (presionar para hablar)",
   "settings.plugins.microphone.description": "Sensible: permite que los complementos aprobados capturen una entrada de voz puntual.",
@@ -401,22 +401,22 @@ export const es419: Partial<Messages> = {
   "plugins.busy.uninstalling": "Desinstalando",
 
   // --- Plugin permission labels (renderer) ---
-  "plugins.permission.pet:speak": "Habla",
-  "plugins.permission.pet:reaction": "Reacciones",
-  "plugins.permission.pet:move": "Movimiento",
+  "plugins.permission.familiar:speak": "Habla",
+  "plugins.permission.familiar:reaction": "Reacciones",
+  "plugins.permission.familiar:move": "Movimiento",
   "plugins.permission.timer": "Temporizadores",
   "plugins.permission.schedule": "Programación",
   "plugins.permission.storage": "Almacenamiento",
   "plugins.permission.status": "Estado",
   "plugins.permission.commands": "Comandos",
   "plugins.permission.network": "Red",
-  "plugins.permission.pet:interact": "Botones de globo",
-  "plugins.permission.pet:pin": "Globo fijado",
-  "plugins.permission.pet:animate": "Animación personalizada",
-  "plugins.permission.pet:speak:dynamic": "Habla por IA",
-  "plugins.permission.pet:drop": "Arrastrar y soltar",
-  "plugins.permission.pets:read": "Leer mascotas",
-  "plugins.permission.pets:manage": "Administrar mascotas",
+  "plugins.permission.familiar:interact": "Botones de globo",
+  "plugins.permission.familiar:pin": "Globo fijado",
+  "plugins.permission.familiar:animate": "Animación personalizada",
+  "plugins.permission.familiar:speak:dynamic": "Habla por IA",
+  "plugins.permission.familiar:drop": "Arrastrar y soltar",
+  "plugins.permission.familiars:read": "Leer Familiars",
+  "plugins.permission.familiars:manage": "Administrar Familiars",
   "plugins.permission.audio": "Sonido",
   "plugins.permission.events": "Eventos",
   "plugins.permission.ui:toast": "Notificaciones emergentes",
@@ -440,14 +440,14 @@ export const es419: Partial<Messages> = {
   "integrations.commandMode.local": "Desarrollo local",
   "integrations.loading": "Cargando integraciones…",
   "integrations.claude.name": "Claude Code",
-  "integrations.claude.description": "Conecta Claude Code a tu compañero de OpenPets.",
+  "integrations.claude.description": "Conecta Claude Code a tu compañero de FamiliarOS.",
   "integrations.opencode.name": "OpenCode",
-  "integrations.opencode.description": "Conecta OpenCode globalmente a tu compañero de OpenPets.",
+  "integrations.opencode.description": "Conecta OpenCode globalmente a tu compañero de FamiliarOS.",
   "integrations.cursor.name": "Cursor",
-  "integrations.cursor.description": "Conecta Cursor a tu compañero de OpenPets mediante la configuración global de MCP.",
+  "integrations.cursor.description": "Conecta Cursor a tu compañero de FamiliarOS mediante la configuración global de MCP.",
   "integrations.pi.name": "Pi",
   "integrations.pi.status": "Manual",
-  "integrations.pi.description": "Conecta la actividad del agente de programación Pi mediante el paquete de extensión Pi de OpenPets.",
+  "integrations.pi.description": "Conecta la actividad del agente de programación Pi mediante el paquete de extensión Pi de FamiliarOS.",
   "integrations.soon.vscode": "VS Code",
   "integrations.soon.windsurf": "Windsurf",
   "integrations.soon.zed": "Zed",
@@ -463,13 +463,13 @@ export const es419: Partial<Messages> = {
   "integrations.commandSource": "Origen del comando",
   "integrations.cliMode": "Modo de CLI",
   "integrations.localUnavailable": " no disponible",
-  "integrations.commandModeHelp": "Usa el paquete publicado para una configuración normal, el incluido para la compilación de la app de escritorio, o el local mientras desarrollas OpenPets.",
+  "integrations.commandModeHelp": "Usa el paquete publicado para una configuración normal, el incluido para la compilación de la app de escritorio, o el local mientras desarrollas FamiliarOS.",
   "integrations.connection": "Conexión",
   "integrations.statusRouting": "Estado y enrutamiento",
   "integrations.globalSetup": "Configuración global",
   "integrations.globalMcp": "MCP global",
-  "integrations.petRouting": "Enrutamiento de mascotas",
-  "integrations.defaultPet": "Mascota predeterminada",
+  "integrations.petRouting": "Enrutamiento de Familiars",
+  "integrations.defaultPet": "Familiar predeterminada",
   "integrations.configuration": "Configuración",
   "integrations.commandPaths": "Rutas de comandos",
   "integrations.claudeCommand": "Comando de Claude",
@@ -497,12 +497,12 @@ export const es419: Partial<Messages> = {
   "integrations.rulesPreview": "Vista previa de reglas",
   "integrations.pi.manualSetup": "Configuración manual",
   "integrations.pi.extension": "Extensión Pi",
-  "integrations.pi.intro": "Instala la extensión Pi de OpenPets desde Pi y luego usa los comandos de barra dentro de una sesión de Pi.",
+  "integrations.pi.intro": "Instala la extensión Pi de FamiliarOS desde Pi y luego usa los comandos de barra dentro de una sesión de Pi.",
   "integrations.pi.globalInstall": "Instalación global",
   "integrations.pi.projectInstall": "Instalación del proyecto",
   "integrations.pi.remove": "Quitar",
   "integrations.pi.slashCommands": "Comandos de barra",
-  "integrations.pi.outro": "Usa la instalación global para todos los espacios de trabajo de Pi, o la instalación del proyecto cuando solo quieras OpenPets en el proyecto actual.",
+  "integrations.pi.outro": "Usa la instalación global para todos los espacios de trabajo de Pi, o la instalación del proyecto cuando solo quieras FamiliarOS en el proyecto actual.",
   "integrations.toast.pathSaved": "Ruta guardada.",
   "integrations.busy.installing": "Instalando",
   "integrations.busy.replacing": "Reemplazando",
@@ -517,21 +517,21 @@ export const es419: Partial<Messages> = {
   "integrations.mcpToolServers.noTools": "None active",
   "integrations.mcpToolServers.builtInChat": "Built-in Chat",
   "integrations.mcpToolServers.saved": "Saved {count} tool server(s).",
-  "integrations.openpetsMcpServer.name": "OpenPets MCP Server",
-  "integrations.openpetsMcpServer.description": "External-agent bridge that exposes your pet to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
-  "integrations.openpetsMcpServer.commandModeHelp": "Choose how the OpenPets MCP server is launched for external hosts.",
-  "integrations.openpetsMcpServer.testServer": "Test Server",
-  "integrations.openpetsMcpServer.testBusy": "Testing server…",
-  "integrations.openpetsMcpServer.testOk": "Server responded: {output}",
-  "integrations.openpetsMcpServer.testError": "Server test failed: {error}",
-  "integrations.openpetsMcpServer.copyMcpJson": "Copy MCP JSON",
-  "integrations.openpetsMcpServer.status": "Ready",
+  "integrations.familiarosMcpServer.name": "FamiliarOS MCP Server",
+  "integrations.familiarosMcpServer.description": "External-agent bridge that exposes your familiar to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
+  "integrations.familiarosMcpServer.commandModeHelp": "Choose how the FamiliarOS MCP server is launched for external hosts.",
+  "integrations.familiarosMcpServer.testServer": "Test Server",
+  "integrations.familiarosMcpServer.testBusy": "Testing server…",
+  "integrations.familiarosMcpServer.testOk": "Server responded: {output}",
+  "integrations.familiarosMcpServer.testError": "Server test failed: {error}",
+  "integrations.familiarosMcpServer.copyMcpJson": "Copy MCP JSON",
+  "integrations.familiarosMcpServer.status": "Ready",
   "integrations.curatedToolkit.name": "Curated MCP Toolkit",
   "integrations.curatedToolkit.description": "Starter stack for filesystem, Git, browser use, memory, databases, Docker, and terminal-oriented MCP lanes.",
-  "integrations.linkToCentralPanel": "Configure in the OpenPets MCP Server panel above.",
+  "integrations.linkToCentralPanel": "Configure in the FamiliarOS MCP Server panel above.",
 
   // --- Settings: Language section (renderer) ---
   "settings.language.title": "Idioma",
-  "settings.language.description": "Idioma de visualización de los menús y ventanas de OpenPets.",
+  "settings.language.description": "Idioma de visualización de los menús y ventanas de FamiliarOS.",
   "settings.language.system": "Predeterminado del sistema",
 };
diff --git a/apps/desktop/src/i18n/locales/ja.ts b/apps/desktop/src/i18n/locales/ja.ts
index b2398d53..172c8799 100644
--- a/apps/desktop/src/i18n/locales/ja.ts
+++ b/apps/desktop/src/i18n/locales/ja.ts
@@ -4,38 +4,38 @@ import type { Messages } from "../catalog.js";
 export const ja: Partial<Messages> = {
   // --- Tray menu (main process, src/tray.ts) ---
   "tray.updateAvailable": "アップデートがあります: {version}...",
-  "tray.defaultPet": "デフォルトのペット: {name}",
-  "tray.toggleDefaultPet.show": "デフォルトのペットを表示",
-  "tray.toggleDefaultPet.hide": "デフォルトのペットを非表示",
-  "tray.pauseAllPets": "すべてのペットを一時停止",
-  "tray.resumeAllPets": "すべてのペットを再開",
-  "tray.managePets": "ペットを管理...",
+  "tray.defaultPet": "デフォルトのFamiliar: {name}",
+  "tray.toggleDefaultPet.show": "デフォルトのFamiliarを表示",
+  "tray.toggleDefaultPet.hide": "デフォルトのFamiliarを非表示",
+  "tray.pauseAllPets": "すべてのFamiliarを一時停止",
+  "tray.resumeAllPets": "すべてのFamiliarを再開",
+  "tray.managePets": "Familiarを管理...",
   "tray.controlCenter": "コントロールセンター...",
   "tray.website": "ウェブサイト...",
   "tray.integrations": "連携...",
   "tray.plugins": "プラグイン...",
   "tray.settings": "設定...",
   "tray.openLogsFolder": "ログフォルダを開く...",
-  "tray.quit": "OpenPets を終了",
+  "tray.quit": "FamiliarOS を終了",
 
   // --- Shared ---
   "common.latest": "最新",
-  "common.builtInPet": "組み込みペット",
+  "common.builtInPet": "組み込みFamiliar",
   "common.cancel": "キャンセル",
 
-  // --- Pet window (main process, src/pet-window.ts) ---
-  "pet.paused": "一時停止中",
-  "pet.status.thinking": "思考中",
-  "pet.status.working": "作業中",
-  "pet.status.editing": "編集中",
-  "pet.status.testing": "テスト中",
-  "pet.status.waiting": "待機中",
-  "pet.status.done": "完了",
-  "pet.status.oops": "エラー",
-  "pet.status.hi": "こんにちは",
-  "pet.menu.hidePet": "ペットを隠す",
-  "pet.menu.closePet": "ペットを閉じる",
-  "pet.menu.openControlCenter": "コントロールセンターを開く",
+  // --- Familiar window (main process, src/familiar-window.ts) ---
+  "familiar.paused": "一時停止中",
+  "familiar.status.thinking": "思考中",
+  "familiar.status.working": "作業中",
+  "familiar.status.editing": "編集中",
+  "familiar.status.testing": "テスト中",
+  "familiar.status.waiting": "待機中",
+  "familiar.status.done": "完了",
+  "familiar.status.oops": "エラー",
+  "familiar.status.hi": "こんにちは",
+  "familiar.menu.hidePet": "Familiarを隠す",
+  "familiar.menu.closePet": "Familiarを閉じる",
+  "familiar.menu.openControlCenter": "コントロールセンターを開く",
 
   // --- Common (renderer, shared across views) ---
   "common.retry": "再試行",
@@ -45,7 +45,7 @@ export const ja: Partial<Messages> = {
 
   // --- Navigation tabs (renderer) ---
   "nav.dashboard": "ダッシュボード",
-  "nav.pets": "ペット",
+  "nav.familiars": "Familiar",
   "nav.settings": "設定",
   "nav.plugins": "プラグイン",
   "nav.integrations": "連携",
@@ -53,8 +53,8 @@ export const ja: Partial<Messages> = {
   // --- Route metadata (renderer hero header) ---
   "route.dashboard.title": "ダッシュボード",
   "route.dashboard.description": "アクティブな相棒、ステータス、システム指標の概要。",
-  "route.pets.title": "ペット",
-  "route.pets.description": "デスクトップの相棒をインストール、インポート、プレビューして選びましょう。",
+  "route.familiars.title": "Familiar",
+  "route.familiars.description": "デスクトップの相棒をインストール、インポート、プレビューして選びましょう。",
   "route.settings.title": "設定",
   "route.settings.description": "起動時の動作、サイズ設定、アニメーション設定を構成します。",
   "route.plugins.title": "プラグイン",
@@ -64,13 +64,13 @@ export const ja: Partial<Messages> = {
 
   // --- App shell (renderer) ---
   "app.controlCenter": "コントロールセンター",
-  "app.logo.alt": "OpenPets",
+  "app.logo.alt": "FamiliarOS",
 
   // --- Dashboard (renderer) ---
   "dashboard.loading": "相棒の指標を収集中...",
   "dashboard.hero.eyebrow": "メインの相棒",
   "dashboard.hero.desc": "次のコーディングセッションの準備は万全です。",
-  "dashboard.hero.changePet": "ペットを変更",
+  "dashboard.hero.changePet": "Familiarを変更",
   "dashboard.lastActive.none": "まだ活動がありません",
   "dashboard.update.available": "アップデートあり",
   "dashboard.update.error": "確認に失敗",
@@ -82,7 +82,7 @@ export const ja: Partial<Messages> = {
   "dashboard.stat.reactions": "リアクション",
   "dashboard.stat.reactions.footer": "発生したアニメーションの合計",
   "dashboard.stat.topCompanion": "トップの相棒",
-  "dashboard.stat.topCompanion.footer": "最近もっとも活発なペット",
+  "dashboard.stat.topCompanion.footer": "最近もっとも活発なFamiliar",
   "dashboard.activity.title": "アクティビティ概要",
   "dashboard.activity.topReactions": "トップリアクション",
   "dashboard.activity.noReactions": "まだリアクションがありません。コーディングを始めましょう！",
@@ -93,17 +93,17 @@ export const ja: Partial<Messages> = {
   "dashboard.reactionMix.reactions": "リアクション",
   "dashboard.reactionMix.empty": "まだリアクションの内訳がありません。",
   "dashboard.companions.title": "トップの相棒",
-  "dashboard.companions.subtitle": "もっとも活発なペット",
+  "dashboard.companions.subtitle": "もっとも活発なFamiliar",
   "dashboard.companions.empty": "まだ相棒の活動がありません。",
   "dashboard.lastActive.label": "最終アクティブ: ",
   "dashboard.system.title": "システムの状態",
-  "dashboard.system.pets": "ペット",
-  "dashboard.system.pets.value": "{count} 個インストール済み",
+  "dashboard.system.familiars": "Familiar",
+  "dashboard.system.familiars.value": "{count} 個インストール済み",
   "dashboard.system.plugins": "プラグイン",
   "dashboard.system.plugins.enabled": "{count} 個有効",
   "dashboard.system.catalog": "カタログ",
   "dashboard.system.catalog.offline": "オフライン",
-  "dashboard.system.catalog.pets": "{count} 個のペット",
+  "dashboard.system.catalog.familiars": "{count} 個のFamiliar",
   "dashboard.system.catalog.ready": "準備完了",
   "dashboard.system.updates": "アップデート",
   "dashboard.system.version": "バージョン",
@@ -111,77 +111,77 @@ export const ja: Partial<Messages> = {
   // --- Placeholder view (renderer) ---
   "placeholder.comingSoon": "近日公開 • 次の移行対象",
 
-  // --- Pets filters (renderer) ---
-  "pets.filter.all": "すべて",
-  "pets.filter.installed": "インストール済み",
-  "pets.filter.featured": "おすすめ",
-  "pets.filter.originals": "オリジナル",
-  "pets.filter.codex": "Codex",
-  "pets.search.placeholder": "ペットを検索...",
-  "pets.import": "ペットをインポート",
-  "pets.gallery": "ギャラリー",
+  // --- Familiars filters (renderer) ---
+  "familiars.filter.all": "すべて",
+  "familiars.filter.installed": "インストール済み",
+  "familiars.filter.featured": "おすすめ",
+  "familiars.filter.originals": "オリジナル",
+  "familiars.filter.codex": "Codex",
+  "familiars.search.placeholder": "Familiarを検索...",
+  "familiars.import": "Familiarをインポート",
+  "familiars.gallery": "ギャラリー",
 
-  // --- Pets card badges/actions (renderer) ---
-  "pets.badge.default": "デフォルト",
-  "pets.badge.original": "オリジナル",
-  "pets.badge.featured": "おすすめ",
-  "pets.badge.installed": "インストール済み",
-  "pets.badge.codex": "Codex",
-  "pets.badge.broken": "破損",
-  "pets.badge.ready": "準備完了",
-  "pets.badge.originals": "オリジナル",
-  "pets.action.viewPet": "ペットを表示",
-  "pets.action.install": "インストール",
-  "pets.action.import": "インポート",
-  "pets.action.default": "デフォルト",
-  "pets.action.remove": "削除",
-  "pets.action.refresh": "更新",
-  "pets.aria.view": "{name} を表示",
-  "pets.aria.install": "{name} をインストール",
-  "pets.aria.import": "{name} を Codex からインポート",
-  "pets.aria.setDefault": "{name} をデフォルトに設定",
-  "pets.aria.remove": "{name} を削除",
-  "pets.busy.installing": "インストール中",
-  "pets.busy.importing": "インポート中",
-  "pets.busy.settingDefault": "デフォルトに設定中",
-  "pets.busy.removing": "削除中",
-  "pets.busy.loadingPage": "ページを読み込み中",
+  // --- Familiars card badges/actions (renderer) ---
+  "familiars.badge.default": "デフォルト",
+  "familiars.badge.original": "オリジナル",
+  "familiars.badge.featured": "おすすめ",
+  "familiars.badge.installed": "インストール済み",
+  "familiars.badge.codex": "Codex",
+  "familiars.badge.broken": "破損",
+  "familiars.badge.ready": "準備完了",
+  "familiars.badge.originals": "オリジナル",
+  "familiars.action.viewPet": "Familiarを表示",
+  "familiars.action.install": "インストール",
+  "familiars.action.import": "インポート",
+  "familiars.action.default": "デフォルト",
+  "familiars.action.remove": "削除",
+  "familiars.action.refresh": "更新",
+  "familiars.aria.view": "{name} を表示",
+  "familiars.aria.install": "{name} をインストール",
+  "familiars.aria.import": "{name} を Codex からインポート",
+  "familiars.aria.setDefault": "{name} をデフォルトに設定",
+  "familiars.aria.remove": "{name} を削除",
+  "familiars.busy.installing": "インストール中",
+  "familiars.busy.importing": "インポート中",
+  "familiars.busy.settingDefault": "デフォルトに設定中",
+  "familiars.busy.removing": "削除中",
+  "familiars.busy.loadingPage": "ページを読み込み中",
 
-  // --- Pets pager (renderer) ---
-  "pets.pager.prev": "前へ",
-  "pets.pager.next": "次へ",
-  "pets.pager.count": "{count} 個のペット",
-  "pets.pager.page": " · {pageCount} ページ中 {page} ページ目",
+  // --- Familiars pager (renderer) ---
+  "familiars.pager.prev": "前へ",
+  "familiars.pager.next": "次へ",
+  "familiars.pager.count": "{count} 個のFamiliar",
+  "familiars.pager.page": " · {pageCount} ページ中 {page} ページ目",
 
-  // --- Pet detail dialog (renderer) ---
-  "pets.detail.ariaLabel": "{name} のペット詳細",
-  "pets.detail.closeAria": "ペット詳細を閉じる",
-  "pets.detail.eyebrow": "ペット詳細",
-  "pets.detail.previewAnimations": "アニメーションをプレビュー",
-  "pets.detail.preview.idle": "待機",
-  "pets.detail.preview.thinking": "思考中",
-  "pets.detail.preview.happy": "うれしい",
-  "pets.detail.preview.wave": "手を振る",
-  "pets.detail.installPet": "ペットをインストール",
-  "pets.detail.importCodexPet": "Codex ペットをインポート",
-  "pets.detail.setDefaultPet": "デフォルトのペットに設定",
-  "pets.detail.remove": "削除",
-  "pets.detail.refresh": "更新",
+  // --- Familiar detail dialog (renderer) ---
+  "familiars.detail.ariaLabel": "{name} のFamiliar詳細",
+  "familiars.detail.closeAria": "Familiar詳細を閉じる",
+  "familiars.detail.eyebrow": "Familiar詳細",
+  "familiars.detail.previewAnimations": "アニメーションをプレビュー",
+  "familiars.detail.preview.idle": "待機",
+  "familiars.detail.preview.thinking": "思考中",
+  "familiars.detail.preview.happy": "うれしい",
+  "familiars.detail.preview.wave": "手を振る",
+  "familiars.detail.installPet": "Familiarをインストール",
+  "familiars.detail.importCodexPet": "Codex Familiarをインポート",
+  "familiars.detail.setDefaultPet": "デフォルトのFamiliarに設定",
+  "familiars.detail.remove": "削除",
+  "familiars.detail.refresh": "更新",
 
-  // --- Pet detail status text (renderer) ---
-  "pets.status.broken": "このインストール済みペットは破損しており、デフォルトに設定できません。",
-  "pets.status.defaultProtected": "デフォルトの組み込みペット。削除から保護されています。",
-  "pets.status.default": "デフォルトのペット。",
-  "pets.status.installedCodex": "インストール済みで、デフォルトのペットに設定できます。~/.codex/pets にもあります。",
-  "pets.status.installed": "インストール済みで、デフォルトのペットに設定できます。",
-  "pets.status.availableCodex": "~/.codex/pets からインポートできます。",
-  "pets.status.availableCatalog": "カタログからインストールできます。",
+  // --- Familiar detail status text (renderer) ---
+  "familiars.status.broken": "このインストール済みFamiliarは破損しており、デフォルトに設定できません。",
+  "familiars.status.defaultProtected": "デフォルトの組み込みFamiliar。削除から保護されています。",
+  "familiars.status.default": "デフォルトのFamiliar。",
+  "familiars.status.installedCodex": "インストール済みで、デフォルトのFamiliarに設定できます。~/.codex/familiars にもあります。",
+  "familiars.status.installed": "インストール済みで、デフォルトのFamiliarに設定できます。",
+  "familiars.status.availableCodex": "~/.codex/familiars からインポートできます。",
+  "familiars.status.availableCatalog": "カタログからインストールできます。",
 
-  // --- Pet labels for SpriteFrame/PetImage (renderer) ---
-  "pets.spriteLabel.thumbnail": "{name} のサムネイル",
-  "pets.spriteLabel.thumb": "{name} のサムネイル",
-  "pets.spriteLabel.animatedPreview": "{name} のアニメーションプレビュー",
-  "pets.spriteLabel.statePreview": "{name} の {state} プレビュー",
+  // --- Familiar labels for SpriteFrame/PetImage (renderer) ---
+  "familiars.spriteLabel.thumbnail": "{name} のサムネイル",
+  "familiars.spriteLabel.thumb": "{name} のサムネイル",
+  "familiars.spriteLabel.animatedPreview": "{name} のアニメーションプレビュー",
+  "familiars.spriteLabel.statePreview": "{name} の {state} プレビュー",
 
   // --- Settings: general (renderer) ---
   "settings.nav.general": "一般",
@@ -189,22 +189,22 @@ export const ja: Partial<Messages> = {
   "settings.nav.plugins": "プラグインプラットフォーム",
   "settings.general.eyebrow": "環境",
   "settings.general.title": "一般設定",
-  "settings.general.showOnLaunch.title": "起動時にペットを表示",
-  "settings.general.showOnLaunch.description": "OpenPets をトレイに常駐させつつ、要求があるまでペットを非表示にします。",
+  "settings.general.showOnLaunch.title": "起動時にFamiliarを表示",
+  "settings.general.showOnLaunch.description": "FamiliarOS をトレイに常駐させつつ、要求があるまでFamiliarを非表示にします。",
   "settings.general.launchAtLogin.title": "ログイン時に起動",
-  "settings.general.launchAtLogin.supported": "コンピューターの起動時に OpenPets を自動的に開始します。",
+  "settings.general.launchAtLogin.supported": "コンピューターの起動時に FamiliarOS を自動的に開始します。",
   "settings.general.launchAtLogin.unsupported": "このプラットフォームではサポートされていません。",
-  "settings.general.petScale.title": "ペットのサイズ",
-  "settings.general.petScale.description": "デフォルトのデスクトップペットの表示サイズを調整します。",
-  "settings.general.resetPosition": "ペットの位置をリセット",
+  "settings.general.petScale.title": "Familiarのサイズ",
+  "settings.general.petScale.description": "デフォルトのデスクトップFamiliarの表示サイズを調整します。",
+  "settings.general.resetPosition": "Familiarの位置をリセット",
   "settings.general.systemStatus": "システムステータス",
   "settings.general.updateAvailable": "アップデートあり",
   "settings.general.checking": "確認中…",
   "settings.general.checkForUpdates": "アップデートを確認",
   "settings.toast.startupSaved": "起動時の設定を保存しました。",
   "settings.toast.loginStartupSaved": "ログイン起動の設定を保存しました。",
-  "settings.toast.petScaleSaved": "ペットのサイズを保存しました。",
-  "settings.toast.positionReset": "デフォルトペットの位置をリセットしました。",
+  "settings.toast.petScaleSaved": "Familiarのサイズを保存しました。",
+  "settings.toast.positionReset": "デフォルトFamiliarの位置をリセットしました。",
   "settings.busy.saving": "保存中",
   "settings.busy.resetting": "リセット中",
   "settings.busy.opening": "開いています",
@@ -222,7 +222,7 @@ export const ja: Partial<Messages> = {
   "settings.reactions.eyebrow": "動作",
   "settings.reactions.title": "リアクション設定",
   "settings.reactions.resetDefaults": "デフォルトに戻す",
-  "settings.reactions.description": "各エージェントのリアクションで再生するアニメーションをカスタマイズします。プレビューはデフォルトのペットを使用します。",
+  "settings.reactions.description": "各エージェントのリアクションで再生するアニメーションをカスタマイズします。プレビューはデフォルトのFamiliarを使用します。",
   "settings.reactions.previewAria": "アニメーション: {state}",
   "settings.toast.reactionsReset": "リアクションアニメーションをリセットしました。",
   "settings.toast.reactionSaved": "リアクションアニメーションを保存しました。",
@@ -255,7 +255,7 @@ export const ja: Partial<Messages> = {
   "settings.reaction.waiting.label": "待機中",
   "settings.reaction.waiting.description": "エージェントがブロック中または許可待ち。",
   "settings.reaction.waving.label": "手を振る",
-  "settings.reaction.waving.description": "ペットがあいさつまたは注目を促しています。",
+  "settings.reaction.waving.description": "Familiarがあいさつまたは注目を促しています。",
   "settings.reaction.success.label": "成功",
   "settings.reaction.success.description": "タスクが正常に完了しました。",
   "settings.reaction.error.label": "エラー",
@@ -272,13 +272,13 @@ export const ja: Partial<Messages> = {
   "settings.ai.description": "Model, endpoint, and system instructions used by the built-in floating chat.",
   "settings.tts.eyebrow": "Voice",
   "settings.tts.title": "Text-to-Speech",
-  "settings.tts.description": "Voice provider and controls for the pet and floating chat.",
+  "settings.tts.description": "Voice provider and controls for the familiar and floating chat.",
   "settings.tts.placeholder": "TTS provider settings will appear here in the next build step.",
   "settings.plugins.audio.title": "プラグインによる音の再生を許可",
   "settings.plugins.audio.description": "プラグインのチャイム、アラート、付属サウンドを許可します。",
   "settings.plugins.voice.title": "プラグインによる音声発話を許可",
   "settings.plugins.voice.description": "システム音声によるテキスト読み上げを許可します。",
-  "settings.plugins.dynamicSpeech.title": "AI 生成のペット発話を許可",
+  "settings.plugins.dynamicSpeech.title": "AI 生成のFamiliar発話を許可",
   "settings.plugins.dynamicSpeech.description": "機微: 承認済みプラグインがモデル生成の吹き出しを表示できるようにします。",
   "settings.plugins.microphone.title": "マイクを許可（プッシュトゥトーク）",
   "settings.plugins.microphone.description": "機微: 承認済みプラグインが単発の音声入力を取得できるようにします。",
@@ -401,22 +401,22 @@ export const ja: Partial<Messages> = {
   "plugins.busy.uninstalling": "アンインストール中",
 
   // --- Plugin permission labels (renderer) ---
-  "plugins.permission.pet:speak": "発話",
-  "plugins.permission.pet:reaction": "リアクション",
-  "plugins.permission.pet:move": "移動",
+  "plugins.permission.familiar:speak": "発話",
+  "plugins.permission.familiar:reaction": "リアクション",
+  "plugins.permission.familiar:move": "移動",
   "plugins.permission.timer": "タイマー",
   "plugins.permission.schedule": "スケジュール",
   "plugins.permission.storage": "ストレージ",
   "plugins.permission.status": "ステータス",
   "plugins.permission.commands": "コマンド",
   "plugins.permission.network": "ネットワーク",
-  "plugins.permission.pet:interact": "吹き出しボタン",
-  "plugins.permission.pet:pin": "固定吹き出し",
-  "plugins.permission.pet:animate": "カスタムアニメーション",
-  "plugins.permission.pet:speak:dynamic": "AI 発話",
-  "plugins.permission.pet:drop": "ドラッグ＆ドロップ",
-  "plugins.permission.pets:read": "ペットの読み取り",
-  "plugins.permission.pets:manage": "ペットの管理",
+  "plugins.permission.familiar:interact": "吹き出しボタン",
+  "plugins.permission.familiar:pin": "固定吹き出し",
+  "plugins.permission.familiar:animate": "カスタムアニメーション",
+  "plugins.permission.familiar:speak:dynamic": "AI 発話",
+  "plugins.permission.familiar:drop": "ドラッグ＆ドロップ",
+  "plugins.permission.familiars:read": "Familiarの読み取り",
+  "plugins.permission.familiars:manage": "Familiarの管理",
   "plugins.permission.audio": "サウンド",
   "plugins.permission.events": "イベント",
   "plugins.permission.ui:toast": "トースト",
@@ -440,14 +440,14 @@ export const ja: Partial<Messages> = {
   "integrations.commandMode.local": "ローカル開発",
   "integrations.loading": "連携を読み込み中…",
   "integrations.claude.name": "Claude Code",
-  "integrations.claude.description": "Claude Code を OpenPets の相棒に接続します。",
+  "integrations.claude.description": "Claude Code を FamiliarOS の相棒に接続します。",
   "integrations.opencode.name": "OpenCode",
-  "integrations.opencode.description": "OpenCode をグローバルに OpenPets の相棒に接続します。",
+  "integrations.opencode.description": "OpenCode をグローバルに FamiliarOS の相棒に接続します。",
   "integrations.cursor.name": "Cursor",
-  "integrations.cursor.description": "グローバル MCP 設定を通じて Cursor を OpenPets の相棒に接続します。",
+  "integrations.cursor.description": "グローバル MCP 設定を通じて Cursor を FamiliarOS の相棒に接続します。",
   "integrations.pi.name": "Pi",
   "integrations.pi.status": "手動",
-  "integrations.pi.description": "OpenPets Pi 拡張パッケージを通じて Pi コーディングエージェントの活動を接続します。",
+  "integrations.pi.description": "FamiliarOS Pi 拡張パッケージを通じて Pi コーディングエージェントの活動を接続します。",
   "integrations.soon.vscode": "VS Code",
   "integrations.soon.windsurf": "Windsurf",
   "integrations.soon.zed": "Zed",
@@ -463,13 +463,13 @@ export const ja: Partial<Messages> = {
   "integrations.commandSource": "コマンドソース",
   "integrations.cliMode": "CLI モード",
   "integrations.localUnavailable": " は利用できません",
-  "integrations.commandModeHelp": "通常のセットアップには公開パッケージ、デスクトップアプリのビルドには同梱、OpenPets の開発時にはローカルを使用します。",
+  "integrations.commandModeHelp": "通常のセットアップには公開パッケージ、デスクトップアプリのビルドには同梱、FamiliarOS の開発時にはローカルを使用します。",
   "integrations.connection": "接続",
   "integrations.statusRouting": "ステータスとルーティング",
   "integrations.globalSetup": "グローバルセットアップ",
   "integrations.globalMcp": "グローバル MCP",
-  "integrations.petRouting": "ペットのルーティング",
-  "integrations.defaultPet": "デフォルトのペット",
+  "integrations.petRouting": "Familiarのルーティング",
+  "integrations.defaultPet": "デフォルトのFamiliar",
   "integrations.configuration": "設定",
   "integrations.commandPaths": "コマンドパス",
   "integrations.claudeCommand": "Claude コマンド",
@@ -497,12 +497,12 @@ export const ja: Partial<Messages> = {
   "integrations.rulesPreview": "ルールプレビュー",
   "integrations.pi.manualSetup": "手動セットアップ",
   "integrations.pi.extension": "Pi 拡張機能",
-  "integrations.pi.intro": "Pi から OpenPets Pi 拡張機能をインストールし、Pi セッション内でスラッシュコマンドを使用します。",
+  "integrations.pi.intro": "Pi から FamiliarOS Pi 拡張機能をインストールし、Pi セッション内でスラッシュコマンドを使用します。",
   "integrations.pi.globalInstall": "グローバルインストール",
   "integrations.pi.projectInstall": "プロジェクトインストール",
   "integrations.pi.remove": "削除",
   "integrations.pi.slashCommands": "スラッシュコマンド",
-  "integrations.pi.outro": "すべての Pi ワークスペースに使うにはグローバルインストール、現在のプロジェクトだけで OpenPets を使うにはプロジェクトインストールを選びます。",
+  "integrations.pi.outro": "すべての Pi ワークスペースに使うにはグローバルインストール、現在のプロジェクトだけで FamiliarOS を使うにはプロジェクトインストールを選びます。",
   "integrations.toast.pathSaved": "パスを保存しました。",
   "integrations.busy.installing": "インストール中",
   "integrations.busy.replacing": "置き換え中",
@@ -517,21 +517,21 @@ export const ja: Partial<Messages> = {
   "integrations.mcpToolServers.noTools": "None active",
   "integrations.mcpToolServers.builtInChat": "Built-in Chat",
   "integrations.mcpToolServers.saved": "Saved {count} tool server(s).",
-  "integrations.openpetsMcpServer.name": "OpenPets MCP Server",
-  "integrations.openpetsMcpServer.description": "External-agent bridge that exposes your pet to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
-  "integrations.openpetsMcpServer.commandModeHelp": "Choose how the OpenPets MCP server is launched for external hosts.",
-  "integrations.openpetsMcpServer.testServer": "Test Server",
-  "integrations.openpetsMcpServer.testBusy": "Testing server…",
-  "integrations.openpetsMcpServer.testOk": "Server responded: {output}",
-  "integrations.openpetsMcpServer.testError": "Server test failed: {error}",
-  "integrations.openpetsMcpServer.copyMcpJson": "Copy MCP JSON",
-  "integrations.openpetsMcpServer.status": "Ready",
+  "integrations.familiarosMcpServer.name": "FamiliarOS MCP Server",
+  "integrations.familiarosMcpServer.description": "External-agent bridge that exposes your familiar to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
+  "integrations.familiarosMcpServer.commandModeHelp": "Choose how the FamiliarOS MCP server is launched for external hosts.",
+  "integrations.familiarosMcpServer.testServer": "Test Server",
+  "integrations.familiarosMcpServer.testBusy": "Testing server…",
+  "integrations.familiarosMcpServer.testOk": "Server responded: {output}",
+  "integrations.familiarosMcpServer.testError": "Server test failed: {error}",
+  "integrations.familiarosMcpServer.copyMcpJson": "Copy MCP JSON",
+  "integrations.familiarosMcpServer.status": "Ready",
   "integrations.curatedToolkit.name": "Curated MCP Toolkit",
   "integrations.curatedToolkit.description": "Starter stack for filesystem, Git, browser use, memory, databases, Docker, and terminal-oriented MCP lanes.",
-  "integrations.linkToCentralPanel": "Configure in the OpenPets MCP Server panel above.",
+  "integrations.linkToCentralPanel": "Configure in the FamiliarOS MCP Server panel above.",
 
   // --- Settings: Language section (renderer) ---
   "settings.language.title": "言語",
-  "settings.language.description": "OpenPets のメニューとウィンドウの表示言語。",
+  "settings.language.description": "FamiliarOS のメニューとウィンドウの表示言語。",
   "settings.language.system": "システムのデフォルト",
 };
diff --git a/apps/desktop/src/i18n/locales/ko.ts b/apps/desktop/src/i18n/locales/ko.ts
index 1bcf734d..cebbffad 100644
--- a/apps/desktop/src/i18n/locales/ko.ts
+++ b/apps/desktop/src/i18n/locales/ko.ts
@@ -4,38 +4,38 @@ import type { Messages } from "../catalog.js";
 export const ko: Partial<Messages> = {
   // --- Tray menu (main process, src/tray.ts) ---
   "tray.updateAvailable": "업데이트 사용 가능: {version}...",
-  "tray.defaultPet": "기본 펫: {name}",
-  "tray.toggleDefaultPet.show": "기본 펫 표시",
-  "tray.toggleDefaultPet.hide": "기본 펫 숨기기",
-  "tray.pauseAllPets": "모든 펫 일시정지",
-  "tray.resumeAllPets": "모든 펫 재개",
-  "tray.managePets": "펫 관리...",
+  "tray.defaultPet": "기본 Familiar: {name}",
+  "tray.toggleDefaultPet.show": "기본 Familiar 표시",
+  "tray.toggleDefaultPet.hide": "기본 Familiar 숨기기",
+  "tray.pauseAllPets": "모든 Familiar 일시정지",
+  "tray.resumeAllPets": "모든 Familiar 재개",
+  "tray.managePets": "Familiar 관리...",
   "tray.controlCenter": "컨트롤 센터...",
   "tray.website": "웹사이트...",
   "tray.integrations": "연동...",
   "tray.plugins": "플러그인...",
   "tray.settings": "설정...",
   "tray.openLogsFolder": "로그 폴더 열기...",
-  "tray.quit": "OpenPets 종료",
+  "tray.quit": "FamiliarOS 종료",
 
   // --- Shared ---
   "common.latest": "최신",
-  "common.builtInPet": "기본 내장 펫",
+  "common.builtInPet": "기본 내장 Familiar",
   "common.cancel": "취소",
 
-  // --- Pet window (main process, src/pet-window.ts) ---
-  "pet.paused": "일시정지됨",
-  "pet.status.thinking": "생각 중",
-  "pet.status.working": "작업 중",
-  "pet.status.editing": "편집 중",
-  "pet.status.testing": "테스트 중",
-  "pet.status.waiting": "기다리는 중",
-  "pet.status.done": "완료",
-  "pet.status.oops": "오류",
-  "pet.status.hi": "안녕",
-  "pet.menu.hidePet": "펫 숨기기",
-  "pet.menu.closePet": "펫 닫기",
-  "pet.menu.openControlCenter": "컨트롤 센터 열기",
+  // --- Familiar window (main process, src/familiar-window.ts) ---
+  "familiar.paused": "일시정지됨",
+  "familiar.status.thinking": "생각 중",
+  "familiar.status.working": "작업 중",
+  "familiar.status.editing": "편집 중",
+  "familiar.status.testing": "테스트 중",
+  "familiar.status.waiting": "기다리는 중",
+  "familiar.status.done": "완료",
+  "familiar.status.oops": "오류",
+  "familiar.status.hi": "안녕",
+  "familiar.menu.hidePet": "Familiar 숨기기",
+  "familiar.menu.closePet": "Familiar 닫기",
+  "familiar.menu.openControlCenter": "컨트롤 센터 열기",
 
   // --- Common (renderer, shared across views) ---
   "common.retry": "다시 시도",
@@ -45,7 +45,7 @@ export const ko: Partial<Messages> = {
 
   // --- Navigation tabs (renderer) ---
   "nav.dashboard": "대시보드",
-  "nav.pets": "펫",
+  "nav.familiars": "Familiar",
   "nav.settings": "설정",
   "nav.plugins": "플러그인",
   "nav.integrations": "연동",
@@ -53,8 +53,8 @@ export const ko: Partial<Messages> = {
   // --- Route metadata (renderer hero header) ---
   "route.dashboard.title": "대시보드",
   "route.dashboard.description": "활성 동반자, 상태, 시스템 지표를 한눈에 확인하세요.",
-  "route.pets.title": "펫",
-  "route.pets.description": "기본 데스크톱 동반자를 설치, 가져오기, 미리보기하고 선택하세요.",
+  "route.familiars.title": "Familiar",
+  "route.familiars.description": "기본 데스크톱 동반자를 설치, 가져오기, 미리보기하고 선택하세요.",
   "route.settings.title": "설정",
   "route.settings.description": "시작 동작, 크기 설정, 애니메이션 설정을 구성하세요.",
   "route.plugins.title": "플러그인",
@@ -64,13 +64,13 @@ export const ko: Partial<Messages> = {
 
   // --- App shell (renderer) ---
   "app.controlCenter": "컨트롤 센터",
-  "app.logo.alt": "OpenPets",
+  "app.logo.alt": "FamiliarOS",
 
   // --- Dashboard (renderer) ---
   "dashboard.loading": "동반자 지표를 수집하는 중...",
   "dashboard.hero.eyebrow": "주요 동반자",
   "dashboard.hero.desc": "다음 코딩 세션을 위한 준비 완료.",
-  "dashboard.hero.changePet": "펫 변경",
+  "dashboard.hero.changePet": "Familiar 변경",
   "dashboard.lastActive.none": "아직 활동 없음",
   "dashboard.update.available": "업데이트 사용 가능",
   "dashboard.update.error": "확인 실패",
@@ -82,7 +82,7 @@ export const ko: Partial<Messages> = {
   "dashboard.stat.reactions": "반응",
   "dashboard.stat.reactions.footer": "실행된 애니메이션 총수",
   "dashboard.stat.topCompanion": "최고 동반자",
-  "dashboard.stat.topCompanion.footer": "최근 가장 활발한 펫",
+  "dashboard.stat.topCompanion.footer": "최근 가장 활발한 Familiar",
   "dashboard.activity.title": "활동 개요",
   "dashboard.activity.topReactions": "주요 반응",
   "dashboard.activity.noReactions": "아직 기록된 반응이 없습니다. 코딩을 시작하세요!",
@@ -93,17 +93,17 @@ export const ko: Partial<Messages> = {
   "dashboard.reactionMix.reactions": "반응",
   "dashboard.reactionMix.empty": "아직 반응 구성이 없습니다.",
   "dashboard.companions.title": "최고 동반자",
-  "dashboard.companions.subtitle": "가장 활발한 펫",
+  "dashboard.companions.subtitle": "가장 활발한 Familiar",
   "dashboard.companions.empty": "아직 동반자 활동이 없습니다.",
   "dashboard.lastActive.label": "마지막 활동: ",
   "dashboard.system.title": "시스템 상태",
-  "dashboard.system.pets": "펫",
-  "dashboard.system.pets.value": "{count}개 설치됨",
+  "dashboard.system.familiars": "Familiar",
+  "dashboard.system.familiars.value": "{count}개 설치됨",
   "dashboard.system.plugins": "플러그인",
   "dashboard.system.plugins.enabled": "{count}개 활성화됨",
   "dashboard.system.catalog": "카탈로그",
   "dashboard.system.catalog.offline": "오프라인",
-  "dashboard.system.catalog.pets": "펫 {count}개",
+  "dashboard.system.catalog.familiars": "Familiar {count}개",
   "dashboard.system.catalog.ready": "준비됨",
   "dashboard.system.updates": "업데이트",
   "dashboard.system.version": "버전",
@@ -111,77 +111,77 @@ export const ko: Partial<Messages> = {
   // --- Placeholder view (renderer) ---
   "placeholder.comingSoon": "출시 예정 • 다음 마이그레이션 대상",
 
-  // --- Pets filters (renderer) ---
-  "pets.filter.all": "전체",
-  "pets.filter.installed": "설치됨",
-  "pets.filter.featured": "추천",
-  "pets.filter.originals": "오리지널",
-  "pets.filter.codex": "Codex",
-  "pets.search.placeholder": "펫 검색...",
-  "pets.import": "펫 가져오기",
-  "pets.gallery": "갤러리",
+  // --- Familiars filters (renderer) ---
+  "familiars.filter.all": "전체",
+  "familiars.filter.installed": "설치됨",
+  "familiars.filter.featured": "추천",
+  "familiars.filter.originals": "오리지널",
+  "familiars.filter.codex": "Codex",
+  "familiars.search.placeholder": "Familiar 검색...",
+  "familiars.import": "Familiar 가져오기",
+  "familiars.gallery": "갤러리",
 
-  // --- Pets card badges/actions (renderer) ---
-  "pets.badge.default": "기본",
-  "pets.badge.original": "오리지널",
-  "pets.badge.featured": "추천",
-  "pets.badge.installed": "설치됨",
-  "pets.badge.codex": "Codex",
-  "pets.badge.broken": "손상됨",
-  "pets.badge.ready": "준비됨",
-  "pets.badge.originals": "오리지널",
-  "pets.action.viewPet": "펫 보기",
-  "pets.action.install": "설치",
-  "pets.action.import": "가져오기",
-  "pets.action.default": "기본",
-  "pets.action.remove": "제거",
-  "pets.action.refresh": "새로고침",
-  "pets.aria.view": "{name} 보기",
-  "pets.aria.install": "{name} 설치",
-  "pets.aria.import": "Codex에서 {name} 가져오기",
-  "pets.aria.setDefault": "{name}을(를) 기본으로 설정",
-  "pets.aria.remove": "{name} 제거",
-  "pets.busy.installing": "설치 중",
-  "pets.busy.importing": "가져오는 중",
-  "pets.busy.settingDefault": "기본 설정 중",
-  "pets.busy.removing": "제거 중",
-  "pets.busy.loadingPage": "페이지 불러오는 중",
+  // --- Familiars card badges/actions (renderer) ---
+  "familiars.badge.default": "기본",
+  "familiars.badge.original": "오리지널",
+  "familiars.badge.featured": "추천",
+  "familiars.badge.installed": "설치됨",
+  "familiars.badge.codex": "Codex",
+  "familiars.badge.broken": "손상됨",
+  "familiars.badge.ready": "준비됨",
+  "familiars.badge.originals": "오리지널",
+  "familiars.action.viewPet": "Familiar 보기",
+  "familiars.action.install": "설치",
+  "familiars.action.import": "가져오기",
+  "familiars.action.default": "기본",
+  "familiars.action.remove": "제거",
+  "familiars.action.refresh": "새로고침",
+  "familiars.aria.view": "{name} 보기",
+  "familiars.aria.install": "{name} 설치",
+  "familiars.aria.import": "Codex에서 {name} 가져오기",
+  "familiars.aria.setDefault": "{name}을(를) 기본으로 설정",
+  "familiars.aria.remove": "{name} 제거",
+  "familiars.busy.installing": "설치 중",
+  "familiars.busy.importing": "가져오는 중",
+  "familiars.busy.settingDefault": "기본 설정 중",
+  "familiars.busy.removing": "제거 중",
+  "familiars.busy.loadingPage": "페이지 불러오는 중",
 
-  // --- Pets pager (renderer) ---
-  "pets.pager.prev": "이전",
-  "pets.pager.next": "다음",
-  "pets.pager.count": "펫 {count}개",
-  "pets.pager.page": " · {pageCount}페이지 중 {page}페이지",
+  // --- Familiars pager (renderer) ---
+  "familiars.pager.prev": "이전",
+  "familiars.pager.next": "다음",
+  "familiars.pager.count": "Familiar {count}개",
+  "familiars.pager.page": " · {pageCount}페이지 중 {page}페이지",
 
-  // --- Pet detail dialog (renderer) ---
-  "pets.detail.ariaLabel": "{name} 펫 상세 정보",
-  "pets.detail.closeAria": "펫 상세 정보 닫기",
-  "pets.detail.eyebrow": "펫 상세 정보",
-  "pets.detail.previewAnimations": "애니메이션 미리보기",
-  "pets.detail.preview.idle": "대기",
-  "pets.detail.preview.thinking": "생각 중",
-  "pets.detail.preview.happy": "행복",
-  "pets.detail.preview.wave": "손 흔들기",
-  "pets.detail.installPet": "펫 설치",
-  "pets.detail.importCodexPet": "Codex 펫 가져오기",
-  "pets.detail.setDefaultPet": "기본 펫으로 설정",
-  "pets.detail.remove": "제거",
-  "pets.detail.refresh": "새로고침",
+  // --- Familiar detail dialog (renderer) ---
+  "familiars.detail.ariaLabel": "{name} Familiar 상세 정보",
+  "familiars.detail.closeAria": "Familiar 상세 정보 닫기",
+  "familiars.detail.eyebrow": "Familiar 상세 정보",
+  "familiars.detail.previewAnimations": "애니메이션 미리보기",
+  "familiars.detail.preview.idle": "대기",
+  "familiars.detail.preview.thinking": "생각 중",
+  "familiars.detail.preview.happy": "행복",
+  "familiars.detail.preview.wave": "손 흔들기",
+  "familiars.detail.installPet": "Familiar 설치",
+  "familiars.detail.importCodexPet": "Codex Familiar 가져오기",
+  "familiars.detail.setDefaultPet": "기본 Familiar으로 설정",
+  "familiars.detail.remove": "제거",
+  "familiars.detail.refresh": "새로고침",
 
-  // --- Pet detail status text (renderer) ---
-  "pets.status.broken": "이 설치된 펫은 손상되어 기본 펫으로 선택할 수 없습니다.",
-  "pets.status.defaultProtected": "기본 내장 펫입니다. 제거할 수 없도록 보호됩니다.",
-  "pets.status.default": "기본 펫입니다.",
-  "pets.status.installedCodex": "설치되어 기본 펫으로 설정할 준비가 되었습니다. ~/.codex/pets에서도 찾을 수 있습니다.",
-  "pets.status.installed": "설치되어 기본 펫으로 설정할 준비가 되었습니다.",
-  "pets.status.availableCodex": "~/.codex/pets에서 가져올 수 있습니다.",
-  "pets.status.availableCatalog": "카탈로그에서 설치할 수 있습니다.",
+  // --- Familiar detail status text (renderer) ---
+  "familiars.status.broken": "이 설치된 Familiar은 손상되어 기본 Familiar으로 선택할 수 없습니다.",
+  "familiars.status.defaultProtected": "기본 내장 Familiar입니다. 제거할 수 없도록 보호됩니다.",
+  "familiars.status.default": "기본 Familiar입니다.",
+  "familiars.status.installedCodex": "설치되어 기본 Familiar으로 설정할 준비가 되었습니다. ~/.codex/pets에서도 찾을 수 있습니다.",
+  "familiars.status.installed": "설치되어 기본 Familiar으로 설정할 준비가 되었습니다.",
+  "familiars.status.availableCodex": "~/.codex/pets에서 가져올 수 있습니다.",
+  "familiars.status.availableCatalog": "카탈로그에서 설치할 수 있습니다.",
 
-  // --- Pet labels for SpriteFrame/PetImage (renderer) ---
-  "pets.spriteLabel.thumbnail": "{name} 썸네일",
-  "pets.spriteLabel.thumb": "{name} 썸네일",
-  "pets.spriteLabel.animatedPreview": "{name} 애니메이션 미리보기",
-  "pets.spriteLabel.statePreview": "{name} {state} 미리보기",
+  // --- Familiar labels for SpriteFrame/PetImage (renderer) ---
+  "familiars.spriteLabel.thumbnail": "{name} 썸네일",
+  "familiars.spriteLabel.thumb": "{name} 썸네일",
+  "familiars.spriteLabel.animatedPreview": "{name} 애니메이션 미리보기",
+  "familiars.spriteLabel.statePreview": "{name} {state} 미리보기",
 
   // --- Settings: general (renderer) ---
   "settings.nav.general": "일반",
@@ -189,22 +189,22 @@ export const ko: Partial<Messages> = {
   "settings.nav.plugins": "플러그인 플랫폼",
   "settings.general.eyebrow": "환경",
   "settings.general.title": "일반 설정",
-  "settings.general.showOnLaunch.title": "실행 시 펫 표시",
-  "settings.general.showOnLaunch.description": "OpenPets를 트레이에 유지하되 요청하기 전까지 펫을 숨깁니다.",
+  "settings.general.showOnLaunch.title": "실행 시 Familiar 표시",
+  "settings.general.showOnLaunch.description": "FamiliarOS를 트레이에 유지하되 요청하기 전까지 Familiar을 숨깁니다.",
   "settings.general.launchAtLogin.title": "로그인 시 실행",
-  "settings.general.launchAtLogin.supported": "컴퓨터가 시작될 때 OpenPets를 자동으로 실행합니다.",
+  "settings.general.launchAtLogin.supported": "컴퓨터가 시작될 때 FamiliarOS를 자동으로 실행합니다.",
   "settings.general.launchAtLogin.unsupported": "이 플랫폼에서는 지원되지 않습니다.",
-  "settings.general.petScale.title": "펫 크기",
-  "settings.general.petScale.description": "기본 데스크톱 펫이 표시되는 크기를 조정합니다.",
-  "settings.general.resetPosition": "펫 위치 초기화",
+  "settings.general.petScale.title": "Familiar 크기",
+  "settings.general.petScale.description": "기본 데스크톱 Familiar이 표시되는 크기를 조정합니다.",
+  "settings.general.resetPosition": "Familiar 위치 초기화",
   "settings.general.systemStatus": "시스템 상태",
   "settings.general.updateAvailable": "업데이트 사용 가능",
   "settings.general.checking": "확인 중…",
   "settings.general.checkForUpdates": "업데이트 확인",
   "settings.toast.startupSaved": "시작 설정이 저장되었습니다.",
   "settings.toast.loginStartupSaved": "로그인 시작 설정이 저장되었습니다.",
-  "settings.toast.petScaleSaved": "펫 크기가 저장되었습니다.",
-  "settings.toast.positionReset": "기본 펫 위치가 초기화되었습니다.",
+  "settings.toast.petScaleSaved": "Familiar 크기가 저장되었습니다.",
+  "settings.toast.positionReset": "기본 Familiar 위치가 초기화되었습니다.",
   "settings.busy.saving": "저장 중",
   "settings.busy.resetting": "초기화 중",
   "settings.busy.opening": "여는 중",
@@ -222,7 +222,7 @@ export const ko: Partial<Messages> = {
   "settings.reactions.eyebrow": "동작",
   "settings.reactions.title": "반응 매핑",
   "settings.reactions.resetDefaults": "기본값으로 초기화",
-  "settings.reactions.description": "각 에이전트 반응에 재생할 애니메이션을 맞춤 설정하세요. 미리보기는 기본 펫을 사용합니다.",
+  "settings.reactions.description": "각 에이전트 반응에 재생할 애니메이션을 맞춤 설정하세요. 미리보기는 기본 Familiar을 사용합니다.",
   "settings.reactions.previewAria": "애니메이션: {state}",
   "settings.toast.reactionsReset": "반응 애니메이션이 초기화되었습니다.",
   "settings.toast.reactionSaved": "반응 애니메이션이 저장되었습니다.",
@@ -255,7 +255,7 @@ export const ko: Partial<Messages> = {
   "settings.reaction.waiting.label": "기다리는 중",
   "settings.reaction.waiting.description": "에이전트가 차단되었거나 권한을 기다리는 중입니다.",
   "settings.reaction.waving.label": "손 흔들기",
-  "settings.reaction.waving.description": "펫이 인사하거나 주의를 끕니다.",
+  "settings.reaction.waving.description": "Familiar이 인사하거나 주의를 끕니다.",
   "settings.reaction.success.label": "성공",
   "settings.reaction.success.description": "작업이 성공적으로 완료되었습니다.",
   "settings.reaction.error.label": "오류",
@@ -272,13 +272,13 @@ export const ko: Partial<Messages> = {
   "settings.ai.description": "Model, endpoint, and system instructions used by the built-in floating chat.",
   "settings.tts.eyebrow": "Voice",
   "settings.tts.title": "Text-to-Speech",
-  "settings.tts.description": "Voice provider and controls for the pet and floating chat.",
+  "settings.tts.description": "Voice provider and controls for the familiar and floating chat.",
   "settings.tts.placeholder": "TTS provider settings will appear here in the next build step.",
   "settings.plugins.audio.title": "플러그인 소리 재생 허용",
   "settings.plugins.audio.description": "플러그인 알림음, 경고음, 번들 사운드를 허용합니다.",
   "settings.plugins.voice.title": "플러그인 음성 말하기 허용",
   "settings.plugins.voice.description": "시스템 음성을 통한 텍스트 음성 변환을 허용합니다.",
-  "settings.plugins.dynamicSpeech.title": "AI 생성 펫 말하기 허용",
+  "settings.plugins.dynamicSpeech.title": "AI 생성 Familiar 말하기 허용",
   "settings.plugins.dynamicSpeech.description": "민감: 승인된 플러그인이 모델 생성 말풍선을 표시할 수 있도록 합니다.",
   "settings.plugins.microphone.title": "마이크 허용 (푸시 투 토크)",
   "settings.plugins.microphone.description": "민감: 승인된 플러그인이 일회성 음성 입력을 캡처할 수 있도록 합니다.",
@@ -401,22 +401,22 @@ export const ko: Partial<Messages> = {
   "plugins.busy.uninstalling": "제거 중",
 
   // --- Plugin permission labels (renderer) ---
-  "plugins.permission.pet:speak": "말하기",
-  "plugins.permission.pet:reaction": "반응",
-  "plugins.permission.pet:move": "이동",
+  "plugins.permission.familiar:speak": "말하기",
+  "plugins.permission.familiar:reaction": "반응",
+  "plugins.permission.familiar:move": "이동",
   "plugins.permission.timer": "타이머",
   "plugins.permission.schedule": "일정",
   "plugins.permission.storage": "저장소",
   "plugins.permission.status": "상태",
   "plugins.permission.commands": "명령",
   "plugins.permission.network": "네트워크",
-  "plugins.permission.pet:interact": "말풍선 버튼",
-  "plugins.permission.pet:pin": "고정 말풍선",
-  "plugins.permission.pet:animate": "맞춤 애니메이션",
-  "plugins.permission.pet:speak:dynamic": "AI 말하기",
-  "plugins.permission.pet:drop": "드래그 앤 드롭",
-  "plugins.permission.pets:read": "펫 읽기",
-  "plugins.permission.pets:manage": "펫 관리",
+  "plugins.permission.familiar:interact": "말풍선 버튼",
+  "plugins.permission.familiar:pin": "고정 말풍선",
+  "plugins.permission.familiar:animate": "맞춤 애니메이션",
+  "plugins.permission.familiar:speak:dynamic": "AI 말하기",
+  "plugins.permission.familiar:drop": "드래그 앤 드롭",
+  "plugins.permission.familiars:read": "Familiar 읽기",
+  "plugins.permission.familiars:manage": "Familiar 관리",
   "plugins.permission.audio": "소리",
   "plugins.permission.events": "이벤트",
   "plugins.permission.ui:toast": "토스트",
@@ -440,14 +440,14 @@ export const ko: Partial<Messages> = {
   "integrations.commandMode.local": "로컬 개발",
   "integrations.loading": "연동을 불러오는 중…",
   "integrations.claude.name": "Claude Code",
-  "integrations.claude.description": "Claude Code를 OpenPets 동반자에 연결하세요.",
+  "integrations.claude.description": "Claude Code를 FamiliarOS 동반자에 연결하세요.",
   "integrations.opencode.name": "OpenCode",
-  "integrations.opencode.description": "OpenCode를 OpenPets 동반자에 전역으로 연결하세요.",
+  "integrations.opencode.description": "OpenCode를 FamiliarOS 동반자에 전역으로 연결하세요.",
   "integrations.cursor.name": "Cursor",
-  "integrations.cursor.description": "전역 MCP 구성을 통해 Cursor를 OpenPets 동반자에 연결하세요.",
+  "integrations.cursor.description": "전역 MCP 구성을 통해 Cursor를 FamiliarOS 동반자에 연결하세요.",
   "integrations.pi.name": "Pi",
   "integrations.pi.status": "수동",
-  "integrations.pi.description": "OpenPets Pi 확장 패키지를 통해 Pi 코딩 에이전트 활동을 연결하세요.",
+  "integrations.pi.description": "FamiliarOS Pi 확장 패키지를 통해 Pi 코딩 에이전트 활동을 연결하세요.",
   "integrations.soon.vscode": "VS Code",
   "integrations.soon.windsurf": "Windsurf",
   "integrations.soon.zed": "Zed",
@@ -463,13 +463,13 @@ export const ko: Partial<Messages> = {
   "integrations.commandSource": "명령 소스",
   "integrations.cliMode": "CLI 모드",
   "integrations.localUnavailable": " 사용 불가",
-  "integrations.commandModeHelp": "일반 설정에는 게시된 패키지를, 데스크톱 앱 빌드에는 번들을, OpenPets 개발 중에는 로컬을 사용하세요.",
+  "integrations.commandModeHelp": "일반 설정에는 게시된 패키지를, 데스크톱 앱 빌드에는 번들을, FamiliarOS 개발 중에는 로컬을 사용하세요.",
   "integrations.connection": "연결",
   "integrations.statusRouting": "상태 및 라우팅",
   "integrations.globalSetup": "전역 설정",
   "integrations.globalMcp": "전역 MCP",
-  "integrations.petRouting": "펫 라우팅",
-  "integrations.defaultPet": "기본 펫",
+  "integrations.petRouting": "Familiar 라우팅",
+  "integrations.defaultPet": "기본 Familiar",
   "integrations.configuration": "구성",
   "integrations.commandPaths": "명령 경로",
   "integrations.claudeCommand": "Claude 명령",
@@ -497,12 +497,12 @@ export const ko: Partial<Messages> = {
   "integrations.rulesPreview": "규칙 미리보기",
   "integrations.pi.manualSetup": "수동 설정",
   "integrations.pi.extension": "Pi 확장",
-  "integrations.pi.intro": "Pi에서 OpenPets Pi 확장을 설치한 다음 Pi 세션 안에서 슬래시 명령을 사용하세요.",
+  "integrations.pi.intro": "Pi에서 FamiliarOS Pi 확장을 설치한 다음 Pi 세션 안에서 슬래시 명령을 사용하세요.",
   "integrations.pi.globalInstall": "전역 설치",
   "integrations.pi.projectInstall": "프로젝트 설치",
   "integrations.pi.remove": "제거",
   "integrations.pi.slashCommands": "슬래시 명령",
-  "integrations.pi.outro": "모든 Pi 워크스페이스에는 전역 설치를, 현재 프로젝트에서만 OpenPets를 사용하려면 프로젝트 설치를 사용하세요.",
+  "integrations.pi.outro": "모든 Pi 워크스페이스에는 전역 설치를, 현재 프로젝트에서만 FamiliarOS를 사용하려면 프로젝트 설치를 사용하세요.",
   "integrations.toast.pathSaved": "경로가 저장되었습니다.",
   "integrations.busy.installing": "설치 중",
   "integrations.busy.replacing": "교체 중",
@@ -517,21 +517,21 @@ export const ko: Partial<Messages> = {
   "integrations.mcpToolServers.noTools": "None active",
   "integrations.mcpToolServers.builtInChat": "Built-in Chat",
   "integrations.mcpToolServers.saved": "Saved {count} tool server(s).",
-  "integrations.openpetsMcpServer.name": "OpenPets MCP Server",
-  "integrations.openpetsMcpServer.description": "External-agent bridge that exposes your pet to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
-  "integrations.openpetsMcpServer.commandModeHelp": "Choose how the OpenPets MCP server is launched for external hosts.",
-  "integrations.openpetsMcpServer.testServer": "Test Server",
-  "integrations.openpetsMcpServer.testBusy": "Testing server…",
-  "integrations.openpetsMcpServer.testOk": "Server responded: {output}",
-  "integrations.openpetsMcpServer.testError": "Server test failed: {error}",
-  "integrations.openpetsMcpServer.copyMcpJson": "Copy MCP JSON",
-  "integrations.openpetsMcpServer.status": "Ready",
+  "integrations.familiarosMcpServer.name": "FamiliarOS MCP Server",
+  "integrations.familiarosMcpServer.description": "External-agent bridge that exposes your familiar to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
+  "integrations.familiarosMcpServer.commandModeHelp": "Choose how the FamiliarOS MCP server is launched for external hosts.",
+  "integrations.familiarosMcpServer.testServer": "Test Server",
+  "integrations.familiarosMcpServer.testBusy": "Testing server…",
+  "integrations.familiarosMcpServer.testOk": "Server responded: {output}",
+  "integrations.familiarosMcpServer.testError": "Server test failed: {error}",
+  "integrations.familiarosMcpServer.copyMcpJson": "Copy MCP JSON",
+  "integrations.familiarosMcpServer.status": "Ready",
   "integrations.curatedToolkit.name": "Curated MCP Toolkit",
   "integrations.curatedToolkit.description": "Starter stack for filesystem, Git, browser use, memory, databases, Docker, and terminal-oriented MCP lanes.",
-  "integrations.linkToCentralPanel": "Configure in the OpenPets MCP Server panel above.",
+  "integrations.linkToCentralPanel": "Configure in the FamiliarOS MCP Server panel above.",
 
   // --- Settings: Language section (renderer) ---
   "settings.language.title": "언어",
-  "settings.language.description": "OpenPets 메뉴와 창의 표시 언어입니다.",
+  "settings.language.description": "FamiliarOS 메뉴와 창의 표시 언어입니다.",
   "settings.language.system": "시스템 기본값",
 };
diff --git a/apps/desktop/src/i18n/locales/pt-BR.ts b/apps/desktop/src/i18n/locales/pt-BR.ts
index 7dfa0274..ab5ee22d 100644
--- a/apps/desktop/src/i18n/locales/pt-BR.ts
+++ b/apps/desktop/src/i18n/locales/pt-BR.ts
@@ -4,38 +4,38 @@ import type { Messages } from "../catalog.js";
 export const ptBR: Partial<Messages> = {
   // --- Tray menu (main process, src/tray.ts) ---
   "tray.updateAvailable": "Atualização disponível: {version}...",
-  "tray.defaultPet": "Pet padrão: {name}",
-  "tray.toggleDefaultPet.show": "Mostrar pet padrão",
-  "tray.toggleDefaultPet.hide": "Ocultar pet padrão",
-  "tray.pauseAllPets": "Pausar todos os pets",
-  "tray.resumeAllPets": "Retomar todos os pets",
-  "tray.managePets": "Gerenciar pets...",
+  "tray.defaultPet": "Familiar padrão: {name}",
+  "tray.toggleDefaultPet.show": "Mostrar familiar padrão",
+  "tray.toggleDefaultPet.hide": "Ocultar familiar padrão",
+  "tray.pauseAllPets": "Pausar todos os Familiares",
+  "tray.resumeAllPets": "Retomar todos os Familiares",
+  "tray.managePets": "Gerenciar Familiares...",
   "tray.controlCenter": "Central de controle...",
   "tray.website": "Site...",
   "tray.integrations": "Integrações...",
   "tray.plugins": "Plugins...",
   "tray.settings": "Configurações...",
   "tray.openLogsFolder": "Abrir pasta de logs...",
-  "tray.quit": "Sair do OpenPets",
+  "tray.quit": "Sair do FamiliarOS",
 
   // --- Shared ---
   "common.latest": "mais recente",
-  "common.builtInPet": "Pet integrado",
+  "common.builtInPet": "Familiar integrado",
   "common.cancel": "Cancelar",
 
-  // --- Pet window (main process, src/pet-window.ts) ---
-  "pet.paused": "Pausado",
-  "pet.status.thinking": "Pensando",
-  "pet.status.working": "Trabalhando",
-  "pet.status.editing": "Editando",
-  "pet.status.testing": "Testando",
-  "pet.status.waiting": "Aguardando",
-  "pet.status.done": "Concluído",
-  "pet.status.oops": "Ops",
-  "pet.status.hi": "Oi",
-  "pet.menu.hidePet": "Ocultar pet",
-  "pet.menu.closePet": "Fechar pet",
-  "pet.menu.openControlCenter": "Abrir Central de controle",
+  // --- Familiar window (main process, src/familiar-window.ts) ---
+  "familiar.paused": "Pausado",
+  "familiar.status.thinking": "Pensando",
+  "familiar.status.working": "Trabalhando",
+  "familiar.status.editing": "Editando",
+  "familiar.status.testing": "Testando",
+  "familiar.status.waiting": "Aguardando",
+  "familiar.status.done": "Concluído",
+  "familiar.status.oops": "Ops",
+  "familiar.status.hi": "Oi",
+  "familiar.menu.hidePet": "Ocultar familiar",
+  "familiar.menu.closePet": "Fechar familiar",
+  "familiar.menu.openControlCenter": "Abrir Central de controle",
 
   // --- Common (renderer, shared across views) ---
   "common.retry": "Tentar novamente",
@@ -45,7 +45,7 @@ export const ptBR: Partial<Messages> = {
 
   // --- Navigation tabs (renderer) ---
   "nav.dashboard": "Painel",
-  "nav.pets": "Pets",
+  "nav.familiars": "Familiars",
   "nav.settings": "Configurações",
   "nav.plugins": "Plugins",
   "nav.integrations": "Integrações",
@@ -53,8 +53,8 @@ export const ptBR: Partial<Messages> = {
   // --- Route metadata (renderer hero header) ---
   "route.dashboard.title": "Painel",
   "route.dashboard.description": "Visão geral dos seus companheiros ativos, status e métricas do sistema.",
-  "route.pets.title": "Pets",
-  "route.pets.description": "Instale, importe, visualize e escolha o seu companheiro de desktop padrão.",
+  "route.familiars.title": "Familiars",
+  "route.familiars.description": "Instale, importe, visualize e escolha o seu companheiro de desktop padrão.",
   "route.settings.title": "Configurações",
   "route.settings.description": "Configure comportamentos de inicialização, preferências de escala e ajustes de animação.",
   "route.plugins.title": "Plugins",
@@ -64,13 +64,13 @@ export const ptBR: Partial<Messages> = {
 
   // --- App shell (renderer) ---
   "app.controlCenter": "Central de controle",
-  "app.logo.alt": "OpenPets",
+  "app.logo.alt": "FamiliarOS",
 
   // --- Dashboard (renderer) ---
   "dashboard.loading": "Coletando métricas dos companheiros...",
   "dashboard.hero.eyebrow": "Companheiro principal",
   "dashboard.hero.desc": "Pronto para a sua próxima sessão de programação.",
-  "dashboard.hero.changePet": "Trocar pet",
+  "dashboard.hero.changePet": "Trocar familiar",
   "dashboard.lastActive.none": "Nenhuma atividade ainda",
   "dashboard.update.available": "Atualização disponível",
   "dashboard.update.error": "Falha na verificação",
@@ -82,7 +82,7 @@ export const ptBR: Partial<Messages> = {
   "dashboard.stat.reactions": "Reações",
   "dashboard.stat.reactions.footer": "Total de animações acionadas",
   "dashboard.stat.topCompanion": "Companheiro favorito",
-  "dashboard.stat.topCompanion.footer": "Pet mais ativo recentemente",
+  "dashboard.stat.topCompanion.footer": "Familiar mais ativo recentemente",
   "dashboard.activity.title": "Visão geral da atividade",
   "dashboard.activity.topReactions": "Principais reações",
   "dashboard.activity.noReactions": "Nenhuma reação registrada ainda. Comece a programar!",
@@ -93,17 +93,17 @@ export const ptBR: Partial<Messages> = {
   "dashboard.reactionMix.reactions": "reações",
   "dashboard.reactionMix.empty": "Nenhum mix de reações ainda.",
   "dashboard.companions.title": "Principais companheiros",
-  "dashboard.companions.subtitle": "Pets mais ativos",
+  "dashboard.companions.subtitle": "Familiars mais ativos",
   "dashboard.companions.empty": "Nenhuma atividade de companheiro ainda.",
   "dashboard.lastActive.label": "Última atividade: ",
   "dashboard.system.title": "Saúde do sistema",
-  "dashboard.system.pets": "Pets",
-  "dashboard.system.pets.value": "{count} instalados",
+  "dashboard.system.familiars": "Familiars",
+  "dashboard.system.familiars.value": "{count} instalados",
   "dashboard.system.plugins": "Plugins",
   "dashboard.system.plugins.enabled": "{count} ativados",
   "dashboard.system.catalog": "Catálogo",
   "dashboard.system.catalog.offline": "Offline",
-  "dashboard.system.catalog.pets": "{count} pets",
+  "dashboard.system.catalog.familiars": "{count} Familiares",
   "dashboard.system.catalog.ready": "Pronto",
   "dashboard.system.updates": "Atualizações",
   "dashboard.system.version": "Versão",
@@ -111,77 +111,77 @@ export const ptBR: Partial<Messages> = {
   // --- Placeholder view (renderer) ---
   "placeholder.comingSoon": "Em breve • Próximo alvo de migração",
 
-  // --- Pets filters (renderer) ---
-  "pets.filter.all": "Todos",
-  "pets.filter.installed": "Instalados",
-  "pets.filter.featured": "Destaques",
-  "pets.filter.originals": "Originais",
-  "pets.filter.codex": "Codex",
-  "pets.search.placeholder": "Buscar pets...",
-  "pets.import": "Importar pet",
-  "pets.gallery": "Galeria",
+  // --- Familiars filters (renderer) ---
+  "familiars.filter.all": "Todos",
+  "familiars.filter.installed": "Instalados",
+  "familiars.filter.featured": "Destaques",
+  "familiars.filter.originals": "Originais",
+  "familiars.filter.codex": "Codex",
+  "familiars.search.placeholder": "Buscar Familiares...",
+  "familiars.import": "Importar familiar",
+  "familiars.gallery": "Galeria",
 
-  // --- Pets card badges/actions (renderer) ---
-  "pets.badge.default": "Padrão",
-  "pets.badge.original": "Original",
-  "pets.badge.featured": "Destaque",
-  "pets.badge.installed": "Instalado",
-  "pets.badge.codex": "Codex",
-  "pets.badge.broken": "Com defeito",
-  "pets.badge.ready": "Pronto",
-  "pets.badge.originals": "Originais",
-  "pets.action.viewPet": "Ver pet",
-  "pets.action.install": "Instalar",
-  "pets.action.import": "Importar",
-  "pets.action.default": "Padrão",
-  "pets.action.remove": "Remover",
-  "pets.action.refresh": "Atualizar",
-  "pets.aria.view": "Ver {name}",
-  "pets.aria.install": "Instalar {name}",
-  "pets.aria.import": "Importar {name} do Codex",
-  "pets.aria.setDefault": "Definir {name} como padrão",
-  "pets.aria.remove": "Remover {name}",
-  "pets.busy.installing": "Instalando",
-  "pets.busy.importing": "Importando",
-  "pets.busy.settingDefault": "Definindo padrão",
-  "pets.busy.removing": "Removendo",
-  "pets.busy.loadingPage": "Carregando página",
+  // --- Familiars card badges/actions (renderer) ---
+  "familiars.badge.default": "Padrão",
+  "familiars.badge.original": "Original",
+  "familiars.badge.featured": "Destaque",
+  "familiars.badge.installed": "Instalado",
+  "familiars.badge.codex": "Codex",
+  "familiars.badge.broken": "Com defeito",
+  "familiars.badge.ready": "Pronto",
+  "familiars.badge.originals": "Originais",
+  "familiars.action.viewPet": "Ver familiar",
+  "familiars.action.install": "Instalar",
+  "familiars.action.import": "Importar",
+  "familiars.action.default": "Padrão",
+  "familiars.action.remove": "Remover",
+  "familiars.action.refresh": "Atualizar",
+  "familiars.aria.view": "Ver {name}",
+  "familiars.aria.install": "Instalar {name}",
+  "familiars.aria.import": "Importar {name} do Codex",
+  "familiars.aria.setDefault": "Definir {name} como padrão",
+  "familiars.aria.remove": "Remover {name}",
+  "familiars.busy.installing": "Instalando",
+  "familiars.busy.importing": "Importando",
+  "familiars.busy.settingDefault": "Definindo padrão",
+  "familiars.busy.removing": "Removendo",
+  "familiars.busy.loadingPage": "Carregando página",
 
-  // --- Pets pager (renderer) ---
-  "pets.pager.prev": "Anterior",
-  "pets.pager.next": "Próxima",
-  "pets.pager.count": "{count} pets",
-  "pets.pager.page": " · Página {page} de {pageCount}",
+  // --- Familiars pager (renderer) ---
+  "familiars.pager.prev": "Anterior",
+  "familiars.pager.next": "Próxima",
+  "familiars.pager.count": "{count} Familiares",
+  "familiars.pager.page": " · Página {page} de {pageCount}",
 
-  // --- Pet detail dialog (renderer) ---
-  "pets.detail.ariaLabel": "Detalhes do pet {name}",
-  "pets.detail.closeAria": "Fechar detalhes do pet",
-  "pets.detail.eyebrow": "Detalhe do pet",
-  "pets.detail.previewAnimations": "Pré-visualizar animações",
-  "pets.detail.preview.idle": "Ocioso",
-  "pets.detail.preview.thinking": "Pensando",
-  "pets.detail.preview.happy": "Feliz",
-  "pets.detail.preview.wave": "Aceno",
-  "pets.detail.installPet": "Instalar pet",
-  "pets.detail.importCodexPet": "Importar pet do Codex",
-  "pets.detail.setDefaultPet": "Definir pet padrão",
-  "pets.detail.remove": "Remover",
-  "pets.detail.refresh": "Atualizar",
+  // --- Familiar detail dialog (renderer) ---
+  "familiars.detail.ariaLabel": "Detalhes do familiar {name}",
+  "familiars.detail.closeAria": "Fechar detalhes do familiar",
+  "familiars.detail.eyebrow": "Detalhe do familiar",
+  "familiars.detail.previewAnimations": "Pré-visualizar animações",
+  "familiars.detail.preview.idle": "Ocioso",
+  "familiars.detail.preview.thinking": "Pensando",
+  "familiars.detail.preview.happy": "Feliz",
+  "familiars.detail.preview.wave": "Aceno",
+  "familiars.detail.installPet": "Instalar familiar",
+  "familiars.detail.importCodexPet": "Importar familiar do Codex",
+  "familiars.detail.setDefaultPet": "Definir familiar padrão",
+  "familiars.detail.remove": "Remover",
+  "familiars.detail.refresh": "Atualizar",
 
-  // --- Pet detail status text (renderer) ---
-  "pets.status.broken": "Este pet instalado está com defeito e não pode ser definido como padrão.",
-  "pets.status.defaultProtected": "Pet integrado padrão. Protegido contra remoção.",
-  "pets.status.default": "Pet padrão.",
-  "pets.status.installedCodex": "Instalado e pronto para se tornar o seu pet padrão. Também encontrado em ~/.codex/pets.",
-  "pets.status.installed": "Instalado e pronto para se tornar o seu pet padrão.",
-  "pets.status.availableCodex": "Disponível para importar de ~/.codex/pets.",
-  "pets.status.availableCatalog": "Disponível para instalar a partir do catálogo.",
+  // --- Familiar detail status text (renderer) ---
+  "familiars.status.broken": "Este familiar instalado está com defeito e não pode ser definido como padrão.",
+  "familiars.status.defaultProtected": "Familiar integrado padrão. Protegido contra remoção.",
+  "familiars.status.default": "Familiar padrão.",
+  "familiars.status.installedCodex": "Instalado e pronto para se tornar o seu familiar padrão. Também encontrado em ~/.codex/Familiares.",
+  "familiars.status.installed": "Instalado e pronto para se tornar o seu familiar padrão.",
+  "familiars.status.availableCodex": "Disponível para importar de ~/.codex/Familiares.",
+  "familiars.status.availableCatalog": "Disponível para instalar a partir do catálogo.",
 
-  // --- Pet labels for SpriteFrame/PetImage (renderer) ---
-  "pets.spriteLabel.thumbnail": "Miniatura de {name}",
-  "pets.spriteLabel.thumb": "Miniatura de {name}",
-  "pets.spriteLabel.animatedPreview": "Pré-visualização animada de {name}",
-  "pets.spriteLabel.statePreview": "Pré-visualização de {name} {state}",
+  // --- Familiar labels for SpriteFrame/PetImage (renderer) ---
+  "familiars.spriteLabel.thumbnail": "Miniatura de {name}",
+  "familiars.spriteLabel.thumb": "Miniatura de {name}",
+  "familiars.spriteLabel.animatedPreview": "Pré-visualização animada de {name}",
+  "familiars.spriteLabel.statePreview": "Pré-visualização de {name} {state}",
 
   // --- Settings: general (renderer) ---
   "settings.nav.general": "Geral",
@@ -189,22 +189,22 @@ export const ptBR: Partial<Messages> = {
   "settings.nav.plugins": "Plataforma de plugins",
   "settings.general.eyebrow": "Ambiente",
   "settings.general.title": "Configurações gerais",
-  "settings.general.showOnLaunch.title": "Mostrar pet ao iniciar",
-  "settings.general.showOnLaunch.description": "Mantenha o OpenPets na bandeja, mas oculte o pet até que seja solicitado.",
+  "settings.general.showOnLaunch.title": "Mostrar familiar ao iniciar",
+  "settings.general.showOnLaunch.description": "Mantenha o FamiliarOS na bandeja, mas oculte o familiar até que seja solicitado.",
   "settings.general.launchAtLogin.title": "Iniciar ao fazer login",
-  "settings.general.launchAtLogin.supported": "Inicie o OpenPets automaticamente quando o seu computador ligar.",
+  "settings.general.launchAtLogin.supported": "Inicie o FamiliarOS automaticamente quando o seu computador ligar.",
   "settings.general.launchAtLogin.unsupported": "Não compatível com esta plataforma.",
-  "settings.general.petScale.title": "Escala do pet",
-  "settings.general.petScale.description": "Ajuste o tamanho com que o pet padrão aparece no desktop.",
-  "settings.general.resetPosition": "Redefinir posição do pet",
+  "settings.general.petScale.title": "Escala do familiar",
+  "settings.general.petScale.description": "Ajuste o tamanho com que o familiar padrão aparece no desktop.",
+  "settings.general.resetPosition": "Redefinir posição do familiar",
   "settings.general.systemStatus": "Status do sistema",
   "settings.general.updateAvailable": "Atualização disponível",
   "settings.general.checking": "Verificando…",
   "settings.general.checkForUpdates": "Verificar atualizações",
   "settings.toast.startupSaved": "Preferência de inicialização salva.",
   "settings.toast.loginStartupSaved": "Preferência de inicialização no login salva.",
-  "settings.toast.petScaleSaved": "Escala do pet salva.",
-  "settings.toast.positionReset": "Posição do pet padrão redefinida.",
+  "settings.toast.petScaleSaved": "Escala do familiar salva.",
+  "settings.toast.positionReset": "Posição do familiar padrão redefinida.",
   "settings.busy.saving": "Salvando",
   "settings.busy.resetting": "Redefinindo",
   "settings.busy.opening": "Abrindo",
@@ -222,7 +222,7 @@ export const ptBR: Partial<Messages> = {
   "settings.reactions.eyebrow": "Comportamento",
   "settings.reactions.title": "Mapeamento de reações",
   "settings.reactions.resetDefaults": "Restaurar padrões",
-  "settings.reactions.description": "Personalize qual animação é reproduzida para cada reação do agente. As pré-visualizações usam o pet padrão.",
+  "settings.reactions.description": "Personalize qual animação é reproduzida para cada reação do agente. As pré-visualizações usam o familiar padrão.",
   "settings.reactions.previewAria": "Animação: {state}",
   "settings.toast.reactionsReset": "Animações de reação redefinidas.",
   "settings.toast.reactionSaved": "Animação de reação salva.",
@@ -255,7 +255,7 @@ export const ptBR: Partial<Messages> = {
   "settings.reaction.waiting.label": "Aguardando",
   "settings.reaction.waiting.description": "O agente está bloqueado ou aguardando permissão.",
   "settings.reaction.waving.label": "Acenando",
-  "settings.reaction.waving.description": "O pet está cumprimentando ou chamando atenção.",
+  "settings.reaction.waving.description": "O familiar está cumprimentando ou chamando atenção.",
   "settings.reaction.success.label": "Sucesso",
   "settings.reaction.success.description": "A tarefa foi concluída com sucesso.",
   "settings.reaction.error.label": "Erro",
@@ -272,13 +272,13 @@ export const ptBR: Partial<Messages> = {
   "settings.ai.description": "Model, endpoint, and system instructions used by the built-in floating chat.",
   "settings.tts.eyebrow": "Voice",
   "settings.tts.title": "Text-to-Speech",
-  "settings.tts.description": "Voice provider and controls for the pet and floating chat.",
+  "settings.tts.description": "Voice provider and controls for the familiar and floating chat.",
   "settings.tts.placeholder": "TTS provider settings will appear here in the next build step.",
   "settings.plugins.audio.title": "Plugins podem reproduzir som",
   "settings.plugins.audio.description": "Permitir sinos, alertas e sons incluídos dos plugins.",
   "settings.plugins.voice.title": "Plugins podem falar (voz)",
   "settings.plugins.voice.description": "Permitir conversão de texto em fala pela voz do sistema.",
-  "settings.plugins.dynamicSpeech.title": "Permitir fala do pet gerada por IA",
+  "settings.plugins.dynamicSpeech.title": "Permitir fala do familiar gerada por IA",
   "settings.plugins.dynamicSpeech.description": "Sensível: permite que plugins aprovados exibam balões gerados por modelo.",
   "settings.plugins.microphone.title": "Permitir microfone (apertar para falar)",
   "settings.plugins.microphone.description": "Sensível: permite que plugins aprovados capturem entrada de voz pontual.",
@@ -401,22 +401,22 @@ export const ptBR: Partial<Messages> = {
   "plugins.busy.uninstalling": "Desinstalando",
 
   // --- Plugin permission labels (renderer) ---
-  "plugins.permission.pet:speak": "Fala",
-  "plugins.permission.pet:reaction": "Reações",
-  "plugins.permission.pet:move": "Movimento",
+  "plugins.permission.familiar:speak": "Fala",
+  "plugins.permission.familiar:reaction": "Reações",
+  "plugins.permission.familiar:move": "Movimento",
   "plugins.permission.timer": "Temporizadores",
   "plugins.permission.schedule": "Agenda",
   "plugins.permission.storage": "Armazenamento",
   "plugins.permission.status": "Status",
   "plugins.permission.commands": "Comandos",
   "plugins.permission.network": "Rede",
-  "plugins.permission.pet:interact": "Botões de balão",
-  "plugins.permission.pet:pin": "Balão fixado",
-  "plugins.permission.pet:animate": "Animação personalizada",
-  "plugins.permission.pet:speak:dynamic": "Fala por IA",
-  "plugins.permission.pet:drop": "Arrastar e soltar",
-  "plugins.permission.pets:read": "Ler pets",
-  "plugins.permission.pets:manage": "Gerenciar pets",
+  "plugins.permission.familiar:interact": "Botões de balão",
+  "plugins.permission.familiar:pin": "Balão fixado",
+  "plugins.permission.familiar:animate": "Animação personalizada",
+  "plugins.permission.familiar:speak:dynamic": "Fala por IA",
+  "plugins.permission.familiar:drop": "Arrastar e soltar",
+  "plugins.permission.familiars:read": "Ler Familiares",
+  "plugins.permission.familiars:manage": "Gerenciar Familiares",
   "plugins.permission.audio": "Som",
   "plugins.permission.events": "Eventos",
   "plugins.permission.ui:toast": "Avisos",
@@ -440,14 +440,14 @@ export const ptBR: Partial<Messages> = {
   "integrations.commandMode.local": "Desenvolvimento local",
   "integrations.loading": "Carregando integrações…",
   "integrations.claude.name": "Claude Code",
-  "integrations.claude.description": "Conecte o Claude Code ao seu companheiro OpenPets.",
+  "integrations.claude.description": "Conecte o Claude Code ao seu companheiro FamiliarOS.",
   "integrations.opencode.name": "OpenCode",
-  "integrations.opencode.description": "Conecte o OpenCode globalmente ao seu companheiro OpenPets.",
+  "integrations.opencode.description": "Conecte o OpenCode globalmente ao seu companheiro FamiliarOS.",
   "integrations.cursor.name": "Cursor",
-  "integrations.cursor.description": "Conecte o Cursor ao seu companheiro OpenPets via configuração global de MCP.",
+  "integrations.cursor.description": "Conecte o Cursor ao seu companheiro FamiliarOS via configuração global de MCP.",
   "integrations.pi.name": "Pi",
   "integrations.pi.status": "Manual",
-  "integrations.pi.description": "Conecte a atividade do agente de programação Pi através do pacote de extensão Pi do OpenPets.",
+  "integrations.pi.description": "Conecte a atividade do agente de programação Pi através do pacote de extensão Pi do FamiliarOS.",
   "integrations.soon.vscode": "VS Code",
   "integrations.soon.windsurf": "Windsurf",
   "integrations.soon.zed": "Zed",
@@ -463,13 +463,13 @@ export const ptBR: Partial<Messages> = {
   "integrations.commandSource": "Origem do comando",
   "integrations.cliMode": "Modo CLI",
   "integrations.localUnavailable": " indisponível",
-  "integrations.commandModeHelp": "Use o pacote publicado para configuração normal, o incluído para o build do app de desktop, ou o local enquanto desenvolve o OpenPets.",
+  "integrations.commandModeHelp": "Use o pacote publicado para configuração normal, o incluído para o build do app de desktop, ou o local enquanto desenvolve o FamiliarOS.",
   "integrations.connection": "Conexão",
   "integrations.statusRouting": "Status e roteamento",
   "integrations.globalSetup": "Configuração global",
   "integrations.globalMcp": "MCP global",
-  "integrations.petRouting": "Roteamento de pet",
-  "integrations.defaultPet": "Pet padrão",
+  "integrations.petRouting": "Roteamento de familiar",
+  "integrations.defaultPet": "Familiar padrão",
   "integrations.configuration": "Configuração",
   "integrations.commandPaths": "Caminhos de comando",
   "integrations.claudeCommand": "Comando do Claude",
@@ -497,12 +497,12 @@ export const ptBR: Partial<Messages> = {
   "integrations.rulesPreview": "Pré-visualização das regras",
   "integrations.pi.manualSetup": "Configuração manual",
   "integrations.pi.extension": "Extensão Pi",
-  "integrations.pi.intro": "Instale a extensão Pi do OpenPets a partir do Pi e use os comandos de barra dentro de uma sessão do Pi.",
+  "integrations.pi.intro": "Instale a extensão Pi do FamiliarOS a partir do Pi e use os comandos de barra dentro de uma sessão do Pi.",
   "integrations.pi.globalInstall": "Instalação global",
   "integrations.pi.projectInstall": "Instalação no projeto",
   "integrations.pi.remove": "Remover",
   "integrations.pi.slashCommands": "Comandos de barra",
-  "integrations.pi.outro": "Use a instalação global para todos os workspaces do Pi, ou a instalação no projeto quando quiser o OpenPets apenas no projeto atual.",
+  "integrations.pi.outro": "Use a instalação global para todos os workspaces do Pi, ou a instalação no projeto quando quiser o FamiliarOS apenas no projeto atual.",
   "integrations.toast.pathSaved": "Caminho salvo.",
   "integrations.busy.installing": "Instalando",
   "integrations.busy.replacing": "Substituindo",
@@ -517,21 +517,21 @@ export const ptBR: Partial<Messages> = {
   "integrations.mcpToolServers.noTools": "None active",
   "integrations.mcpToolServers.builtInChat": "Built-in Chat",
   "integrations.mcpToolServers.saved": "Saved {count} tool server(s).",
-  "integrations.openpetsMcpServer.name": "OpenPets MCP Server",
-  "integrations.openpetsMcpServer.description": "External-agent bridge that exposes your pet to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
-  "integrations.openpetsMcpServer.commandModeHelp": "Choose how the OpenPets MCP server is launched for external hosts.",
-  "integrations.openpetsMcpServer.testServer": "Test Server",
-  "integrations.openpetsMcpServer.testBusy": "Testing server…",
-  "integrations.openpetsMcpServer.testOk": "Server responded: {output}",
-  "integrations.openpetsMcpServer.testError": "Server test failed: {error}",
-  "integrations.openpetsMcpServer.copyMcpJson": "Copy MCP JSON",
-  "integrations.openpetsMcpServer.status": "Ready",
+  "integrations.familiarosMcpServer.name": "FamiliarOS MCP Server",
+  "integrations.familiarosMcpServer.description": "External-agent bridge that exposes your familiar to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
+  "integrations.familiarosMcpServer.commandModeHelp": "Choose how the FamiliarOS MCP server is launched for external hosts.",
+  "integrations.familiarosMcpServer.testServer": "Test Server",
+  "integrations.familiarosMcpServer.testBusy": "Testing server…",
+  "integrations.familiarosMcpServer.testOk": "Server responded: {output}",
+  "integrations.familiarosMcpServer.testError": "Server test failed: {error}",
+  "integrations.familiarosMcpServer.copyMcpJson": "Copy MCP JSON",
+  "integrations.familiarosMcpServer.status": "Ready",
   "integrations.curatedToolkit.name": "Curated MCP Toolkit",
   "integrations.curatedToolkit.description": "Starter stack for filesystem, Git, browser use, memory, databases, Docker, and terminal-oriented MCP lanes.",
-  "integrations.linkToCentralPanel": "Configure in the OpenPets MCP Server panel above.",
+  "integrations.linkToCentralPanel": "Configure in the FamiliarOS MCP Server panel above.",
 
   // --- Settings: Language section (renderer) ---
   "settings.language.title": "Idioma",
-  "settings.language.description": "Idioma de exibição dos menus e janelas do OpenPets.",
+  "settings.language.description": "Idioma de exibição dos menus e janelas do FamiliarOS.",
   "settings.language.system": "Padrão do sistema",
 };
diff --git a/apps/desktop/src/i18n/locales/zh-Hans.ts b/apps/desktop/src/i18n/locales/zh-Hans.ts
index c8343916..813e3eaf 100644
--- a/apps/desktop/src/i18n/locales/zh-Hans.ts
+++ b/apps/desktop/src/i18n/locales/zh-Hans.ts
@@ -4,38 +4,38 @@ import type { Messages } from "../catalog.js";
 export const zhHans: Partial<Messages> = {
   // --- Tray menu (main process, src/tray.ts) ---
   "tray.updateAvailable": "有可用更新：{version}...",
-  "tray.defaultPet": "默认宠物：{name}",
-  "tray.toggleDefaultPet.show": "显示默认宠物",
-  "tray.toggleDefaultPet.hide": "隐藏默认宠物",
-  "tray.pauseAllPets": "暂停所有宠物",
-  "tray.resumeAllPets": "恢复所有宠物",
-  "tray.managePets": "管理宠物...",
+  "tray.defaultPet": "默认Familiar：{name}",
+  "tray.toggleDefaultPet.show": "显示默认Familiar",
+  "tray.toggleDefaultPet.hide": "隐藏默认Familiar",
+  "tray.pauseAllPets": "暂停所有Familiar",
+  "tray.resumeAllPets": "恢复所有Familiar",
+  "tray.managePets": "管理Familiar...",
   "tray.controlCenter": "控制中心...",
   "tray.website": "网站...",
   "tray.integrations": "集成...",
   "tray.plugins": "插件...",
   "tray.settings": "设置...",
   "tray.openLogsFolder": "打开日志文件夹...",
-  "tray.quit": "退出 OpenPets",
+  "tray.quit": "退出 FamiliarOS",
 
   // --- Shared ---
   "common.latest": "最新",
-  "common.builtInPet": "内置宠物",
+  "common.builtInPet": "内置Familiar",
   "common.cancel": "取消",
 
-  // --- Pet window (main process, src/pet-window.ts) ---
-  "pet.paused": "已暂停",
-  "pet.status.thinking": "思考中",
-  "pet.status.working": "工作中",
-  "pet.status.editing": "编辑中",
-  "pet.status.testing": "测试中",
-  "pet.status.waiting": "等待中",
-  "pet.status.done": "完成",
-  "pet.status.oops": "出错了",
-  "pet.status.hi": "你好",
-  "pet.menu.hidePet": "隐藏宠物",
-  "pet.menu.closePet": "关闭宠物",
-  "pet.menu.openControlCenter": "打开控制中心",
+  // --- Familiar window (main process, src/familiar-window.ts) ---
+  "familiar.paused": "已暂停",
+  "familiar.status.thinking": "思考中",
+  "familiar.status.working": "工作中",
+  "familiar.status.editing": "编辑中",
+  "familiar.status.testing": "测试中",
+  "familiar.status.waiting": "等待中",
+  "familiar.status.done": "完成",
+  "familiar.status.oops": "出错了",
+  "familiar.status.hi": "你好",
+  "familiar.menu.hidePet": "隐藏Familiar",
+  "familiar.menu.closePet": "关闭Familiar",
+  "familiar.menu.openControlCenter": "打开控制中心",
 
   // --- Common (renderer, shared across views) ---
   "common.retry": "重试",
@@ -45,7 +45,7 @@ export const zhHans: Partial<Messages> = {
 
   // --- Navigation tabs (renderer) ---
   "nav.dashboard": "仪表盘",
-  "nav.pets": "宠物",
+  "nav.familiars": "Familiar",
   "nav.settings": "设置",
   "nav.plugins": "插件",
   "nav.integrations": "集成",
@@ -53,8 +53,8 @@ export const zhHans: Partial<Messages> = {
   // --- Route metadata (renderer hero header) ---
   "route.dashboard.title": "仪表盘",
   "route.dashboard.description": "查看活跃伙伴、状态及系统指标的概览。",
-  "route.pets.title": "宠物",
-  "route.pets.description": "安装、导入、预览并选择你的默认桌面伙伴。",
+  "route.familiars.title": "Familiar",
+  "route.familiars.description": "安装、导入、预览并选择你的默认桌面伙伴。",
   "route.settings.title": "设置",
   "route.settings.description": "配置启动行为、缩放偏好和动画设置。",
   "route.plugins.title": "插件",
@@ -64,13 +64,13 @@ export const zhHans: Partial<Messages> = {
 
   // --- App shell (renderer) ---
   "app.controlCenter": "控制中心",
-  "app.logo.alt": "OpenPets",
+  "app.logo.alt": "FamiliarOS",
 
   // --- Dashboard (renderer) ---
   "dashboard.loading": "正在收集伙伴指标...",
   "dashboard.hero.eyebrow": "主要伙伴",
   "dashboard.hero.desc": "已准备好开始你的下一次编程。",
-  "dashboard.hero.changePet": "更换宠物",
+  "dashboard.hero.changePet": "更换Familiar",
   "dashboard.lastActive.none": "暂无活动",
   "dashboard.update.available": "有可用更新",
   "dashboard.update.error": "检查失败",
@@ -82,7 +82,7 @@ export const zhHans: Partial<Messages> = {
   "dashboard.stat.reactions": "反应",
   "dashboard.stat.reactions.footer": "触发的动画总数",
   "dashboard.stat.topCompanion": "最活跃伙伴",
-  "dashboard.stat.topCompanion.footer": "近期最活跃的宠物",
+  "dashboard.stat.topCompanion.footer": "近期最活跃的Familiar",
   "dashboard.activity.title": "活动概览",
   "dashboard.activity.topReactions": "热门反应",
   "dashboard.activity.noReactions": "暂无反应记录。开始编程吧！",
@@ -93,17 +93,17 @@ export const zhHans: Partial<Messages> = {
   "dashboard.reactionMix.reactions": "次反应",
   "dashboard.reactionMix.empty": "暂无反应分布。",
   "dashboard.companions.title": "最活跃伙伴",
-  "dashboard.companions.subtitle": "最活跃的宠物",
+  "dashboard.companions.subtitle": "最活跃的Familiar",
   "dashboard.companions.empty": "暂无伙伴活动。",
   "dashboard.lastActive.label": "最近活动：",
   "dashboard.system.title": "系统健康",
-  "dashboard.system.pets": "宠物",
-  "dashboard.system.pets.value": "已安装 {count} 个",
+  "dashboard.system.familiars": "Familiar",
+  "dashboard.system.familiars.value": "已安装 {count} 个",
   "dashboard.system.plugins": "插件",
   "dashboard.system.plugins.enabled": "已启用 {count} 个",
   "dashboard.system.catalog": "目录",
   "dashboard.system.catalog.offline": "离线",
-  "dashboard.system.catalog.pets": "{count} 个宠物",
+  "dashboard.system.catalog.familiars": "{count} 个Familiar",
   "dashboard.system.catalog.ready": "就绪",
   "dashboard.system.updates": "更新",
   "dashboard.system.version": "版本",
@@ -111,77 +111,77 @@ export const zhHans: Partial<Messages> = {
   // --- Placeholder view (renderer) ---
   "placeholder.comingSoon": "敬请期待 • 下一个迁移目标",
 
-  // --- Pets filters (renderer) ---
-  "pets.filter.all": "全部",
-  "pets.filter.installed": "已安装",
-  "pets.filter.featured": "精选",
-  "pets.filter.originals": "原创",
-  "pets.filter.codex": "Codex",
-  "pets.search.placeholder": "搜索宠物...",
-  "pets.import": "导入宠物",
-  "pets.gallery": "图库",
+  // --- Familiars filters (renderer) ---
+  "familiars.filter.all": "全部",
+  "familiars.filter.installed": "已安装",
+  "familiars.filter.featured": "精选",
+  "familiars.filter.originals": "原创",
+  "familiars.filter.codex": "Codex",
+  "familiars.search.placeholder": "搜索Familiar...",
+  "familiars.import": "导入Familiar",
+  "familiars.gallery": "图库",
 
-  // --- Pets card badges/actions (renderer) ---
-  "pets.badge.default": "默认",
-  "pets.badge.original": "原创",
-  "pets.badge.featured": "精选",
-  "pets.badge.installed": "已安装",
-  "pets.badge.codex": "Codex",
-  "pets.badge.broken": "已损坏",
-  "pets.badge.ready": "就绪",
-  "pets.badge.originals": "原创",
-  "pets.action.viewPet": "查看宠物",
-  "pets.action.install": "安装",
-  "pets.action.import": "导入",
-  "pets.action.default": "设为默认",
-  "pets.action.remove": "移除",
-  "pets.action.refresh": "刷新",
-  "pets.aria.view": "查看 {name}",
-  "pets.aria.install": "安装 {name}",
-  "pets.aria.import": "从 Codex 导入 {name}",
-  "pets.aria.setDefault": "将 {name} 设为默认",
-  "pets.aria.remove": "移除 {name}",
-  "pets.busy.installing": "安装中",
-  "pets.busy.importing": "导入中",
-  "pets.busy.settingDefault": "设置默认中",
-  "pets.busy.removing": "移除中",
-  "pets.busy.loadingPage": "加载页面中",
+  // --- Familiars card badges/actions (renderer) ---
+  "familiars.badge.default": "默认",
+  "familiars.badge.original": "原创",
+  "familiars.badge.featured": "精选",
+  "familiars.badge.installed": "已安装",
+  "familiars.badge.codex": "Codex",
+  "familiars.badge.broken": "已损坏",
+  "familiars.badge.ready": "就绪",
+  "familiars.badge.originals": "原创",
+  "familiars.action.viewPet": "查看Familiar",
+  "familiars.action.install": "安装",
+  "familiars.action.import": "导入",
+  "familiars.action.default": "设为默认",
+  "familiars.action.remove": "移除",
+  "familiars.action.refresh": "刷新",
+  "familiars.aria.view": "查看 {name}",
+  "familiars.aria.install": "安装 {name}",
+  "familiars.aria.import": "从 Codex 导入 {name}",
+  "familiars.aria.setDefault": "将 {name} 设为默认",
+  "familiars.aria.remove": "移除 {name}",
+  "familiars.busy.installing": "安装中",
+  "familiars.busy.importing": "导入中",
+  "familiars.busy.settingDefault": "设置默认中",
+  "familiars.busy.removing": "移除中",
+  "familiars.busy.loadingPage": "加载页面中",
 
-  // --- Pets pager (renderer) ---
-  "pets.pager.prev": "上一页",
-  "pets.pager.next": "下一页",
-  "pets.pager.count": "{count} 个宠物",
-  "pets.pager.page": " · 第 {page} / {pageCount} 页",
+  // --- Familiars pager (renderer) ---
+  "familiars.pager.prev": "上一页",
+  "familiars.pager.next": "下一页",
+  "familiars.pager.count": "{count} 个Familiar",
+  "familiars.pager.page": " · 第 {page} / {pageCount} 页",
 
-  // --- Pet detail dialog (renderer) ---
-  "pets.detail.ariaLabel": "{name} 宠物详情",
-  "pets.detail.closeAria": "关闭宠物详情",
-  "pets.detail.eyebrow": "宠物详情",
-  "pets.detail.previewAnimations": "预览动画",
-  "pets.detail.preview.idle": "待机",
-  "pets.detail.preview.thinking": "思考",
-  "pets.detail.preview.happy": "开心",
-  "pets.detail.preview.wave": "挥手",
-  "pets.detail.installPet": "安装宠物",
-  "pets.detail.importCodexPet": "导入 Codex 宠物",
-  "pets.detail.setDefaultPet": "设为默认宠物",
-  "pets.detail.remove": "移除",
-  "pets.detail.refresh": "刷新",
+  // --- Familiar detail dialog (renderer) ---
+  "familiars.detail.ariaLabel": "{name} Familiar详情",
+  "familiars.detail.closeAria": "关闭Familiar详情",
+  "familiars.detail.eyebrow": "Familiar详情",
+  "familiars.detail.previewAnimations": "预览动画",
+  "familiars.detail.preview.idle": "待机",
+  "familiars.detail.preview.thinking": "思考",
+  "familiars.detail.preview.happy": "开心",
+  "familiars.detail.preview.wave": "挥手",
+  "familiars.detail.installPet": "安装Familiar",
+  "familiars.detail.importCodexPet": "导入 Codex Familiar",
+  "familiars.detail.setDefaultPet": "设为默认Familiar",
+  "familiars.detail.remove": "移除",
+  "familiars.detail.refresh": "刷新",
 
-  // --- Pet detail status text (renderer) ---
-  "pets.status.broken": "此已安装的宠物已损坏，无法设为默认。",
-  "pets.status.defaultProtected": "默认内置宠物，受保护无法移除。",
-  "pets.status.default": "默认宠物。",
-  "pets.status.installedCodex": "已安装，可设为默认宠物。也可在 ~/.codex/pets 中找到。",
-  "pets.status.installed": "已安装，可设为默认宠物。",
-  "pets.status.availableCodex": "可从 ~/.codex/pets 导入。",
-  "pets.status.availableCatalog": "可从目录安装。",
+  // --- Familiar detail status text (renderer) ---
+  "familiars.status.broken": "此已安装的Familiar已损坏，无法设为默认。",
+  "familiars.status.defaultProtected": "默认内置Familiar，受保护无法移除。",
+  "familiars.status.default": "默认Familiar。",
+  "familiars.status.installedCodex": "已安装，可设为默认Familiar。也可在 ~/.codex/familiars 中找到。",
+  "familiars.status.installed": "已安装，可设为默认Familiar。",
+  "familiars.status.availableCodex": "可从 ~/.codex/familiars 导入。",
+  "familiars.status.availableCatalog": "可从目录安装。",
 
-  // --- Pet labels for SpriteFrame/PetImage (renderer) ---
-  "pets.spriteLabel.thumbnail": "{name} 缩略图",
-  "pets.spriteLabel.thumb": "{name} 缩略图",
-  "pets.spriteLabel.animatedPreview": "{name} 动画预览",
-  "pets.spriteLabel.statePreview": "{name} {state} 预览",
+  // --- Familiar labels for SpriteFrame/PetImage (renderer) ---
+  "familiars.spriteLabel.thumbnail": "{name} 缩略图",
+  "familiars.spriteLabel.thumb": "{name} 缩略图",
+  "familiars.spriteLabel.animatedPreview": "{name} 动画预览",
+  "familiars.spriteLabel.statePreview": "{name} {state} 预览",
 
   // --- Settings: general (renderer) ---
   "settings.nav.general": "常规",
@@ -189,22 +189,22 @@ export const zhHans: Partial<Messages> = {
   "settings.nav.plugins": "插件平台",
   "settings.general.eyebrow": "环境",
   "settings.general.title": "常规设置",
-  "settings.general.showOnLaunch.title": "启动时显示宠物",
-  "settings.general.showOnLaunch.description": "将 OpenPets 保留在托盘中，但在需要前隐藏宠物。",
+  "settings.general.showOnLaunch.title": "启动时显示Familiar",
+  "settings.general.showOnLaunch.description": "将 FamiliarOS 保留在托盘中，但在需要前隐藏Familiar。",
   "settings.general.launchAtLogin.title": "开机自启动",
-  "settings.general.launchAtLogin.supported": "在电脑启动时自动启动 OpenPets。",
+  "settings.general.launchAtLogin.supported": "在电脑启动时自动启动 FamiliarOS。",
   "settings.general.launchAtLogin.unsupported": "此平台不支持。",
-  "settings.general.petScale.title": "宠物大小",
-  "settings.general.petScale.description": "调整默认桌面宠物的显示大小。",
-  "settings.general.resetPosition": "重置宠物位置",
+  "settings.general.petScale.title": "Familiar大小",
+  "settings.general.petScale.description": "调整默认桌面Familiar的显示大小。",
+  "settings.general.resetPosition": "重置Familiar位置",
   "settings.general.systemStatus": "系统状态",
   "settings.general.updateAvailable": "有可用更新",
   "settings.general.checking": "检查中…",
   "settings.general.checkForUpdates": "检查更新",
   "settings.toast.startupSaved": "启动偏好已保存。",
   "settings.toast.loginStartupSaved": "登录启动偏好已保存。",
-  "settings.toast.petScaleSaved": "宠物大小已保存。",
-  "settings.toast.positionReset": "默认宠物位置已重置。",
+  "settings.toast.petScaleSaved": "Familiar大小已保存。",
+  "settings.toast.positionReset": "默认Familiar位置已重置。",
   "settings.busy.saving": "保存中",
   "settings.busy.resetting": "重置中",
   "settings.busy.opening": "打开中",
@@ -222,7 +222,7 @@ export const zhHans: Partial<Messages> = {
   "settings.reactions.eyebrow": "行为",
   "settings.reactions.title": "反应映射",
   "settings.reactions.resetDefaults": "恢复默认",
-  "settings.reactions.description": "自定义每个代理反应所播放的动画。预览使用默认宠物。",
+  "settings.reactions.description": "自定义每个代理反应所播放的动画。预览使用默认Familiar。",
   "settings.reactions.previewAria": "动画：{state}",
   "settings.toast.reactionsReset": "反应动画已重置。",
   "settings.toast.reactionSaved": "反应动画已保存。",
@@ -255,7 +255,7 @@ export const zhHans: Partial<Messages> = {
   "settings.reaction.waiting.label": "等待中",
   "settings.reaction.waiting.description": "代理被阻塞或正在等待权限。",
   "settings.reaction.waving.label": "挥手",
-  "settings.reaction.waving.description": "宠物正在问候或引起注意。",
+  "settings.reaction.waving.description": "Familiar正在问候或引起注意。",
   "settings.reaction.success.label": "成功",
   "settings.reaction.success.description": "任务已成功完成。",
   "settings.reaction.error.label": "错误",
@@ -272,13 +272,13 @@ export const zhHans: Partial<Messages> = {
   "settings.ai.description": "Model, endpoint, and system instructions used by the built-in floating chat.",
   "settings.tts.eyebrow": "Voice",
   "settings.tts.title": "Text-to-Speech",
-  "settings.tts.description": "Voice provider and controls for the pet and floating chat.",
+  "settings.tts.description": "Voice provider and controls for the familiar and floating chat.",
   "settings.tts.placeholder": "TTS provider settings will appear here in the next build step.",
   "settings.plugins.audio.title": "允许插件播放声音",
   "settings.plugins.audio.description": "允许插件播放提示音、警报和内置音效。",
   "settings.plugins.voice.title": "允许插件说话（语音）",
   "settings.plugins.voice.description": "允许通过系统语音进行文字转语音。",
-  "settings.plugins.dynamicSpeech.title": "允许 AI 生成宠物语音",
+  "settings.plugins.dynamicSpeech.title": "允许 AI 生成Familiar语音",
   "settings.plugins.dynamicSpeech.description": "敏感：允许已批准的插件显示模型生成的气泡。",
   "settings.plugins.microphone.title": "允许麦克风（按键说话）",
   "settings.plugins.microphone.description": "敏感：允许已批准的插件捕获一次性语音输入。",
@@ -401,22 +401,22 @@ export const zhHans: Partial<Messages> = {
   "plugins.busy.uninstalling": "卸载中",
 
   // --- Plugin permission labels (renderer) ---
-  "plugins.permission.pet:speak": "说话",
-  "plugins.permission.pet:reaction": "反应",
-  "plugins.permission.pet:move": "移动",
+  "plugins.permission.familiar:speak": "说话",
+  "plugins.permission.familiar:reaction": "反应",
+  "plugins.permission.familiar:move": "移动",
   "plugins.permission.timer": "计时器",
   "plugins.permission.schedule": "日程",
   "plugins.permission.storage": "存储",
   "plugins.permission.status": "状态",
   "plugins.permission.commands": "命令",
   "plugins.permission.network": "网络",
-  "plugins.permission.pet:interact": "气泡按钮",
-  "plugins.permission.pet:pin": "固定气泡",
-  "plugins.permission.pet:animate": "自定义动画",
-  "plugins.permission.pet:speak:dynamic": "AI 语音",
-  "plugins.permission.pet:drop": "拖放",
-  "plugins.permission.pets:read": "读取宠物",
-  "plugins.permission.pets:manage": "管理宠物",
+  "plugins.permission.familiar:interact": "气泡按钮",
+  "plugins.permission.familiar:pin": "固定气泡",
+  "plugins.permission.familiar:animate": "自定义动画",
+  "plugins.permission.familiar:speak:dynamic": "AI 语音",
+  "plugins.permission.familiar:drop": "拖放",
+  "plugins.permission.familiars:read": "读取Familiar",
+  "plugins.permission.familiars:manage": "管理Familiar",
   "plugins.permission.audio": "声音",
   "plugins.permission.events": "事件",
   "plugins.permission.ui:toast": "提示消息",
@@ -440,14 +440,14 @@ export const zhHans: Partial<Messages> = {
   "integrations.commandMode.local": "本地开发",
   "integrations.loading": "正在加载集成…",
   "integrations.claude.name": "Claude Code",
-  "integrations.claude.description": "将 Claude Code 连接到你的 OpenPets 伙伴。",
+  "integrations.claude.description": "将 Claude Code 连接到你的 FamiliarOS 伙伴。",
   "integrations.opencode.name": "OpenCode",
-  "integrations.opencode.description": "将 OpenCode 全局连接到你的 OpenPets 伙伴。",
+  "integrations.opencode.description": "将 OpenCode 全局连接到你的 FamiliarOS 伙伴。",
   "integrations.cursor.name": "Cursor",
-  "integrations.cursor.description": "通过全局 MCP 配置将 Cursor 连接到你的 OpenPets 伙伴。",
+  "integrations.cursor.description": "通过全局 MCP 配置将 Cursor 连接到你的 FamiliarOS 伙伴。",
   "integrations.pi.name": "Pi",
   "integrations.pi.status": "手动",
-  "integrations.pi.description": "通过 OpenPets Pi 扩展包连接 Pi 编程代理活动。",
+  "integrations.pi.description": "通过 FamiliarOS Pi 扩展包连接 Pi 编程代理活动。",
   "integrations.soon.vscode": "VS Code",
   "integrations.soon.windsurf": "Windsurf",
   "integrations.soon.zed": "Zed",
@@ -463,13 +463,13 @@ export const zhHans: Partial<Messages> = {
   "integrations.commandSource": "命令来源",
   "integrations.cliMode": "CLI 模式",
   "integrations.localUnavailable": " 不可用",
-  "integrations.commandModeHelp": "常规设置请使用已发布的包，桌面应用构建请使用内置版，开发 OpenPets 时请使用本地版。",
+  "integrations.commandModeHelp": "常规设置请使用已发布的包，桌面应用构建请使用内置版，开发 FamiliarOS 时请使用本地版。",
   "integrations.connection": "连接",
   "integrations.statusRouting": "状态与路由",
   "integrations.globalSetup": "全局设置",
   "integrations.globalMcp": "全局 MCP",
-  "integrations.petRouting": "宠物路由",
-  "integrations.defaultPet": "默认宠物",
+  "integrations.petRouting": "Familiar路由",
+  "integrations.defaultPet": "默认Familiar",
   "integrations.configuration": "配置",
   "integrations.commandPaths": "命令路径",
   "integrations.claudeCommand": "Claude 命令",
@@ -497,12 +497,12 @@ export const zhHans: Partial<Messages> = {
   "integrations.rulesPreview": "规则预览",
   "integrations.pi.manualSetup": "手动设置",
   "integrations.pi.extension": "Pi 扩展",
-  "integrations.pi.intro": "从 Pi 安装 OpenPets Pi 扩展，然后在 Pi 会话中使用斜杠命令。",
+  "integrations.pi.intro": "从 Pi 安装 FamiliarOS Pi 扩展，然后在 Pi 会话中使用斜杠命令。",
   "integrations.pi.globalInstall": "全局安装",
   "integrations.pi.projectInstall": "项目安装",
   "integrations.pi.remove": "移除",
   "integrations.pi.slashCommands": "斜杠命令",
-  "integrations.pi.outro": "全局安装适用于所有 Pi 工作区，项目安装则仅在当前项目中启用 OpenPets。",
+  "integrations.pi.outro": "全局安装适用于所有 Pi 工作区，项目安装则仅在当前项目中启用 FamiliarOS。",
   "integrations.toast.pathSaved": "路径已保存。",
   "integrations.busy.installing": "安装中",
   "integrations.busy.replacing": "替换中",
@@ -517,21 +517,21 @@ export const zhHans: Partial<Messages> = {
   "integrations.mcpToolServers.noTools": "None active",
   "integrations.mcpToolServers.builtInChat": "Built-in Chat",
   "integrations.mcpToolServers.saved": "Saved {count} tool server(s).",
-  "integrations.openpetsMcpServer.name": "OpenPets MCP Server",
-  "integrations.openpetsMcpServer.description": "External-agent bridge that exposes your pet to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
-  "integrations.openpetsMcpServer.commandModeHelp": "Choose how the OpenPets MCP server is launched for external hosts.",
-  "integrations.openpetsMcpServer.testServer": "Test Server",
-  "integrations.openpetsMcpServer.testBusy": "Testing server…",
-  "integrations.openpetsMcpServer.testOk": "Server responded: {output}",
-  "integrations.openpetsMcpServer.testError": "Server test failed: {error}",
-  "integrations.openpetsMcpServer.copyMcpJson": "Copy MCP JSON",
-  "integrations.openpetsMcpServer.status": "Ready",
+  "integrations.familiarosMcpServer.name": "FamiliarOS MCP Server",
+  "integrations.familiarosMcpServer.description": "External-agent bridge that exposes your familiar to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
+  "integrations.familiarosMcpServer.commandModeHelp": "Choose how the FamiliarOS MCP server is launched for external hosts.",
+  "integrations.familiarosMcpServer.testServer": "Test Server",
+  "integrations.familiarosMcpServer.testBusy": "Testing server…",
+  "integrations.familiarosMcpServer.testOk": "Server responded: {output}",
+  "integrations.familiarosMcpServer.testError": "Server test failed: {error}",
+  "integrations.familiarosMcpServer.copyMcpJson": "Copy MCP JSON",
+  "integrations.familiarosMcpServer.status": "Ready",
   "integrations.curatedToolkit.name": "Curated MCP Toolkit",
   "integrations.curatedToolkit.description": "Starter stack for filesystem, Git, browser use, memory, databases, Docker, and terminal-oriented MCP lanes.",
-  "integrations.linkToCentralPanel": "Configure in the OpenPets MCP Server panel above.",
+  "integrations.linkToCentralPanel": "Configure in the FamiliarOS MCP Server panel above.",
 
   // --- Settings: Language section (renderer) ---
   "settings.language.title": "语言",
-  "settings.language.description": "OpenPets 菜单和窗口的显示语言。",
+  "settings.language.description": "FamiliarOS 菜单和窗口的显示语言。",
   "settings.language.system": "跟随系统",
 };
diff --git a/apps/desktop/src/i18n/locales/zh-Hant.ts b/apps/desktop/src/i18n/locales/zh-Hant.ts
index 588f3ab8..df6366fa 100644
--- a/apps/desktop/src/i18n/locales/zh-Hant.ts
+++ b/apps/desktop/src/i18n/locales/zh-Hant.ts
@@ -4,38 +4,38 @@ import type { Messages } from "../catalog.js";
 export const zhHant: Partial<Messages> = {
   // --- Tray menu (main process, src/tray.ts) ---
   "tray.updateAvailable": "有可用更新：{version}...",
-  "tray.defaultPet": "預設寵物：{name}",
-  "tray.toggleDefaultPet.show": "顯示預設寵物",
-  "tray.toggleDefaultPet.hide": "隱藏預設寵物",
-  "tray.pauseAllPets": "暫停所有寵物",
-  "tray.resumeAllPets": "恢復所有寵物",
-  "tray.managePets": "管理寵物...",
+  "tray.defaultPet": "預設Familiar：{name}",
+  "tray.toggleDefaultPet.show": "顯示預設Familiar",
+  "tray.toggleDefaultPet.hide": "隱藏預設Familiar",
+  "tray.pauseAllPets": "暫停所有Familiar",
+  "tray.resumeAllPets": "恢復所有Familiar",
+  "tray.managePets": "管理Familiar...",
   "tray.controlCenter": "控制中心...",
   "tray.website": "網站...",
   "tray.integrations": "整合...",
   "tray.plugins": "外掛...",
   "tray.settings": "設定...",
   "tray.openLogsFolder": "開啟日誌資料夾...",
-  "tray.quit": "結束 OpenPets",
+  "tray.quit": "結束 FamiliarOS",
 
   // --- Shared ---
   "common.latest": "最新",
-  "common.builtInPet": "內建寵物",
+  "common.builtInPet": "內建Familiar",
   "common.cancel": "取消",
 
-  // --- Pet window (main process, src/pet-window.ts) ---
-  "pet.paused": "已暫停",
-  "pet.status.thinking": "思考中",
-  "pet.status.working": "工作中",
-  "pet.status.editing": "編輯中",
-  "pet.status.testing": "測試中",
-  "pet.status.waiting": "等待中",
-  "pet.status.done": "完成",
-  "pet.status.oops": "出錯了",
-  "pet.status.hi": "你好",
-  "pet.menu.hidePet": "隱藏寵物",
-  "pet.menu.closePet": "關閉寵物",
-  "pet.menu.openControlCenter": "開啟控制中心",
+  // --- Familiar window (main process, src/familiar-window.ts) ---
+  "familiar.paused": "已暫停",
+  "familiar.status.thinking": "思考中",
+  "familiar.status.working": "工作中",
+  "familiar.status.editing": "編輯中",
+  "familiar.status.testing": "測試中",
+  "familiar.status.waiting": "等待中",
+  "familiar.status.done": "完成",
+  "familiar.status.oops": "出錯了",
+  "familiar.status.hi": "你好",
+  "familiar.menu.hidePet": "隱藏Familiar",
+  "familiar.menu.closePet": "關閉Familiar",
+  "familiar.menu.openControlCenter": "開啟控制中心",
 
   // --- Common (renderer, shared across views) ---
   "common.retry": "重試",
@@ -45,7 +45,7 @@ export const zhHant: Partial<Messages> = {
 
   // --- Navigation tabs (renderer) ---
   "nav.dashboard": "儀表板",
-  "nav.pets": "寵物",
+  "nav.familiars": "Familiar",
   "nav.settings": "設定",
   "nav.plugins": "外掛",
   "nav.integrations": "整合",
@@ -53,8 +53,8 @@ export const zhHant: Partial<Messages> = {
   // --- Route metadata (renderer hero header) ---
   "route.dashboard.title": "儀表板",
   "route.dashboard.description": "總覽你的活躍夥伴、狀態與系統指標。",
-  "route.pets.title": "寵物",
-  "route.pets.description": "安裝、匯入、預覽並選擇你的預設桌面夥伴。",
+  "route.familiars.title": "Familiar",
+  "route.familiars.description": "安裝、匯入、預覽並選擇你的預設桌面夥伴。",
   "route.settings.title": "設定",
   "route.settings.description": "設定啟動行為、大小偏好與動畫設定。",
   "route.plugins.title": "外掛",
@@ -64,13 +64,13 @@ export const zhHant: Partial<Messages> = {
 
   // --- App shell (renderer) ---
   "app.controlCenter": "控制中心",
-  "app.logo.alt": "OpenPets",
+  "app.logo.alt": "FamiliarOS",
 
   // --- Dashboard (renderer) ---
   "dashboard.loading": "正在蒐集夥伴指標...",
   "dashboard.hero.eyebrow": "主要夥伴",
   "dashboard.hero.desc": "準備好開始你的下一段寫程式時光。",
-  "dashboard.hero.changePet": "更換寵物",
+  "dashboard.hero.changePet": "更換Familiar",
   "dashboard.lastActive.none": "尚無活動",
   "dashboard.update.available": "有可用更新",
   "dashboard.update.error": "檢查失敗",
@@ -82,7 +82,7 @@ export const zhHant: Partial<Messages> = {
   "dashboard.stat.reactions": "反應",
   "dashboard.stat.reactions.footer": "觸發的動畫總數",
   "dashboard.stat.topCompanion": "最佳夥伴",
-  "dashboard.stat.topCompanion.footer": "近期最活躍的寵物",
+  "dashboard.stat.topCompanion.footer": "近期最活躍的Familiar",
   "dashboard.activity.title": "活動總覽",
   "dashboard.activity.topReactions": "熱門反應",
   "dashboard.activity.noReactions": "尚無反應記錄。開始寫程式吧！",
@@ -93,17 +93,17 @@ export const zhHant: Partial<Messages> = {
   "dashboard.reactionMix.reactions": "個反應",
   "dashboard.reactionMix.empty": "尚無反應組合。",
   "dashboard.companions.title": "最佳夥伴",
-  "dashboard.companions.subtitle": "最活躍的寵物",
+  "dashboard.companions.subtitle": "最活躍的Familiar",
   "dashboard.companions.empty": "尚無夥伴活動。",
   "dashboard.lastActive.label": "上次活躍：",
   "dashboard.system.title": "系統狀態",
-  "dashboard.system.pets": "寵物",
-  "dashboard.system.pets.value": "已安裝 {count} 個",
+  "dashboard.system.familiars": "Familiar",
+  "dashboard.system.familiars.value": "已安裝 {count} 個",
   "dashboard.system.plugins": "外掛",
   "dashboard.system.plugins.enabled": "已啟用 {count} 個",
   "dashboard.system.catalog": "目錄",
   "dashboard.system.catalog.offline": "離線",
-  "dashboard.system.catalog.pets": "{count} 個寵物",
+  "dashboard.system.catalog.familiars": "{count} 個Familiar",
   "dashboard.system.catalog.ready": "就緒",
   "dashboard.system.updates": "更新",
   "dashboard.system.version": "版本",
@@ -111,77 +111,77 @@ export const zhHant: Partial<Messages> = {
   // --- Placeholder view (renderer) ---
   "placeholder.comingSoon": "即將推出 • 下一個移轉目標",
 
-  // --- Pets filters (renderer) ---
-  "pets.filter.all": "全部",
-  "pets.filter.installed": "已安裝",
-  "pets.filter.featured": "精選",
-  "pets.filter.originals": "原創",
-  "pets.filter.codex": "Codex",
-  "pets.search.placeholder": "搜尋寵物...",
-  "pets.import": "匯入寵物",
-  "pets.gallery": "藝廊",
+  // --- Familiars filters (renderer) ---
+  "familiars.filter.all": "全部",
+  "familiars.filter.installed": "已安裝",
+  "familiars.filter.featured": "精選",
+  "familiars.filter.originals": "原創",
+  "familiars.filter.codex": "Codex",
+  "familiars.search.placeholder": "搜尋Familiar...",
+  "familiars.import": "匯入Familiar",
+  "familiars.gallery": "藝廊",
 
-  // --- Pets card badges/actions (renderer) ---
-  "pets.badge.default": "預設",
-  "pets.badge.original": "原創",
-  "pets.badge.featured": "精選",
-  "pets.badge.installed": "已安裝",
-  "pets.badge.codex": "Codex",
-  "pets.badge.broken": "已損壞",
-  "pets.badge.ready": "就緒",
-  "pets.badge.originals": "原創",
-  "pets.action.viewPet": "檢視寵物",
-  "pets.action.install": "安裝",
-  "pets.action.import": "匯入",
-  "pets.action.default": "設為預設",
-  "pets.action.remove": "移除",
-  "pets.action.refresh": "重新整理",
-  "pets.aria.view": "檢視 {name}",
-  "pets.aria.install": "安裝 {name}",
-  "pets.aria.import": "從 Codex 匯入 {name}",
-  "pets.aria.setDefault": "將 {name} 設為預設",
-  "pets.aria.remove": "移除 {name}",
-  "pets.busy.installing": "安裝中",
-  "pets.busy.importing": "匯入中",
-  "pets.busy.settingDefault": "設定預設中",
-  "pets.busy.removing": "移除中",
-  "pets.busy.loadingPage": "載入頁面中",
+  // --- Familiars card badges/actions (renderer) ---
+  "familiars.badge.default": "預設",
+  "familiars.badge.original": "原創",
+  "familiars.badge.featured": "精選",
+  "familiars.badge.installed": "已安裝",
+  "familiars.badge.codex": "Codex",
+  "familiars.badge.broken": "已損壞",
+  "familiars.badge.ready": "就緒",
+  "familiars.badge.originals": "原創",
+  "familiars.action.viewPet": "檢視Familiar",
+  "familiars.action.install": "安裝",
+  "familiars.action.import": "匯入",
+  "familiars.action.default": "設為預設",
+  "familiars.action.remove": "移除",
+  "familiars.action.refresh": "重新整理",
+  "familiars.aria.view": "檢視 {name}",
+  "familiars.aria.install": "安裝 {name}",
+  "familiars.aria.import": "從 Codex 匯入 {name}",
+  "familiars.aria.setDefault": "將 {name} 設為預設",
+  "familiars.aria.remove": "移除 {name}",
+  "familiars.busy.installing": "安裝中",
+  "familiars.busy.importing": "匯入中",
+  "familiars.busy.settingDefault": "設定預設中",
+  "familiars.busy.removing": "移除中",
+  "familiars.busy.loadingPage": "載入頁面中",
 
-  // --- Pets pager (renderer) ---
-  "pets.pager.prev": "上一頁",
-  "pets.pager.next": "下一頁",
-  "pets.pager.count": "{count} 個寵物",
-  "pets.pager.page": " · 第 {page} / {pageCount} 頁",
+  // --- Familiars pager (renderer) ---
+  "familiars.pager.prev": "上一頁",
+  "familiars.pager.next": "下一頁",
+  "familiars.pager.count": "{count} 個Familiar",
+  "familiars.pager.page": " · 第 {page} / {pageCount} 頁",
 
-  // --- Pet detail dialog (renderer) ---
-  "pets.detail.ariaLabel": "{name} 寵物詳情",
-  "pets.detail.closeAria": "關閉寵物詳情",
-  "pets.detail.eyebrow": "寵物詳情",
-  "pets.detail.previewAnimations": "預覽動畫",
-  "pets.detail.preview.idle": "待機",
-  "pets.detail.preview.thinking": "思考",
-  "pets.detail.preview.happy": "開心",
-  "pets.detail.preview.wave": "揮手",
-  "pets.detail.installPet": "安裝寵物",
-  "pets.detail.importCodexPet": "匯入 Codex 寵物",
-  "pets.detail.setDefaultPet": "設為預設寵物",
-  "pets.detail.remove": "移除",
-  "pets.detail.refresh": "重新整理",
+  // --- Familiar detail dialog (renderer) ---
+  "familiars.detail.ariaLabel": "{name} Familiar詳情",
+  "familiars.detail.closeAria": "關閉Familiar詳情",
+  "familiars.detail.eyebrow": "Familiar詳情",
+  "familiars.detail.previewAnimations": "預覽動畫",
+  "familiars.detail.preview.idle": "待機",
+  "familiars.detail.preview.thinking": "思考",
+  "familiars.detail.preview.happy": "開心",
+  "familiars.detail.preview.wave": "揮手",
+  "familiars.detail.installPet": "安裝Familiar",
+  "familiars.detail.importCodexPet": "匯入 Codex Familiar",
+  "familiars.detail.setDefaultPet": "設為預設Familiar",
+  "familiars.detail.remove": "移除",
+  "familiars.detail.refresh": "重新整理",
 
-  // --- Pet detail status text (renderer) ---
-  "pets.status.broken": "這個已安裝的寵物已損壞，無法設為預設。",
-  "pets.status.defaultProtected": "預設內建寵物，無法移除。",
-  "pets.status.default": "預設寵物。",
-  "pets.status.installedCodex": "已安裝，可設為你的預設寵物。也可在 ~/.codex/pets 中找到。",
-  "pets.status.installed": "已安裝，可設為你的預設寵物。",
-  "pets.status.availableCodex": "可從 ~/.codex/pets 匯入。",
-  "pets.status.availableCatalog": "可從目錄安裝。",
+  // --- Familiar detail status text (renderer) ---
+  "familiars.status.broken": "這個已安裝的Familiar已損壞，無法設為預設。",
+  "familiars.status.defaultProtected": "預設內建Familiar，無法移除。",
+  "familiars.status.default": "預設Familiar。",
+  "familiars.status.installedCodex": "已安裝，可設為你的預設Familiar。也可在 ~/.codex/familiars 中找到。",
+  "familiars.status.installed": "已安裝，可設為你的預設Familiar。",
+  "familiars.status.availableCodex": "可從 ~/.codex/familiars 匯入。",
+  "familiars.status.availableCatalog": "可從目錄安裝。",
 
-  // --- Pet labels for SpriteFrame/PetImage (renderer) ---
-  "pets.spriteLabel.thumbnail": "{name} 縮圖",
-  "pets.spriteLabel.thumb": "{name} 縮圖",
-  "pets.spriteLabel.animatedPreview": "{name} 動畫預覽",
-  "pets.spriteLabel.statePreview": "{name} {state} 預覽",
+  // --- Familiar labels for SpriteFrame/PetImage (renderer) ---
+  "familiars.spriteLabel.thumbnail": "{name} 縮圖",
+  "familiars.spriteLabel.thumb": "{name} 縮圖",
+  "familiars.spriteLabel.animatedPreview": "{name} 動畫預覽",
+  "familiars.spriteLabel.statePreview": "{name} {state} 預覽",
 
   // --- Settings: general (renderer) ---
   "settings.nav.general": "一般",
@@ -189,22 +189,22 @@ export const zhHant: Partial<Messages> = {
   "settings.nav.plugins": "外掛平台",
   "settings.general.eyebrow": "環境",
   "settings.general.title": "一般設定",
-  "settings.general.showOnLaunch.title": "啟動時顯示寵物",
-  "settings.general.showOnLaunch.description": "將 OpenPets 保留在工作列，但在需要時才顯示寵物。",
+  "settings.general.showOnLaunch.title": "啟動時顯示Familiar",
+  "settings.general.showOnLaunch.description": "將 FamiliarOS 保留在工作列，但在需要時才顯示Familiar。",
   "settings.general.launchAtLogin.title": "登入時啟動",
-  "settings.general.launchAtLogin.supported": "在電腦開機時自動啟動 OpenPets。",
+  "settings.general.launchAtLogin.supported": "在電腦開機時自動啟動 FamiliarOS。",
   "settings.general.launchAtLogin.unsupported": "此平台不支援。",
-  "settings.general.petScale.title": "寵物大小",
-  "settings.general.petScale.description": "調整預設桌面寵物的顯示大小。",
-  "settings.general.resetPosition": "重設寵物位置",
+  "settings.general.petScale.title": "Familiar大小",
+  "settings.general.petScale.description": "調整預設桌面Familiar的顯示大小。",
+  "settings.general.resetPosition": "重設Familiar位置",
   "settings.general.systemStatus": "系統狀態",
   "settings.general.updateAvailable": "有可用更新",
   "settings.general.checking": "檢查中…",
   "settings.general.checkForUpdates": "檢查更新",
   "settings.toast.startupSaved": "已儲存啟動偏好。",
   "settings.toast.loginStartupSaved": "已儲存登入啟動偏好。",
-  "settings.toast.petScaleSaved": "已儲存寵物大小。",
-  "settings.toast.positionReset": "已重設預設寵物位置。",
+  "settings.toast.petScaleSaved": "已儲存Familiar大小。",
+  "settings.toast.positionReset": "已重設預設Familiar位置。",
   "settings.busy.saving": "儲存中",
   "settings.busy.resetting": "重設中",
   "settings.busy.opening": "開啟中",
@@ -222,7 +222,7 @@ export const zhHant: Partial<Messages> = {
   "settings.reactions.eyebrow": "行為",
   "settings.reactions.title": "反應對應",
   "settings.reactions.resetDefaults": "重設為預設值",
-  "settings.reactions.description": "自訂每個代理反應所播放的動畫。預覽使用預設寵物。",
+  "settings.reactions.description": "自訂每個代理反應所播放的動畫。預覽使用預設Familiar。",
   "settings.reactions.previewAria": "動畫：{state}",
   "settings.toast.reactionsReset": "已重設反應動畫。",
   "settings.toast.reactionSaved": "已儲存反應動畫。",
@@ -255,7 +255,7 @@ export const zhHant: Partial<Messages> = {
   "settings.reaction.waiting.label": "等待中",
   "settings.reaction.waiting.description": "代理受阻或正在等待權限。",
   "settings.reaction.waving.label": "揮手",
-  "settings.reaction.waving.description": "寵物正在問候或吸引注意。",
+  "settings.reaction.waving.description": "Familiar正在問候或吸引注意。",
   "settings.reaction.success.label": "成功",
   "settings.reaction.success.description": "任務已成功完成。",
   "settings.reaction.error.label": "錯誤",
@@ -272,13 +272,13 @@ export const zhHant: Partial<Messages> = {
   "settings.ai.description": "Model, endpoint, and system instructions used by the built-in floating chat.",
   "settings.tts.eyebrow": "Voice",
   "settings.tts.title": "Text-to-Speech",
-  "settings.tts.description": "Voice provider and controls for the pet and floating chat.",
+  "settings.tts.description": "Voice provider and controls for the familiar and floating chat.",
   "settings.tts.placeholder": "TTS provider settings will appear here in the next build step.",
   "settings.plugins.audio.title": "允許外掛播放聲音",
   "settings.plugins.audio.description": "允許外掛的提示音、警示音與內建音效。",
   "settings.plugins.voice.title": "允許外掛說話（語音）",
   "settings.plugins.voice.description": "允許透過系統語音進行文字轉語音。",
-  "settings.plugins.dynamicSpeech.title": "允許 AI 生成的寵物對話",
+  "settings.plugins.dynamicSpeech.title": "允許 AI 生成的Familiar對話",
   "settings.plugins.dynamicSpeech.description": "敏感：讓核准的外掛顯示由模型生成的對話泡泡。",
   "settings.plugins.microphone.title": "允許麥克風（按住說話）",
   "settings.plugins.microphone.description": "敏感：讓核准的外掛擷取單次語音輸入。",
@@ -401,22 +401,22 @@ export const zhHant: Partial<Messages> = {
   "plugins.busy.uninstalling": "解除安裝中",
 
   // --- Plugin permission labels (renderer) ---
-  "plugins.permission.pet:speak": "說話",
-  "plugins.permission.pet:reaction": "反應",
-  "plugins.permission.pet:move": "移動",
+  "plugins.permission.familiar:speak": "說話",
+  "plugins.permission.familiar:reaction": "反應",
+  "plugins.permission.familiar:move": "移動",
   "plugins.permission.timer": "計時器",
   "plugins.permission.schedule": "排程",
   "plugins.permission.storage": "儲存空間",
   "plugins.permission.status": "狀態",
   "plugins.permission.commands": "指令",
   "plugins.permission.network": "網路",
-  "plugins.permission.pet:interact": "泡泡按鈕",
-  "plugins.permission.pet:pin": "釘選泡泡",
-  "plugins.permission.pet:animate": "自訂動畫",
-  "plugins.permission.pet:speak:dynamic": "AI 對話",
-  "plugins.permission.pet:drop": "拖放",
-  "plugins.permission.pets:read": "讀取寵物",
-  "plugins.permission.pets:manage": "管理寵物",
+  "plugins.permission.familiar:interact": "泡泡按鈕",
+  "plugins.permission.familiar:pin": "釘選泡泡",
+  "plugins.permission.familiar:animate": "自訂動畫",
+  "plugins.permission.familiar:speak:dynamic": "AI 對話",
+  "plugins.permission.familiar:drop": "拖放",
+  "plugins.permission.familiars:read": "讀取Familiar",
+  "plugins.permission.familiars:manage": "管理Familiar",
   "plugins.permission.audio": "聲音",
   "plugins.permission.events": "事件",
   "plugins.permission.ui:toast": "提示訊息",
@@ -440,14 +440,14 @@ export const zhHant: Partial<Messages> = {
   "integrations.commandMode.local": "本機開發",
   "integrations.loading": "正在載入整合…",
   "integrations.claude.name": "Claude Code",
-  "integrations.claude.description": "將 Claude Code 連接到你的 OpenPets 夥伴。",
+  "integrations.claude.description": "將 Claude Code 連接到你的 FamiliarOS 夥伴。",
   "integrations.opencode.name": "OpenCode",
-  "integrations.opencode.description": "將 OpenCode 全域連接到你的 OpenPets 夥伴。",
+  "integrations.opencode.description": "將 OpenCode 全域連接到你的 FamiliarOS 夥伴。",
   "integrations.cursor.name": "Cursor",
-  "integrations.cursor.description": "透過全域 MCP 設定將 Cursor 連接到你的 OpenPets 夥伴。",
+  "integrations.cursor.description": "透過全域 MCP 設定將 Cursor 連接到你的 FamiliarOS 夥伴。",
   "integrations.pi.name": "Pi",
   "integrations.pi.status": "手動",
-  "integrations.pi.description": "透過 OpenPets Pi 擴充套件連接 Pi 程式設計代理的活動。",
+  "integrations.pi.description": "透過 FamiliarOS Pi 擴充套件連接 Pi 程式設計代理的活動。",
   "integrations.soon.vscode": "VS Code",
   "integrations.soon.windsurf": "Windsurf",
   "integrations.soon.zed": "Zed",
@@ -463,13 +463,13 @@ export const zhHant: Partial<Messages> = {
   "integrations.commandSource": "指令來源",
   "integrations.cliMode": "CLI 模式",
   "integrations.localUnavailable": " 無法使用",
-  "integrations.commandModeHelp": "一般設定請使用已發佈套件，桌面應用程式版本請使用內建，開發 OpenPets 時則使用本機。",
+  "integrations.commandModeHelp": "一般設定請使用已發佈套件，桌面應用程式版本請使用內建，開發 FamiliarOS 時則使用本機。",
   "integrations.connection": "連線",
   "integrations.statusRouting": "狀態與路由",
   "integrations.globalSetup": "全域設定",
   "integrations.globalMcp": "全域 MCP",
-  "integrations.petRouting": "寵物路由",
-  "integrations.defaultPet": "預設寵物",
+  "integrations.petRouting": "Familiar路由",
+  "integrations.defaultPet": "預設Familiar",
   "integrations.configuration": "設定",
   "integrations.commandPaths": "指令路徑",
   "integrations.claudeCommand": "Claude 指令",
@@ -497,12 +497,12 @@ export const zhHant: Partial<Messages> = {
   "integrations.rulesPreview": "規則預覽",
   "integrations.pi.manualSetup": "手動設定",
   "integrations.pi.extension": "Pi 擴充套件",
-  "integrations.pi.intro": "從 Pi 安裝 OpenPets Pi 擴充套件，然後在 Pi 工作階段中使用斜線指令。",
+  "integrations.pi.intro": "從 Pi 安裝 FamiliarOS Pi 擴充套件，然後在 Pi 工作階段中使用斜線指令。",
   "integrations.pi.globalInstall": "全域安裝",
   "integrations.pi.projectInstall": "專案安裝",
   "integrations.pi.remove": "移除",
   "integrations.pi.slashCommands": "斜線指令",
-  "integrations.pi.outro": "所有 Pi 工作區皆使用全域安裝；只想在目前專案使用 OpenPets 時則選擇專案安裝。",
+  "integrations.pi.outro": "所有 Pi 工作區皆使用全域安裝；只想在目前專案使用 FamiliarOS 時則選擇專案安裝。",
   "integrations.toast.pathSaved": "已儲存路徑。",
   "integrations.busy.installing": "安裝中",
   "integrations.busy.replacing": "取代中",
@@ -517,21 +517,21 @@ export const zhHant: Partial<Messages> = {
   "integrations.mcpToolServers.noTools": "None active",
   "integrations.mcpToolServers.builtInChat": "Built-in Chat",
   "integrations.mcpToolServers.saved": "Saved {count} tool server(s).",
-  "integrations.openpetsMcpServer.name": "OpenPets MCP Server",
-  "integrations.openpetsMcpServer.description": "External-agent bridge that exposes your pet to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
-  "integrations.openpetsMcpServer.commandModeHelp": "Choose how the OpenPets MCP server is launched for external hosts.",
-  "integrations.openpetsMcpServer.testServer": "Test Server",
-  "integrations.openpetsMcpServer.testBusy": "Testing server…",
-  "integrations.openpetsMcpServer.testOk": "Server responded: {output}",
-  "integrations.openpetsMcpServer.testError": "Server test failed: {error}",
-  "integrations.openpetsMcpServer.copyMcpJson": "Copy MCP JSON",
-  "integrations.openpetsMcpServer.status": "Ready",
+  "integrations.familiarosMcpServer.name": "FamiliarOS MCP Server",
+  "integrations.familiarosMcpServer.description": "External-agent bridge that exposes your familiar to Claude Code, Cursor, Codex CLI, and other MCP hosts.",
+  "integrations.familiarosMcpServer.commandModeHelp": "Choose how the FamiliarOS MCP server is launched for external hosts.",
+  "integrations.familiarosMcpServer.testServer": "Test Server",
+  "integrations.familiarosMcpServer.testBusy": "Testing server…",
+  "integrations.familiarosMcpServer.testOk": "Server responded: {output}",
+  "integrations.familiarosMcpServer.testError": "Server test failed: {error}",
+  "integrations.familiarosMcpServer.copyMcpJson": "Copy MCP JSON",
+  "integrations.familiarosMcpServer.status": "Ready",
   "integrations.curatedToolkit.name": "Curated MCP Toolkit",
   "integrations.curatedToolkit.description": "Starter stack for filesystem, Git, browser use, memory, databases, Docker, and terminal-oriented MCP lanes.",
-  "integrations.linkToCentralPanel": "Configure in the OpenPets MCP Server panel above.",
+  "integrations.linkToCentralPanel": "Configure in the FamiliarOS MCP Server panel above.",
 
   // --- Settings: Language section (renderer) ---
   "settings.language.title": "語言",
-  "settings.language.description": "OpenPets 選單與視窗的顯示語言。",
+  "settings.language.description": "FamiliarOS 選單與視窗的顯示語言。",
   "settings.language.system": "跟隨系統",
 };
diff --git a/apps/desktop/src/i18n/reactions/es-419.ts b/apps/desktop/src/i18n/reactions/es-419.ts
index 90efa2ad..fc10f2c8 100644
--- a/apps/desktop/src/i18n/reactions/es-419.ts
+++ b/apps/desktop/src/i18n/reactions/es-419.ts
@@ -1,7 +1,7 @@
-import type { OpenPetsReaction } from "../../local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "../../local-ipc-protocol.js";
 
-// Español (Latinoamérica) pet speech-bubble pools.
-export const es419: Record<OpenPetsReaction, readonly string[]> = {
+// Español (Latinoamérica) familiar speech-bubble pools.
+export const es419: Record<FamiliarOSReaction, readonly string[]> = {
   idle: [
     "Listo",
     "En espera",
diff --git a/apps/desktop/src/i18n/reactions/index.ts b/apps/desktop/src/i18n/reactions/index.ts
index 9a1de08a..8bc6a46a 100644
--- a/apps/desktop/src/i18n/reactions/index.ts
+++ b/apps/desktop/src/i18n/reactions/index.ts
@@ -1,9 +1,9 @@
-// Localized pet speech-bubble pools. English lives in ../../reaction-messages.ts
+// Localized familiar speech-bubble pools. English lives in ../../reaction-messages.ts
 // (`reactionMessagePools`); this registry holds the translated pools and is the
 // fallback source for `pickReactionMessage`. A locale absent here, or a reaction
 // absent from a locale, falls back to English.
 import type { Locale } from "../catalog.js";
-import type { OpenPetsReaction } from "../../local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "../../local-ipc-protocol.js";
 
 import { ja } from "./ja.js";
 import { ko } from "./ko.js";
@@ -12,7 +12,7 @@ import { zhHant } from "./zh-Hant.js";
 import { ptBR } from "./pt-BR.js";
 import { es419 } from "./es-419.js";
 
-export type ReactionMessagePool = Record<OpenPetsReaction, readonly string[]>;
+export type ReactionMessagePool = Record<FamiliarOSReaction, readonly string[]>;
 
 export const localizedReactionMessagePools: Partial<Record<Locale, ReactionMessagePool>> = {
   ja,
diff --git a/apps/desktop/src/i18n/reactions/ja.ts b/apps/desktop/src/i18n/reactions/ja.ts
index 340e2d96..7f1b9b40 100644
--- a/apps/desktop/src/i18n/reactions/ja.ts
+++ b/apps/desktop/src/i18n/reactions/ja.ts
@@ -1,7 +1,7 @@
-import type { OpenPetsReaction } from "../../local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "../../local-ipc-protocol.js";
 
-// 日本語 (Japanese) pet speech-bubble pools.
-export const ja: Record<OpenPetsReaction, readonly string[]> = {
+// 日本語 (Japanese) familiar speech-bubble pools.
+export const ja: Record<FamiliarOSReaction, readonly string[]> = {
   idle: [
     "準備OK",
     "待機中",
diff --git a/apps/desktop/src/i18n/reactions/ko.ts b/apps/desktop/src/i18n/reactions/ko.ts
index a2c51d81..2e3494ed 100644
--- a/apps/desktop/src/i18n/reactions/ko.ts
+++ b/apps/desktop/src/i18n/reactions/ko.ts
@@ -1,7 +1,7 @@
-import type { OpenPetsReaction } from "../../local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "../../local-ipc-protocol.js";
 
-// 한국어 (Korean) pet speech-bubble pools.
-export const ko: Record<OpenPetsReaction, readonly string[]> = {
+// 한국어 (Korean) familiar speech-bubble pools.
+export const ko: Record<FamiliarOSReaction, readonly string[]> = {
   idle: [
     "준비 완료",
     "대기 중",
diff --git a/apps/desktop/src/i18n/reactions/pt-BR.ts b/apps/desktop/src/i18n/reactions/pt-BR.ts
index 09afeb9c..4dadae02 100644
--- a/apps/desktop/src/i18n/reactions/pt-BR.ts
+++ b/apps/desktop/src/i18n/reactions/pt-BR.ts
@@ -1,7 +1,7 @@
-import type { OpenPetsReaction } from "../../local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "../../local-ipc-protocol.js";
 
-// Português (Brasil) pet speech-bubble pools.
-export const ptBR: Record<OpenPetsReaction, readonly string[]> = {
+// Português (Brasil) familiar speech-bubble pools.
+export const ptBR: Record<FamiliarOSReaction, readonly string[]> = {
   idle: [
     "Pronto",
     "De prontidão",
diff --git a/apps/desktop/src/i18n/reactions/zh-Hans.ts b/apps/desktop/src/i18n/reactions/zh-Hans.ts
index 9b525993..cbaf38bc 100644
--- a/apps/desktop/src/i18n/reactions/zh-Hans.ts
+++ b/apps/desktop/src/i18n/reactions/zh-Hans.ts
@@ -1,7 +1,7 @@
-import type { OpenPetsReaction } from "../../local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "../../local-ipc-protocol.js";
 
-// 简体中文 (Simplified Chinese) pet speech-bubble pools.
-export const zhHans: Record<OpenPetsReaction, readonly string[]> = {
+// 简体中文 (Simplified Chinese) familiar speech-bubble pools.
+export const zhHans: Record<FamiliarOSReaction, readonly string[]> = {
   idle: [
     "准备好了",
     "随时待命",
diff --git a/apps/desktop/src/i18n/reactions/zh-Hant.ts b/apps/desktop/src/i18n/reactions/zh-Hant.ts
index 7d5782f2..4b3795a6 100644
--- a/apps/desktop/src/i18n/reactions/zh-Hant.ts
+++ b/apps/desktop/src/i18n/reactions/zh-Hant.ts
@@ -1,7 +1,7 @@
-import type { OpenPetsReaction } from "../../local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "../../local-ipc-protocol.js";
 
-// 繁體中文 (Traditional Chinese) pet speech-bubble pools.
-export const zhHant: Record<OpenPetsReaction, readonly string[]> = {
+// 繁體中文 (Traditional Chinese) familiar speech-bubble pools.
+export const zhHant: Record<FamiliarOSReaction, readonly string[]> = {
   idle: [
     "準備好了",
     "待命中",
diff --git a/apps/desktop/src/knowledge-store.ts b/apps/desktop/src/knowledge-store.ts
index dd48fa93..ee54be37 100644
--- a/apps/desktop/src/knowledge-store.ts
+++ b/apps/desktop/src/knowledge-store.ts
@@ -8,19 +8,19 @@ import {
   type StoreKnowledgeFileInput,
   formatBytes,
 } from "./knowledge-store-core.js";
-import { type OpenPetsMemoryEntry, type OpenPetsMemorySearchHit, searchOpenPetsMemories, storeOpenPetsMemory } from "./openpets-memory.js";
-import type { OpenPetsMemoryKind } from "./local-ipc-protocol.js";
+import { type FamiliarOSMemoryEntry, type FamiliarOSMemorySearchHit, searchFamiliarOSMemories, storeFamiliarOSMemory } from "./familiaros-memory.js";
+import type { FamiliarOSMemoryKind } from "./local-ipc-protocol.js";
 
 export type { KnowledgeFileEntry, KnowledgeFileSearchHit, StoreKnowledgeFileInput };
 
 export interface KnowledgeStoreSearchResult {
   readonly files: readonly KnowledgeFileSearchHit[];
-  readonly memories: readonly OpenPetsMemorySearchHit[];
+  readonly memories: readonly FamiliarOSMemorySearchHit[];
 }
 
 export interface StoreKnowledgeMemoryInput {
   readonly text: string;
-  readonly kind?: OpenPetsMemoryKind;
+  readonly kind?: FamiliarOSMemoryKind;
   readonly tags?: readonly string[];
   readonly importance?: number;
 }
@@ -47,7 +47,7 @@ export function searchKnowledgeStore(query: string, limit?: number): KnowledgeSt
   const memoryLimit = clampLimit(typeof limit === "number" ? limit : 8, 8);
   return {
     files: getStore().searchFiles(query, fileLimit),
-    memories: searchOpenPetsMemories(query, memoryLimit),
+    memories: searchFamiliarOSMemories(query, memoryLimit),
   };
 }
 
@@ -59,8 +59,8 @@ export async function deleteKnowledgeFile(id: string): Promise<boolean> {
   return getStore().deleteFile(id);
 }
 
-export function addKnowledgeMemory(input: StoreKnowledgeMemoryInput): OpenPetsMemoryEntry {
-  return storeOpenPetsMemory({
+export function addKnowledgeMemory(input: StoreKnowledgeMemoryInput): FamiliarOSMemoryEntry {
+  return storeFamiliarOSMemory({
     text: input.text,
     kind: input.kind,
     tags: input.tags,
diff --git a/apps/desktop/src/lease-manager.ts b/apps/desktop/src/lease-manager.ts
index 60750dec..89c3312a 100644
--- a/apps/desktop/src/lease-manager.ts
+++ b/apps/desktop/src/lease-manager.ts
@@ -54,7 +54,7 @@ export class LeaseManager {
     this.#ttlMs = options.ttlMs ?? 15_000;
     this.#now = options.now ?? Date.now;
     this.#resolveTarget = options.resolveTarget ?? (() => { throw new Error("Lease target resolver is not configured."); });
-    this.#getDefaultPetId = options.getDefaultPetId ?? (() => { throw new Error("Default pet resolver is not configured."); });
+    this.#getDefaultPetId = options.getDefaultPetId ?? (() => { throw new Error("Default familiar resolver is not configured."); });
     this.#getPetDisplayName = options.getPetDisplayName ?? ((petId) => petId);
     this.#onFirstExplicitLease = options.onFirstExplicitLease ?? (() => {});
     this.#onLastExplicitLease = options.onLastExplicitLease ?? (() => {});
diff --git a/apps/desktop/src/lifecycle.ts b/apps/desktop/src/lifecycle.ts
index 3f2d2ad5..0dd0b847 100644
--- a/apps/desktop/src/lifecycle.ts
+++ b/apps/desktop/src/lifecycle.ts
@@ -1,7 +1,7 @@
 import { app } from "electron";
 
-import { closeAllAgentPets } from "./agent-pet-controller.js";
-import { destroyDefaultPet } from "./default-pet-controller.js";
+import { closeAllAgentPets } from "./agent-familiar-controller.js";
+import { destroyDefaultPet } from "./default-familiar-controller.js";
 import { info } from "./logger.js";
 import { destroyMcpChatClientManager } from "./mcp-chat-client.js";
 import { stopLocalIpcServer } from "./local-ipc.js";
@@ -14,20 +14,20 @@ let hardExitTimer: NodeJS.Timeout | null = null;
 export function installAppLifecycle(): void {
   app.on("second-instance", () => {
     info("app", "second instance requested");
-    console.log("Second OpenPets launch requested; keeping existing instance.");
+    console.log("Second FamiliarOS launch requested; keeping existing instance.");
     focusOpenTaskWindows();
   });
 
   app.on("window-all-closed", () => {
     if (!intentionalQuit) {
       info("app", "all task windows closed; tray app kept alive");
-      console.log("All OpenPets task windows closed; keeping tray app running.");
+      console.log("All FamiliarOS task windows closed; keeping tray app running.");
     }
   });
 
   app.on("activate", () => {
     info("app", "activate event");
-    console.log("OpenPets activate event received; not opening a dashboard window.");
+    console.log("FamiliarOS activate event received; not opening a dashboard window.");
   });
 
   app.on("before-quit", () => {
@@ -42,7 +42,7 @@ export function installAppLifecycle(): void {
   });
 }
 
-export function quitOpenPets(): void {
+export function quitFamiliarOS(): void {
   intentionalQuit = true;
   info("app", "quit requested");
   scheduleHardExitFallback("quit-requested");
diff --git a/apps/desktop/src/local-ipc-paths.ts b/apps/desktop/src/local-ipc-paths.ts
index d9f82aa6..1ea64831 100644
--- a/apps/desktop/src/local-ipc-paths.ts
+++ b/apps/desktop/src/local-ipc-paths.ts
@@ -7,9 +7,9 @@ import { app } from "electron";
 
 import { openPetsIpcProtocol, openPetsIpcVersion } from "./local-ipc-protocol.js";
 
-export interface OpenPetsDiscoveryFile {
+export interface FamiliarOSDiscoveryFile {
   readonly protocolVersion: 1;
-  readonly protocol: "openpets-ipc";
+  readonly protocol: "familiaros-ipc";
   readonly endpoint: string;
   readonly token: string;
   readonly appVersion: string;
@@ -22,24 +22,24 @@ export type IpcEndpoint =
   | { readonly kind: "path"; readonly path: string };
 
 export function getDiscoveryFilePath(): string {
-  if (process.env.OPENPETS_DISCOVERY_FILE) {
-    return process.env.OPENPETS_DISCOVERY_FILE;
+  if (process.env.FAMILIAROS_DISCOVERY_FILE) {
+    return process.env.FAMILIAROS_DISCOVERY_FILE;
   }
 
   if (process.platform === "darwin") {
-    return join(homedir(), "Library", "Application Support", "OpenPets", "runtime", "ipc.json");
+    return join(homedir(), "Library", "Application Support", "FamiliarOS", "runtime", "ipc.json");
   }
 
   if (process.platform === "win32") {
-    return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "OpenPets", "runtime", "ipc.json");
+    return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "FamiliarOS", "runtime", "ipc.json");
   }
 
   const xdg = getSecureXdgRuntimeDir();
   if (xdg) {
-    return join(xdg, "openpets", "ipc.json");
+    return join(xdg, "familiaros", "ipc.json");
   }
 
-  return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "OpenPets", "runtime", "ipc.json");
+  return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "FamiliarOS", "runtime", "ipc.json");
 }
 
 export interface IpcEndpointConfig {
@@ -53,27 +53,27 @@ export function createIpcEndpoint(): string {
 }
 
 export function getIpcEndpointConfig(): IpcEndpointConfig {
-  const bindEnv = process.env.OPENPETS_IPC_BIND;
-  const endpointEnv = process.env.OPENPETS_IPC_ENDPOINT;
+  const bindEnv = process.env.FAMILIAROS_IPC_BIND;
+  const endpointEnv = process.env.FAMILIAROS_IPC_ENDPOINT;
 
   // Case 1: Both BIND and ENDPOINT set - BIND for listening, ENDPOINT for advertising
   if (bindEnv && endpointEnv) {
     const bindParsed = parseIpcEndpoint(bindEnv, { allowPortZero: true, allowNonLoopback: true });
     if (bindParsed.kind !== "tcp") {
-      throw new Error("OPENPETS_IPC_BIND only supports TCP endpoints (e.g., tcp://0.0.0.0:37645 or tcp://127.0.0.1:37645).");
+      throw new Error("FAMILIAROS_IPC_BIND only supports TCP endpoints (e.g., tcp://0.0.0.0:37645 or tcp://127.0.0.1:37645).");
     }
     validateBindHost(bindParsed.host);
     const advertisedParsed = parseIpcEndpoint(endpointEnv, { allowPortZero: false, allowNonLoopback: true });
     if (advertisedParsed.kind !== "tcp") {
-      throw new Error("OPENPETS_IPC_ENDPOINT must be a TCP endpoint when used with OPENPETS_IPC_BIND.");
+      throw new Error("FAMILIAROS_IPC_ENDPOINT must be a TCP endpoint when used with FAMILIAROS_IPC_BIND.");
     }
     // Advertised endpoint must have a concrete host (not 0.0.0.0)
     if (advertisedParsed.host === "0.0.0.0") {
-      throw new Error("OPENPETS_IPC_ENDPOINT must specify a concrete IPv4 address (not 0.0.0.0) when used as the advertised endpoint.");
+      throw new Error("FAMILIAROS_IPC_ENDPOINT must specify a concrete IPv4 address (not 0.0.0.0) when used as the advertised endpoint.");
     }
     validateAdvertisedHost(advertisedParsed.host);
     if (bindParsed.port !== 0 && advertisedParsed.port !== bindParsed.port) {
-      throw new Error("OPENPETS_IPC_ENDPOINT must use the same port as OPENPETS_IPC_BIND unless OPENPETS_IPC_BIND uses port 0.");
+      throw new Error("FAMILIAROS_IPC_ENDPOINT must use the same port as FAMILIAROS_IPC_BIND unless FAMILIAROS_IPC_BIND uses port 0.");
     }
     return { bindEndpoint: bindParsed, advertisedEndpoint: endpointEnv };
   }
@@ -82,12 +82,12 @@ export function getIpcEndpointConfig(): IpcEndpointConfig {
   if (bindEnv) {
     const bindParsed = parseIpcEndpoint(bindEnv, { allowPortZero: true, allowNonLoopback: true });
     if (bindParsed.kind !== "tcp") {
-      throw new Error("OPENPETS_IPC_BIND only supports TCP endpoints (e.g., tcp://0.0.0.0:37645 or tcp://127.0.0.1:37645).");
+      throw new Error("FAMILIAROS_IPC_BIND only supports TCP endpoints (e.g., tcp://0.0.0.0:37645 or tcp://127.0.0.1:37645).");
     }
     validateBindHost(bindParsed.host);
     // If binding to 0.0.0.0, we need a separate advertised endpoint
     if (bindParsed.host === "0.0.0.0") {
-      throw new Error("When OPENPETS_IPC_BIND is set to 0.0.0.0, you must also set OPENPETS_IPC_ENDPOINT to specify the advertised endpoint (e.g., the WSL host IP).");
+      throw new Error("When FAMILIAROS_IPC_BIND is set to 0.0.0.0, you must also set FAMILIAROS_IPC_ENDPOINT to specify the advertised endpoint (e.g., the WSL host IP).");
     }
     validateAdvertisedHost(bindParsed.host);
     return { bindEndpoint: bindParsed, advertisedEndpoint: bindEnv };
@@ -95,51 +95,51 @@ export function getIpcEndpointConfig(): IpcEndpointConfig {
 
   // Case 3: Only ENDPOINT set - invalid. ENDPOINT only advertises; BIND opts into TCP listening.
   if (endpointEnv) {
-    throw new Error("OPENPETS_IPC_ENDPOINT only controls the advertised discovery endpoint. Set OPENPETS_IPC_BIND to opt into TCP IPC listening.");
+    throw new Error("FAMILIAROS_IPC_ENDPOINT only controls the advertised discovery endpoint. Set FAMILIAROS_IPC_BIND to opt into TCP IPC listening.");
   }
 
   // Case 4: No env vars - use platform default
   if (process.platform === "win32") {
-    const pipePath = `\\\\.\\pipe\\openpets-${randomEndpointPart()}-${process.pid}`;
+    const pipePath = `\\\\.\\pipe\\familiaros-${randomEndpointPart()}-${process.pid}`;
     return { bindEndpoint: { kind: "path", path: pipePath }, advertisedEndpoint: pipePath };
   }
 
   const runtimeDir = getSocketRuntimeDir();
   mkdirSync(runtimeDir, { recursive: true, mode: 0o700 });
   ensurePrivateRuntimeDir(runtimeDir);
-  const socketPath = join(runtimeDir, `openpets-${process.pid}.sock`);
+  const socketPath = join(runtimeDir, `familiaros-${process.pid}.sock`);
   return { bindEndpoint: { kind: "path", path: socketPath }, advertisedEndpoint: socketPath };
 }
 
 export function parseIpcEndpoint(endpoint: string, options: { readonly allowPortZero?: boolean; readonly allowNonLoopback?: boolean } = {}): IpcEndpoint {
-  if (endpoint.length < 1 || endpoint.length > 240) throw new Error("OpenPets IPC endpoint length is invalid.");
-  if (endpoint.includes("\0")) throw new Error("OpenPets IPC endpoint contains NUL.");
+  if (endpoint.length < 1 || endpoint.length > 240) throw new Error("FamiliarOS IPC endpoint length is invalid.");
+  if (endpoint.includes("\0")) throw new Error("FamiliarOS IPC endpoint contains NUL.");
 
   if (endpoint.startsWith("tcp://")) {
     let url: URL;
     try {
       url = new URL(endpoint);
     } catch {
-      throw new Error("OpenPets TCP IPC endpoint is invalid.");
+      throw new Error("FamiliarOS TCP IPC endpoint is invalid.");
     }
 
     if (url.protocol !== "tcp:" || url.username || url.password || (url.pathname !== "" && url.pathname !== "/") || url.search || url.hash) {
-      throw new Error("OpenPets TCP IPC endpoint must be tcp://<host>:<port> with no credentials, path, query, or fragment.");
+      throw new Error("FamiliarOS TCP IPC endpoint must be tcp://<host>:<port> with no credentials, path, query, or fragment.");
     }
 
     const host = url.hostname;
     if (!isValidIpv4(host)) {
-      throw new Error("OpenPets TCP IPC endpoint host must be a valid IPv4 address (127.0.0.1, 0.0.0.0, or a concrete address).");
+      throw new Error("FamiliarOS TCP IPC endpoint host must be a valid IPv4 address (127.0.0.1, 0.0.0.0, or a concrete address).");
     }
 
     if (!options.allowNonLoopback && host !== "127.0.0.1") {
-      throw new Error("OpenPets TCP IPC endpoint must bind to loopback host 127.0.0.1.");
+      throw new Error("FamiliarOS TCP IPC endpoint must bind to loopback host 127.0.0.1.");
     }
 
     const port = Number(url.port);
     const minPort = options.allowPortZero ? 0 : 1;
     if (!Number.isInteger(port) || port < minPort || port > 65_535 || String(port) !== url.port) {
-      throw new Error("OpenPets TCP IPC endpoint port is invalid.");
+      throw new Error("FamiliarOS TCP IPC endpoint port is invalid.");
     }
 
     return { kind: "tcp", host, port };
@@ -177,7 +177,7 @@ function validateAdvertisedHost(host: string): void {
 function validateBindHost(host: string): void {
   if (host === "0.0.0.0") return;
   if (!isPrivateOrLocalIpv4(host)) {
-    throw new Error(`OPENPETS_IPC_BIND host ${host} is not a private/local IPv4 address. Only 0.0.0.0, loopback (127.0.0.1), private (10.x.x.x, 172.16-31.x.x, 192.168.x.x), or link-local (169.254.x.x) addresses are allowed.`);
+    throw new Error(`FAMILIAROS_IPC_BIND host ${host} is not a private/local IPv4 address. Only 0.0.0.0, loopback (127.0.0.1), private (10.x.x.x, 172.16-31.x.x, 192.168.x.x), or link-local (169.254.x.x) addresses are allowed.`);
   }
 }
 
@@ -203,8 +203,8 @@ function isPrivateOrLocalIpv4(host: string): boolean {
   return false;
 }
 
-export function writeDiscoveryFile(endpoint: string, token: string): OpenPetsDiscoveryFile {
-  const discovery: OpenPetsDiscoveryFile = {
+export function writeDiscoveryFile(endpoint: string, token: string): FamiliarOSDiscoveryFile {
+  const discovery: FamiliarOSDiscoveryFile = {
     protocolVersion: openPetsIpcVersion,
     protocol: openPetsIpcProtocol,
     endpoint,
@@ -225,11 +225,11 @@ export function writeDiscoveryFile(endpoint: string, token: string): OpenPetsDis
   return discovery;
 }
 
-export function removeDiscoveryFile(discovery: OpenPetsDiscoveryFile | null): void {
+export function removeDiscoveryFile(discovery: FamiliarOSDiscoveryFile | null): void {
   if (!discovery) return;
   const path = getDiscoveryFilePath();
   try {
-    const current = JSON.parse(readFileSync(path, "utf8")) as Partial<OpenPetsDiscoveryFile>;
+    const current = JSON.parse(readFileSync(path, "utf8")) as Partial<FamiliarOSDiscoveryFile>;
     if (current.pid !== discovery.pid || current.token !== discovery.token || current.endpoint !== discovery.endpoint) {
       return;
     }
@@ -258,10 +258,10 @@ export function protectUnixSocket(endpoint: string): void {
 function getSocketRuntimeDir(): string {
   const xdg = process.platform === "linux" ? getSecureXdgRuntimeDir() : null;
   if (xdg) {
-    return join(xdg, "openpets");
+    return join(xdg, "familiaros");
   }
 
-  return join("/tmp", `openpets-${getUserIdForPath()}`);
+  return join("/tmp", `familiaros-${getUserIdForPath()}`);
 }
 
 function getSecureXdgRuntimeDir(): string | null {
@@ -282,17 +282,17 @@ function getSecureXdgRuntimeDir(): string | null {
 function ensurePrivateRuntimeDir(dir: string): void {
   const stat = lstatSync(dir);
   if (!stat.isDirectory() || stat.isSymbolicLink()) {
-    throw new Error(`OpenPets IPC runtime path is not a safe directory: ${dir}`);
+    throw new Error(`FamiliarOS IPC runtime path is not a safe directory: ${dir}`);
   }
 
   if (typeof process.getuid === "function" && stat.uid !== process.getuid()) {
-    throw new Error(`OpenPets IPC runtime directory is not owned by the current user: ${dir}`);
+    throw new Error(`FamiliarOS IPC runtime directory is not owned by the current user: ${dir}`);
   }
 
   try { chmodSync(dir, 0o700); } catch { /* best effort */ }
   const updated = lstatSync(dir);
   if ((updated.mode & 0o777) !== 0o700) {
-    throw new Error(`OpenPets IPC runtime directory is not private: ${dir}`);
+    throw new Error(`FamiliarOS IPC runtime directory is not private: ${dir}`);
   }
 }
 
diff --git a/apps/desktop/src/local-ipc-protocol.ts b/apps/desktop/src/local-ipc-protocol.ts
index 1ab97367..a95c9e5d 100644
--- a/apps/desktop/src/local-ipc-protocol.ts
+++ b/apps/desktop/src/local-ipc-protocol.ts
@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 
-export const openPetsIpcProtocol = "openpets-ipc";
+export const openPetsIpcProtocol = "familiaros-ipc";
 export const openPetsIpcVersion = 1;
 export const maxIpcMessageBytes = 16 * 1024;
 export const transientDisplayMs = 4_000;
@@ -26,19 +26,19 @@ export const allowedMemoryKinds = [
   "note",
 ] as const;
 
-export type OpenPetsReaction = typeof allowedReactions[number];
-export type OpenPetsMemoryKind = typeof allowedMemoryKinds[number];
-export type OpenPetsIpcMethod = "hello" | "status" | "pets.list" | "pets.install" | "lease.acquire" | "lease.heartbeat" | "lease.release" | "pet.react" | "pet.say" | "memory.list" | "memory.search" | "memory.store" | "memory.delete";
+export type FamiliarOSReaction = typeof allowedReactions[number];
+export type FamiliarOSMemoryKind = typeof allowedMemoryKinds[number];
+export type FamiliarOSIpcMethod = "hello" | "status" | "familiars.list" | "familiars.install" | "lease.acquire" | "lease.heartbeat" | "lease.release" | "familiar.react" | "familiar.say" | "memory.list" | "memory.search" | "memory.store" | "memory.delete";
 
-export interface OpenPetsIpcRequest {
+export interface FamiliarOSIpcRequest {
   readonly id: string;
   readonly version: number;
   readonly token: string;
-  readonly method: OpenPetsIpcMethod;
+  readonly method: FamiliarOSIpcMethod;
   readonly params?: unknown;
 }
 
-export interface OpenPetsIpcResponse {
+export interface FamiliarOSIpcResponse {
   readonly id: string | null;
   readonly ok: boolean;
   readonly result?: unknown;
@@ -52,7 +52,7 @@ export function createRequestId(): string {
   return randomUUID();
 }
 
-export function parseIpcRequest(raw: string, expectedToken: string): OpenPetsIpcRequest {
+export function parseIpcRequest(raw: string, expectedToken: string): FamiliarOSIpcRequest {
   let parsed: unknown;
   try {
     parsed = JSON.parse(raw) as unknown;
@@ -63,7 +63,7 @@ export function parseIpcRequest(raw: string, expectedToken: string): OpenPetsIpc
   if (typeof parsed.id !== "string" || parsed.id.length < 1 || parsed.id.length > 120) throw new IpcProtocolError("invalid_request", "IPC request id is invalid.");
   if (parsed.version !== openPetsIpcVersion) throw new IpcProtocolError("invalid_version", "Unsupported IPC protocol version.");
   if (parsed.token !== expectedToken) throw new IpcProtocolError("invalid_token", "Invalid IPC token.");
-  if (parsed.method !== "hello" && parsed.method !== "status" && parsed.method !== "pets.list" && parsed.method !== "pets.install" && parsed.method !== "lease.acquire" && parsed.method !== "lease.heartbeat" && parsed.method !== "lease.release" && parsed.method !== "pet.react" && parsed.method !== "pet.say" && parsed.method !== "memory.list" && parsed.method !== "memory.search" && parsed.method !== "memory.store" && parsed.method !== "memory.delete") {
+  if (parsed.method !== "hello" && parsed.method !== "status" && parsed.method !== "familiars.list" && parsed.method !== "familiars.install" && parsed.method !== "lease.acquire" && parsed.method !== "lease.heartbeat" && parsed.method !== "lease.release" && parsed.method !== "familiar.react" && parsed.method !== "familiar.say" && parsed.method !== "memory.list" && parsed.method !== "memory.search" && parsed.method !== "memory.store" && parsed.method !== "memory.delete") {
     throw new IpcProtocolError("unknown_method", "Unknown IPC method.");
   }
 
@@ -78,16 +78,16 @@ export function parseIpcRequest(raw: string, expectedToken: string): OpenPetsIpc
 
 export function validateInstallPetId(value: unknown): string {
   if (typeof value !== "string" || !/^[a-z0-9][a-z0-9_-]{0,63}$/.test(value) || value === "builtin") {
-    throw new IpcProtocolError("invalid_params", "Invalid pet id.");
+    throw new IpcProtocolError("invalid_params", "Invalid familiar id.");
   }
   return value;
 }
 
-export function validateReaction(value: unknown): OpenPetsReaction {
-  if (typeof value !== "string" || !allowedReactions.includes(value as OpenPetsReaction)) {
-    throw new IpcProtocolError("invalid_params", "Invalid pet reaction.");
+export function validateReaction(value: unknown): FamiliarOSReaction {
+  if (typeof value !== "string" || !allowedReactions.includes(value as FamiliarOSReaction)) {
+    throw new IpcProtocolError("invalid_params", "Invalid familiar reaction.");
   }
-  return value as OpenPetsReaction;
+  return value as FamiliarOSReaction;
 }
 
 export function validateSayMessage(value: unknown): string {
@@ -112,23 +112,23 @@ export function validateOptionalLeaseId(value: unknown): string | undefined {
 
 export function validateRequestedPetId(value: unknown): string | undefined {
   if (value === undefined) return undefined;
-  if (typeof value !== "string") throw new IpcProtocolError("invalid_params", "Requested pet id must be a string.");
+  if (typeof value !== "string") throw new IpcProtocolError("invalid_params", "Requested familiar id must be a string.");
   const trimmed = value.trim();
   if (trimmed.length < 1) return undefined;
   if (Buffer.byteLength(trimmed, "utf8") > 128 || /[\x00-\x1F\x7F/\\]/.test(trimmed)) {
-    throw new IpcProtocolError("invalid_params", "Requested pet id is outside CLI bounds.");
+    throw new IpcProtocolError("invalid_params", "Requested familiar id is outside CLI bounds.");
   }
   return trimmed;
 }
 
-export function validateMemoryKind(value: unknown): OpenPetsMemoryKind {
-  if (typeof value !== "string" || !allowedMemoryKinds.includes(value as OpenPetsMemoryKind)) {
+export function validateMemoryKind(value: unknown): FamiliarOSMemoryKind {
+  if (typeof value !== "string" || !allowedMemoryKinds.includes(value as FamiliarOSMemoryKind)) {
     throw new IpcProtocolError("invalid_params", "Invalid memory kind.");
   }
-  return value as OpenPetsMemoryKind;
+  return value as FamiliarOSMemoryKind;
 }
 
-export function validateOptionalMemoryKind(value: unknown): OpenPetsMemoryKind | undefined {
+export function validateOptionalMemoryKind(value: unknown): FamiliarOSMemoryKind | undefined {
   if (value === undefined) return undefined;
   return validateMemoryKind(value);
 }
@@ -198,11 +198,11 @@ export function validateMemoryLimit(value: unknown, fallback: number, max = 25):
   return rounded;
 }
 
-export function okResponse(id: string | null, result: unknown): OpenPetsIpcResponse {
+export function okResponse(id: string | null, result: unknown): FamiliarOSIpcResponse {
   return { id, ok: true, result };
 }
 
-export function errorResponse(id: string | null, error: unknown): OpenPetsIpcResponse {
+export function errorResponse(id: string | null, error: unknown): FamiliarOSIpcResponse {
   if (error instanceof IpcProtocolError) {
     return { id, ok: false, error: { code: error.code, message: error.message } };
   }
diff --git a/apps/desktop/src/local-ipc.ts b/apps/desktop/src/local-ipc.ts
index 5cd1614a..2b7b42da 100644
--- a/apps/desktop/src/local-ipc.ts
+++ b/apps/desktop/src/local-ipc.ts
@@ -1,19 +1,19 @@
 import { randomBytes } from "node:crypto";
 import net from "node:net";
 
-import { applyAgentPetReaction, applyAgentPetSay, clearAgentPetLeaseState, showAgentPet } from "./agent-pet-controller.js";
-import { getAppStateSnapshot, recordOpenPetsActivity } from "./app-state.js";
-import { builtInPet } from "./built-in-pet.js";
-import { applyExternalPetReaction, applyExternalPetSay, getDefaultPetPaused, isDefaultPetVisible } from "./default-pet-controller.js";
+import { applyAgentPetReaction, applyAgentPetSay, clearAgentPetLeaseState, showAgentPet } from "./agent-familiar-controller.js";
+import { getAppStateSnapshot, recordFamiliarOSActivity } from "./app-state.js";
+import { builtInPet } from "./built-in-familiar.js";
+import { applyExternalPetReaction, applyExternalPetSay, getDefaultPetPaused, isDefaultPetVisible } from "./default-familiar-controller.js";
 import { createStaleLeaseStatus, LeaseManager } from "./lease-manager.js";
 import { debug, error as logError, info } from "./logger.js";
-import { cleanupUnixSocket, getDiscoveryFilePath, getIpcEndpointConfig, parseIpcEndpoint, protectUnixSocket, removeDiscoveryFile, writeDiscoveryFile, type IpcEndpoint, type IpcEndpointConfig, type OpenPetsDiscoveryFile } from "./local-ipc-paths.js";
-import { errorResponse, IpcProtocolError, isRecord, maxIpcMessageBytes, okResponse, parseIpcRequest, validateInstallPetId, validateMemoryId, validateMemoryImportance, validateMemoryLimit, validateMemoryQuery, validateMemoryTags, validateMemoryText, validateOptionalLeaseId, validateOptionalMemoryKind, validateReaction, validateRequestedPetId, validateSayMessage, type OpenPetsIpcRequest } from "./local-ipc-protocol.js";
-import { forgetOpenPetsMemory, listOpenPetsMemories, searchOpenPetsMemories, storeOpenPetsMemory } from "./openpets-memory.js";
-import { installPet } from "./pet-installation.js";
+import { cleanupUnixSocket, getDiscoveryFilePath, getIpcEndpointConfig, parseIpcEndpoint, protectUnixSocket, removeDiscoveryFile, writeDiscoveryFile, type IpcEndpoint, type IpcEndpointConfig, type FamiliarOSDiscoveryFile } from "./local-ipc-paths.js";
+import { errorResponse, IpcProtocolError, isRecord, maxIpcMessageBytes, okResponse, parseIpcRequest, validateInstallPetId, validateMemoryId, validateMemoryImportance, validateMemoryLimit, validateMemoryQuery, validateMemoryTags, validateMemoryText, validateOptionalLeaseId, validateOptionalMemoryKind, validateReaction, validateRequestedPetId, validateSayMessage, type FamiliarOSIpcRequest } from "./local-ipc-protocol.js";
+import { forgetFamiliarOSMemory, listFamiliarOSMemories, searchFamiliarOSMemories, storeFamiliarOSMemory } from "./familiaros-memory.js";
+import { installPet } from "./familiar-installation.js";
 
 let ipcServer: net.Server | null = null;
-let ipcDiscovery: OpenPetsDiscoveryFile | null = null;
+let ipcDiscovery: FamiliarOSDiscoveryFile | null = null;
 let leaseCleanupTimer: NodeJS.Timeout | null = null;
 const leaseManager = new LeaseManager({
   resolveTarget: resolveLeaseTarget,
@@ -39,7 +39,7 @@ export async function startLocalIpcServer(): Promise<void> {
   const server = net.createServer((socket) => handleSocket(socket, token, endpointConfig));
   server.on("error", (error) => {
     logError("ipc", "server error", error);
-    console.error("OpenPets local IPC server error.", error);
+    console.error("FamiliarOS local IPC server error.", error);
   });
 
   await new Promise<void>((resolve, reject) => {
@@ -57,7 +57,7 @@ export async function startLocalIpcServer(): Promise<void> {
   leaseCleanupTimer = setInterval(() => leaseManager.cleanupExpired(), 5_000);
   leaseCleanupTimer.unref?.();
   info("ipc", "server started", { endpointKind: endpointConfig.bindEndpoint.kind, bindEndpoint: formatEndpoint(endpointConfig.bindEndpoint), advertisedEndpoint: listeningEndpoint, discoveryPath: getDiscoveryFilePath() });
-  console.log(`OpenPets local IPC listening at ${listeningEndpoint}.`);
+  console.log(`FamiliarOS local IPC listening at ${listeningEndpoint}.`);
 }
 
 export function stopLocalIpcServer(): void {
@@ -117,7 +117,7 @@ function handleSocket(socket: net.Socket, token: string, endpointConfig: IpcEndp
   socket.on("error", (error) => {
     if (isBenignSocketCloseError(error)) return;
     logError("ipc", "client socket error", error);
-    console.error("OpenPets local IPC client socket error.", error);
+    console.error("FamiliarOS local IPC client socket error.", error);
   });
 }
 
@@ -217,11 +217,11 @@ async function handleRawRequest(raw: string, token: string) {
   }
 }
 
-async function handleRequest(request: OpenPetsIpcRequest): Promise<unknown> {
+async function handleRequest(request: FamiliarOSIpcRequest): Promise<unknown> {
   if (request.method === "hello") {
     return {
       ok: true,
-      protocol: "openpets-ipc",
+      protocol: "familiaros-ipc",
       protocolVersion: 1,
       appVersion: ipcDiscovery?.appVersion ?? "0.0.0",
     };
@@ -236,7 +236,7 @@ async function handleRequest(request: OpenPetsIpcRequest): Promise<unknown> {
       return { ok: true, appRunning: true, ...lease };
     }
     const state = getAppStateSnapshot();
-    const defaultPet = state.pets.installed.find((pet) => pet.id === state.preferences.defaultPetId) ?? builtInPet;
+    const defaultPet = state.familiars.installed.find((familiar) => familiar.id === state.preferences.defaultPetId) ?? builtInPet;
     return {
       ok: true,
       appRunning: true,
@@ -255,26 +255,26 @@ async function handleRequest(request: OpenPetsIpcRequest): Promise<unknown> {
     };
   }
 
-  if (request.method === "pets.list") {
+  if (request.method === "familiars.list") {
     const state = getAppStateSnapshot();
     return {
       ok: true,
-      pets: state.pets.installed.map((pet) => ({
-        id: pet.id,
-        displayName: pet.displayName,
-        builtIn: pet.builtIn,
-        broken: pet.broken === true,
+      familiars: state.familiars.installed.map((familiar) => ({
+        id: familiar.id,
+        displayName: familiar.displayName,
+        builtIn: familiar.builtIn,
+        broken: familiar.broken === true,
       })),
       defaultPetId: state.preferences.defaultPetId,
     };
   }
 
-  if (request.method === "pets.install") {
+  if (request.method === "familiars.install") {
     const params = isRecord(request.params) ? request.params : {};
     const petId = validateInstallPetId(params.petId);
     const state = await installPet(petId);
-    const installed = state.pets.installed.find((pet) => pet.id === petId);
-    if (!installed) throw new IpcProtocolError("install_failed", "Pet install did not complete.");
+    const installed = state.familiars.installed.find((familiar) => familiar.id === petId);
+    if (!installed) throw new IpcProtocolError("install_failed", "Familiar install did not complete.");
     return { ok: true, petId: installed.id, displayName: installed.displayName, installed: true };
   }
 
@@ -309,7 +309,7 @@ async function handleRequest(request: OpenPetsIpcRequest): Promise<unknown> {
     debug("ipc", "memory list requested", { requestId: request.id, limit });
     return {
       ok: true,
-      memories: listOpenPetsMemories(limit),
+      memories: listFamiliarOSMemories(limit),
     };
   }
 
@@ -321,7 +321,7 @@ async function handleRequest(request: OpenPetsIpcRequest): Promise<unknown> {
     return {
       ok: true,
       query,
-      memories: searchOpenPetsMemories(query, limit),
+      memories: searchFamiliarOSMemories(query, limit),
     };
   }
 
@@ -334,7 +334,7 @@ async function handleRequest(request: OpenPetsIpcRequest): Promise<unknown> {
     debug("ipc", "memory store requested", { requestId: request.id, kind, hasTags: Array.isArray(tags) && tags.length > 0, importance });
     return {
       ok: true,
-      memory: storeOpenPetsMemory({
+      memory: storeFamiliarOSMemory({
         text,
         kind,
         tags,
@@ -350,25 +350,25 @@ async function handleRequest(request: OpenPetsIpcRequest): Promise<unknown> {
     debug("ipc", "memory delete requested", { requestId: request.id, id });
     return {
       ok: true,
-      deleted: forgetOpenPetsMemory(id),
+      deleted: forgetFamiliarOSMemory(id),
       id,
     };
   }
 
-  if (request.method === "pet.react") {
+  if (request.method === "familiar.react") {
     const params = isRecord(request.params) ? request.params : {};
     const reaction = validateReaction(params.reaction);
     const lease = getLeaseTarget(params.leaseId);
     const petId = lease?.actualTargetPetId ?? getCurrentDefaultPet().id;
-    debug("ipc", "pet react requested", { requestId: request.id, reaction, leaseId: lease?.leaseId, targetKind: lease?.targetKind, actualPetId: lease?.actualTargetPetId });
+    debug("ipc", "familiar react requested", { requestId: request.id, reaction, leaseId: lease?.leaseId, targetKind: lease?.targetKind, actualPetId: lease?.actualTargetPetId });
     if (lease?.targetKind === "explicit") {
       if (getDefaultPetPaused()) return { ok: true, reaction, shown: false, reason: "paused", leaseId: lease.leaseId };
       const applied = applyAgentPetReaction(lease.actualTargetPetId, reaction);
-      safeRecordOpenPetsActivity({ kind: "react", reaction, petId });
+      safeRecordFamiliarOSActivity({ kind: "react", reaction, petId });
       return { ok: true, reaction, shown: applied.shown, reason: applied.reason, leaseId: lease.leaseId };
     }
     const applied = applyExternalPetReaction(reaction);
-    safeRecordOpenPetsActivity({ kind: "react", reaction, petId });
+    safeRecordFamiliarOSActivity({ kind: "react", reaction, petId });
     return { ok: true, reaction, shown: applied.shown, reason: applied.reason };
   }
 
@@ -377,21 +377,21 @@ async function handleRequest(request: OpenPetsIpcRequest): Promise<unknown> {
   const reaction = params.reaction === undefined ? undefined : validateReaction(params.reaction);
   const lease = getLeaseTarget(params.leaseId);
   const petId = lease?.actualTargetPetId ?? getCurrentDefaultPet().id;
-  debug("ipc", "pet say requested", { requestId: request.id, reaction, messageLength: message.length, leaseId: lease?.leaseId, targetKind: lease?.targetKind, actualPetId: lease?.actualTargetPetId });
+  debug("ipc", "familiar say requested", { requestId: request.id, reaction, messageLength: message.length, leaseId: lease?.leaseId, targetKind: lease?.targetKind, actualPetId: lease?.actualTargetPetId });
   if (lease?.targetKind === "explicit") {
     if (getDefaultPetPaused()) return { ok: true, shown: false, reason: "paused", reaction, leaseId: lease.leaseId };
     const applied = applyAgentPetSay(lease.actualTargetPetId, message, reaction);
-    safeRecordOpenPetsActivity({ kind: "say", reaction, petId });
+    safeRecordFamiliarOSActivity({ kind: "say", reaction, petId });
     return { ok: true, shown: applied.shown, reason: applied.reason, reaction, leaseId: lease.leaseId };
   }
   const applied = applyExternalPetSay(message, reaction);
-  safeRecordOpenPetsActivity({ kind: "say", reaction, petId });
+  safeRecordFamiliarOSActivity({ kind: "say", reaction, petId });
   return { ok: true, shown: applied.shown, reason: applied.reason, reaction };
 }
 
-function safeRecordOpenPetsActivity(activity: Parameters<typeof recordOpenPetsActivity>[0]): void {
+function safeRecordFamiliarOSActivity(activity: Parameters<typeof recordFamiliarOSActivity>[0]): void {
   try {
-    recordOpenPetsActivity(activity);
+    recordFamiliarOSActivity(activity);
   } catch (error) {
     debug("ipc", "activity record failed", { error: error instanceof Error ? error.message : String(error), kind: activity.kind, reaction: activity.reaction, petId: activity.petId });
   }
@@ -433,24 +433,24 @@ function resolveLeaseTarget(requestedPetId: string | undefined): { readonly targ
   if (!safePetIdPattern.test(requestedPetId)) {
     return { targetKind: "default", actualPetId: defaultPet.id, fallbackReason: "invalid_pet_id" };
   }
-  const pet = getAppStateSnapshot().pets.installed.find((candidate) => candidate.id === requestedPetId);
-  if (!pet) return { targetKind: "default", actualPetId: defaultPet.id, fallbackReason: "pet_not_installed" };
-  if (pet.broken) return { targetKind: "default", actualPetId: defaultPet.id, fallbackReason: "pet_broken" };
-  return { targetKind: "explicit", actualPetId: pet.id };
+  const familiar = getAppStateSnapshot().familiars.installed.find((candidate) => candidate.id === requestedPetId);
+  if (!familiar) return { targetKind: "default", actualPetId: defaultPet.id, fallbackReason: "pet_not_installed" };
+  if (familiar.broken) return { targetKind: "default", actualPetId: defaultPet.id, fallbackReason: "pet_broken" };
+  return { targetKind: "explicit", actualPetId: familiar.id };
 }
 
 function getCurrentDefaultPet(): { readonly id: string; readonly displayName: string } {
-  const pet = getCurrentDefaultPetWithFallback();
-  return { id: pet.id, displayName: pet.displayName };
+  const familiar = getCurrentDefaultPetWithFallback();
+  return { id: familiar.id, displayName: familiar.displayName };
 }
 
 function getCurrentDefaultPetWithFallback(): { readonly id: string; readonly displayName: string; readonly fallbackReason?: "default_broken_fallback_builtin" } {
   const state = getAppStateSnapshot();
-  const configuredDefault = state.pets.installed.find((pet) => pet.id === state.preferences.defaultPetId);
+  const configuredDefault = state.familiars.installed.find((familiar) => familiar.id === state.preferences.defaultPetId);
   if (configuredDefault && !configuredDefault.broken) return configuredDefault;
   return { ...builtInPet, fallbackReason: "default_broken_fallback_builtin" };
 }
 
 function getPetDisplayName(petId: string): string {
-  return getAppStateSnapshot().pets.installed.find((pet) => pet.id === petId)?.displayName ?? petId;
+  return getAppStateSnapshot().familiars.installed.find((familiar) => familiar.id === petId)?.displayName ?? petId;
 }
diff --git a/apps/desktop/src/logger.ts b/apps/desktop/src/logger.ts
index f61c5df5..e8707905 100644
--- a/apps/desktop/src/logger.ts
+++ b/apps/desktop/src/logger.ts
@@ -4,24 +4,24 @@ import { appendFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 
 export type LogLevel = "debug" | "info" | "warn" | "error";
-export type LogScope = "app" | "ipc" | "lease" | "pet.default" | "pet.agent" | "pet.window" | "plugin" | "state" | "tray" | "tts" | "ui";
+export type LogScope = "app" | "ipc" | "lease" | "familiar.default" | "familiar.agent" | "familiar.window" | "plugin" | "state" | "tray" | "tts" | "ui";
 
 type LogFields = Record<string, unknown>;
 
 const levelPriority = { debug: 10, info: 20, warn: 30, error: 40 } as const satisfies Record<LogLevel, number>;
 const maxLogBytes = 2 * 1024 * 1024;
 
-let configuredLevel: LogLevel = normalizeLogLevel(process.env.OPENPETS_LOG_LEVEL) ?? "debug";
+let configuredLevel: LogLevel = normalizeLogLevel(process.env.FAMILIAROS_LOG_LEVEL) ?? "debug";
 let logFilePath: string | null = null;
 let previousLogFilePath: string | null = null;
-let mirrorToConsole = isDevRun() || process.env.OPENPETS_LOG_CONSOLE === "1";
+let mirrorToConsole = isDevRun() || process.env.FAMILIAROS_LOG_CONSOLE === "1";
 
 export function initializeLogger(): void {
   try {
     const logsDir = getLogsDir();
     mkdirSync(logsDir, { recursive: true });
-    logFilePath = join(logsDir, "openpets.log");
-    previousLogFilePath = join(logsDir, "openpets.previous.log");
+    logFilePath = join(logsDir, "familiaros.log");
+    previousLogFilePath = join(logsDir, "familiaros.previous.log");
     rotateCurrentLog(logFilePath, previousLogFilePath);
     writeFileSync(logFilePath, "", { flag: "a" });
     info("app", "logger initialized", { logFile: logFilePath, previousLogFile: previousLogFilePath, level: configuredLevel, console: mirrorToConsole });
@@ -29,7 +29,7 @@ export function initializeLogger(): void {
     const message = initError instanceof Error ? initError.message : String(initError);
     logFilePath = null;
     previousLogFilePath = null;
-    console.error("OpenPets file logger unavailable; continuing without log file.", message);
+    console.error("FamiliarOS file logger unavailable; continuing without log file.", message);
   }
 }
 
@@ -87,7 +87,7 @@ function writeLog(level: LogLevel, scope: LogScope, message: string, fields: Log
 
   if (!logFilePath) return;
   void appendFile(logFilePath, line, "utf8").catch((appendError: unknown) => {
-    if (mirrorToConsole) console.error("Failed to write OpenPets log file.", appendError);
+    if (mirrorToConsole) console.error("Failed to write FamiliarOS log file.", appendError);
   });
 }
 
@@ -96,10 +96,10 @@ function rotateCurrentLog(currentPath: string, previousPath: string): void {
   try {
     const current = statSync(currentPath);
     if (current.size <= 0) return;
-    if (existsSync(previousPath)) renameSync(previousPath, join(dirname(previousPath), "openpets.previous.old.log"));
+    if (existsSync(previousPath)) renameSync(previousPath, join(dirname(previousPath), "familiaros.previous.old.log"));
     renameSync(currentPath, previousPath);
   } catch (rotationError: unknown) {
-    if (mirrorToConsole) console.error("Failed to rotate OpenPets log file.", rotationError);
+    if (mirrorToConsole) console.error("Failed to rotate FamiliarOS log file.", rotationError);
   }
 }
 
@@ -109,7 +109,7 @@ function normalizeLogLevel(value: string | undefined): LogLevel | null {
 }
 
 function isDevRun(): boolean {
-  return process.env.OPENPETS_DEV === "1" || process.env.NODE_ENV === "development" || !app.isPackaged;
+  return process.env.FAMILIAROS_DEV === "1" || process.env.NODE_ENV === "development" || !app.isPackaged;
 }
 
 function formatFields(fields: LogFields | undefined): string {
diff --git a/apps/desktop/src/main.ts b/apps/desktop/src/main.ts
index a11e606f..b3deaef0 100644
--- a/apps/desktop/src/main.ts
+++ b/apps/desktop/src/main.ts
@@ -5,13 +5,13 @@ import { delimiter, join, resolve } from "node:path";
 import { getAppStateSnapshot, initializeAppState, releaseStartupInstallLock } from "./app-state.js";
 import { createAppIcon } from "./assets.js";
 import { setLocaleFromPreference } from "./i18n/index.js";
-import { installDefaultPetDisplayHandlers, shouldOpenDefaultPetOnLaunch, showDefaultPet } from "./default-pet-controller.js";
+import { installDefaultPetDisplayHandlers, shouldOpenDefaultPetOnLaunch, showDefaultPet } from "./default-familiar-controller.js";
 import { installAppLifecycle } from "./lifecycle.js";
 import { debug, error as logError, getLogFilePath, info, initializeLogger, warn } from "./logger.js";
 import { startLocalIpcServer } from "./local-ipc.js";
 import { startDevPluginWatcher } from "./plugin-dev-watcher.js";
 import { createElectronPluginHostCapabilities } from "./plugin-host-capabilities.js";
-import { defaultPluginPetApi } from "./plugin-pet-api.js";
+import { defaultPluginPetApi } from "./plugin-familiar-api.js";
 import { initializePluginPlatformSettings } from "./plugin-platform-settings.js";
 import { ElectronPluginJsHost } from "./plugin-js-host.js";
 import { initializePluginService } from "./plugin-service.js";
@@ -20,14 +20,14 @@ import { createAppTray, refreshTrayMenu } from "./tray.js";
 import { checkForGitHubReleaseUpdate } from "./update-checker.js";
 import { installInternalUiHandlers, installInternalUiProtocol } from "./windows.js";
 
-// OpenPets does not store browser passwords, cookies, or encrypted app secrets.
+// FamiliarOS does not store browser passwords, cookies, or encrypted app secrets.
 // Keep Chromium/Electron from prompting for macOS Keychain or Linux keyring access
 // during startup/profile initialization.
 app.commandLine.appendSwitch("use-mock-keychain");
 app.commandLine.appendSwitch("password-store", "basic");
 
 // GNOME Wayland does not allow Electron apps to reliably control window
-// z-order or absolute position, which breaks the desktop-pet contract: staying
+// z-order or absolute position, which breaks the desktop-familiar contract: staying
 // above normal windows and dragging to a user-chosen screen position. Prefer
 // X11/Xwayland on Linux unless the user explicitly chooses another Ozone
 // backend at launch.
@@ -44,9 +44,9 @@ if (!gotSingleInstanceLock) {
 
   app.whenReady().then(async () => {
     initializeLogger();
-    app.setName("OpenPets");
+    app.setName("FamiliarOS");
     if (process.platform === "win32") {
-      app.setAppUserModelId("dev.openpets.app");
+      app.setAppUserModelId("dev.familiaros.app");
     }
     info("app", "startup begin", { version: app.getVersion(), platform: process.platform, arch: process.arch, packaged: app.isPackaged, pid: process.pid, ozonePlatform: app.commandLine.getSwitchValue("ozone-platform") || null });
 
@@ -65,12 +65,12 @@ if (!gotSingleInstanceLock) {
     installDefaultPetDisplayHandlers({ onPromptRequested: openPromptWindow });
     await startLocalIpcServer();
     releaseStartupInstallLock();
-    const roots = parseDevPluginEnv(process.env.OPENPETS_DEV_PLUGIN_ROOTS);
-    const paths = parseDevPluginEnv(process.env.OPENPETS_DEV_PLUGIN_PATHS);
+    const roots = parseDevPluginEnv(process.env.FAMILIAROS_DEV_PLUGIN_ROOTS);
+    const paths = parseDevPluginEnv(process.env.FAMILIAROS_DEV_PLUGIN_PATHS);
     const devPluginMode = roots.length > 0 || paths.length > 0;
     initializePluginPlatformSettings(app.getPath("userData"));
     const pluginCapabilities = createElectronPluginHostCapabilities(app.getPath("userData"));
-    const pluginService = initializePluginService(app.getPath("userData"), defaultPluginPetApi, app.getVersion(), new ElectronPluginJsHost(), writePluginRuntimeLog, process.env.OPENPETS_DISABLE_PLUGIN_CATALOG === "1" || devPluginMode, resolveBundledOfficialPluginRoots(), !devPluginMode, pluginCapabilities);
+    const pluginService = initializePluginService(app.getPath("userData"), defaultPluginPetApi, app.getVersion(), new ElectronPluginJsHost(), writePluginRuntimeLog, process.env.FAMILIAROS_DISABLE_PLUGIN_CATALOG === "1" || devPluginMode, resolveBundledOfficialPluginRoots(), !devPluginMode, pluginCapabilities);
     // Wall-clock schedules (daily/cron/at) re-arm deterministically after sleep.
     powerMonitor.on("resume", () => pluginService.runtime.resyncSchedules());
     if (shouldOpenDefaultPetOnLaunch()) {
@@ -92,11 +92,11 @@ if (!gotSingleInstanceLock) {
     })().catch((error) => logError("app", "plugin service startup failed", error));
     void checkForGitHubReleaseUpdate().then(() => refreshTrayMenu());
     info("app", "startup complete", { logFile: getLogFilePath(), openDefaultPetOnLaunch: shouldOpenDefaultPetOnLaunch() });
-    console.log("OpenPets desktop shell ready.");
+    console.log("FamiliarOS desktop shell ready.");
   }).catch((error: unknown) => {
     releaseStartupInstallLock();
     logError("app", "startup failed", error);
-    console.error("Failed to start OpenPets desktop shell.", error);
+    console.error("Failed to start FamiliarOS desktop shell.", error);
     app.quit();
   });
 }
diff --git a/apps/desktop/src/mcp-chat-client.ts b/apps/desktop/src/mcp-chat-client.ts
index cee934ce..89724380 100644
--- a/apps/desktop/src/mcp-chat-client.ts
+++ b/apps/desktop/src/mcp-chat-client.ts
@@ -30,7 +30,7 @@ interface ServerSpawnConfig {
 }
 
 // Map of catalog entry IDs to spawn configurations for vanilla chat.
-// These are the servers OpenPets can spawn and manage internally.
+// These are the servers FamiliarOS can spawn and manage internally.
 function getVanillaChatServerConfigs(homeDir: string): Record<string, ServerSpawnConfig> {
   return {
     filesystem: {
@@ -126,7 +126,7 @@ class McpChatClientManager {
       env: config.env,
     });
 
-    const client = new Client({ name: "openpets-vanilla-chat", version: app.getVersion() });
+    const client = new Client({ name: "familiaros-vanilla-chat", version: app.getVersion() });
     await client.connect(transport);
 
     const toolsResult = await client.listTools();
diff --git a/apps/desktop/src/mcp-toolkit-installer.ts b/apps/desktop/src/mcp-toolkit-installer.ts
index d1d3c95e..cfabc56c 100644
--- a/apps/desktop/src/mcp-toolkit-installer.ts
+++ b/apps/desktop/src/mcp-toolkit-installer.ts
@@ -144,7 +144,7 @@ function getSupportedPersistentServers(): readonly McpToolkitServerDefinition[]
   const homeDir = app.getPath("home");
   return [
     {
-      id: "openpets-filesystem",
+      id: "familiaros-filesystem",
       name: "Filesystem",
       description: "Persistent filesystem access scoped to your home directory.",
       command: ["npx", "-y", "@modelcontextprotocol/server-filesystem", homeDir],
@@ -152,42 +152,42 @@ function getSupportedPersistentServers(): readonly McpToolkitServerDefinition[]
       note: "Scoped to your home directory by default. Narrow it later if you want a tighter boundary.",
     },
     {
-      id: "openpets-playwright",
+      id: "familiaros-playwright",
       name: "Playwright",
       description: "Browser automation and browser validation tools.",
       command: ["npx", "@playwright/mcp@latest"],
       requiredRuntime: "npx",
     },
     {
-      id: "openpets-memory",
+      id: "familiaros-memory",
       name: "Memory",
       description: "Persistent project-memory tools for the host agent.",
       command: ["npx", "-y", "@modelcontextprotocol/server-memory"],
       requiredRuntime: "npx",
     },
     {
-      id: "openpets-context7",
+      id: "familiaros-context7",
       name: "Context7 / Docs",
       description: "Up-to-date library and framework docs lookup.",
       command: ["npx", "-y", "@upstash/context7-mcp"],
       requiredRuntime: "npx",
     },
     {
-      id: "openpets-fetch",
+      id: "familiaros-fetch",
       name: "Fetch / Web",
       description: "Lightweight web retrieval without full browser automation.",
       command: ["uvx", "mcp-server-fetch"],
       requiredRuntime: "uvx",
     },
     {
-      id: "openpets-sequential-thinking",
+      id: "familiaros-sequential-thinking",
       name: "Sequential Thinking",
       description: "Structured planning and branching reasoning tools.",
       command: ["npx", "-y", "@modelcontextprotocol/server-sequential-thinking"],
       requiredRuntime: "npx",
     },
     {
-      id: "openpets-browser-use",
+      id: "familiaros-browser-use",
       name: "Browser Use",
       description: "Higher-level browser task execution for agentic web work.",
       command: ["uvx", "--from", "browser-use[cli]", "browser-use", "--mcp"],
diff --git a/apps/desktop/src/openapi-chat.ts b/apps/desktop/src/openapi-chat.ts
index ea18d959..2270d662 100644
--- a/apps/desktop/src/openapi-chat.ts
+++ b/apps/desktop/src/openapi-chat.ts
@@ -3,11 +3,11 @@ import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync
 import { dirname, join } from "node:path";
 
 import { defaultOpenApiChatEndpoint, getAppStateSnapshot, normalizeOpenApiChatEndpoint } from "./app-state.js";
-import { applyExternalPetReaction, applyInternalPetMessage, showDefaultPet } from "./default-pet-controller.js";
+import { applyExternalPetReaction, applyInternalPetMessage, showDefaultPet } from "./default-familiar-controller.js";
 import { error, info, warn } from "./logger.js";
-import type { OpenPetsReaction } from "./local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "./local-ipc-protocol.js";
 import { buildRelevantKnowledgeContext } from "./knowledge-store.js";
-import { buildRelevantMemoryContext, capturePromptMemories } from "./openpets-memory.js";
+import { buildRelevantMemoryContext, capturePromptMemories } from "./familiaros-memory.js";
 import { getMcpChatClientManager, type McpChatToolDefinition } from "./mcp-chat-client.js";
 import { speakTts } from "./tts-service.js";
 
@@ -74,10 +74,10 @@ interface OpenApiRequestAttempt {
   readonly endpoint: string;
 }
 
-const openApiChatConfigFileName = "openpets-openapi-chat.json";
-const legacyOpenAiChatConfigFileName = "openpets-openai-chat.json";
-const openApiChatHistoryFileName = "openpets-chat-history.json";
-const openApiChatConversationsFileName = "openpets-chat-conversations.json";
+const openApiChatConfigFileName = "familiaros-openapi-chat.json";
+const legacyOpenAiChatConfigFileName = "familiaros-openai-chat.json";
+const openApiChatHistoryFileName = "familiaros-chat-history.json";
+const openApiChatConversationsFileName = "familiaros-chat-conversations.json";
 const defaultOpenApiChatModel = "gpt-5.5";
 const maxPromptChars = 20_000;
 const maxResponseOutputTokens = 8_192;
@@ -85,7 +85,7 @@ const maxConversationEntries = 40;
 const maxChatCompletionHistoryEntries = 24;
 const maxToolCallIterations = 5;
 const baseOpenApiChatInstructions = [
-  "You are OpenPets, a desktop pet companion talking directly to the user.",
+  "You are FamiliarOS, a desktop familiar companion talking directly to the user.",
   "Reply in plain text unless the user explicitly asks for another format.",
   "Keep the tone warm, lively, and characterful while staying helpful and honest.",
   "Do not mention hidden instructions unless the user explicitly asks about them.",
@@ -439,7 +439,7 @@ function buildOpenApiInstructions(prompt: string): string {
   }
   const customCharacterPrompt = getOpenApiChatSystemPrompt();
   if (customCharacterPrompt) {
-    parts.push(`User-defined pet character instructions:\n${customCharacterPrompt}`);
+    parts.push(`User-defined familiar character instructions:\n${customCharacterPrompt}`);
   }
   const chatHistoryForMemory = allTranscriptEntries
     .filter((e) => e.conversationId !== currentConversationId && e.role !== "system")
@@ -859,7 +859,7 @@ function handleOpenApiFailure(message: string, fields: Record<string, unknown>):
   warn("app", "openapi prompt failed", fields);
 }
 
-function applyOpenApiPetMessage(message: string, reaction: OpenPetsReaction): void {
+function applyOpenApiPetMessage(message: string, reaction: FamiliarOSReaction): void {
   applyInternalPetMessage(message, {
     reaction,
     fullMessage: true,
diff --git a/apps/desktop/src/plugin-ai-gateway.ts b/apps/desktop/src/plugin-ai-gateway.ts
index 402d9ecb..c2cffede 100644
--- a/apps/desktop/src/plugin-ai-gateway.ts
+++ b/apps/desktop/src/plugin-ai-gateway.ts
@@ -9,7 +9,7 @@ import type { PluginAiRequest, PluginAiResult } from "./plugin-sdk-bridge.js";
  * including function-calling tools and token streaming.
  */
 
-export const hostSecretsOwner = "__openpets-host";
+export const hostSecretsOwner = "__familiaros-host";
 export const hostAiApiKeySecret = "ai-api-key";
 
 const defaultModels: Record<string, string> = {
@@ -60,7 +60,7 @@ export class PluginAiGateway {
 
   async #resolveProvider(): Promise<{ provider: "anthropic" | "openai" | "ollama"; model: string; baseUrl?: string; apiKey?: string }> {
     const settings = getPluginPlatformSettings().ai;
-    if (settings.provider === "none") throw new Error("No AI provider is configured in OpenPets settings.");
+    if (settings.provider === "none") throw new Error("No AI provider is configured in FamiliarOS settings.");
     const apiKey = await this.#secrets.get(hostSecretsOwner, hostAiApiKeySecret);
     if (settings.provider !== "ollama" && !apiKey) throw new Error("The configured AI provider has no API key.");
     return {
diff --git a/apps/desktop/src/plugin-assets.ts b/apps/desktop/src/plugin-assets.ts
index cf2db3a6..0d1b8745 100644
--- a/apps/desktop/src/plugin-assets.ts
+++ b/apps/desktop/src/plugin-assets.ts
@@ -1,7 +1,7 @@
 import { promises as fs } from "node:fs";
 import { join } from "node:path";
 
-import { pluginAssetMaxBytes, pluginPanelMaxBytes, type OpenPetsJavascriptPluginManifest, type PluginAssetKind } from "./plugin-manifest.js";
+import { pluginAssetMaxBytes, pluginPanelMaxBytes, type FamiliarOSJavascriptPluginManifest, type PluginAssetKind } from "./plugin-manifest.js";
 import { SUPPORTED_LOCALES } from "./i18n/catalog.js";
 
 /** Per-locale size cap for bundled `locales/<locale>.json` catalogs. */
@@ -16,7 +16,7 @@ export type DeclaredPluginFile = {
 };
 
 /** All bundled files a v3 plugin declares beyond manifest + entry. */
-export function collectDeclaredPluginFiles(manifest: OpenPetsJavascriptPluginManifest): DeclaredPluginFile[] {
+export function collectDeclaredPluginFiles(manifest: FamiliarOSJavascriptPluginManifest): DeclaredPluginFile[] {
   if (manifest.manifestVersion !== 3) return [];
   const files: DeclaredPluginFile[] = [];
   const kinds: PluginAssetKind[] = ["icons", "images", "svgs", "sprites", "sounds"];
@@ -34,7 +34,7 @@ export function collectDeclaredPluginFiles(manifest: OpenPetsJavascriptPluginMan
 /**
  * Install-time SVG sanitization (§6): strip script, foreignObject, event
  * handler attributes, and external/javascript references. The output is the
- * only SVG ever handed to a pet window.
+ * only SVG ever handed to a familiar window.
  */
 export function sanitizeSvgText(svg: string): string {
   let out = svg;
@@ -83,7 +83,7 @@ export function preparePluginFileBytes(file: DeclaredPluginFile, bytes: Buffer):
 }
 
 /** Read all declared files from a plugin source folder, validated and prepared. */
-export async function readDeclaredPluginFiles(manifest: OpenPetsJavascriptPluginManifest, realSourceFolder: string): Promise<Map<string, Buffer>> {
+export async function readDeclaredPluginFiles(manifest: FamiliarOSJavascriptPluginManifest, realSourceFolder: string): Promise<Map<string, Buffer>> {
   const out = new Map<string, Buffer>();
   for (const file of collectDeclaredPluginFiles(manifest)) {
     const filePath = join(realSourceFolder, file.relPath);
@@ -120,14 +120,14 @@ export async function writeDeclaredPluginFiles(targetDir: string, files: Readonl
 }
 
 /** Resolve a declared asset name to its on-disk path inside an install dir. */
-export function resolveDeclaredAssetPath(manifest: OpenPetsJavascriptPluginManifest, installPath: string, kind: PluginAssetKind, name: string): string {
+export function resolveDeclaredAssetPath(manifest: FamiliarOSJavascriptPluginManifest, installPath: string, kind: PluginAssetKind, name: string): string {
   const relPath = manifest.manifestVersion === 3 ? manifest.assets?.[kind]?.[name] : undefined;
   if (!relPath) throw new Error(`Plugin asset is not declared: ${kind}/${name}`);
   return join(installPath, relPath);
 }
 
 /** Resolve a declared panel name to its on-disk path inside an install dir. */
-export function resolveDeclaredPanelPath(manifest: OpenPetsJavascriptPluginManifest, installPath: string, name: string): string {
+export function resolveDeclaredPanelPath(manifest: FamiliarOSJavascriptPluginManifest, installPath: string, name: string): string {
   const relPath = manifest.manifestVersion === 3 ? manifest.panels?.[name] : undefined;
   if (!relPath) throw new Error(`Plugin panel is not declared: ${name}`);
   return join(installPath, relPath);
diff --git a/apps/desktop/src/plugin-bubble-arbiter.ts b/apps/desktop/src/plugin-bubble-arbiter.ts
index 1086b76e..38f514eb 100644
--- a/apps/desktop/src/plugin-bubble-arbiter.ts
+++ b/apps/desktop/src/plugin-bubble-arbiter.ts
@@ -2,7 +2,7 @@ import type { PluginBubbleCallbacks, PluginBubbleDescriptor, PluginBubbleDismiss
 
 /**
  * Bubble arbiter (§1.4/§1.5): with several enabled plugins all wanting the
- * bubble, this layer decides who is showing. Two slots per pet:
+ * bubble, this layer decides who is showing. Two slots per familiar:
  *
  * - transient — the rotating bubble; a priority queue with do-not-interrupt
  *   for sticky/urgent content and coalescing of identical back-to-back text.
@@ -22,7 +22,7 @@ export type ActiveBubble = {
 };
 
 export interface PetBubbleSink {
-  /** Render (or clear with null) a slot's content on the pet surface. */
+  /** Render (or clear with null) a slot's content on the familiar surface. */
   present(slot: ArbiterSlot, content: ActiveBubble | null): void;
 }
 
@@ -73,7 +73,7 @@ export class PetBubbleArbiter {
     };
   }
 
-  /** Routed from the pet window when a rendered bubble fires an action. */
+  /** Routed from the familiar window when a rendered bubble fires an action. */
   handleAction(token: string, actionId: string): void {
     const entry = this.#entries.get(token);
     if (!entry || entry.dismissed) return;
@@ -82,14 +82,14 @@ export class PetBubbleArbiter {
     if (!action || action.dismissesBubble) this.#finish(entry, "click");
   }
 
-  /** Routed from the pet window when a rendered bubble's input submits. */
+  /** Routed from the familiar window when a rendered bubble's input submits. */
   handleSubmit(token: string, values: Record<string, string | number>): void {
     const entry = this.#entries.get(token);
     if (!entry || entry.dismissed) return;
     entry.callbacks.onSubmit(values);
   }
 
-  /** Routed from the pet window when the user click-dismisses a bubble. */
+  /** Routed from the familiar window when the user click-dismisses a bubble. */
   handleDismissed(token: string): void {
     const entry = this.#entries.get(token);
     if (entry) this.#finish(entry, "click");
diff --git a/apps/desktop/src/plugin-catalog-validation.ts b/apps/desktop/src/plugin-catalog-validation.ts
index ac29822c..1caa919e 100644
--- a/apps/desktop/src/plugin-catalog-validation.ts
+++ b/apps/desktop/src/plugin-catalog-validation.ts
@@ -1,12 +1,12 @@
 import { canonicalizePluginPermissions, type PluginIcon, type PluginPermission, type KnownPluginRuntime } from "./plugin-manifest.js";
 
-export type PluginCatalogEntry = { readonly id: string; readonly name: string; readonly version: string; readonly description: string; readonly runtime: "declarative"; readonly icon?: PluginIcon; readonly permissions: readonly PluginPermission[]; readonly downloadUrl: string; readonly sha256: string; readonly minOpenPetsVersion?: string };
-export type PluginCatalogEntryV2 = Omit<PluginCatalogEntry, "runtime"> & { readonly runtime: KnownPluginRuntime; readonly sdkVersion?: string; readonly maxOpenPetsVersion?: string; readonly disabled?: boolean; readonly deprecated?: boolean; readonly statusReason?: string; readonly network?: { readonly hosts: readonly string[] } };
+export type PluginCatalogEntry = { readonly id: string; readonly name: string; readonly version: string; readonly description: string; readonly runtime: "declarative"; readonly icon?: PluginIcon; readonly permissions: readonly PluginPermission[]; readonly downloadUrl: string; readonly sha256: string; readonly minFamiliarOSVersion?: string };
+export type PluginCatalogEntryV2 = Omit<PluginCatalogEntry, "runtime"> & { readonly runtime: KnownPluginRuntime; readonly sdkVersion?: string; readonly maxFamiliarOSVersion?: string; readonly disabled?: boolean; readonly deprecated?: boolean; readonly statusReason?: string; readonly network?: { readonly hosts: readonly string[] } };
 export type PluginCatalog = { readonly version: 1; readonly generatedAt: string; readonly plugins: readonly PluginCatalogEntry[] } | { readonly version: 2; readonly generatedAt: string; readonly plugins: readonly PluginCatalogEntryV2[] };
 
 const catalogFields = new Set(["version", "generatedAt", "plugins"]);
-const entryFields = new Set(["id", "name", "version", "description", "runtime", "icon", "permissions", "downloadUrl", "sha256", "minOpenPetsVersion"]);
-const entryFieldsV2 = new Set([...entryFields, "sdkVersion", "maxOpenPetsVersion", "disabled", "deprecated", "statusReason", "network"]);
+const entryFields = new Set(["id", "name", "version", "description", "runtime", "icon", "permissions", "downloadUrl", "sha256", "minFamiliarOSVersion"]);
+const entryFieldsV2 = new Set([...entryFields, "sdkVersion", "maxFamiliarOSVersion", "disabled", "deprecated", "statusReason", "network"]);
 const idPattern = /^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/;
 const versionPattern = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
 const shaPattern = /^[0-9a-f]{64}$/;
@@ -27,14 +27,14 @@ export function validatePluginCatalog(input: unknown): PluginCatalog {
     if (seen.has(id)) throw new Error(`Duplicate plugin id: ${id}`);
     seen.add(id);
     const permissions = canonicalizePluginPermissions(entry.permissions);
-    const base = { id, name: requireString(entry.name, "name", 1, 120), version: requireString(entry.version, "version", 1, 80, versionPattern), description: requireString(entry.description, "description", 0, 1000), runtime: requireRuntime(entry.runtime, input.version), icon: normalizeIcon(entry.icon), permissions, downloadUrl: requireString(entry.downloadUrl, "downloadUrl", 1, 2048), sha256: requireString(entry.sha256, "sha256", 64, 64, shaPattern), minOpenPetsVersion: entry.minOpenPetsVersion === undefined ? undefined : requireString(entry.minOpenPetsVersion, "minOpenPetsVersion", 1, 80, versionPattern) };
+    const base = { id, name: requireString(entry.name, "name", 1, 120), version: requireString(entry.version, "version", 1, 80, versionPattern), description: requireString(entry.description, "description", 0, 1000), runtime: requireRuntime(entry.runtime, input.version), icon: normalizeIcon(entry.icon), permissions, downloadUrl: requireString(entry.downloadUrl, "downloadUrl", 1, 2048), sha256: requireString(entry.sha256, "sha256", 64, 64, shaPattern), minFamiliarOSVersion: entry.minFamiliarOSVersion === undefined ? undefined : requireString(entry.minFamiliarOSVersion, "minFamiliarOSVersion", 1, 80, versionPattern) };
     if (input.version === 1) return base;
     const hasNetworkPermission = permissions.includes("network");
     if (base.runtime === "javascript" && entry.sdkVersion === undefined) throw new Error("Invalid plugin catalog sdkVersion.");
     if (base.runtime === "javascript" && permissions.includes("timer")) throw new Error("Invalid plugin catalog permissions.");
     if (hasNetworkPermission && entry.network === undefined) throw new Error("Invalid plugin catalog network.hosts.");
     if (!hasNetworkPermission && entry.network !== undefined) throw new Error("Invalid plugin catalog network.hosts.");
-    return { ...base, sdkVersion: entry.sdkVersion === undefined ? undefined : requireString(entry.sdkVersion, "sdkVersion", 1, 80, versionPattern), maxOpenPetsVersion: entry.maxOpenPetsVersion === undefined ? undefined : requireString(entry.maxOpenPetsVersion, "maxOpenPetsVersion", 1, 80, versionPattern), disabled: entry.disabled === undefined ? undefined : requireBoolean(entry.disabled, "disabled"), deprecated: entry.deprecated === undefined ? undefined : requireBoolean(entry.deprecated, "deprecated"), statusReason: entry.statusReason === undefined ? undefined : requireString(entry.statusReason, "statusReason", 1, 500), network: normalizeNetwork(entry.network) };
+    return { ...base, sdkVersion: entry.sdkVersion === undefined ? undefined : requireString(entry.sdkVersion, "sdkVersion", 1, 80, versionPattern), maxFamiliarOSVersion: entry.maxFamiliarOSVersion === undefined ? undefined : requireString(entry.maxFamiliarOSVersion, "maxFamiliarOSVersion", 1, 80, versionPattern), disabled: entry.disabled === undefined ? undefined : requireBoolean(entry.disabled, "disabled"), deprecated: entry.deprecated === undefined ? undefined : requireBoolean(entry.deprecated, "deprecated"), statusReason: entry.statusReason === undefined ? undefined : requireString(entry.statusReason, "statusReason", 1, 500), network: normalizeNetwork(entry.network) };
   });
   return { version: input.version, generatedAt: String(input.generatedAt), plugins } as PluginCatalog;
 }
diff --git a/apps/desktop/src/plugin-catalog.ts b/apps/desktop/src/plugin-catalog.ts
index 941f29e1..0011fd86 100644
--- a/apps/desktop/src/plugin-catalog.ts
+++ b/apps/desktop/src/plugin-catalog.ts
@@ -1,7 +1,7 @@
 import { validatePluginCatalog, type PluginCatalog, type PluginCatalogEntry, type PluginCatalogEntryV2 } from "./plugin-catalog-validation.js";
 
-export const pluginCatalogUrl = "https://openpets.dev/plugins/catalog.v2.json";
-export const pluginCatalogV1Url = "https://openpets.dev/plugins/catalog.v1.json";
+export const pluginCatalogUrl = "https://familiaros.dev/plugins/catalog.v2.json";
+export const pluginCatalogV1Url = "https://familiaros.dev/plugins/catalog.v1.json";
 export const pluginCatalogV2Url = pluginCatalogUrl;
 const maxCatalogBytes = 2 * 1024 * 1024;
 const catalogTimeoutMs = 15_000;
diff --git a/apps/desktop/src/plugin-config.ts b/apps/desktop/src/plugin-config.ts
index a24982f3..2367b5cd 100644
--- a/apps/desktop/src/plugin-config.ts
+++ b/apps/desktop/src/plugin-config.ts
@@ -1,4 +1,4 @@
-import type { OpenPetsPluginManifest, PluginConfigField } from "./plugin-manifest.js";
+import type { FamiliarOSPluginManifest, PluginConfigField } from "./plugin-manifest.js";
 import { isValidUserSoundId } from "./plugin-user-sound-store.js";
 
 export type PluginConfigValue = string | number | boolean | string[] | Array<Record<string, unknown>> | { kind: "user-sound"; id: string; name?: string } | null;
@@ -7,7 +7,7 @@ export type PluginConfig = Record<string, PluginConfigValue>;
 export type PluginConfigValidationError = { path: string; code: string; message: string };
 export type PluginConfigValidationResult = { ok: true; config: PluginConfig; errors: [] } | { ok: false; errors: PluginConfigValidationError[] };
 
-export function getPluginDefaultConfig(manifest: OpenPetsPluginManifest): PluginConfig {
+export function getPluginDefaultConfig(manifest: FamiliarOSPluginManifest): PluginConfig {
   const config: PluginConfig = {};
   for (const [key, field] of configSchemaEntries(manifest)) {
     if (isValidDefault(field)) config[key] = field.default;
@@ -15,15 +15,15 @@ export function getPluginDefaultConfig(manifest: OpenPetsPluginManifest): Plugin
   return config;
 }
 
-export function validatePluginConfigReplacement(manifest: OpenPetsPluginManifest, value: unknown): PluginConfigValidationResult {
+export function validatePluginConfigReplacement(manifest: FamiliarOSPluginManifest, value: unknown): PluginConfigValidationResult {
   return validateConfigObject(manifest, value, { rejectUnknown: true, applyDefaults: false });
 }
 
-export function getEffectivePluginConfig(manifest: OpenPetsPluginManifest, persisted: unknown): PluginConfigValidationResult {
+export function getEffectivePluginConfig(manifest: FamiliarOSPluginManifest, persisted: unknown): PluginConfigValidationResult {
   return validateConfigObject(manifest, persisted, { rejectUnknown: false, applyDefaults: true });
 }
 
-export function resolvePluginNumericConfig(manifest: OpenPetsPluginManifest, persisted: unknown, fieldName: string, options: { min?: number } = {}): number {
+export function resolvePluginNumericConfig(manifest: FamiliarOSPluginManifest, persisted: unknown, fieldName: string, options: { min?: number } = {}): number {
   const schema = manifest.configSchema;
   const field = schema && Object.prototype.hasOwnProperty.call(schema, fieldName) ? schema[fieldName] : undefined;
   if (!field || field.type !== "number") throw new Error(`Plugin numeric config ${fieldName} must reference a number config field.`);
@@ -36,7 +36,7 @@ export function resolvePluginNumericConfig(manifest: OpenPetsPluginManifest, per
   return value;
 }
 
-export function resolvePluginStringConfig(manifest: OpenPetsPluginManifest, persisted: unknown, fieldName: string, allowedType: "text" | "select"): string {
+export function resolvePluginStringConfig(manifest: FamiliarOSPluginManifest, persisted: unknown, fieldName: string, allowedType: "text" | "select"): string {
   const schema = manifest.configSchema;
   const field = schema && Object.prototype.hasOwnProperty.call(schema, fieldName) ? schema[fieldName] : undefined;
   if (!field || field.type !== allowedType) throw new Error(`Plugin string config reference must point to a ${allowedType} config field.`);
@@ -48,7 +48,7 @@ export function resolvePluginStringConfig(manifest: OpenPetsPluginManifest, pers
   return value;
 }
 
-function validateConfigObject(manifest: OpenPetsPluginManifest, value: unknown, options: { rejectUnknown: boolean; applyDefaults: boolean }): PluginConfigValidationResult {
+function validateConfigObject(manifest: FamiliarOSPluginManifest, value: unknown, options: { rejectUnknown: boolean; applyDefaults: boolean }): PluginConfigValidationResult {
   const errors: PluginConfigValidationError[] = [];
   if (!isPlainRecord(value)) return { ok: false, errors: [{ path: "$", code: "invalid_config", message: "Plugin config must be a plain object." }] };
   const config: PluginConfig = options.applyDefaults ? getPluginDefaultConfig(manifest) : {};
@@ -110,7 +110,7 @@ function looksLikeFilesystemPath(value: string): boolean {
   return value.startsWith("/") || value.startsWith("~") || /^[A-Za-z]:[\\/]/.test(value) || value.includes("\\") || value.includes("/") || value.startsWith("file:");
 }
 
-function configSchemaEntries(manifest: OpenPetsPluginManifest): Array<[string, PluginConfigField]> {
+function configSchemaEntries(manifest: FamiliarOSPluginManifest): Array<[string, PluginConfigField]> {
   return Object.entries(manifest.configSchema ?? {}).sort(([a], [b]) => a.localeCompare(b));
 }
 
diff --git a/apps/desktop/src/plugin-dev-watcher.ts b/apps/desktop/src/plugin-dev-watcher.ts
index cf73ab52..587b5076 100644
--- a/apps/desktop/src/plugin-dev-watcher.ts
+++ b/apps/desktop/src/plugin-dev-watcher.ts
@@ -3,7 +3,7 @@ import { promises as fs } from "node:fs";
 import { join } from "node:path";
 
 import { debug, error as logError, info } from "./logger.js";
-import { OPENPETS_PLUGIN_MANIFEST_FILENAME } from "./plugin-manifest.js";
+import { FAMILIAROS_PLUGIN_MANIFEST_FILENAME } from "./plugin-manifest.js";
 import type { PluginService } from "./plugin-service.js";
 
 /**
@@ -24,7 +24,7 @@ export function startDevPluginWatcher(service: PluginService, roots: readonly st
     if (existing) clearTimeout(existing);
     pending.set(sourceFolder, setTimeout(() => {
       pending.delete(sourceFolder);
-      if (!existsSync(join(sourceFolder, OPENPETS_PLUGIN_MANIFEST_FILENAME))) return;
+      if (!existsSync(join(sourceFolder, FAMILIAROS_PLUGIN_MANIFEST_FILENAME))) return;
       info("plugin", "dev hot reload", { sourceFolder });
       void service.loadLocalPath(sourceFolder, { autoApprove: true }).then((result) => {
         if (!result.ok) logError("plugin", "dev hot reload failed", new Error(result.error));
@@ -55,7 +55,7 @@ export function startDevPluginWatcher(service: PluginService, roots: readonly st
       const rootWatcher = watch(root, { persistent: false }, (_event, fileName) => {
         if (!fileName) return;
         const candidate = join(root, String(fileName));
-        if (existsSync(join(candidate, OPENPETS_PLUGIN_MANIFEST_FILENAME))) {
+        if (existsSync(join(candidate, FAMILIAROS_PLUGIN_MANIFEST_FILENAME))) {
           watchPluginFolder(candidate);
           scheduleReload(candidate);
         }
diff --git a/apps/desktop/src/plugin-events-source.ts b/apps/desktop/src/plugin-events-source.ts
index 630c9ca6..bba354ee 100644
--- a/apps/desktop/src/plugin-events-source.ts
+++ b/apps/desktop/src/plugin-events-source.ts
@@ -6,7 +6,7 @@ import { debug } from "./logger.js";
 
 /**
  * The senses bus host source (§3): a curated, read-only event stream fed by
- * the pet windows, powerMonitor, screen, and small pollers. Plugins subscribe
+ * the familiar windows, powerMonitor, screen, and small pollers. Plugins subscribe
  * through the SDK bridge; the bridge enforces the permission and the bounded
  * event-name set. Hard privacy line (§3.1): nothing here ever carries
  * keystrokes, screen contents, other apps' window titles, or clipboard data.
@@ -40,7 +40,7 @@ export function emitPluginEvent(event: string, payload: Record<string, unknown>)
   try { emitter.emit(event, payload); } catch { /* subscriber errors are isolated upstream */ }
 }
 
-const petWindowEventNames = new Set(["pet:clicked", "pet:doubleClicked", "pet:dragStart", "pet:dragEnd", "pet:hover", "pet:drop"]);
+const petWindowEventNames = new Set(["familiar:clicked", "familiar:doubleClicked", "familiar:dragStart", "familiar:dragEnd", "familiar:hover", "familiar:drop"]);
 let nextDropFileId = 0;
 const droppedFileTexts = new Map<string, { text: string; expiresAt: number }>();
 
@@ -52,15 +52,15 @@ export function readDroppedFileText(fileId: string): string | undefined {
   return entry.text;
 }
 
-/** Pet windows publish their senses through this (clicks, hovers, drops). */
+/** Familiar windows publish their senses through this (clicks, hovers, drops). */
 export function publishPluginPetEvent(petId: string, name: string, payload: Record<string, unknown>): void {
   if (!petWindowEventNames.has(name)) return;
-  if (name === "pet:drop") {
+  if (name === "familiar:drop") {
     const kind = payload.kind === "files" ? "files" : "text";
     if (kind === "text") {
       const text = typeof payload.text === "string" ? payload.text.slice(0, 256 * 1024) : "";
       if (!text) return;
-      emitPluginEvent("pet:drop", { kind: "text", text, petId });
+      emitPluginEvent("familiar:drop", { kind: "text", text, petId });
       return;
     }
     const dropped = Array.isArray(payload.droppedFiles) ? payload.droppedFiles.slice(0, 4) : [];
@@ -73,7 +73,7 @@ export function publishPluginPetEvent(petId: string, name: string, payload: Reco
       return [{ fileId, name: typeof record.name === "string" ? record.name.slice(0, 200) : "file", sizeBytes: Number(record.sizeBytes) || text.length }];
     });
     if (files.length === 0) return;
-    emitPluginEvent("pet:drop", { kind: "files", files, petId });
+    emitPluginEvent("familiar:drop", { kind: "files", files, petId });
     return;
   }
   emitPluginEvent(name, { petId });
diff --git a/apps/desktop/src/plugin-pet-api.ts b/apps/desktop/src/plugin-familiar-api.ts
similarity index 75%
rename from apps/desktop/src/plugin-pet-api.ts
rename to apps/desktop/src/plugin-familiar-api.ts
index 4eabe508..7a6ee038 100644
--- a/apps/desktop/src/plugin-pet-api.ts
+++ b/apps/desktop/src/plugin-familiar-api.ts
@@ -1,11 +1,11 @@
-import { getAppStateSnapshot, recordOpenPetsActivity } from "./app-state.js";
-import { applyExternalPetMoveBy, applyExternalPetMoveToHome, applyExternalPetReaction, applyExternalPetSay, applyExternalPetWander, type PetMoveOptions, type PetReactionOptions, type PetWanderOptions } from "./default-pet-controller.js";
+import { getAppStateSnapshot, recordFamiliarOSActivity } from "./app-state.js";
+import { applyExternalPetMoveBy, applyExternalPetMoveToHome, applyExternalPetReaction, applyExternalPetSay, applyExternalPetWander, type PetMoveOptions, type PetReactionOptions, type PetWanderOptions } from "./default-familiar-controller.js";
 import { debug } from "./logger.js";
-import type { OpenPetsReaction } from "./local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "./local-ipc-protocol.js";
 
 export interface PluginPetApi {
   speak(message: string): void | Promise<void>;
-  react(reaction: OpenPetsReaction, options?: PetReactionOptions): void | Promise<void>;
+  react(reaction: FamiliarOSReaction, options?: PetReactionOptions): void | Promise<void>;
   moveBy(options: PetMoveOptions): void | Promise<void>;
   wander(options: PetWanderOptions): void | Promise<void>;
   moveToHome(): void | Promise<void>;
@@ -25,10 +25,10 @@ export const defaultPluginPetApi: PluginPetApi = {
   moveToHome() { applyExternalPetMoveToHome(); },
 };
 
-function recordPluginPetActivity(activity: { readonly kind: "say"; readonly reaction?: undefined } | { readonly kind: "react"; readonly reaction: OpenPetsReaction }): void {
+function recordPluginPetActivity(activity: { readonly kind: "say"; readonly reaction?: undefined } | { readonly kind: "react"; readonly reaction: FamiliarOSReaction }): void {
   try {
     const state = getAppStateSnapshot();
-    recordOpenPetsActivity({ ...activity, petId: state.preferences.defaultPetId });
+    recordFamiliarOSActivity({ ...activity, petId: state.preferences.defaultPetId });
   } catch (error) {
     debug("plugin", "activity record failed", { error: error instanceof Error ? error.message : String(error), kind: activity.kind, reaction: activity.reaction });
   }
diff --git a/apps/desktop/src/plugin-pet-registry.ts b/apps/desktop/src/plugin-familiar-registry.ts
similarity index 59%
rename from apps/desktop/src/plugin-pet-registry.ts
rename to apps/desktop/src/plugin-familiar-registry.ts
index 3ea1ac6f..3547ad3d 100644
--- a/apps/desktop/src/plugin-pet-registry.ts
+++ b/apps/desktop/src/plugin-familiar-registry.ts
@@ -1,21 +1,21 @@
 import { BrowserWindow } from "electron";
 
 import { getAppStateSnapshot, type PetScaleValue } from "./app-state.js";
-import { applyExternalPetReaction, applyExternalPetStatusReaction, getDefaultPetPaused, getDefaultPetWindowForPlugins, defaultPetBubbleArbiter } from "./default-pet-controller.js";
+import { applyExternalPetReaction, applyExternalPetStatusReaction, getDefaultPetPaused, getDefaultPetWindowForPlugins, defaultPetBubbleArbiter } from "./default-familiar-controller.js";
 import { clampToVisibleWorkArea, defaultPetWindowSize, getDefaultPetInitialPosition, type Point } from "./display.js";
-import { builtInPet } from "./built-in-pet.js";
+import { builtInPet } from "./built-in-familiar.js";
 import { debug, info } from "./logger.js";
-import type { OpenPetsReaction } from "./local-ipc-protocol.js";
-import { motionMoveTo, motionSetFollowCursor, motionSetPhysics, motionStop, type WindowAccessor } from "./pet-motion-engine.js";
-import { createAgentPetWindow, isPetWindowDragging, loadExplicitPetContent, setPetReactionState, setPetSpriteOverride, setPetWindowScale, type PetPluginBubbles, type PetStatusBadgeReaction } from "./pet-window.js";
+import type { FamiliarOSReaction } from "./local-ipc-protocol.js";
+import { motionMoveTo, motionSetFollowCursor, motionSetPhysics, motionStop, type WindowAccessor } from "./familiar-motion-engine.js";
+import { createAgentPetWindow, isPetWindowDragging, loadExplicitPetContent, setPetReactionState, setPetSpriteOverride, setPetWindowScale, type PetPluginBubbles, type PetStatusBadgeReaction } from "./familiar-window.js";
 import { PetBubbleArbiter, type PetBubbleSink } from "./plugin-bubble-arbiter.js";
 import { publishPluginPetEvent } from "./plugin-events-source.js";
 import { resolveReactionSpriteState } from "./reaction-animation-mapping.js";
 import type { PluginAnimationSpec, PluginPetInfo, PluginPetState } from "./plugin-sdk-bridge.js";
 
 /**
- * Multi-pet registry (§4): addressable pet handles for plugins. "default" is
- * the user's default pet; plugin-spawned pets get their own windows, bubble
+ * Multi-familiar registry (§4): addressable familiar handles for plugins. "default" is
+ * the user's default familiar; plugin-spawned familiars get their own windows, bubble
  * arbiters, and liveness loops, and are torn down with their owning plugin.
  */
 
@@ -35,7 +35,7 @@ type SpawnedPet = {
 };
 
 const spawnedPets = new Map<string, SpawnedPet>();
-const changeListeners = new Set<(pets: PluginPetInfo[]) => void>();
+const changeListeners = new Set<(familiars: PluginPetInfo[]) => void>();
 const tickSubscribers = new Map<string, Set<(dtMs: number) => void>>();
 const tickLoops = new Map<string, { timer: NodeJS.Timeout; lastAt: number }>();
 const tickIntervalMs = 100;
@@ -45,54 +45,54 @@ let defaultAnimation = "idle";
 function windowAccessor(petHandleId: string): WindowAccessor {
   if (petHandleId === "default") return getDefaultPetWindowForPlugins;
   return () => {
-    const pet = spawnedPets.get(petHandleId);
-    return pet?.window && !pet.window.isDestroyed() ? pet.window : null;
+    const familiar = spawnedPets.get(petHandleId);
+    return familiar?.window && !familiar.window.isDestroyed() ? familiar.window : null;
   };
 }
 
 function requireWindow(petHandleId: string): BrowserWindow {
   const window = windowAccessor(petHandleId)();
-  if (!window) throw new Error(`Pet is not available: ${petHandleId}`);
+  if (!window) throw new Error(`Familiar is not available: ${petHandleId}`);
   return window;
 }
 
 function notifyChange(): void {
-  const pets = listPluginPets();
-  for (const listener of changeListeners) { try { listener(pets); } catch { /* listener errors are isolated */ } }
+  const familiars = listPluginPets();
+  for (const listener of changeListeners) { try { listener(familiars); } catch { /* listener errors are isolated */ } }
 }
 
 export function listPluginPets(): PluginPetInfo[] {
   const state = getAppStateSnapshot();
-  const defaultName = state.pets.installed.find((pet) => pet.id === state.preferences.defaultPetId)?.displayName ?? "Default pet";
+  const defaultName = state.familiars.installed.find((familiar) => familiar.id === state.preferences.defaultPetId)?.displayName ?? "Default familiar";
   const out: PluginPetInfo[] = [{ id: "default", name: defaultName, kind: "default", visible: getDefaultPetWindowForPlugins()?.isVisible() ?? false }];
-  for (const pet of spawnedPets.values()) {
-    out.push({ id: pet.handleId, name: pet.name, kind: "plugin", visible: pet.window !== null && !pet.window.isDestroyed() && pet.window.isVisible() });
+  for (const familiar of spawnedPets.values()) {
+    out.push({ id: familiar.handleId, name: familiar.name, kind: "plugin", visible: familiar.window !== null && !familiar.window.isDestroyed() && familiar.window.isVisible() });
   }
   return out;
 }
 
-export function onPluginPetsChange(listener: (pets: PluginPetInfo[]) => void): () => void {
+export function onPluginPetsChange(listener: (familiars: PluginPetInfo[]) => void): () => void {
   changeListeners.add(listener);
   return () => changeListeners.delete(listener);
 }
 
-function refreshSpawnedPet(pet: SpawnedPet): void {
-  if (!pet.window || pet.window.isDestroyed()) return;
-  void loadExplicitPetContent(pet.window, pet.petId, null, pet.statusReaction, undefined, pet.scale, pet.bubbles.transient || pet.bubbles.pinned ? pet.bubbles : null).then(() => {
-    if (pet.window && !pet.window.isDestroyed() && pet.spriteOverride) setPetSpriteOverride(pet.window, pet.spriteOverride);
+function refreshSpawnedPet(familiar: SpawnedPet): void {
+  if (!familiar.window || familiar.window.isDestroyed()) return;
+  void loadExplicitPetContent(familiar.window, familiar.petId, null, familiar.statusReaction, undefined, familiar.scale, familiar.bubbles.transient || familiar.bubbles.pinned ? familiar.bubbles : null).then(() => {
+    if (familiar.window && !familiar.window.isDestroyed() && familiar.spriteOverride) setPetSpriteOverride(familiar.window, familiar.spriteOverride);
   });
 }
 
 export async function spawnPluginPet(opts: { pluginId: string; petId: string; name?: string; position?: Point }): Promise<string> {
   const state = getAppStateSnapshot();
-  const installed = state.pets.installed.find((pet) => pet.id === opts.petId);
-  if (!installed || installed.broken || installed.id === builtInPet.id) throw new Error(`Pet is not installed or cannot be spawned: ${opts.petId}`);
-  const handleId = `plugin-pet-${++nextSpawnId}`;
+  const installed = state.familiars.installed.find((familiar) => familiar.id === opts.petId);
+  if (!installed || installed.broken || installed.id === builtInPet.id) throw new Error(`Familiar is not installed or cannot be spawned: ${opts.petId}`);
+  const handleId = `plugin-familiar-${++nextSpawnId}`;
   const base = getDefaultPetInitialPosition(defaultPetWindowSize);
   const offset = (spawnedPets.size + 1) * 60;
   const position = clampToVisibleWorkArea(opts.position ?? { x: base.x - offset, y: base.y }, defaultPetWindowSize);
 
-  const pet: SpawnedPet = {
+  const familiar: SpawnedPet = {
     handleId,
     ownerPluginId: opts.pluginId,
     petId: opts.petId,
@@ -108,73 +108,73 @@ export async function spawnPluginPet(opts: { pluginId: string; petId: string; na
   };
   const sink: PetBubbleSink = {
     present(slot, content) {
-      pet.bubbles = slot === "pinned" ? { ...pet.bubbles, pinned: content } : { ...pet.bubbles, transient: content };
-      refreshSpawnedPet(pet);
+      familiar.bubbles = slot === "pinned" ? { ...familiar.bubbles, pinned: content } : { ...familiar.bubbles, transient: content };
+      refreshSpawnedPet(familiar);
     },
   };
-  (pet as { arbiter: PetBubbleArbiter }).arbiter = new PetBubbleArbiter(sink);
+  (familiar as { arbiter: PetBubbleArbiter }).arbiter = new PetBubbleArbiter(sink);
 
   const window = createAgentPetWindow({
     petId: opts.petId,
-    displayName: pet.name,
-    scale: pet.scale,
+    displayName: familiar.name,
+    scale: familiar.scale,
     position,
     display: null,
     badge: null,
     onCloseRequested: () => closePluginPet(opts.pluginId, handleId, true),
-    onBubbleDismissed: (token) => { if (PetBubbleArbiter.isArbiterToken(token)) pet.arbiter.handleDismissed(token); },
-    onBubbleAction: (token, actionId) => pet.arbiter.handleAction(token, actionId),
-    onBubbleSubmit: (token, values) => pet.arbiter.handleSubmit(token, values),
+    onBubbleDismissed: (token) => { if (PetBubbleArbiter.isArbiterToken(token)) familiar.arbiter.handleDismissed(token); },
+    onBubbleAction: (token, actionId) => familiar.arbiter.handleAction(token, actionId),
+    onBubbleSubmit: (token, values) => familiar.arbiter.handleSubmit(token, values),
     onPetEvent: (name, payload) => publishPluginPetEvent(handleId, name, payload),
   });
-  pet.window = window;
-  window.once("closed", () => { pet.window = null; });
+  familiar.window = window;
+  window.once("closed", () => { familiar.window = null; });
   window.showInactive();
-  spawnedPets.set(handleId, pet);
-  info("plugin", "plugin pet spawned", { handleId, petId: opts.petId, pluginId: opts.pluginId });
+  spawnedPets.set(handleId, familiar);
+  info("plugin", "plugin familiar spawned", { handleId, petId: opts.petId, pluginId: opts.pluginId });
   notifyChange();
   return handleId;
 }
 
 export async function closePluginPet(pluginId: string, petHandleId: string, force = false): Promise<void> {
-  const pet = spawnedPets.get(petHandleId);
-  if (!pet) return;
-  if (!force && pet.ownerPluginId !== pluginId) throw new Error("Plugins may only close pets they spawned.");
+  const familiar = spawnedPets.get(petHandleId);
+  if (!familiar) return;
+  if (!force && familiar.ownerPluginId !== pluginId) throw new Error("Plugins may only close familiars they spawned.");
   spawnedPets.delete(petHandleId);
   motionStop(petHandleId);
   stopTicker(petHandleId);
-  if (pet.reactionRevert) clearTimeout(pet.reactionRevert);
-  pet.arbiter.clearPlugin(pet.ownerPluginId);
-  if (pet.window && !pet.window.isDestroyed()) pet.window.destroy();
-  info("plugin", "plugin pet closed", { petHandleId, pluginId });
+  if (familiar.reactionRevert) clearTimeout(familiar.reactionRevert);
+  familiar.arbiter.clearPlugin(familiar.ownerPluginId);
+  if (familiar.window && !familiar.window.isDestroyed()) familiar.window.destroy();
+  info("plugin", "plugin familiar closed", { petHandleId, pluginId });
   notifyChange();
 }
 
 /** Tear down everything a plugin spawned or animated (plugin stop/reload). */
 export function clearPluginPetsForPlugin(pluginId: string): void {
-  for (const pet of [...spawnedPets.values()]) {
-    if (pet.ownerPluginId === pluginId) void closePluginPet(pluginId, pet.handleId, true);
+  for (const familiar of [...spawnedPets.values()]) {
+    if (familiar.ownerPluginId === pluginId) void closePluginPet(pluginId, familiar.handleId, true);
   }
   defaultPetBubbleArbiter.clearPlugin(pluginId);
 }
 
 export function showPluginPet(petHandleId: string): void {
-  if (petHandleId === "default") { import("./default-pet-controller.js").then(({ showDefaultPet }) => showDefaultPet()).catch(() => undefined); notifyChange(); return; }
+  if (petHandleId === "default") { import("./default-familiar-controller.js").then(({ showDefaultPet }) => showDefaultPet()).catch(() => undefined); notifyChange(); return; }
   requireWindow(petHandleId).showInactive();
   notifyChange();
 }
 
 export function hidePluginPet(petHandleId: string): void {
-  if (petHandleId === "default") { import("./default-pet-controller.js").then(({ hideDefaultPet }) => hideDefaultPet()).catch(() => undefined); notifyChange(); return; }
+  if (petHandleId === "default") { import("./default-familiar-controller.js").then(({ hideDefaultPet }) => hideDefaultPet()).catch(() => undefined); notifyChange(); return; }
   requireWindow(petHandleId).hide();
   notifyChange();
 }
 
-export function reactPluginPet(petHandleId: string, reaction: OpenPetsReaction, options: { readonly showMessage?: boolean } = {}): void {
+export function reactPluginPet(petHandleId: string, reaction: FamiliarOSReaction, options: { readonly showMessage?: boolean } = {}): void {
   if (petHandleId === "default") { applyExternalPetReaction(reaction, options); defaultAnimation = String(reaction); return; }
-  const pet = spawnedPets.get(petHandleId);
-  if (!pet) throw new Error(`Pet is not available: ${petHandleId}`);
-  applySpawnedPetAnimation(pet, { kind: "reaction", reaction });
+  const familiar = spawnedPets.get(petHandleId);
+  if (!familiar) throw new Error(`Familiar is not available: ${petHandleId}`);
+  applySpawnedPetAnimation(familiar, { kind: "reaction", reaction });
 }
 
 export function setPluginPetAnimation(petHandleId: string, spec: PluginAnimationSpec): void {
@@ -190,48 +190,48 @@ export function setPluginPetAnimation(petHandleId: string, spec: PluginAnimation
     }
     return;
   }
-  const pet = spawnedPets.get(petHandleId);
-  if (!pet) throw new Error(`Pet is not available: ${petHandleId}`);
-  applySpawnedPetAnimation(pet, spec);
+  const familiar = spawnedPets.get(petHandleId);
+  if (!familiar) throw new Error(`Familiar is not available: ${petHandleId}`);
+  applySpawnedPetAnimation(familiar, spec);
 }
 
-function applySpawnedPetAnimation(pet: SpawnedPet, spec: PluginAnimationSpec): void {
-  if (!pet.window || pet.window.isDestroyed()) throw new Error(`Pet is not available: ${pet.handleId}`);
-  if (pet.reactionRevert) { clearTimeout(pet.reactionRevert); pet.reactionRevert = null; }
+function applySpawnedPetAnimation(familiar: SpawnedPet, spec: PluginAnimationSpec): void {
+  if (!familiar.window || familiar.window.isDestroyed()) throw new Error(`Familiar is not available: ${familiar.handleId}`);
+  if (familiar.reactionRevert) { clearTimeout(familiar.reactionRevert); familiar.reactionRevert = null; }
   if (spec.kind === "reaction") {
-    pet.spriteOverride = null;
-    setPetSpriteOverride(pet.window, null);
+    familiar.spriteOverride = null;
+    setPetSpriteOverride(familiar.window, null);
     const spriteState = resolveReactionSpriteState(spec.reaction, getAppStateSnapshot().preferences.reactionAnimationOverrides);
-    setPetReactionState(pet.window, spriteState);
-    pet.currentAnimation = String(spec.reaction);
-    pet.reactionRevert = setTimeout(() => {
-      pet.reactionRevert = null;
-      if (pet.window && !pet.window.isDestroyed()) setPetReactionState(pet.window, "idle");
-      pet.currentAnimation = "idle";
+    setPetReactionState(familiar.window, spriteState);
+    familiar.currentAnimation = String(spec.reaction);
+    familiar.reactionRevert = setTimeout(() => {
+      familiar.reactionRevert = null;
+      if (familiar.window && !familiar.window.isDestroyed()) setPetReactionState(familiar.window, "idle");
+      familiar.currentAnimation = "idle";
     }, 4_000);
-    pet.reactionRevert.unref?.();
+    familiar.reactionRevert.unref?.();
   } else {
-    pet.spriteOverride = { filePath: spec.spritePath, fps: spec.fps, loop: spec.loop };
-    setPetSpriteOverride(pet.window, pet.spriteOverride);
-    pet.currentAnimation = "sprite";
+    familiar.spriteOverride = { filePath: spec.spritePath, fps: spec.fps, loop: spec.loop };
+    setPetSpriteOverride(familiar.window, familiar.spriteOverride);
+    familiar.currentAnimation = "sprite";
   }
 }
 
 export function setPluginPetScale(petHandleId: string, scale: number): void {
   setPetWindowScale(requireWindow(petHandleId), scale);
-  const pet = spawnedPets.get(petHandleId);
-  if (pet) pet.scale = scale as PetScaleValue;
+  const familiar = spawnedPets.get(petHandleId);
+  if (familiar) familiar.scale = scale as PetScaleValue;
 }
 
-export function setPluginPetStatusReaction(petHandleId: string, reaction: OpenPetsReaction | null): void {
+export function setPluginPetStatusReaction(petHandleId: string, reaction: FamiliarOSReaction | null): void {
   if (petHandleId === "default") {
     applyExternalPetStatusReaction(reaction);
     return;
   }
-  const pet = spawnedPets.get(petHandleId);
-  if (!pet) throw new Error(`Pet is not available: ${petHandleId}`);
-  pet.statusReaction = reaction === null || reaction === "idle" ? null : reaction as PetStatusBadgeReaction;
-  refreshSpawnedPet(pet);
+  const familiar = spawnedPets.get(petHandleId);
+  if (!familiar) throw new Error(`Familiar is not available: ${petHandleId}`);
+  familiar.statusReaction = reaction === null || reaction === "idle" ? null : reaction as PetStatusBadgeReaction;
+  refreshSpawnedPet(familiar);
 }
 
 export async function movePluginPetBy(petHandleId: string, opts: { x: number; y: number; durationMs?: number }): Promise<void> {
@@ -272,11 +272,11 @@ export function getPluginPetState(petHandleId: string): PluginPetState {
   const window = requireWindow(petHandleId);
   const [x, y] = window.getPosition();
   const [width, height] = window.getSize();
-  const pet = spawnedPets.get(petHandleId);
+  const familiar = spawnedPets.get(petHandleId);
   return {
     position: { x, y },
     bounds: { x, y, width, height },
-    currentAnimation: petHandleId === "default" ? (getDefaultPetPaused() ? "paused" : defaultAnimation) : pet?.currentAnimation ?? "idle",
+    currentAnimation: petHandleId === "default" ? (getDefaultPetPaused() ? "paused" : defaultAnimation) : familiar?.currentAnimation ?? "idle",
     visible: window.isVisible(),
     dragging: isPetWindowDragging(window),
   };
@@ -315,15 +315,15 @@ function stopTicker(petHandleId: string): void {
   tickSubscribers.delete(petHandleId);
 }
 
-/** Show a plugin bubble on a pet surface (the bubbles capability entry point). */
+/** Show a plugin bubble on a familiar surface (the bubbles capability entry point). */
 export function getPluginPetArbiter(petHandleId: string): PetBubbleArbiter {
   if (petHandleId === "default") return defaultPetBubbleArbiter;
-  const pet = spawnedPets.get(petHandleId);
-  if (!pet) throw new Error(`Pet is not available: ${petHandleId}`);
-  return pet.arbiter;
+  const familiar = spawnedPets.get(petHandleId);
+  if (!familiar) throw new Error(`Familiar is not available: ${petHandleId}`);
+  return familiar.arbiter;
 }
 
 export function closeAllPluginPets(): void {
-  for (const pet of [...spawnedPets.values()]) void closePluginPet(pet.ownerPluginId, pet.handleId, true);
-  debug("plugin", "all plugin pets closed");
+  for (const familiar of [...spawnedPets.values()]) void closePluginPet(familiar.ownerPluginId, familiar.handleId, true);
+  debug("plugin", "all plugin familiars closed");
 }
diff --git a/apps/desktop/src/plugin-host-capabilities.ts b/apps/desktop/src/plugin-host-capabilities.ts
index c83477d4..7bfbb328 100644
--- a/apps/desktop/src/plugin-host-capabilities.ts
+++ b/apps/desktop/src/plugin-host-capabilities.ts
@@ -4,10 +4,10 @@ import { basename, extname, join } from "node:path";
 
 import { app, clipboard, dialog, nativeTheme, net, Notification, shell } from "electron";
 
-import { getDefaultPetWindowForPlugins } from "./default-pet-controller.js";
+import { getDefaultPetWindowForPlugins } from "./default-familiar-controller.js";
 import { getActiveLocaleLang } from "./i18n/index.js";
 import { debug, warn } from "./logger.js";
-import { playPetWindowAudio, stopPetWindowAudio } from "./pet-window.js";
+import { playPetWindowAudio, stopPetWindowAudio } from "./familiar-window.js";
 import { PluginAiGateway } from "./plugin-ai-gateway.js";
 import { readDroppedFileText, startPluginEventSources, subscribePluginEvent } from "./plugin-events-source.js";
 import { PluginOauthBroker } from "./plugin-oauth.js";
@@ -17,8 +17,8 @@ import {
   setPluginPetStatusReaction, clearPluginPetsForPlugin, closeAllPluginPets, closePluginPet, getPluginPetArbiter, getPluginPetState, hidePluginPet, listPluginPets,
   movePluginPetBy, movePluginPetTo, movePluginPetToHome, onPluginPetTick, onPluginPetsChange, reactPluginPet,
   setPluginPetAnimation, setPluginPetFollowCursor, setPluginPetPhysics, setPluginPetScale, showPluginPet, spawnPluginPet, wanderPluginPet,
-} from "./plugin-pet-registry.js";
-import { motionStop } from "./pet-motion-engine.js";
+} from "./plugin-familiar-registry.js";
+import { motionStop } from "./familiar-motion-engine.js";
 import { PluginSecretsStore } from "./plugin-secrets.js";
 import { showPluginToast } from "./plugin-toast.js";
 import { pluginVoiceListen, pluginVoiceSpeak } from "./plugin-voice.js";
@@ -95,7 +95,7 @@ export function createElectronPluginHostCapabilities(userDataPath: string): Elec
         const baseFields = { kind: spec.kind, pluginId: "pluginId" in spec ? spec.pluginId : undefined, soundId: "id" in spec ? spec.id : undefined, name: "name" in spec ? spec.name : undefined };
         debug("plugin", "audio play requested", baseFields);
         const window = getDefaultPetWindowForPlugins();
-        if (!window) { debug("plugin", "audio play skipped", { ...baseFields, reason: "no-pet-window" }); return; }
+        if (!window) { debug("plugin", "audio play skipped", { ...baseFields, reason: "no-familiar-window" }); return; }
         if (spec.kind === "named") {
           playPetWindowAudio(window, { kind: "named", name: spec.name, volume });
           debug("plugin", "audio play started", baseFields);
@@ -142,7 +142,7 @@ export function createElectronPluginHostCapabilities(userDataPath: string): Elec
         return subscribePluginEvent(event, handler);
       },
     },
-    pets: {
+    familiars: {
       list: () => listPluginPets(),
       spawn: (opts) => spawnPluginPet(opts),
       close: (pluginId, petHandleId) => closePluginPet(pluginId, petHandleId),
@@ -270,7 +270,7 @@ export function createElectronPluginHostCapabilities(userDataPath: string): Elec
       try {
         clearPluginPetsForPlugin(pluginId);
       } catch (error) {
-        warn("plugin", "plugin pet teardown failed", { pluginId, error: error instanceof Error ? error.message : String(error) });
+        warn("plugin", "plugin familiar teardown failed", { pluginId, error: error instanceof Error ? error.message : String(error) });
       }
       // Runtime teardown must not delete persistent plugin data. User-imported
       // sounds are cleared only by PluginService uninstall/prune paths.
diff --git a/apps/desktop/src/plugin-js-host.ts b/apps/desktop/src/plugin-js-host.ts
index 3547d15d..e0e3d8fb 100644
--- a/apps/desktop/src/plugin-js-host.ts
+++ b/apps/desktop/src/plugin-js-host.ts
@@ -3,7 +3,7 @@ import { pathToFileURL } from "node:url";
 
 import { app, BrowserWindow, ipcMain, session, type Event, type IpcMainEvent, type IpcMainInvokeEvent, type RenderProcessGoneDetails, type Session, type WebContents } from "electron";
 
-import type { OpenPetsJavascriptPluginManifest } from "./plugin-manifest.js";
+import type { FamiliarOSJavascriptPluginManifest } from "./plugin-manifest.js";
 import { classifyPluginError, logPluginDiagnostic, truncatePluginConsoleMessage } from "./plugin-diagnostics.js";
 import type { PluginRuntimeLogger, PluginSdkApi } from "./plugin-sdk-bridge.js";
 import { isPluginSdkRoute, pluginSdkSyncRoutes, type PluginSdkRoute } from "./plugin-sdk-routes.js";
@@ -11,7 +11,7 @@ import type { PluginStateRecord } from "./plugin-state.js";
 
 export type PluginJsHostStartOptions = {
   readonly record: PluginStateRecord;
-  readonly manifest: OpenPetsJavascriptPluginManifest;
+  readonly manifest: FamiliarOSJavascriptPluginManifest;
   readonly entryPath: string;
   readonly sdk?: PluginSdkApi;
   readonly startupTimeoutMs?: number;
@@ -32,7 +32,7 @@ export class ElectronPluginJsHost implements PluginJsHost {
   }
 
   async startPlugin(options: PluginJsHostStartOptions): Promise<PluginJsHostInstance> {
-    const partition = `openpets-plugin:${encodeURIComponent(options.record.id)}:${Date.now()}`;
+    const partition = `familiaros-plugin:${encodeURIComponent(options.record.id)}:${Date.now()}`;
     const logger = (options.sdk as SdkWithLogger | undefined)?.__logger;
     logPluginDiagnostic(logger, "debug", "plugin js host start", { pluginId: options.record.id, runtime: "javascript", phase: "begin" });
     const pluginSession = session.fromPartition(partition, { cache: false });
@@ -42,7 +42,7 @@ export class ElectronPluginJsHost implements PluginJsHost {
     const moduleUrl = buildPluginModuleUrl(await readFile(options.entryPath, "utf8"), entryUrl);
     const htmlUrl = buildPluginHtmlUrl(moduleUrl);
     const token = `${options.record.id}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
-    const sdkChannel = `openpets:plugin-sdk:${token}`;
+    const sdkChannel = `familiaros:plugin-sdk:${token}`;
     hardenSession(pluginSession, { entryUrl: moduleUrl, htmlUrl });
 
     const window = new BrowserWindow({
@@ -57,7 +57,7 @@ export class ElectronPluginJsHost implements PluginJsHost {
         allowRunningInsecureContent: false,
         partition,
         preload: getPluginSdkPreloadPath(),
-        additionalArguments: [`--openpets-plugin-token=${token}`],
+        additionalArguments: [`--familiaros-plugin-token=${token}`],
       },
     });
 
@@ -132,28 +132,28 @@ const noop = (): void => undefined;
 const callbackOf = (runCallback: RunCallback, id: unknown): ((...callbackArgs: unknown[]) => unknown) => runCallback(id) ?? noop;
 
 export const sdkCallHandlers: Record<PluginSdkRoute, SdkCallHandler> = {
-  // Pet handles (first arg is the pet handle id; "default" targets the default pet).
-  "pet.speak": (sdk, args) => sdk.pets.forPet(args[0]).speak(args[1]),
-  "pet.react": (sdk, args) => sdk.pets.forPet(args[0]).react(args[1] as never, args[2]),
-  "pet.setAnimation": (sdk, args) => sdk.pets.forPet(args[0]).setAnimation(args[1]),
-  "pet.setScale": (sdk, args) => sdk.pets.forPet(args[0]).setScale(args[1]),
-  "pet.setStatusReaction": (sdk, args) => sdk.pets.forPet(args[0]).setStatusReaction(args[1]),
-  "pet.moveBy": (sdk, args) => sdk.pets.forPet(args[0]).moveBy(args[1]),
-  "pet.wander": (sdk, args) => sdk.pets.forPet(args[0]).wander(args[1]),
-  "pet.moveToHome": (sdk, args) => sdk.pets.forPet(args[0]).moveToHome(),
-  "pet.moveTo": (sdk, args) => sdk.pets.forPet(args[0]).moveTo(args[1], args[2]),
-  "pet.followCursor": (sdk, args) => sdk.pets.forPet(args[0]).followCursor(args[1]),
-  "pet.physics": (sdk, args) => sdk.pets.forPet(args[0]).physics(args[1]),
-  "pet.onTick": (sdk, args, runCallback) => sdk.pets.forPet(args[0]).onTick(callbackOf(runCallback, args[1])),
-  "pet.offTick": (sdk, args) => sdk.pets.forPet("default").offTick(args[0]),
-  "pet.getState": (sdk, args) => sdk.pets.forPet(args[0]).getState(),
-  "pet.show": (sdk, args) => sdk.pets.forPet(args[0]).show(),
-  "pet.hide": (sdk, args) => sdk.pets.forPet(args[0]).hide(),
-  "pet.close": (sdk, args) => sdk.pets.forPet(args[0]).close(),
-  "pets.list": (sdk) => sdk.pets.list(),
-  "pets.spawn": (sdk, args) => sdk.pets.spawn(args[0]),
-  "pets.onChange": (sdk, args, runCallback) => sdk.pets.onChange(callbackOf(runCallback, args[0])),
-  "pets.offChange": (sdk, args) => sdk.pets.offChange(args[0]),
+  // Familiar handles (first arg is the familiar handle id; "default" targets the default familiar).
+  "familiar.speak": (sdk, args) => sdk.familiars.forPet(args[0]).speak(args[1]),
+  "familiar.react": (sdk, args) => sdk.familiars.forPet(args[0]).react(args[1] as never, args[2]),
+  "familiar.setAnimation": (sdk, args) => sdk.familiars.forPet(args[0]).setAnimation(args[1]),
+  "familiar.setScale": (sdk, args) => sdk.familiars.forPet(args[0]).setScale(args[1]),
+  "familiar.setStatusReaction": (sdk, args) => sdk.familiars.forPet(args[0]).setStatusReaction(args[1]),
+  "familiar.moveBy": (sdk, args) => sdk.familiars.forPet(args[0]).moveBy(args[1]),
+  "familiar.wander": (sdk, args) => sdk.familiars.forPet(args[0]).wander(args[1]),
+  "familiar.moveToHome": (sdk, args) => sdk.familiars.forPet(args[0]).moveToHome(),
+  "familiar.moveTo": (sdk, args) => sdk.familiars.forPet(args[0]).moveTo(args[1], args[2]),
+  "familiar.followCursor": (sdk, args) => sdk.familiars.forPet(args[0]).followCursor(args[1]),
+  "familiar.physics": (sdk, args) => sdk.familiars.forPet(args[0]).physics(args[1]),
+  "familiar.onTick": (sdk, args, runCallback) => sdk.familiars.forPet(args[0]).onTick(callbackOf(runCallback, args[1])),
+  "familiar.offTick": (sdk, args) => sdk.familiars.forPet("default").offTick(args[0]),
+  "familiar.getState": (sdk, args) => sdk.familiars.forPet(args[0]).getState(),
+  "familiar.show": (sdk, args) => sdk.familiars.forPet(args[0]).show(),
+  "familiar.hide": (sdk, args) => sdk.familiars.forPet(args[0]).hide(),
+  "familiar.close": (sdk, args) => sdk.familiars.forPet(args[0]).close(),
+  "familiars.list": (sdk) => sdk.familiars.list(),
+  "familiars.spawn": (sdk, args) => sdk.familiars.spawn(args[0]),
+  "familiars.onChange": (sdk, args, runCallback) => sdk.familiars.onChange(callbackOf(runCallback, args[0])),
+  "familiars.offChange": (sdk, args) => sdk.familiars.offChange(args[0]),
   // UI: bubbles, toasts, panels, menus.
   "ui.bubble": (sdk, args) => sdk.ui.bubble(args[0]),
   "ui.alert": (sdk, args) => sdk.ui.alert(args[0]),
@@ -318,10 +318,10 @@ export function buildPluginRegistrationHandshakeCode(entryUrl: string): string {
     let done = false;
     const sdk = globalThis.__openPetsSdk;
     const finish = (value) => { if (done) return; done = true; globalThis.__openPetsRegisteredPlugin = value; Promise.resolve(value && typeof value.start === "function" ? value.start(sdk) : undefined).then(() => resolve(true), reject); };
-    Object.defineProperty(globalThis, "OpenPetsPlugin", { configurable: false, enumerable: false, writable: false, value: Object.freeze({ register: finish }) });
+    Object.defineProperty(globalThis, "FamiliarOSPlugin", { configurable: false, enumerable: false, writable: false, value: Object.freeze({ register: finish }) });
     import(${JSON.stringify(entryUrl)}).then((mod) => {
-      if (mod && typeof mod.register === "function") Promise.resolve(mod.register(globalThis.OpenPetsPlugin)).then(finish, reject);
-      else if (mod && typeof mod.default === "function") Promise.resolve(mod.default(globalThis.OpenPetsPlugin)).then(finish, reject);
+      if (mod && typeof mod.register === "function") Promise.resolve(mod.register(globalThis.FamiliarOSPlugin)).then(finish, reject);
+      else if (mod && typeof mod.default === "function") Promise.resolve(mod.default(globalThis.FamiliarOSPlugin)).then(finish, reject);
       else setTimeout(() => { if (!done) reject(new Error("JavaScript plugin did not register.")); }, 0);
     }, reject);
   }))();`;
diff --git a/apps/desktop/src/plugin-local-loader.ts b/apps/desktop/src/plugin-local-loader.ts
index e7c714d2..efe7ab06 100644
--- a/apps/desktop/src/plugin-local-loader.ts
+++ b/apps/desktop/src/plugin-local-loader.ts
@@ -4,10 +4,10 @@ import { basename, dirname, join } from "node:path";
 
 import { readDeclaredPluginFiles } from "./plugin-assets.js";
 import { defaultMaxPluginManifestBytes, isUnderPath, readSafePluginManifest } from "./plugin-manifest-reader.js";
-import { OPENPETS_PLUGIN_MANIFEST_FILENAME, validatePluginManifest, type OpenPetsPluginManifest } from "./plugin-manifest.js";
+import { FAMILIAROS_PLUGIN_MANIFEST_FILENAME, validatePluginManifest, type FamiliarOSPluginManifest } from "./plugin-manifest.js";
 
-export type LocalPluginLoadResult = { readonly manifest: OpenPetsPluginManifest; readonly installPath: string; readonly manifestPath: string };
-export type LocalPluginSourceManifest = { readonly manifest: OpenPetsPluginManifest; readonly manifestText: string; readonly entryText?: string; readonly declaredFiles?: ReadonlyMap<string, Buffer> };
+export type LocalPluginLoadResult = { readonly manifest: FamiliarOSPluginManifest; readonly installPath: string; readonly manifestPath: string };
+export type LocalPluginSourceManifest = { readonly manifest: FamiliarOSPluginManifest; readonly manifestText: string; readonly entryText?: string; readonly declaredFiles?: ReadonlyMap<string, Buffer> };
 const maxPluginEntryBytes = 1024 * 1024;
 
 export async function loadLocalPluginSnapshot(options: { readonly sourceFolder: string; readonly userDataPath: string; readonly maxManifestBytes?: number }): Promise<LocalPluginLoadResult> {
@@ -21,12 +21,12 @@ export async function readLocalPluginSourceManifest(options: { readonly sourceFo
   if (!sourceStat.isDirectory() || sourceStat.isSymbolicLink()) throw new Error("Selected plugin folder is invalid.");
   const realSourceFolder = await fs.realpath(options.sourceFolder);
 
-  const sourceManifestPath = join(realSourceFolder, OPENPETS_PLUGIN_MANIFEST_FILENAME);
+  const sourceManifestPath = join(realSourceFolder, FAMILIAROS_PLUGIN_MANIFEST_FILENAME);
   const manifestStat = await fs.lstat(sourceManifestPath);
   if (!manifestStat.isFile() || manifestStat.isSymbolicLink()) throw new Error("Selected plugin manifest is invalid.");
   if (manifestStat.size > maxBytes) throw new Error("Plugin manifest is too large.");
   const realSourceManifestPath = await fs.realpath(sourceManifestPath);
-  if (dirname(realSourceManifestPath) !== realSourceFolder || basename(realSourceManifestPath) !== OPENPETS_PLUGIN_MANIFEST_FILENAME) throw new Error("Selected plugin manifest is invalid.");
+  if (dirname(realSourceManifestPath) !== realSourceFolder || basename(realSourceManifestPath) !== FAMILIAROS_PLUGIN_MANIFEST_FILENAME) throw new Error("Selected plugin manifest is invalid.");
 
   let handle: FileHandle | undefined;
   try {
@@ -57,15 +57,15 @@ export async function readLocalPluginSourceManifest(options: { readonly sourceFo
   }
 }
 
-export async function publishLocalPluginSnapshot(options: { readonly manifest: OpenPetsPluginManifest; readonly manifestText: string; readonly entryText?: string; readonly declaredFiles?: ReadonlyMap<string, Buffer>; readonly userDataPath: string; readonly maxManifestBytes?: number }): Promise<LocalPluginLoadResult> {
+export async function publishLocalPluginSnapshot(options: { readonly manifest: FamiliarOSPluginManifest; readonly manifestText: string; readonly entryText?: string; readonly declaredFiles?: ReadonlyMap<string, Buffer>; readonly userDataPath: string; readonly maxManifestBytes?: number }): Promise<LocalPluginLoadResult> {
   const maxBytes = options.maxManifestBytes ?? defaultMaxPluginManifestBytes;
   const devRoot = join(options.userDataPath, "plugins-dev");
   await fs.mkdir(devRoot, { recursive: true });
   await assertRealDirectory(devRoot, "Plugin development directory is invalid.");
   const installPath = join(devRoot, options.manifest.id);
-  const manifestPath = join(installPath, OPENPETS_PLUGIN_MANIFEST_FILENAME);
+  const manifestPath = join(installPath, FAMILIAROS_PLUGIN_MANIFEST_FILENAME);
   const tempPath = join(devRoot, `.tmp-${options.manifest.id}-${process.pid}-${Date.now()}`);
-  const tempManifestPath = join(tempPath, OPENPETS_PLUGIN_MANIFEST_FILENAME);
+  const tempManifestPath = join(tempPath, FAMILIAROS_PLUGIN_MANIFEST_FILENAME);
   await fs.rm(tempPath, { recursive: true, force: true });
   await fs.mkdir(tempPath, { recursive: true });
   try {
diff --git a/apps/desktop/src/plugin-manifest-reader.ts b/apps/desktop/src/plugin-manifest-reader.ts
index 1e458c02..873c87a5 100644
--- a/apps/desktop/src/plugin-manifest-reader.ts
+++ b/apps/desktop/src/plugin-manifest-reader.ts
@@ -2,7 +2,7 @@ import { promises as fs } from "node:fs";
 import type { FileHandle } from "node:fs/promises";
 import { basename, dirname, isAbsolute, relative, resolve } from "node:path";
 
-import { OPENPETS_PLUGIN_MANIFEST_FILENAME, validatePluginManifest, type OpenPetsPluginManifest } from "./plugin-manifest.js";
+import { FAMILIAROS_PLUGIN_MANIFEST_FILENAME, validatePluginManifest, type FamiliarOSPluginManifest } from "./plugin-manifest.js";
 
 export const defaultMaxPluginManifestBytes = 64 * 1024;
 
@@ -15,7 +15,7 @@ export type ReadPluginManifestOptions = {
   readonly expectedVersion?: string;
 };
 
-export async function readSafePluginManifest(options: ReadPluginManifestOptions): Promise<OpenPetsPluginManifest> {
+export async function readSafePluginManifest(options: ReadPluginManifestOptions): Promise<FamiliarOSPluginManifest> {
   const maxBytes = options.maxManifestBytes ?? defaultMaxPluginManifestBytes;
   const realInstallPath = await fs.realpath(options.installPath);
   const allowedRoots = await Promise.all(options.allowedPluginRoots.map((root) => fs.realpath(root)));
@@ -23,7 +23,7 @@ export async function readSafePluginManifest(options: ReadPluginManifestOptions)
 
   const realManifestPath = await fs.realpath(options.manifestPath);
   if (!isUnderPath(realManifestPath, realInstallPath)) throw new Error("Plugin manifest path is outside install path.");
-  if (dirname(realManifestPath) !== realInstallPath || basename(realManifestPath) !== OPENPETS_PLUGIN_MANIFEST_FILENAME) throw new Error("Plugin manifest path is invalid.");
+  if (dirname(realManifestPath) !== realInstallPath || basename(realManifestPath) !== FAMILIAROS_PLUGIN_MANIFEST_FILENAME) throw new Error("Plugin manifest path is invalid.");
 
   const stat = await fs.stat(realManifestPath);
   if (!stat.isFile()) throw new Error("Plugin manifest path is not a file.");
diff --git a/apps/desktop/src/plugin-manifest.ts b/apps/desktop/src/plugin-manifest.ts
index 8a1e732f..40164d92 100644
--- a/apps/desktop/src/plugin-manifest.ts
+++ b/apps/desktop/src/plugin-manifest.ts
@@ -1,14 +1,14 @@
 import { allowedReactions } from "./local-ipc-protocol.js";
 
-export const OPENPETS_PLUGIN_MANIFEST_FILENAME = "openpets.plugin.json";
-export const openPetsPluginManifestFilename = OPENPETS_PLUGIN_MANIFEST_FILENAME;
+export const FAMILIAROS_PLUGIN_MANIFEST_FILENAME = "familiaros.plugin.json";
+export const openPetsPluginManifestFilename = FAMILIAROS_PLUGIN_MANIFEST_FILENAME;
 
 export type PluginRuntime = "declarative";
 export type KnownPluginRuntime = PluginRuntime | "javascript";
 export type PluginPermission =
-  | "pet:speak"
-  | "pet:reaction"
-  | "pet:move"
+  | "familiar:speak"
+  | "familiar:reaction"
+  | "familiar:move"
   | "timer"
   | "schedule"
   | "storage"
@@ -16,13 +16,13 @@ export type PluginPermission =
   | "commands"
   | "network"
   // SDK v3 permissions (manifestVersion 3 only)
-  | "pet:interact"
-  | "pet:pin"
-  | "pet:animate"
-  | "pet:speak:dynamic"
-  | "pet:drop"
-  | "pets:read"
-  | "pets:manage"
+  | "familiar:interact"
+  | "familiar:pin"
+  | "familiar:animate"
+  | "familiar:speak:dynamic"
+  | "familiar:drop"
+  | "familiars:read"
+  | "familiars:manage"
   | "audio"
   | "events"
   | "ui:toast"
@@ -41,7 +41,7 @@ export type PluginPermission =
   | "network:write";
 export type PluginJavascriptPermission = Exclude<PluginPermission, "timer">;
 /** Permissions flagged sensitive in the UI (louder consent, global toggles). */
-export const sensitivePluginPermissions: ReadonlySet<PluginPermission> = new Set(["voice:listen", "clipboard", "pet:speak:dynamic"]);
+export const sensitivePluginPermissions: ReadonlySet<PluginPermission> = new Set(["voice:listen", "clipboard", "familiar:speak:dynamic"]);
 export type PluginIcon = "plugin" | "bell" | "timer" | "github" | "heart" | "sparkles" | "coffee" | "focus" | "droplet";
 export type PluginConfigFieldType = "text" | "textarea" | "number" | "boolean" | "select" | "time" | "date" | "multiSelect" | "list" | "secret" | "sound";
 
@@ -65,11 +65,11 @@ export type PluginConfigField = {
 };
 
 export type PluginStringConfigRef = { config: string };
-export type PluginAction = { type: "pet.speak"; message: string | PluginStringConfigRef } | { type: "pet.react"; reaction: string | PluginStringConfigRef };
+export type PluginAction = { type: "familiar.speak"; message: string | PluginStringConfigRef } | { type: "familiar.react"; reaction: string | PluginStringConfigRef };
 export type PluginTimerEveryMinutes = number | { config: string };
 export type PluginTrigger = { on: "timer"; everyMinutes: PluginTimerEveryMinutes; actions: PluginAction[] };
 
-export type OpenPetsDeclarativePluginManifest = {
+export type FamiliarOSDeclarativePluginManifest = {
   manifestVersion: 1;
   id: string;
   name: string;
@@ -82,7 +82,7 @@ export type OpenPetsDeclarativePluginManifest = {
   triggers: PluginTrigger[];
 };
 
-export type OpenPetsJavascriptPluginManifest = {
+export type FamiliarOSJavascriptPluginManifest = {
   manifestVersion: 2 | 3;
   id: string;
   name: string;
@@ -101,7 +101,7 @@ export type OpenPetsJavascriptPluginManifest = {
   panels?: Record<string, string>;
 };
 
-export type OpenPetsPluginManifest = OpenPetsDeclarativePluginManifest | OpenPetsJavascriptPluginManifest;
+export type FamiliarOSPluginManifest = FamiliarOSDeclarativePluginManifest | FamiliarOSJavascriptPluginManifest;
 
 export type PluginManifestValidationError = {
   path: string;
@@ -110,7 +110,7 @@ export type PluginManifestValidationError = {
 };
 
 export type PluginManifestValidationResult =
-  | { ok: true; manifest: OpenPetsPluginManifest; errors: [] }
+  | { ok: true; manifest: FamiliarOSPluginManifest; errors: [] }
   | { ok: false; errors: PluginManifestValidationError[] };
 
 // "$schema" is tolerated everywhere so manifests can opt into editor validation.
@@ -127,13 +127,13 @@ const deferredConfigTypes = new Set(["multi-select", "schedule", "connection"]);
 const deferredConfigFeatures = new Set(["dynamicOptions"]);
 const supportedPluginIcons = new Set(["plugin", "bell", "timer", "github", "heart", "sparkles", "coffee", "focus", "droplet"]);
 export const pluginV3Permissions = [
-  "pet:interact",
-  "pet:pin",
-  "pet:animate",
-  "pet:speak:dynamic",
-  "pet:drop",
-  "pets:read",
-  "pets:manage",
+  "familiar:interact",
+  "familiar:pin",
+  "familiar:animate",
+  "familiar:speak:dynamic",
+  "familiar:drop",
+  "familiars:read",
+  "familiars:manage",
   "audio",
   "events",
   "ui:toast",
@@ -151,11 +151,11 @@ export const pluginV3Permissions = [
   "clipboard",
   "network:write",
 ] as const satisfies readonly PluginPermission[];
-export const pluginPermissions = ["pet:speak", "pet:reaction", "pet:move", "timer", "schedule", "storage", "status", "commands", "network", ...pluginV3Permissions] as const satisfies readonly PluginPermission[];
-const javascriptPluginPermissionsV2 = ["pet:speak", "pet:reaction", "pet:move", "schedule", "storage", "status", "commands", "network"] as const satisfies readonly PluginJavascriptPermission[];
+export const pluginPermissions = ["familiar:speak", "familiar:reaction", "familiar:move", "timer", "schedule", "storage", "status", "commands", "network", ...pluginV3Permissions] as const satisfies readonly PluginPermission[];
+const javascriptPluginPermissionsV2 = ["familiar:speak", "familiar:reaction", "familiar:move", "schedule", "storage", "status", "commands", "network"] as const satisfies readonly PluginJavascriptPermission[];
 const javascriptPluginPermissionsV3 = [...javascriptPluginPermissionsV2, ...pluginV3Permissions] as const satisfies readonly PluginJavascriptPermission[];
 export const pluginPermissionSet: ReadonlySet<string> = new Set(pluginPermissions);
-const declarativePluginPermissionSet: ReadonlySet<string> = new Set(["pet:speak", "pet:reaction", "timer"]);
+const declarativePluginPermissionSet: ReadonlySet<string> = new Set(["familiar:speak", "familiar:reaction", "timer"]);
 const pluginAssetKinds = ["icons", "images", "svgs", "sprites", "sounds"] as const satisfies readonly PluginAssetKind[];
 const pluginAssetExtensions: Record<PluginAssetKind, readonly string[]> = {
   icons: [".png", ".webp", ".svg"],
@@ -213,7 +213,7 @@ export function validatePluginManifest(input: unknown): PluginManifestValidation
   validateTriggers(input.triggers, permissions, configFields, errors);
 
   if (errors.length > 0) return { ok: false, errors };
-  return { ok: true, manifest: input as OpenPetsPluginManifest, errors: [] };
+  return { ok: true, manifest: input as FamiliarOSPluginManifest, errors: [] };
 }
 
 function validateJavascriptPluginManifest(input: Record<string, unknown>, manifestVersion: 2 | 3): PluginManifestValidationResult {
@@ -238,7 +238,7 @@ function validateJavascriptPluginManifest(input: Record<string, unknown>, manife
     validatePanels(input.panels, errors);
   }
   if (errors.length > 0) return { ok: false, errors };
-  return { ok: true, manifest: input as OpenPetsPluginManifest, errors: [] };
+  return { ok: true, manifest: input as FamiliarOSPluginManifest, errors: [] };
 }
 
 function validateJavascriptPermissions(value: unknown, manifestVersion: 2 | 3, errors: PluginManifestValidationError[]): Set<string> {
@@ -460,28 +460,28 @@ function validateReactionSelectReference(schema: Record<string, unknown>, fieldN
   if (!isRecord(field) || field.type !== "select") return;
   const reactions = new Set<string>(allowedReactions);
   if (!Object.prototype.hasOwnProperty.call(field, "default") || typeof field.default !== "string" || !reactions.has(field.default)) {
-    addError(errors, `${path}.config`, "invalid_reaction_config_reference", "Reaction select config must have a valid OpenPets reaction default.");
+    addError(errors, `${path}.config`, "invalid_reaction_config_reference", "Reaction select config must have a valid FamiliarOS reaction default.");
   }
   if (Array.isArray(field.options)) {
     for (const option of field.options) {
-      if (isRecord(option) && typeof option.value === "string" && !reactions.has(option.value)) addError(errors, `${path}.config`, "invalid_reaction_config_reference", "Reaction select options must be valid OpenPets reactions.");
+      if (isRecord(option) && typeof option.value === "string" && !reactions.has(option.value)) addError(errors, `${path}.config`, "invalid_reaction_config_reference", "Reaction select options must be valid FamiliarOS reactions.");
     }
   }
 }
 
 function validateAction(value: unknown, permissions: Set<string>, configFields: ConfigFieldSets, path: string, errors: PluginManifestValidationError[]): void {
   if (!isRecord(value)) return addError(errors, path, "invalid_action", "Action must be an object.");
-  if (value.type === "pet.speak") {
+  if (value.type === "familiar.speak") {
     rejectUnknownFields(value, speakActionFields, path, errors);
     validateStringOrConfigRef(value.message, configFields.text, `${path}.message`, "message", "text", errors);
-    requirePermission(permissions, "pet:speak", path, errors);
-  } else if (value.type === "pet.react") {
+    requirePermission(permissions, "familiar:speak", path, errors);
+  } else if (value.type === "familiar.react") {
     rejectUnknownFields(value, reactActionFields, path, errors);
     validateStringOrConfigRef(value.reaction, configFields.select, `${path}.reaction`, "reaction", "select", errors);
     if (isRecord(value.reaction) && typeof value.reaction.config === "string" && configFields.select.has(value.reaction.config)) validateReactionSelectReference(configFields.schema, value.reaction.config, `${path}.reaction`, errors);
-    requirePermission(permissions, "pet:reaction", path, errors);
+    requirePermission(permissions, "familiar:reaction", path, errors);
   } else {
-    addError(errors, `${path}.type`, "invalid_action", "Action type must be pet.speak or pet.react.");
+    addError(errors, `${path}.type`, "invalid_action", "Action type must be familiar.speak or familiar.react.");
   }
 }
 
diff --git a/apps/desktop/src/plugin-oauth.ts b/apps/desktop/src/plugin-oauth.ts
index 2dd45cf6..0f5c8c2b 100644
--- a/apps/desktop/src/plugin-oauth.ts
+++ b/apps/desktop/src/plugin-oauth.ts
@@ -115,11 +115,11 @@ async function startLoopbackListener(stateToken: string): Promise<{ server: Serv
       const state = url.searchParams.get("state");
       response.writeHead(200, { "content-type": "text/html; charset=utf-8" });
       if (error || !code || state !== stateToken) {
-        response.end("<html><body><p>OpenPets sign-in failed. You can close this tab.</p></body></html>");
+        response.end("<html><body><p>FamiliarOS sign-in failed. You can close this tab.</p></body></html>");
         rejectCode(new Error(error ? `OAuth authorization failed: ${error}` : "OAuth authorization response was invalid."));
         return;
       }
-      response.end("<html><body><p>OpenPets is connected. You can close this tab.</p></body></html>");
+      response.end("<html><body><p>FamiliarOS is connected. You can close this tab.</p></body></html>");
       clearTimeout(timeout);
       resolveCode(code);
     } catch {
diff --git a/apps/desktop/src/plugin-package.ts b/apps/desktop/src/plugin-package.ts
index e328bcf0..b3df0a81 100644
--- a/apps/desktop/src/plugin-package.ts
+++ b/apps/desktop/src/plugin-package.ts
@@ -6,14 +6,14 @@ import type { Entry, ZipFile } from "yauzl";
 import { collectDeclaredPluginFiles, preparePluginFileBytes } from "./plugin-assets.js";
 import { type PluginCatalogEntry, type PluginCatalogEntryV2 } from "./plugin-catalog-validation.js";
 import { defaultMaxPluginManifestBytes, readSafePluginManifest, isUnderPath } from "./plugin-manifest-reader.js";
-import { canonicalizePluginPermissions, OPENPETS_PLUGIN_MANIFEST_FILENAME, validatePluginManifest, type OpenPetsPluginManifest } from "./plugin-manifest.js";
+import { canonicalizePluginPermissions, FAMILIAROS_PLUGIN_MANIFEST_FILENAME, validatePluginManifest, type FamiliarOSPluginManifest } from "./plugin-manifest.js";
 
 const maxZipBytes = 16 * 1024 * 1024;
 const maxPluginEntryBytes = 1024 * 1024;
 const maxPluginZipEntries = 2 + 32 * 5 + 8;
 const maxPluginZipUncompressedBytes = 32 * 1024 * 1024;
 const maxPluginZipFileBytes = 5 * 1024 * 1024;
-export type PluginPackageInstall = { readonly manifest: OpenPetsPluginManifest; readonly installPath: string; readonly manifestPath: string; readonly entryPath?: string };
+export type PluginPackageInstall = { readonly manifest: FamiliarOSPluginManifest; readonly installPath: string; readonly manifestPath: string; readonly entryPath?: string };
 
 type AnyPluginCatalogEntry = PluginCatalogEntry | PluginCatalogEntryV2;
 
@@ -24,12 +24,12 @@ export async function downloadCatalogPluginZip(entry: AnyPluginCatalogEntry, fet
   finally { clearTimeout(timeout); }
 }
 
-export function validatePluginZipUrl(value: string): void { const url = new URL(value); if (url.protocol !== "https:" || url.hostname !== "zip.openpets.dev" || !url.pathname.startsWith("/plugins/") || url.username || url.password || url.port) throw new Error("Plugin ZIP URL is not allowed."); }
+export function validatePluginZipUrl(value: string): void { const url = new URL(value); if (url.protocol !== "https:" || url.hostname !== "zip.familiaros.dev" || !url.pathname.startsWith("/plugins/") || url.username || url.password || url.port) throw new Error("Plugin ZIP URL is not allowed."); }
 
-export async function readCatalogPluginManifestFromZip(options: { readonly catalogEntry: AnyPluginCatalogEntry; readonly zip: Buffer; readonly maxManifestBytes?: number; readonly maxEntryBytes?: number }): Promise<{ readonly manifest: OpenPetsPluginManifest; readonly manifestText: string; readonly entryText?: string; readonly declaredFiles?: ReadonlyMap<string, Buffer> }> {
+export async function readCatalogPluginManifestFromZip(options: { readonly catalogEntry: AnyPluginCatalogEntry; readonly zip: Buffer; readonly maxManifestBytes?: number; readonly maxEntryBytes?: number }): Promise<{ readonly manifest: FamiliarOSPluginManifest; readonly manifestText: string; readonly entryText?: string; readonly declaredFiles?: ReadonlyMap<string, Buffer> }> {
   const files = await readPluginZipFiles(options.zip, options.maxManifestBytes ?? defaultMaxPluginManifestBytes, options.maxEntryBytes ?? maxPluginEntryBytes);
-  const text = files.get(OPENPETS_PLUGIN_MANIFEST_FILENAME)?.toString("utf8");
-  if (text === undefined) throw new Error("Plugin ZIP must contain openpets.plugin.json.");
+  const text = files.get(FAMILIAROS_PLUGIN_MANIFEST_FILENAME)?.toString("utf8");
+  if (text === undefined) throw new Error("Plugin ZIP must contain familiaros.plugin.json.");
   const parsed = JSON.parse(text) as unknown; const result = validatePluginManifest(parsed); if (!result.ok) throw new Error("Plugin manifest validation failed.");
   const manifest = result.manifest; assertCatalogConsistency(options.catalogEntry, manifest);
   let entryText: string | undefined;
@@ -46,7 +46,7 @@ export async function readCatalogPluginManifestFromZip(options: { readonly catal
       if (bytes === undefined) throw new Error(`Plugin ZIP is missing declared file: ${file.relPath}`);
       declaredFiles.set(file.relPath, preparePluginFileBytes(file, bytes));
     }
-    const allowed = new Set([OPENPETS_PLUGIN_MANIFEST_FILENAME, manifest.entry, ...declared.map((file) => file.relPath)]);
+    const allowed = new Set([FAMILIAROS_PLUGIN_MANIFEST_FILENAME, manifest.entry, ...declared.map((file) => file.relPath)]);
     for (const name of files.keys()) if (!allowed.has(name)) throw new Error(`Plugin ZIP contains an undeclared file: ${name}`);
     return { manifest, manifestText: text, entryText, declaredFiles };
   } else if (files.size !== 1) throw new Error("Plugin ZIP must contain exactly one root manifest file.");
@@ -56,13 +56,13 @@ export async function readCatalogPluginManifestFromZip(options: { readonly catal
 export async function installCatalogPluginPackage(options: { readonly userDataPath: string; readonly catalogEntry: AnyPluginCatalogEntry; readonly zip: Buffer; readonly maxManifestBytes?: number }): Promise<PluginPackageInstall> {
   const { manifest, manifestText: text, entryText, declaredFiles } = await readCatalogPluginManifestFromZip(options);
   const root = join(options.userDataPath, "plugins"); await fs.mkdir(root, { recursive: true }); await assertDir(root);
-  const installPath = join(root, manifest.id); const manifestPath = join(installPath, OPENPETS_PLUGIN_MANIFEST_FILENAME); const tempPath = join(root, `.tmp-${manifest.id}-${process.pid}-${Date.now()}`);
+  const installPath = join(root, manifest.id); const manifestPath = join(installPath, FAMILIAROS_PLUGIN_MANIFEST_FILENAME); const tempPath = join(root, `.tmp-${manifest.id}-${process.pid}-${Date.now()}`);
   const entryPath = manifest.manifestVersion === 2 || manifest.manifestVersion === 3 ? join(installPath, manifest.entry) : undefined;
   try {
     await fs.rm(tempPath, { recursive: true, force: true });
     await fs.mkdir(tempPath, { recursive: false, mode: 0o700 });
     await assertDir(tempPath);
-    await fs.writeFile(join(tempPath, OPENPETS_PLUGIN_MANIFEST_FILENAME), text, { mode: 0o600 });
+    await fs.writeFile(join(tempPath, FAMILIAROS_PLUGIN_MANIFEST_FILENAME), text, { mode: 0o600 });
     if ((manifest.manifestVersion === 2 || manifest.manifestVersion === 3) && entryPath && entryText !== undefined) {
       if (Buffer.byteLength(entryText) > maxPluginEntryBytes) throw new Error("Plugin entry file is too large.");
       const tempEntryPath = join(tempPath, manifest.entry);
@@ -74,7 +74,7 @@ export async function installCatalogPluginPackage(options: { readonly userDataPa
         await fs.writeFile(filePath, bytes, { mode: 0o600 });
       }
     }
-    await readSafePluginManifest({ installPath: tempPath, manifestPath: join(tempPath, OPENPETS_PLUGIN_MANIFEST_FILENAME), allowedPluginRoots: [root], maxManifestBytes: options.maxManifestBytes, expectedId: manifest.id, expectedVersion: manifest.version });
+    await readSafePluginManifest({ installPath: tempPath, manifestPath: join(tempPath, FAMILIAROS_PLUGIN_MANIFEST_FILENAME), allowedPluginRoots: [root], maxManifestBytes: options.maxManifestBytes, expectedId: manifest.id, expectedVersion: manifest.version });
     await replaceInstallDirectory(root, installPath, tempPath);
   } catch (e) { await fs.rm(tempPath, { recursive: true, force: true }); throw e; }
   const copied = await readSafePluginManifest({ installPath, manifestPath, allowedPluginRoots: [root], maxManifestBytes: options.maxManifestBytes, expectedId: manifest.id, expectedVersion: manifest.version });
@@ -85,8 +85,8 @@ export async function resolveSafePluginInstallDir(userDataPath: string, id: stri
 
 export async function safeDeletePluginInstallDir(userDataPath: string, id: string, installPath: string, source: "catalog" | "local"): Promise<void> { const realInstall = await resolveSafePluginInstallDir(userDataPath, id, installPath, source); await fs.rm(realInstall, { recursive: true, force: true }); }
 
-function assertCatalogConsistency(entry: AnyPluginCatalogEntry, manifest: OpenPetsPluginManifest): void { const entryPermissions = canonicalizePluginPermissions(entry.permissions); const manifestPermissions = canonicalizePluginPermissions(manifest.permissions); const entrySdk = "sdkVersion" in entry ? entry.sdkVersion : undefined; const manifestSdk = "sdkVersion" in manifest ? manifest.sdkVersion : undefined; const entryHosts = "network" in entry ? entry.network?.hosts ?? [] : []; const manifestHosts = "network" in manifest ? manifest.network?.hosts ?? [] : []; if (entry.id !== manifest.id || entry.version !== manifest.version || entry.name !== manifest.name || entry.runtime !== manifest.runtime || entryPermissions.join("\0") !== manifestPermissions.join("\0") || entrySdk !== manifestSdk || entryHosts.join("\0") !== manifestHosts.join("\0")) throw new Error("Plugin manifest does not match catalog entry."); }
-async function readPluginZipFiles(zip: Buffer, maxManifestBytes: number, maxEntryBytes: number): Promise<Map<string, Buffer>> { const zipFile = await new Promise<ZipFile>((res, rej) => yauzl.fromBuffer(zip, { lazyEntries: true, validateEntrySizes: true }, (e, z) => e || !z ? rej(e ?? new Error("Unable to open plugin ZIP.")) : res(z))); const files = new Map<string, Buffer>(); let entryCount = 0; let totalUncompressed = 0; await new Promise<void>((resolve, reject) => { zipFile.on("error", reject); zipFile.on("end", resolve); zipFile.on("entry", (entry: Entry) => { try { entryCount += 1; if (entryCount > maxPluginZipEntries) throw new Error("Plugin ZIP contains too many entries."); totalUncompressed += entry.uncompressedSize; if (totalUncompressed > maxPluginZipUncompressedBytes) throw new Error("Plugin ZIP uncompressed size is too large."); const name = validateEntry(entry); if (files.has(name)) throw new Error("Plugin ZIP contains duplicate entry path."); const limit = name === OPENPETS_PLUGIN_MANIFEST_FILENAME ? maxManifestBytes : name.endsWith(".js") || name.endsWith(".mjs") ? maxEntryBytes : maxPluginZipFileBytes; if (entry.uncompressedSize > limit) throw new Error(name === OPENPETS_PLUGIN_MANIFEST_FILENAME ? "Plugin manifest is too large." : "Plugin entry file is too large."); zipFile.openReadStream(entry, (err, stream) => { if (err || !stream) return reject(err ?? new Error("Unable to read plugin ZIP entry.")); const chunks: Buffer[] = []; let total = 0; stream.on("data", (chunk: Buffer) => { total += chunk.length; if (total > limit) { stream.destroy(new Error("Plugin ZIP entry is too large.")); return; } chunks.push(chunk); }); stream.on("error", reject); stream.on("end", () => { files.set(name, Buffer.concat(chunks)); zipFile.readEntry(); }); }); } catch (e) { reject(e); } }); zipFile.readEntry(); }).finally(() => zipFile.close()); return files; }
+function assertCatalogConsistency(entry: AnyPluginCatalogEntry, manifest: FamiliarOSPluginManifest): void { const entryPermissions = canonicalizePluginPermissions(entry.permissions); const manifestPermissions = canonicalizePluginPermissions(manifest.permissions); const entrySdk = "sdkVersion" in entry ? entry.sdkVersion : undefined; const manifestSdk = "sdkVersion" in manifest ? manifest.sdkVersion : undefined; const entryHosts = "network" in entry ? entry.network?.hosts ?? [] : []; const manifestHosts = "network" in manifest ? manifest.network?.hosts ?? [] : []; if (entry.id !== manifest.id || entry.version !== manifest.version || entry.name !== manifest.name || entry.runtime !== manifest.runtime || entryPermissions.join("\0") !== manifestPermissions.join("\0") || entrySdk !== manifestSdk || entryHosts.join("\0") !== manifestHosts.join("\0")) throw new Error("Plugin manifest does not match catalog entry."); }
+async function readPluginZipFiles(zip: Buffer, maxManifestBytes: number, maxEntryBytes: number): Promise<Map<string, Buffer>> { const zipFile = await new Promise<ZipFile>((res, rej) => yauzl.fromBuffer(zip, { lazyEntries: true, validateEntrySizes: true }, (e, z) => e || !z ? rej(e ?? new Error("Unable to open plugin ZIP.")) : res(z))); const files = new Map<string, Buffer>(); let entryCount = 0; let totalUncompressed = 0; await new Promise<void>((resolve, reject) => { zipFile.on("error", reject); zipFile.on("end", resolve); zipFile.on("entry", (entry: Entry) => { try { entryCount += 1; if (entryCount > maxPluginZipEntries) throw new Error("Plugin ZIP contains too many entries."); totalUncompressed += entry.uncompressedSize; if (totalUncompressed > maxPluginZipUncompressedBytes) throw new Error("Plugin ZIP uncompressed size is too large."); const name = validateEntry(entry); if (files.has(name)) throw new Error("Plugin ZIP contains duplicate entry path."); const limit = name === FAMILIAROS_PLUGIN_MANIFEST_FILENAME ? maxManifestBytes : name.endsWith(".js") || name.endsWith(".mjs") ? maxEntryBytes : maxPluginZipFileBytes; if (entry.uncompressedSize > limit) throw new Error(name === FAMILIAROS_PLUGIN_MANIFEST_FILENAME ? "Plugin manifest is too large." : "Plugin entry file is too large."); zipFile.openReadStream(entry, (err, stream) => { if (err || !stream) return reject(err ?? new Error("Unable to read plugin ZIP entry.")); const chunks: Buffer[] = []; let total = 0; stream.on("data", (chunk: Buffer) => { total += chunk.length; if (total > limit) { stream.destroy(new Error("Plugin ZIP entry is too large.")); return; } chunks.push(chunk); }); stream.on("error", reject); stream.on("end", () => { files.set(name, Buffer.concat(chunks)); zipFile.readEntry(); }); }); } catch (e) { reject(e); } }); zipFile.readEntry(); }).finally(() => zipFile.close()); return files; }
 function validateEntry(entry: Entry): string { const normalized = posix.normalize(entry.fileName); if (entry.fileName.includes("\\") || entry.fileName.includes("\0") || entry.fileName.startsWith("/") || /^[A-Za-z]:/.test(entry.fileName) || normalized !== entry.fileName || normalized.startsWith("../") || normalized === "." || normalized.includes("/../")) throw new Error("Plugin ZIP entry path is invalid."); if (entry.fileName.endsWith("/")) throw new Error("Plugin ZIP directory entries are unsupported."); if (entry.compressionMethod !== 0 && entry.compressionMethod !== 8) throw new Error("Unsupported plugin ZIP entry compression method."); const type = (entry.externalFileAttributes >>> 16) & 0o170000; if (type === 0o120000 || (type !== 0 && type !== 0o100000)) throw new Error("Plugin ZIP entry type is unsupported."); if (entry.generalPurposeBitFlag & 0x1) throw new Error("Encrypted plugin ZIP entries are unsupported."); return normalized; }
 async function assertDir(path: string): Promise<void> { const stat = await fs.lstat(path); if (!stat.isDirectory() || stat.isSymbolicLink()) throw new Error("Plugin directory is invalid."); }
 async function replaceInstallDirectory(root: string, installPath: string, tempPath: string): Promise<void> { const backupPath = join(root, `.bak-${Date.now()}-${process.pid}`); let hadExisting = false; try { await assertDir(tempPath); try { await assertDir(installPath); hadExisting = true; } catch (error) { const code = typeof error === "object" && error !== null && "code" in error ? (error as { code?: unknown }).code : undefined; if (code !== "ENOENT") throw error; } if (hadExisting) await fs.rename(installPath, backupPath); await fs.rename(tempPath, installPath); await fs.rm(backupPath, { recursive: true, force: true }); } catch (error) { await fs.rm(installPath, { recursive: true, force: true }).catch(() => undefined); if (hadExisting) await fs.rename(backupPath, installPath).catch(() => undefined); throw error; } }
diff --git a/apps/desktop/src/plugin-panels.ts b/apps/desktop/src/plugin-panels.ts
index d90d4b03..2126cd2d 100644
--- a/apps/desktop/src/plugin-panels.ts
+++ b/apps/desktop/src/plugin-panels.ts
@@ -41,8 +41,8 @@ export async function openPluginPanel(options: OpenPluginPanelOptions): Promise<
   if (!panelStat.isFile()) throw new Error("Plugin panel page is not a file.");
 
   const token = randomBytes(16).toString("hex");
-  const channel = `openpets:plugin-panel:${token}`;
-  const partition = `openpets-panel:${encodeURIComponent(options.pluginId)}:${Date.now()}`;
+  const channel = `familiaros:plugin-panel:${token}`;
+  const partition = `familiaros-panel:${encodeURIComponent(options.pluginId)}:${Date.now()}`;
   const panelSession = session.fromPartition(partition, { cache: false });
   panelSession.setPermissionRequestHandler((_contents, _permission, callback) => callback(false));
   panelSession.setPermissionCheckHandler(() => false);
@@ -54,7 +54,7 @@ export async function openPluginPanel(options: OpenPluginPanelOptions): Promise<
   });
 
   const window = new BrowserWindow({
-    title: options.title ?? "OpenPets plugin",
+    title: options.title ?? "FamiliarOS plugin",
     width: options.width ?? 420,
     height: options.height ?? 480,
     show: false,
@@ -67,7 +67,7 @@ export async function openPluginPanel(options: OpenPluginPanelOptions): Promise<
       allowRunningInsecureContent: false,
       partition,
       preload: `${app.getAppPath()}/panel-preload.cjs`,
-      additionalArguments: [`--openpets-panel-token=${token}`],
+      additionalArguments: [`--familiaros-panel-token=${token}`],
     },
   });
   window.setMenu(null);
diff --git a/apps/desktop/src/plugin-platform-settings.ts b/apps/desktop/src/plugin-platform-settings.ts
index 7aad80b7..e3c30506 100644
--- a/apps/desktop/src/plugin-platform-settings.ts
+++ b/apps/desktop/src/plugin-platform-settings.ts
@@ -28,7 +28,7 @@ export const defaultPluginPlatformSettings: PluginPlatformSettings = {
   ai: { provider: "none", model: "" },
 };
 
-const settingsFileName = "openpets-plugin-platform.json";
+const settingsFileName = "familiaros-plugin-platform.json";
 let settingsPath: string | null = null;
 let cached: PluginPlatformSettings = defaultPluginPlatformSettings;
 
diff --git a/apps/desktop/src/plugin-runtime.ts b/apps/desktop/src/plugin-runtime.ts
index 5c6fb211..549a63ad 100644
--- a/apps/desktop/src/plugin-runtime.ts
+++ b/apps/desktop/src/plugin-runtime.ts
@@ -1,13 +1,13 @@
 import { promises as fs } from "node:fs";
 import { relative, resolve, sep } from "node:path";
 
-import { validateReaction, validateSayMessage, type OpenPetsReaction } from "./local-ipc-protocol.js";
+import { validateReaction, validateSayMessage, type FamiliarOSReaction } from "./local-ipc-protocol.js";
 import { resolvePluginNumericConfig, resolvePluginStringConfig } from "./plugin-config.js";
 import type { PluginJsHost, PluginJsHostInstance } from "./plugin-js-host.js";
 import { loadPluginLocales, registerPluginLocales, unregisterPluginLocales } from "./plugin-i18n.js";
 import { defaultMaxPluginManifestBytes, readSafePluginManifest } from "./plugin-manifest-reader.js";
-import { type OpenPetsJavascriptPluginManifest, type OpenPetsPluginManifest, type PluginAction } from "./plugin-manifest.js";
-import type { PluginPetApi } from "./plugin-pet-api.js";
+import { type FamiliarOSJavascriptPluginManifest, type FamiliarOSPluginManifest, type PluginAction } from "./plugin-manifest.js";
+import type { PluginPetApi } from "./plugin-familiar-api.js";
 import { PluginSdkBridge, type PluginHostCapabilities, type PluginLogLevel, type PluginRuntimePublicState, type PluginStorageStore } from "./plugin-sdk-bridge.js";
 import type { PluginInspectorState } from "./plugin-sdk-state.js";
 import type { PluginStateRecord, PluginStateStore } from "./plugin-state.js";
@@ -37,7 +37,7 @@ export type PluginRuntimeOptions = {
 };
 
 type CompiledTimer = { readonly intervalMs: number; readonly actions: readonly CompiledAction[] };
-type CompiledAction = { readonly type: "pet.speak"; readonly message: string } | { readonly type: "pet.react"; readonly reaction: OpenPetsReaction };
+type CompiledAction = { readonly type: "familiar.speak"; readonly message: string } | { readonly type: "familiar.react"; readonly reaction: FamiliarOSReaction };
 type PluginRuntimeSlot = { generation: number; active: boolean; timers: PluginTimerHandle[]; jsHost?: PluginJsHostInstance };
 
 export class PluginRuntime {
@@ -136,7 +136,7 @@ export class PluginRuntime {
     return current?.enabled === true && current.catalogDisabled !== true && current.version === record.version && current.manifestPath === record.manifestPath && current.installPath === record.installPath;
   }
 
-  #compileDeclarativePlugin(record: PluginStateRecord, manifest: OpenPetsPluginManifest): CompiledTimer[] {
+  #compileDeclarativePlugin(record: PluginStateRecord, manifest: FamiliarOSPluginManifest): CompiledTimer[] {
     if (manifest.runtime !== "declarative") throw new Error("Plugin runtime is not declarative.");
     const approved = new Set(record.approvedPermissions);
     for (const permission of manifest.permissions) if (!approved.has(permission)) throw new Error(`Plugin permission is not approved: ${permission}`);
@@ -148,7 +148,7 @@ export class PluginRuntime {
     });
   }
 
-  async #startJavascriptPlugin(record: PluginStateRecord, manifest: OpenPetsJavascriptPluginManifest, slot: PluginRuntimeSlot, generation: number): Promise<void> {
+  async #startJavascriptPlugin(record: PluginStateRecord, manifest: FamiliarOSJavascriptPluginManifest, slot: PluginRuntimeSlot, generation: number): Promise<void> {
     if (!this.#jsHost) throw new Error("JavaScript plugin host is unavailable.");
     const approved = new Set(record.approvedPermissions);
     for (const permission of manifest.permissions) if (!approved.has(permission)) throw new Error(`Plugin permission is not approved: ${permission}`);
@@ -184,7 +184,7 @@ export class PluginRuntime {
       logPluginDiagnostic(this.#logger, "debug", "plugin declarative schedule fired", { pluginId: id, runtime: "declarative", scheduleId: String(generation) });
       for (const action of timer.actions) {
         if (!this.#active || !slot.active || slot.generation !== generation) return;
-        if (action.type === "pet.speak") await this.#petApi.speak(action.message);
+        if (action.type === "familiar.speak") await this.#petApi.speak(action.message);
         else await this.#petApi.react(action.reaction);
       }
       if (this.#active && slot.active && slot.generation === generation) this.#scheduleTimer(id, slot, generation, timer);
@@ -226,18 +226,18 @@ export class PluginRuntime {
   }
 }
 
-function compileAction(record: PluginStateRecord, manifest: OpenPetsPluginManifest, action: PluginAction, approved: Set<string>): CompiledAction {
-  if (action.type === "pet.speak") {
-    if (!approved.has("pet:speak")) throw new Error("Plugin speak permission is not approved.");
+function compileAction(record: PluginStateRecord, manifest: FamiliarOSPluginManifest, action: PluginAction, approved: Set<string>): CompiledAction {
+  if (action.type === "familiar.speak") {
+    if (!approved.has("familiar:speak")) throw new Error("Plugin speak permission is not approved.");
     const message = typeof action.message === "string" ? action.message : resolvePluginStringConfig(manifest, record.config, action.message.config, "text");
-    return { type: "pet.speak", message: validateSayMessage(message) };
+    return { type: "familiar.speak", message: validateSayMessage(message) };
   }
-  if (!approved.has("pet:reaction")) throw new Error("Plugin reaction permission is not approved.");
+  if (!approved.has("familiar:reaction")) throw new Error("Plugin reaction permission is not approved.");
   const reaction = typeof action.reaction === "string" ? action.reaction : resolvePluginStringConfig(manifest, record.config, action.reaction.config, "select");
-  return { type: "pet.react", reaction: validateReaction(reaction) };
+  return { type: "familiar.react", reaction: validateReaction(reaction) };
 }
 
-function resolveTimerInterval(record: PluginStateRecord, manifest: OpenPetsPluginManifest, value: number | { config: string }, triggerIndex: number): number {
+function resolveTimerInterval(record: PluginStateRecord, manifest: FamiliarOSPluginManifest, value: number | { config: string }, triggerIndex: number): number {
   const interval = typeof value === "number" ? value : resolvePluginNumericConfig(manifest, record.config, value.config, { min: 5 });
   if (!Number.isInteger(interval) || interval < 5) throw new Error(`Plugin timer interval for trigger ${triggerIndex} must be an integer of at least 5 minutes.`);
   return interval;
diff --git a/apps/desktop/src/plugin-sdk-bridge.ts b/apps/desktop/src/plugin-sdk-bridge.ts
index 9222ff8d..d8d1ef36 100644
--- a/apps/desktop/src/plugin-sdk-bridge.ts
+++ b/apps/desktop/src/plugin-sdk-bridge.ts
@@ -4,13 +4,13 @@ import * as net from "node:net";
 import { join } from "node:path";
 
 import { getActiveLocaleLang } from "./i18n/index.js";
-import type { OpenPetsReaction } from "./local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "./local-ipc-protocol.js";
 import { validateReaction, validateSayMessage } from "./local-ipc-protocol.js";
 import { makePluginT } from "./plugin-i18n.js";
 import { resolveDeclaredAssetPath, resolveDeclaredPanelPath } from "./plugin-assets.js";
 import type { PluginConfig } from "./plugin-config.js";
-import type { OpenPetsJavascriptPluginManifest, PluginAssetKind, PluginPermission } from "./plugin-manifest.js";
-import type { PluginPetApi } from "./plugin-pet-api.js";
+import type { FamiliarOSJavascriptPluginManifest, PluginAssetKind, PluginPermission } from "./plugin-manifest.js";
+import type { PluginPetApi } from "./plugin-familiar-api.js";
 import type { PluginRuntimeScheduler } from "./plugin-runtime.js";
 import { createPluginAudioApi } from "./plugin-sdk-audio.js";
 import { createPluginBusApi, type PluginBusTopicEntry } from "./plugin-sdk-bus.js";
@@ -119,7 +119,7 @@ export interface PluginBubbleHostHandle {
 
 export type PluginPetInfo = { id: string; name: string; kind: "default" | "agent" | "plugin"; visible: boolean };
 export type PluginPetState = { position: { x: number; y: number }; bounds: { x: number; y: number; width: number; height: number }; currentAnimation: string; visible: boolean; dragging: boolean };
-export type PluginAnimationSpec = { kind: "reaction"; reaction: OpenPetsReaction } | { kind: "sprite"; spritePath: string; loop: boolean; fps: number };
+export type PluginAnimationSpec = { kind: "reaction"; reaction: FamiliarOSReaction } | { kind: "sprite"; spritePath: string; loop: boolean; fps: number };
 export type PluginReactOptions = { showMessage?: boolean };
 export type PluginPickedFileHost = { fileId: string; name: string; sizeBytes: number };
 export type PluginAiRequest = { system?: string; messages: Array<{ role: "user" | "assistant"; content: string }>; maxTokens?: number; temperature?: number; tools?: Array<{ name: string; description?: string; inputSchema: Record<string, unknown> }> };
@@ -141,16 +141,16 @@ export interface PluginHostCapabilities {
   events: {
     subscribe(event: string, handler: (payload: Record<string, unknown>) => void): () => void;
   };
-  pets: {
+  familiars: {
     list(): PluginPetInfo[];
     spawn(opts: { pluginId: string; petId: string; name?: string; position?: { x: number; y: number } }): Promise<string>;
     close(pluginId: string, petHandleId: string): Promise<void>;
     show(petHandleId: string): Promise<void>;
     hide(petHandleId: string): Promise<void>;
-    react(petHandleId: string, reaction: OpenPetsReaction, options?: PluginReactOptions): Promise<void>;
+    react(petHandleId: string, reaction: FamiliarOSReaction, options?: PluginReactOptions): Promise<void>;
     setAnimation(petHandleId: string, spec: PluginAnimationSpec): Promise<void>;
     setScale(petHandleId: string, scale: number): Promise<void>;
-    setStatusReaction(petHandleId: string, reaction: OpenPetsReaction | null): Promise<void>;
+    setStatusReaction(petHandleId: string, reaction: FamiliarOSReaction | null): Promise<void>;
     moveBy(petHandleId: string, opts: { x: number; y: number; durationMs?: number }): Promise<void>;
     wander(petHandleId: string, opts: { distance?: number; durationMs?: number }): Promise<void>;
     moveToHome(petHandleId: string): Promise<void>;
@@ -159,7 +159,7 @@ export interface PluginHostCapabilities {
     physics(petHandleId: string, pluginId: string, opts: { gravity?: boolean; bounce?: number; climbEdges?: boolean }): Promise<void>;
     getState(petHandleId: string): Promise<PluginPetState>;
     onTick(petHandleId: string, handler: (dtMs: number) => void): () => void;
-    onChange(handler: (pets: PluginPetInfo[]) => void): () => void;
+    onChange(handler: (familiars: PluginPetInfo[]) => void): () => void;
   };
   toast(spec: { text: string; tone?: "info" | "success" | "warning" | "error"; durationMs?: number }): Promise<void>;
   notify(spec: { title: string; body?: string; sound?: boolean }): Promise<void>;
@@ -211,7 +211,7 @@ export interface PluginHostCapabilities {
 
 /**
  * Capability defaults used when the Electron layer is not wired (contract
- * tests, headless runs). Pet speech/reactions fall back to the v2 pet API;
+ * tests, headless runs). Familiar speech/reactions fall back to the v2 familiar API;
  * everything host-bound reports a clear, structured unavailability error.
  */
 export function createDefaultPluginHostCapabilities(petApi: PluginPetApi): PluginHostCapabilities {
@@ -232,10 +232,10 @@ export function createDefaultPluginHostCapabilities(petApi: PluginPetApi): Plugi
     },
     audio: { play: async () => undefined, importUserSound: async (_pluginId, _fileId, opts) => ({ kind: "user-sound", id: "0".repeat(32), name: opts?.name }), importUserSoundFromPath: async (_pluginId, _path, opts) => ({ kind: "user-sound", id: "0".repeat(32), name: opts?.name }), forgetUserSound: async () => undefined, stop: async () => undefined },
     events: { subscribe: () => () => undefined },
-    pets: {
-      list: () => [{ id: "default", name: "Default pet", kind: "default", visible: true }],
-      spawn: unavailable("pets.spawn"),
-      close: unavailable("pets.close"),
+    familiars: {
+      list: () => [{ id: "default", name: "Default familiar", kind: "default", visible: true }],
+      spawn: unavailable("familiars.spawn"),
+      close: unavailable("familiars.close"),
       show: async () => undefined,
       hide: async () => undefined,
       react: async (_petId, reaction, options) => { await petApi.react(reaction, options); },
@@ -245,7 +245,7 @@ export function createDefaultPluginHostCapabilities(petApi: PluginPetApi): Plugi
       moveBy: async (_petId, opts) => { await petApi.moveBy(opts); },
       wander: async (_petId, opts) => { await petApi.wander(opts); },
       moveToHome: async () => { await petApi.moveToHome(); },
-      moveTo: unavailable("pets.moveTo"),
+      moveTo: unavailable("familiars.moveTo"),
       followCursor: async () => undefined,
       physics: async () => undefined,
       getState: async () => ({ position: { x: 0, y: 0 }, bounds: { x: 0, y: 0, width: 0, height: 0 }, currentAnimation: "idle", visible: true, dragging: false }),
@@ -288,7 +288,7 @@ const quotas = pluginSdkQuotas;
 const commandIdPattern = /^[A-Za-z0-9._:-]{1,64}$/;
 const scheduleIdPattern = /^[A-Za-z0-9._:-]{1,64}$/;
 const allowedEventNames = new Set([
-  "pet:clicked", "pet:doubleClicked", "pet:dragStart", "pet:dragEnd", "pet:hover", "pet:drop",
+  "familiar:clicked", "familiar:doubleClicked", "familiar:dragStart", "familiar:dragEnd", "familiar:hover", "familiar:drop",
   "idle:enter", "idle:exit", "agent:activity", "config:changed",
   "screen:locked", "screen:unlocked", "power:battery-low", "power:charging",
   "display:changed", "online", "offline", "day:partChanged",
@@ -354,7 +354,7 @@ export class PluginSdkBridge {
     this.#capabilities = options.capabilities ?? createDefaultPluginHostCapabilities(options.petApi);
   }
 
-  createApi(record: PluginStateRecord, manifest: OpenPetsJavascriptPluginManifest) {
+  createApi(record: PluginStateRecord, manifest: FamiliarOSJavascriptPluginManifest) {
     const approved = new Set(record.approvedPermissions);
     const state = this.#pluginState(record.id);
     const caps = this.#capabilities;
@@ -402,8 +402,8 @@ export class PluginSdkBridge {
       const out: PluginBubbleDescriptor = { priority: "normal" };
       const dynamic = raw.dynamic === true;
       if (dynamic) {
-        requirePermission("pet:speak:dynamic");
-        check(caps.settings.dynamicSpeechAllowed(), "AI-generated pet speech is disabled in settings.");
+        requirePermission("familiar:speak:dynamic");
+        check(caps.settings.dynamicSpeechAllowed(), "AI-generated familiar speech is disabled in settings.");
         out.dynamic = true;
       }
       const pinned = raw.pin === true;
@@ -425,7 +425,7 @@ export class PluginSdkBridge {
       if (raw.accent !== undefined) { check(allowedAccents.has(String(raw.accent)), "Invalid bubble accent token."); out.accent = String(raw.accent); }
       if (raw.durationMs !== undefined) { const duration = Number(raw.durationMs); check(Number.isFinite(duration) && duration >= 500 && duration <= 10 * 60_000, "Invalid bubble durationMs."); out.durationMs = duration; }
       if (raw.sticky !== undefined) out.sticky = raw.sticky === true;
-      if (raw.pin !== undefined) { if (raw.pin === true) { requirePermission("pet:pin"); out.pin = true; if (out.sticky === undefined && out.durationMs === undefined) out.sticky = true; } }
+      if (raw.pin !== undefined) { if (raw.pin === true) { requirePermission("familiar:pin"); out.pin = true; if (out.sticky === undefined && out.durationMs === undefined) out.sticky = true; } }
       if (raw.hud !== undefined) {
         if (!forUpdate) {
           check(raw.pin === true, "Bubble HUD descriptor is only allowed for pinned bubbles.");
@@ -439,8 +439,8 @@ export class PluginSdkBridge {
       }
       if (raw.priority !== undefined) { check(["low", "normal", "high", "urgent"].includes(String(raw.priority)), "Invalid bubble priority."); out.priority = raw.priority as PluginBubbleDescriptor["priority"]; }
       if (raw.indicator !== undefined && raw.indicator !== false) out.indicator = validateBubbleIndicator(raw.indicator);
-      if (raw.actions !== undefined) { requirePermission("pet:interact"); out.actions = validateBubbleActions(raw.actions); }
-      if (raw.input !== undefined) { requirePermission("pet:interact"); out.input = validateBubbleInput(raw.input); }
+      if (raw.actions !== undefined) { requirePermission("familiar:interact"); out.actions = validateBubbleActions(raw.actions); }
+      if (raw.input !== undefined) { requirePermission("familiar:interact"); out.input = validateBubbleInput(raw.input); }
       if (out.text !== undefined || out.markdownHtml !== undefined) {
         check(out.iconName === undefined && out.svgPath === undefined && out.imagePath === undefined, "Plugin bubble body media cannot be combined with text or markdown. Use indicator for icon + message alerts.");
         check(out.hud === undefined, "Plugin bubble HUD cannot be combined with text or markdown.");
@@ -524,72 +524,72 @@ export class PluginSdkBridge {
 
     const petNamespace = (petHandleId: string) => ({
       speak: (spec: unknown) => ui.showBubble(petHandleId, spec),
-      react: async (reaction: OpenPetsReaction, options?: unknown) => {
-        requirePermission("pet:reaction");
-        state.petWindow.tick(quotas.petActionsPerMinute, "pet action");
+      react: async (reaction: FamiliarOSReaction, options?: unknown) => {
+        requirePermission("familiar:reaction");
+        state.petWindow.tick(quotas.petActionsPerMinute, "familiar action");
         const opts = validateReactOptions(options);
         if (petHandleId === "default") await this.#petApi.react(validateReaction(reaction), opts);
-        else await caps.pets.react(validatePetHandleId(petHandleId), validateReaction(reaction), opts);
+        else await caps.familiars.react(validatePetHandleId(petHandleId), validateReaction(reaction), opts);
       },
       setAnimation: async (animation: unknown) => {
-        state.petWindow.tick(quotas.petActionsPerMinute, "pet action");
-        if (typeof animation === "string") { requirePermission("pet:reaction"); await caps.pets.setAnimation(validatePetHandleId(petHandleId), { kind: "reaction", reaction: validateReaction(animation) }); return; }
-        requirePermission("pet:animate");
-        if (!isRecord(animation) || animation.sprite === undefined) throw new Error("Invalid pet animation state.");
+        state.petWindow.tick(quotas.petActionsPerMinute, "familiar action");
+        if (typeof animation === "string") { requirePermission("familiar:reaction"); await caps.familiars.setAnimation(validatePetHandleId(petHandleId), { kind: "reaction", reaction: validateReaction(animation) }); return; }
+        requirePermission("familiar:animate");
+        if (!isRecord(animation) || animation.sprite === undefined) throw new Error("Invalid familiar animation state.");
         const sprite = resolveAssetRef(animation.sprite, ["sprites"]);
         const fps = animation.fps === undefined ? 8 : Number(animation.fps);
         check(Number.isFinite(fps) && fps >= 1 && fps <= 30, "Invalid sprite animation fps.");
-        await caps.pets.setAnimation(validatePetHandleId(petHandleId), { kind: "sprite", spritePath: sprite.path, loop: animation.loop !== false, fps });
+        await caps.familiars.setAnimation(validatePetHandleId(petHandleId), { kind: "sprite", spritePath: sprite.path, loop: animation.loop !== false, fps });
       },
-      setScale: async (scale: unknown) => { requirePermission("pet:animate"); const value = Number(scale); check(Number.isFinite(value) && value >= 0.5 && value <= 2, "Pet scale must be between 0.5 and 2."); await caps.pets.setScale(validatePetHandleId(petHandleId), value); },
-      setStatusReaction: async (reaction: unknown) => { requirePermission("pet:reaction"); state.petWindow.tick(quotas.petActionsPerMinute, "pet action"); await caps.pets.setStatusReaction(validatePetHandleId(petHandleId), reaction === null || reaction === "idle" ? null : validateReaction(reaction)); },
-      moveBy: async (options: unknown) => { requirePermission("pet:move"); state.petWindow.tick(quotas.petActionsPerMinute, "pet action"); const opts = validateMoveBy(options); if (petHandleId === "default") await this.#petApi.moveBy(opts); else await caps.pets.moveBy(validatePetHandleId(petHandleId), opts); },
-      wander: async (options: unknown) => { requirePermission("pet:move"); state.petWindow.tick(quotas.petActionsPerMinute, "pet action"); const opts = validateWander(options); if (petHandleId === "default") await this.#petApi.wander(opts); else await caps.pets.wander(validatePetHandleId(petHandleId), opts); },
-      moveToHome: async () => { requirePermission("pet:move"); state.petWindow.tick(quotas.petActionsPerMinute, "pet action"); if (petHandleId === "default") await this.#petApi.moveToHome(); else await caps.pets.moveToHome(validatePetHandleId(petHandleId)); },
-      moveTo: async (point: unknown, opts: unknown) => { requirePermission("pet:move"); state.petWindow.tick(quotas.petActionsPerMinute, "pet action"); await caps.pets.moveTo(validatePetHandleId(petHandleId), validatePoint(point), validateMoveToOptions(opts)); },
-      followCursor: async (opts: unknown) => { requirePermission("pet:move"); const options = isRecord(opts) ? opts : { enabled: true }; const lag = options.lag === undefined ? undefined : Number(options.lag); if (lag !== undefined) check(Number.isFinite(lag) && lag >= 0 && lag <= 1, "followCursor lag must be 0..1."); await caps.pets.followCursor(validatePetHandleId(petHandleId), pluginId, { enabled: options.enabled !== false, lag }); },
-      physics: async (opts: unknown) => { requirePermission("pet:move"); const options = isRecord(opts) ? opts : {}; const bounce = options.bounce === undefined ? undefined : Number(options.bounce); if (bounce !== undefined) check(Number.isFinite(bounce) && bounce >= 0 && bounce <= 1, "physics bounce must be 0..1."); await caps.pets.physics(validatePetHandleId(petHandleId), pluginId, { gravity: options.gravity === true, bounce, climbEdges: options.climbEdges === true }); },
+      setScale: async (scale: unknown) => { requirePermission("familiar:animate"); const value = Number(scale); check(Number.isFinite(value) && value >= 0.5 && value <= 2, "Familiar scale must be between 0.5 and 2."); await caps.familiars.setScale(validatePetHandleId(petHandleId), value); },
+      setStatusReaction: async (reaction: unknown) => { requirePermission("familiar:reaction"); state.petWindow.tick(quotas.petActionsPerMinute, "familiar action"); await caps.familiars.setStatusReaction(validatePetHandleId(petHandleId), reaction === null || reaction === "idle" ? null : validateReaction(reaction)); },
+      moveBy: async (options: unknown) => { requirePermission("familiar:move"); state.petWindow.tick(quotas.petActionsPerMinute, "familiar action"); const opts = validateMoveBy(options); if (petHandleId === "default") await this.#petApi.moveBy(opts); else await caps.familiars.moveBy(validatePetHandleId(petHandleId), opts); },
+      wander: async (options: unknown) => { requirePermission("familiar:move"); state.petWindow.tick(quotas.petActionsPerMinute, "familiar action"); const opts = validateWander(options); if (petHandleId === "default") await this.#petApi.wander(opts); else await caps.familiars.wander(validatePetHandleId(petHandleId), opts); },
+      moveToHome: async () => { requirePermission("familiar:move"); state.petWindow.tick(quotas.petActionsPerMinute, "familiar action"); if (petHandleId === "default") await this.#petApi.moveToHome(); else await caps.familiars.moveToHome(validatePetHandleId(petHandleId)); },
+      moveTo: async (point: unknown, opts: unknown) => { requirePermission("familiar:move"); state.petWindow.tick(quotas.petActionsPerMinute, "familiar action"); await caps.familiars.moveTo(validatePetHandleId(petHandleId), validatePoint(point), validateMoveToOptions(opts)); },
+      followCursor: async (opts: unknown) => { requirePermission("familiar:move"); const options = isRecord(opts) ? opts : { enabled: true }; const lag = options.lag === undefined ? undefined : Number(options.lag); if (lag !== undefined) check(Number.isFinite(lag) && lag >= 0 && lag <= 1, "followCursor lag must be 0..1."); await caps.familiars.followCursor(validatePetHandleId(petHandleId), pluginId, { enabled: options.enabled !== false, lag }); },
+      physics: async (opts: unknown) => { requirePermission("familiar:move"); const options = isRecord(opts) ? opts : {}; const bounce = options.bounce === undefined ? undefined : Number(options.bounce); if (bounce !== undefined) check(Number.isFinite(bounce) && bounce >= 0 && bounce <= 1, "physics bounce must be 0..1."); await caps.familiars.physics(validatePetHandleId(petHandleId), pluginId, { gravity: options.gravity === true, bounce, climbEdges: options.climbEdges === true }); },
       onTick: (handler: (dtMs: number) => void) => {
         requirePermission("events");
         check(state.tickSubscriptions.size < quotas.eventSubscriptions, "Plugin tick subscription quota exceeded.");
         const subId = opaqueId("tick");
-        const dispose = caps.pets.onTick(validatePetHandleId(petHandleId), guardCallback(handler));
+        const dispose = caps.familiars.onTick(validatePetHandleId(petHandleId), guardCallback(handler));
         state.tickSubscriptions.set(subId, dispose);
         return { subscriptionId: subId };
       },
       offTick: (subscriptionId: unknown) => { const dispose = state.tickSubscriptions.get(String(subscriptionId)); dispose?.(); state.tickSubscriptions.delete(String(subscriptionId)); },
-      getState: async () => { requirePermission("pets:read"); return caps.pets.getState(validatePetHandleId(petHandleId)); },
-      show: async () => { requirePermission("pets:manage"); await caps.pets.show(validatePetHandleId(petHandleId)); },
-      hide: async () => { requirePermission("pets:manage"); await caps.pets.hide(validatePetHandleId(petHandleId)); },
+      getState: async () => { requirePermission("familiars:read"); return caps.familiars.getState(validatePetHandleId(petHandleId)); },
+      show: async () => { requirePermission("familiars:manage"); await caps.familiars.show(validatePetHandleId(petHandleId)); },
+      hide: async () => { requirePermission("familiars:manage"); await caps.familiars.hide(validatePetHandleId(petHandleId)); },
       close: async () => {
-        requirePermission("pets:manage");
-        check(state.spawnedPets.has(petHandleId), "Plugins may only close pets they spawned.");
-        await caps.pets.close(pluginId, petHandleId);
+        requirePermission("familiars:manage");
+        check(state.spawnedPets.has(petHandleId), "Plugins may only close familiars they spawned.");
+        await caps.familiars.close(pluginId, petHandleId);
         state.spawnedPets.delete(petHandleId);
       },
     });
 
     return {
       __logger: this.#logger,
-      pet: petNamespace("default"),
-      pets: {
-        list: async () => { requirePermission("pets:read"); return caps.pets.list(); },
+      familiar: petNamespace("default"),
+      familiars: {
+        list: async () => { requirePermission("familiars:read"); return caps.familiars.list(); },
         forPet: (petHandleId: unknown) => petNamespace(validatePetHandleId(petHandleId)),
         spawn: async (spec: unknown) => {
-          requirePermission("pets:manage");
-          check(state.spawnedPets.size < quotas.spawnedPets, "Plugin spawned pet quota exceeded.");
-          if (!isRecord(spec) || typeof spec.petId !== "string") throw new Error("Invalid pet spawn spec.");
+          requirePermission("familiars:manage");
+          check(state.spawnedPets.size < quotas.spawnedPets, "Plugin spawned familiar quota exceeded.");
+          if (!isRecord(spec) || typeof spec.petId !== "string") throw new Error("Invalid familiar spawn spec.");
           const name = spec.name === undefined ? undefined : String(spec.name).slice(0, 60);
           const position = spec.position === undefined ? undefined : validatePoint(spec.position);
-          const handleId = await caps.pets.spawn({ pluginId, petId: spec.petId, name, position });
+          const handleId = await caps.familiars.spawn({ pluginId, petId: spec.petId, name, position });
           state.spawnedPets.add(handleId);
           return { petHandleId: handleId };
         },
-        onChange: (handler: (pets: PluginPetInfo[]) => void) => {
-          requirePermission("pets:read");
+        onChange: (handler: (familiars: PluginPetInfo[]) => void) => {
+          requirePermission("familiars:read");
           check(state.eventSubscriptions.size < quotas.eventSubscriptions, "Plugin event subscription quota exceeded.");
           const subId = opaqueId("petschange");
-          state.eventSubscriptions.set(subId, caps.pets.onChange(guardCallback(handler)));
+          state.eventSubscriptions.set(subId, caps.familiars.onChange(guardCallback(handler)));
           return { subscriptionId: subId };
         },
         offChange: (subscriptionId: unknown) => { state.eventSubscriptions.get(String(subscriptionId))?.(); state.eventSubscriptions.delete(String(subscriptionId)); },
@@ -696,8 +696,8 @@ export class PluginSdkBridge {
           return picked;
         },
         read: async (fileId: unknown, encoding: unknown) => {
-          // Picked files need `files`; user-dropped files are readable with `pet:drop` alone.
-          if (!approved.has("files") && !approved.has("pet:drop")) throw new Error("Plugin permission is not approved: files");
+          // Picked files need `files`; user-dropped files are readable with `familiar:drop` alone.
+          if (!approved.has("files") && !approved.has("familiar:drop")) throw new Error("Plugin permission is not approved: files");
           check(state.pickedFiles.has(String(fileId)), "Plugin file handle is invalid.");
           check(encoding === "text" || encoding === "bytes", "Invalid file read encoding.");
           return caps.files.read(String(fileId), encoding as "text" | "bytes");
@@ -832,7 +832,7 @@ export class PluginSdkBridge {
     state.bubbles.clear();
     for (const panel of state.panels.values()) { void panel.close().catch(() => undefined); }
     state.panels.clear();
-    for (const petHandleId of state.spawnedPets) { void this.#capabilities.pets.close(id, petHandleId).catch(() => undefined); }
+    for (const petHandleId of state.spawnedPets) { void this.#capabilities.familiars.close(id, petHandleId).catch(() => undefined); }
     state.spawnedPets.clear();
     state.pickedFiles.clear();
     state.userCommandDepth = 0;
@@ -893,7 +893,7 @@ function safeNetHeaders(value: unknown): Record<string, string> | undefined {
   return out;
 }
 
-function allowedNetworkHosts(record: PluginStateRecord, manifest: OpenPetsJavascriptPluginManifest): Set<string> { const manifestHosts = new Set((manifest.network?.hosts ?? []).map((h) => h.toLowerCase())); const approved = record.approvedNetworkHosts?.map((h) => h.toLowerCase()) ?? []; return new Set(approved.filter((h) => manifestHosts.has(h))); }
+function allowedNetworkHosts(record: PluginStateRecord, manifest: FamiliarOSJavascriptPluginManifest): Set<string> { const manifestHosts = new Set((manifest.network?.hosts ?? []).map((h) => h.toLowerCase())); const approved = record.approvedNetworkHosts?.map((h) => h.toLowerCase()) ?? []; return new Set(approved.filter((h) => manifestHosts.has(h))); }
 
 async function prepareSafeRequest(urlText: string, opts: ValidatedNetOptions, allowedHosts: Set<string>): Promise<{ url: URL; init: RequestInit; controller: AbortController; timeout: NodeJS.Timeout }> {
   const url = new URL(urlText);
@@ -989,8 +989,8 @@ function check(ok: boolean, message: string): void { if (!ok) throw new Error(me
 function clampNumber(value: number, min: number, max: number): number { if (!Number.isFinite(value)) return min; return Math.min(Math.max(value, min), max); }
 function validateCssColor(value: unknown, message: string): string { const color = String(value).trim(); check(color.length <= 48 && safeCssColorPattern.test(color), message); return color; }
 function validateStorageKey(key: string): string { if (!/^[A-Za-z0-9._:-]{1,128}$/.test(String(key))) throw new Error("Invalid plugin storage key."); return String(key); }
-function validatePetHandleId(value: unknown): string { const id = String(value); if (!/^[A-Za-z0-9._:-]{1,128}$/.test(id)) throw new Error("Invalid pet handle id."); return id; }
-function validateReactOptions(value: unknown): PluginReactOptions | undefined { if (value === undefined) return undefined; if (!isRecord(value)) throw new Error("Invalid pet reaction options."); const keys = Object.keys(value); check(keys.every((key) => key === "showMessage"), "Invalid pet reaction option."); if (value.showMessage !== undefined && typeof value.showMessage !== "boolean") throw new Error("Invalid pet reaction showMessage option."); return value.showMessage === undefined ? {} : { showMessage: value.showMessage }; }
+function validatePetHandleId(value: unknown): string { const id = String(value); if (!/^[A-Za-z0-9._:-]{1,128}$/.test(id)) throw new Error("Invalid familiar handle id."); return id; }
+function validateReactOptions(value: unknown): PluginReactOptions | undefined { if (value === undefined) return undefined; if (!isRecord(value)) throw new Error("Invalid familiar reaction options."); const keys = Object.keys(value); check(keys.every((key) => key === "showMessage"), "Invalid familiar reaction option."); if (value.showMessage !== undefined && typeof value.showMessage !== "boolean") throw new Error("Invalid familiar reaction showMessage option."); return value.showMessage === undefined ? {} : { showMessage: value.showMessage }; }
 function validatePoint(value: unknown): { x: number; y: number } { if (!isRecord(value)) throw new Error("Invalid point."); const x = Number(value.x); const y = Number(value.y); if (!Number.isFinite(x) || !Number.isFinite(y)) throw new Error("Invalid point."); return { x, y }; }
 function validateMoveToOptions(value: unknown): { durationMs?: number; easing?: string } { const opts = isRecord(value) ? value : {}; const durationMs = opts.durationMs === undefined ? undefined : clampNumber(Number(opts.durationMs), 100, 10_000); const easing = opts.easing === undefined ? undefined : (check(["linear", "ease-in", "ease-out", "ease-in-out"].includes(String(opts.easing)), "Invalid easing."), String(opts.easing)); return { durationMs, easing }; }
 
@@ -1256,7 +1256,7 @@ export function validateCommandFormValues(form: PluginCommandForm, args: unknown
 }
 
 function validateStatus(status: PluginStatus | string): PluginStatus { const value = typeof status === "string" ? { text: status } : status; if (!value || typeof value.text !== "string" || value.text.trim() === "" || value.text.length > 120) throw new Error("Invalid plugin status text."); if (value.tone !== undefined && !["info", "success", "warning", "error"].includes(value.tone)) throw new Error("Invalid plugin status tone."); return { text: value.text, tone: value.tone }; }
-function validateMoveBy(value: unknown): { x: number; y: number; durationMs?: number } { if (!isRecord(value)) throw new Error("Invalid pet movement options."); const x = Number(value.x); const y = Number(value.y); if (!Number.isFinite(x) || !Number.isFinite(y)) throw new Error("Invalid pet movement distance."); return { x, y, durationMs: value.durationMs === undefined ? undefined : Number(value.durationMs) }; }
+function validateMoveBy(value: unknown): { x: number; y: number; durationMs?: number } { if (!isRecord(value)) throw new Error("Invalid familiar movement options."); const x = Number(value.x); const y = Number(value.y); if (!Number.isFinite(x) || !Number.isFinite(y)) throw new Error("Invalid familiar movement distance."); return { x, y, durationMs: value.durationMs === undefined ? undefined : Number(value.durationMs) }; }
 function validateWander(value: unknown): { distance?: number; durationMs?: number } { const options = isRecord(value) ? value : {}; return { distance: options.distance === undefined ? undefined : Number(options.distance), durationMs: options.durationMs === undefined ? undefined : Number(options.durationMs) }; }
 function parseDaily(spec: string | { time: string; days?: number[] }): { time: string; days?: number[] } { const value = typeof spec === "string" ? { time: spec } : spec; const m = /^(\d{2}):(\d{2})$/.exec(value.time); if (!m || Number(m[1]) > 23 || Number(m[2]) > 59) throw new Error("Daily schedule time must be HH:mm between 00:00 and 23:59."); if (value.days && (!Array.isArray(value.days) || value.days.some((d) => !Number.isInteger(d) || d < 0 || d > 6))) throw new Error("Daily schedule days must be weekdays 0-6."); return value; }
 function msUntilDaily(spec: { time: string; days?: number[] }): number { const [hour, minute] = spec.time.split(":").map(Number); const now = new Date(); for (let add = 0; add <= 7; add += 1) { const next = new Date(now); next.setDate(now.getDate() + add); next.setHours(hour ?? 0, minute ?? 0, 0, 0); if (next > now && (!spec.days || spec.days.includes(next.getDay()))) return next.getTime() - now.getTime(); } return 24 * 60 * 60 * 1000; }
diff --git a/apps/desktop/src/plugin-sdk-events.ts b/apps/desktop/src/plugin-sdk-events.ts
index c8346e98..b0713082 100644
--- a/apps/desktop/src/plugin-sdk-events.ts
+++ b/apps/desktop/src/plugin-sdk-events.ts
@@ -17,12 +17,12 @@ export function createPluginEventsApi(options: {
       requirePermission("events");
       const name = String(event);
       if (!allowedEventNames.has(name)) throw new Error(`Unknown plugin event: ${name}`);
-      if (name === "pet:drop") requirePermission("pet:drop");
+      if (name === "familiar:drop") requirePermission("familiar:drop");
       if (state.eventSubscriptions.size >= eventSubscriptionsQuota) throw new Error("Plugin event subscription quota exceeded.");
       const subId = opaqueId("event");
       if (name === "config:changed") {
         registerConfigChangedEvent({ state, subscriptionId: subId, handler, guardCallback });
-      } else if (name === "pet:drop") {
+      } else if (name === "familiar:drop") {
         const wrapped = guardCallback((payload: Record<string, unknown>) => {
           if (Array.isArray(payload.files)) for (const file of payload.files) { if (isRecord(file) && typeof file.fileId === "string") state.pickedFiles.add(file.fileId); }
           handler(payload);
diff --git a/apps/desktop/src/plugin-sdk-routes.ts b/apps/desktop/src/plugin-sdk-routes.ts
index 91ee887e..6f36806e 100644
--- a/apps/desktop/src/plugin-sdk-routes.ts
+++ b/apps/desktop/src/plugin-sdk-routes.ts
@@ -1,6 +1,6 @@
 export const pluginSdkAsyncRoutes = [
-  "pet.speak", "pet.react", "pet.setAnimation", "pet.setScale", "pet.setStatusReaction", "pet.moveBy", "pet.wander", "pet.moveToHome", "pet.moveTo", "pet.followCursor", "pet.physics", "pet.onTick", "pet.offTick", "pet.getState", "pet.show", "pet.hide", "pet.close",
-  "pets.list", "pets.spawn", "pets.onChange", "pets.offChange",
+  "familiar.speak", "familiar.react", "familiar.setAnimation", "familiar.setScale", "familiar.setStatusReaction", "familiar.moveBy", "familiar.wander", "familiar.moveToHome", "familiar.moveTo", "familiar.followCursor", "familiar.physics", "familiar.onTick", "familiar.offTick", "familiar.getState", "familiar.show", "familiar.hide", "familiar.close",
+  "familiars.list", "familiars.spawn", "familiars.onChange", "familiars.offChange",
   "ui.bubble", "ui.alert", "ui.bubbleUpdate", "ui.bubbleDismiss", "ui.bubblePin", "ui.bubbleUnpin", "ui.bubbleSubscribe", "ui.toast", "ui.panel", "ui.panelShow", "ui.panelHide", "ui.panelPost", "ui.panelClose", "ui.panelOnMessage", "ui.menuSetItems", "ui.menuOnSelect", "ui.menuOffSelect",
   "audio.play", "audio.importUserSound", "audio.forgetUserSound", "audio.stop",
   "events.on", "events.off",
diff --git a/apps/desktop/src/plugin-sdk-ui.ts b/apps/desktop/src/plugin-sdk-ui.ts
index 6d1e2df8..9c6ee193 100644
--- a/apps/desktop/src/plugin-sdk-ui.ts
+++ b/apps/desktop/src/plugin-sdk-ui.ts
@@ -1,11 +1,11 @@
-import type { OpenPetsJavascriptPluginManifest, PluginPermission } from "./plugin-manifest.js";
+import type { FamiliarOSJavascriptPluginManifest, PluginPermission } from "./plugin-manifest.js";
 import type { PluginAudioApi } from "./plugin-sdk-audio.js";
 import type { BubbleSlot, PluginRuntimeState } from "./plugin-sdk-state.js";
 import type { PluginBubbleDescriptor, PluginBubbleDismissReason, PluginBubbleHostHandle, PluginHostCapabilities, PluginLogLevel, PluginMenuItem, PluginStatus } from "./plugin-sdk-bridge.js";
 
 export function createPluginUiApi(options: {
   readonly pluginId: string;
-  readonly manifest: OpenPetsJavascriptPluginManifest;
+  readonly manifest: FamiliarOSJavascriptPluginManifest;
   readonly installPath: string;
   readonly state: PluginRuntimeState;
   readonly capabilities: PluginHostCapabilities;
@@ -26,8 +26,8 @@ export function createPluginUiApi(options: {
   const { pluginId, manifest, state, capabilities, audio, requirePermission, guardCallback, validateBubbleSpec, validatePetHandleId, resolvePanelPath, normalizeJson, validateMenuItems, validateSayMessage, safeError, logger, onError, quotas } = options;
 
   const showBubble = async (petHandleId: string, spec: unknown): Promise<{ bubbleId: string }> => {
-    requirePermission("pet:speak");
-    state.petWindow.tick(quotas.petActionsPerMinute, "pet action");
+    requirePermission("familiar:speak");
+    state.petWindow.tick(quotas.petActionsPerMinute, "familiar action");
     const bubble = validateBubbleSpec(spec);
     check(state.bubbles.size < quotas.activeBubbles, "Plugin active bubble quota exceeded.");
     const bubbleId = opaqueId("bubble");
@@ -80,7 +80,7 @@ export function createPluginUiApi(options: {
       },
       bubbleUpdate: async (bubbleId: unknown, patch: unknown) => { const slot = requireBubble(bubbleId); await slot.host.update(validateBubbleSpec(patch, true)); },
       bubbleDismiss: async (bubbleId: unknown) => { const slot = state.bubbles.get(String(bubbleId)); if (slot) await slot.host.dismiss().catch(() => undefined); },
-      bubblePin: async (bubbleId: unknown) => { requirePermission("pet:pin"); await requireBubble(bubbleId).host.pin(); },
+      bubblePin: async (bubbleId: unknown) => { requirePermission("familiar:pin"); await requireBubble(bubbleId).host.pin(); },
       bubbleUnpin: async (bubbleId: unknown) => { const slot = state.bubbles.get(String(bubbleId)); if (slot) await slot.host.unpin().catch(() => undefined); },
       bubbleSubscribe: (bubbleId: unknown, kind: unknown, handler: (...args: never[]) => void) => {
         const slot = state.bubbles.get(String(bubbleId));
diff --git a/apps/desktop/src/plugin-service.ts b/apps/desktop/src/plugin-service.ts
index c603543b..17603419 100644
--- a/apps/desktop/src/plugin-service.ts
+++ b/apps/desktop/src/plugin-service.ts
@@ -9,10 +9,10 @@ import { readSafePluginManifest } from "./plugin-manifest-reader.js";
 import type { OpenDialogOptions } from "electron";
 import type { PluginJsHost } from "./plugin-js-host.js";
 import { resolveDeclaredAssetPath } from "./plugin-assets.js";
-import { OPENPETS_PLUGIN_MANIFEST_FILENAME, type OpenPetsPluginManifest, type PluginConfigField, type PluginIcon, type PluginPermission } from "./plugin-manifest.js";
+import { FAMILIAROS_PLUGIN_MANIFEST_FILENAME, type FamiliarOSPluginManifest, type PluginConfigField, type PluginIcon, type PluginPermission } from "./plugin-manifest.js";
 import { ensureLoaded as ensurePluginLocales, resolvePluginText } from "./plugin-i18n.js";
 import { downloadCatalogPluginZip, installCatalogPluginPackage, readCatalogPluginManifestFromZip, resolveSafePluginInstallDir } from "./plugin-package.js";
-import type { PluginPetApi } from "./plugin-pet-api.js";
+import type { PluginPetApi } from "./plugin-familiar-api.js";
 import { JsonPluginStorageStore, type PluginCommand, type PluginHostCapabilities, type PluginLogLevel, type PluginStatus } from "./plugin-sdk-bridge.js";
 import { PluginRuntime, type PluginRuntimeScheduler } from "./plugin-runtime.js";
 import { PluginStateStore, type PluginSource, type PluginStateRecord } from "./plugin-state.js";
@@ -34,7 +34,7 @@ export type SafePluginRecord = {
   readonly catalogDisabled?: boolean;
   readonly catalogDeprecated?: boolean;
   readonly catalogStatusReason?: string;
-  readonly configSchema?: OpenPetsPluginManifest["configSchema"];
+  readonly configSchema?: FamiliarOSPluginManifest["configSchema"];
   readonly effectiveConfig?: PluginConfig;
   readonly configErrors?: readonly PluginConfigValidationError[];
   readonly commands?: readonly PluginCommand[];
@@ -48,7 +48,7 @@ export type PluginServiceResult = { readonly ok: true; readonly snapshot: Plugin
 export type PluginConfigSoundPickResult = { readonly ok: true; readonly sound: { readonly kind: "user-sound"; readonly id: string; readonly name?: string }; readonly snapshot: PluginServiceSnapshot } | { readonly ok: true; readonly canceled: true; readonly snapshot: PluginServiceSnapshot } | { readonly ok: false; readonly error: string; readonly snapshot: PluginServiceSnapshot };
 export type DevPluginLoadResult = { readonly path: string; readonly id?: string; readonly ok: true } | { readonly path: string; readonly ok: false; readonly error: string };
 export type PluginFolderDialog = (options?: unknown) => Promise<{ readonly canceled: boolean; readonly filePaths: readonly string[] }>;
-export type PluginPermissionDialog = (manifest: OpenPetsPluginManifest) => Promise<boolean>;
+export type PluginPermissionDialog = (manifest: FamiliarOSPluginManifest) => Promise<boolean>;
 
 export type PluginServiceOptions = {
   readonly userDataPath?: string;
@@ -72,9 +72,9 @@ export type PluginServiceOptions = {
   readonly capabilities?: PluginHostCapabilities;
 };
 
-export const bundledOfficialPluginIds = ["openpets.reminders", "openpets.virtual-pet"] as const;
-const bundledEnabledByDefault = new Set<string>(["openpets.reminders", "openpets.virtual-pet"]);
-const staleBundledPluginIds = ["openpets.daily-reminders", "openpets.pomodoro", "openpets.ambient-companion", "openpets.break-buddy", "openpets.focus-buddy", "openpets.github-notifications", "openpets.pet-pal", "openpets.quick-reminders", "openpets.wander-buddy"] as const;
+export const bundledOfficialPluginIds = ["familiaros.reminders", "familiaros.virtual-familiar"] as const;
+const bundledEnabledByDefault = new Set<string>(["familiaros.reminders", "familiaros.virtual-familiar"]);
+const staleBundledPluginIds = ["familiaros.daily-reminders", "familiaros.pomodoro", "familiaros.ambient-companion", "familiaros.break-buddy", "familiaros.focus-buddy", "familiaros.github-notifications", "familiaros.familiar-pal", "familiaros.quick-reminders", "familiaros.wander-buddy"] as const;
 
 export class PluginService {
   readonly stateStore: PluginStateStore;
@@ -180,7 +180,7 @@ export class PluginService {
   async saveConfig(id: string, config: unknown): Promise<PluginServiceResult> {
     const record = this.stateStore.getRecord(id);
     if (!record) return this.#error("Plugin is not installed.");
-    let manifest: OpenPetsPluginManifest;
+    let manifest: FamiliarOSPluginManifest;
     try {
       manifest = await this.#readManifest(record);
     } catch {
@@ -205,7 +205,7 @@ export class PluginService {
     this.#log("debug", "Plugin config sound pick requested.", { pluginId: id });
     const record = this.stateStore.getRecord(id);
     if (!record) { this.#log("warn", "Plugin config sound pick unavailable.", { pluginId: id, reason: "not-installed" }); return this.#soundError("Plugin is not installed."); }
-    let manifest: OpenPetsPluginManifest;
+    let manifest: FamiliarOSPluginManifest;
     try { manifest = await this.#readManifest(record); }
     catch { this.#log("warn", "Plugin config sound pick unavailable.", { pluginId: id, reason: "manifest-unavailable" }); return this.#soundError("Plugin manifest is unavailable."); }
     if (!Object.values(manifest.configSchema ?? {}).some((field) => field.type === "sound")) { this.#log("warn", "Plugin config sound pick unavailable.", { pluginId: id, reason: "no-sound-field" }); return this.#soundError("Plugin does not declare a sound config field."); }
@@ -240,7 +240,7 @@ export class PluginService {
     try {
       const catalog = await getPluginCatalog({ ...this.#catalogOptions, fetchImpl: this.#fetchImpl ?? this.#catalogOptions?.fetchImpl, refresh });
       for (const entry of catalog.plugins) await this.#updateCatalogMetadata(entry);
-      return { plugins: catalog.plugins.filter((entry) => !isEntryDisabled(entry) && isCatalogEntryCompatible(entry.minOpenPetsVersion, getMaxVersion(entry), this.#currentAppVersion)).map((entry) => { const installed = this.stateStore.getRecord(entry.id); return { id: entry.id, name: entry.name, version: entry.version, description: entry.description, runtime: entry.runtime, icon: entry.icon, sdkVersion: getSdkVersion(entry), permissions: entry.permissions, installed: installed?.source === "catalog", bundled: installed?.bundled || undefined, deprecated: isEntryDeprecated(entry) || undefined, statusReason: getStatusReason(entry) }; }) };
+      return { plugins: catalog.plugins.filter((entry) => !isEntryDisabled(entry) && isCatalogEntryCompatible(entry.minFamiliarOSVersion, getMaxVersion(entry), this.#currentAppVersion)).map((entry) => { const installed = this.stateStore.getRecord(entry.id); return { id: entry.id, name: entry.name, version: entry.version, description: entry.description, runtime: entry.runtime, icon: entry.icon, sdkVersion: getSdkVersion(entry), permissions: entry.permissions, installed: installed?.source === "catalog", bundled: installed?.bundled || undefined, deprecated: isEntryDeprecated(entry) || undefined, statusReason: getStatusReason(entry) }; }) };
     } catch {
       return { plugins: [] };
     }
@@ -252,7 +252,7 @@ export class PluginService {
 
   async updateCatalog(id: string): Promise<PluginServiceResult> {
     const record = this.stateStore.getRecord(id);
-    if (record?.bundled) return this.#error("Bundled plugins update with OpenPets.");
+    if (record?.bundled) return this.#error("Bundled plugins update with FamiliarOS.");
     return this.#installOrUpdateCatalog(id, true);
   }
 
@@ -338,7 +338,7 @@ export class PluginService {
         continue;
       }
       for (const path of entries) {
-        try { await fs.access(join(path, OPENPETS_PLUGIN_MANIFEST_FILENAME)); }
+        try { await fs.access(join(path, FAMILIAROS_PLUGIN_MANIFEST_FILENAME)); }
         catch { continue; }
         let id: string | undefined;
         try { id = (await readLocalPluginSourceManifest({ sourceFolder: path, maxManifestBytes: this.#maxManifestBytes })).manifest.id; }
@@ -376,7 +376,7 @@ export class PluginService {
   async #installOrUpdateCatalog(id: string, update: boolean): Promise<PluginServiceResult> {
     if (!this.#userDataPath) return this.#error("Catalog plugin installation is unavailable.");
     const existing = this.stateStore.getRecord(id);
-    if (existing?.bundled) return this.#error(update ? "Bundled plugins update with OpenPets." : "Plugin is already installed as a bundled plugin.");
+    if (existing?.bundled) return this.#error(update ? "Bundled plugins update with FamiliarOS." : "Plugin is already installed as a bundled plugin.");
     if (!update && existing) return this.#error("Plugin is already installed.");
     if (update && (!existing || existing.source !== "catalog")) return this.#error("Catalog plugin is not installed.");
     if (existing?.source === "local") return this.#error("A local plugin with this id is already loaded.");
@@ -385,7 +385,7 @@ export class PluginService {
       const entry = await getCatalogPlugin(id, { ...this.#catalogOptions, fetchImpl: this.#fetchImpl ?? this.#catalogOptions?.fetchImpl, refresh: update });
       if (isEntryDisabled(entry)) throw new Error("Plugin is disabled in the catalog.");
       if (isEntryDeprecated(entry)) throw new Error("Plugin is deprecated in the catalog.");
-      if (!isCatalogEntryCompatible(entry.minOpenPetsVersion, getMaxVersion(entry), this.#currentAppVersion)) throw new Error("Plugin is incompatible with this OpenPets version.");
+      if (!isCatalogEntryCompatible(entry.minFamiliarOSVersion, getMaxVersion(entry), this.#currentAppVersion)) throw new Error("Plugin is incompatible with this FamiliarOS version.");
       const zip = await downloadCatalogPluginZip(entry, this.#fetchImpl ?? this.#catalogOptions?.fetchImpl ?? fetch);
       const preview = await readCatalogPluginManifestFromZip({ catalogEntry: entry, zip, maxManifestBytes: this.#maxManifestBytes });
       const networkHosts = "network" in preview.manifest ? preview.manifest.network?.hosts : undefined;
@@ -430,7 +430,7 @@ export class PluginService {
     if (disabled && existing.enabled) await this.runtime.reloadPlugin(entry.id);
   }
 
-  #readManifest(record: PluginStateRecord): Promise<OpenPetsPluginManifest> {
+  #readManifest(record: PluginStateRecord): Promise<FamiliarOSPluginManifest> {
     return readSafePluginManifest({ installPath: record.installPath, manifestPath: record.manifestPath, allowedPluginRoots: this.allowedPluginRoots, maxManifestBytes: this.#maxManifestBytes, expectedId: record.id, expectedVersion: record.version });
   }
 
@@ -449,7 +449,7 @@ export class PluginService {
   #findBundledSourceFolder(id: string): string | null {
     for (const root of this.#bundledPluginSourceDirs) {
       const candidate = join(root, id);
-      if (existsSync(join(candidate, OPENPETS_PLUGIN_MANIFEST_FILENAME))) return candidate;
+      if (existsSync(join(candidate, FAMILIAROS_PLUGIN_MANIFEST_FILENAME))) return candidate;
     }
     return null;
   }
@@ -461,12 +461,12 @@ export class PluginService {
     const root = join(this.#userDataPath, "plugins");
     await ensureRealDirectory(root);
     const installPath = join(root, source.manifest.id);
-    const manifestPath = join(installPath, OPENPETS_PLUGIN_MANIFEST_FILENAME);
+    const manifestPath = join(installPath, FAMILIAROS_PLUGIN_MANIFEST_FILENAME);
     const tempPath = join(root, `.tmp-bundled-${source.manifest.id}-${process.pid}-${Date.now()}`);
     await fs.rm(tempPath, { recursive: true, force: true });
     await fs.mkdir(tempPath, { recursive: true });
     try {
-      await fs.writeFile(join(tempPath, OPENPETS_PLUGIN_MANIFEST_FILENAME), source.manifestText, { mode: 0o600 });
+      await fs.writeFile(join(tempPath, FAMILIAROS_PLUGIN_MANIFEST_FILENAME), source.manifestText, { mode: 0o600 });
       if (source.manifest.manifestVersion === 2 || source.manifest.manifestVersion === 3) {
         if (source.entryText === undefined) throw new Error("Bundled plugin entry is missing.");
         const entryPath = join(tempPath, source.manifest.entry);
@@ -478,7 +478,7 @@ export class PluginService {
           await fs.writeFile(filePath, bytes, { mode: 0o600 });
         }
       }
-      await readSafePluginManifest({ installPath: tempPath, manifestPath: join(tempPath, OPENPETS_PLUGIN_MANIFEST_FILENAME), allowedPluginRoots: [root], maxManifestBytes: this.#maxManifestBytes, expectedId: source.manifest.id, expectedVersion: source.manifest.version });
+      await readSafePluginManifest({ installPath: tempPath, manifestPath: join(tempPath, FAMILIAROS_PLUGIN_MANIFEST_FILENAME), allowedPluginRoots: [root], maxManifestBytes: this.#maxManifestBytes, expectedId: source.manifest.id, expectedVersion: source.manifest.version });
       await replaceInstallDirectory(root, installPath, tempPath);
     } finally { await fs.rm(tempPath, { recursive: true, force: true }).catch(() => undefined); }
     await readSafePluginManifest({ installPath, manifestPath, allowedPluginRoots: [root], maxManifestBytes: this.#maxManifestBytes, expectedId: source.manifest.id, expectedVersion: source.manifest.version });
@@ -517,7 +517,7 @@ function resolveCommandFormText(pluginId: string, form: PluginCommand["form"]):
   };
 }
 
-/** Resolve `$t:` references in command titles/descriptions/forms for Control Center snapshots and pet menus. */
+/** Resolve `$t:` references in command titles/descriptions/forms for Control Center snapshots and familiar menus. */
 function resolveCommandText(pluginId: string, command: PluginCommand): PluginCommand {
   return {
     ...command,
@@ -577,13 +577,13 @@ function safeError(error: unknown): string {
   if (/outside install/i.test(message)) return "Plugin manifest path is outside install path.";
   if (/path is invalid/i.test(message)) return "Plugin manifest path is invalid.";
   if (/id\/version/i.test(message)) return "Plugin manifest id/version does not match installed state.";
-  if (/newer OpenPets version|incompatible with this OpenPets version/i.test(message)) return "Plugin requires a newer OpenPets version.";
+  if (/newer FamiliarOS version|incompatible with this FamiliarOS version/i.test(message)) return "Plugin requires a newer FamiliarOS version.";
   return "Plugin manifest is unavailable.";
 }
 
 const pluginIconDataUrlMaxBytes = 64 * 1024;
 
-async function readPluginIconDataUrl(manifest: OpenPetsPluginManifest, installPath: string): Promise<string | undefined> {
+async function readPluginIconDataUrl(manifest: FamiliarOSPluginManifest, installPath: string): Promise<string | undefined> {
   if (manifest.manifestVersion !== 3 || manifest.runtime !== "javascript") return undefined;
   const icons = manifest.assets?.icons ?? {};
   const iconName = choosePluginIconAssetName(manifest.id, manifest.icon, icons);
@@ -657,7 +657,7 @@ function resolveConfigValueText(pluginId: string, config: PluginConfig): PluginC
 }
 
 /** Walk a manifest's `configSchema`, resolving every `$t:` display string against the plugin's catalogs. */
-function resolveConfigSchemaText(pluginId: string, schema: OpenPetsPluginManifest["configSchema"]): OpenPetsPluginManifest["configSchema"] {
+function resolveConfigSchemaText(pluginId: string, schema: FamiliarOSPluginManifest["configSchema"]): FamiliarOSPluginManifest["configSchema"] {
   if (!schema) return schema;
   return Object.fromEntries(Object.entries(schema).map(([key, field]) => [key, resolveConfigFieldText(pluginId, field)]));
 }
@@ -703,9 +703,9 @@ function getErrorCode(error: unknown): unknown {
   return typeof error === "object" && error !== null && "code" in error ? (error as { code?: unknown }).code : undefined;
 }
 
-function isCatalogEntryCompatible(minOpenPetsVersion: string | undefined, maxOpenPetsVersion: string | undefined, currentAppVersion: string): boolean {
-  if (minOpenPetsVersion && compareSemver(currentAppVersion, minOpenPetsVersion) < 0) return false;
-  if (maxOpenPetsVersion && compareSemver(currentAppVersion, maxOpenPetsVersion) > 0) return false;
+function isCatalogEntryCompatible(minFamiliarOSVersion: string | undefined, maxFamiliarOSVersion: string | undefined, currentAppVersion: string): boolean {
+  if (minFamiliarOSVersion && compareSemver(currentAppVersion, minFamiliarOSVersion) < 0) return false;
+  if (maxFamiliarOSVersion && compareSemver(currentAppVersion, maxFamiliarOSVersion) > 0) return false;
   return true;
 }
 
@@ -713,7 +713,7 @@ function isEntryDisabled(entry: object): boolean { return "disabled" in entry &&
 function isEntryDeprecated(entry: object): boolean { return "deprecated" in entry && entry.deprecated === true; }
 function getStatusReason(entry: object): string | undefined { return "statusReason" in entry && typeof entry.statusReason === "string" ? entry.statusReason : undefined; }
 function getSdkVersion(entry: object): string | undefined { return "sdkVersion" in entry && typeof entry.sdkVersion === "string" ? entry.sdkVersion : undefined; }
-function getMaxVersion(entry: object): string | undefined { return "maxOpenPetsVersion" in entry && typeof entry.maxOpenPetsVersion === "string" ? entry.maxOpenPetsVersion : undefined; }
+function getMaxVersion(entry: object): string | undefined { return "maxFamiliarOSVersion" in entry && typeof entry.maxFamiliarOSVersion === "string" ? entry.maxFamiliarOSVersion : undefined; }
 function getNetworkHosts(entry: object): readonly string[] | undefined { return "network" in entry && entry.network && typeof entry.network === "object" && "hosts" in entry.network && Array.isArray(entry.network.hosts) ? entry.network.hosts : undefined; }
 
 function compareSemver(a: string, b: string): number {
@@ -741,9 +741,9 @@ function isDialogOptions(value: unknown): value is OpenDialogOptions {
   return typeof value === "object" && value !== null;
 }
 
-async function defaultConfirmPermissions(manifest: OpenPetsPluginManifest): Promise<boolean> {
+async function defaultConfirmPermissions(manifest: FamiliarOSPluginManifest): Promise<boolean> {
   const { dialog } = await import("electron");
   const permissions = manifest.permissions.length === 0 ? "No permissions" : manifest.permissions.join(", ");
-  const result = await dialog.showMessageBox({ type: "question", buttons: ["Load plugin", "Cancel"], defaultId: 0, cancelId: 1, title: "Load local OpenPets plugin?", message: `Load ${manifest.name}?`, detail: `Permissions: ${permissions}` });
+  const result = await dialog.showMessageBox({ type: "question", buttons: ["Load plugin", "Cancel"], defaultId: 0, cancelId: 1, title: "Load local FamiliarOS plugin?", message: `Load ${manifest.name}?`, detail: `Permissions: ${permissions}` });
   return result.response === 0;
 }
diff --git a/apps/desktop/src/plugin-state.ts b/apps/desktop/src/plugin-state.ts
index 49f02be3..dec1ced5 100644
--- a/apps/desktop/src/plugin-state.ts
+++ b/apps/desktop/src/plugin-state.ts
@@ -3,7 +3,7 @@ import { dirname, join } from "node:path";
 
 import { canonicalizePluginPermissions, type KnownPluginRuntime, type PluginPermission } from "./plugin-manifest.js";
 
-export const openPetsPluginStateFileName = "openpets-plugin-state.json";
+export const openPetsPluginStateFileName = "familiaros-plugin-state.json";
 
 export type PluginSource = "catalog" | "local";
 
@@ -34,7 +34,7 @@ export type PluginStateRecord = {
   readonly update?: PluginUpdateMetadata;
 };
 
-export type OpenPetsPluginStateV1 = {
+export type FamiliarOSPluginStateV1 = {
   readonly version: 1;
   readonly plugins: Record<string, PluginStateRecord>;
 };
@@ -45,19 +45,19 @@ export type PluginStateStoreOptions =
 
 export class PluginStateStore {
   readonly statePath: string;
-  #state: OpenPetsPluginStateV1 | null = null;
+  #state: FamiliarOSPluginStateV1 | null = null;
 
   constructor(options: PluginStateStoreOptions) {
     this.statePath = options.statePath ?? join(options.userDataPath, openPetsPluginStateFileName);
   }
 
-  initialize(): OpenPetsPluginStateV1 {
+  initialize(): FamiliarOSPluginStateV1 {
     const state = normalizePluginState(readPluginStateFile(this.statePath));
     this.#commit(state);
     return this.snapshot();
   }
 
-  read(): OpenPetsPluginStateV1 {
+  read(): FamiliarOSPluginStateV1 {
     const state = normalizePluginState(readPluginStateFile(this.statePath));
     this.#state = state;
     return this.snapshot();
@@ -79,7 +79,7 @@ export class PluginStateStore {
     return cloneRecord(normalized);
   }
 
-  removeRecord(id: string): OpenPetsPluginStateV1 {
+  removeRecord(id: string): FamiliarOSPluginStateV1 {
     const state = this.#getState();
     const plugins = { ...state.plugins };
     delete plugins[id];
@@ -116,7 +116,7 @@ export class PluginStateStore {
     return this.#replaceRecord(record);
   }
 
-  snapshot(): OpenPetsPluginStateV1 {
+  snapshot(): FamiliarOSPluginStateV1 {
     return cloneState(this.#getState());
   }
 
@@ -137,12 +137,12 @@ export class PluginStateStore {
     return record;
   }
 
-  #getState(): OpenPetsPluginStateV1 {
-    if (!this.#state) throw new Error("OpenPets plugin state has not been initialized.");
+  #getState(): FamiliarOSPluginStateV1 {
+    if (!this.#state) throw new Error("FamiliarOS plugin state has not been initialized.");
     return this.#state;
   }
 
-  #commit(state: OpenPetsPluginStateV1): void {
+  #commit(state: FamiliarOSPluginStateV1): void {
     writePluginStateToDisk(this.statePath, state);
     this.#state = state;
   }
@@ -159,12 +159,12 @@ function readPluginStateFile(path: string): unknown {
   try {
     return JSON.parse(readFileSync(path, "utf8")) as unknown;
   } catch (error) {
-    console.error(`Failed to read OpenPets plugin state from ${path}; using defaults.`, error);
+    console.error(`Failed to read FamiliarOS plugin state from ${path}; using defaults.`, error);
     return undefined;
   }
 }
 
-function normalizePluginState(value: unknown): OpenPetsPluginStateV1 {
+function normalizePluginState(value: unknown): FamiliarOSPluginStateV1 {
   const plugins: Record<string, PluginStateRecord> = {};
   if (isPlainRecord(value) && isPlainRecord(value.plugins)) {
     for (const [id, record] of Object.entries(value.plugins)) {
@@ -295,15 +295,15 @@ function normalizeUpdateMetadata(value: unknown): PluginUpdateMetadata | undefin
   return update.availableVersion || update.checkedAt || update.catalogUrl ? update : undefined;
 }
 
-function writePluginStateToDisk(path: string, state: OpenPetsPluginStateV1): void {
+function writePluginStateToDisk(path: string, state: FamiliarOSPluginStateV1): void {
   mkdirSync(dirname(path), { recursive: true });
   const tempPath = `${path}.${process.pid}.tmp`;
   writeFileSync(tempPath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
   renameSync(tempPath, path);
 }
 
-function cloneState(state: OpenPetsPluginStateV1): OpenPetsPluginStateV1 {
-  return structuredClone(state) as OpenPetsPluginStateV1;
+function cloneState(state: FamiliarOSPluginStateV1): FamiliarOSPluginStateV1 {
+  return structuredClone(state) as FamiliarOSPluginStateV1;
 }
 
 function cloneRecord(record: PluginStateRecord): PluginStateRecord {
diff --git a/apps/desktop/src/plugin-voice.ts b/apps/desktop/src/plugin-voice.ts
index 4f4666a5..ff013c85 100644
--- a/apps/desktop/src/plugin-voice.ts
+++ b/apps/desktop/src/plugin-voice.ts
@@ -5,7 +5,7 @@ import { speakTts, stopTts } from "./tts-service.js";
 import type { PluginAiGateway } from "./plugin-ai-gateway.js";
 
 /**
- * Plugin voice (§13.5). TTS speaks through the pet window's renderer
+ * Plugin voice (§13.5). TTS speaks through the familiar window's renderer
  * speechSynthesis (the OS voice). STT is strictly one-shot push-to-talk: a
  * dedicated capture window records a bounded clip in its own session (the only
  * session granted microphone permission), and the clip is transcribed through
@@ -13,11 +13,11 @@ import type { PluginAiGateway } from "./plugin-ai-gateway.js";
  */
 
 export async function pluginVoiceSpeak(text: string, _opts: { voice?: string; rate?: number }): Promise<void> {
-  await speakTts(text, "pet");
+  await speakTts(text, "familiar");
 }
 
 export function pluginVoiceStop(): void {
-  stopTts("pet");
+  stopTts("familiar");
 }
 
 let listenInProgress = false;
@@ -35,7 +35,7 @@ export async function pluginVoiceListen(gateway: PluginAiGateway, opts: { timeou
 }
 
 async function captureMicrophoneClip(timeoutMs: number): Promise<Uint8Array> {
-  const partition = `openpets-voice-capture:${Date.now()}`;
+  const partition = `familiaros-voice-capture:${Date.now()}`;
   const captureSession = session.fromPartition(partition, { cache: false });
   // The one and only session where the microphone is allowed, per capture.
   captureSession.setPermissionRequestHandler((_contents, permission, callback) => callback(permission === "media"));
diff --git a/apps/desktop/src/prompt-memory-extraction.ts b/apps/desktop/src/prompt-memory-extraction.ts
index 9f37cd2d..2acc8442 100644
--- a/apps/desktop/src/prompt-memory-extraction.ts
+++ b/apps/desktop/src/prompt-memory-extraction.ts
@@ -1,8 +1,8 @@
-import type { OpenPetsMemoryKind } from "./local-ipc-protocol.js";
+import type { FamiliarOSMemoryKind } from "./local-ipc-protocol.js";
 
 interface ExtractedMemoryCandidate {
   readonly text: string;
-  readonly kind: OpenPetsMemoryKind;
+  readonly kind: FamiliarOSMemoryKind;
   readonly tags: readonly string[];
   readonly importance: number;
 }
diff --git a/apps/desktop/src/prompt-window.ts b/apps/desktop/src/prompt-window.ts
index 050ef0b2..223e4914 100644
--- a/apps/desktop/src/prompt-window.ts
+++ b/apps/desktop/src/prompt-window.ts
@@ -2,7 +2,7 @@ import { app, BrowserWindow, ipcMain, screen, type IpcMainInvokeEvent } from "el
 import { join } from "node:path";
 
 import { getAppStateSnapshot } from "./app-state.js";
-import { getDefaultPetWindowBounds } from "./default-pet-controller.js";
+import { getDefaultPetWindowBounds } from "./default-familiar-controller.js";
 import { storeKnowledgeFile } from "./knowledge-store.js";
 import { error as logError } from "./logger.js";
 import { createConversation, deleteConversation, getAllChatTranscriptEntries, getCurrentConversationId, getOpenApiChatSettingsSnapshot, getOpenApiChatTranscriptEntries, listConversations, resetOpenApiConversation, sendOpenApiChatPrompt, switchConversation, type ChatConversation, type OpenApiChatTranscriptEntry } from "./openapi-chat.js";
@@ -44,12 +44,12 @@ export function installPromptWindowHandlers(): void {
 
   promptWindowHandlersInstalled = true;
 
-  ipcMain.handle("openpets:prompt-window-state", (event) => {
+  ipcMain.handle("familiaros:prompt-window-state", (event) => {
     assertPromptWindowSender(event);
     return getPromptWindowState();
   });
 
-  ipcMain.handle("openpets:prompt-window-submit", async (event, prompt: unknown) => {
+  ipcMain.handle("familiaros:prompt-window-submit", async (event, prompt: unknown) => {
     assertPromptWindowSender(event);
     if (typeof prompt !== "string") {
       throw new Error("Prompt must be text.");
@@ -58,20 +58,20 @@ export function installPromptWindowHandlers(): void {
     return getPromptWindowState();
   });
 
-  ipcMain.handle("openpets:prompt-window-reset-conversation", (event) => {
+  ipcMain.handle("familiaros:prompt-window-reset-conversation", (event) => {
     assertPromptWindowSender(event);
     resetOpenApiConversation();
     return getPromptWindowState();
   });
 
-  ipcMain.handle("openpets:prompt-window-create-conversation", (event) => {
+  ipcMain.handle("familiaros:prompt-window-create-conversation", (event) => {
     assertPromptWindowSender(event);
     const conv = createConversation();
     switchConversation(conv.id);
     return getPromptWindowState();
   });
 
-  ipcMain.handle("openpets:prompt-window-switch-conversation", (event, conversationId: unknown) => {
+  ipcMain.handle("familiaros:prompt-window-switch-conversation", (event, conversationId: unknown) => {
     assertPromptWindowSender(event);
     if (typeof conversationId !== "string") {
       throw new Error("Conversation ID must be a string.");
@@ -80,7 +80,7 @@ export function installPromptWindowHandlers(): void {
     return getPromptWindowState();
   });
 
-  ipcMain.handle("openpets:prompt-window-delete-conversation", (event, conversationId: unknown) => {
+  ipcMain.handle("familiaros:prompt-window-delete-conversation", (event, conversationId: unknown) => {
     assertPromptWindowSender(event);
     if (typeof conversationId !== "string") {
       throw new Error("Conversation ID must be a string.");
@@ -89,24 +89,24 @@ export function installPromptWindowHandlers(): void {
     return getPromptWindowState();
   });
 
-  ipcMain.handle("openpets:prompt-window-open-settings", (event) => {
+  ipcMain.handle("familiaros:prompt-window-open-settings", (event) => {
     assertPromptWindowSender(event);
     openControlCenterWindow("settings");
   });
 
-  ipcMain.handle("openpets:prompt-window-resize", (event, nextBounds: unknown) => {
+  ipcMain.handle("familiaros:prompt-window-resize", (event, nextBounds: unknown) => {
     assertPromptWindowSender(event);
     resizePromptWindow(normalizeResizeRequest(nextBounds));
   });
 
-  ipcMain.handle("openpets:prompt-window-close", (event) => {
+  ipcMain.handle("familiaros:prompt-window-close", (event) => {
     assertPromptWindowSender(event);
     if (promptWindow && !promptWindow.isDestroyed()) {
       promptWindow.close();
     }
   });
 
-  ipcMain.handle("openpets:prompt-window-store-file", async (event, file: unknown) => {
+  ipcMain.handle("familiaros:prompt-window-store-file", async (event, file: unknown) => {
     assertPromptWindowSender(event);
     if (!isPromptWindowFileRecord(file) || typeof file.name !== "string" || !file.name.trim()) {
       throw new Error("File name is required.");
@@ -154,7 +154,7 @@ export function openPromptWindow(): void {
 
   const bounds = getPromptWindowBounds();
   const window = new BrowserWindow({
-    title: "OpenPets Prompt",
+    title: "FamiliarOS Prompt",
     width: bounds.width,
     height: bounds.height,
     x: bounds.x,
@@ -228,7 +228,7 @@ function getPromptWindowThemeMode(): PromptWindowThemeMode {
 
 function assertPromptWindowSender(event: IpcMainInvokeEvent): void {
   if (!promptWindow || promptWindow.isDestroyed() || event.sender !== promptWindow.webContents) {
-    throw new Error("OpenPets prompt request came from an unexpected window.");
+    throw new Error("FamiliarOS prompt request came from an unexpected window.");
   }
 }
 
@@ -316,7 +316,7 @@ function clampNumber(value: number, min: number, max: number): number {
 
 function buildPromptWindowUrl(): string {
   const csp = "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src 'none'; connect-src 'none'; form-action 'none'; base-uri 'none'";
-  const html = `<!doctype html><html lang="en" data-theme="dark"><head><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="${csp}"><meta name="viewport" content="width=device-width, initial-scale=1"><title>OpenPets Prompt</title><style>
+  const html = `<!doctype html><html lang="en" data-theme="dark"><head><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="${csp}"><meta name="viewport" content="width=device-width, initial-scale=1"><title>FamiliarOS Prompt</title><style>
   :root{color-scheme:light dark;font-family:"Avenir Next",Avenir,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}
   html[data-theme="dark"]{--window-bg:linear-gradient(180deg,#232323 0,#1a1a1a 56%,#121212 100%);--panel-bg:linear-gradient(180deg,rgba(28,28,28,.98),rgba(18,18,18,.99));--surface-bg:rgba(13,13,13,.96);--surface-alt:rgba(24,24,24,.95);--border:rgba(255,255,255,.09);--border-strong:rgba(255,255,255,.14);--text-primary:#f2f4f7;--text-muted:#a9afba;--text-dim:#8c93a0;--shadow:0 16px 42px rgba(0,0,0,.4);--danger-bg:rgba(74,24,31,.92);--danger-border:rgba(248,113,113,.28);--danger-text:#ffd2d2;--button-bg:rgba(32,32,32,.94);--button-border:rgba(255,255,255,.1);--button-text:#e7ebf2;--button-hover:rgba(44,44,44,.98);--button-active:rgba(58,58,58,.98);--primary-bg:linear-gradient(135deg,#4b8dff,#2f6fea);--primary-text:#fff}
   html[data-theme="light"]{--window-bg:linear-gradient(180deg,#fafbfc 0,#f0f3f7 56%,#e7edf4 100%);--panel-bg:linear-gradient(180deg,rgba(255,255,255,.98),rgba(242,246,250,.99));--surface-bg:rgba(255,255,255,.98);--surface-alt:rgba(246,248,251,.96);--border:rgba(110,122,139,.18);--border-strong:rgba(110,122,139,.26);--text-primary:#182332;--text-muted:#5f6c7c;--text-dim:#728092;--shadow:0 16px 38px rgba(31,41,55,.14);--danger-bg:rgba(255,243,243,.98);--danger-border:rgba(220,38,38,.18);--danger-text:#a11a1a;--button-bg:rgba(244,247,251,.98);--button-border:rgba(110,122,139,.16);--button-text:#223144;--button-hover:rgba(236,241,247,.98);--button-active:rgba(226,234,243,.98);--primary-bg:linear-gradient(135deg,#3878f4,#2f6fea);--primary-text:#fff}
@@ -463,7 +463,7 @@ function buildPromptWindowUrl(): string {
 
   const formatEntryRole = (entry) => {
     if (!entry || entry.role === 'system') return 'System';
-    if (entry.role === 'assistant') return 'Pet';
+    if (entry.role === 'assistant') return 'Familiar';
     return 'You';
   };
 
diff --git a/apps/desktop/src/reaction-animation-mapping.ts b/apps/desktop/src/reaction-animation-mapping.ts
index 7308532d..eae82b11 100644
--- a/apps/desktop/src/reaction-animation-mapping.ts
+++ b/apps/desktop/src/reaction-animation-mapping.ts
@@ -1,9 +1,9 @@
-import { allowedReactions, type OpenPetsReaction } from "./local-ipc-protocol.js";
+import { allowedReactions, type FamiliarOSReaction } from "./local-ipc-protocol.js";
 
 export type PetMotionState = "idle" | "run-left" | "run-right";
 export type UniversalSpriteState = "idle" | "running-right" | "running-left" | "waving" | "jumping" | "failed" | "waiting" | "running" | "review";
 export type UserSelectableAnimationState = Exclude<UniversalSpriteState, "running-left" | "running-right">;
-export type ReactionAnimationOverrides = Partial<Record<OpenPetsReaction, UserSelectableAnimationState>>;
+export type ReactionAnimationOverrides = Partial<Record<FamiliarOSReaction, UserSelectableAnimationState>>;
 
 export interface SpriteStateDefinition {
   readonly row: number;
@@ -30,10 +30,10 @@ export const defaultReactionToSpriteState = {
   success: "jumping",
   error: "failed",
   celebrating: "jumping",
-} as const satisfies Record<OpenPetsReaction, UserSelectableAnimationState>;
+} as const satisfies Record<FamiliarOSReaction, UserSelectableAnimationState>;
 
 export const defaultPetSprite = {
-  fileName: "default-pet-spritesheet.webp",
+  fileName: "default-familiar-spritesheet.webp",
   frameWidth: 192,
   frameHeight: 208,
   columns: 8,
@@ -69,13 +69,13 @@ export const reactionAnimationMetadata = [
   { id: "running", label: "Running", description: "Agent is running a command.", defaultAnimation: defaultReactionToSpriteState.running },
   { id: "testing", label: "Testing", description: "Agent is running checks.", defaultAnimation: defaultReactionToSpriteState.testing },
   { id: "waiting", label: "Waiting", description: "Agent is blocked or waiting for permission.", defaultAnimation: defaultReactionToSpriteState.waiting },
-  { id: "waving", label: "Waving", description: "Pet is greeting or getting attention.", defaultAnimation: defaultReactionToSpriteState.waving },
+  { id: "waving", label: "Waving", description: "Familiar is greeting or getting attention.", defaultAnimation: defaultReactionToSpriteState.waving },
   { id: "success", label: "Success", description: "Task completed successfully.", defaultAnimation: defaultReactionToSpriteState.success },
   { id: "error", label: "Error", description: "Something failed.", defaultAnimation: defaultReactionToSpriteState.error },
   { id: "celebrating", label: "Celebrating", description: "Positive manual reaction.", defaultAnimation: defaultReactionToSpriteState.celebrating },
-] as const satisfies readonly { readonly id: OpenPetsReaction; readonly label: string; readonly description: string; readonly defaultAnimation: UserSelectableAnimationState }[];
+] as const satisfies readonly { readonly id: FamiliarOSReaction; readonly label: string; readonly description: string; readonly defaultAnimation: UserSelectableAnimationState }[];
 
-const allowedReactionSet = new Set<OpenPetsReaction>(allowedReactions);
+const allowedReactionSet = new Set<FamiliarOSReaction>(allowedReactions);
 const selectableAnimationSet = new Set<UserSelectableAnimationState>(selectableAnimationMetadata.map((animation) => animation.id));
 
 export function isUserSelectableAnimationState(value: unknown): value is UserSelectableAnimationState {
@@ -86,8 +86,8 @@ export function normalizeReactionAnimationOverrides(value: unknown): ReactionAni
   if (!isRecord(value)) return undefined;
   const overrides: ReactionAnimationOverrides = {};
   for (const [reaction, animation] of Object.entries(value)) {
-    if (!allowedReactionSet.has(reaction as OpenPetsReaction) || !isUserSelectableAnimationState(animation)) continue;
-    if (defaultReactionToSpriteState[reaction as OpenPetsReaction] !== animation) overrides[reaction as OpenPetsReaction] = animation;
+    if (!allowedReactionSet.has(reaction as FamiliarOSReaction) || !isUserSelectableAnimationState(animation)) continue;
+    if (defaultReactionToSpriteState[reaction as FamiliarOSReaction] !== animation) overrides[reaction as FamiliarOSReaction] = animation;
   }
   return Object.keys(overrides).length > 0 ? overrides : undefined;
 }
@@ -96,13 +96,13 @@ export function validateReactionAnimationOverrides(value: unknown): ReactionAnim
   if (value === undefined) return undefined;
   if (!isRecord(value)) throw new Error("Invalid reaction animation overrides.");
   for (const [reaction, animation] of Object.entries(value)) {
-    if (!allowedReactionSet.has(reaction as OpenPetsReaction)) throw new Error("Invalid reaction animation reaction.");
+    if (!allowedReactionSet.has(reaction as FamiliarOSReaction)) throw new Error("Invalid reaction animation reaction.");
     if (!isUserSelectableAnimationState(animation)) throw new Error("Invalid reaction animation state.");
   }
   return normalizeReactionAnimationOverrides(value);
 }
 
-export function resolveReactionSpriteState(reaction: OpenPetsReaction | undefined, overrides: ReactionAnimationOverrides | undefined): UserSelectableAnimationState {
+export function resolveReactionSpriteState(reaction: FamiliarOSReaction | undefined, overrides: ReactionAnimationOverrides | undefined): UserSelectableAnimationState {
   if (!reaction) return "idle";
   return overrides?.[reaction] ?? defaultReactionToSpriteState[reaction] ?? "idle";
 }
diff --git a/apps/desktop/src/reaction-messages.ts b/apps/desktop/src/reaction-messages.ts
index c99b9815..6d8d2ee3 100644
--- a/apps/desktop/src/reaction-messages.ts
+++ b/apps/desktop/src/reaction-messages.ts
@@ -1,6 +1,6 @@
 import type { Locale } from "./i18n/catalog.js";
 import { localizedReactionMessagePools } from "./i18n/reactions/index.js";
-import type { OpenPetsReaction } from "./local-ipc-protocol.js";
+import type { FamiliarOSReaction } from "./local-ipc-protocol.js";
 
 export const reactionMessagePools = {
   idle: [
@@ -157,9 +157,9 @@ export const reactionMessagePools = {
     "Result shines",
     "Moment earned",
   ],
-} as const satisfies Record<OpenPetsReaction, readonly string[]>;
+} as const satisfies Record<FamiliarOSReaction, readonly string[]>;
 
-export function pickReactionMessage(reaction: OpenPetsReaction, random: () => number = Math.random, locale: Locale = "en"): string {
+export function pickReactionMessage(reaction: FamiliarOSReaction, random: () => number = Math.random, locale: Locale = "en"): string {
   const pool = localizedReactionMessagePools[locale]?.[reaction] ?? reactionMessagePools[reaction];
   return pool[Math.floor(random() * pool.length) % pool.length] ?? reaction;
 }
diff --git a/apps/desktop/src/renderer/codemap.md b/apps/desktop/src/renderer/codemap.md
index 66991d1f..fe1ff658 100644
--- a/apps/desktop/src/renderer/codemap.md
+++ b/apps/desktop/src/renderer/codemap.md
@@ -9,10 +9,10 @@ Vite renderer workspace for the desktop React/Tailwind Control Center. It owns t
 - Built as a sandboxed Electron renderer loaded by the singleton Control Center BrowserWindow.
 - Uses `control-center-preload.cjs` as the only bridge to the main process; `ipcRenderer` is not exposed directly.
 - Production output is emitted to `apps/desktop/dist/renderer/`; development can load a loopback-only Vite URL.
-- Transparent pet windows and plugin JavaScript host windows are separate lightweight renderers and do not live here.
+- Transparent familiar windows and plugin JavaScript host windows are separate lightweight renderers and do not live here.
 
 ## Key Files
 
 - `index.html`: Vite HTML entry mounting the React app.
-- `src/main.tsx`: Route shell and pages for Dashboard, Pets, Integrations, Plugins, and Settings.
+- `src/main.tsx`: Route shell and pages for Dashboard, Familiars, Integrations, Plugins, and Settings.
 - `src/styles.css`: Tailwind directives plus Control Center component styling.
diff --git a/apps/desktop/src/renderer/index.html b/apps/desktop/src/renderer/index.html
index a4294452..848a0a9f 100644
--- a/apps/desktop/src/renderer/index.html
+++ b/apps/desktop/src/renderer/index.html
@@ -2,9 +2,9 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'self'; style-src 'self'; img-src 'self' data: https://openpets.dev openpets-codex: openpets-installed: openpets-pet-preview:; connect-src 'self'; base-uri 'none'; form-action 'none'; frame-src 'none'" />
+    <meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'self'; style-src 'self'; img-src 'self' data: https://familiaros.dev familiaros-codex: familiaros-installed: familiaros-familiar-preview:; connect-src 'self'; base-uri 'none'; form-action 'none'; frame-src 'none'" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>OpenPets Control Center</title>
+    <title>FamiliarOS Control Center</title>
   </head>
   <body>
     <div id="root"></div>
diff --git a/apps/desktop/src/renderer/src/codemap.md b/apps/desktop/src/renderer/src/codemap.md
index c49f4bcf..35a26272 100644
--- a/apps/desktop/src/renderer/src/codemap.md
+++ b/apps/desktop/src/renderer/src/codemap.md
@@ -2,16 +2,16 @@
 
 ## Responsibility
 
-React/Tailwind source for the Control Center management UI. This renderer presents dashboard status, pet management, coding-agent integrations, plugin management, and settings using narrow preload APIs backed by `windows.ts` IPC handlers and desktop services.
+React/Tailwind source for the Control Center management UI. This renderer presents dashboard status, familiar management, coding-agent integrations, plugin management, and settings using narrow preload APIs backed by `windows.ts` IPC handlers and desktop services.
 
 ## Design
 
-- **Route Shell**: In-renderer route state supports `dashboard`, `pets`, `integrations`, `plugins`, and `settings`; tray actions retarget the singleton window through route-change events.
-- **Dashboard**: Reads a narrowed dashboard snapshot for default pet preview, install/catalog counts, plugin health, update status, and activity totals.
-- **Pets**: Combines installed pets, catalog v3 pages/search, Codex imports, filters, detail panes, set-default/install/import/remove actions, and animated sprite previews.
+- **Route Shell**: In-renderer route state supports `dashboard`, `familiars`, `integrations`, `plugins`, and `settings`; tray actions retarget the singleton window through route-change events.
+- **Dashboard**: Reads a narrowed dashboard snapshot for default familiar preview, install/catalog counts, plugin health, update status, and activity totals.
+- **Familiars**: Combines installed familiars, catalog v3 pages/search, Codex imports, filters, detail panes, set-default/install/import/remove actions, and animated sprite previews.
 - **Integrations**: Card-first setup UI for Claude Code, OpenCode, Cursor, and Pi guidance, including command mode/path controls and preview/action flows.
 - **Plugins**: Gallery-first plugin hub for installed/catalog/local/broken filters, catalog refresh, local load, install/update/uninstall, enable/disable, config modal, command execution, runtime/status display, and broken-state feedback.
-- **Settings**: Startup, launch-at-login, pet scale, reaction-animation mapping, update check, default-pet position reset, and pet reaction previews.
+- **Settings**: Startup, launch-at-login, familiar scale, reaction-animation mapping, update check, default-familiar position reset, and familiar reaction previews.
 - **Bridge Contract**: All data and actions go through `window.openPetsControlCenter`; page snapshots intentionally omit raw install paths and unrelated app state.
 
 ## Key Files
diff --git a/apps/desktop/src/renderer/src/i18n.tsx b/apps/desktop/src/renderer/src/i18n.tsx
index 879d24c4..064ac305 100644
--- a/apps/desktop/src/renderer/src/i18n.tsx
+++ b/apps/desktop/src/renderer/src/i18n.tsx
@@ -2,7 +2,7 @@ import React, { createContext, useContext } from "react";
 
 // Renderer-side i18n. The renderer never imports the catalog source (it lives
 // under the main-process rootDir); instead it receives a fully-resolved message
-// map over IPC (`openpets:get-i18n`) and looks strings up here. Missing keys
+// map over IPC (`familiaros:get-i18n`) and looks strings up here. Missing keys
 // fall back to the key itself so a partial wiring is visible, not blank.
 export type I18nSnapshot = {
   locale: string;
diff --git a/apps/desktop/src/renderer/src/main.tsx b/apps/desktop/src/renderer/src/main.tsx
index 7ef60cfa..ffb2937e 100644
--- a/apps/desktop/src/renderer/src/main.tsx
+++ b/apps/desktop/src/renderer/src/main.tsx
@@ -3,8 +3,8 @@ import { createRoot } from "react-dom/client";
 import { I18nProvider, useI18n, type I18nSnapshot } from "./i18n";
 import "./styles.css";
 import { getMcpToolkitEntry, mcpToolkitEntries, mcpToolkitTierLabels } from "./mcp-toolkit-catalog";
-import openPetsLogoUrl from "../../../assets/openpets.webp";
-import defaultThumbUrl from "../../../assets/default-pet-thumbnail.png";
+import openPetsLogoUrl from "../../../assets/familiaros.webp";
+import defaultThumbUrl from "../../../assets/default-familiar-thumbnail.png";
 
 import claudeLogoUrl from "../../../assets/integrations/claude.svg";
 import opencodeLogoUrl from "../../../assets/integrations/opencode.svg";
@@ -18,15 +18,15 @@ type Filter = "all" | "installed" | "featured" | "originals" | "codex";
 type InstalledPet = { id: string; displayName: string; description?: string; builtIn: boolean; protected: boolean; installed: boolean; broken?: boolean; brokenReason?: string; source?: { kind?: "catalog"; preview?: string } | { kind: "codex"; path: string } };
 type PetEntry = { id: string; displayName: string; description?: string; searchText?: string; preview?: string; thumbnail?: string; spritesheet?: string; category?: "western" | "asian"; original?: boolean; featured?: boolean; catalogPage?: number; sourceKind?: "installed" | "catalog" | "codex"; installed?: boolean; builtIn?: boolean; protected?: boolean; broken?: boolean; brokenReason?: string };
 type SearchPetEntry = Pick<PetEntry, "id" | "displayName" | "category" | "original" | "featured"> & { searchText?: string; catalogPage?: number };
-type StateSnapshot = { preferences: { defaultPetId: string }; pets: { installed: InstalledPet[] } };
-type CatalogState = { pets: PetEntry[]; source: string; error?: string; page?: number; pageCount?: number; total?: number; categories?: { id: "western" | "asian"; label: string; count: number }[]; originalsCount?: number; featuredCount?: number };
-type CodexState = { pets: PetEntry[]; error?: string };
+type StateSnapshot = { preferences: { defaultPetId: string }; familiars: { installed: InstalledPet[] } };
+type CatalogState = { familiars: PetEntry[]; source: string; error?: string; page?: number; pageCount?: number; total?: number; categories?: { id: "western" | "asian"; label: string; count: number }[]; originalsCount?: number; featuredCount?: number };
+type CodexState = { familiars: PetEntry[]; error?: string };
 type PetScaleOption = { label: string; value: number };
 type ThemeMode = "system" | "light" | "dark";
 type UserSelectableAnimationState = "idle" | "review" | "running" | "waiting" | "waving" | "jumping" | "failed";
 type ReactionAnimationOverrides = Record<string, UserSelectableAnimationState>;
 type OpenApiChatSettings = { model: string; endpoint: string; defaultEndpoint: string; usingDefaultEndpoint: boolean; hasCredential: boolean; storageMode: "encrypted" | "plain" };
-type SettingsState = { preferences: { openDefaultPetOnLaunch: boolean; locale?: "system" | string; petScale: number; reactionAnimationOverrides?: ReactionAnimationOverrides; openApiChatModel?: string; openApiChatSystemPrompt?: string; openApiChatEndpoint?: string; openApiChatTheme?: ThemeMode; openApiChatBaseInstructionsEnabled?: boolean; ttsProvider?: TtsProviderId; ttsVoice?: string; ttsSpeed?: number; ttsModel?: string; ttsEndpointPreset?: "openrouter" | "litellm" | "wavespeedai" | "custom"; ttsEndpoint?: string }; petScaleOptions: PetScaleOption[]; openApiChat: OpenApiChatSettings };
+type SettingsState = { preferences: { openDefaultPetOnLaunch: boolean; locale?: "system" | string; petScale: number; reactionAnimationOverrides?: ReactionAnimationOverrides; openApiChatModel?: string; openApiChatSystemPrompt?: string; openApiChatEndpoint?: string; openApiChatTheme?: ThemeMode; openApiChatBaseInstructionsEnabled?: boolean; ttsProvider?: TtsProviderId; ttsVoice?: string; ttsSpeed?: number; ttsModel?: string; ttsEndpointPreset?: "openrouter" | "litellm" | "wavespeedai" | "custom"; ttsEndpoint?: string; familiarName?: string }; petScaleOptions: PetScaleOption[]; openApiChat: OpenApiChatSettings };
 type LaunchAtLoginState = { supported: boolean; enabled: boolean };
 type UpdateStatus = { state: "idle" | "checking" | "available" | "current" | "error"; currentVersion: string; latestVersion?: string; releaseUrl?: string; checkedAt?: number; error?: string };
 type DashboardActivity = { messagesSent: number; reactionsSent: number; reactionCounts: Record<string, number>; perPetActivityCounts: Record<string, number>; lastActivityAt?: number };
@@ -34,8 +34,8 @@ type DashboardSnapshot = { defaultPet: { id: string; displayName: string; previe
 type ReactionAnimationSettings = { reactions: { id: string; label: string; description: string; defaultAnimation: UserSelectableAnimationState }[]; animations: { id: UserSelectableAnimationState; label: string; description: string }[]; sprite: { frameWidth: number; frameHeight: number; columns: number; rows: number; states: Record<UserSelectableAnimationState, { row: number; frames: number; durationMs: number; iterations?: number | "infinite" }> }; overrides: ReactionAnimationOverrides; previewSpriteUrl: string };
 type PluginFilter = "all" | "installed" | "catalog" | "local" | "broken";
 type PluginPermission =
-  | "pet:speak" | "pet:reaction" | "pet:move" | "timer" | "schedule" | "storage" | "status" | "commands" | "network"
-  | "pet:interact" | "pet:pin" | "pet:animate" | "pet:speak:dynamic" | "pet:drop" | "pets:read" | "pets:manage"
+  | "familiar:speak" | "familiar:reaction" | "familiar:move" | "timer" | "schedule" | "storage" | "status" | "commands" | "network"
+  | "familiar:interact" | "familiar:pin" | "familiar:animate" | "familiar:speak:dynamic" | "familiar:drop" | "familiars:read" | "familiars:manage"
   | "audio" | "events" | "ui:toast" | "ui:panel" | "notify" | "bus" | "ai" | "secrets" | "voice:speak" | "voice:listen"
   | "auth" | "files" | "system:openExternal" | "system:metrics" | "clipboard" | "network:write";
 type PluginPlatformSettings = {
@@ -115,7 +115,7 @@ type ControlCenterApi = {
   getPluginAiApiKeyStatus(): Promise<{ hasKey: boolean }>;
   getCatalog(): Promise<CatalogState>;
   getCatalogPage(page: number): Promise<CatalogState>;
-  getCatalogSearch(): Promise<{ pets: SearchPetEntry[]; error?: string }>;
+  getCatalogSearch(): Promise<{ familiars: SearchPetEntry[]; error?: string }>;
   getCodexPets(): Promise<CodexState>;
   setDefaultPet(petId: string): Promise<StateSnapshot>;
   installPet(petId: string): Promise<unknown>;
@@ -128,8 +128,8 @@ type ControlCenterApi = {
   getIntegrationsState(selectedPetId?: string, commandMode?: "published" | "local" | "bundled"): Promise<AgentSetupSnapshot>;
   runIntegrationAction(action: AgentSetupAction, selectedPetId?: string, commandMode?: "published" | "local" | "bundled"): Promise<AgentSetupSnapshot>;
   updateIntegrationCommandPaths(patch: Partial<AgentSetupCommandPaths>): Promise<AgentSetupCommandPaths>;
-  getOpenPetsMcpServerPreview(selectedPetId?: string, commandMode?: "published" | "local" | "bundled"): Promise<OpenPetsMcpServerPreview>;
-  testOpenPetsMcpServer(selectedPetId?: string, commandMode?: "published" | "local" | "bundled"): Promise<OpenPetsMcpServerHealth>;
+  getFamiliarOSMcpServerPreview(selectedPetId?: string, commandMode?: "published" | "local" | "bundled"): Promise<FamiliarOSMcpServerPreview>;
+  testFamiliarOSMcpServer(selectedPetId?: string, commandMode?: "published" | "local" | "bundled"): Promise<FamiliarOSMcpServerHealth>;
   getTtsSettings(): Promise<TtsSettingsSnapshot>;
   getTtsVoices(provider: TtsProviderId): Promise<TtsVoice[]>;
   saveTtsCredential(provider: TtsProviderId, credential: string): Promise<TtsCredentialStatus>;
@@ -157,16 +157,16 @@ type AgentSetupAction = "configure" | "replace" | "remove" | "install-memory" |
 type AgentSetupPetOption = { id: string; displayName: string; default: boolean };
 type ClaudeCodeStatus = { state: "detected" | "not_detected" | "configured" | "needs_setup" | "error"; label: string; details: string; claudeCommand?: string; version?: string; mcpListWorks: boolean; openPetsEntry: { present: boolean; verified: boolean; matchesExpected: boolean }; canConfigure: boolean; canReplace: boolean; canRemove: boolean };
 type ClaudeHookDoctorResult = { status: "installed" | "needs_setup" | "error" | "custom" | "conflict"; settingsPath: string; exists: boolean; valid: boolean; message: string; preview: Record<string, unknown>; asyncSupported: boolean; backupPath?: string };
-type ClaudeOpenPetsMemoryStatus = { state: "installed" | "needs_setup" | "error"; label: string; details: string; claudeMdPath: string; openPetsMemoryPath: string; canInstall: boolean };
+type ClaudeFamiliarOSMemoryStatus = { state: "installed" | "needs_setup" | "error"; label: string; details: string; claudeMdPath: string; openPetsMemoryPath: string; canInstall: boolean };
 type OpenCodeSetupStatus = { state: "configured" | "needs_setup" | "not_detected" | "error"; label: string; details: string; configDir: string; canInstall: boolean; canRemove: boolean };
 type OpenCodeSetupPreview = { global: true; configDir: string; configPath: string; cleanupConfigPaths: string[]; mcpCommand: string[]; plugin: unknown[] | string; instructionPath: string; configPreview: Record<string, unknown> };
 type CursorSetupStatus = { state: "configured" | "needs_setup" | "not_detected" | "error" | "conflict" | "needs_update"; label: string; details: string; configPath: string; canInstall: boolean; canReplace: boolean; canRemove: boolean };
 type CursorSetupPreview = { global: true; configPath: string; mcpEntry: Record<string, unknown>; rulesPath: string; rulesContent: string; commandMode: "published" | "local" | "bundled" };
 type AgentSetupCommandPaths = { claude: string; node: string; opencode: string };
 type AgentSetupActionResult = { ok: boolean; action: AgentSetupAction; message: string; changed: boolean };
-type AgentSetupSnapshot = { selectedPetId?: string; commandMode: "published" | "local" | "bundled"; localDevAvailable: boolean; petOptions: AgentSetupPetOption[]; preview: { displayCommand: string; mcpJson: Record<string, unknown> }; status: ClaudeCodeStatus; hookStatus: ClaudeHookDoctorResult; memoryStatus: ClaudeOpenPetsMemoryStatus; opencodeStatus: OpenCodeSetupStatus; opencodePreview: OpenCodeSetupPreview; cursorStatus: CursorSetupStatus; cursorPreview: CursorSetupPreview; commandPaths: AgentSetupCommandPaths; busy: boolean; lastAction?: AgentSetupActionResult };
-type OpenPetsMcpServerPreview = { commandMode: "published" | "local" | "bundled"; command: string; args: readonly string[]; displayCommand: string; mcpJson: { mcpServers: { openpets: { type: "stdio"; command: string; args: readonly string[] } } } };
-type OpenPetsMcpServerHealth = { ok: boolean; output: string; error?: string };
+type AgentSetupSnapshot = { selectedPetId?: string; commandMode: "published" | "local" | "bundled"; localDevAvailable: boolean; petOptions: AgentSetupPetOption[]; preview: { displayCommand: string; mcpJson: Record<string, unknown> }; status: ClaudeCodeStatus; hookStatus: ClaudeHookDoctorResult; memoryStatus: ClaudeFamiliarOSMemoryStatus; opencodeStatus: OpenCodeSetupStatus; opencodePreview: OpenCodeSetupPreview; cursorStatus: CursorSetupStatus; cursorPreview: CursorSetupPreview; commandPaths: AgentSetupCommandPaths; busy: boolean; lastAction?: AgentSetupActionResult };
+type FamiliarOSMcpServerPreview = { commandMode: "published" | "local" | "bundled"; command: string; args: readonly string[]; displayCommand: string; mcpJson: { mcpServers: { familiaros: { type: "stdio"; command: string; args: readonly string[] } } } };
+type FamiliarOSMcpServerHealth = { ok: boolean; output: string; error?: string };
 type TtsProviderId = "system" | "openai" | "elevenlabs" | "piper" | "openai-compatible";
 type TtsEndpointPreset = "openrouter" | "litellm" | "wavespeedai" | "custom";
 type TtsVoice = { id: string; label: string };
@@ -219,7 +219,7 @@ const openApiEndpointPresets: readonly OpenApiEndpointPreset[] = [
     label: "OpenRouter",
     endpoint: "https://openrouter.ai/api/v1",
     applyMode: "save",
-    description: "Uses the OpenRouter OpenAPI base so OpenPets can choose the best supported chat route automatically.",
+    description: "Uses the OpenRouter OpenAPI base so FamiliarOS can choose the best supported chat route automatically.",
   },
   {
     id: "azure",
@@ -584,7 +584,7 @@ const ShieldIcon = () => (
 );
 
 // Navigation Shell Types and Icons
-type Route = "dashboard" | "pets" | "settings" | "plugins" | "integrations";
+type Route = "dashboard" | "familiars" | "settings" | "plugins" | "integrations";
 
 const DashboardIcon = () => (
   <svg className="nav-icon" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
@@ -638,7 +638,7 @@ const IntegrationsIcon = () => (
 
 const navTabs = [
   { id: "dashboard" as const, labelKey: "nav.dashboard", icon: <DashboardIcon /> },
-  { id: "pets" as const, labelKey: "nav.pets", icon: <PetsIcon /> },
+  { id: "familiars" as const, labelKey: "nav.familiars", icon: <PetsIcon /> },
   { id: "settings" as const, labelKey: "nav.settings", icon: <SettingsIcon /> },
   { id: "plugins" as const, labelKey: "nav.plugins", icon: <PluginsIcon /> },
   { id: "integrations" as const, labelKey: "nav.integrations", icon: <IntegrationsIcon /> },
@@ -649,9 +649,9 @@ const routeMetadata: Record<Route, { titleKey: string; descKey: string }> = {
     titleKey: "route.dashboard.title",
     descKey: "route.dashboard.description",
   },
-  pets: {
-    titleKey: "route.pets.title",
-    descKey: "route.pets.description",
+  familiars: {
+    titleKey: "route.familiars.title",
+    descKey: "route.familiars.description",
   },
   settings: {
     titleKey: "route.settings.title",
@@ -697,7 +697,7 @@ function DashboardView({ onNavigate }: { onNavigate: (route: Route) => void }) {
 
   const { activity, defaultPet, plugins, installedPetCount, updateStatus, catalog } = snapshot;
 
-  // Find top pet by activity or fallback to default
+  // Find top familiar by activity or fallback to default
   const topPetId = Object.entries(activity.perPetActivityCounts).sort(([, a], [, b]) => b - a)[0]?.[0];
   const topPetName = topPetId === defaultPet.id ? defaultPet.displayName : (topPetId || defaultPet.displayName);
 
@@ -732,10 +732,10 @@ function DashboardView({ onNavigate }: { onNavigate: (route: Route) => void }) {
             {t("dashboard.hero.desc")}
           </p>
           <div className="flex gap-3 mt-3">
-            <Button variant="secondary" size="compact" onClick={() => onNavigate("pets")}>{t("dashboard.hero.changePet")}</Button>
+            <Button variant="secondary" size="compact" onClick={() => onNavigate("familiars")}>{t("dashboard.hero.changePet")}</Button>
           </div>
         </div>
-        <div className="dashboard-hero-pet">
+        <div className="dashboard-hero-familiar">
           <SpriteFrame src={defaultPet.previewSpriteUrl} label={defaultPet.displayName} state="idle" size="detail" />
         </div>
       </section>
@@ -857,9 +857,9 @@ function DashboardView({ onNavigate }: { onNavigate: (route: Route) => void }) {
             <div className="dashboard-system-item">
               <div className="dashboard-system-info">
                 <div className="dashboard-system-icon"><BoxIcon /></div>
-                <span className="dashboard-system-label">{t("dashboard.system.pets")}</span>
+                <span className="dashboard-system-label">{t("dashboard.system.familiars")}</span>
               </div>
-              <span className="dashboard-system-value">{t("dashboard.system.pets.value", { count: installedPetCount })}</span>
+              <span className="dashboard-system-value">{t("dashboard.system.familiars.value", { count: installedPetCount })}</span>
             </div>
 
             <div className="dashboard-system-item">
@@ -878,7 +878,7 @@ function DashboardView({ onNavigate }: { onNavigate: (route: Route) => void }) {
                 <div className="dashboard-system-icon"><StarIcon /></div>
                 <span className="dashboard-system-label">{t("dashboard.system.catalog")}</span>
               </div>
-              <span className="dashboard-system-value">{catalog.error ? t("dashboard.system.catalog.offline") : catalog.total ? t("dashboard.system.catalog.pets", { count: catalog.total }) : t("dashboard.system.catalog.ready")}</span>
+              <span className="dashboard-system-value">{catalog.error ? t("dashboard.system.catalog.offline") : catalog.total ? t("dashboard.system.catalog.familiars", { count: catalog.total }) : t("dashboard.system.catalog.ready")}</span>
             </div>
 
             <div className="dashboard-system-item">
@@ -932,11 +932,11 @@ const filterIcons: Record<Filter, React.ReactNode> = {
 };
 
 const filterLabelKeys: Record<Filter, string> = {
-  all: "pets.filter.all",
-  installed: "pets.filter.installed",
-  featured: "pets.filter.featured",
-  originals: "pets.filter.originals",
-  codex: "pets.filter.codex",
+  all: "familiars.filter.all",
+  installed: "familiars.filter.installed",
+  featured: "familiars.filter.featured",
+  originals: "familiars.filter.originals",
+  codex: "familiars.filter.codex",
 };
 
 const buttonVariantClass = {
@@ -958,7 +958,7 @@ const statusPillToneClass = {
 } as const;
 
 function isRoute(value: string | null | undefined): value is Route {
-  return value === "dashboard" || value === "pets" || value === "settings" || value === "plugins" || value === "integrations";
+  return value === "dashboard" || value === "familiars" || value === "settings" || value === "plugins" || value === "integrations";
 }
 
 function initialControlCenterRoute(): Route {
@@ -999,28 +999,28 @@ function buildPersistentToolkitBundle(target: McpToolkitPersistentTarget): McpTo
     return {
       label: "Claude Code user-scope install bundle",
       language: "bash",
-      description: "This mirrors OpenPets' supported Install Now baseline for Claude Code. It keeps the same managed server names so reruns stay predictable.",
-      value: `claude mcp add --scope user openpets-filesystem -- npx -y @modelcontextprotocol/server-filesystem "$HOME"
-claude mcp add --scope user openpets-playwright -- npx @playwright/mcp@latest
-claude mcp add --scope user openpets-memory -- npx -y @modelcontextprotocol/server-memory
-claude mcp add --scope user openpets-context7 -- npx -y @upstash/context7-mcp
-claude mcp add --scope user openpets-fetch -- uvx mcp-server-fetch
-claude mcp add --scope user openpets-sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
-claude mcp add --scope user openpets-browser-use -- uvx --from browser-use[cli] browser-use --mcp`,
+      description: "This mirrors FamiliarOS' supported Install Now baseline for Claude Code. It keeps the same managed server names so reruns stay predictable.",
+      value: `claude mcp add --scope user familiaros-filesystem -- npx -y @modelcontextprotocol/server-filesystem "$HOME"
+claude mcp add --scope user familiaros-playwright -- npx @playwright/mcp@latest
+claude mcp add --scope user familiaros-memory -- npx -y @modelcontextprotocol/server-memory
+claude mcp add --scope user familiaros-context7 -- npx -y @upstash/context7-mcp
+claude mcp add --scope user familiaros-fetch -- uvx mcp-server-fetch
+claude mcp add --scope user familiaros-sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
+claude mcp add --scope user familiaros-browser-use -- uvx --from browser-use[cli] browser-use --mcp`,
     };
   }
 
   return {
     label: "Codex CLI persistent install bundle",
     language: "bash",
-    description: "This mirrors OpenPets' supported Install Now baseline for Codex CLI and keeps the same managed server names.",
-    value: `codex mcp add openpets-filesystem -- npx -y @modelcontextprotocol/server-filesystem "$HOME"
-codex mcp add openpets-playwright -- npx @playwright/mcp@latest
-codex mcp add openpets-memory -- npx -y @modelcontextprotocol/server-memory
-codex mcp add openpets-context7 -- npx -y @upstash/context7-mcp
-codex mcp add openpets-fetch -- uvx mcp-server-fetch
-codex mcp add openpets-sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
-codex mcp add openpets-browser-use -- uvx --from browser-use[cli] browser-use --mcp`,
+    description: "This mirrors FamiliarOS' supported Install Now baseline for Codex CLI and keeps the same managed server names.",
+    value: `codex mcp add familiaros-filesystem -- npx -y @modelcontextprotocol/server-filesystem "$HOME"
+codex mcp add familiaros-playwright -- npx @playwright/mcp@latest
+codex mcp add familiaros-memory -- npx -y @modelcontextprotocol/server-memory
+codex mcp add familiaros-context7 -- npx -y @upstash/context7-mcp
+codex mcp add familiaros-fetch -- uvx mcp-server-fetch
+codex mcp add familiaros-sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
+codex mcp add familiaros-browser-use -- uvx --from browser-use[cli] browser-use --mcp`,
   };
 }
 
@@ -1067,18 +1067,18 @@ function Button({
 }
 function GlassCard({ children, className = "" }: { children: React.ReactNode; className?: string }) { return <section className={`glass ${className}`}>{children}</section>; }
 function StatusPill({ children, tone = "blue" }: { children: React.ReactNode; tone?: keyof typeof statusPillToneClass }) { return <span className={`pill ${statusPillToneClass[tone]}`}>{children}</span>; }
-function SearchInput(props: React.InputHTMLAttributes<HTMLInputElement>) { const { t } = useI18n(); return <input className="search" placeholder={t("pets.search.placeholder")} {...props} />; }
+function SearchInput(props: React.InputHTMLAttributes<HTMLInputElement>) { const { t } = useI18n(); return <input className="search" placeholder={t("familiars.search.placeholder")} {...props} />; }
 
 function isAllowedCatalogPreview(value: string | undefined): value is string {
   if (!value) return false;
   try {
     const url = new URL(value);
     return url.protocol === "https:" && 
-      url.hostname === "openpets.dev" && 
+      url.hostname === "familiaros.dev" && 
       url.port === "" && 
       url.username === "" && 
       url.password === "" && 
-      url.pathname.startsWith("/pets/") && 
+      url.pathname.startsWith("/familiars/") && 
       url.pathname.endsWith(".webp");
   } catch {
     return false;
@@ -1086,15 +1086,15 @@ function isAllowedCatalogPreview(value: string | undefined): value is string {
 }
 
 function isAllowedCodexPreview(value: string | undefined): value is string {
-  return typeof value === "string" && /^openpets-codex:\/\/spritesheet\/[a-zA-Z0-9%][a-zA-Z0-9%_-]{0,128}$/u.test(value);
+  return typeof value === "string" && /^familiaros-codex:\/\/spritesheet\/[a-zA-Z0-9%][a-zA-Z0-9%_-]{0,128}$/u.test(value);
 }
 
 function isAllowedInstalledPetPreview(value: string | undefined): value is string {
-  return typeof value === "string" && /^openpets-installed:\/\/spritesheet\/[a-zA-Z0-9%][a-zA-Z0-9%_-]{0,128}$/u.test(value);
+  return typeof value === "string" && /^familiaros-installed:\/\/spritesheet\/[a-zA-Z0-9%][a-zA-Z0-9%_-]{0,128}$/u.test(value);
 }
 
 function isAllowedDefaultPetPreview(value: string | undefined): value is string {
-  return typeof value === "string" && /^openpets-pet-preview:\/\/spritesheet\/default\?v=[a-z0-9_-]+-\d+-\d+$/u.test(value);
+  return typeof value === "string" && /^familiaros-familiar-preview:\/\/spritesheet\/default\?v=[a-z0-9_-]+-\d+-\d+$/u.test(value);
 }
 
 function isAllowedDataUrl(value: string | undefined): value is string {
@@ -1106,7 +1106,7 @@ function safePetImage(value: string | undefined): string | undefined {
 }
 
 function installedPetSpritesheetUrl(petId: string): string {
-  return `openpets-installed://spritesheet/${encodeURIComponent(petId)}`;
+  return `familiaros-installed://spritesheet/${encodeURIComponent(petId)}`;
 }
 
 function imageDebug(value: string | undefined): string {
@@ -1210,6 +1210,7 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
   const [openApiCredential, setOpenApiCredential] = useState("");
   const [openApiModelDraft, setOpenApiModelDraft] = useState("");
   const [openApiSystemPromptDraft, setOpenApiSystemPromptDraft] = useState("");
+  const [familiarNameDraft, setFamiliarNameDraft] = useState("");
   const [openApiBaseInstructionsEnabled, setOpenApiBaseInstructionsEnabled] = useState(true);
   const [openApiEndpointDraft, setOpenApiEndpointDraft] = useState("");
   const [ttsSettings, setTtsSettings] = useState<TtsSettingsSnapshot | null>(null);
@@ -1263,6 +1264,7 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
     setSettings(nextSettings);
     setOpenApiModelDraft(nextSettings.preferences.openApiChatModel ?? nextSettings.openApiChat.model);
     setOpenApiSystemPromptDraft(nextSettings.preferences.openApiChatSystemPrompt ?? "");
+    setFamiliarNameDraft(nextSettings.preferences.familiarName ?? "");
     setOpenApiBaseInstructionsEnabled(nextSettings.preferences.openApiChatBaseInstructionsEnabled !== false);
     setOpenApiEndpointDraft(nextSettings.preferences.openApiChatEndpoint ?? "");
     onThemeModeChange(normalizeThemeMode(nextSettings.preferences.openApiChatTheme));
@@ -1345,6 +1347,9 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
       if ("openApiChatSystemPrompt" in patch) {
         setOpenApiSystemPromptDraft(next.preferences.openApiChatSystemPrompt ?? "");
       }
+      if ("familiarName" in patch) {
+        setFamiliarNameDraft(next.preferences.familiarName ?? "");
+      }
       setMessage(success);
     });
   }
@@ -1467,21 +1472,21 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
                           void patchPreferences({ openApiChatBaseInstructionsEnabled: next }, next ? "Base instructions enabled." : "Base instructions disabled.");
                         }}
                       />
-                      <span className="text-sm text-slatecopy">Include OpenPets base instructions</span>
+                      <span className="text-sm text-slatecopy">Include FamiliarOS base instructions</span>
                     </label>
                   </div>
                 </div>
 
                 <div className="settings-row">
                   <div className="settings-row-info">
-                    <strong>Pet character</strong>
-                    <small>Sets the pet's tone, personality, and boundaries for future replies.</small>
+                    <strong>Familiar character</strong>
+                    <small>Sets the familiar's tone, personality, and boundaries for future replies.</small>
                   </div>
                   <div className="flex min-w-[320px] max-w-[620px] flex-1 flex-col items-stretch gap-2">
                     <textarea
                       className="plugin-input plugin-textarea"
                       value={openApiSystemPromptDraft}
-                      placeholder="Describe the pet's personality, speaking style, and boundaries."
+                      placeholder="Describe the familiar's personality, speaking style, and boundaries."
                       disabled={!settings || !!busy}
                       onChange={(event) => setOpenApiSystemPromptDraft(event.target.value)}
                     />
@@ -1498,7 +1503,7 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
                         variant="secondary"
                         size="compact"
                         disabled={!settings || !!busy}
-                        onClick={() => patchPreferences({ openApiChatSystemPrompt: openApiSystemPromptDraft.trim() || undefined }, "Pet character saved.")}
+                        onClick={() => patchPreferences({ openApiChatSystemPrompt: openApiSystemPromptDraft.trim() || undefined }, "Familiar character saved.")}
                       >
                         Save
                       </Button>
@@ -1713,7 +1718,7 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
                     onChange={(event) => patchPreferences({ petScale: Number(event.target.value) }, t("settings.toast.petScaleSaved"))}
                   >
                     {(settings?.petScaleOptions ?? []).map((option) => (
-                      <option key={option.value} value={option.value} title={`Pet scale: ${option.label}`}>
+                      <option key={option.value} value={option.value} title={`Familiar scale: ${option.label}`}>
                         {option.label}
                       </option>
                     ))}
@@ -1722,8 +1727,8 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
                     <button
                       type="button"
                       className="scale-nudge"
-                      aria-label="Decrease pet scale"
-                      title="Decrease pet scale"
+                      aria-label="Decrease familiar scale"
+                      title="Decrease familiar scale"
                       disabled={!settings || !!busy || (settings?.preferences.petScale ?? 0.56) <= 0.16}
                       onClick={() => patchPreferences({ petScale: Math.max(0.16, (settings?.preferences.petScale ?? 0.56) - 0.02) }, t("settings.toast.petScaleSaved"))}
                     >
@@ -1742,8 +1747,8 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
                     <button
                       type="button"
                       className="scale-nudge"
-                      aria-label="Increase pet scale"
-                      title="Increase pet scale"
+                      aria-label="Increase familiar scale"
+                      title="Increase familiar scale"
                       disabled={!settings || !!busy || (settings?.preferences.petScale ?? 0.56) >= 10}
                       onClick={() => patchPreferences({ petScale: Math.min(10, (settings?.preferences.petScale ?? 0.56) + 0.02) }, t("settings.toast.petScaleSaved"))}
                     >
@@ -1779,6 +1784,32 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
                   {availableLocales.map((option) => <option key={option.value} value={option.value}>{option.label}</option>)}
                 </select>
               </div>
+              <div className="settings-row">
+                <div className="settings-row-info">
+                  <strong>{t("settings.general.familiarName.title")}</strong>
+                  <small>{t("settings.general.familiarName.description")}</small>
+                </div>
+                <div className="flex items-center gap-2 min-w-[180px]">
+                  <input
+                    type="text"
+                    className="settings-input"
+                    value={familiarNameDraft}
+                    disabled={!settings || !!busy}
+                    placeholder={t("common.builtInPet")}
+                    maxLength={64}
+                    onChange={(event) => setFamiliarNameDraft(event.target.value)}
+                    onKeyDown={(event) => { if (event.key === "Enter") { event.preventDefault(); patchPreferences({ familiarName: familiarNameDraft.trim() || undefined }, t("settings.toast.familiarNameSaved")); } }}
+                  />
+                  <Button
+                    variant="primary"
+                    size="compact"
+                    disabled={!settings || !!busy || familiarNameDraft.trim() === (settings?.preferences.familiarName ?? "")}
+                    onClick={() => patchPreferences({ familiarName: familiarNameDraft.trim() || undefined }, t("settings.toast.familiarNameSaved"))}
+                  >
+                    {t("common.save")}
+                  </Button>
+                </div>
+              </div>
             </div>
 
             <div className="settings-actions">
@@ -2188,7 +2219,7 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
           <div className="settings-section">
             <p className="eyebrow">Memory & files</p>
             <h2 className="settings-section-title">Knowledge Store</h2>
-            <p className="text-sm text-slatecopy -mt-2 mb-2">Store files and commandable memories the pet can recall during chat.</p>
+            <p className="text-sm text-slatecopy -mt-2 mb-2">Store files and commandable memories the familiar can recall during chat.</p>
 
             <div className="settings-group">
               <div className="settings-row">
@@ -2256,7 +2287,7 @@ function SettingsView({ onThemeModeChange }: { onThemeModeChange: (mode: ThemeMo
               <div className="settings-row">
                 <div className="settings-row-info">
                   <strong>Memories</strong>
-                  <small>Add short facts, preferences, or commands the pet should remember.</small>
+                  <small>Add short facts, preferences, or commands the familiar should remember.</small>
                 </div>
                 <div className="flex min-w-[320px] max-w-[620px] flex-1 flex-col items-stretch gap-2">
                   <div className="flex flex-col gap-2">
@@ -2381,22 +2412,22 @@ const pluginFilterLabelKeys: Record<PluginFilter, string> = {
 };
 
 const pluginPermissionLabelKeys: Record<PluginPermission, string> = {
-  "pet:speak": "plugins.permission.pet:speak",
-  "pet:reaction": "plugins.permission.pet:reaction",
-  "pet:move": "plugins.permission.pet:move",
+  "familiar:speak": "plugins.permission.familiar:speak",
+  "familiar:reaction": "plugins.permission.familiar:reaction",
+  "familiar:move": "plugins.permission.familiar:move",
   timer: "plugins.permission.timer",
   schedule: "plugins.permission.schedule",
   storage: "plugins.permission.storage",
   status: "plugins.permission.status",
   commands: "plugins.permission.commands",
   network: "plugins.permission.network",
-  "pet:interact": "plugins.permission.pet:interact",
-  "pet:pin": "plugins.permission.pet:pin",
-  "pet:animate": "plugins.permission.pet:animate",
-  "pet:speak:dynamic": "plugins.permission.pet:speak:dynamic",
-  "pet:drop": "plugins.permission.pet:drop",
-  "pets:read": "plugins.permission.pets:read",
-  "pets:manage": "plugins.permission.pets:manage",
+  "familiar:interact": "plugins.permission.familiar:interact",
+  "familiar:pin": "plugins.permission.familiar:pin",
+  "familiar:animate": "plugins.permission.familiar:animate",
+  "familiar:speak:dynamic": "plugins.permission.familiar:speak:dynamic",
+  "familiar:drop": "plugins.permission.familiar:drop",
+  "familiars:read": "plugins.permission.familiars:read",
+  "familiars:manage": "plugins.permission.familiars:manage",
   audio: "plugins.permission.audio",
   events: "plugins.permission.events",
   "ui:toast": "plugins.permission.ui:toast",
@@ -2414,7 +2445,7 @@ const pluginPermissionLabelKeys: Record<PluginPermission, string> = {
   clipboard: "plugins.permission.clipboard",
   "network:write": "plugins.permission.network:write",
 };
-const sensitivePermissionSet = new Set<PluginPermission>(["voice:listen", "clipboard", "pet:speak:dynamic"]);
+const sensitivePermissionSet = new Set<PluginPermission>(["voice:listen", "clipboard", "familiar:speak:dynamic"]);
 
 const pluginStatusTone: Record<NonNullable<PluginStatus["tone"]>, keyof typeof statusPillToneClass> = {
   info: "blue",
@@ -2566,7 +2597,7 @@ function ConfigFieldEditor({ pluginId, fieldKey, field, value, onChange, onPickS
     const items = Array.isArray(value) ? value.filter((item): item is Record<string, unknown> => item !== null && typeof item === "object" && !Array.isArray(item)) : [];
     const maxed = typeof field.maxItems === "number" && items.length >= field.maxItems;
 
-    const isReminders = (pluginId === "openpets.break-buddy" || fieldKey === "reminders") && ["reminders", "breaks"].includes(fieldKey);
+    const isReminders = (pluginId === "familiaros.break-buddy" || fieldKey === "reminders") && ["reminders", "breaks"].includes(fieldKey);
     const addLabel = isReminders ? t("plugins.config.addReminder") : t("plugins.config.addItem");
 
     return <div className="plugin-config-row">
@@ -2718,7 +2749,7 @@ function IntegrationIcon({ id }: { id: string }) {
   const src = logos[id];
   if (src) return <img src={src} className="integration-logo" alt="" draggable="false" />;
   if (id === "mcp-toolkit" || id === "mcp-tool-servers") return <BoxIcon />;
-  if (id === "openpets-mcp-server") return <ServerIcon />;
+  if (id === "familiaros-mcp-server") return <ServerIcon />;
   return <PluginGlyph />;
 }
 
@@ -2764,8 +2795,8 @@ function IntegrationsView() {
   const [busy, setBusy] = useState("");
   const [error, setError] = useState("");
   const [message, setMessage] = useState("");
-  const [openpetsMcpPreview, setOpenpetsMcpPreview] = useState<OpenPetsMcpServerPreview | null>(null);
-  const [openpetsMcpTest, setOpenpetsMcpTest] = useState<{ busy: boolean; result: OpenPetsMcpServerHealth | null }>({ busy: false, result: null });
+  const [familiarosMcpPreview, setOpenpetsMcpPreview] = useState<FamiliarOSMcpServerPreview | null>(null);
+  const [familiarosMcpTest, setOpenpetsMcpTest] = useState<{ busy: boolean; result: FamiliarOSMcpServerHealth | null }>({ busy: false, result: null });
 
   const load = async (selectedPetId?: string, commandMode?: AgentSetupSnapshot["commandMode"]) => {
     try {
@@ -2800,7 +2831,7 @@ function IntegrationsView() {
 
   useEffect(() => {
     if (!snapshot) return;
-    void api.getOpenPetsMcpServerPreview(snapshot.selectedPetId, snapshot.commandMode)
+    void api.getFamiliarOSMcpServerPreview(snapshot.selectedPetId, snapshot.commandMode)
       .then(setOpenpetsMcpPreview)
       .catch(() => setOpenpetsMcpPreview(null));
   }, [snapshot?.selectedPetId, snapshot?.commandMode, snapshot?.commandPaths.node]);
@@ -2859,18 +2890,18 @@ function IntegrationsView() {
     }
   };
 
-  const testOpenPetsMcpServer = async () => {
+  const testFamiliarOSMcpServer = async () => {
     if (!snapshot) return;
     try {
       setOpenpetsMcpTest({ busy: true, result: null });
       setError("");
       setMessage("");
-      const result = await api.testOpenPetsMcpServer(snapshot.selectedPetId, snapshot.commandMode);
+      const result = await api.testFamiliarOSMcpServer(snapshot.selectedPetId, snapshot.commandMode);
       setOpenpetsMcpTest({ busy: false, result });
       if (result.ok) {
-        setMessage(t("integrations.openpetsMcpServer.testOk", { output: result.output }));
+        setMessage(t("integrations.familiarosMcpServer.testOk", { output: result.output }));
       } else {
-        setError(t("integrations.openpetsMcpServer.testError", { error: result.error || "unknown" }));
+        setError(t("integrations.familiarosMcpServer.testError", { error: result.error || "unknown" }));
       }
     } catch (err) {
       setOpenpetsMcpTest({ busy: false, result: null });
@@ -2878,9 +2909,9 @@ function IntegrationsView() {
     }
   };
 
-  const copyOpenPetsMcpJson = async () => {
-    if (!openpetsMcpPreview) return;
-    await copyText("MCP JSON", JSON.stringify(openpetsMcpPreview.mcpJson, null, 2));
+  const copyFamiliarOSMcpJson = async () => {
+    if (!familiarosMcpPreview) return;
+    await copyText("MCP JSON", JSON.stringify(familiarosMcpPreview.mcpJson, null, 2));
   };
 
   const saveVanillaChatTools = async (toolIds: string[]) => {
@@ -2941,7 +2972,7 @@ function IntegrationsView() {
   const mcpToolServersActive = vanillaChatTools.length;
   const integrations = [
     { id: "mcp-tool-servers", name: t("integrations.mcpToolServers.name"), icon: "mcp-tool-servers", status: mcpToolServersActive > 0 ? t("integrations.mcpToolServers.status", { count: mcpToolServersActive }) : t("integrations.mcpToolServers.noTools"), tone: mcpToolServersActive > 0 ? "green" : "slate", description: t("integrations.mcpToolServers.description") },
-    { id: "openpets-mcp-server", name: t("integrations.openpetsMcpServer.name"), icon: "openpets-mcp-server", status: t("integrations.openpetsMcpServer.status"), tone: "blue" satisfies StatusTone, description: t("integrations.openpetsMcpServer.description") },
+    { id: "familiaros-mcp-server", name: t("integrations.familiarosMcpServer.name"), icon: "familiaros-mcp-server", status: t("integrations.familiarosMcpServer.status"), tone: "blue" satisfies StatusTone, description: t("integrations.familiarosMcpServer.description") },
     { id: "claude", name: t("integrations.claude.name"), icon: "claude", status: snapshot.status.label, tone: claudeStatusTone(snapshot.status.state), description: t("integrations.claude.description") },
     { id: "opencode", name: t("integrations.opencode.name"), icon: "opencode", status: snapshot.opencodeStatus.label, tone: opencodeStatusTone(snapshot.opencodeStatus.state), description: t("integrations.opencode.description") },
     { id: "cursor", name: t("integrations.cursor.name"), icon: "cursor", status: snapshot.cursorStatus.label, tone: cursorStatusTone(snapshot.cursorStatus.state), description: t("integrations.cursor.description") },
@@ -2961,8 +2992,8 @@ function IntegrationsView() {
       ? t("integrations.curatedToolkit.name")
       : selectedId === "mcp-tool-servers"
         ? t("integrations.mcpToolServers.name")
-        : selectedId === "openpets-mcp-server"
-          ? t("integrations.openpetsMcpServer.name")
+        : selectedId === "familiaros-mcp-server"
+          ? t("integrations.familiarosMcpServer.name")
           : integrations.find((item) => item.id === selectedId)?.name;
 
   return (
@@ -3032,15 +3063,15 @@ function IntegrationsView() {
             </div>
 
             <div className="flex flex-col gap-5 mt-4">
-              {selectedId === "openpets-mcp-server" && (
+              {selectedId === "familiaros-mcp-server" && (
                 <section className="plugin-section">
                   <div className="plugin-section-title"><small>{t("integrations.commandSource")}</small><strong>{t("integrations.cliMode")}</strong></div>
-                  <select className="settings-select w-full" value={snapshot.commandMode} disabled={isBusy || openpetsMcpTest.busy} onChange={(event) => changeCommandMode(event.target.value as AgentSetupSnapshot["commandMode"])}>
+                  <select className="settings-select w-full" value={snapshot.commandMode} disabled={isBusy || familiarosMcpTest.busy} onChange={(event) => changeCommandMode(event.target.value as AgentSetupSnapshot["commandMode"])}>
                     <option value="published">{t(commandModeLabelKeys.published)}</option>
                     <option value="bundled">{t(commandModeLabelKeys.bundled)}</option>
                     <option value="local" disabled={!snapshot.localDevAvailable}>{t(commandModeLabelKeys.local)}{snapshot.localDevAvailable ? "" : t("integrations.localUnavailable")}</option>
                   </select>
-                  <p className="text-xs text-slatecopy mt-2">{t("integrations.openpetsMcpServer.commandModeHelp")}</p>
+                  <p className="text-xs text-slatecopy mt-2">{t("integrations.familiarosMcpServer.commandModeHelp")}</p>
                 </section>
               )}
 
@@ -3056,7 +3087,7 @@ function IntegrationsView() {
                 <section className="plugin-section">
                   <div className="plugin-section-title"><small>{t("integrations.mcpToolServers.builtInChat")}</small><strong>{t("integrations.mcpToolServers.name")}</strong></div>
                   <p className="text-sm text-slatecopy leading-relaxed">
-                    Select which MCP tools the pet can use directly in the floating chat window. When active, the pet can run terminal commands, browse files, fetch web pages, and more.
+                    Select which MCP tools the familiar can use directly in the floating chat window. When active, the familiar can run terminal commands, browse files, fetch web pages, and more.
                   </p>
                   <div className="flex flex-col gap-4 mt-3">
                     {(["starter", "system", "advanced"] as const).map((tier) => {
@@ -3097,17 +3128,17 @@ function IntegrationsView() {
                     </Button>
                   </div>
                   <small className="text-xs text-slatecopy leading-relaxed mt-2 block">
-                    Only tools with a green dot are active in the vanilla chat. The pet will only use tools that are both selected <em>and</em> successfully started by the system.
+                    Only tools with a green dot are active in the vanilla chat. The familiar will only use tools that are both selected <em>and</em> successfully started by the system.
                   </small>
                 </section>
               )}
 
-              {selectedId === "openpets-mcp-server" && (
+              {selectedId === "familiaros-mcp-server" && (
                 <>
                   <section className="plugin-section">
                     <div className="plugin-section-title"><small>{t("integrations.configuration")}</small><strong>{t("integrations.commandPaths")}</strong></div>
                     <div className="flex flex-col gap-3">
-                      <PathField label={t("integrations.nodeCommand")} value={snapshot.commandPaths.node} placeholder="node" onSave={(v) => updatePath("node", v)} disabled={isBusy || openpetsMcpTest.busy} />
+                      <PathField label={t("integrations.nodeCommand")} value={snapshot.commandPaths.node} placeholder="node" onSave={(v) => updatePath("node", v)} disabled={isBusy || familiarosMcpTest.busy} />
                     </div>
                   </section>
 
@@ -3119,7 +3150,7 @@ function IntegrationsView() {
                         className="settings-select w-full"
                         value={snapshot.selectedPetId || ""}
                         onChange={(e) => void load(e.target.value)}
-                        disabled={isBusy || openpetsMcpTest.busy}
+                        disabled={isBusy || familiarosMcpTest.busy}
                       >
                         <option value="">{t("integrations.defaultPet")}</option>
                         {snapshot.petOptions.map(p => <option key={p.id} value={p.id}>{p.displayName}</option>)}
@@ -3130,16 +3161,16 @@ function IntegrationsView() {
                   <section className="plugin-section">
                     <div className="plugin-section-title"><small>{t("integrations.actions")}</small><strong>{t("integrations.management")}</strong></div>
                     <div className="flex flex-wrap gap-2">
-                      <Button variant="primary" icon={<RefreshIcon />} disabled={isBusy || openpetsMcpTest.busy} onClick={() => void testOpenPetsMcpServer()}>
-                        {openpetsMcpTest.busy ? t("integrations.openpetsMcpServer.testBusy") : t("integrations.openpetsMcpServer.testServer")}
+                      <Button variant="primary" icon={<RefreshIcon />} disabled={isBusy || familiarosMcpTest.busy} onClick={() => void testFamiliarOSMcpServer()}>
+                        {familiarosMcpTest.busy ? t("integrations.familiarosMcpServer.testBusy") : t("integrations.familiarosMcpServer.testServer")}
                       </Button>
-                      <Button variant="secondary" icon={<CopyIcon />} disabled={isBusy || !openpetsMcpPreview} onClick={() => void copyOpenPetsMcpJson()}>
-                        {t("integrations.openpetsMcpServer.copyMcpJson")}
+                      <Button variant="secondary" icon={<CopyIcon />} disabled={isBusy || !familiarosMcpPreview} onClick={() => void copyFamiliarOSMcpJson()}>
+                        {t("integrations.familiarosMcpServer.copyMcpJson")}
                       </Button>
                     </div>
-                    {openpetsMcpTest.result && (
-                      <div className={`mt-3 p-3 rounded-2xl border text-xs ${openpetsMcpTest.result.ok ? "bg-green-50/50 border-green-200/80 text-green-900" : "bg-red-50/50 border-red-200/80 text-red-900"}`}>
-                        {openpetsMcpTest.result.ok ? openpetsMcpTest.result.output : (openpetsMcpTest.result.error || "Unknown error")}
+                    {familiarosMcpTest.result && (
+                      <div className={`mt-3 p-3 rounded-2xl border text-xs ${familiarosMcpTest.result.ok ? "bg-green-50/50 border-green-200/80 text-green-900" : "bg-red-50/50 border-red-200/80 text-red-900"}`}>
+                        {familiarosMcpTest.result.ok ? familiarosMcpTest.result.output : (familiarosMcpTest.result.error || "Unknown error")}
                       </div>
                     )}
                   </section>
@@ -3150,7 +3181,7 @@ function IntegrationsView() {
                       <span className="text-brand group-open:rotate-180 transition-transform"><NextIcon /></span>
                     </summary>
                     <pre className="mt-3 p-3 rounded-xl bg-navy/5 text-[10px] font-mono overflow-x-auto border border-navy/5">
-                      {openpetsMcpPreview ? JSON.stringify(openpetsMcpPreview.mcpJson, null, 2) : "Loading preview…"}
+                      {familiarosMcpPreview ? JSON.stringify(familiarosMcpPreview.mcpJson, null, 2) : "Loading preview…"}
                     </pre>
                   </details>
                 </>
@@ -3294,23 +3325,23 @@ function IntegrationsView() {
                   <div className="mt-3 p-4 rounded-2xl bg-navy/5 border border-navy/5 flex flex-col gap-3">
                     <div className="flex flex-col gap-1">
                       <span className="text-[10px] font-bold text-slatecopy uppercase tracking-wider">{t("integrations.pi.globalInstall")}</span>
-                      <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">pi install npm:@open-pets/pi</code>
+                      <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">pi install npm:@familiaros/pi</code>
                     </div>
                     <div className="flex flex-col gap-1">
                       <span className="text-[10px] font-bold text-slatecopy uppercase tracking-wider">{t("integrations.pi.projectInstall")}</span>
-                      <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">pi install -l npm:@open-pets/pi</code>
+                      <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">pi install -l npm:@familiaros/pi</code>
                     </div>
                     <div className="flex flex-col gap-1">
                       <span className="text-[10px] font-bold text-slatecopy uppercase tracking-wider">{t("integrations.pi.remove")}</span>
-                      <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">pi remove npm:@open-pets/pi</code>
+                      <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">pi remove npm:@familiaros/pi</code>
                     </div>
                   </div>
                   <div className="mt-3 p-4 rounded-2xl bg-blue-50/50 border border-blue-100/60 flex flex-col gap-2">
                     <span className="text-[10px] font-bold text-slatecopy uppercase tracking-wider">{t("integrations.pi.slashCommands")}</span>
-                    <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">/openpets status</code>
-                    <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">/openpets test</code>
-                    <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">/openpets react &lt;reaction&gt;</code>
-                    <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">/openpets say &lt;message&gt;</code>
+                    <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">/familiaros status</code>
+                    <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">/familiaros test</code>
+                    <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">/familiaros react &lt;reaction&gt;</code>
+                    <code className="bg-white px-2 py-1 rounded border border-blue-100 text-brand text-xs">/familiaros say &lt;message&gt;</code>
                   </div>
                   <p className="text-xs text-slatecopy mt-2">
                     {t("integrations.pi.outro")}
@@ -3342,7 +3373,7 @@ function IntegrationsView() {
                       </button>
                     </div>
                     <small className="text-xs text-slatecopy leading-relaxed">
-                      <strong>Manual Setup</strong> shows copy-paste commands for each tool so you can install them yourself into your host agent. <strong>Persistent Full Access</strong> lets OpenPets register the supported baseline automatically into Claude Code or Codex CLI.
+                      <strong>Manual Setup</strong> shows copy-paste commands for each tool so you can install them yourself into your host agent. <strong>Persistent Full Access</strong> lets FamiliarOS register the supported baseline automatically into Claude Code or Codex CLI.
                     </small>
                   </section>
 
@@ -3455,7 +3486,7 @@ function IntegrationsView() {
                       <section className="plugin-section">
                         <div className="plugin-section-title"><small>Persistent Install</small><strong>Choose your host</strong></div>
                         <p className="text-sm text-slatecopy leading-relaxed">
-                          This mode is for the “install it for good” path. OpenPets can install the supported persistent baseline for you now, and it also shows the exact matching bundle if you prefer to run it yourself.
+                          This mode is for the “install it for good” path. FamiliarOS can install the supported persistent baseline for you now, and it also shows the exact matching bundle if you prefer to run it yourself.
                         </p>
                         <div className="plugin-chip-list">
                           <button
@@ -3504,7 +3535,7 @@ function IntegrationsView() {
                           <span className="pill pill-green">Context7 / Docs</span>
                         </div>
                         <small className="text-xs text-slatecopy leading-relaxed">
-                          These are the lanes OpenPets can attempt automatically today. Browser Use and Fetch / Web still depend on `uvx`, and Browser Use still needs its own runtime credential in the host environment.
+                          These are the lanes FamiliarOS can attempt automatically today. Browser Use and Fetch / Web still depend on `uvx`, and Browser Use still needs its own runtime credential in the host environment.
                         </small>
                       </section>
 
@@ -3835,7 +3866,7 @@ function ControlCenter() {
   const [catalogPages, setCatalogPages] = useState<Record<number, PetEntry[]>>({});
   const [catalogSearch, setCatalogSearch] = useState<SearchPetEntry[] | null>(null);
   const [catalogPage, setCatalogPage] = useState(0);
-  const [codex, setCodex] = useState<CodexState>({ pets: [] });
+  const [codex, setCodex] = useState<CodexState>({ familiars: [] });
   const [selectedId, setSelectedId] = useState("");
   const [filter, setFilter] = useState<Filter>("all");
   const [query, setQuery] = useState("");
@@ -3868,29 +3899,29 @@ function ControlCenter() {
   async function loadPetsData() {
     setError("");
     const [nextState, nextCatalog, nextCodex] = await Promise.all([api.getPetsState(), api.getCatalog(), api.getCodexPets()]);
-    logPetsEvent("load-complete", { installed: nextState.pets.installed.length, defaultPetId: nextState.preferences.defaultPetId, catalogSource: nextCatalog.source, catalogPets: nextCatalog.pets.length, catalogPage: nextCatalog.page, catalogPageCount: nextCatalog.pageCount, codexPets: nextCodex.pets.length, catalogError: nextCatalog.error, codexError: nextCodex.error, firstCatalogPet: nextCatalog.pets[0] ? { id: nextCatalog.pets[0].id, preview: imageDebug(nextCatalog.pets[0].preview), thumbnail: imageDebug(nextCatalog.pets[0].thumbnail), spritesheet: imageDebug(nextCatalog.pets[0].spritesheet) } : null });
+    logPetsEvent("load-complete", { installed: nextState.familiars.installed.length, defaultPetId: nextState.preferences.defaultPetId, catalogSource: nextCatalog.source, catalogPets: nextCatalog.familiars.length, catalogPage: nextCatalog.page, catalogPageCount: nextCatalog.pageCount, codexPets: nextCodex.familiars.length, catalogError: nextCatalog.error, codexError: nextCodex.error, firstCatalogPet: nextCatalog.familiars[0] ? { id: nextCatalog.familiars[0].id, preview: imageDebug(nextCatalog.familiars[0].preview), thumbnail: imageDebug(nextCatalog.familiars[0].thumbnail), spritesheet: imageDebug(nextCatalog.familiars[0].spritesheet) } : null });
     setState(nextState); setCatalog(nextCatalog); setCodex(nextCodex);
     setCatalogPage(nextCatalog.page ?? 0);
-    setCatalogPages({ [nextCatalog.page ?? 0]: nextCatalog.pets });
-    const visiblePetIds = new Set<string>([...nextState.pets.installed.map((pet) => pet.id), ...nextCatalog.pets.map((pet) => pet.id), ...nextCodex.pets.map((pet) => pet.id)]);
+    setCatalogPages({ [nextCatalog.page ?? 0]: nextCatalog.familiars });
+    const visiblePetIds = new Set<string>([...nextState.familiars.installed.map((familiar) => familiar.id), ...nextCatalog.familiars.map((familiar) => familiar.id), ...nextCodex.familiars.map((familiar) => familiar.id)]);
     setSelectedId((current) => current && visiblePetIds.has(current) ? current : "");
   }
   useEffect(() => {
-    if (currentRoute !== "pets") return;
+    if (currentRoute !== "familiars") return;
     void loadPetsData().catch((err) => setError(String(err?.message ?? err)));
   }, [currentRoute]);
 
-  const pets = useMemo(() => {
-    const installed = new Map((state?.pets.installed ?? []).map((p) => [p.id, p]));
+  const familiars = useMemo(() => {
+    const installed = new Map((state?.familiars.installed ?? []).map((p) => [p.id, p]));
     const catalogMap = new Map<string, PetEntry>();
     for (const pagePets of Object.values(catalogPages)) {
       for (const p of pagePets) {
         catalogMap.set(p.id, p);
       }
     }
-    const codexMap = new Map<string, PetEntry>((codex.pets ?? []).map((p) => [p.id, p]));
+    const codexMap = new Map<string, PetEntry>((codex.familiars ?? []).map((p) => [p.id, p]));
 
-    const rows: PetEntry[] = (state?.pets.installed ?? []).map((p) => {
+    const rows: PetEntry[] = (state?.familiars.installed ?? []).map((p) => {
       const catalogPet = catalogMap.get(p.id);
       const codexPet = codexMap.get(p.id);
       const localSpritesheet = p.id && !catalogPet && !codexPet && !p.builtIn ? installedPetSpritesheetUrl(p.id) : undefined;
@@ -3945,7 +3976,7 @@ function ControlCenter() {
     });
   }, [state, catalogPages, catalogSearch, codex, filter, query]);
 
-  const selected = selectedId ? pets.find((p) => p.id === selectedId) ?? null : null;
+  const selected = selectedId ? familiars.find((p) => p.id === selectedId) ?? null : null;
   const defaultId = state?.preferences.defaultPetId;
 
   useEffect(() => {
@@ -3993,21 +4024,21 @@ function ControlCenter() {
 
   useEffect(() => {
     if (!selected) return;
-    logPetsEvent("selected-pet", { id: selected.id, sourceKind: selected.sourceKind, installed: selected.installed, builtIn: selected.builtIn, preview: imageDebug(selected.preview), spritesheet: imageDebug(selected.spritesheet), hasSafePreview: Boolean(safePetImage(selected.preview)), hasSafeSpritesheet: Boolean(safePetImage(selected.spritesheet)), catalogPages: Object.keys(catalogPages).join(",") });
+    logPetsEvent("selected-familiar", { id: selected.id, sourceKind: selected.sourceKind, installed: selected.installed, builtIn: selected.builtIn, preview: imageDebug(selected.preview), spritesheet: imageDebug(selected.spritesheet), hasSafePreview: Boolean(safePetImage(selected.preview)), hasSafeSpritesheet: Boolean(safePetImage(selected.spritesheet)), catalogPages: Object.keys(catalogPages).join(",") });
   }, [selected]);
 
   const statusText = useMemo(() => {
     if (!selected) return "";
     const isDefault = selected.id === defaultId;
-    const isCodex = selected.sourceKind === "codex" || (state?.pets.installed.find(p => p.id === selected.id)?.source?.kind === "codex");
-    if (selected.broken) return selected.brokenReason || t("pets.status.broken");
-    if (isDefault) return selected.protected ? t("pets.status.defaultProtected") : t("pets.status.default");
+    const isCodex = selected.sourceKind === "codex" || (state?.familiars.installed.find(p => p.id === selected.id)?.source?.kind === "codex");
+    if (selected.broken) return selected.brokenReason || t("familiars.status.broken");
+    if (isDefault) return selected.protected ? t("familiars.status.defaultProtected") : t("familiars.status.default");
     if (selected.installed) {
-      if (isCodex) return t("pets.status.installedCodex");
-      return t("pets.status.installed");
+      if (isCodex) return t("familiars.status.installedCodex");
+      return t("familiars.status.installed");
     }
-    if (selected.sourceKind === "codex") return t("pets.status.availableCodex");
-    return t("pets.status.availableCatalog");
+    if (selected.sourceKind === "codex") return t("familiars.status.availableCodex");
+    return t("familiars.status.availableCatalog");
   }, [selected, defaultId, state, t]);
 
   async function act(label: string, fn: () => Promise<unknown>) {
@@ -4017,24 +4048,24 @@ function ControlCenter() {
   }
 
   useEffect(() => {
-    if (currentRoute !== "pets") return;
+    if (currentRoute !== "familiars") return;
     if (catalogSearch) return;
     void api.getCatalogSearch().then((result) => {
       if (result.error) setError(result.error);
-      setCatalogSearch(result.pets ?? []);
+      setCatalogSearch(result.familiars ?? []);
     }).catch((err) => setError(String(err?.message ?? err)));
   }, [catalogSearch, currentRoute]);
 
   useEffect(() => {
-    if (currentRoute !== "pets") return;
+    if (currentRoute !== "familiars") return;
     if (!catalogSearch) return;
     const q = query.trim().toLowerCase();
     const needsRemotePages = !!q || filter === "featured" || filter === "originals";
     
     const pages = new Set<number>();
     
-    if (state?.pets.installed) {
-      for (const p of state.pets.installed) {
+    if (state?.familiars.installed) {
+      for (const p of state.familiars.installed) {
         const searchPet = catalogSearch.find(sp => sp.id === p.id);
         if (searchPet && typeof searchPet.catalogPage === "number" && !catalogPages[searchPet.catalogPage]) {
           pages.add(searchPet.catalogPage);
@@ -4043,22 +4074,22 @@ function ControlCenter() {
     }
 
     if (needsRemotePages) {
-      for (const pet of catalogSearch) {
+      for (const familiar of catalogSearch) {
         if (pages.size >= 12) break;
-        if (filter === "originals" && !pet.original) continue;
-        if (filter === "featured" && (!pet.featured || pet.original)) continue;
-        if (q && !`${pet.displayName} ${pet.searchText ?? ""} ${pet.id}`.toLowerCase().includes(q)) continue;
-        if (typeof pet.catalogPage === "number" && !catalogPages[pet.catalogPage]) pages.add(pet.catalogPage);
+        if (filter === "originals" && !familiar.original) continue;
+        if (filter === "featured" && (!familiar.featured || familiar.original)) continue;
+        if (q && !`${familiar.displayName} ${familiar.searchText ?? ""} ${familiar.id}`.toLowerCase().includes(q)) continue;
+        if (typeof familiar.catalogPage === "number" && !catalogPages[familiar.catalogPage]) pages.add(familiar.catalogPage);
       }
     }
     
     if (!pages.size) return;
     let cancelled = false;
-    void Promise.all([...pages].map((page) => api.getCatalogPage(page).catch((err) => ({ source: "error", pets: [], error: String((err as Error)?.message ?? err), page } as CatalogState)))).then((results) => {
+    void Promise.all([...pages].map((page) => api.getCatalogPage(page).catch((err) => ({ source: "error", familiars: [], error: String((err as Error)?.message ?? err), page } as CatalogState)))).then((results) => {
       if (cancelled) return;
       setCatalogPages((current) => {
         const next = { ...current };
-        for (const result of results) if (result.source !== "error") next[result.page ?? 0] = result.pets;
+        for (const result of results) if (result.source !== "error") next[result.page ?? 0] = result.familiars;
         return next;
       });
       const firstError = results.find((result) => result.source === "error")?.error;
@@ -4070,9 +4101,9 @@ function ControlCenter() {
   async function loadCatalogPage(page: number) {
     if (catalogPages[page]) { setCatalogPage(page); return; }
     try {
-      setBusy(t("pets.busy.loadingPage")); setError("");
+      setBusy(t("familiars.busy.loadingPage")); setError("");
       const next = await api.getCatalogPage(page);
-      setCatalog(next); setCatalogPage(next.page ?? page); setCatalogPages((pages) => ({ ...pages, [next.page ?? page]: next.pets }));
+      setCatalog(next); setCatalogPage(next.page ?? page); setCatalogPages((pages) => ({ ...pages, [next.page ?? page]: next.familiars }));
     } catch (err) { setError(String((err as Error)?.message ?? err)); }
     finally { setBusy(""); }
   }
@@ -4134,48 +4165,48 @@ function ControlCenter() {
                 ))}
               </div>
               <div className="filter-actions">
-                <Button variant="secondary" size="compact" icon={<FolderPlusIcon />} disabled={!!busy} onClick={() => void act(t("pets.busy.importing"), () => api.installLocalPet())}>{t("pets.import")}</Button>
-                <Button variant="secondary" size="compact" icon={<HeartIcon />} onClick={() => void api.openGallery().catch((err) => setError(String(err?.message ?? err)))}>{t("pets.gallery")}</Button>
+                <Button variant="secondary" size="compact" icon={<FolderPlusIcon />} disabled={!!busy} onClick={() => void act(t("familiars.busy.importing"), () => api.installLocalPet())}>{t("familiars.import")}</Button>
+                <Button variant="secondary" size="compact" icon={<HeartIcon />} onClick={() => void api.openGallery().catch((err) => setError(String(err?.message ?? err)))}>{t("familiars.gallery")}</Button>
               </div>
             </div>
-            <div className="pets-grid">{pets.map((pet) => {
-              const isBuiltIn = pet.builtIn;
-              const hasDistinctPreview = pet.preview && pet.preview !== pet.spritesheet;
-              const useSpritesheetFrame = !isBuiltIn && !hasDistinctPreview && !!pet.spritesheet;
-              const isDefault = pet.id === defaultId;
-              const canInstall = !pet.installed && pet.sourceKind === "catalog";
-              const canImport = !pet.installed && pet.sourceKind === "codex";
-              const canSetDefault = pet.installed && !isDefault && !pet.broken;
-              const canRemove = pet.installed && !pet.builtIn && !pet.protected;
+            <div className="familiars-grid">{familiars.map((familiar) => {
+              const isBuiltIn = familiar.builtIn;
+              const hasDistinctPreview = familiar.preview && familiar.preview !== familiar.spritesheet;
+              const useSpritesheetFrame = !isBuiltIn && !hasDistinctPreview && !!familiar.spritesheet;
+              const isDefault = familiar.id === defaultId;
+              const canInstall = !familiar.installed && familiar.sourceKind === "catalog";
+              const canImport = !familiar.installed && familiar.sourceKind === "codex";
+              const canSetDefault = familiar.installed && !isDefault && !familiar.broken;
+              const canRemove = familiar.installed && !familiar.builtIn && !familiar.protected;
 
               return (
                 <div
-                  key={`${pet.sourceKind}-${pet.id}`}
-                  className={`pet-card group ${selected?.id === pet.id ? "selected" : ""}`}
+                  key={`${familiar.sourceKind}-${familiar.id}`}
+                  className={`familiar-card group ${selected?.id === familiar.id ? "selected" : ""}`}
                 >
                   <span className="thumb">
                     {useSpritesheetFrame ? (
-                      <SpriteFrame src={pet.spritesheet} label={t("pets.spriteLabel.thumbnail", { name: pet.displayName })} size="thumb" />
+                      <SpriteFrame src={familiar.spritesheet} label={t("familiars.spriteLabel.thumbnail", { name: familiar.displayName })} size="thumb" />
                     ) : (
-                      <PetImage src={pet.preview} debugLabel={`${pet.id}:card`} />
+                      <PetImage src={familiar.preview} debugLabel={`${familiar.id}:card`} />
                     )}
                   </span>
                   <div className="card-content">
                     <span className="card-title-row">
-                      <b className="card-title">{pet.displayName}</b>
+                      <b className="card-title">{familiar.displayName}</b>
                     </span>
-                    <p className="card-desc">{pet.description || pet.id}</p>
-                    <div className="badges">{isDefault && <StatusPill tone="green">{t("pets.badge.default")}</StatusPill>}{pet.original || pet.builtIn ? <StatusPill tone="yellow">{t("pets.badge.original")}</StatusPill> : pet.featured ? <StatusPill tone="purple">{t("pets.badge.featured")}</StatusPill> : null}{pet.installed && <StatusPill>{t("pets.badge.installed")}</StatusPill>}{pet.sourceKind === "codex" && <StatusPill tone="orange">{t("pets.badge.codex")}</StatusPill>}</div>
+                    <p className="card-desc">{familiar.description || familiar.id}</p>
+                    <div className="badges">{isDefault && <StatusPill tone="green">{t("familiars.badge.default")}</StatusPill>}{familiar.original || familiar.builtIn ? <StatusPill tone="yellow">{t("familiars.badge.original")}</StatusPill> : familiar.featured ? <StatusPill tone="purple">{t("familiars.badge.featured")}</StatusPill> : null}{familiar.installed && <StatusPill>{t("familiars.badge.installed")}</StatusPill>}{familiar.sourceKind === "codex" && <StatusPill tone="orange">{t("familiars.badge.codex")}</StatusPill>}</div>
 
-                    <div className="pet-card-actions" onClick={(event) => event.stopPropagation()}>
+                    <div className="familiar-card-actions" onClick={(event) => event.stopPropagation()}>
                       <Button
                         variant="secondary"
                         size="compact"
                         icon={<EyeIcon />}
-                        ariaLabel={t("pets.aria.view", { name: pet.displayName })}
-                        onClick={() => setSelectedId(pet.id)}
+                        ariaLabel={t("familiars.aria.view", { name: familiar.displayName })}
+                        onClick={() => setSelectedId(familiar.id)}
                       >
-                        {t("pets.action.viewPet")}
+                        {t("familiars.action.viewPet")}
                       </Button>
                       {canInstall && (
                         <Button
@@ -4183,10 +4214,10 @@ function ControlCenter() {
                           size="compact"
                           icon={<InstallIcon />}
                           disabled={!!busy}
-                          ariaLabel={t("pets.aria.install", { name: pet.displayName })}
-                          onClick={() => { void act(t("pets.busy.installing"), () => api.installPet(pet.id)); }}
+                          ariaLabel={t("familiars.aria.install", { name: familiar.displayName })}
+                          onClick={() => { void act(t("familiars.busy.installing"), () => api.installPet(familiar.id)); }}
                         >
-                          {t("pets.action.install")}
+                          {t("familiars.action.install")}
                         </Button>
                       )}
                       {canImport && (
@@ -4195,10 +4226,10 @@ function ControlCenter() {
                           size="compact"
                           icon={<ImportIcon />}
                           disabled={!!busy}
-                          ariaLabel={t("pets.aria.import", { name: pet.displayName })}
-                          onClick={() => { void act(t("pets.busy.importing"), () => api.importCodexPet(pet.id)); }}
+                          ariaLabel={t("familiars.aria.import", { name: familiar.displayName })}
+                          onClick={() => { void act(t("familiars.busy.importing"), () => api.importCodexPet(familiar.id)); }}
                         >
-                          {t("pets.action.import")}
+                          {t("familiars.action.import")}
                         </Button>
                       )}
                       {canSetDefault && (
@@ -4207,10 +4238,10 @@ function ControlCenter() {
                           size="compact"
                           icon={<SetDefaultIcon />}
                           disabled={!!busy}
-                          ariaLabel={t("pets.aria.setDefault", { name: pet.displayName })}
-                          onClick={() => { void act(t("pets.busy.settingDefault"), () => api.setDefaultPet(pet.id)); }}
+                          ariaLabel={t("familiars.aria.setDefault", { name: familiar.displayName })}
+                          onClick={() => { void act(t("familiars.busy.settingDefault"), () => api.setDefaultPet(familiar.id)); }}
                         >
-                          {t("pets.action.default")}
+                          {t("familiars.action.default")}
                         </Button>
                       )}
                       {canRemove && (
@@ -4219,10 +4250,10 @@ function ControlCenter() {
                           size="compact"
                           icon={<RemoveIcon />}
                           disabled={!!busy}
-                          ariaLabel={t("pets.aria.remove", { name: pet.displayName })}
-                          onClick={() => { void act(t("pets.busy.removing"), () => api.removePet(pet.id)); }}
+                          ariaLabel={t("familiars.aria.remove", { name: familiar.displayName })}
+                          onClick={() => { void act(t("familiars.busy.removing"), () => api.removePet(familiar.id)); }}
                         >
-                          {t("pets.action.remove")}
+                          {t("familiars.action.remove")}
                         </Button>
                       )}
                     </div>
@@ -4239,10 +4270,10 @@ function ControlCenter() {
                   disabled={!!busy || catalogPage <= 0}
                   onClick={() => void loadCatalogPage(catalogPage - 1)}
                 >
-                  {t("pets.pager.prev")}
+                  {t("familiars.pager.prev")}
                 </Button>
               ) : <span />}
-              <span className="pager-text">{t("pets.pager.count", { count: pets.length })}{!!catalog?.pageCount && catalog.pageCount > 1 ? t("pets.pager.page", { page: catalogPage + 1, pageCount: catalog.pageCount }) : ""}</span>
+              <span className="pager-text">{t("familiars.pager.count", { count: familiars.length })}{!!catalog?.pageCount && catalog.pageCount > 1 ? t("familiars.pager.page", { page: catalogPage + 1, pageCount: catalog.pageCount }) : ""}</span>
               {!!catalog?.pageCount && catalog.pageCount > 1 ? (
                 <Button
                   variant="secondary"
@@ -4252,62 +4283,62 @@ function ControlCenter() {
                   disabled={!!busy || catalogPage >= catalog.pageCount - 1}
                   onClick={() => void loadCatalogPage(catalogPage + 1)}
                 >
-                  {t("pets.pager.next")}
+                  {t("familiars.pager.next")}
                 </Button>
               ) : <span />}
             </div>
           </GlassCard>
 
           {selected ? (
-            <div ref={petDetailDialogRef} className="plugin-config-overlay" role="dialog" aria-modal="true" aria-label={t("pets.detail.ariaLabel", { name: selected.displayName })}>
-              <button className="plugin-config-backdrop" type="button" aria-label={t("pets.detail.closeAria")} onClick={() => setSelectedId("")} />
-              <GlassCard className="plugin-inspector pet-detail-inspector">
+            <div ref={petDetailDialogRef} className="plugin-config-overlay" role="dialog" aria-modal="true" aria-label={t("familiars.detail.ariaLabel", { name: selected.displayName })}>
+              <button className="plugin-config-backdrop" type="button" aria-label={t("familiars.detail.closeAria")} onClick={() => setSelectedId("")} />
+              <GlassCard className="plugin-inspector familiar-detail-inspector">
                 <div className="plugin-inspector-head">
                   <span className="plugin-inspector-icon">
                     {safePetImage(selected.spritesheet) ? (
-                      <SpriteFrame src={selected.spritesheet} label={t("pets.spriteLabel.thumb", { name: selected.displayName })} size="thumb" />
+                      <SpriteFrame src={selected.spritesheet} label={t("familiars.spriteLabel.thumb", { name: selected.displayName })} size="thumb" />
                     ) : (
                       <PetImage src={selected.preview} debugLabel={`${selected.id}:thumb`} />
                     )}
                   </span>
                   <div className="flex-1 min-w-0">
-                    <p className="eyebrow">{t("pets.detail.eyebrow")}</p>
+                    <p className="eyebrow">{t("familiars.detail.eyebrow")}</p>
                     <h2>{selected.displayName}</h2>
                   </div>
                   <Button variant="secondary" size="compact" icon={<CloseIcon />} onClick={() => setSelectedId("")}>{t("common.close")}</Button>
                 </div>
 
-                <div className="pet-detail-content">
-                  <div className="pet-detail-main">
+                <div className="familiar-detail-content">
+                  <div className="familiar-detail-main">
                     <p className="desc">{selected.description || selected.id}</p>
                     <div className="stage">
                       {safePetImage(selected.spritesheet) ? (
-                        <SpriteFrame src={selected.spritesheet} label={t("pets.spriteLabel.animatedPreview", { name: selected.displayName })} />
+                        <SpriteFrame src={selected.spritesheet} label={t("familiars.spriteLabel.animatedPreview", { name: selected.displayName })} />
                       ) : (
                         <PetImage src={selected.preview} debugLabel={`${selected.id}:detail-fallback`} />
                       )}
                     </div>
                     <div className="meta">
-                      {selected.broken && <StatusPill tone="red">{t("pets.badge.broken")}</StatusPill>}
-                      {selected.installed && !selected.broken && <StatusPill tone="green">{t("pets.badge.ready")}</StatusPill>}
-                      {selected.builtIn && <StatusPill tone="orange">{t("pets.badge.originals")}</StatusPill>}
-                      {selected.original && !selected.builtIn && <StatusPill tone="yellow">{t("pets.badge.original")}</StatusPill>}
-                      {selected.featured && !selected.original && <StatusPill tone="purple">{t("pets.badge.featured")}</StatusPill>}
+                      {selected.broken && <StatusPill tone="red">{t("familiars.badge.broken")}</StatusPill>}
+                      {selected.installed && !selected.broken && <StatusPill tone="green">{t("familiars.badge.ready")}</StatusPill>}
+                      {selected.builtIn && <StatusPill tone="orange">{t("familiars.badge.originals")}</StatusPill>}
+                      {selected.original && !selected.builtIn && <StatusPill tone="yellow">{t("familiars.badge.original")}</StatusPill>}
+                      {selected.featured && !selected.original && <StatusPill tone="purple">{t("familiars.badge.featured")}</StatusPill>}
                     </div>
                     {statusText && <p className="text-sm text-slatecopy mt-3 mb-0 font-medium">{statusText}</p>}
                   </div>
 
-                  <aside className="pet-detail-reactions">
-                    <h3 className="text-xs font-bold uppercase tracking-wider text-slatecopy mb-3">{t("pets.detail.previewAnimations")}</h3>
-                    <div className="pet-preview-grid">
+                  <aside className="familiar-detail-reactions">
+                    <h3 className="text-xs font-bold uppercase tracking-wider text-slatecopy mb-3">{t("familiars.detail.previewAnimations")}</h3>
+                    <div className="familiar-preview-grid">
                       {[
-                        { label: t("pets.detail.preview.idle"), state: "idle" as const },
-                        { label: t("pets.detail.preview.thinking"), state: "thinking" as const },
-                        { label: t("pets.detail.preview.happy"), state: "happy" as const },
-                        { label: t("pets.detail.preview.wave"), state: "wave" as const },
+                        { label: t("familiars.detail.preview.idle"), state: "idle" as const },
+                        { label: t("familiars.detail.preview.thinking"), state: "thinking" as const },
+                        { label: t("familiars.detail.preview.happy"), state: "happy" as const },
+                        { label: t("familiars.detail.preview.wave"), state: "wave" as const },
                       ].map((previewState) => (
-                        <article key={previewState.state} className="pet-preview-item">
-                          <SpriteFrame src={selected.spritesheet} label={t("pets.spriteLabel.statePreview", { name: selected.displayName, state: previewState.label })} state={previewState.state} size="mini" />
+                        <article key={previewState.state} className="familiar-preview-item">
+                          <SpriteFrame src={selected.spritesheet} label={t("familiars.spriteLabel.statePreview", { name: selected.displayName, state: previewState.label })} state={previewState.state} size="mini" />
                           <span className="text-xs font-bold text-slatecopy">{previewState.label}</span>
                         </article>
                       ))}
@@ -4315,7 +4346,7 @@ function ControlCenter() {
                   </aside>
                 </div>
 
-                <div className="actions-container mt-6 flex flex-col gap-3 pet-detail-actions">
+                <div className="actions-container mt-6 flex flex-col gap-3 familiar-detail-actions">
                   {/* Main Action (Install, Import, Set Default) */}
                   {!selected.installed && selected.sourceKind === "catalog" && (
                     <Button
@@ -4323,9 +4354,9 @@ function ControlCenter() {
                       fullWidth
                       icon={<InstallIcon />}
                       disabled={!!busy}
-                      onClick={() => act(t("pets.busy.installing"), () => api.installPet(selected.id))}
+                      onClick={() => act(t("familiars.busy.installing"), () => api.installPet(selected.id))}
                     >
-                      {busy || t("pets.detail.installPet")}
+                      {busy || t("familiars.detail.installPet")}
                     </Button>
                   )}
                   {!selected.installed && selected.sourceKind === "codex" && (
@@ -4334,9 +4365,9 @@ function ControlCenter() {
                       fullWidth
                       icon={<ImportIcon />}
                       disabled={!!busy}
-                      onClick={() => act(t("pets.busy.importing"), () => api.importCodexPet(selected.id))}
+                      onClick={() => act(t("familiars.busy.importing"), () => api.importCodexPet(selected.id))}
                     >
-                      {busy || t("pets.detail.importCodexPet")}
+                      {busy || t("familiars.detail.importCodexPet")}
                     </Button>
                   )}
                   {selected.installed && selected.id !== defaultId && !selected.broken && (
@@ -4345,9 +4376,9 @@ function ControlCenter() {
                       fullWidth
                       icon={<SetDefaultIcon />}
                       disabled={!!busy}
-                      onClick={() => act(t("pets.busy.settingDefault"), () => api.setDefaultPet(selected.id))}
+                      onClick={() => act(t("familiars.busy.settingDefault"), () => api.setDefaultPet(selected.id))}
                     >
-                      {busy || t("pets.detail.setDefaultPet")}
+                      {busy || t("familiars.detail.setDefaultPet")}
                     </Button>
                   )}
 
@@ -4357,9 +4388,9 @@ function ControlCenter() {
                         variant="danger"
                         icon={<RemoveIcon />}
                         disabled={!!busy}
-                        onClick={() => act(t("pets.busy.removing"), () => api.removePet(selected.id))}
+                        onClick={() => act(t("familiars.busy.removing"), () => api.removePet(selected.id))}
                       >
-                        {t("pets.detail.remove")}
+                        {t("familiars.detail.remove")}
                       </Button>
                     )}
                     <Button
@@ -4368,7 +4399,7 @@ function ControlCenter() {
                       disabled={!!busy}
                       onClick={() => void loadPetsData()}
                     >
-                      {t("pets.detail.refresh")}
+                      {t("familiars.detail.refresh")}
                     </Button>
                   </div>
                 </div>
diff --git a/apps/desktop/src/renderer/src/mcp-toolkit-catalog.ts b/apps/desktop/src/renderer/src/mcp-toolkit-catalog.ts
index 9fb3e574..b47da020 100644
--- a/apps/desktop/src/renderer/src/mcp-toolkit-catalog.ts
+++ b/apps/desktop/src/renderer/src/mcp-toolkit-catalog.ts
@@ -254,7 +254,7 @@ export const mcpToolkitEntries: readonly McpToolkitEntry[] = [
     docsLabel: "Official servers repo",
     tags: ["memory", "facts", "decisions", "persistence"],
     notes: [
-      "OpenPets now also has its own pet-side memory system and `openpets_memory_*` tools. This entry is for the host agent's broader project memory.",
+      "FamiliarOS now also has its own familiar-side memory system and `familiaros_memory_*` tools. This entry is for the host agent's broader project memory.",
     ],
     snippets: [
       {
diff --git a/apps/desktop/src/renderer/src/styles.css b/apps/desktop/src/renderer/src/styles.css
index 928603cd..dfb5335c 100644
--- a/apps/desktop/src/renderer/src/styles.css
+++ b/apps/desktop/src/renderer/src/styles.css
@@ -19,13 +19,13 @@
   html[data-theme="dark"] .settings-group,
   html[data-theme="dark"] .plugin-section,
   html[data-theme="dark"] .plugin-card,
-  html[data-theme="dark"] .pet-card,
+  html[data-theme="dark"] .familiar-card,
   html[data-theme="dark"] .integration-card,
   html[data-theme="dark"] .dashboard-stat-card,
   html[data-theme="dark"] .dashboard-activity-charts,
   html[data-theme="dark"] .dashboard-chart-panel,
   html[data-theme="dark"] .plugin-empty,
-  html[data-theme="dark"] .pet-detail-reactions,
+  html[data-theme="dark"] .familiar-detail-reactions,
   html[data-theme="dark"] .settings-system-footer,
   html[data-theme="dark"] .reaction-row,
   html[data-theme="dark"] .plugin-config-row,
@@ -171,11 +171,11 @@
   .filter.active .filter-icon-wrapper { @apply opacity-100; }
   .filter-icon { @apply h-3.5 w-3.5 stroke-[2.5]; }
   .pager { @apply mt-3 flex items-center justify-between gap-2.5 rounded-xl border border-blue-200/40 bg-blue-50/20 p-1.5 text-xs font-bold text-slatecopy; }
-  .pets-grid { @apply grid min-h-0 flex-1 grid-cols-2 gap-3 overflow-y-auto p-1.5 pr-2.5 pb-3; overscroll-behavior: contain; scrollbar-color: rgba(96, 165, 250, 0.42) transparent; }
-  .pet-card { @apply relative flex flex-row items-start gap-3.5 rounded-2xl border border-slate-200 bg-white/80 p-3 text-left shadow-sm transition-[transform,border-color,background-color,box-shadow] hover:-translate-y-0.5 hover:border-brand hover:bg-white min-h-[138px] w-full; }
-  .pet-card.selected { @apply border-brand bg-blue-50/90 ring-4 ring-blue-200/50 shadow-md; }
-  .pet-card-actions { @apply relative z-10 mt-2 grid grid-cols-3 gap-1.5; }
-  .pet-card-actions .btn { @apply min-h-[30px] min-w-0 px-2 py-1 text-[10px] tracking-wide; }
+  .familiars-grid { @apply grid min-h-0 flex-1 grid-cols-2 gap-3 overflow-y-auto p-1.5 pr-2.5 pb-3; overscroll-behavior: contain; scrollbar-color: rgba(96, 165, 250, 0.42) transparent; }
+  .familiar-card { @apply relative flex flex-row items-start gap-3.5 rounded-2xl border border-slate-200 bg-white/80 p-3 text-left shadow-sm transition-[transform,border-color,background-color,box-shadow] hover:-translate-y-0.5 hover:border-brand hover:bg-white min-h-[138px] w-full; }
+  .familiar-card.selected { @apply border-brand bg-blue-50/90 ring-4 ring-blue-200/50 shadow-md; }
+  .familiar-card-actions { @apply relative z-10 mt-2 grid grid-cols-3 gap-1.5; }
+  .familiar-card-actions .btn { @apply min-h-[30px] min-w-0 px-2 py-1 text-[10px] tracking-wide; }
   .thumb { @apply relative z-10 grid h-14 w-14 shrink-0 place-items-center overflow-hidden rounded-2xl bg-gradient-to-br from-white to-blue-100 border border-blue-100/50; }
   .thumb img { @apply max-h-12 max-w-12 object-contain; }
   .card-content { @apply relative z-10 flex flex-col flex-1 min-w-0 justify-center gap-1; }
@@ -194,7 +194,7 @@
   .sprite-detail.sprite-idle { animation: cc-idle-bob 2.6s ease-in-out infinite; }
   @keyframes cc-idle-bob { 0%, 100% { transform: translateY(0); } 50% { transform: translateY(-8px); } }
   @media (prefers-reduced-motion: reduce) { .sprite-frame { animation: none !important; } .sprite-frame animate { display: none; } }
-  @media (max-width: 900px) { body { overflow:auto; } .app-shell { @apply h-auto min-h-screen; } .layout, .gallery, .pets-grid, .detail { @apply overflow-visible; } .pets-grid { @apply grid-cols-1; } .pet-detail-content { @apply grid-cols-1; } .pet-preview-grid { @apply grid-cols-1; } }
+  @media (max-width: 900px) { body { overflow:auto; } .app-shell { @apply h-auto min-h-screen; } .layout, .gallery, .familiars-grid, .detail { @apply overflow-visible; } .familiars-grid { @apply grid-cols-1; } .familiar-detail-content { @apply grid-cols-1; } .familiar-preview-grid { @apply grid-cols-1; } }
   .meta { @apply flex flex-wrap gap-2; }
   .btn { @apply rounded-2xl px-4 py-3 font-monoDisplay text-sm font-black uppercase tracking-wide disabled:cursor-not-allowed disabled:opacity-60 active:scale-[0.96] transition-[transform,translate,background-color,border-color,box-shadow] duration-150 flex items-center justify-center min-h-[44px] cursor-pointer select-none; } 
   .btn-compact { @apply rounded-xl px-2.5 py-1 text-xs min-h-[30px]; } 
@@ -316,13 +316,13 @@
   .plugin-config-overlay { @apply fixed inset-0 z-30 flex items-center justify-center p-6; animation: plugin-fade-in 0.2s ease-out; }
   .plugin-config-backdrop { @apply absolute inset-0 cursor-default border-0 bg-navy/[0.12] p-0 backdrop-blur-[4px]; }
   .plugin-inspector { @apply relative z-10 flex max-h-[calc(100vh-4rem)] w-[min(760px,calc(100vw-3rem))] flex-col gap-4 overflow-y-auto pr-3 shadow-[0_32px_80px_rgba(16,33,73,0.25)]; overscroll-behavior: contain; scrollbar-gutter: stable; animation: plugin-pop-in 0.25s cubic-bezier(0.16, 1, 0.3, 1); }
-  .pet-detail-inspector { @apply w-[min(900px,calc(100vw-3rem))]; }
-  .pet-detail-content { @apply grid gap-5 grid-cols-[1.1fr_0.9fr] items-start; }
-  .pet-detail-main { @apply flex flex-col gap-3; }
-  .pet-detail-reactions { @apply rounded-2xl border border-blue-100/70 bg-white/55 p-3; }
-  .pet-preview-grid { @apply grid gap-3; grid-template-columns: repeat(2, minmax(0, 1fr)); }
-  .pet-preview-item { @apply flex flex-col items-center justify-center gap-2 rounded-2xl border border-blue-100 bg-white/60 p-2.5 shadow-sm; }
-  .pet-detail-actions .grid { @apply grid-cols-1 sm:grid-cols-2; }
+  .familiar-detail-inspector { @apply w-[min(900px,calc(100vw-3rem))]; }
+  .familiar-detail-content { @apply grid gap-5 grid-cols-[1.1fr_0.9fr] items-start; }
+  .familiar-detail-main { @apply flex flex-col gap-3; }
+  .familiar-detail-reactions { @apply rounded-2xl border border-blue-100/70 bg-white/55 p-3; }
+  .familiar-preview-grid { @apply grid gap-3; grid-template-columns: repeat(2, minmax(0, 1fr)); }
+  .familiar-preview-item { @apply flex flex-col items-center justify-center gap-2 rounded-2xl border border-blue-100 bg-white/60 p-2.5 shadow-sm; }
+  .familiar-detail-actions .grid { @apply grid-cols-1 sm:grid-cols-2; }
   @keyframes plugin-fade-in { from { opacity: 0; } to { opacity: 1; } }
   @keyframes plugin-pop-in { from { opacity: 0; transform: scale(0.96) translateY(10px); } to { opacity: 1; transform: scale(1) translateY(0); } }
   .plugin-inspector-head { @apply flex items-center gap-4; }
@@ -379,8 +379,8 @@
   .dashboard-hero-content { @apply relative z-10 flex flex-col gap-1.5 flex-1 min-w-0; }
   .dashboard-hero-title { @apply m-0 font-monoDisplay text-4xl font-black leading-tight tracking-tight; text-wrap: balance; }
   .dashboard-hero-desc { @apply max-w-md text-sm font-medium text-blue-50 opacity-90; text-wrap: pretty; }
-  .dashboard-hero-pet { @apply relative z-10 flex shrink-0 items-center justify-center ml-6; }
-  .dashboard-hero-pet .sprite-detail { filter: drop-shadow(0 20px 25px rgba(0, 0, 0, 0.25)); }
+  .dashboard-hero-familiar { @apply relative z-10 flex shrink-0 items-center justify-center ml-6; }
+  .dashboard-hero-familiar .sprite-detail { filter: drop-shadow(0 20px 25px rgba(0, 0, 0, 0.25)); }
 
   .dashboard-grid { @apply grid grid-cols-3 gap-5; }
   .dashboard-stat-card { @apply flex flex-col gap-4 rounded-[28px] border border-blue-100/50 bg-white/80 p-6 shadow-sm transition-[border-color,background-color,box-shadow] duration-150 hover:border-blue-200 hover:bg-white hover:shadow-md; }
diff --git a/apps/desktop/src/tray.ts b/apps/desktop/src/tray.ts
index cfe86612..61fa1dd8 100644
--- a/apps/desktop/src/tray.ts
+++ b/apps/desktop/src/tray.ts
@@ -2,9 +2,9 @@ import { Menu, shell, Tray, type MenuItemConstructorOptions } from "electron";
 
 import { getAppStateSnapshot } from "./app-state.js";
 import { createTrayIcon } from "./assets.js";
-import { hideDefaultPet, isDefaultPetVisible, setDefaultPetPaused, showDefaultPet } from "./default-pet-controller.js";
+import { hideDefaultPet, isDefaultPetVisible, setDefaultPetPaused, showDefaultPet } from "./default-familiar-controller.js";
 import { t } from "./i18n/index.js";
-import { quitOpenPets } from "./lifecycle.js";
+import { quitFamiliarOS } from "./lifecycle.js";
 import { info, openLogsFolder } from "./logger.js";
 import { shellState, togglePaused } from "./state.js";
 import { getUpdateStatus, openUpdateReleasePage } from "./update-checker.js";
@@ -18,10 +18,10 @@ export function createAppTray(): Tray {
   }
 
   tray = new Tray(createTrayIcon());
-  tray.setToolTip("OpenPets");
+  tray.setToolTip("FamiliarOS");
   refreshTrayMenu();
   info("tray", "created");
-  console.log("OpenPets tray created.");
+  console.log("FamiliarOS tray created.");
 
   return tray;
 }
@@ -32,19 +32,19 @@ export function refreshTrayMenu(): void {
   }
 
   const state = getAppStateSnapshot();
-  const defaultPet = state.pets.installed.find((pet) => pet.id === state.preferences.defaultPetId && !pet.broken) ?? state.pets.installed[0];
-  const defaultPetName = defaultPet?.displayName ?? t("common.builtInPet");
+  const defaultPet = state.familiars.installed.find((familiar) => familiar.id === state.preferences.defaultPetId && !familiar.broken) ?? state.familiars.installed[0];
+  const defaultPetName = state.preferences.familiarName ?? defaultPet?.displayName ?? t("common.builtInPet");
 
   const menu = Menu.buildFromTemplate([
     {
-      label: "OpenPets",
+      label: "FamiliarOS",
       enabled: false,
     },
     ...createUpdateMenuItems(),
     { type: "separator" },
     {
       label: t("tray.defaultPet", { name: defaultPetName }),
-      click: () => openControlCenterWindow("pets"),
+      click: () => openControlCenterWindow("familiars"),
     },
     {
       label: isDefaultPetVisible() ? t("tray.toggleDefaultPet.hide") : t("tray.toggleDefaultPet.show"),
@@ -64,14 +64,14 @@ export function refreshTrayMenu(): void {
         const paused = togglePaused();
         setDefaultPetPaused(paused);
         info("tray", "pause toggled", { paused });
-        console.log(paused ? "OpenPets paused." : "OpenPets resumed.");
+        console.log(paused ? "FamiliarOS paused." : "FamiliarOS resumed.");
         refreshTrayMenu();
       },
     },
     { type: "separator" },
     {
       label: t("tray.managePets"),
-      click: () => openControlCenterWindow("pets"),
+      click: () => openControlCenterWindow("familiars"),
     },
     {
       label: t("tray.controlCenter"),
@@ -92,7 +92,7 @@ export function refreshTrayMenu(): void {
     { type: "separator" },
     {
       label: t("tray.website"),
-      click: () => { void shell.openExternal("https://openpets.dev/"); },
+      click: () => { void shell.openExternal("https://familiaros.dev/"); },
     },
     {
       label: t("tray.openLogsFolder"),
@@ -101,7 +101,7 @@ export function refreshTrayMenu(): void {
     { type: "separator" },
     {
       label: t("tray.quit"),
-      click: () => quitOpenPets(),
+      click: () => quitFamiliarOS(),
     },
   ]);
 
diff --git a/apps/desktop/src/tts-credentials.ts b/apps/desktop/src/tts-credentials.ts
index cdfaaa24..b68d4ff4 100644
--- a/apps/desktop/src/tts-credentials.ts
+++ b/apps/desktop/src/tts-credentials.ts
@@ -17,7 +17,7 @@ interface StoredTtsCredentialV1 {
   readonly apiKey: string;
 }
 
-const ttsCredentialFileName = "openpets-tts-credential.json";
+const ttsCredentialFileName = "familiaros-tts-credential.json";
 
 export function getTtsCredentialStatus(provider: string): TtsCredentialStatus {
   const stored = readStoredCredential();
diff --git a/apps/desktop/src/tts-engine.ts b/apps/desktop/src/tts-engine.ts
index 92577268..07f80070 100644
--- a/apps/desktop/src/tts-engine.ts
+++ b/apps/desktop/src/tts-engine.ts
@@ -1,6 +1,6 @@
 import { spawn } from "node:child_process";
 import { existsSync, readFileSync, statSync } from "node:fs";
-import { type OpenPetsStateV1 } from "./app-state.js";
+import { type FamiliarOSStateV1 } from "./app-state.js";
 import { getTtsCredential } from "./tts-credentials.js";
 import { getOpenAiTtsVoices, getTtsEndpointPreset, getTtsProviderDefaults, listTtsProviders, type TtsEndpointPreset, type TtsProviderId, type TtsVoice } from "./tts-catalog.js";
 
diff --git a/apps/desktop/src/tts-service.ts b/apps/desktop/src/tts-service.ts
index 259cf209..cbd0a82d 100644
--- a/apps/desktop/src/tts-service.ts
+++ b/apps/desktop/src/tts-service.ts
@@ -1,7 +1,7 @@
 import type { BrowserWindow } from "electron";
 
 import { getAppStateSnapshot } from "./app-state.js";
-import { getDefaultPetWindowForPlugins } from "./default-pet-controller.js";
+import { getDefaultPetWindowForPlugins } from "./default-familiar-controller.js";
 import { isInQuietHours } from "./plugin-platform-settings.js";
 import { getPromptWindow } from "./prompt-window.js";
 import { debug, error as logError } from "./logger.js";
@@ -45,7 +45,7 @@ export async function fetchTtsVoiceList(provider: TtsProviderId): Promise<TtsVoi
   return fetchTtsVoices(provider, credential ?? undefined);
 }
 
-export async function speakTts(text: string, target?: "pet" | "prompt" | BrowserWindow): Promise<void> {
+export async function speakTts(text: string, target?: "familiar" | "prompt" | BrowserWindow): Promise<void> {
   const prefs = getAppStateSnapshot().preferences;
   const provider = prefs.ttsProvider ?? "system";
 
@@ -83,25 +83,25 @@ export async function speakTts(text: string, target?: "pet" | "prompt" | Browser
   }
 }
 
-export function stopTts(target?: "pet" | "prompt" | BrowserWindow): void {
+export function stopTts(target?: "familiar" | "prompt" | BrowserWindow): void {
   sendToTarget(target, { type: "tts-stop" });
 }
 
-function resolveWindow(target: "pet" | "prompt" | BrowserWindow | undefined): BrowserWindow | null {
+function resolveWindow(target: "familiar" | "prompt" | BrowserWindow | undefined): BrowserWindow | null {
   if (target instanceof Object && "webContents" in target) return target as BrowserWindow;
   if (target === "prompt") return getPromptWindow();
   return getDefaultPetWindowForPlugins();
 }
 
-function sendToTarget(target: "pet" | "prompt" | BrowserWindow | undefined, message: TtsRendererMessage): void {
+function sendToTarget(target: "familiar" | "prompt" | BrowserWindow | undefined, message: TtsRendererMessage): void {
   const window = resolveWindow(target);
   if (!window || window.isDestroyed()) return;
   if (message.type === "tts-audio") {
-    window.webContents.send("openpets:tts-audio", { audio: message.audio, mimeType: message.mimeType });
+    window.webContents.send("familiaros:tts-audio", { audio: message.audio, mimeType: message.mimeType });
   } else if (message.type === "tts-speak") {
-    window.webContents.send("openpets:tts-speak", { text: message.text, voice: message.voice, rate: message.rate });
+    window.webContents.send("familiaros:tts-speak", { text: message.text, voice: message.voice, rate: message.rate });
   } else if (message.type === "tts-stop") {
-    window.webContents.send("openpets:tts-stop");
+    window.webContents.send("familiaros:tts-stop");
   }
 }
 
diff --git a/apps/desktop/src/update-checker.ts b/apps/desktop/src/update-checker.ts
index 701d10b7..3237f0bd 100644
--- a/apps/desktop/src/update-checker.ts
+++ b/apps/desktop/src/update-checker.ts
@@ -20,7 +20,7 @@ interface GitHubReleaseResponse {
   readonly html_url?: unknown;
 }
 
-const githubRepository = process.env.OPENPETS_GITHUB_REPOSITORY || "alvinunreal/openpets";
+const githubRepository = process.env.FAMILIAROS_GITHUB_REPOSITORY || "alvinunreal/familiaros";
 const latestReleaseApiUrl = `https://api.github.com/repos/${githubRepository}/releases/latest`;
 const releasesPageUrl = `https://github.com/${githubRepository}/releases`;
 const releaseCheckTimeoutMs = 6_000;
@@ -90,7 +90,7 @@ function fetchLatestRelease(): Promise<GitHubReleaseResponse> {
     const request = https.get(latestReleaseApiUrl, {
       headers: {
         Accept: "application/vnd.github+json",
-        "User-Agent": `OpenPets/${getCurrentAppVersion()}`,
+        "User-Agent": `FamiliarOS/${getCurrentAppVersion()}`,
       },
       timeout: releaseCheckTimeoutMs,
     }, (response) => {
@@ -104,7 +104,7 @@ function fetchLatestRelease(): Promise<GitHubReleaseResponse> {
       });
       response.on("end", () => {
         if (response.statusCode === 404) {
-          reject(new Error("No public OpenPets releases found yet."));
+          reject(new Error("No public FamiliarOS releases found yet."));
           return;
         }
         if ((response.statusCode ?? 0) < 200 || (response.statusCode ?? 0) >= 300) {
diff --git a/apps/desktop/src/windows.ts b/apps/desktop/src/windows.ts
index ceb15631..657dcabc 100644
--- a/apps/desktop/src/windows.ts
+++ b/apps/desktop/src/windows.ts
@@ -3,14 +3,14 @@ import { join } from "node:path";
 
 import { app, BrowserWindow, clipboard, dialog, ipcMain, protocol, shell, type IpcMainInvokeEvent, type OpenDialogOptions } from "electron";
 
-import { buildOpenPetsMcpServerPreview, getAgentSetupSnapshot, runAgentSetupAction, testOpenPetsMcpServer, updateAgentSetupCommandPaths } from "./agent-setup.js";
-import { refreshAgentPetContent } from "./agent-pet-controller.js";
-import { getAppStateSnapshot, normalizeOpenApiChatEndpoint, normalizePetScale, petScaleOptions, updatePreferences } from "./app-state.js";
+import { buildFamiliarOSMcpServerPreview, getAgentSetupSnapshot, runAgentSetupAction, testFamiliarOSMcpServer, updateAgentSetupCommandPaths } from "./agent-setup.js";
+import { refreshAgentPetContent } from "./agent-familiar-controller.js";
+import { getAppStateSnapshot, normalizeFamiliarName, normalizeOpenApiChatEndpoint, normalizePetScale, petScaleOptions, updatePreferences } from "./app-state.js";
 import { createAppIcon } from "./assets.js";
 import { getCatalogPageUiState, getCatalogSearchUiState, getCatalogUiState } from "./catalog.js";
-import { getCodexPetsUiState, importCodexPet, readCodexPetSpritesheet } from "./codex-pets.js";
+import { getCodexPetsUiState, importCodexPet, readCodexPetSpritesheet } from "./codex-familiars.js";
 import { getActiveLocale, getActiveMessages, isSupportedLocale, LOCALE_LABELS, SUPPORTED_LOCALES, setLocaleFromPreference, t, type Locale, type LocalePreference } from "./i18n/index.js";
-import { recoverDefaultPetMouseInterop, refreshDefaultPetContent, resetDefaultPetToInitialPosition } from "./default-pet-controller.js";
+import { recoverDefaultPetMouseInterop, refreshDefaultPetContent, resetDefaultPetToInitialPosition } from "./default-familiar-controller.js";
 import { getMcpChatClientManager, listMcpChatVanillaServerIds } from "./mcp-chat-client.js";
 import { installPersistentToolkit, type McpToolkitPersistentTarget } from "./mcp-toolkit-installer.js";
 import { clearOpenApiCredential, getOpenApiChatSettingsSnapshot, normalizeChatModel, resetOpenApiConversationContext, saveOpenApiCredential } from "./openapi-chat.js";
@@ -18,18 +18,18 @@ import { clearTtsCredential, saveTtsCredential } from "./tts-credentials.js";
 import { fetchTtsVoiceList, getTtsSettingsSnapshot, speakTts, stopTts, type TtsProviderId } from "./tts-service.js";
 import { listTtsProviders } from "./tts-engine.js";
 import { addKnowledgeMemory, deleteKnowledgeFile, listKnowledgeFiles, searchKnowledgeStore, storeKnowledgeFile } from "./knowledge-store.js";
-import { forgetOpenPetsMemory, listOpenPetsMemories, searchOpenPetsMemories, storeOpenPetsMemory, updateOpenPetsMemory } from "./openpets-memory.js";
-import { installPet, installPetFromFolder, installPetFromZipFile, removePet, setDefaultInstalledPet } from "./pet-installation.js";
-import { assertSafePetId, getInstalledPetDir } from "./pet-paths.js";
+import { forgetFamiliarOSMemory, listFamiliarOSMemories, searchFamiliarOSMemories, storeFamiliarOSMemory, updateFamiliarOSMemory } from "./familiaros-memory.js";
+import { installPet, installPetFromFolder, installPetFromZipFile, removePet, setDefaultInstalledPet } from "./familiar-installation.js";
+import { assertSafePetId, getInstalledPetDir } from "./familiar-paths.js";
 import { debug, error as logError, warn } from "./logger.js";
 import { getPluginService, type PluginConfigSoundPickResult, type PluginServiceResult } from "./plugin-service.js";
 import { defaultPetSprite, reactionAnimationMetadata, selectableAnimationMetadata, validateReactionAnimationOverrides } from "./reaction-animation-mapping.js";
 import { checkForGitHubReleaseUpdate, getUpdateStatus, openUpdateReleasePage } from "./update-checker.js";
 
 type InternalUiWindowKind = "control-center";
-export type ControlCenterRoute = "dashboard" | "pets" | "settings" | "plugins" | "integrations";
+export type ControlCenterRoute = "dashboard" | "familiars" | "settings" | "plugins" | "integrations";
 
-const controlCenterRoutes = new Set<ControlCenterRoute>(["dashboard", "pets", "settings", "plugins", "integrations"]);
+const controlCenterRoutes = new Set<ControlCenterRoute>(["dashboard", "familiars", "settings", "plugins", "integrations"]);
 let controlCenterWindow: BrowserWindow | null = null;
 let internalUiHandlersInstalled = false;
 let pendingControlCenterRoute: ControlCenterRoute | null = null;
@@ -38,7 +38,7 @@ let lastDockHideAt = 0;
 const dockHideShowCooldownMs = 1100;
 
 async function loadCodexPetsModule() {
-  return import("./codex-pets.js");
+  return import("./codex-familiars.js");
 }
 
 function hasOpenInternalUiWindows(): boolean {
@@ -70,9 +70,9 @@ function syncDockVisibilityForInternalUi(): void {
   }
 }
 
-function getPetsStateSnapshot(): { preferences: { defaultPetId: string }; pets: ReturnType<typeof getAppStateSnapshot>["pets"] } {
+function getPetsStateSnapshot(): { preferences: { defaultPetId: string }; familiars: ReturnType<typeof getAppStateSnapshot>["familiars"] } {
   const state = getAppStateSnapshot();
-  return { preferences: { defaultPetId: state.preferences.defaultPetId }, pets: state.pets };
+  return { preferences: { defaultPetId: state.preferences.defaultPetId }, familiars: state.familiars };
 }
 
 function getSettingsStateSnapshot(): {
@@ -121,9 +121,9 @@ async function getDashboardSnapshot(): Promise<{
   readonly activity: ReturnType<typeof getAppStateSnapshot>["analytics"];
 }> {
   const state = getAppStateSnapshot();
-  const defaultPet = state.pets.installed.find((pet) => pet.id === state.preferences.defaultPetId && !pet.broken) ?? state.pets.installed[0];
+  const defaultPet = state.familiars.installed.find((familiar) => familiar.id === state.preferences.defaultPetId && !familiar.broken) ?? state.familiars.installed[0];
   const preview = await getDefaultPetPreviewSpriteInfo();
-  const catalog = await getCatalogUiState().catch((error: unknown) => ({ source: "error" as const, pets: [], total: undefined, page: undefined, pageCount: undefined, error: error instanceof Error ? error.message : "Catalog unavailable." }));
+  const catalog = await getCatalogUiState().catch((error: unknown) => ({ source: "error" as const, familiars: [], total: undefined, page: undefined, pageCount: undefined, error: error instanceof Error ? error.message : "Catalog unavailable." }));
   const pluginSnapshot = await getPluginService().getSnapshot().catch((error: unknown) => {
     warn("ui", "dashboard plugin snapshot unavailable", { error: error instanceof Error ? error.message : String(error) });
     return { plugins: [] } as const;
@@ -135,10 +135,10 @@ async function getDashboardSnapshot(): Promise<{
   return {
     defaultPet: {
       id: defaultPet?.id ?? state.preferences.defaultPetId,
-      displayName: defaultPet?.displayName ?? "OpenPets",
-      previewSpriteUrl: `openpets-pet-preview://spritesheet/default?v=${encodeURIComponent(preview.version)}`,
+      displayName: defaultPet?.displayName ?? "FamiliarOS",
+      previewSpriteUrl: `familiaros-familiar-preview://spritesheet/default?v=${encodeURIComponent(preview.version)}`,
     },
-    installedPetCount: state.pets.installed.length,
+    installedPetCount: state.familiars.installed.length,
     catalog: {
       source: catalog.source,
       total: catalog.total,
@@ -163,43 +163,43 @@ export function installInternalUiHandlers(): void {
 
   internalUiHandlersInstalled = true;
 
-  ipcMain.handle("openpets:get-pets-state", (event) => {
+  ipcMain.handle("familiaros:get-familiars-state", (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getPetsStateSnapshot();
   });
 
-  ipcMain.handle("openpets:get-settings-state", (event) => {
+  ipcMain.handle("familiaros:get-settings-state", (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getSettingsStateSnapshot();
   });
 
-  ipcMain.handle("openpets:get-i18n", (event) => {
+  ipcMain.handle("familiaros:get-i18n", (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getI18nSnapshot();
   });
 
-  ipcMain.handle("openpets:get-dashboard-snapshot", async (event) => {
+  ipcMain.handle("familiaros:get-dashboard-snapshot", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getDashboardSnapshot();
   });
 
-  ipcMain.handle("openpets:get-openapi-chat-settings", (event) => {
+  ipcMain.handle("familiaros:get-openapi-chat-settings", (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getOpenApiChatSettingsSnapshot();
   });
 
-  ipcMain.handle("openpets:save-openapi-credential", (event, apiKey: unknown) => {
+  ipcMain.handle("familiaros:save-openapi-credential", (event, apiKey: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof apiKey !== "string") throw new Error("Invalid chat credential.");
     return saveOpenApiCredential(apiKey);
   });
 
-  ipcMain.handle("openpets:clear-openapi-credential", (event) => {
+  ipcMain.handle("familiaros:clear-openapi-credential", (event) => {
     assertAllowedSender(event, ["control-center"]);
     return clearOpenApiCredential();
   });
 
-  ipcMain.handle("openpets:install-mcp-toolkit", async (event, target: unknown) => {
+  ipcMain.handle("familiaros:install-mcp-toolkit", async (event, target: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (target !== "claude-user" && target !== "codex-global") {
       throw new Error("Invalid MCP toolkit target.");
@@ -207,7 +207,7 @@ export function installInternalUiHandlers(): void {
     return installPersistentToolkit(target as McpToolkitPersistentTarget);
   });
 
-  ipcMain.handle("openpets:get-vanilla-chat-mcp-tools", async (event) => {
+  ipcMain.handle("familiaros:get-vanilla-chat-mcp-tools", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     const state = getAppStateSnapshot();
     return {
@@ -217,7 +217,7 @@ export function installInternalUiHandlers(): void {
     };
   });
 
-  ipcMain.handle("openpets:set-vanilla-chat-mcp-tools", async (event, toolIds: unknown) => {
+  ipcMain.handle("familiaros:set-vanilla-chat-mcp-tools", async (event, toolIds: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (!Array.isArray(toolIds) || !toolIds.every((id) => typeof id === "string")) {
       throw new Error("Invalid vanilla chat MCP tool list.");
@@ -229,18 +229,18 @@ export function installInternalUiHandlers(): void {
     return getAppStateSnapshot().preferences.vanillaChatMcpTools ?? [];
   });
 
-  ipcMain.handle("openpets:get-memories", async (event, query: unknown, limit: unknown) => {
+  ipcMain.handle("familiaros:get-memories", async (event, query: unknown, limit: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     const q = typeof query === "string" ? query.trim() : "";
     const l = typeof limit === "number" && Number.isFinite(limit) ? Math.max(1, Math.min(100, Math.round(limit))) : 50;
-    if (q) return searchOpenPetsMemories(q, l).map((h) => h.entry);
-    return listOpenPetsMemories(l);
+    if (q) return searchFamiliarOSMemories(q, l).map((h) => h.entry);
+    return listFamiliarOSMemories(l);
   });
 
-  ipcMain.handle("openpets:store-memory", async (event, text: unknown, kind: unknown, tags: unknown, importance: unknown) => {
+  ipcMain.handle("familiaros:store-memory", async (event, text: unknown, kind: unknown, tags: unknown, importance: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof text !== "string" || !text.trim()) throw new Error("Memory text is required.");
-    return storeOpenPetsMemory({
+    return storeFamiliarOSMemory({
       text: text.trim(),
       kind: typeof kind === "string" ? kind as "identity" | "preference" | "fact" | "note" : undefined,
       tags: Array.isArray(tags) ? tags.filter((t): t is string => typeof t === "string") : undefined,
@@ -248,11 +248,11 @@ export function installInternalUiHandlers(): void {
     });
   });
 
-  ipcMain.handle("openpets:update-memory", async (event, id: unknown, text: unknown, kind: unknown, tags: unknown, importance: unknown) => {
+  ipcMain.handle("familiaros:update-memory", async (event, id: unknown, text: unknown, kind: unknown, tags: unknown, importance: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !id.trim()) throw new Error("Memory id is required.");
     if (typeof text !== "string" || !text.trim()) throw new Error("Memory text is required.");
-    const result = updateOpenPetsMemory(id.trim(), {
+    const result = updateFamiliarOSMemory(id.trim(), {
       text: text.trim(),
       kind: typeof kind === "string" ? kind as "identity" | "preference" | "fact" | "note" : undefined,
       tags: Array.isArray(tags) ? tags.filter((t): t is string => typeof t === "string") : undefined,
@@ -262,21 +262,21 @@ export function installInternalUiHandlers(): void {
     return result;
   });
 
-  ipcMain.handle("openpets:delete-memory", async (event, id: unknown) => {
+  ipcMain.handle("familiaros:delete-memory", async (event, id: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !id.trim()) throw new Error("Memory id is required.");
-    const ok = forgetOpenPetsMemory(id.trim());
+    const ok = forgetFamiliarOSMemory(id.trim());
     if (!ok) throw new Error("Memory not found.");
     return true;
   });
 
-  ipcMain.handle("openpets:knowledge-list", async (event, limit: unknown) => {
+  ipcMain.handle("familiaros:knowledge-list", async (event, limit: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     const l = typeof limit === "number" && Number.isFinite(limit) ? Math.max(1, Math.min(100, Math.round(limit))) : 50;
     return listKnowledgeFiles(l);
   });
 
-  ipcMain.handle("openpets:knowledge-search", async (event, query: unknown, limit: unknown) => {
+  ipcMain.handle("familiaros:knowledge-search", async (event, query: unknown, limit: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     const q = typeof query === "string" ? query.trim() : "";
     const l = typeof limit === "number" && Number.isFinite(limit) ? Math.max(1, Math.min(100, Math.round(limit))) : 10;
@@ -289,7 +289,7 @@ export function installInternalUiHandlers(): void {
     return searchKnowledgeStore(q, l);
   });
 
-  ipcMain.handle("openpets:knowledge-delete-file", async (event, id: unknown) => {
+  ipcMain.handle("familiaros:knowledge-delete-file", async (event, id: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !id.trim()) throw new Error("File id is required.");
     const ok = await deleteKnowledgeFile(id.trim());
@@ -297,7 +297,7 @@ export function installInternalUiHandlers(): void {
     return true;
   });
 
-  ipcMain.handle("openpets:knowledge-add-memory", async (event, text: unknown, kind: unknown, tags: unknown, importance: unknown) => {
+  ipcMain.handle("familiaros:knowledge-add-memory", async (event, text: unknown, kind: unknown, tags: unknown, importance: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof text !== "string" || !text.trim()) throw new Error("Memory text is required.");
     return addKnowledgeMemory({
@@ -308,7 +308,7 @@ export function installInternalUiHandlers(): void {
     });
   });
 
-  ipcMain.handle("openpets:knowledge-store-file", async (event) => {
+  ipcMain.handle("familiaros:knowledge-store-file", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     const owner = BrowserWindow.fromWebContents(event.sender) ?? undefined;
     const options: OpenDialogOptions = {
@@ -331,29 +331,29 @@ export function installInternalUiHandlers(): void {
     return storeKnowledgeFile({ name, data });
   });
 
-  ipcMain.handle("openpets:get-reaction-animation-settings", async (event) => {
+  ipcMain.handle("familiaros:get-reaction-animation-settings", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getReactionAnimationSettingsSnapshot();
   });
 
-  ipcMain.handle("openpets:plugins-snapshot", async (event) => {
+  ipcMain.handle("familiaros:plugins-snapshot", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getPluginService().getSnapshot();
   });
 
-  ipcMain.handle("openpets:plugins-set-enabled", async (event, id: unknown, enabled: unknown): Promise<PluginServiceResult> => {
+  ipcMain.handle("familiaros:plugins-set-enabled", async (event, id: unknown, enabled: unknown): Promise<PluginServiceResult> => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id) || typeof enabled !== "boolean") return pluginUiError("Invalid plugin enable request.");
     return getPluginService().setEnabled(id, enabled);
   });
 
-  ipcMain.handle("openpets:plugins-save-config", async (event, id: unknown, config: unknown): Promise<PluginServiceResult> => {
+  ipcMain.handle("familiaros:plugins-save-config", async (event, id: unknown, config: unknown): Promise<PluginServiceResult> => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id) || !isPlainObject(config)) return pluginUiError("Invalid plugin config request.");
     return getPluginService().saveConfig(id, config);
   });
 
-  ipcMain.handle("openpets:plugins-pick-config-sound", async (event, id: unknown): Promise<PluginConfigSoundPickResult> => {
+  ipcMain.handle("familiaros:plugins-pick-config-sound", async (event, id: unknown): Promise<PluginConfigSoundPickResult> => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id)) {
       warn("ui", "Plugin sound pick invalid request.", { ok: false, reason: "invalid-plugin-id" });
@@ -372,66 +372,66 @@ export function installInternalUiHandlers(): void {
     }
   });
 
-  ipcMain.handle("openpets:plugins-reload", async (event, id: unknown): Promise<PluginServiceResult> => {
+  ipcMain.handle("familiaros:plugins-reload", async (event, id: unknown): Promise<PluginServiceResult> => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id)) return pluginUiError("Invalid plugin reload request.");
     return getPluginService().reload(id);
   });
 
-  ipcMain.handle("openpets:plugins-execute-command", async (event, id: unknown, commandId: unknown, args: unknown): Promise<PluginServiceResult> => {
+  ipcMain.handle("familiaros:plugins-execute-command", async (event, id: unknown, commandId: unknown, args: unknown): Promise<PluginServiceResult> => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id) || typeof commandId !== "string" || !/^[A-Za-z0-9._:-]{1,64}$/.test(commandId) || (args !== undefined && !isPlainObject(args))) return pluginUiError("Invalid plugin command request.");
     return getPluginService().executeCommand(id, commandId, isPlainObject(args) ? args as Record<string, unknown> : undefined);
   });
 
-  ipcMain.handle("openpets:plugins-load-local", async (event): Promise<PluginServiceResult> => {
+  ipcMain.handle("familiaros:plugins-load-local", async (event): Promise<PluginServiceResult> => {
     assertAllowedSender(event, ["control-center"]);
     return getPluginService().loadLocal();
   });
 
-  ipcMain.handle("openpets:plugins-catalog-snapshot", async (event, refresh: unknown) => {
+  ipcMain.handle("familiaros:plugins-catalog-snapshot", async (event, refresh: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     return getPluginService().getCatalogSnapshot(refresh === true);
   });
 
-  ipcMain.handle("openpets:plugins-install-catalog", async (event, id: unknown): Promise<PluginServiceResult> => {
+  ipcMain.handle("familiaros:plugins-install-catalog", async (event, id: unknown): Promise<PluginServiceResult> => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id)) return pluginUiError("Invalid plugin install request.");
     return getPluginService().installCatalog(id);
   });
 
-  ipcMain.handle("openpets:plugins-update-catalog", async (event, id: unknown): Promise<PluginServiceResult> => {
+  ipcMain.handle("familiaros:plugins-update-catalog", async (event, id: unknown): Promise<PluginServiceResult> => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id)) return pluginUiError("Invalid plugin update request.");
     return getPluginService().updateCatalog(id);
   });
 
-  ipcMain.handle("openpets:plugins-uninstall", async (event, id: unknown): Promise<PluginServiceResult> => {
+  ipcMain.handle("familiaros:plugins-uninstall", async (event, id: unknown): Promise<PluginServiceResult> => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id)) return pluginUiError("Invalid plugin uninstall request.");
     return getPluginService().uninstall(id);
   });
 
-  ipcMain.handle("openpets:plugins-inspector", async (event, id: unknown) => {
+  ipcMain.handle("familiaros:plugins-inspector", async (event, id: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof id !== "string" || !/^[a-z0-9][a-z0-9._-]{1,62}[a-z0-9]$/.test(id)) throw new Error("Invalid plugin inspector request.");
     return getPluginService().runtime.getInspectorState(id);
   });
 
-  ipcMain.handle("openpets:plugin-platform-settings-get", async (event) => {
+  ipcMain.handle("familiaros:plugin-platform-settings-get", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     const { getPluginPlatformSettings } = await import("./plugin-platform-settings.js");
     return getPluginPlatformSettings();
   });
 
-  ipcMain.handle("openpets:plugin-platform-settings-update", async (event, patch: unknown) => {
+  ipcMain.handle("familiaros:plugin-platform-settings-update", async (event, patch: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (!isPlainObject(patch)) throw new Error("Invalid plugin platform settings patch.");
     const { updatePluginPlatformSettings } = await import("./plugin-platform-settings.js");
     return updatePluginPlatformSettings(patch as never);
   });
 
-  ipcMain.handle("openpets:plugin-platform-ai-key-set", async (event, key: unknown) => {
+  ipcMain.handle("familiaros:plugin-platform-ai-key-set", async (event, key: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     const { getPluginHostCapabilitiesForUi } = await import("./plugin-host-capabilities.js");
     const { hostSecretsOwner, hostAiApiKeySecret } = await import("./plugin-ai-gateway.js");
@@ -443,7 +443,7 @@ export function installInternalUiHandlers(): void {
     return { ok: true, hasKey: true };
   });
 
-  ipcMain.handle("openpets:plugin-platform-ai-key-status", async (event) => {
+  ipcMain.handle("familiaros:plugin-platform-ai-key-status", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     const { getPluginHostCapabilitiesForUi } = await import("./plugin-host-capabilities.js");
     const { hostSecretsOwner, hostAiApiKeySecret } = await import("./plugin-ai-gateway.js");
@@ -452,28 +452,28 @@ export function installInternalUiHandlers(): void {
     return { hasKey: await capabilities.secretsStore.has(hostSecretsOwner, hostAiApiKeySecret) };
   });
 
-  ipcMain.handle("openpets:get-catalog", async (event) => {
+  ipcMain.handle("familiaros:get-catalog", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getCatalogUiState();
   });
 
-  ipcMain.handle("openpets:get-catalog-page", async (event, page: unknown) => {
+  ipcMain.handle("familiaros:get-catalog-page", async (event, page: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof page !== "number" || !Number.isInteger(page) || page < 0) throw new Error("Invalid catalog page.");
     return getCatalogPageUiState(page);
   });
 
-  ipcMain.handle("openpets:get-catalog-search", async (event) => {
+  ipcMain.handle("familiaros:get-catalog-search", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getCatalogSearchUiState();
   });
 
-  ipcMain.handle("openpets:get-codex-pets", async (event) => {
+  ipcMain.handle("familiaros:get-codex-familiars", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     return (await loadCodexPetsModule()).getCodexPetsUiState();
   });
 
-  ipcMain.handle("openpets:update-preferences", (event, patch: unknown) => {
+  ipcMain.handle("familiaros:update-preferences", (event, patch: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     const currentState = getAppStateSnapshot();
     const previousScale = getAppStateSnapshot().preferences.petScale;
@@ -489,22 +489,25 @@ export function installInternalUiHandlers(): void {
       refreshDefaultPetContent();
       refreshAgentPetContent();
     }
-    if (setLocaleFromPreference(state.preferences.locale) !== previousLocale) {
-      // Tray labels are rendered eagerly, so rebuild the menu in the new language.
+    if (setLocaleFromPreference(state.preferences.locale) !== previousLocale
+      || state.preferences.familiarName !== currentState.preferences.familiarName) {
+      // Tray labels are rendered eagerly, so rebuild the menu when language or Familiar name changes.
       void import("./tray.js").then(({ refreshTrayMenu }) => refreshTrayMenu());
-      // Control Center plugin labels are resolved at display time; nudge it to re-fetch the
-      // SafePluginRecords so manifest/config labels re-render in the new language.
-      broadcastPluginRecordsRefresh();
+      if (setLocaleFromPreference(state.preferences.locale) !== previousLocale) {
+        // Control Center plugin labels are resolved at display time; nudge it to re-fetch the
+        // SafePluginRecords so manifest/config labels re-render in the new language.
+        broadcastPluginRecordsRefresh();
+      }
     }
     return getInternalUiWindowKindForWebContents(event.sender.id) === "control-center" ? getSettingsStateSnapshot() : state;
   });
 
-  ipcMain.handle("openpets:get-launch-at-login", (event) => {
+  ipcMain.handle("familiaros:get-launch-at-login", (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getLaunchAtLoginState();
   });
 
-  ipcMain.handle("openpets:set-launch-at-login", (event, enabled: unknown) => {
+  ipcMain.handle("familiaros:set-launch-at-login", (event, enabled: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof enabled !== "boolean") throw new Error("Invalid launch-at-login value.");
     if (!isLaunchAtLoginSupported()) return getLaunchAtLoginState();
@@ -512,12 +515,12 @@ export function installInternalUiHandlers(): void {
     return getLaunchAtLoginState();
   });
 
-  ipcMain.handle("openpets:get-update-status", (event) => {
+  ipcMain.handle("familiaros:get-update-status", (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getUpdateStatus();
   });
 
-  ipcMain.handle("openpets:check-for-updates", async (event) => {
+  ipcMain.handle("familiaros:check-for-updates", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     const status = await checkForGitHubReleaseUpdate();
     const { refreshTrayMenu } = await import("./tray.js");
@@ -525,59 +528,59 @@ export function installInternalUiHandlers(): void {
     return status;
   });
 
-  ipcMain.handle("openpets:open-update-release-page", async (event) => {
+  ipcMain.handle("familiaros:open-update-release-page", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     await openUpdateReleasePage();
   });
 
-  ipcMain.handle("openpets:copy-text", (event, text: unknown) => {
+  ipcMain.handle("familiaros:copy-text", (event, text: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof text !== "string" || !text.trim()) throw new Error("Invalid copy payload.");
     clipboard.writeText(text);
   });
 
-  ipcMain.handle("openpets:open-external-url", async (event, rawUrl: unknown) => {
+  ipcMain.handle("familiaros:open-external-url", async (event, rawUrl: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     const url = validateExternalUrl(rawUrl);
     await shell.openExternal(url);
   });
 
-  ipcMain.handle("openpets:set-default-pet", async (event, petId: unknown) => {
+  ipcMain.handle("familiaros:set-default-familiar", async (event, petId: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof petId !== "string") {
-      throw new Error("Invalid pet id.");
+      throw new Error("Invalid familiar id.");
     }
 
     const state = await setDefaultInstalledPet(petId);
     refreshDefaultPetContent();
-    recoverDefaultPetMouseInterop("default-pet-changed");
-    setTimeout(() => recoverDefaultPetMouseInterop("default-pet-changed+500ms"), 500).unref?.();
+    recoverDefaultPetMouseInterop("default-familiar-changed");
+    setTimeout(() => recoverDefaultPetMouseInterop("default-familiar-changed+500ms"), 500).unref?.();
     return getInternalUiWindowKindForWebContents(event.sender.id) === "control-center" ? getPetsStateSnapshot() : state;
   });
 
-  ipcMain.handle("openpets:install-pet", async (event, petId: unknown) => {
+  ipcMain.handle("familiaros:install-familiar", async (event, petId: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof petId !== "string") {
-      throw new Error("Invalid pet id.");
+      throw new Error("Invalid familiar id.");
     }
 
     const state = await installPet(petId);
     return getInternalUiWindowKindForWebContents(event.sender.id) === "control-center" ? getPetsStateSnapshot() : state;
   });
 
-  ipcMain.handle("openpets:install-local-pet", async (event) => {
+  ipcMain.handle("familiaros:install-local-familiar", async (event) => {
     assertAllowedSender(event, ["control-center"]);
     const owner = BrowserWindow.fromWebContents(event.sender) ?? undefined;
     const importKind = await chooseLocalPetImportKind(owner);
     if (!importKind) return getPetsStateSnapshot();
     const options: OpenDialogOptions = importKind === "zip" ? {
-      title: "Install pet from ZIP",
-      buttonLabel: "Install Pet",
+      title: "Install familiar from ZIP",
+      buttonLabel: "Install Familiar",
       properties: ["openFile"],
-      filters: [{ name: "OpenPets ZIP", extensions: ["zip"] }],
+      filters: [{ name: "FamiliarOS ZIP", extensions: ["zip"] }],
     } : {
-      title: "Install pet from folder",
-      buttonLabel: "Install Pet",
+      title: "Install familiar from folder",
+      buttonLabel: "Install Familiar",
       properties: ["openDirectory"],
     };
     const result = owner ? await dialog.showOpenDialog(owner, options) : await dialog.showOpenDialog(options);
@@ -586,34 +589,34 @@ export function installInternalUiHandlers(): void {
     try {
       const selectedStats = await stat(selectedPath);
       const state = selectedStats.isDirectory() ? await installPetFromFolder(selectedPath) : await installPetFromZipFile(selectedPath);
-      debug("ui", "local pet import succeeded", { kind: selectedStats.isDirectory() ? "folder" : "zip" });
+      debug("ui", "local familiar import succeeded", { kind: selectedStats.isDirectory() ? "folder" : "zip" });
       refreshDefaultPetContent();
       return getInternalUiWindowKindForWebContents(event.sender.id) === "control-center" ? getPetsStateSnapshot() : state;
     } catch (error) {
-      logError("ui", "local pet import failed", { error: error instanceof Error ? error.message : String(error) });
+      logError("ui", "local familiar import failed", { error: error instanceof Error ? error.message : String(error) });
       throw error;
     }
   });
 
-  ipcMain.handle("openpets:open-gallery", async (event) => {
+  ipcMain.handle("familiaros:open-gallery", async (event) => {
     assertAllowedSender(event, ["control-center"]);
-    await shell.openExternal("https://openpets.dev/gallery");
+    await shell.openExternal("https://familiaros.dev/gallery");
   });
 
-  ipcMain.handle("openpets:import-codex-pet", async (event, petId: unknown) => {
+  ipcMain.handle("familiaros:import-codex-familiar", async (event, petId: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof petId !== "string") {
-      throw new Error("Invalid pet id.");
+      throw new Error("Invalid familiar id.");
     }
 
     const state = await (await loadCodexPetsModule()).importCodexPet(petId);
     return getInternalUiWindowKindForWebContents(event.sender.id) === "control-center" ? getPetsStateSnapshot() : state;
   });
 
-  ipcMain.handle("openpets:remove-pet", async (event, petId: unknown) => {
+  ipcMain.handle("familiaros:remove-familiar", async (event, petId: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof petId !== "string") {
-      throw new Error("Invalid pet id.");
+      throw new Error("Invalid familiar id.");
     }
 
     const state = await removePet(petId);
@@ -621,18 +624,18 @@ export function installInternalUiHandlers(): void {
     return getInternalUiWindowKindForWebContents(event.sender.id) === "control-center" ? getPetsStateSnapshot() : state;
   });
 
-  ipcMain.handle("openpets:reset-default-pet-position", (event) => {
+  ipcMain.handle("familiaros:reset-default-familiar-position", (event) => {
     assertAllowedSender(event, ["control-center"]);
     resetDefaultPetToInitialPosition();
     return getInternalUiWindowKindForWebContents(event.sender.id) === "control-center" ? getSettingsStateSnapshot() : getAppStateSnapshot();
   });
 
-  ipcMain.handle("openpets:agent-setup-snapshot", async (event, selectedPetId: unknown, commandMode: unknown) => {
+  ipcMain.handle("familiaros:agent-setup-snapshot", async (event, selectedPetId: unknown, commandMode: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     return getAgentSetupSnapshot(selectedPetId, commandMode);
   });
 
-  ipcMain.handle("openpets:agent-setup-action", async (event, action: unknown, selectedPetId: unknown, commandMode: unknown) => {
+  ipcMain.handle("familiaros:agent-setup-action", async (event, action: unknown, selectedPetId: unknown, commandMode: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (action !== "configure" && action !== "replace" && action !== "remove" && action !== "install-memory" && action !== "doctor-hooks" && action !== "install-hooks" && action !== "uninstall-hooks" && action !== "opencode-install" && action !== "opencode-remove" && action !== "cursor-install" && action !== "cursor-replace" && action !== "cursor-remove") {
       throw new Error("Invalid agent setup action.");
@@ -641,68 +644,68 @@ export function installInternalUiHandlers(): void {
     return runAgentSetupAction(action, selectedPetId, commandMode);
   });
 
-  ipcMain.handle("openpets:agent-setup-command-paths", (event, patch: unknown) => {
+  ipcMain.handle("familiaros:agent-setup-command-paths", (event, patch: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     return updateAgentSetupCommandPaths(patch);
   });
 
-  ipcMain.handle("openpets:openpets-mcp-server-preview", (event, selectedPetId: unknown, commandMode: unknown) => {
+  ipcMain.handle("familiaros:familiaros-mcp-server-preview", (event, selectedPetId: unknown, commandMode: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     const petId = typeof selectedPetId === "string" && selectedPetId.trim() ? selectedPetId.trim() : undefined;
     const mode = typeof commandMode === "string" && (commandMode === "published" || commandMode === "bundled" || commandMode === "local") ? commandMode : "published";
-    return buildOpenPetsMcpServerPreview(petId, mode);
+    return buildFamiliarOSMcpServerPreview(petId, mode);
   });
 
-  ipcMain.handle("openpets:test-openpets-mcp-server", async (event, selectedPetId: unknown, commandMode: unknown) => {
+  ipcMain.handle("familiaros:test-familiaros-mcp-server", async (event, selectedPetId: unknown, commandMode: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     const petId = typeof selectedPetId === "string" && selectedPetId.trim() ? selectedPetId.trim() : undefined;
     const mode = typeof commandMode === "string" && (commandMode === "published" || commandMode === "bundled" || commandMode === "local") ? commandMode : "published";
-    return testOpenPetsMcpServer(petId, mode);
+    return testFamiliarOSMcpServer(petId, mode);
   });
 
-  ipcMain.handle("openpets:get-tts-settings", (event) => {
+  ipcMain.handle("familiaros:get-tts-settings", (event) => {
     assertAllowedSender(event, ["control-center"]);
     return getTtsSettingsSnapshot();
   });
 
-  ipcMain.handle("openpets:get-tts-voices", async (event, provider: unknown) => {
+  ipcMain.handle("familiaros:get-tts-voices", async (event, provider: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof provider !== "string") throw new Error("Provider must be a string.");
     return fetchTtsVoiceList(provider as TtsProviderId);
   });
 
-  ipcMain.handle("openpets:save-tts-credential", (event, provider: unknown, credential: unknown) => {
+  ipcMain.handle("familiaros:save-tts-credential", (event, provider: unknown, credential: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof provider !== "string") throw new Error("Provider must be a string.");
     if (typeof credential !== "string") throw new Error("Credential must be a string.");
     return saveTtsCredential(provider, credential);
   });
 
-  ipcMain.handle("openpets:clear-tts-credential", (event, provider: unknown) => {
+  ipcMain.handle("familiaros:clear-tts-credential", (event, provider: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof provider !== "string") throw new Error("Provider must be a string.");
     return clearTtsCredential(provider);
   });
 
-  ipcMain.handle("openpets:test-tts", async (event, text: unknown) => {
+  ipcMain.handle("familiaros:test-tts", async (event, text: unknown) => {
     assertAllowedSender(event, ["control-center"]);
     if (typeof text !== "string" || !text.trim()) throw new Error("Text must be a non-empty string.");
-    await speakTts(text.trim(), "pet");
+    await speakTts(text.trim(), "familiar");
     return { ok: true };
   });
 
-  ipcMain.handle("openpets:tts-stop", (event) => {
+  ipcMain.handle("familiaros:tts-stop", (event) => {
     assertAllowedSender(event, ["control-center"]);
-    stopTts("pet");
+    stopTts("familiar");
   });
 }
 
 async function chooseLocalPetImportKind(owner: BrowserWindow | undefined): Promise<"zip" | "folder" | null> {
   const options = {
     type: "question" as const,
-    title: "Install pet",
-    message: "Install pet from ZIP or folder?",
-    detail: "Choose the source type before selecting the pet package.",
+    title: "Install familiar",
+    message: "Install familiar from ZIP or folder?",
+    detail: "Choose the source type before selecting the familiar package.",
     buttons: ["ZIP", "Folder", "Cancel"],
     defaultId: 0,
     cancelId: 2,
@@ -715,7 +718,7 @@ async function chooseLocalPetImportKind(owner: BrowserWindow | undefined): Promi
 }
 
 export function installInternalUiProtocol(): void {
-  protocol.handle("openpets-codex", async (request) => {
+  protocol.handle("familiaros-codex", async (request) => {
     try {
       if (request.method !== "GET" && request.method !== "HEAD") return new Response(null, { status: 405 });
       const url = new URL(request.url);
@@ -733,15 +736,15 @@ export function installInternalUiProtocol(): void {
     }
   });
 
-  protocol.handle("openpets-installed", async (request) => {
+  protocol.handle("familiaros-installed", async (request) => {
     try {
       if (request.method !== "GET" && request.method !== "HEAD") return new Response(null, { status: 405 });
       const url = new URL(request.url);
       if (url.hostname !== "spritesheet" || url.search || url.hash) return new Response(null, { status: 404 });
       const petId = decodeURIComponent(url.pathname.replace(/^\//, ""));
       assertSafePetId(petId);
-      const pet = getAppStateSnapshot().pets.installed.find((candidate) => candidate.id === petId && !candidate.broken);
-      if (!pet) return new Response(null, { status: 404 });
+      const familiar = getAppStateSnapshot().familiars.installed.find((candidate) => candidate.id === petId && !candidate.broken);
+      if (!familiar) return new Response(null, { status: 404 });
       const spritesheetPath = join(getInstalledPetDir(petId), "spritesheet.webp");
       const spritesheet = await stat(spritesheetPath);
       if (!spritesheet.isFile() || spritesheet.size <= 0 || spritesheet.size > 100 * 1024 * 1024) return new Response(null, { status: 404 });
@@ -756,7 +759,7 @@ export function installInternalUiProtocol(): void {
     }
   });
 
-  protocol.handle("openpets-pet-preview", async (request) => {
+  protocol.handle("familiaros-familiar-preview", async (request) => {
     try {
       if (request.method !== "GET" && request.method !== "HEAD") return new Response(null, { status: 405 });
       const url = new URL(request.url);
@@ -790,7 +793,7 @@ export function openControlCenterWindow(route: ControlCenterRoute = "dashboard")
   }
 
   const window = new BrowserWindow({
-    title: "OpenPets — Control Center",
+    title: "FamiliarOS — Control Center",
     width: 1180,
     height: 820,
     minWidth: 820,
@@ -851,13 +854,13 @@ function normalizeControlCenterRoute(route: unknown): ControlCenterRoute {
 
 function sendControlCenterRoute(window: BrowserWindow, route: ControlCenterRoute): void {
   if (window.isDestroyed()) return;
-  window.webContents.send("openpets:control-center-route", route);
+  window.webContents.send("familiaros:control-center-route", route);
 }
 
 /** Tell the open Control Center to re-fetch the plugin snapshot (e.g. after a locale change). */
 function broadcastPluginRecordsRefresh(): void {
   if (controlCenterWindow && !controlCenterWindow.isDestroyed()) {
-    controlCenterWindow.webContents.send("openpets:plugins-refresh");
+    controlCenterWindow.webContents.send("familiaros:plugins-refresh");
   }
 }
 
@@ -900,7 +903,7 @@ function getControlCenterPreloadPath(): string {
 
 function getSafeControlCenterDevUrl(): string | null {
   if (app.isPackaged) return null;
-  const raw = process.env.OPENPETS_RENDERER_URL;
+  const raw = process.env.FAMILIAROS_RENDERER_URL;
   if (!raw) return null;
   try {
     const url = new URL(raw);
@@ -917,7 +920,7 @@ function assertAllowedSender(event: IpcMainInvokeEvent, allowedKinds: readonly I
   const actualKind = getInternalUiWindowKindForWebContents(event.sender.id);
 
   if (!actualKind || !allowedKinds.includes(actualKind)) {
-    throw new Error("OpenPets internal UI request came from an unexpected window.");
+    throw new Error("FamiliarOS internal UI request came from an unexpected window.");
   }
 }
 
@@ -944,13 +947,13 @@ async function getReactionAnimationSettingsSnapshot(): Promise<unknown> {
     })),
     sprite: defaultPetSprite,
     overrides: state.preferences.reactionAnimationOverrides ?? {},
-    previewSpriteUrl: `openpets-pet-preview://spritesheet/default?v=${encodeURIComponent(preview.version)}`,
+    previewSpriteUrl: `familiaros-familiar-preview://spritesheet/default?v=${encodeURIComponent(preview.version)}`,
   };
 }
 
 async function getDefaultPetPreviewSpriteInfo(): Promise<{ readonly path: string; readonly version: string }> {
   const state = getAppStateSnapshot();
-  const selected = state.pets.installed.find((pet) => pet.id === state.preferences.defaultPetId);
+  const selected = state.familiars.installed.find((familiar) => familiar.id === state.preferences.defaultPetId);
   const builtInPath = join(app.getAppPath(), "assets", defaultPetSprite.fileName);
   const candidatePath = selected && !selected.broken && !selected.builtIn
     ? join(getInstalledPetDir(selected.id), "spritesheet.webp")
@@ -961,18 +964,18 @@ async function getDefaultPetPreviewSpriteInfo(): Promise<{ readonly path: string
       return { path: candidatePath, version: `${selected?.id ?? "builtin"}-${Math.round(spritesheet.mtimeMs)}-${spritesheet.size}` };
     }
   } catch {
-    // Fall back to the bundled pet if an installed default disappears while Settings is open.
+    // Fall back to the bundled familiar if an installed default disappears while Settings is open.
   }
   const fallback = await stat(builtInPath);
   return { path: builtInPath, version: `builtin-${Math.round(fallback.mtimeMs)}-${fallback.size}` };
 }
 
-function validatePreferencePatch(value: unknown): { openDefaultPetOnLaunch?: boolean; locale?: LocalePreference; petScale?: number; reactionAnimationOverrides?: ReturnType<typeof validateReactionAnimationOverrides>; openApiChatModel?: string | undefined; openApiChatSystemPrompt?: string | undefined; openApiChatEndpoint?: string | undefined; openApiChatTheme?: "system" | "light" | "dark"; ttsProvider?: TtsProviderId; ttsVoice?: string | undefined; ttsSpeed?: number; ttsModel?: string | undefined; ttsEndpointPreset?: "openrouter" | "litellm" | "wavespeedai" | "custom"; ttsEndpoint?: string | undefined } {
+function validatePreferencePatch(value: unknown): { openDefaultPetOnLaunch?: boolean; locale?: LocalePreference; petScale?: number; reactionAnimationOverrides?: ReturnType<typeof validateReactionAnimationOverrides>; openApiChatModel?: string | undefined; openApiChatSystemPrompt?: string | undefined; openApiChatEndpoint?: string | undefined; openApiChatTheme?: "system" | "light" | "dark"; ttsProvider?: TtsProviderId; ttsVoice?: string | undefined; ttsSpeed?: number; ttsModel?: string | undefined; ttsEndpointPreset?: "openrouter" | "litellm" | "wavespeedai" | "custom"; ttsEndpoint?: string | undefined; familiarName?: string | undefined } {
   if (!isRecord(value)) {
     throw new Error("Invalid preferences patch.");
   }
 
-  const patch: { openDefaultPetOnLaunch?: boolean; locale?: LocalePreference; petScale?: number; reactionAnimationOverrides?: ReturnType<typeof validateReactionAnimationOverrides>; openApiChatModel?: string | undefined; openApiChatSystemPrompt?: string | undefined; openApiChatEndpoint?: string | undefined; openApiChatTheme?: "system" | "light" | "dark"; ttsProvider?: TtsProviderId; ttsVoice?: string | undefined; ttsSpeed?: number; ttsModel?: string | undefined; ttsEndpointPreset?: "openrouter" | "litellm" | "wavespeedai" | "custom"; ttsEndpoint?: string | undefined } = {};
+  const patch: { openDefaultPetOnLaunch?: boolean; locale?: LocalePreference; petScale?: number; reactionAnimationOverrides?: ReturnType<typeof validateReactionAnimationOverrides>; openApiChatModel?: string | undefined; openApiChatSystemPrompt?: string | undefined; openApiChatEndpoint?: string | undefined; openApiChatTheme?: "system" | "light" | "dark"; ttsProvider?: TtsProviderId; ttsVoice?: string | undefined; ttsSpeed?: number; ttsModel?: string | undefined; ttsEndpointPreset?: "openrouter" | "litellm" | "wavespeedai" | "custom"; ttsEndpoint?: string | undefined; familiarName?: string | undefined } = {};
 
   if ("openDefaultPetOnLaunch" in value) {
     if (typeof value.openDefaultPetOnLaunch !== "boolean") throw new Error("Invalid open-on-launch value.");
@@ -986,7 +989,7 @@ function validatePreferencePatch(value: unknown): { openDefaultPetOnLaunch?: boo
 
   if ("petScale" in value) {
     const scale = normalizePetScale(value.petScale);
-    if (scale !== value.petScale) throw new Error("Invalid pet scale value.");
+    if (scale !== value.petScale) throw new Error("Invalid familiar scale value.");
     patch.petScale = scale;
   }
 
@@ -1010,7 +1013,7 @@ function validatePreferencePatch(value: unknown): { openDefaultPetOnLaunch?: boo
     } else if (typeof value.openApiChatSystemPrompt === "string") {
       patch.openApiChatSystemPrompt = value.openApiChatSystemPrompt;
     } else {
-      throw new Error("Invalid pet character prompt.");
+      throw new Error("Invalid familiar character prompt.");
     }
   }
 
@@ -1090,6 +1093,20 @@ function validatePreferencePatch(value: unknown): { openDefaultPetOnLaunch?: boo
     }
   }
 
+  if ("familiarName" in value) {
+    if (value.familiarName === undefined || value.familiarName === null || value.familiarName === "") {
+      patch.familiarName = undefined;
+    } else if (typeof value.familiarName === "string") {
+      const name = normalizeFamiliarName(value.familiarName);
+      if (name === undefined) {
+        throw new Error("Invalid Familiar name. Use up to 64 characters and avoid control characters.");
+      }
+      patch.familiarName = name;
+    } else {
+      throw new Error("Invalid Familiar name.");
+    }
+  }
+
   return patch;
 }
 
diff --git a/apps/desktop/src/zip-safety.ts b/apps/desktop/src/zip-safety.ts
index 4206a2c2..e46f7c8e 100644
--- a/apps/desktop/src/zip-safety.ts
+++ b/apps/desktop/src/zip-safety.ts
@@ -4,7 +4,7 @@ export interface SafeZipEntryPath {
   readonly originalName: string;
   readonly normalizedName: string;
   readonly topLevelDirectory: string;
-  readonly relativeOutputPath: "pet.json" | "spritesheet.webp" | null;
+  readonly relativeOutputPath: "familiar.json" | "spritesheet.webp" | null;
   readonly isDirectory: boolean;
 }
 
@@ -60,10 +60,10 @@ export function validateZipEntryName(fileName: string): SafeZipEntryPath {
     };
   }
 
-  if (parts.length !== 1 && parts.length !== 2) throw new Error("Zip must contain pet files at the root or under exactly one top-level directory.");
+  if (parts.length !== 1 && parts.length !== 2) throw new Error("Zip must contain familiar files at the root or under exactly one top-level directory.");
 
   const leaf = parts.at(-1);
-  if (leaf !== "pet.json" && leaf !== "spritesheet.webp") {
+  if (leaf !== "familiar.json" && leaf !== "spritesheet.webp") {
     throw new Error(`Unexpected zip file: ${leaf}`);
   }
 
diff --git a/apps/desktop/tests/claude-memory.test.ts b/apps/desktop/tests/claude-memory.test.ts
index 968f0d58..e7131411 100644
--- a/apps/desktop/tests/claude-memory.test.ts
+++ b/apps/desktop/tests/claude-memory.test.ts
@@ -3,71 +3,71 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync,
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 
-import { ensureImportLine, ensureManagedImport, installClaudeOpenPetsMemory, openPetsClaudeImportLine, removeImportLine, removeOpenPetsMemoryBlock, uninstallClaudeOpenPetsMemory, upsertOpenPetsMemoryBlock } from "../src/claude-memory.js";
+import { ensureImportLine, ensureManagedImport, installClaudeFamiliarOSMemory, openPetsClaudeImportLine, removeImportLine, removeFamiliarOSMemoryBlock, uninstallClaudeFamiliarOSMemory, upsertFamiliarOSMemoryBlock } from "../src/claude-memory.js";
 
 assert.equal(ensureImportLine("", openPetsClaudeImportLine), `${openPetsClaudeImportLine}\n`);
 assert.equal(ensureImportLine("# User notes\n", openPetsClaudeImportLine), `# User notes\n\n${openPetsClaudeImportLine}\n`);
 assert.equal(ensureImportLine(`# User notes\n${openPetsClaudeImportLine}\n${openPetsClaudeImportLine}\n`, openPetsClaudeImportLine), `# User notes\n\n${openPetsClaudeImportLine}\n`);
 assert.equal(removeImportLine(`# User notes\n\n${openPetsClaudeImportLine}\n`, openPetsClaudeImportLine), "# User notes\n");
-assert.match(upsertOpenPetsMemoryBlock("custom\n", "<!-- OPENPETS:START -->\nmanaged\n<!-- OPENPETS:END -->\n"), /custom[\s\S]*managed/);
-assert.equal((upsertOpenPetsMemoryBlock("<!-- OPENPETS:START -->\nold\n<!-- OPENPETS:END -->\n\n<!-- OPENPETS:START -->\nolder\n<!-- OPENPETS:END -->\n", "<!-- OPENPETS:START -->\nnew\n<!-- OPENPETS:END -->\n").match(/OPENPETS:START/g) ?? []).length, 1);
-assert.match(ensureManagedImport("# User notes\n"), /OPENPETS:IMPORT:START[\s\S]*@~\/\.claude\/openpets\.md[\s\S]*OPENPETS:IMPORT:END/);
+assert.match(upsertFamiliarOSMemoryBlock("custom\n", "<!-- FAMILIAROS:START -->\nmanaged\n<!-- FAMILIAROS:END -->\n"), /custom[\s\S]*managed/);
+assert.equal((upsertFamiliarOSMemoryBlock("<!-- FAMILIAROS:START -->\nold\n<!-- FAMILIAROS:END -->\n\n<!-- FAMILIAROS:START -->\nolder\n<!-- FAMILIAROS:END -->\n", "<!-- FAMILIAROS:START -->\nnew\n<!-- FAMILIAROS:END -->\n").match(/FAMILIAROS:START/g) ?? []).length, 1);
+assert.match(ensureManagedImport("# User notes\n"), /FAMILIAROS:IMPORT:START[\s\S]*@~\/\.claude\/familiaros\.md[\s\S]*FAMILIAROS:IMPORT:END/);
 assert.equal(ensureManagedImport(`${openPetsClaudeImportLine}\n`), `${openPetsClaudeImportLine}\n`, "user-owned import line should not be wrapped as managed.");
-assert.equal(removeOpenPetsMemoryBlock("custom\n<!-- OPENPETS:START -->\nmanaged\n<!-- OPENPETS:END -->\n"), "custom\n");
+assert.equal(removeFamiliarOSMemoryBlock("custom\n<!-- FAMILIAROS:START -->\nmanaged\n<!-- FAMILIAROS:END -->\n"), "custom\n");
 
-const dir = mkdtempSync(join(tmpdir(), "openpets-claude-memory-"));
+const dir = mkdtempSync(join(tmpdir(), "familiaros-claude-memory-"));
 try {
   const claudeDir = join(dir, ".claude");
   const claudeMd = join(claudeDir, "CLAUDE.md");
-  const openpetsMd = join(claudeDir, "openpets.md");
+  const familiarosMd = join(claudeDir, "familiaros.md");
   mkdirSync(claudeDir);
   writeFileSync(claudeMd, "# Existing Claude instructions\n\nKeep this.\n", "utf8");
 
-  const installed = installClaudeOpenPetsMemory(dir);
+  const installed = installClaudeFamiliarOSMemory(dir);
   assert.equal(installed.changed, true);
-  assert.match(readFileSync(claudeMd, "utf8"), /Keep this\.[\s\S]*@~\/\.claude\/openpets\.md/);
-  assert.match(readFileSync(openpetsMd, "utf8"), /openpets_say/);
+  assert.match(readFileSync(claudeMd, "utf8"), /Keep this\.[\s\S]*@~\/\.claude\/familiaros\.md/);
+  assert.match(readFileSync(familiarosMd, "utf8"), /familiaros_say/);
 
-  const reinstalled = installClaudeOpenPetsMemory(dir);
+  const reinstalled = installClaudeFamiliarOSMemory(dir);
   assert.equal(reinstalled.changed, false);
-  assert.equal((readFileSync(claudeMd, "utf8").match(/@~\/\.claude\/openpets\.md/g) ?? []).length, 1);
-  assert.match(readFileSync(claudeMd, "utf8"), /OPENPETS:IMPORT:START/);
+  assert.equal((readFileSync(claudeMd, "utf8").match(/@~\/\.claude\/familiaros\.md/g) ?? []).length, 1);
+  assert.match(readFileSync(claudeMd, "utf8"), /FAMILIAROS:IMPORT:START/);
 
-  writeFileSync(openpetsMd, `${readFileSync(openpetsMd, "utf8")}\nUser custom note.\n`, "utf8");
-  const uninstalled = uninstallClaudeOpenPetsMemory(dir);
+  writeFileSync(familiarosMd, `${readFileSync(familiarosMd, "utf8")}\nUser custom note.\n`, "utf8");
+  const uninstalled = uninstallClaudeFamiliarOSMemory(dir);
   assert.equal(uninstalled.changed, true);
-  assert.doesNotMatch(readFileSync(claudeMd, "utf8"), /openpets\.md/);
-  assert.equal(existsSync(openpetsMd), true, "customized openpets.md should be preserved after managed block removal.");
-  assert.match(readFileSync(openpetsMd, "utf8"), /User custom note/);
+  assert.doesNotMatch(readFileSync(claudeMd, "utf8"), /familiaros\.md/);
+  assert.equal(existsSync(familiarosMd), true, "customized familiaros.md should be preserved after managed block removal.");
+  assert.match(readFileSync(familiarosMd, "utf8"), /User custom note/);
 
   const userImportHome = join(dir, "user-import-home");
   const userClaudeDir = join(userImportHome, ".claude");
   mkdirSync(userClaudeDir, { recursive: true });
   writeFileSync(join(userClaudeDir, "CLAUDE.md"), `# User-owned import\n${openPetsClaudeImportLine}\n`, "utf8");
-  writeFileSync(join(userClaudeDir, "openpets.md"), "User-owned content.\n", "utf8");
-  installClaudeOpenPetsMemory(userImportHome);
-  assert.doesNotMatch(readFileSync(join(userClaudeDir, "CLAUDE.md"), "utf8"), /OPENPETS:IMPORT:START/, "pre-existing import should remain user-owned.");
-  uninstallClaudeOpenPetsMemory(userImportHome);
-  assert.match(readFileSync(join(userClaudeDir, "CLAUDE.md"), "utf8"), /@~\/\.claude\/openpets\.md/, "user-owned import should not be removed.");
-  assert.match(readFileSync(join(userClaudeDir, "openpets.md"), "utf8"), /User-owned content/, "user-owned openpets.md content should be preserved.");
+  writeFileSync(join(userClaudeDir, "familiaros.md"), "User-owned content.\n", "utf8");
+  installClaudeFamiliarOSMemory(userImportHome);
+  assert.doesNotMatch(readFileSync(join(userClaudeDir, "CLAUDE.md"), "utf8"), /FAMILIAROS:IMPORT:START/, "pre-existing import should remain user-owned.");
+  uninstallClaudeFamiliarOSMemory(userImportHome);
+  assert.match(readFileSync(join(userClaudeDir, "CLAUDE.md"), "utf8"), /@~\/\.claude\/familiaros\.md/, "user-owned import should not be removed.");
+  assert.match(readFileSync(join(userClaudeDir, "familiaros.md"), "utf8"), /User-owned content/, "user-owned familiaros.md content should be preserved.");
 
   const symlinkHome = join(dir, "symlink-home");
   const symlinkTarget = join(dir, "outside");
   mkdirSync(symlinkHome);
   mkdirSync(symlinkTarget);
   symlinkSync(symlinkTarget, join(symlinkHome, ".claude"));
-  assert.throws(() => installClaudeOpenPetsMemory(symlinkHome));
+  assert.throws(() => installClaudeFamiliarOSMemory(symlinkHome));
 
   const symlinkFileHome = join(dir, "symlink-file-home");
   mkdirSync(join(symlinkFileHome, ".claude"), { recursive: true });
   writeFileSync(join(dir, "outside-file"), "x", "utf8");
   symlinkSync(join(dir, "outside-file"), join(symlinkFileHome, ".claude", "CLAUDE.md"));
-  assert.throws(() => installClaudeOpenPetsMemory(symlinkFileHome));
+  assert.throws(() => installClaudeFamiliarOSMemory(symlinkFileHome));
 
   const oversizedHome = join(dir, "oversized-home");
   mkdirSync(join(oversizedHome, ".claude"), { recursive: true });
   writeFileSync(join(oversizedHome, ".claude", "CLAUDE.md"), "x".repeat(1024 * 1024 + 1), "utf8");
-  assert.throws(() => installClaudeOpenPetsMemory(oversizedHome));
+  assert.throws(() => installClaudeFamiliarOSMemory(oversizedHome));
 } finally {
   rmSync(dir, { recursive: true, force: true });
 }
diff --git a/apps/desktop/tests/codex-pets.test.ts b/apps/desktop/tests/codex-familiars.test.ts
similarity index 91%
rename from apps/desktop/tests/codex-pets.test.ts
rename to apps/desktop/tests/codex-familiars.test.ts
index 0a051074..6d8f9eb0 100644
--- a/apps/desktop/tests/codex-pets.test.ts
+++ b/apps/desktop/tests/codex-familiars.test.ts
@@ -1,6 +1,6 @@
 import assert from "node:assert/strict";
 
-import { maxCodexPets, maxCodexSpritesheetBytes, maxCodexThumbnailSourceBytes, validateCodexPetMetadata } from "../src/codex-pets-core.js";
+import { maxCodexPets, maxCodexSpritesheetBytes, maxCodexThumbnailSourceBytes, validateCodexPetMetadata } from "../src/codex-familiars-core.js";
 
 const valid = validateCodexPetMetadata({
   id: "fixer",
@@ -26,4 +26,4 @@ assert.equal(maxCodexSpritesheetBytes, 100 * 1024 * 1024);
 assert.equal(maxCodexThumbnailSourceBytes, 24 * 1024 * 1024);
 assert.equal(maxCodexPets, 100);
 
-console.log("Codex pet validation passed.");
+console.log("Codex familiar validation passed.");
diff --git a/apps/desktop/tests/default-pet-external-show.test.ts b/apps/desktop/tests/default-familiar-external-show.test.ts
similarity index 77%
rename from apps/desktop/tests/default-pet-external-show.test.ts
rename to apps/desktop/tests/default-familiar-external-show.test.ts
index 18097113..deac7345 100644
--- a/apps/desktop/tests/default-pet-external-show.test.ts
+++ b/apps/desktop/tests/default-familiar-external-show.test.ts
@@ -8,31 +8,31 @@ import { shouldShowDefaultPetForExternalEvent } from "../src/app-state-core.js";
 assert.equal(
   shouldShowDefaultPetForExternalEvent(false, false, false),
   true,
-  "external pet.say should show the default pet even when launch display is disabled",
+  "external familiar.say should show the default familiar even when launch display is disabled",
 );
 assert.equal(
   shouldShowDefaultPetForExternalEvent(true, false, false),
   true,
-  "external events should keep showing an already visible default pet",
+  "external events should keep showing an already visible default familiar",
 );
 assert.equal(
   shouldShowDefaultPetForExternalEvent(false, true, false),
   true,
-  "external events should keep showing the default pet when launch display is enabled",
+  "external events should keep showing the default familiar when launch display is enabled",
 );
 assert.equal(
   shouldShowDefaultPetForExternalEvent(false, false, true),
   false,
-  "paused state should suppress external default pet display",
+  "paused state should suppress external default familiar display",
 );
 assert.equal(
   shouldShowDefaultPetForExternalEvent(true, true, true),
   false,
-  "paused state should suppress external default pet display even when the window is visible",
+  "paused state should suppress external default familiar display even when the window is visible",
 );
 
-const appRoot = process.env.OPENPETS_DESKTOP_ROOT ?? resolve(dirname(fileURLToPath(import.meta.url)), "../..");
-const controllerSource = readFileSync(join(appRoot, "src", "default-pet-controller.ts"), "utf8");
+const appRoot = process.env.FAMILIAROS_DESKTOP_ROOT ?? resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+const controllerSource = readFileSync(join(appRoot, "src", "default-familiar-controller.ts"), "utf8");
 const showDefaultPet = extractFunction(controllerSource, "showDefaultPet");
 const showDefaultPetWindow = extractFunction(controllerSource, "showDefaultPetWindow");
 const showDefaultPetForExternalEvent = extractFunction(controllerSource, "showDefaultPetForExternalEvent");
@@ -50,7 +50,7 @@ assert.doesNotMatch(
   "shared window show path must not persist the open-on-launch preference",
 );
 assert.match(showDefaultPetWindow, /getOrCreateDefaultPetWindow\(\)/, "shared window show path should create the window when needed");
-assert.match(showDefaultPetWindow, /window\.showInactive\(\)/, "shared window show path should make the pet visible");
+assert.match(showDefaultPetWindow, /window\.showInactive\(\)/, "shared window show path should make the familiar visible");
 assert.match(
   showDefaultPetForExternalEvent,
   /shouldShowDefaultPetForExternalEvent\(visible, state\.preferences\.openDefaultPetOnLaunch, paused\)/,
@@ -59,7 +59,7 @@ assert.match(
 assert.match(
   showDefaultPetForExternalEvent,
   /showDefaultPetWindow\("external-event"\)/,
-  "external show should open the default pet without going through the preference-writing user action",
+  "external show should open the default familiar without going through the preference-writing user action",
 );
 assert.doesNotMatch(
   showDefaultPetForExternalEvent,
@@ -69,15 +69,15 @@ assert.doesNotMatch(
 assert.match(
   applyExternalPetSay,
   /setTransientDisplay\(\{ message, reaction \}\);\s*showDefaultPetForExternalEvent\(\);/,
-  "pet.say should set the transient message before opening the default pet window",
+  "familiar.say should set the transient message before opening the default familiar window",
 );
 assert.match(
   getOrCreateDefaultPetWindow,
   /display: transientDisplay/,
-  "new default pet windows should render the active transient message on first load",
+  "new default familiar windows should render the active transient message on first load",
 );
 
-console.error("Default pet external show validation passed.");
+console.error("Default familiar external show validation passed.");
 
 function extractFunction(source: string, functionName: string): string {
   const declaration = `function ${functionName}`;
diff --git a/apps/desktop/tests/knowledge-store.test.ts b/apps/desktop/tests/knowledge-store.test.ts
index 28839991..1a1dd584 100644
--- a/apps/desktop/tests/knowledge-store.test.ts
+++ b/apps/desktop/tests/knowledge-store.test.ts
@@ -6,7 +6,7 @@ import { join } from "node:path";
 import { KnowledgeStore } from "../src/knowledge-store-core.js";
 
 function makeTempDir(): string {
-  return mkdtempSync(join(tmpdir(), "openpets-knowledge-"));
+  return mkdtempSync(join(tmpdir(), "familiaros-knowledge-"));
 }
 
 function cleanTempDir(dir: string): void {
@@ -23,12 +23,12 @@ const store = new KnowledgeStore(tempDir);
 assert.deepEqual(store.listFiles(), [], "New store should have no files.");
 assert.equal(store.buildRelevantContext("hello"), undefined, "Empty store should produce no context.");
 
-const text = await store.storeFile({ name: "hello.txt", data: Buffer.from("Hello world, this is OpenPets knowledge store.") });
+const text = await store.storeFile({ name: "hello.txt", data: Buffer.from("Hello world, this is FamiliarOS knowledge store.") });
 assert.ok(text.id.startsWith("kfile-"), "Stored file should have a kfile id.");
 assert.equal(text.name, "hello.txt", "Stored file should keep its name.");
 assert.equal(text.mimeType, "text/plain", "TXT files should be detected as text/plain.");
 assert.equal(text.isText, true, "TXT files should be flagged as text.");
-assert.equal(text.extractedText, "Hello world, this is OpenPets knowledge store.", "Text should be extracted.");
+assert.equal(text.extractedText, "Hello world, this is FamiliarOS knowledge store.", "Text should be extracted.");
 
 const binary = await store.storeFile({ name: "blob.bin", data: Buffer.from([0x00, 0x01, 0x02, 0x03]) });
 assert.equal(binary.mimeType, "application/octet-stream", "Unknown extensions default to octet-stream.");
@@ -36,7 +36,7 @@ assert.equal(binary.isText, false, "Binary files should not be flagged as text."
 assert.equal(binary.extractedText, undefined, "Binary files should have no extracted text.");
 
 await new Promise((resolve) => setTimeout(resolve, 10));
-const markdown = await store.storeFile({ name: "notes.md", data: Buffer.from("# OpenPets\n\nKnowledge store notes.") });
+const markdown = await store.storeFile({ name: "notes.md", data: Buffer.from("# FamiliarOS\n\nKnowledge store notes.") });
 assert.equal(markdown.mimeType, "text/markdown", "MD extension should infer markdown.");
 
 // Listing and ordering
@@ -45,8 +45,8 @@ assert.equal(listed.length, 3, "All three files should be listed.");
 assert.equal(listed[0].id, markdown.id, "Most recent file should appear first.");
 
 // Searching
-const hits = store.searchFiles("OpenPets");
-assert.equal(hits.length, 2, "Search should find files mentioning OpenPets.");
+const hits = store.searchFiles("FamiliarOS");
+assert.equal(hits.length, 2, "Search should find files mentioning FamiliarOS.");
 assert.ok(hits.every((hit) => hit.score > 0), "All returned hits should have a positive score.");
 
 const noHits = store.searchFiles("quantum physics");
@@ -56,7 +56,7 @@ const emptyQuery = store.searchFiles("  ");
 assert.equal(emptyQuery.length, 3, "Empty query should fall back to listing.");
 
 // Relevant context building
-const context = store.buildRelevantContext("OpenPets knowledge");
+const context = store.buildRelevantContext("FamiliarOS knowledge");
 assert.ok(context, "Relevant context should be built for matching query.");
 assert.ok(context?.includes("hello.txt"), "Context should include the matching file name.");
 assert.ok(context?.includes("Use the above files only when they help answer the current request."), "Context should include guidance footer.");
@@ -64,7 +64,7 @@ assert.ok(context?.includes("Use the above files only when they help answer the
 // File path retrieval
 const filePath = store.getFilePath(text.id);
 assert.ok(filePath, "Stored file should have a path.");
-assert.equal(readFileSync(filePath, "utf8"), "Hello world, this is OpenPets knowledge store.", "Stored file content should match.");
+assert.equal(readFileSync(filePath, "utf8"), "Hello world, this is FamiliarOS knowledge store.", "Stored file content should match.");
 assert.equal(store.getFilePath("kfile-missing"), null, "Missing id should return null.");
 
 // Deletion
diff --git a/apps/desktop/tests/lease-manager.test.ts b/apps/desktop/tests/lease-manager.test.ts
index 7bd69256..1d23728b 100644
--- a/apps/desktop/tests/lease-manager.test.ts
+++ b/apps/desktop/tests/lease-manager.test.ts
@@ -23,20 +23,20 @@ const defaultLease = manager.acquire();
 assert.equal(defaultLease.usingDefaultPet, true, "Default lease did not target default.");
 assert.equal(defaultLease.targetKind, "default", "Default lease targetKind should be 'default'.");
 manager.release(defaultLease.leaseId);
-assert.equal(closed.length, 0, "Default release closed a temp pet.");
+assert.equal(closed.length, 0, "Default release closed a temp familiar.");
 
 const first = manager.acquire("snoopy");
 const second = manager.acquire("snoopy");
-assert.equal(opened.join(","), "snoopy", "Explicit pet did not open once for multiple leases.");
+assert.equal(opened.join(","), "snoopy", "Explicit familiar did not open once for multiple leases.");
 manager.release(first.leaseId);
-assert.equal(closed.length, 0, "Explicit pet closed before final lease release.");
+assert.equal(closed.length, 0, "Explicit familiar closed before final lease release.");
 manager.release(first.leaseId);
 manager.release(second.leaseId);
-assert.equal(closed.join(","), "snoopy", "Explicit pet did not close after final release.");
+assert.equal(closed.join(","), "snoopy", "Explicit familiar did not close after final release.");
 
 const missing = manager.acquire("missing");
-assert.equal(missing.fallbackReason, "pet_not_installed", "Missing pet did not fall back to default.");
-assert.equal(missing.usingDefaultPet, true, "Missing pet should use default.");
+assert.equal(missing.fallbackReason, "pet_not_installed", "Missing familiar did not fall back to default.");
+assert.equal(missing.usingDefaultPet, true, "Missing familiar should use default.");
 manager.release(missing.leaseId);
 
 const expiring = manager.acquire("tux");
diff --git a/apps/desktop/tests/onboarding-state.test.ts b/apps/desktop/tests/onboarding-state.test.ts
index 33f87312..5ef7fa90 100644
--- a/apps/desktop/tests/onboarding-state.test.ts
+++ b/apps/desktop/tests/onboarding-state.test.ts
@@ -16,8 +16,8 @@ const state = {
     petScale: 1,
     onboardingCompleted: false,
   },
-  pets: {
-    installed: [{ id: "built-in", displayName: "Built-in Pet" }],
+  familiars: {
+    installed: [{ id: "built-in", displayName: "Built-in Familiar" }],
   },
 };
 
@@ -27,7 +27,7 @@ assert.equal(completed.preferences.defaultPetId, "built-in");
 assert.equal(completed.preferences.openDefaultPetOnLaunch, true);
 assert.equal(completed.preferences.speechBubblesEnabled, true);
 assert.equal(completed.preferences.petScale, 1);
-assert.deepEqual(completed.pets, state.pets);
+assert.deepEqual(completed.familiars, state.familiars);
 assert.equal(state.preferences.onboardingCompleted, false);
 
 const preferencePatch = {
diff --git a/apps/desktop/tests/plugin-catalog-validation.test.ts b/apps/desktop/tests/plugin-catalog-validation.test.ts
index 8b75424f..a30d5b94 100644
--- a/apps/desktop/tests/plugin-catalog-validation.test.ts
+++ b/apps/desktop/tests/plugin-catalog-validation.test.ts
@@ -1,22 +1,22 @@
 import assert from "node:assert/strict";
 import { validatePluginCatalog } from "../src/plugin-catalog-validation.js";
 
-const entry = { id: "hello-plugin", name: "Hello", version: "1.0.0", description: "desc", runtime: "declarative", permissions: ["timer", "pet:speak"], downloadUrl: "https://zip.openpets.dev/plugins/hello.zip", sha256: "a".repeat(64) };
+const entry = { id: "hello-plugin", name: "Hello", version: "1.0.0", description: "desc", runtime: "declarative", permissions: ["timer", "familiar:speak"], downloadUrl: "https://zip.familiaros.dev/plugins/hello.zip", sha256: "a".repeat(64) };
 
 const catalog = validatePluginCatalog({ version: 1, generatedAt: new Date().toISOString(), plugins: [entry] });
 assert.equal(catalog.plugins[0].id, "hello-plugin");
-assert.deepEqual(catalog.plugins[0].permissions, ["pet:speak", "timer"]);
+assert.deepEqual(catalog.plugins[0].permissions, ["familiar:speak", "timer"]);
 
 assert.throws(() => validatePluginCatalog({ version: 1, generatedAt: "now", plugins: [{ ...entry, extra: true }] }), /Unknown field/);
 assert.throws(() => validatePluginCatalog({ version: 1, generatedAt: "now", plugins: [entry, entry] }), /Duplicate plugin id/);
 assert.throws(() => validatePluginCatalog({ version: 1, generatedAt: "now", plugins: [{ ...entry, sha256: "A".repeat(64) }] }), /sha256/);
 
-const catalogV2 = validatePluginCatalog({ version: 2, generatedAt: "now", plugins: [{ ...entry, id: "js-plugin", runtime: "javascript", icon: "github", sdkVersion: "1.0.0", permissions: ["pet:speak", "network"], minOpenPetsVersion: "2.0.0", maxOpenPetsVersion: "3.0.0", deprecated: true, statusReason: "Use another plugin", network: { hosts: ["api.example.com"] } }] });
+const catalogV2 = validatePluginCatalog({ version: 2, generatedAt: "now", plugins: [{ ...entry, id: "js-plugin", runtime: "javascript", icon: "github", sdkVersion: "1.0.0", permissions: ["familiar:speak", "network"], minFamiliarOSVersion: "2.0.0", maxFamiliarOSVersion: "3.0.0", deprecated: true, statusReason: "Use another plugin", network: { hosts: ["api.example.com"] } }] });
 assert.equal(catalogV2.version, 2);
 assert.equal(catalogV2.plugins[0].runtime, "javascript");
 assert.equal(catalogV2.plugins[0].icon, "github");
 assert.throws(() => validatePluginCatalog({ version: 2, generatedAt: "now", plugins: [{ ...entry, runtime: "python" }] }), /runtime/);
 assert.throws(() => validatePluginCatalog({ version: 2, generatedAt: "now", plugins: [{ ...entry, icon: "https://example.com/icon.svg" }] }), /icon/);
-assert.throws(() => validatePluginCatalog({ version: 2, generatedAt: "now", plugins: [{ ...entry, runtime: "javascript", sdkVersion: "1.0.0", permissions: ["pet:speak", "network"], network: { hosts: ["*.example.com"] } }] }), /network/);
+assert.throws(() => validatePluginCatalog({ version: 2, generatedAt: "now", plugins: [{ ...entry, runtime: "javascript", sdkVersion: "1.0.0", permissions: ["familiar:speak", "network"], network: { hosts: ["*.example.com"] } }] }), /network/);
 
 console.error("Plugin catalog validation passed.");
diff --git a/apps/desktop/tests/plugin-config.test.ts b/apps/desktop/tests/plugin-config.test.ts
index e8ea8a51..a6bdd91a 100644
--- a/apps/desktop/tests/plugin-config.test.ts
+++ b/apps/desktop/tests/plugin-config.test.ts
@@ -1,7 +1,7 @@
 import assert from "node:assert/strict";
 
 import { getEffectivePluginConfig, getPluginDefaultConfig, resolvePluginNumericConfig, resolvePluginStringConfig, validatePluginConfigReplacement } from "../src/plugin-config.js";
-import type { OpenPetsPluginManifest } from "../src/plugin-manifest.js";
+import type { FamiliarOSPluginManifest } from "../src/plugin-manifest.js";
 
 const base = manifest();
 
@@ -58,7 +58,7 @@ function assertInvalidReplacement(config: unknown, code: string): void {
   assert.ok(result.errors.some((error) => error.code === code), JSON.stringify(result.errors));
 }
 
-function manifest(patch: Partial<OpenPetsPluginManifest> = {}): OpenPetsPluginManifest {
+function manifest(patch: Partial<FamiliarOSPluginManifest> = {}): FamiliarOSPluginManifest {
   return {
     manifestVersion: 1,
     id: "plug",
diff --git a/apps/desktop/tests/plugin-package.test.ts b/apps/desktop/tests/plugin-package.test.ts
index 27f157d8..6a89364a 100644
--- a/apps/desktop/tests/plugin-package.test.ts
+++ b/apps/desktop/tests/plugin-package.test.ts
@@ -5,44 +5,44 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { validatePluginCatalog } from "../src/plugin-catalog-validation.js";
 import { installCatalogPluginPackage, safeDeletePluginInstallDir, validatePluginZipUrl } from "../src/plugin-package.js";
-import type { OpenPetsPluginManifest } from "../src/plugin-manifest.js";
+import type { FamiliarOSPluginManifest } from "../src/plugin-manifest.js";
 
-const manifest: OpenPetsPluginManifest = { manifestVersion: 1, id: "zip-plug", name: "Zip Plug", version: "1.0.0", runtime: "declarative", permissions: ["timer", "pet:speak"], triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.speak", message: "hi" }] }] };
+const manifest: FamiliarOSPluginManifest = { manifestVersion: 1, id: "zip-plug", name: "Zip Plug", version: "1.0.0", runtime: "declarative", permissions: ["timer", "familiar:speak"], triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.speak", message: "hi" }] }] };
 const text = JSON.stringify(manifest);
-const zip = makeZip("openpets.plugin.json", Buffer.from(text));
-const entry = { id: manifest.id, name: manifest.name, version: manifest.version, description: "desc", runtime: "declarative" as const, permissions: manifest.permissions, downloadUrl: "https://zip.openpets.dev/plugins/zip-plug.zip", sha256: createHash("sha256").update(zip).digest("hex") };
+const zip = makeZip("familiaros.plugin.json", Buffer.from(text));
+const entry = { id: manifest.id, name: manifest.name, version: manifest.version, description: "desc", runtime: "declarative" as const, permissions: manifest.permissions, downloadUrl: "https://zip.familiaros.dev/plugins/zip-plug.zip", sha256: createHash("sha256").update(zip).digest("hex") };
 
 validatePluginZipUrl(entry.downloadUrl);
-assert.throws(() => validatePluginZipUrl("http://zip.openpets.dev/plugins/x.zip"), /not allowed/);
-assert.throws(() => validatePluginZipUrl("https://zip.openpets.dev:444/plugins/x.zip"), /not allowed/);
+assert.throws(() => validatePluginZipUrl("http://zip.familiaros.dev/plugins/x.zip"), /not allowed/);
+assert.throws(() => validatePluginZipUrl("https://zip.familiaros.dev:444/plugins/x.zip"), /not allowed/);
 
-const userData = mkdtempSync(join(tmpdir(), "openpets-plugin-package-"));
+const userData = mkdtempSync(join(tmpdir(), "familiaros-plugin-package-"));
 const installed = await installCatalogPluginPackage({ userDataPath: userData, catalogEntry: entry, zip });
 assert.equal(installed.manifest.id, manifest.id);
-assert.equal(readFileSync(join(userData, "plugins", manifest.id, "openpets.plugin.json"), "utf8"), text);
+assert.equal(readFileSync(join(userData, "plugins", manifest.id, "familiaros.plugin.json"), "utf8"), text);
 assert.rejects(() => installCatalogPluginPackage({ userDataPath: userData, catalogEntry: { ...entry, name: "Other" }, zip }), /does not match/);
-assert.rejects(() => installCatalogPluginPackage({ userDataPath: userData, catalogEntry: entry, zip: makeZip("nested/openpets.plugin.json", Buffer.from(text)) }), /invalid|exactly one root manifest|must contain openpets/);
+assert.rejects(() => installCatalogPluginPackage({ userDataPath: userData, catalogEntry: entry, zip: makeZip("nested/familiaros.plugin.json", Buffer.from(text)) }), /invalid|exactly one root manifest|must contain familiaros/);
 
-const jsManifest: OpenPetsPluginManifest = { manifestVersion: 2, id: "js-plug", name: "JS Plug", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.mjs", permissions: ["pet:speak"] };
+const jsManifest: FamiliarOSPluginManifest = { manifestVersion: 2, id: "js-plug", name: "JS Plug", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.mjs", permissions: ["familiar:speak"] };
 const jsText = JSON.stringify(jsManifest);
 const jsEntryText = "export default {};\n";
-const jsZip = makeZipFiles([{ name: "openpets.plugin.json", data: Buffer.from(jsText) }, { name: "index.mjs", data: Buffer.from(jsEntryText) }]);
-const jsCatalogEntry = { id: jsManifest.id, name: jsManifest.name, version: jsManifest.version, description: "desc", runtime: "javascript" as const, sdkVersion: "1.0.0", permissions: jsManifest.permissions, downloadUrl: "https://zip.openpets.dev/plugins/js-plug.zip", sha256: createHash("sha256").update(jsZip).digest("hex") };
+const jsZip = makeZipFiles([{ name: "familiaros.plugin.json", data: Buffer.from(jsText) }, { name: "index.mjs", data: Buffer.from(jsEntryText) }]);
+const jsCatalogEntry = { id: jsManifest.id, name: jsManifest.name, version: jsManifest.version, description: "desc", runtime: "javascript" as const, sdkVersion: "1.0.0", permissions: jsManifest.permissions, downloadUrl: "https://zip.familiaros.dev/plugins/js-plug.zip", sha256: createHash("sha256").update(jsZip).digest("hex") };
 const jsInstalled = await installCatalogPluginPackage({ userDataPath: userData, catalogEntry: jsCatalogEntry, zip: jsZip });
 assert.equal(readFileSync(join(jsInstalled.installPath, "index.mjs"), "utf8"), jsEntryText);
-await assert.rejects(() => installCatalogPluginPackage({ userDataPath: userData, catalogEntry: jsCatalogEntry, zip: makeZipFiles([{ name: "openpets.plugin.json", data: Buffer.from(jsText) }]) }), /manifest and entry/);
-await assert.rejects(() => installCatalogPluginPackage({ userDataPath: userData, catalogEntry: jsCatalogEntry, zip: makeZipFiles([{ name: "openpets.plugin.json", data: Buffer.from(jsText) }, { name: "index.mjs", data: Buffer.from(jsEntryText) }, { name: "extra.js", data: Buffer.from("") }]) }), /manifest and entry|too many entries/);
+await assert.rejects(() => installCatalogPluginPackage({ userDataPath: userData, catalogEntry: jsCatalogEntry, zip: makeZipFiles([{ name: "familiaros.plugin.json", data: Buffer.from(jsText) }]) }), /manifest and entry/);
+await assert.rejects(() => installCatalogPluginPackage({ userDataPath: userData, catalogEntry: jsCatalogEntry, zip: makeZipFiles([{ name: "familiaros.plugin.json", data: Buffer.from(jsText) }, { name: "index.mjs", data: Buffer.from(jsEntryText) }, { name: "extra.js", data: Buffer.from("") }]) }), /manifest and entry|too many entries/);
 
-const canonicalEntry = validatePluginCatalog({ version: 1, generatedAt: new Date().toISOString(), plugins: [{ ...entry, permissions: ["timer", "pet:speak"] }] }).plugins[0];
+const canonicalEntry = validatePluginCatalog({ version: 1, generatedAt: new Date().toISOString(), plugins: [{ ...entry, permissions: ["timer", "familiar:speak"] }] }).plugins[0];
 await installCatalogPluginPackage({ userDataPath: userData, catalogEntry: canonicalEntry, zip });
 
 const oldText = JSON.stringify({ ...manifest, version: "0.9.0" });
-writeFileSync(join(userData, "plugins", manifest.id, "openpets.plugin.json"), oldText, "utf8");
+writeFileSync(join(userData, "plugins", manifest.id, "familiaros.plugin.json"), oldText, "utf8");
 await installCatalogPluginPackage({ userDataPath: userData, catalogEntry: entry, zip });
-assert.equal(readFileSync(join(userData, "plugins", manifest.id, "openpets.plugin.json"), "utf8"), text);
+assert.equal(readFileSync(join(userData, "plugins", manifest.id, "familiaros.plugin.json"), "utf8"), text);
 
-const deleteRoot = mkdtempSync(join(tmpdir(), "openpets-plugin-delete-"));
-const outside = mkdtempSync(join(tmpdir(), "openpets-plugin-outside-"));
+const deleteRoot = mkdtempSync(join(tmpdir(), "familiaros-plugin-delete-"));
+const outside = mkdtempSync(join(tmpdir(), "familiaros-plugin-outside-"));
 symlinkSync(outside, join(deleteRoot, "plugins"), "dir");
 await assert.rejects(() => safeDeletePluginInstallDir(deleteRoot, manifest.id, join(deleteRoot, "plugins", manifest.id), "catalog"), /invalid|unexpected/);
 
diff --git a/apps/desktop/tests/plugin-runtime.test.ts b/apps/desktop/tests/plugin-runtime.test.ts
index 2cc1ceee..bd54e4a7 100644
--- a/apps/desktop/tests/plugin-runtime.test.ts
+++ b/apps/desktop/tests/plugin-runtime.test.ts
@@ -3,8 +3,8 @@ import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 
-import { OPENPETS_PLUGIN_MANIFEST_FILENAME, type OpenPetsDeclarativePluginManifest, type OpenPetsJavascriptPluginManifest } from "../src/plugin-manifest.js";
-import { type PluginPetApi } from "../src/plugin-pet-api.js";
+import { FAMILIAROS_PLUGIN_MANIFEST_FILENAME, type FamiliarOSDeclarativePluginManifest, type FamiliarOSJavascriptPluginManifest } from "../src/plugin-manifest.js";
+import { type PluginPetApi } from "../src/plugin-familiar-api.js";
 import { PluginRuntime, type PluginRuntimeScheduler, type PluginTimerHandle } from "../src/plugin-runtime.js";
 import type { PluginJsHost, PluginJsHostInstance, PluginJsHostStartOptions } from "../src/plugin-js-host.js";
 import { initializePluginState, type PluginStateStore, type PluginStateRecord } from "../src/plugin-state.js";
@@ -35,12 +35,12 @@ class FakePetApi implements PluginPetApi {
   fail = false;
   deferredFailure: { reject: (error: Error) => void } | undefined;
   speak(message: string): void {
-    if (this.fail) throw new Error("pet api failed");
+    if (this.fail) throw new Error("familiar api failed");
     this.events.push(`speak:${message}`);
   }
   react(reaction: string): void | Promise<void> {
     if (this.deferredFailure) return new Promise((_resolve, reject) => { this.deferredFailure = { reject }; });
-    if (this.fail) throw new Error("pet api failed");
+    if (this.fail) throw new Error("familiar api failed");
     this.events.push(`react:${reaction}`);
   }
   moveBy(options: { x: number; y: number; durationMs?: number }): void { this.events.push(`moveBy:${options.x},${options.y},${options.durationMs ?? ""}`); }
@@ -72,7 +72,7 @@ await scenario("disabled no timers", async ({ store, scheduler }) => {
 
 await scenario("javascript sdk command status storage schedule and permissions", async ({ store, scheduler, petApi }) => {
   const jsHost = new FakeJsHost();
-  addPlugin(store, { manifestVersion: 2, runtime: "javascript", approvedPermissions: ["commands", "status", "storage", "schedule", "pet:speak"] }, jsManifest({ permissions: ["commands", "status", "storage", "schedule", "pet:speak"] }));
+  addPlugin(store, { manifestVersion: 2, runtime: "javascript", approvedPermissions: ["commands", "status", "storage", "schedule", "familiar:speak"] }, jsManifest({ permissions: ["commands", "status", "storage", "schedule", "familiar:speak"] }));
   const rt = runtime(store, scheduler, petApi, undefined, jsHost);
   await rt.start();
   assert.deepEqual(rt.getPluginState("plug").commands.map((c) => c.id), ["run"]);
@@ -81,7 +81,7 @@ await scenario("javascript sdk command status storage schedule and permissions",
   jsHost.starts[0].sdk?.storage.set("a", "b");
   assert.equal(jsHost.starts[0].sdk?.storage.get("a"), "b");
   assert.equal(store.getRecord("plug")?.config["storage:a"], undefined);
-  jsHost.starts[0].sdk?.schedule.once("s", 1, () => jsHost.starts[0].sdk?.pet.speak("hi"));
+  jsHost.starts[0].sdk?.schedule.once("s", 1, () => jsHost.starts[0].sdk?.familiar.speak("hi"));
   scheduler.fire(0);
   await Promise.resolve();
   assert.deepEqual(petApi.events, ["speak:hi"]);
@@ -94,13 +94,13 @@ await scenario("javascript sdk permission rejection", async ({ store }) => {
   assert.throws(() => jsHost.starts[0].sdk?.storage.set("a", "b"), /not approved/);
 });
 
-await scenario("javascript sdk pet movement requires pet move permission", async ({ store, scheduler, petApi }) => {
+await scenario("javascript sdk familiar movement requires familiar move permission", async ({ store, scheduler, petApi }) => {
   const jsHost = new FakeJsHost();
-  addPlugin(store, { manifestVersion: 2, runtime: "javascript", approvedPermissions: ["pet:move"] }, jsManifest({ permissions: ["pet:move"] }));
+  addPlugin(store, { manifestVersion: 2, runtime: "javascript", approvedPermissions: ["familiar:move"] }, jsManifest({ permissions: ["familiar:move"] }));
   await runtime(store, scheduler, petApi, undefined, jsHost).start();
-  await jsHost.starts[0].sdk?.pet.moveBy({ x: 20, y: -10, durationMs: 500 });
-  await jsHost.starts[0].sdk?.pet.wander({ distance: 40, durationMs: 700 });
-  await jsHost.starts[0].sdk?.pet.moveToHome();
+  await jsHost.starts[0].sdk?.familiar.moveBy({ x: 20, y: -10, durationMs: 500 });
+  await jsHost.starts[0].sdk?.familiar.wander({ distance: 40, durationMs: 700 });
+  await jsHost.starts[0].sdk?.familiar.moveToHome();
   assert.deepEqual(petApi.events, ["moveBy:20,-10,500", "wander:40,700", "moveToHome"]);
 });
 
@@ -111,7 +111,7 @@ await scenario("javascript http fetch allows approved github host", async ({ sto
   globalThis.fetch = (async () => new Response(JSON.stringify({ ok: true }), { status: 200, headers: { "content-type": "application/json", etag: "abc" } })) as typeof fetch;
   try {
     await runtime(store, new FakeScheduler(), new FakePetApi(), undefined, jsHost).start();
-    const result = await jsHost.starts[0].sdk?.http.fetch("https://api.github.com/repos/open-pets/openpets/releases");
+    const result = await jsHost.starts[0].sdk?.http.fetch("https://api.github.com/repos/familiaros/familiaros/releases");
     assert.equal(result?.status, 200);
     assert.deepEqual(result?.json, { ok: true });
     assert.equal(result?.headers.etag, "abc");
@@ -189,7 +189,7 @@ await scenario("javascript reload replaces host", async ({ store }) => {
 });
 
 await scenario("valid timer schedules and fires", async ({ store, scheduler, petApi }) => {
-  addPlugin(store, {}, manifest({ permissions: ["timer", "pet:speak", "pet:reaction"], actions: [{ type: "pet.speak", message: "Stretch" }, { type: "pet.react", reaction: "celebrating" }] }));
+  addPlugin(store, {}, manifest({ permissions: ["timer", "familiar:speak", "familiar:reaction"], actions: [{ type: "familiar.speak", message: "Stretch" }, { type: "familiar.react", reaction: "celebrating" }] }));
   await runtime(store, scheduler, petApi).start();
   assert.equal(scheduler.timers[0].delayMs, 5 * 60_000);
   assert.deepEqual(petApi.events, []);
@@ -199,7 +199,7 @@ await scenario("valid timer schedules and fires", async ({ store, scheduler, pet
 });
 
 await scenario("config speak and reaction refs execute", async ({ store, scheduler, petApi }) => {
-  addPlugin(store, { config: { message: "Hello", reaction: "celebrating" } }, manifest({ permissions: ["timer", "pet:speak", "pet:reaction"], configSchema: { message: { type: "text", default: "Stretch" }, reaction: { type: "select", default: "idle", options: [{ label: "Idle", value: "idle" }, { label: "Celebrate", value: "celebrating" }] } }, actions: [{ type: "pet.speak", message: { config: "message" } }, { type: "pet.react", reaction: { config: "reaction" } }] }));
+  addPlugin(store, { config: { message: "Hello", reaction: "celebrating" } }, manifest({ permissions: ["timer", "familiar:speak", "familiar:reaction"], configSchema: { message: { type: "text", default: "Stretch" }, reaction: { type: "select", default: "idle", options: [{ label: "Idle", value: "idle" }, { label: "Celebrate", value: "celebrating" }] } }, actions: [{ type: "familiar.speak", message: { config: "message" } }, { type: "familiar.react", reaction: { config: "reaction" } }] }));
   await runtime(store, scheduler, petApi).start();
   scheduler.fire(0);
   await Promise.resolve();
@@ -207,7 +207,7 @@ await scenario("config speak and reaction refs execute", async ({ store, schedul
 });
 
 await scenario("invalid persisted config refs mark broken without api call", async ({ store, scheduler, petApi }) => {
-  addPlugin(store, { config: { message: 42 } }, manifest({ configSchema: { message: { type: "text", default: "Stretch" } }, actions: [{ type: "pet.speak", message: { config: "message" } }] }));
+  addPlugin(store, { config: { message: 42 } }, manifest({ configSchema: { message: { type: "text", default: "Stretch" } }, actions: [{ type: "familiar.speak", message: { config: "message" } }] }));
   await runtime(store, scheduler, petApi).start();
   assert.match(store.getRecord("plug")?.brokenReason ?? "", /invalid/);
   assert.equal(scheduler.activeCount(), 0);
@@ -215,13 +215,13 @@ await scenario("invalid persisted config refs mark broken without api call", asy
 });
 
 await scenario("final config message and reaction validation applies", async ({ store }) => {
-  addPlugin(store, { config: { message: "https://example.test" } }, manifest({ configSchema: { message: { type: "text", default: "Stretch" } }, actions: [{ type: "pet.speak", message: { config: "message" } }] }));
+  addPlugin(store, { config: { message: "https://example.test" } }, manifest({ configSchema: { message: { type: "text", default: "Stretch" } }, actions: [{ type: "familiar.speak", message: { config: "message" } }] }));
   await runtime(store, new FakeScheduler()).start();
   assert.match(store.getRecord("plug")?.brokenReason ?? "", /URL/);
 });
 
 await scenario("unapproved permission broken", async ({ store, scheduler }) => {
-  addPlugin(store, { approvedPermissions: ["timer"] }, manifest({ permissions: ["timer", "pet:speak"] }));
+  addPlugin(store, { approvedPermissions: ["timer"] }, manifest({ permissions: ["timer", "familiar:speak"] }));
   await runtime(store, scheduler).start();
   assert.match(store.getRecord("plug")?.brokenReason ?? "", /not approved/);
   assert.equal(scheduler.activeCount(), 0);
@@ -238,10 +238,10 @@ await scenario("invalid manifest and id-version mismatch broken", async ({ root,
 });
 
 await scenario("invalid reaction and message broken", async ({ store }) => {
-  addPlugin(store, {}, manifest({ permissions: ["timer", "pet:reaction"], actions: [{ type: "pet.react", reaction: "celebrate" }] }));
-  addPlugin(store, { id: "bad-message" }, manifest({ id: "bad-message", actions: [{ type: "pet.speak", message: "https://example.test" }] }));
+  addPlugin(store, {}, manifest({ permissions: ["timer", "familiar:reaction"], actions: [{ type: "familiar.react", reaction: "celebrate" }] }));
+  addPlugin(store, { id: "bad-message" }, manifest({ id: "bad-message", actions: [{ type: "familiar.speak", message: "https://example.test" }] }));
   await runtime(store, new FakeScheduler()).start();
-  assert.match(store.getRecord("plug")?.brokenReason ?? "", /Invalid pet reaction/);
+  assert.match(store.getRecord("plug")?.brokenReason ?? "", /Invalid familiar reaction/);
   assert.match(store.getRecord("bad-message")?.brokenReason ?? "", /URL/);
 });
 
@@ -282,7 +282,7 @@ await scenario("path outside install/root and oversized rejected", async ({ root
   assert.match(store.getRecord("plug")?.brokenReason ?? "", /outside allowed/);
   const install = join(root, "oversized");
   mkdirSync(install, { recursive: true });
-  const path = join(install, OPENPETS_PLUGIN_MANIFEST_FILENAME);
+  const path = join(install, FAMILIAROS_PLUGIN_MANIFEST_FILENAME);
   writeFileSync(path, JSON.stringify(manifest()) + " ".repeat(200), "utf8");
   store.upsertRecord(record({ id: "oversized", installPath: install, manifestPath: path }));
   await new PluginRuntime({ stateStore: store, petApi: new FakePetApi(), scheduler: new FakeScheduler(), allowedPluginRoots: [root], maxManifestBytes: 100 }).start();
@@ -302,7 +302,7 @@ await scenario("manifest outside install rejected", async ({ root, store }) => {
 await scenario("root-level evil manifest filename rejected", async ({ root, store }) => {
   const install = join(root, "evil-name");
   mkdirSync(install, { recursive: true });
-  const manifestPath = join(install, `evil-${OPENPETS_PLUGIN_MANIFEST_FILENAME}`);
+  const manifestPath = join(install, `evil-${FAMILIAROS_PLUGIN_MANIFEST_FILENAME}`);
   writeFileSync(manifestPath, JSON.stringify(manifest()), "utf8");
   store.upsertRecord(record({ installPath: install, manifestPath }));
   await runtime(store, new FakeScheduler()).start();
@@ -342,20 +342,20 @@ await scenario("timer handles do not accumulate after repeated fires", async ({
 
 await scenario("brokenReason clears and bad plugin not blocking good", async ({ store, scheduler }) => {
   addPlugin(store, { brokenReason: "old" });
-  addPlugin(store, { id: "bad" }, manifest({ id: "bad", permissions: ["timer", "pet:reaction"], actions: [{ type: "pet.react", reaction: "celebrate" }] }));
+  addPlugin(store, { id: "bad" }, manifest({ id: "bad", permissions: ["timer", "familiar:reaction"], actions: [{ type: "familiar.react", reaction: "celebrate" }] }));
   await runtime(store, scheduler).start();
   assert.equal(store.getRecord("plug")?.brokenReason, undefined);
-  assert.match(store.getRecord("bad")?.brokenReason ?? "", /Invalid pet reaction/);
+  assert.match(store.getRecord("bad")?.brokenReason ?? "", /Invalid familiar reaction/);
   assert.equal(scheduler.activeCount(), 1);
 });
 
-await scenario("pet api failure marks broken", async ({ store, scheduler, petApi }) => {
+await scenario("familiar api failure marks broken", async ({ store, scheduler, petApi }) => {
   addPlugin(store);
   petApi.fail = true;
   await runtime(store, scheduler, petApi).start();
   scheduler.fire(0);
   await Promise.resolve();
-  assert.match(store.getRecord("plug")?.brokenReason ?? "", /pet api failed/);
+  assert.match(store.getRecord("plug")?.brokenReason ?? "", /familiar api failed/);
   assert.equal(store.getRecord("plug")?.enabled, true);
 });
 
@@ -385,7 +385,7 @@ await scenario("stale reload cannot resurrect stopped runtime", async ({ store,
 });
 
 await scenario("stale async action failure does not break new generation", async ({ store, scheduler, petApi }) => {
-  addPlugin(store, {}, manifest({ permissions: ["timer", "pet:reaction"], actions: [{ type: "pet.react", reaction: "celebrating" }] }));
+  addPlugin(store, {}, manifest({ permissions: ["timer", "familiar:reaction"], actions: [{ type: "familiar.react", reaction: "celebrating" }] }));
   petApi.deferredFailure = { reject() {} };
   const rt = runtime(store, scheduler, petApi);
   await rt.start();
@@ -419,33 +419,33 @@ function addPlugin(store: PluginStateStore, patch: Partial<PluginStateRecord> =
   const id = patch.id ?? "plug";
   const installPath = patch.installPath ?? join(root, id);
   const manifestPath = patch.manifestPath ?? writeManifest(installPath, data);
-  if (isJsManifest(data)) writeFileSync(join(installPath, data.entry), "OpenPetsPlugin.register();", "utf8");
+  if (isJsManifest(data)) writeFileSync(join(installPath, data.entry), "FamiliarOSPlugin.register();", "utf8");
   const rec = record({ ...patch, id, installPath, manifestPath });
   store.upsertRecord(rec);
   return rec;
 }
 
 function record(patch: Partial<PluginStateRecord> = {}): PluginStateRecord {
-  return { id: patch.id ?? "plug", version: patch.version ?? "1.0.0", manifestPath: patch.manifestPath ?? "", installPath: patch.installPath ?? "", source: patch.source ?? "local", manifestVersion: patch.manifestVersion, runtime: patch.runtime, sdkVersion: patch.sdkVersion, enabled: patch.enabled ?? true, approvedPermissions: patch.approvedPermissions ?? ["timer", "pet:speak", "pet:reaction"], approvedNetworkHosts: patch.approvedNetworkHosts, config: patch.config ?? {}, brokenReason: patch.brokenReason, catalogDisabled: patch.catalogDisabled };
+  return { id: patch.id ?? "plug", version: patch.version ?? "1.0.0", manifestPath: patch.manifestPath ?? "", installPath: patch.installPath ?? "", source: patch.source ?? "local", manifestVersion: patch.manifestVersion, runtime: patch.runtime, sdkVersion: patch.sdkVersion, enabled: patch.enabled ?? true, approvedPermissions: patch.approvedPermissions ?? ["timer", "familiar:speak", "familiar:reaction"], approvedNetworkHosts: patch.approvedNetworkHosts, config: patch.config ?? {}, brokenReason: patch.brokenReason, catalogDisabled: patch.catalogDisabled };
 }
 
-function manifest(patch: Partial<OpenPetsDeclarativePluginManifest> & { everyMinutes?: OpenPetsDeclarativePluginManifest["triggers"][number]["everyMinutes"]; actions?: OpenPetsDeclarativePluginManifest["triggers"][number]["actions"] } = {}): OpenPetsDeclarativePluginManifest {
-  return { manifestVersion: 1, id: patch.id ?? "plug", name: "Plug", version: patch.version ?? "1.0.0", runtime: "declarative", permissions: patch.permissions ?? ["timer", "pet:speak"], configSchema: patch.configSchema, triggers: [{ on: "timer", everyMinutes: patch.everyMinutes ?? 5, actions: patch.actions ?? [{ type: "pet.speak", message: "Stretch" }] }] };
+function manifest(patch: Partial<FamiliarOSDeclarativePluginManifest> & { everyMinutes?: FamiliarOSDeclarativePluginManifest["triggers"][number]["everyMinutes"]; actions?: FamiliarOSDeclarativePluginManifest["triggers"][number]["actions"] } = {}): FamiliarOSDeclarativePluginManifest {
+  return { manifestVersion: 1, id: patch.id ?? "plug", name: "Plug", version: patch.version ?? "1.0.0", runtime: "declarative", permissions: patch.permissions ?? ["timer", "familiar:speak"], configSchema: patch.configSchema, triggers: [{ on: "timer", everyMinutes: patch.everyMinutes ?? 5, actions: patch.actions ?? [{ type: "familiar.speak", message: "Stretch" }] }] };
 }
 
-function jsManifest(patch: Partial<OpenPetsJavascriptPluginManifest> = {}): OpenPetsJavascriptPluginManifest {
+function jsManifest(patch: Partial<FamiliarOSJavascriptPluginManifest> = {}): FamiliarOSJavascriptPluginManifest {
   return { manifestVersion: 2, id: patch.id ?? "plug", name: "Plug", version: patch.version ?? "1.0.0", runtime: "javascript", sdkVersion: patch.sdkVersion ?? "1.0.0", entry: patch.entry ?? "index.js", permissions: patch.permissions ?? [], network: patch.network };
 }
 
-function isJsManifest(data: unknown): data is OpenPetsJavascriptPluginManifest {
+function isJsManifest(data: unknown): data is FamiliarOSJavascriptPluginManifest {
   return typeof data === "object" && data !== null && "runtime" in data && data.runtime === "javascript" && "entry" in data && typeof data.entry === "string";
 }
 
 function writeManifest(dir: string, data: unknown): string {
   mkdirSync(dir, { recursive: true });
-  const path = join(dir, OPENPETS_PLUGIN_MANIFEST_FILENAME);
+  const path = join(dir, FAMILIAROS_PLUGIN_MANIFEST_FILENAME);
   writeFileSync(path, JSON.stringify(data), "utf8");
   return path;
 }
 
-function tempDir(): string { return mkdtempSync(join(tmpdir(), "openpets-plugin-runtime-")); }
+function tempDir(): string { return mkdtempSync(join(tmpdir(), "familiaros-plugin-runtime-")); }
diff --git a/apps/desktop/tests/plugin-sdk-bridge.test.ts b/apps/desktop/tests/plugin-sdk-bridge.test.ts
index eae4f5f1..584a04f3 100644
--- a/apps/desktop/tests/plugin-sdk-bridge.test.ts
+++ b/apps/desktop/tests/plugin-sdk-bridge.test.ts
@@ -6,7 +6,7 @@ import { join } from "node:path";
 import { PluginSdkBridge, type PluginHostCapabilities } from "../src/plugin-sdk-bridge.js";
 import { pluginSdkQuotas } from "../src/plugin-sdk-quotas.js";
 import { PluginStateStore, type PluginStateRecord } from "../src/plugin-state.js";
-import type { OpenPetsJavascriptPluginManifest } from "../src/plugin-manifest.js";
+import type { FamiliarOSJavascriptPluginManifest } from "../src/plugin-manifest.js";
 import { sanitizePluginDiagnosticsFields } from "../src/plugin-diagnostics.js";
 
 await scenario("storage.subscribe receives set value and delete as undefined", async ({ api }) => {
@@ -84,17 +84,17 @@ await scenario("commands accept declared icon asset refs and reject raw svg stri
   );
 });
 
-await scenario("pet.react validates silent reaction options", async ({ api }) => {
-  await api.pet.react("waving", { showMessage: false });
-  await assert.rejects(() => api.pet.react("waving", { showMessage: "no" }), /Invalid pet reaction showMessage option\./);
-  await assert.rejects(() => api.pet.react("waving", { showMessage: false, extra: true }), /Invalid pet reaction option\./);
+await scenario("familiar.react validates silent reaction options", async ({ api }) => {
+  await api.familiar.react("waving", { showMessage: false });
+  await assert.rejects(() => api.familiar.react("waving", { showMessage: "no" }), /Invalid familiar reaction showMessage option\./);
+  await assert.rejects(() => api.familiar.react("waving", { showMessage: false, extra: true }), /Invalid familiar reaction option\./);
 });
 
 await scenario("hud bubble spec validation is enforced", async ({ store, bridge }) => {
   const record = store.getRecord("plug")!;
   const updatedRecord = {
     ...record,
-    approvedPermissions: [...record.approvedPermissions, "pet:pin" as const],
+    approvedPermissions: [...record.approvedPermissions, "familiar:pin" as const],
   };
   store.upsertRecord(updatedRecord);
   
@@ -188,21 +188,21 @@ type ScenarioContext = {
 };
 
 async function scenario(name: string, run: (context: ScenarioContext) => Promise<void> | void): Promise<void> {
-  const root = mkdtempSync(join(tmpdir(), "openpets-plugin-sdk-"));
+  const root = mkdtempSync(join(tmpdir(), "familiaros-plugin-sdk-"));
   try {
     const store = new PluginStateStore({ statePath: join(root, "state.json") });
     store.initialize();
     const record: PluginStateRecord = {
       id: "plug",
       version: "1.0.0",
-      manifestPath: join(root, "openpets.plugin.json"),
+      manifestPath: join(root, "familiaros.plugin.json"),
       installPath: root,
       source: "local",
       manifestVersion: 3,
       runtime: "javascript",
       sdkVersion: "3.0.0",
       enabled: true,
-      approvedPermissions: ["commands", "events", "storage", "pet:reaction"],
+      approvedPermissions: ["commands", "events", "storage", "familiar:reaction"],
       config: {},
     };
     store.upsertRecord(record);
@@ -227,9 +227,9 @@ function createTestCapabilities(): TestCapabilities {
     bubbles: { show: async () => ({ id: "bubble", update: async () => undefined, dismiss: async () => undefined, pin: async () => undefined, unpin: async () => undefined }) },
     audio: { play: async () => undefined, importUserSound: async (_pluginId, _fileId, opts) => ({ kind: "user-sound", id: "0".repeat(32), name: opts?.name }), forgetUserSound: async () => undefined, stop: async () => undefined },
     events: { subscribed: [], subscribe(event) { this.subscribed.push(event); return () => undefined; } },
-    pets: {
+    familiars: {
       list: () => [],
-      spawn: async () => "pet",
+      spawn: async () => "familiar",
       close: async () => undefined,
       show: async () => undefined,
       hide: async () => undefined,
@@ -260,7 +260,7 @@ function createTestCapabilities(): TestCapabilities {
   };
 }
 
-function manifest(): OpenPetsJavascriptPluginManifest {
+function manifest(): FamiliarOSJavascriptPluginManifest {
   return {
     manifestVersion: 3,
     id: "plug",
diff --git a/apps/desktop/tests/plugin-service.test.ts b/apps/desktop/tests/plugin-service.test.ts
index 22bd7982..039ae2d6 100644
--- a/apps/desktop/tests/plugin-service.test.ts
+++ b/apps/desktop/tests/plugin-service.test.ts
@@ -4,7 +4,7 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync,
 import { tmpdir } from "node:os";
 import { basename, join } from "node:path";
 
-import { OPENPETS_PLUGIN_MANIFEST_FILENAME, type OpenPetsDeclarativePluginManifest } from "../src/plugin-manifest.js";
+import { FAMILIAROS_PLUGIN_MANIFEST_FILENAME, type FamiliarOSDeclarativePluginManifest } from "../src/plugin-manifest.js";
 import { PluginService, executeDefaultPetPluginCommand, getDefaultPetPluginCommands, setPluginServiceForTests, stopPluginService } from "../src/plugin-service.js";
 import { PluginStateStore, type PluginStateRecord } from "../src/plugin-state.js";
 
@@ -55,11 +55,11 @@ await scenario("snapshot omits paths and includes manifest config", async ({ ser
 });
 
 await scenario("snapshot exposes declared v3 svg icon data url", async ({ root, service, store }) => {
-  const installPath = join(root, "openpets.reminders");
+  const installPath = join(root, "familiaros.reminders");
   mkdirSync(join(installPath, "assets"), { recursive: true });
   writeFileSync(join(installPath, "index.js"), "export default {};", "utf8");
   writeFileSync(join(installPath, "assets", "reminders.svg"), "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"/></svg>", "utf8");
-  addPlugin(store, { id: "openpets.reminders", version: "1.0.0", installPath }, { manifestVersion: 3, id: "openpets.reminders", name: "Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "3.0.0", entry: "index.js", icon: "bell", permissions: [], assets: { icons: { reminders: "assets/reminders.svg" } } });
+  addPlugin(store, { id: "familiaros.reminders", version: "1.0.0", installPath }, { manifestVersion: 3, id: "familiaros.reminders", name: "Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "3.0.0", entry: "index.js", icon: "bell", permissions: [], assets: { icons: { reminders: "assets/reminders.svg" } } });
   const snapshot = await service.getSnapshot();
   assert.match(snapshot.plugins[0].iconDataUrl ?? "", /^data:image\/svg\+xml;base64,/);
   assert.equal(Buffer.from((snapshot.plugins[0].iconDataUrl ?? "").split(",")[1] ?? "", "base64").toString("utf8").includes("<svg"), true);
@@ -72,7 +72,7 @@ await scenario("invalid manifest appears safe broken", async ({ service, store }
 });
 
 await scenario("missing manifest does not leak absolute paths", async ({ service, store, root }) => {
-  const missingPath = join(root, "missing", OPENPETS_PLUGIN_MANIFEST_FILENAME);
+  const missingPath = join(root, "missing", FAMILIAROS_PLUGIN_MANIFEST_FILENAME);
   store.upsertRecord({ id: "missing", version: "1.0.0", manifestPath: missingPath, installPath: join(root, "missing"), source: "local", enabled: true, approvedPermissions: ["timer"], config: {} });
   const snapshot = await service.getSnapshot();
   const reason = snapshot.plugins[0].brokenReason ?? "";
@@ -81,7 +81,7 @@ await scenario("missing manifest does not leak absolute paths", async ({ service
 });
 
 await scenario("stored path-like broken reason is sanitized", async ({ service, store, root }) => {
-  addPlugin(store, { brokenReason: `ENOENT: no such file or directory, open '${join(root, "plug", OPENPETS_PLUGIN_MANIFEST_FILENAME)}'` });
+  addPlugin(store, { brokenReason: `ENOENT: no such file or directory, open '${join(root, "plug", FAMILIAROS_PLUGIN_MANIFEST_FILENAME)}'` });
   const snapshot = await service.getSnapshot();
   const reason = snapshot.plugins[0].brokenReason ?? "";
   assert.equal(reason, "Plugin needs attention. Check logs for details.");
@@ -192,14 +192,14 @@ await scenario("stop cancels runtime", async ({ service, runtime }) => {
 });
 
 await localScenario("loadLocal snapshots manifest disabled", async ({ service, store, source }) => {
-  writeManifest(source, manifest({ id: "local-plug", permissions: ["timer", "pet:speak"] }));
+  writeManifest(source, manifest({ id: "local-plug", permissions: ["timer", "familiar:speak"] }));
   const result = await service.loadLocal();
   assert.equal(result.ok, true);
   const record = store.getRecord("local-plug");
   assert.equal(record?.enabled, false);
   assert.equal(record?.source, "local");
-  assert.deepEqual(record?.approvedPermissions, ["pet:speak", "timer"]);
-  assert.equal(existsSync(join(record?.installPath ?? "", OPENPETS_PLUGIN_MANIFEST_FILENAME)), true);
+  assert.deepEqual(record?.approvedPermissions, ["familiar:speak", "timer"]);
+  assert.equal(existsSync(join(record?.installPath ?? "", FAMILIAROS_PLUGIN_MANIFEST_FILENAME)), true);
   assert.equal("installPath" in result.snapshot.plugins[0], false);
 });
 
@@ -216,14 +216,14 @@ await localScenario("loadLocal permission cancel does not install", async ({ ser
   const result = await service.loadLocal();
   assert.equal(result.ok, true);
   assert.deepEqual(store.listRecords(), []);
-  assert.equal(existsSync(join(service["__userData"] as string, "plugins-dev", "cancel-plug", OPENPETS_PLUGIN_MANIFEST_FILENAME)), false);
+  assert.equal(existsSync(join(service["__userData"] as string, "plugins-dev", "cancel-plug", FAMILIAROS_PLUGIN_MANIFEST_FILENAME)), false);
 });
 
 await localScenario("loadLocal permission cancel preserves previous snapshot", async ({ service, store, source, userData }) => {
-  writeManifest(source, manifest({ id: "keep-plug", version: "2.0.0", permissions: ["timer", "pet:speak", "pet:reaction"], triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.react", reaction: "celebrating" }] }] }));
+  writeManifest(source, manifest({ id: "keep-plug", version: "2.0.0", permissions: ["timer", "familiar:speak", "familiar:reaction"], triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.react", reaction: "celebrating" }] }] }));
   const install = join(userData, "plugins-dev", "keep-plug");
-  const oldManifestPath = writeManifest(install, manifest({ id: "keep-plug", version: "1.0.0", permissions: ["timer", "pet:speak"] }));
-  store.upsertRecord({ id: "keep-plug", version: "1.0.0", installPath: install, manifestPath: oldManifestPath, source: "local", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  const oldManifestPath = writeManifest(install, manifest({ id: "keep-plug", version: "1.0.0", permissions: ["timer", "familiar:speak"] }));
+  store.upsertRecord({ id: "keep-plug", version: "1.0.0", installPath: install, manifestPath: oldManifestPath, source: "local", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   service["__denyPermissions"] = true;
   const result = await service.loadLocal();
   assert.equal(result.ok, true);
@@ -251,16 +251,16 @@ await localScenario("loadLocal rejects source symlink", async ({ service, source
 await localScenario("loadLocal rejects manifest symlink", async ({ service, source, root }) => {
   const real = join(root, "real-manifest.json");
   writeFileSync(real, JSON.stringify(manifest({ id: "symlink-manifest" })), "utf8");
-  symlinkSync(real, join(source, OPENPETS_PLUGIN_MANIFEST_FILENAME));
+  symlinkSync(real, join(source, FAMILIAROS_PLUGIN_MANIFEST_FILENAME));
   const result = await service.loadLocal();
   assert.equal(result.ok, false);
 });
 
 await localScenario("loadLocal reload preserves enabled for subset permissions", async ({ service, store, runtime, source, userData }) => {
-  writeManifest(source, manifest({ id: "reload-plug", version: "2.0.0", permissions: ["timer", "pet:speak"] }));
+  writeManifest(source, manifest({ id: "reload-plug", version: "2.0.0", permissions: ["timer", "familiar:speak"] }));
   const existingInstall = join(userData, "plugins-dev", "reload-plug");
-  const existingManifest = writeManifest(existingInstall, manifest({ id: "reload-plug", permissions: ["timer", "pet:speak"] }));
-  store.upsertRecord({ id: "reload-plug", version: "1.0.0", installPath: existingInstall, manifestPath: existingManifest, source: "local", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  const existingManifest = writeManifest(existingInstall, manifest({ id: "reload-plug", permissions: ["timer", "familiar:speak"] }));
+  store.upsertRecord({ id: "reload-plug", version: "1.0.0", installPath: existingInstall, manifestPath: existingManifest, source: "local", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const result = await service.loadLocal();
   assert.equal(result.ok, true);
   assert.equal(store.getRecord("reload-plug")?.enabled, true);
@@ -272,11 +272,11 @@ await localScenario("loadLocal rejects catalog collision", async ({ service, sto
   writeManifest(source, manifest({ id: "catalog-plug" }));
   const install = join(userData, "plugins", "catalog-plug");
   const manifestPath = writeManifest(install, manifest({ id: "catalog-plug" }));
-  store.upsertRecord({ id: "catalog-plug", version: "1.0.0", installPath: install, manifestPath, source: "catalog", enabled: false, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  store.upsertRecord({ id: "catalog-plug", version: "1.0.0", installPath: install, manifestPath, source: "catalog", enabled: false, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const result = await service.loadLocal();
   assert.equal(result.ok, false);
   assert.match(result.error, /catalog plugin/);
-  assert.equal(existsSync(join(userData, "plugins-dev", "catalog-plug", OPENPETS_PLUGIN_MANIFEST_FILENAME)), false);
+  assert.equal(existsSync(join(userData, "plugins-dev", "catalog-plug", FAMILIAROS_PLUGIN_MANIFEST_FILENAME)), false);
 });
 
 await localScenario("loadLocal rejects destination symlink before write", async ({ service, source, userData, root }) => {
@@ -286,18 +286,18 @@ await localScenario("loadLocal rejects destination symlink before write", async
   symlinkSync(outside, join(userData, "plugins-dev", "dest-link"), "dir");
   const result = await service.loadLocal();
   assert.equal(result.ok, false);
-  assert.equal(existsSync(join(outside, OPENPETS_PLUGIN_MANIFEST_FILENAME)), false);
+  assert.equal(existsSync(join(outside, FAMILIAROS_PLUGIN_MANIFEST_FILENAME)), false);
 });
 
 await localScenario("loadLocal permission change disables", async ({ service, store, source, userData }) => {
-  writeManifest(source, manifest({ id: "perm-plug", permissions: ["timer", "pet:speak", "pet:reaction"], triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "pet.react", reaction: "celebrating" }] }] }));
+  writeManifest(source, manifest({ id: "perm-plug", permissions: ["timer", "familiar:speak", "familiar:reaction"], triggers: [{ on: "timer", everyMinutes: 5, actions: [{ type: "familiar.react", reaction: "celebrating" }] }] }));
   const install = join(userData, "plugins-dev", "perm-plug");
-  const manifestPath = writeManifest(install, manifest({ id: "perm-plug", permissions: ["timer", "pet:speak"] }));
-  store.upsertRecord({ id: "perm-plug", version: "1.0.0", installPath: install, manifestPath, source: "local", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  const manifestPath = writeManifest(install, manifest({ id: "perm-plug", permissions: ["timer", "familiar:speak"] }));
+  store.upsertRecord({ id: "perm-plug", version: "1.0.0", installPath: install, manifestPath, source: "local", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const result = await service.loadLocal();
   assert.equal(result.ok, true);
   assert.equal(store.getRecord("perm-plug")?.enabled, false);
-  assert.deepEqual(store.getRecord("perm-plug")?.approvedPermissions, ["pet:speak", "pet:reaction", "timer"]);
+  assert.deepEqual(store.getRecord("perm-plug")?.approvedPermissions, ["familiar:speak", "familiar:reaction", "timer"]);
   assert.deepEqual(service["__runtimeReloads"], ["perm-plug"]);
 });
 
@@ -314,17 +314,17 @@ await localScenario("loadLocal copies only manifest", async ({ service, source,
   const result = await service.loadLocal();
   assert.equal(result.ok, true);
   const install = store.getRecord("only-manifest")?.installPath ?? join(userData, "plugins-dev", "only-manifest");
-  assert.equal(existsSync(join(install, OPENPETS_PLUGIN_MANIFEST_FILENAME)), true);
+  assert.equal(existsSync(join(install, FAMILIAROS_PLUGIN_MANIFEST_FILENAME)), true);
   assert.equal(existsSync(join(install, "extra.txt")), false);
 });
 
 await localScenario("loadLocal snapshots javascript entry", async ({ service, source, store, userData }) => {
-  writeManifest(source, { manifestVersion: 2, id: "js-local", name: "JS Local", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.mjs", permissions: ["pet:speak"] });
+  writeManifest(source, { manifestVersion: 2, id: "js-local", name: "JS Local", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.mjs", permissions: ["familiar:speak"] });
   writeFileSync(join(source, "index.mjs"), "export default {};\n", "utf8");
   const result = await service.loadLocal();
   assert.equal(result.ok, true);
   const install = store.getRecord("js-local")?.installPath ?? join(userData, "plugins-dev", "js-local");
-  assert.equal(existsSync(join(install, OPENPETS_PLUGIN_MANIFEST_FILENAME)), true);
+  assert.equal(existsSync(join(install, FAMILIAROS_PLUGIN_MANIFEST_FILENAME)), true);
   assert.equal(readFileSync(join(install, "index.mjs"), "utf8"), "export default {};\n");
 });
 
@@ -338,12 +338,12 @@ await localScenario("loadLocal snapshots v3 locale catalogs for translated UI",
     runtime: "javascript",
     sdkVersion: "3.0.0",
     entry: "index.js",
-    permissions: ["pet:speak"],
+    permissions: ["familiar:speak"],
     configSchema: {
       enabled: { type: "boolean", default: true, label: "$t:config.enabled.label", description: "$t:config.enabled.description" },
     },
   });
-  writeFileSync(join(source, "index.js"), "OpenPetsPlugin.register({ start() {} });\n", "utf8");
+  writeFileSync(join(source, "index.js"), "FamiliarOSPlugin.register({ start() {} });\n", "utf8");
   mkdirSync(join(source, "locales"), { recursive: true });
   writeFileSync(join(source, "locales", "en.json"), JSON.stringify({
     "plugin.name": "Translated Plugin",
@@ -376,66 +376,66 @@ await localScenario("loadLocal snapshots v3 locale catalogs for translated UI",
 
 await localScenario("bundled seeding copies manifest and preserves user choices", async ({ userData, root, store }) => {
   const official = join(root, "official");
-  const source = join(official, "openpets.reminders");
-  writeManifest(source, { manifestVersion: 2, id: "openpets.reminders", name: "Quick Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["pet:speak"], configSchema: { minutes: { type: "number", default: 30 } } });
-  writeFileSync(join(source, "index.js"), "OpenPetsPlugin.register({ start() {} });\n", "utf8");
+  const source = join(official, "familiaros.reminders");
+  writeManifest(source, { manifestVersion: 2, id: "familiaros.reminders", name: "Quick Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["familiar:speak"], configSchema: { minutes: { type: "number", default: 30 } } });
+  writeFileSync(join(source, "index.js"), "FamiliarOSPlugin.register({ start() {} });\n", "utf8");
   const service = new PluginService({ userDataPath: userData, stateStore: store, runtime: new FakeRuntime() as never, bundledPluginSourceDirs: [official] });
   await service.start();
-  let record = store.getRecord("openpets.reminders");
+  let record = store.getRecord("familiaros.reminders");
   assert.equal(record?.source, "catalog");
   assert.equal(record?.bundled, true);
   assert.equal(record?.enabled, true);
-  assert.equal(readFileSync(join(record?.installPath ?? "", "index.js"), "utf8"), "OpenPetsPlugin.register({ start() {} });\n");
-  store.replaceConfig("openpets.reminders", { minutes: 45 });
-  store.setEnabled("openpets.reminders", false);
-  writeManifest(source, { manifestVersion: 2, id: "openpets.reminders", name: "Quick Reminders", version: "2.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["pet:speak", "pet:reaction"] });
+  assert.equal(readFileSync(join(record?.installPath ?? "", "index.js"), "utf8"), "FamiliarOSPlugin.register({ start() {} });\n");
+  store.replaceConfig("familiaros.reminders", { minutes: 45 });
+  store.setEnabled("familiaros.reminders", false);
+  writeManifest(source, { manifestVersion: 2, id: "familiaros.reminders", name: "Quick Reminders", version: "2.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["familiar:speak", "familiar:reaction"] });
   await service.seedBundledPlugins();
-  record = store.getRecord("openpets.reminders");
+  record = store.getRecord("familiaros.reminders");
   assert.equal(record?.version, "2.0.0");
   assert.equal(record?.enabled, false);
   assert.deepEqual(record?.config, { minutes: 45 });
-  assert.deepEqual(record?.approvedPermissions, ["pet:speak", "pet:reaction"]);
+  assert.deepEqual(record?.approvedPermissions, ["familiar:speak", "familiar:reaction"]);
 });
 
 await localScenario("bundled seeding prunes stale ids and blocks uninstall update", async ({ userData, root, store }) => {
-  const oldInstall = join(userData, "plugins", "openpets.pomodoro");
-  const oldManifest = writeManifest(oldInstall, manifest({ id: "openpets.pomodoro" }));
-  store.upsertRecord({ id: "openpets.pomodoro", version: "1.0.0", installPath: oldInstall, manifestPath: oldManifest, source: "catalog", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  const oldInstall = join(userData, "plugins", "familiaros.pomodoro");
+  const oldManifest = writeManifest(oldInstall, manifest({ id: "familiaros.pomodoro" }));
+  store.upsertRecord({ id: "familiaros.pomodoro", version: "1.0.0", installPath: oldInstall, manifestPath: oldManifest, source: "catalog", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const official = join(root, "official");
-  const source = join(official, "openpets.reminders");
-  writeManifest(source, { manifestVersion: 2, id: "openpets.reminders", name: "Quick Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["network"], network: { hosts: ["api.github.com"] } });
-  writeFileSync(join(source, "index.js"), "OpenPetsPlugin.register({ start() {} });\n", "utf8");
+  const source = join(official, "familiaros.reminders");
+  writeManifest(source, { manifestVersion: 2, id: "familiaros.reminders", name: "Quick Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["network"], network: { hosts: ["api.github.com"] } });
+  writeFileSync(join(source, "index.js"), "FamiliarOSPlugin.register({ start() {} });\n", "utf8");
   const service = new PluginService({ userDataPath: userData, stateStore: store, runtime: new FakeRuntime() as never, bundledPluginSourceDirs: [official] });
   await service.start();
-  assert.equal(store.getRecord("openpets.pomodoro"), undefined);
-  assert.equal(store.getRecord("openpets.reminders")?.enabled, true);
-  assert.deepEqual(store.getRecord("openpets.reminders")?.approvedNetworkHosts, ["api.github.com"]);
-  assert.equal((await service.uninstall("openpets.reminders")).ok, false);
-  const update = await service.updateCatalog("openpets.reminders");
+  assert.equal(store.getRecord("familiaros.pomodoro"), undefined);
+  assert.equal(store.getRecord("familiaros.reminders")?.enabled, true);
+  assert.deepEqual(store.getRecord("familiaros.reminders")?.approvedNetworkHosts, ["api.github.com"]);
+  assert.equal((await service.uninstall("familiaros.reminders")).ok, false);
+  const update = await service.updateCatalog("familiaros.reminders");
   assert.equal(update.ok, false);
   assert.match(update.error, /Bundled plugins update/);
 });
 
 await localScenario("bundled seeding prunes stale local old ids", async ({ userData, store }) => {
-  const oldInstall = join(userData, "plugins-dev", "openpets.daily-reminders");
-  const oldManifest = writeManifest(oldInstall, manifest({ id: "openpets.daily-reminders" }));
-  store.upsertRecord({ id: "openpets.daily-reminders", version: "1.0.0", installPath: oldInstall, manifestPath: oldManifest, source: "local", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  const oldInstall = join(userData, "plugins-dev", "familiaros.daily-reminders");
+  const oldManifest = writeManifest(oldInstall, manifest({ id: "familiaros.daily-reminders" }));
+  store.upsertRecord({ id: "familiaros.daily-reminders", version: "1.0.0", installPath: oldInstall, manifestPath: oldManifest, source: "local", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const service = new PluginService({ userDataPath: userData, stateStore: store, runtime: new FakeRuntime() as never, bundledPluginSourceDirs: [] });
   await service.seedBundledPlugins();
-  assert.equal(store.getRecord("openpets.daily-reminders"), undefined);
+  assert.equal(store.getRecord("familiaros.daily-reminders"), undefined);
   assert.equal(existsSync(oldInstall), false);
 });
 
 await localScenario("bundled stale prune refuses unsafe path", async ({ userData, root, store }) => {
   const outside = join(root, "outside-stale");
   mkdirSync(outside, { recursive: true });
-  const link = join(userData, "plugins", "openpets.pomodoro");
+  const link = join(userData, "plugins", "familiaros.pomodoro");
   symlinkSync(outside, link, "dir");
-  store.upsertRecord({ id: "openpets.pomodoro", version: "1.0.0", installPath: link, manifestPath: join(link, OPENPETS_PLUGIN_MANIFEST_FILENAME), source: "catalog", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  store.upsertRecord({ id: "familiaros.pomodoro", version: "1.0.0", installPath: link, manifestPath: join(link, FAMILIAROS_PLUGIN_MANIFEST_FILENAME), source: "catalog", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const runtime = new FakeRuntime();
   const service = new PluginService({ userDataPath: userData, stateStore: store, runtime: runtime as never, bundledPluginSourceDirs: [] });
   await service.seedBundledPlugins();
-  assert.equal(store.getRecord("openpets.pomodoro")?.id, "openpets.pomodoro");
+  assert.equal(store.getRecord("familiaros.pomodoro")?.id, "familiaros.pomodoro");
   assert.equal(existsSync(outside), true);
   assert.equal(runtime.logs.some((entry) => entry.message.includes("Refused to prune")), true);
 });
@@ -446,41 +446,41 @@ await localScenario("bundled seeding rejects plugins root symlink", async ({ use
   mkdirSync(outsideRoot, { recursive: true });
   symlinkSync(outsideRoot, join(userData, "plugins"), "dir");
   const official = join(root, "official");
-  const source = join(official, "openpets.reminders");
-  writeManifest(source, { manifestVersion: 2, id: "openpets.reminders", name: "Quick Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["pet:speak"] });
-  writeFileSync(join(source, "index.js"), "OpenPetsPlugin.register({ start() {} });\n", "utf8");
+  const source = join(official, "familiaros.reminders");
+  writeManifest(source, { manifestVersion: 2, id: "familiaros.reminders", name: "Quick Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["familiar:speak"] });
+  writeFileSync(join(source, "index.js"), "FamiliarOSPlugin.register({ start() {} });\n", "utf8");
   const runtime = new FakeRuntime();
   const service = new PluginService({ userDataPath: userData, stateStore: store, runtime: runtime as never, bundledPluginSourceDirs: [official] });
   await service.seedBundledPlugins();
-  assert.equal(store.getRecord("openpets.reminders"), undefined);
-  assert.equal(existsSync(join(outsideRoot, "openpets.reminders")), false);
+  assert.equal(store.getRecord("familiaros.reminders"), undefined);
+  assert.equal(existsSync(join(outsideRoot, "familiaros.reminders")), false);
   assert.equal(runtime.logs.some((entry) => entry.message.includes("Bundled plugin seed failed")), true);
 });
 
 await localScenario("start skips bundled seeding when disabled", async ({ userData, root, store }) => {
   const official = join(root, "official");
-  const source = join(official, "openpets.reminders");
-  writeManifest(source, { manifestVersion: 2, id: "openpets.reminders", name: "Quick Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["pet:speak"] });
-  writeFileSync(join(source, "index.js"), "OpenPetsPlugin.register({ start() {} });\n", "utf8");
+  const source = join(official, "familiaros.reminders");
+  writeManifest(source, { manifestVersion: 2, id: "familiaros.reminders", name: "Quick Reminders", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["familiar:speak"] });
+  writeFileSync(join(source, "index.js"), "FamiliarOSPlugin.register({ start() {} });\n", "utf8");
   const service = new PluginService({ userDataPath: userData, stateStore: store, runtime: new FakeRuntime() as never, bundledPluginSourceDirs: [official], seedBundledPlugins: false });
   await service.start();
-  assert.equal(store.getRecord("openpets.reminders"), undefined);
+  assert.equal(store.getRecord("familiaros.reminders"), undefined);
 });
 
 await scenario("catalog metadata ignores bundled records", async ({ userData, store, runtime }) => {
-  const install = join(userData, "plugins", "openpets.break-buddy");
-  const manifestPath = writeManifest(install, manifest({ id: "openpets.break-buddy" }));
-  store.upsertRecord({ id: "openpets.break-buddy", version: "1.0.0", installPath: install, manifestPath, source: "catalog", bundled: true, enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
-  const fetchImpl = async (): Promise<Response> => new Response(JSON.stringify({ version: 1, generatedAt: new Date().toISOString(), plugins: [{ ...catalogEntry("openpets.break-buddy", "1.0.0"), disabled: true, statusReason: "disabled" }] }), { status: 200 });
+  const install = join(userData, "plugins", "familiaros.break-buddy");
+  const manifestPath = writeManifest(install, manifest({ id: "familiaros.break-buddy" }));
+  store.upsertRecord({ id: "familiaros.break-buddy", version: "1.0.0", installPath: install, manifestPath, source: "catalog", bundled: true, enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
+  const fetchImpl = async (): Promise<Response> => new Response(JSON.stringify({ version: 1, generatedAt: new Date().toISOString(), plugins: [{ ...catalogEntry("familiaros.break-buddy", "1.0.0"), disabled: true, statusReason: "disabled" }] }), { status: 200 });
   const service = new PluginService({ userDataPath: userData, stateStore: store, runtime: runtime as never, fetchImpl });
   await service.getCatalogSnapshot(true);
-  assert.equal(store.getRecord("openpets.break-buddy")?.enabled, true);
-  assert.equal(store.getRecord("openpets.break-buddy")?.catalogDisabled, undefined);
+  assert.equal(store.getRecord("familiaros.break-buddy")?.enabled, true);
+  assert.equal(store.getRecord("familiaros.break-buddy")?.catalogDisabled, undefined);
 });
 
 await localScenario("loadLocalPath auto-approves explicit dev path", async ({ service, source, store }) => {
   writeManifest(source, { manifestVersion: 2, id: "dev-js", name: "Dev JS", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "index.js", permissions: ["network"], network: { hosts: ["api.github.com"] } });
-  writeFileSync(join(source, "index.js"), "OpenPetsPlugin.register({ start() {} });\n", "utf8");
+  writeFileSync(join(source, "index.js"), "FamiliarOSPlugin.register({ start() {} });\n", "utf8");
   service["__denyPermissions"] = true;
   const result = await service.loadLocalPath(source, { autoApprove: true });
   assert.equal(result.ok, true);
@@ -507,7 +507,7 @@ await localScenario("loadLocalRoots prunes stale plugins-dev records", async ({
   writeManifest(good, manifest({ id: "root-good" }));
   const staleInstall = join(userData, "plugins-dev", "old-sample");
   const staleManifest = writeManifest(staleInstall, manifest({ id: "old-sample" }));
-  store.upsertRecord({ id: "old-sample", version: "1.0.0", installPath: staleInstall, manifestPath: staleManifest, source: "local", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  store.upsertRecord({ id: "old-sample", version: "1.0.0", installPath: staleInstall, manifestPath: staleManifest, source: "local", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const results = await service.loadLocalRoots([pluginsRoot], { autoApprove: true, pruneStale: true });
   assert.equal(results.some((result) => result.ok && result.id === "root-good"), true);
   assert.equal(store.getRecord("root-good")?.source, "local");
@@ -516,7 +516,7 @@ await localScenario("loadLocalRoots prunes stale plugins-dev records", async ({
 });
 
 await localScenario("loadLocal rejects javascript nested entry symlink", async ({ service, source, root }) => {
-  writeManifest(source, { manifestVersion: 2, id: "js-entry-link", name: "JS Entry Link", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "nested/index.mjs", permissions: ["pet:speak"] });
+  writeManifest(source, { manifestVersion: 2, id: "js-entry-link", name: "JS Entry Link", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "nested/index.mjs", permissions: ["familiar:speak"] });
   mkdirSync(join(source, "nested"), { recursive: true });
   const real = join(root, "real-entry.mjs");
   writeFileSync(real, "export default {};\n", "utf8");
@@ -526,7 +526,7 @@ await localScenario("loadLocal rejects javascript nested entry symlink", async (
 });
 
 await localScenario("loadLocal rejects javascript symlinked entry parent", async ({ service, source, root }) => {
-  writeManifest(source, { manifestVersion: 2, id: "js-parent-link", name: "JS Parent Link", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "nested/index.mjs", permissions: ["pet:speak"] });
+  writeManifest(source, { manifestVersion: 2, id: "js-parent-link", name: "JS Parent Link", version: "1.0.0", runtime: "javascript", sdkVersion: "1.0.0", entry: "nested/index.mjs", permissions: ["familiar:speak"] });
   const realNested = join(root, "real-nested");
   mkdirSync(realNested, { recursive: true });
   writeFileSync(join(realNested, "index.mjs"), "export default {};\n", "utf8");
@@ -538,7 +538,7 @@ await localScenario("loadLocal rejects javascript symlinked entry parent", async
 await localScenario("uninstall removes state reloads and rejects symlink deletion", async ({ service, store, runtime, userData, root }) => {
   const install = join(userData, "plugins", "remove-plug");
   const manifestPath = writeManifest(install, manifest({ id: "remove-plug" }));
-  store.upsertRecord({ id: "remove-plug", version: "1.0.0", installPath: install, manifestPath, source: "catalog", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  store.upsertRecord({ id: "remove-plug", version: "1.0.0", installPath: install, manifestPath, source: "catalog", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const result = await service.uninstall("remove-plug");
   assert.equal(result.ok, true);
   assert.equal(store.getRecord("remove-plug"), undefined);
@@ -548,7 +548,7 @@ await localScenario("uninstall removes state reloads and rejects symlink deletio
   mkdirSync(outside, { recursive: true });
   const link = join(userData, "plugins", "link-plug");
   symlinkSync(outside, link, "dir");
-  store.upsertRecord({ id: "link-plug", version: "1.0.0", installPath: link, manifestPath: join(link, OPENPETS_PLUGIN_MANIFEST_FILENAME), source: "catalog", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  store.upsertRecord({ id: "link-plug", version: "1.0.0", installPath: link, manifestPath: join(link, FAMILIAROS_PLUGIN_MANIFEST_FILENAME), source: "catalog", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const rejected = await service.uninstall("link-plug");
   assert.equal(rejected.ok, false);
   assert.equal(store.getRecord("link-plug")?.id, "link-plug");
@@ -558,7 +558,7 @@ await localScenario("uninstall removes state reloads and rejects symlink deletio
   mkdirSync(rootOutside, { recursive: true });
   rmSync(join(userData, "plugins"), { recursive: true, force: true });
   symlinkSync(rootOutside, join(userData, "plugins"), "dir");
-  store.upsertRecord({ id: "root-link", version: "1.0.0", installPath: join(userData, "plugins", "root-link"), manifestPath: join(userData, "plugins", "root-link", OPENPETS_PLUGIN_MANIFEST_FILENAME), source: "catalog", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  store.upsertRecord({ id: "root-link", version: "1.0.0", installPath: join(userData, "plugins", "root-link"), manifestPath: join(userData, "plugins", "root-link", FAMILIAROS_PLUGIN_MANIFEST_FILENAME), source: "catalog", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
   const rootRejected = await service.uninstall("root-link");
   assert.equal(rootRejected.ok, false);
   assert.equal(store.getRecord("root-link")?.id, "root-link");
@@ -568,7 +568,7 @@ await catalogRollbackScenario("catalog update rolls back manifest if state write
   const oldManifest = manifest({ id: "rollback-plug", version: "1.0.0" });
   const install = join(userData, "plugins", "rollback-plug");
   const manifestPath = writeManifest(install, oldManifest);
-  store.upsertRecord({ id: "rollback-plug", version: "1.0.0", installPath: install, manifestPath, source: "catalog", enabled: true, approvedPermissions: ["timer", "pet:speak"], config: {} });
+  store.upsertRecord({ id: "rollback-plug", version: "1.0.0", installPath: install, manifestPath, source: "catalog", enabled: true, approvedPermissions: ["timer", "familiar:speak"], config: {} });
 
   store.failNextUpsert = true;
   const result = await service.updateCatalog("rollback-plug");
@@ -583,7 +583,7 @@ await catalogCompatibilityScenario("catalog filters and blocks incompatible plug
   assert.deepEqual(snapshot.plugins.map((plugin) => plugin.id), ["compatible-plug"]);
   const result = await service.installCatalog("future-plug");
   assert.equal(result.ok, false);
-  assert.match(result.error, /newer OpenPets/);
+  assert.match(result.error, /newer FamiliarOS/);
 });
 
 await scenario("disabled catalog returns no discover plugins", async ({ userData, store, runtime }) => {
@@ -624,9 +624,9 @@ await scenario("executeCommand returns plugin command validation errors", async
 console.error("Plugin service validation passed.");
 
 async function scenario(name: string, fn: (ctx: { root: string; userData: string; store: PluginStateStore; service: PluginService; runtime: FakeRuntime }) => Promise<void>): Promise<void> {
-  const root = mkdtempSync(join(tmpdir(), "openpets-plugin-service-root-"));
+  const root = mkdtempSync(join(tmpdir(), "familiaros-plugin-service-root-"));
   lastRoot = root;
-  const userData = mkdtempSync(join(tmpdir(), "openpets-plugin-service-user-"));
+  const userData = mkdtempSync(join(tmpdir(), "familiaros-plugin-service-user-"));
   const store = new PluginStateStore({ statePath: join(userData, "state.json") });
   store.initialize();
   const runtime = new FakeRuntime();
@@ -635,8 +635,8 @@ async function scenario(name: string, fn: (ctx: { root: string; userData: string
 }
 
 async function localScenario(name: string, fn: (ctx: { root: string; userData: string; source: string; store: PluginStateStore; service: PluginService & Record<string, unknown>; runtime: FakeRuntime }) => Promise<void>): Promise<void> {
-  const root = mkdtempSync(join(tmpdir(), "openpets-plugin-local-root-"));
-  const userData = mkdtempSync(join(tmpdir(), "openpets-plugin-local-user-"));
+  const root = mkdtempSync(join(tmpdir(), "familiaros-plugin-local-root-"));
+  const userData = mkdtempSync(join(tmpdir(), "familiaros-plugin-local-user-"));
   const source = join(root, "source");
   mkdirSync(source, { recursive: true });
   mkdirSync(join(userData, "plugins"), { recursive: true });
@@ -652,16 +652,16 @@ async function localScenario(name: string, fn: (ctx: { root: string; userData: s
 }
 
 async function catalogRollbackScenario(name: string, fn: (ctx: { root: string; userData: string; store: ThrowingStateStore; service: PluginService; runtime: FakeRuntime }) => Promise<void>): Promise<void> {
-  const root = mkdtempSync(join(tmpdir(), "openpets-plugin-catalog-root-"));
-  const userData = mkdtempSync(join(tmpdir(), "openpets-plugin-catalog-user-"));
+  const root = mkdtempSync(join(tmpdir(), "familiaros-plugin-catalog-root-"));
+  const userData = mkdtempSync(join(tmpdir(), "familiaros-plugin-catalog-user-"));
   mkdirSync(join(userData, "plugins"), { recursive: true });
   mkdirSync(join(userData, "plugins-dev"), { recursive: true });
   const store = new ThrowingStateStore({ statePath: join(userData, "state.json") });
   store.initialize();
   const runtime = new FakeRuntime();
   const nextManifest = manifest({ id: "rollback-plug", version: "2.0.0" });
-  const zip = makeZip(OPENPETS_PLUGIN_MANIFEST_FILENAME, Buffer.from(JSON.stringify(nextManifest), "utf8"));
-  const downloadUrl = "https://zip.openpets.dev/plugins/rollback-plug.zip";
+  const zip = makeZip(FAMILIAROS_PLUGIN_MANIFEST_FILENAME, Buffer.from(JSON.stringify(nextManifest), "utf8"));
+  const downloadUrl = "https://zip.familiaros.dev/plugins/rollback-plug.zip";
   const catalog = { version: 1, generatedAt: new Date().toISOString(), plugins: [{ id: nextManifest.id, name: nextManifest.name, version: nextManifest.version, description: "Rollback", runtime: "declarative", permissions: nextManifest.permissions, downloadUrl, sha256: createHash("sha256").update(zip).digest("hex") }] };
   const fetchImpl = async (url: string | URL | Request): Promise<Response> => {
     const value = String(url);
@@ -673,7 +673,7 @@ async function catalogRollbackScenario(name: string, fn: (ctx: { root: string; u
 }
 
 async function catalogCompatibilityScenario(name: string, fn: (ctx: { service: PluginService }) => Promise<void>): Promise<void> {
-  const userData = mkdtempSync(join(tmpdir(), "openpets-plugin-compat-user-"));
+  const userData = mkdtempSync(join(tmpdir(), "familiaros-plugin-compat-user-"));
   const store = new PluginStateStore({ statePath: join(userData, "state.json") });
   store.initialize();
   const catalog = { version: 1, generatedAt: new Date().toISOString(), plugins: [catalogEntry("compatible-plug", "1.0.0"), catalogEntry("future-plug", "9.0.0")] };
@@ -682,34 +682,34 @@ async function catalogCompatibilityScenario(name: string, fn: (ctx: { service: P
   try { await fn({ service }); } catch (error) { throw new Error(`${name}: ${error instanceof Error ? error.message : String(error)}`); }
 }
 
-function catalogEntry(id: string, minOpenPetsVersion: string): object {
-  return { id, name: id, version: "1.0.0", description: "Test", runtime: "declarative", permissions: ["timer", "pet:speak"], downloadUrl: `https://zip.openpets.dev/plugins/${id}.zip`, sha256: "0".repeat(64), minOpenPetsVersion };
+function catalogEntry(id: string, minFamiliarOSVersion: string): object {
+  return { id, name: id, version: "1.0.0", description: "Test", runtime: "declarative", permissions: ["timer", "familiar:speak"], downloadUrl: `https://zip.familiaros.dev/plugins/${id}.zip`, sha256: "0".repeat(64), minFamiliarOSVersion };
 }
 
 function addPlugin(store: PluginStateStore, patch: Partial<PluginStateRecord> = {}, data: unknown = manifest()): void {
   const id = patch.id ?? "plug";
   const installPath = patch.installPath ?? join(currentRootFromStore(store), id);
   const manifestPath = patch.manifestPath ?? writeManifest(installPath, data);
-  store.upsertRecord({ id, version: patch.version ?? "1.0.0", manifestPath, installPath, source: patch.source ?? "local", bundled: patch.bundled, enabled: patch.enabled ?? true, approvedPermissions: patch.approvedPermissions ?? ["timer", "pet:speak"], config: patch.config ?? {}, brokenReason: patch.brokenReason });
+  store.upsertRecord({ id, version: patch.version ?? "1.0.0", manifestPath, installPath, source: patch.source ?? "local", bundled: patch.bundled, enabled: patch.enabled ?? true, approvedPermissions: patch.approvedPermissions ?? ["timer", "familiar:speak"], config: patch.config ?? {}, brokenReason: patch.brokenReason });
 }
 
 function addCommandPlugin(store: PluginStateStore, userData: string, id: string, name: string, _commands: Array<{ id: string; title: string }>, patch: Partial<PluginStateRecord> = {}): void {
-  const data = manifest({ id, permissions: ["timer", "pet:speak"] });
+  const data = manifest({ id, permissions: ["timer", "familiar:speak"] });
   data.name = name;
   const installPath = join(userData, "plugins", id);
   const manifestPath = writeManifest(installPath, data);
-  store.upsertRecord({ id, version: "1.0.0", manifestPath, installPath, source: "catalog", enabled: patch.enabled ?? true, approvedPermissions: ["timer", "pet:speak"], config: {}, brokenReason: patch.brokenReason });
+  store.upsertRecord({ id, version: "1.0.0", manifestPath, installPath, source: "catalog", enabled: patch.enabled ?? true, approvedPermissions: ["timer", "familiar:speak"], config: {}, brokenReason: patch.brokenReason });
 }
 
 function currentRootFromStore(_store: PluginStateStore): string { return lastRoot; }
 
-function manifest(patch: Partial<OpenPetsDeclarativePluginManifest> & { everyMinutes?: OpenPetsDeclarativePluginManifest["triggers"][number]["everyMinutes"] } = {}): OpenPetsDeclarativePluginManifest {
-  return { manifestVersion: 1, id: patch.id ?? "plug", name: "Plug", version: patch.version ?? "1.0.0", runtime: "declarative", permissions: patch.permissions ?? ["timer", "pet:speak"], configSchema: patch.configSchema, triggers: patch.triggers ?? [{ on: "timer", everyMinutes: patch.everyMinutes ?? 5, actions: [{ type: "pet.speak", message: "Stretch" }] }] };
+function manifest(patch: Partial<FamiliarOSDeclarativePluginManifest> & { everyMinutes?: FamiliarOSDeclarativePluginManifest["triggers"][number]["everyMinutes"] } = {}): FamiliarOSDeclarativePluginManifest {
+  return { manifestVersion: 1, id: patch.id ?? "plug", name: "Plug", version: patch.version ?? "1.0.0", runtime: "declarative", permissions: patch.permissions ?? ["timer", "familiar:speak"], configSchema: patch.configSchema, triggers: patch.triggers ?? [{ on: "timer", everyMinutes: patch.everyMinutes ?? 5, actions: [{ type: "familiar.speak", message: "Stretch" }] }] };
 }
 
 function writeManifest(dir: string, data: unknown): string {
   mkdirSync(dir, { recursive: true });
-  const path = join(dir, OPENPETS_PLUGIN_MANIFEST_FILENAME);
+  const path = join(dir, FAMILIAROS_PLUGIN_MANIFEST_FILENAME);
   writeFileSync(path, JSON.stringify(data), "utf8");
   return path;
 }
diff --git a/apps/desktop/tests/plugin-state.test.ts b/apps/desktop/tests/plugin-state.test.ts
index fe9ef368..16c377c8 100644
--- a/apps/desktop/tests/plugin-state.test.ts
+++ b/apps/desktop/tests/plugin-state.test.ts
@@ -35,17 +35,17 @@ assert.deepEqual(malformedRecordStore.listRecords().map((record) => record.id),
 
 const statePath = join(tempDir(), "custom-plugin-state.json");
 const store = initializePluginState({ statePath });
-const firstRecord = makeRecord({ approvedPermissions: ["timer", "pet:speak"] });
+const firstRecord = makeRecord({ approvedPermissions: ["timer", "familiar:speak"] });
 store.upsertRecord(firstRecord);
 
 const reloadedStore = new PluginStateStore({ statePath });
 reloadedStore.read();
 assert.deepEqual(reloadedStore.getRecord("stretch-reminder"), {
   ...firstRecord,
-  approvedPermissions: ["pet:speak", "timer"],
+  approvedPermissions: ["familiar:speak", "timer"],
 });
 
-const secondRecord = makeRecord({ id: "water-reminder", version: "2.0.0", source: "local", approvedPermissions: ["pet:reaction"] });
+const secondRecord = makeRecord({ id: "water-reminder", version: "2.0.0", source: "local", approvedPermissions: ["familiar:reaction"] });
 reloadedStore.upsertRecord(secondRecord);
 assert.deepEqual(reloadedStore.listRecords().map((record) => record.id), ["stretch-reminder", "water-reminder"]);
 reloadedStore.removeRecord("water-reminder");
@@ -124,15 +124,15 @@ assert.deepEqual(updateReload.getRecord("update-check")?.update, {
 assert.equal(updateReload.getRecord("update-normalized")?.update, undefined);
 
 const orderingStore = initializePluginState({ statePath: join(tempDir(), "ordering-plugin-state.json") });
-orderingStore.upsertRecord(makeRecord({ id: "order-a", approvedPermissions: ["timer", "pet:reaction", "pet:speak"] }));
-orderingStore.upsertRecord(makeRecord({ id: "order-b", approvedPermissions: ["pet:reaction", "pet:speak", "timer"] }));
-assert.deepEqual(orderingStore.getRecord("order-a")?.approvedPermissions, ["pet:speak", "pet:reaction", "timer"]);
-assert.deepEqual(orderingStore.getRecord("order-b")?.approvedPermissions, ["pet:speak", "pet:reaction", "timer"]);
+orderingStore.upsertRecord(makeRecord({ id: "order-a", approvedPermissions: ["timer", "familiar:reaction", "familiar:speak"] }));
+orderingStore.upsertRecord(makeRecord({ id: "order-b", approvedPermissions: ["familiar:reaction", "familiar:speak", "timer"] }));
+assert.deepEqual(orderingStore.getRecord("order-a")?.approvedPermissions, ["familiar:speak", "familiar:reaction", "timer"]);
+assert.deepEqual(orderingStore.getRecord("order-b")?.approvedPermissions, ["familiar:speak", "familiar:reaction", "timer"]);
 
 console.error("Plugin state validation passed.");
 
 function tempDir(): string {
-  return mkdtempSync(join(tmpdir(), "openpets-plugin-state-"));
+  return mkdtempSync(join(tmpdir(), "familiaros-plugin-state-"));
 }
 
 function makeRecord(patch: Partial<PluginStateRecord> = {}): PluginStateRecord {
@@ -140,11 +140,11 @@ function makeRecord(patch: Partial<PluginStateRecord> = {}): PluginStateRecord {
   return Object.fromEntries(Object.entries({
     id,
     version: patch.version ?? "1.0.0",
-    manifestPath: patch.manifestPath ?? `/tmp/${id}/openpets.plugin.json`,
+    manifestPath: patch.manifestPath ?? `/tmp/${id}/familiaros.plugin.json`,
     installPath: patch.installPath ?? `/tmp/${id}`,
     source: patch.source ?? "catalog",
     enabled: patch.enabled ?? true,
-    approvedPermissions: patch.approvedPermissions ?? ["pet:speak", "timer"],
+    approvedPermissions: patch.approvedPermissions ?? ["familiar:speak", "timer"],
     config: patch.config ?? {},
     brokenReason: patch.brokenReason,
     update: patch.update,
diff --git a/apps/desktop/tests/plugin-ui-static.test.ts b/apps/desktop/tests/plugin-ui-static.test.ts
index b3526ea6..17246216 100644
--- a/apps/desktop/tests/plugin-ui-static.test.ts
+++ b/apps/desktop/tests/plugin-ui-static.test.ts
@@ -3,7 +3,7 @@ import { readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
-const desktopRoot = process.env.OPENPETS_DESKTOP_ROOT ?? resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const desktopRoot = process.env.FAMILIAROS_DESKTOP_ROOT ?? resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const windowsSource = readFileSync(resolve(desktopRoot, "src/windows.ts"), "utf8");
 const controlCenterPreloadSource = readFileSync(resolve(desktopRoot, "control-center-preload.cjs"), "utf8");
 const controlCenterRendererSource = readFileSync(resolve(desktopRoot, "src/renderer/src/main.tsx"), "utf8");
@@ -12,27 +12,27 @@ const pluginSdkPreloadSource = readFileSync(resolve(desktopRoot, "plugin-sdk-pre
 
 assert.doesNotMatch(windowsSource, /openTaskWindow|TaskWindowKind|createPluginsHtml|getPreloadPath|"preload\.cjs"/);
 assert.match(windowsSource, /assertAllowedSender\(event, \["control-center"\]\)/);
-assert.match(windowsSource, /openpets:plugins-snapshot/);
-assert.match(windowsSource, /openpets:plugins-save-config/);
-assert.match(windowsSource, /openpets:plugins-load-local/);
-assert.match(windowsSource, /openpets:plugins-catalog-snapshot/);
-assert.match(windowsSource, /openpets:plugins-install-catalog/);
-assert.match(windowsSource, /openpets:plugins-update-catalog/);
-assert.match(windowsSource, /openpets:plugins-uninstall/);
-assert.match(windowsSource, /openpets:plugins-load-local[\s\S]*assertAllowedSender\(event, \["control-center"\]\)/);
+assert.match(windowsSource, /familiaros:plugins-snapshot/);
+assert.match(windowsSource, /familiaros:plugins-save-config/);
+assert.match(windowsSource, /familiaros:plugins-load-local/);
+assert.match(windowsSource, /familiaros:plugins-catalog-snapshot/);
+assert.match(windowsSource, /familiaros:plugins-install-catalog/);
+assert.match(windowsSource, /familiaros:plugins-update-catalog/);
+assert.match(windowsSource, /familiaros:plugins-uninstall/);
+assert.match(windowsSource, /familiaros:plugins-load-local[\s\S]*assertAllowedSender\(event, \["control-center"\]\)/);
 
-assert.match(controlCenterPreloadSource, /getPluginsSnapshot: \(\) => ipcRenderer\.invoke\("openpets:plugins-snapshot"\)/);
-assert.match(controlCenterPreloadSource, /getPluginCatalogSnapshot: \(refresh\) => ipcRenderer\.invoke\("openpets:plugins-catalog-snapshot", refresh\)/);
-assert.match(controlCenterPreloadSource, /setPluginEnabled: \(id, enabled\) => ipcRenderer\.invoke\("openpets:plugins-set-enabled", id, enabled\)/);
-assert.match(controlCenterPreloadSource, /savePluginConfig: \(id, config\) => ipcRenderer\.invoke\("openpets:plugins-save-config", id, config\)/);
-assert.match(controlCenterPreloadSource, /loadLocalPlugin: \(\) => ipcRenderer\.invoke\("openpets:plugins-load-local"\)/);
-assert.match(controlCenterPreloadSource, /installCatalogPlugin: \(id\) => ipcRenderer\.invoke\("openpets:plugins-install-catalog", id\)/);
-assert.match(controlCenterPreloadSource, /uninstallPlugin: \(id\) => ipcRenderer\.invoke\("openpets:plugins-uninstall", id\)/);
+assert.match(controlCenterPreloadSource, /getPluginsSnapshot: \(\) => ipcRenderer\.invoke\("familiaros:plugins-snapshot"\)/);
+assert.match(controlCenterPreloadSource, /getPluginCatalogSnapshot: \(refresh\) => ipcRenderer\.invoke\("familiaros:plugins-catalog-snapshot", refresh\)/);
+assert.match(controlCenterPreloadSource, /setPluginEnabled: \(id, enabled\) => ipcRenderer\.invoke\("familiaros:plugins-set-enabled", id, enabled\)/);
+assert.match(controlCenterPreloadSource, /savePluginConfig: \(id, config\) => ipcRenderer\.invoke\("familiaros:plugins-save-config", id, config\)/);
+assert.match(controlCenterPreloadSource, /loadLocalPlugin: \(\) => ipcRenderer\.invoke\("familiaros:plugins-load-local"\)/);
+assert.match(controlCenterPreloadSource, /installCatalogPlugin: \(id\) => ipcRenderer\.invoke\("familiaros:plugins-install-catalog", id\)/);
+assert.match(controlCenterPreloadSource, /uninstallPlugin: \(id\) => ipcRenderer\.invoke\("familiaros:plugins-uninstall", id\)/);
 assert.doesNotMatch(controlCenterPreloadSource, /onboarding/i);
 assert.doesNotMatch(controlCenterPreloadSource, /plugins-load-local",\s*[^)]/);
 assert.doesNotMatch(controlCenterPreloadSource, /manifestPath/);
 assert.doesNotMatch(controlCenterPreloadSource, /installPath/);
-assert.doesNotMatch(controlCenterPreloadSource, /openpets:plugins-install-catalog",\s*[^)]+,\s*[^)]/);
+assert.doesNotMatch(controlCenterPreloadSource, /familiaros:plugins-install-catalog",\s*[^)]+,\s*[^)]/);
 
 assert.match(controlCenterRendererSource, /function PluginsView\(\)/);
 assert.match(controlCenterRendererSource, /currentRoute === "plugins"[\s\S]*<PluginsView \/>/);
@@ -41,20 +41,20 @@ assert.match(controlCenterRendererSource, /materializeListItemDefaults/);
 assert.match(controlCenterRendererSource, /updateCatalogEntry[\s\S]*api\.updateCatalogPlugin/);
 assert.match(controlCenterRendererSource, /installed\.source === "catalog"[\s\S]*updateCatalogEntry/);
 
-assert.match(jsHostSource, /OpenPetsPlugin[\s\S]*register/);
+assert.match(jsHostSource, /FamiliarOSPlugin[\s\S]*register/);
 assert.match(jsHostSource, /start\(sdk\)/);
 assert.match(jsHostSource, /__openPetsRegisteredPlugin[\s\S]*stop/);
 assert.match(jsHostSource, /preload: getPluginSdkPreloadPath\(\)/);
 assert.match(pluginSdkPreloadSource, /contextBridge\.exposeInMainWorld\("__openPetsSdk", sdk\)/);
-assert.match(pluginSdkPreloadSource, /speak: \(spec\) => call\("pet\.speak", \[petId, spec\]\)/);
+assert.match(pluginSdkPreloadSource, /speak: \(spec\) => call\("familiar\.speak", \[petId, spec\]\)/);
 assert.match(pluginSdkPreloadSource, /register: \(command, handler\) => call\("commands\.register"/);
 // SDK v3 namespaces are exposed to the plugin sandbox.
 assert.match(pluginSdkPreloadSource, /bubble: \(spec\) => call\("ui\.bubble", \[spec\]\)/);
 assert.match(pluginSdkPreloadSource, /on: \(event, fn\) => subscription\("events\.on", "events\.off"/);
 assert.match(pluginSdkPreloadSource, /publish: \(topic, payload\) => call\("bus\.publish", \[topic, payload\]\)/);
 // Plugin platform settings are reachable from the Control Center.
-assert.match(windowsSource, /openpets:plugin-platform-settings-get/);
-assert.match(windowsSource, /openpets:plugins-inspector/);
-assert.match(controlCenterPreloadSource, /getPluginPlatformSettings: \(\) => ipcRenderer\.invoke\("openpets:plugin-platform-settings-get"\)/);
+assert.match(windowsSource, /familiaros:plugin-platform-settings-get/);
+assert.match(windowsSource, /familiaros:plugins-inspector/);
+assert.match(controlCenterPreloadSource, /getPluginPlatformSettings: \(\) => ipcRenderer\.invoke\("familiaros:plugin-platform-settings-get"\)/);
 
 console.error("Plugin Control Center static validation passed.");
diff --git a/apps/desktop/tests/plugin-user-sound-store.test.ts b/apps/desktop/tests/plugin-user-sound-store.test.ts
index 963ab063..7c6cdaf6 100644
--- a/apps/desktop/tests/plugin-user-sound-store.test.ts
+++ b/apps/desktop/tests/plugin-user-sound-store.test.ts
@@ -5,7 +5,7 @@ import { join } from "node:path";
 
 import { UserSoundStore } from "../src/plugin-user-sound-store.js";
 
-const root = mkdtempSync(join(tmpdir(), "openpets-user-sounds-"));
+const root = mkdtempSync(join(tmpdir(), "familiaros-user-sounds-"));
 const source = join(root, "ding.ogg");
 writeFileSync(source, Buffer.from("OggS test sound", "utf8"));
 
diff --git a/apps/desktop/tests/reaction-animation-mapping.test.ts b/apps/desktop/tests/reaction-animation-mapping.test.ts
index 5678174a..24d8e849 100644
--- a/apps/desktop/tests/reaction-animation-mapping.test.ts
+++ b/apps/desktop/tests/reaction-animation-mapping.test.ts
@@ -1,7 +1,7 @@
 import assert from "node:assert/strict";
 import {
   allowedReactions,
-  type OpenPetsReaction,
+  type FamiliarOSReaction,
 } from "../src/local-ipc-protocol.js";
 import {
   defaultPetSprite,
@@ -51,7 +51,7 @@ function assertSameMembers<T>(actual: T[], expected: T[], message: string): void
 }
 
 // Sprite fixed metadata
-assert.equal(defaultPetSprite.fileName, "default-pet-spritesheet.webp", "sprite filename must match bundled asset");
+assert.equal(defaultPetSprite.fileName, "default-familiar-spritesheet.webp", "sprite filename must match bundled asset");
 assert.equal(defaultPetSprite.frameWidth, 192, "sprite frame width must be 192");
 assert.equal(defaultPetSprite.frameHeight, 208, "sprite frame height must be 208");
 assert.equal(defaultPetSprite.columns, 8, "sprite columns must be 8");
@@ -71,13 +71,13 @@ for (const [stateId, def] of Object.entries(defaultPetSprite.states) as [Univers
 }
 
 // Reaction mapping keys match allowedReactions
-const reactionMappingKeys = Object.keys(defaultReactionToSpriteState) as OpenPetsReaction[];
-assertSameMembers(reactionMappingKeys, [...allowedReactions] as OpenPetsReaction[], "reaction mapping keys must match allowedReactions");
+const reactionMappingKeys = Object.keys(defaultReactionToSpriteState) as FamiliarOSReaction[];
+assertSameMembers(reactionMappingKeys, [...allowedReactions] as FamiliarOSReaction[], "reaction mapping keys must match allowedReactions");
 
 // Every mapped value is selectable and exists in sprite states
 const selectableSet = new Set(EXPECTED_SELECTABLE_ANIMATION_IDS);
 const spriteStateSet = new Set(EXPECTED_SPRITE_STATE_IDS);
-for (const [reaction, state] of Object.entries(defaultReactionToSpriteState) as [OpenPetsReaction, UserSelectableAnimationState][]) {
+for (const [reaction, state] of Object.entries(defaultReactionToSpriteState) as [FamiliarOSReaction, UserSelectableAnimationState][]) {
   assert.ok(selectableSet.has(state), `${reaction}: mapped state ${state} must be user-selectable`);
   assert.ok(spriteStateSet.has(state), `${reaction}: mapped state ${state} must exist in sprite states`);
 }
diff --git a/apps/desktop/tests/update-version.test.ts b/apps/desktop/tests/update-version.test.ts
index 3d5ef3b0..7c1ad53e 100644
--- a/apps/desktop/tests/update-version.test.ts
+++ b/apps/desktop/tests/update-version.test.ts
@@ -14,13 +14,13 @@ assert.equal(isVersionNewer("1.0.0", "1.0.0"), false);
 assert.equal(isVersionNewer("1.0.0", "1.0.1"), false);
 assert.equal(isVersionNewer("bad", "1.0.1"), false);
 
-const repo = "alvinunreal/openpets";
+const repo = "alvinunreal/familiaros";
 const releasesUrl = `https://github.com/${repo}/releases`;
-const available = createParsedUpdateStatus("1.0.0", { tag_name: "v1.0.1", html_url: "https://github.com/alvinunreal/openpets/releases/tag/v1.0.1" }, 123, repo, releasesUrl);
+const available = createParsedUpdateStatus("1.0.0", { tag_name: "v1.0.1", html_url: "https://github.com/alvinunreal/familiaros/releases/tag/v1.0.1" }, 123, repo, releasesUrl);
 assert.equal(available.state, "available");
 assert.equal(available.latestVersion, "1.0.1");
 
-const current = createParsedUpdateStatus("1.0.1", { tag_name: "v1.0.1", html_url: "https://github.com/alvinunreal/openpets/releases/tag/v1.0.1" }, 124, repo, releasesUrl);
+const current = createParsedUpdateStatus("1.0.1", { tag_name: "v1.0.1", html_url: "https://github.com/alvinunreal/familiaros/releases/tag/v1.0.1" }, 124, repo, releasesUrl);
 assert.equal(current.state, "current");
 
 assert.throws(() => createParsedUpdateStatus("1.0.0", { tag_name: "release" }, 125, repo, releasesUrl));
diff --git a/apps/desktop/tests/zip-safety.test.ts b/apps/desktop/tests/zip-safety.test.ts
index bd7c124d..cd8a1647 100644
--- a/apps/desktop/tests/zip-safety.test.ts
+++ b/apps/desktop/tests/zip-safety.test.ts
@@ -1,45 +1,45 @@
 import { validateZipEntryName, assertRejectsPath, ZipEntryPathTracker, hasSupportedZipMagic } from "../src/zip-safety.js";
 import yauzl from "yauzl";
 
-validateZipEntryName("pet-package/");
-validateZipEntryName("pet-package/pet.json");
-validateZipEntryName("pet-package/spritesheet.webp");
-validateZipEntryName("pet.json");
+validateZipEntryName("familiar-package/");
+validateZipEntryName("familiar-package/familiar.json");
+validateZipEntryName("familiar-package/spritesheet.webp");
+validateZipEntryName("familiar.json");
 validateZipEntryName("spritesheet.webp");
 
 const validTracker = new ZipEntryPathTracker();
-validTracker.accept("pet-package/");
-validTracker.accept("pet-package/pet.json");
-validTracker.accept("pet-package/spritesheet.webp");
+validTracker.accept("familiar-package/");
+validTracker.accept("familiar-package/familiar.json");
+validTracker.accept("familiar-package/spritesheet.webp");
 
 const validFlatTracker = new ZipEntryPathTracker();
-validFlatTracker.accept("pet.json");
+validFlatTracker.accept("familiar.json");
 validFlatTracker.accept("spritesheet.webp");
 
 for (const unsafe of [
-  "../pet.json",
-  "pet-package/../pet.json",
-  "./pet.json",
-  "/tmp/pet.json",
-  "C:/tmp/pet.json",
-  "pet-package\\pet.json",
-  "//server/share/pet.json",
-  "pet-package/pet.json\0.png",
-  "pet-package/extra.js",
-  "pet-package/nested/pet.json",
-  "pet-package//pet.json",
+  "../familiar.json",
+  "familiar-package/../familiar.json",
+  "./familiar.json",
+  "/tmp/familiar.json",
+  "C:/tmp/familiar.json",
+  "familiar-package\\familiar.json",
+  "//server/share/familiar.json",
+  "familiar-package/familiar.json\0.png",
+  "familiar-package/extra.js",
+  "familiar-package/nested/familiar.json",
+  "familiar-package//familiar.json",
 ]) {
   assertRejectsPath(unsafe);
 }
 
-assertRejectsEntrySet(["pet-package/pet.json", "pet-package/pet.json"]);
-assertRejectsEntrySet(["pet-package/pet.json", "pet-package/PET.json"]);
-assertRejectsEntrySet(["pet-package/pet.json", "other-pet/spritesheet.webp"]);
-assertRejectsEntrySet(["pet.json", "pet-package/spritesheet.webp"]);
-assertRejectsEntrySet(["pet.json", "pet-package/"]);
-assertRejectsEntrySet(["spritesheet.webp", "pet-package/"]);
-assertRejectsEntrySet(["pet.json", "pet.json"]);
-assertRejectsEntrySet(["pet.json", "PET.json"]);
+assertRejectsEntrySet(["familiar-package/familiar.json", "familiar-package/familiar.json"]);
+assertRejectsEntrySet(["familiar-package/familiar.json", "familiar-package/PET.json"]);
+assertRejectsEntrySet(["familiar-package/familiar.json", "other-familiar/spritesheet.webp"]);
+assertRejectsEntrySet(["familiar.json", "familiar-package/spritesheet.webp"]);
+assertRejectsEntrySet(["familiar.json", "familiar-package/"]);
+assertRejectsEntrySet(["spritesheet.webp", "familiar-package/"]);
+assertRejectsEntrySet(["familiar.json", "familiar.json"]);
+assertRejectsEntrySet(["familiar.json", "PET.json"]);
 
 if (!hasSupportedZipMagic(Buffer.from([0x50, 0x4b, 0x03, 0x04]))) {
   throw new Error("Valid local file zip signature was rejected.");
@@ -49,7 +49,7 @@ if (hasSupportedZipMagic(Buffer.from("not a zip", "utf8"))) {
   throw new Error("Non-zip content was accepted as a zip.");
 }
 
-await assertYauzlStrictFileNamesRejects("pet-package\\pet.json");
+await assertYauzlStrictFileNamesRejects("familiar-package\\familiar.json");
 
 console.log("Zip safety validation passed.");
 
diff --git a/apps/desktop/vite.config.ts b/apps/desktop/vite.config.ts
index 5c341e46..8303f45b 100644
--- a/apps/desktop/vite.config.ts
+++ b/apps/desktop/vite.config.ts
@@ -1,8 +1,8 @@
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react";
 
-const productionCsp = "default-src 'none'; script-src 'self'; style-src 'self'; img-src 'self' data: https://openpets.dev openpets-codex: openpets-installed: openpets-pet-preview:; connect-src 'self'; base-uri 'none'; form-action 'none'; frame-src 'none'";
-const devCsp = "default-src 'none'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https://openpets.dev openpets-codex: openpets-installed: openpets-pet-preview:; connect-src 'self' http://127.0.0.1:5173 ws://127.0.0.1:5173; base-uri 'none'; form-action 'none'; frame-src 'none'";
+const productionCsp = "default-src 'none'; script-src 'self'; style-src 'self'; img-src 'self' data: https://familiaros.dev familiaros-codex: familiaros-installed: familiaros-familiar-preview:; connect-src 'self'; base-uri 'none'; form-action 'none'; frame-src 'none'";
+const devCsp = "default-src 'none'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https://familiaros.dev familiaros-codex: familiaros-installed: familiaros-familiar-preview:; connect-src 'self' http://127.0.0.1:5173 ws://127.0.0.1:5173; base-uri 'none'; form-action 'none'; frame-src 'none'";
 
 export default defineConfig(({ command }) => ({
   root: "src/renderer",
@@ -10,7 +10,7 @@ export default defineConfig(({ command }) => ({
   plugins: [
     react(),
     command === "serve" && {
-      name: "openpets-dev-csp",
+      name: "familiaros-dev-csp",
       transformIndexHtml(html: string) {
         return html.replace(productionCsp, devCsp);
       },
diff --git a/codemap.md b/codemap.md
index 98b57525..50cb85f0 100644
--- a/codemap.md
+++ b/codemap.md
@@ -1,15 +1,15 @@
-# Repository Atlas: OpenPets 2.0 Workspace
+# Repository Atlas: FamiliarOS 2.0 Workspace
 
 ## Project Responsibility
 
-OpenPets is a pnpm/TypeScript monorepo for an Electron desktop companion app plus npm packages that let coding agents control animated desktop pets. The workspace provides a local IPC protocol, MCP server, CLI tooling, and editor-specific integrations for Claude Code, OpenCode, Cursor, and Pi.
+FamiliarOS is a pnpm/TypeScript monorepo for an Electron desktop companion app plus npm packages that let coding agents control animated desktop familiars. The workspace provides a local IPC protocol, MCP server, CLI tooling, and editor-specific integrations for Claude Code, OpenCode, Cursor, and Pi.
 
 ## System Entry Points
 
 - `package.json`: workspace scripts for building, checking, testing, desktop packaging, and npm release orchestration.
 - `pnpm-workspace.yaml`: workspace membership for `apps/*` and `packages/*`.
-- `apps/desktop/src/main.ts`: Electron main-process bootstrap for the desktop pet app.
-- `packages/cli/src/index.ts`: command-line setup and pet management entry point.
+- `apps/desktop/src/main.ts`: Electron main-process bootstrap for the desktop familiar app.
+- `packages/cli/src/index.ts`: command-line setup and familiar management entry point.
 - `packages/mcp/src/index.ts`: MCP server entry point used by agents.
 - `packages/client/src/index.ts`: public IPC client API consumed by integrations and tools.
 - `packages/cursor/src/index.ts`: Cursor MCP/rules setup API.
@@ -20,12 +20,12 @@ OpenPets is a pnpm/TypeScript monorepo for an Electron desktop companion app plu
 
 | Directory | Responsibility Summary | Detailed Map |
 |-----------|------------------------|--------------|
-| `apps/` | Deployable application workspace, currently the tray-first Electron desktop app that consumes shared packages, local IPC, pet windows, and desktop plugin support. | [View Map](apps/codemap.md) |
-| `apps/desktop/` | User-facing Electron companion app: tray UX, pet windows, pet installation, plugin automation/runtime, agent setup, update checks, and local IPC server. | [View Map](apps/desktop/codemap.md) |
+| `apps/` | Deployable application workspace, currently the tray-first Electron desktop app that consumes shared packages, local IPC, familiar windows, and desktop plugin support. | [View Map](apps/codemap.md) |
+| `apps/desktop/` | User-facing Electron companion app: tray UX, familiar windows, familiar installation, plugin automation/runtime, agent setup, update checks, and local IPC server. | [View Map](apps/desktop/codemap.md) |
 | `apps/desktop/contracts/` | Desktop public-boundary contract tests for catalog fixtures, local IPC protocol behavior, and plugin manifest schema validation. | [View Map](apps/desktop/contracts/codemap.md) |
-| `apps/desktop/src/` | Main-process service layer for app lifecycle, state, tray/windows, IPC routing, lease-managed agent pets, catalog installation, plugin subsystem, and editor integration. | [View Map](apps/desktop/src/codemap.md) |
+| `apps/desktop/src/` | Main-process service layer for app lifecycle, state, tray/windows, IPC routing, lease-managed agent familiars, catalog installation, plugin subsystem, and editor integration. | [View Map](apps/desktop/src/codemap.md) |
 | `apps/desktop/src/renderer/` | Vite renderer workspace for the sandboxed React/Tailwind Control Center bundle. | [View Map](apps/desktop/src/renderer/codemap.md) |
-| `apps/desktop/src/renderer/src/` | React/Tailwind Control Center UI for Dashboard, Pets, Integrations, Plugins, and Settings via narrow preload APIs. | [View Map](apps/desktop/src/renderer/src/codemap.md) |
+| `apps/desktop/src/renderer/src/` | React/Tailwind Control Center UI for Dashboard, Familiars, Integrations, Plugins, and Settings via narrow preload APIs. | [View Map](apps/desktop/src/renderer/src/codemap.md) |
 | `apps/desktop/scripts/` | Desktop package cleanup and local release automation scripts. | [View Map](apps/desktop/scripts/codemap.md) |
 | `packages/` | Publishable npm package workspace for shared protocol, CLI, MCP, and coding-agent integrations. | [View Map](packages/codemap.md) |
 | `packages/agent-events/` | Shared agent speech/event message pools and validation utilities. | [View Map](packages/agent-events/codemap.md) |
@@ -33,34 +33,34 @@ OpenPets is a pnpm/TypeScript monorepo for an Electron desktop companion app plu
 | `packages/claude/` | Claude Code integration package for hooks, MCP setup, and settings/memory management. | [View Map](packages/claude/codemap.md) |
 | `packages/claude/src/` | Claude Code hook handlers, hook settings, CLI integration, and exported setup APIs. | [View Map](packages/claude/src/codemap.md) |
 | `packages/client/` | IPC client package that discovers and communicates with the desktop app. | [View Map](packages/client/codemap.md) |
-| `packages/client/contracts/` | Client protocol contract tests for discovery, endpoint validation, responses, and pet result parsing. | [View Map](packages/client/contracts/codemap.md) |
+| `packages/client/contracts/` | Client protocol contract tests for discovery, endpoint validation, responses, and familiar result parsing. | [View Map](packages/client/contracts/codemap.md) |
 | `packages/client/src/` | Protocol definitions, discovery logic, public client API, and smoke entry points. | [View Map](packages/client/src/codemap.md) |
-| `packages/cli/` | User-facing OpenPets CLI package. | [View Map](packages/cli/codemap.md) |
+| `packages/cli/` | User-facing FamiliarOS CLI package. | [View Map](packages/cli/codemap.md) |
 | `packages/cli/src/` | CLI command parsing and orchestration across client, Claude, OpenCode, and MCP packages. | [View Map](packages/cli/src/codemap.md) |
 | `packages/cursor/` | Cursor editor integration package for managed MCP configuration and project-local rules. | [View Map](packages/cursor/codemap.md) |
 | `packages/cursor/src/` | Cursor config/rules planning, status classification, safe writes, previews, and validation checks. | [View Map](packages/cursor/src/codemap.md) |
-| `packages/install-pet/` | Standalone installer package for gallery/catalog pets. | [View Map](packages/install-pet/codemap.md) |
-| `packages/install-pet/src/` | Pet installation command implementation. | [View Map](packages/install-pet/src/codemap.md) |
-| `packages/mcp/` | MCP server package exposing OpenPets tools to compatible agents. | [View Map](packages/mcp/codemap.md) |
+| `packages/install-familiar/` | Standalone installer package for gallery/catalog familiars. | [View Map](packages/install-familiar/codemap.md) |
+| `packages/install-familiar/src/` | Familiar installation command implementation. | [View Map](packages/install-familiar/src/codemap.md) |
+| `packages/mcp/` | MCP server package exposing FamiliarOS tools to compatible agents. | [View Map](packages/mcp/codemap.md) |
 | `packages/mcp/src/` | MCP server bootstrap, argument parsing, tool registration, and executable validation helpers. | [View Map](packages/mcp/src/codemap.md) |
 | `packages/opencode/` | OpenCode editor integration package with plugin runtime and global setup helpers. | [View Map](packages/opencode/codemap.md) |
 | `packages/opencode/src/` | OpenCode plugin, config mutation, previews, status, and project/global setup modules. | [View Map](packages/opencode/src/codemap.md) |
 | `packages/pi/` | Pi coding-agent integration package with extension runtime and slash command support. | [View Map](packages/pi/codemap.md) |
-| `packages/pi/src/` | Pi extension entry point, event classification, OpenPets command parsing, and validation checks. | [View Map](packages/pi/src/codemap.md) |
-| `packages/pet-format/` | Minimal package marker/type interface for OpenPets pet package identity. | [View Map](packages/pet-format/codemap.md) |
-| `packages/pet-format/src/` | Marker source export for pet-format package consumers. | [View Map](packages/pet-format/src/codemap.md) |
-| `plugins/` | Root product source for first-party OpenPets plugins before web catalog packaging and R2 upload. | |
+| `packages/pi/src/` | Pi extension entry point, event classification, FamiliarOS command parsing, and validation checks. | [View Map](packages/pi/src/codemap.md) |
+| `packages/familiar-format/` | Minimal package marker/type interface for FamiliarOS familiar package identity. | [View Map](packages/familiar-format/codemap.md) |
+| `packages/familiar-format/src/` | Marker source export for familiar-format package consumers. | [View Map](packages/familiar-format/src/codemap.md) |
+| `plugins/` | Root product source for first-party FamiliarOS plugins before web catalog packaging and R2 upload. | |
 | `plugins/official/` | Official plugin manifests and single-file JavaScript entries loaded by desktop dev mode and packaged by web sync. | |
 
 ## Architecture Flow
 
 1. The desktop app starts `apps/desktop/src/main.ts`, initializes app state, creates tray/task windows, and starts a local IPC server.
-2. Agent integrations (`packages/claude`, `packages/opencode`, `packages/cursor`, `packages/pi`, and `packages/mcp`) configure agents or emit pet commands through `@open-pets/client`.
+2. Agent integrations (`packages/claude`, `packages/opencode`, `packages/cursor`, `packages/pi`, and `packages/mcp`) configure agents or emit familiar commands through `@familiaros/client`.
 3. The client discovers Unix sockets, Windows named pipes, or TCP endpoints for WSL cross-platform access.
-4. The desktop IPC server routes commands through lease-managed controllers so default and agent pets can coexist safely.
-5. The plugin service loads approved catalog or local `openpets.plugin.json` manifests, persists plugin state/config, schedules declarative timers, and bridges allowed actions into the default pet API.
-6. Pet windows render reaction-driven animations, speech bubbles, and status badges using desktop state plus reaction mapping metadata.
-7. Pet assets are resolved from built-in assets, locally developed Codex pets, or remotely downloaded catalog ZIPs.
+4. The desktop IPC server routes commands through lease-managed controllers so default and agent familiars can coexist safely.
+5. The plugin service loads approved catalog or local `familiaros.plugin.json` manifests, persists plugin state/config, schedules declarative timers, and bridges allowed actions into the default familiar API.
+6. Familiar windows render reaction-driven animations, speech bubbles, and status badges using desktop state plus reaction mapping metadata.
+7. Familiar assets are resolved from built-in assets, locally developed Codex familiars, or remotely downloaded catalog ZIPs.
 8. Workspace packages share TypeScript/ESM build conventions and are wired together through pnpm `workspace:*` dependencies.
 
 ## Working Notes
diff --git a/docs/bug-squashing.md b/docs/bug-squashing.md
index c700d146..ed35b837 100644
--- a/docs/bug-squashing.md
+++ b/docs/bug-squashing.md
@@ -15,31 +15,31 @@ Each bug should record:
 
 ---
 
-## Windows transparent pet block and lost interaction
+## Windows transparent familiar block and lost interaction
 
-- **GitHub issue:** https://github.com/alvinunreal/openpets/issues/18
+- **GitHub issue:** https://github.com/alvinunreal/familiaros/issues/18
 - **Platform:** Windows
 - **Reported version(s):** `2.0.5`; also reproduced by reporter when building from source.
 - **Status:** first fix implemented locally; awaiting checks, release, and community confirmation.
 
-### Bug A: gray block behind the pet
+### Bug A: gray block behind the familiar
 
 #### Report
 
-The app opens normally on Windows, but the pet is surrounded by a gray rectangular block instead of a transparent background.
+The app opens normally on Windows, but the familiar is surrounded by a gray rectangular block instead of a transparent background.
 
 #### Current rendering path
 
-- Pet windows are transparent frameless Electron `BrowserWindow`s.
-- Main options are in `apps/desktop/src/pet-window.ts`:
+- Familiar windows are transparent frameless Electron `BrowserWindow`s.
+- Main options are in `apps/desktop/src/familiar-window.ts`:
   - `transparent: true`
   - `frame: false`
   - `backgroundColor: "#00000000"`
   - `hasShadow: false`
   - `show: false`
-- Pet HTML/CSS sets transparent page background:
+- Familiar HTML/CSS sets transparent page background:
   - `html, body { ... background: transparent; ... }`
-- The pet shell currently uses CSS `filter: drop-shadow(...)`.
+- The familiar shell currently uses CSS `filter: drop-shadow(...)`.
 - The speech/status bubble currently uses CSS `backdrop-filter: blur(...)`.
 
 #### Likely cause
@@ -48,7 +48,7 @@ Windows/Electron transparent-window compositing is probably producing an opaque
 
 Most suspicious triggers:
 
-1. CSS `filter: drop-shadow(...)` on `.pet-shell` inside a transparent layered window.
+1. CSS `filter: drop-shadow(...)` on `.familiar-shell` inside a transparent layered window.
 2. CSS `backdrop-filter: blur(...)` on `.bubble` inside a transparent layered window.
 3. Showing the transparent window before the first clean renderer paint.
 
@@ -69,46 +69,46 @@ Useful references:
 Try these in order:
 
 1. Gate/remove `backdrop-filter` on Windows.
-2. Gate/remove or simplify `.pet-shell` `drop-shadow` on Windows.
-3. Delay showing the pet until first successful load/render (`ready-to-show` or an explicit renderer-ready signal).
+2. Gate/remove or simplify `.familiar-shell` `drop-shadow` on Windows.
+3. Delay showing the familiar until first successful load/render (`ready-to-show` or an explicit renderer-ready signal).
 4. If still broken, test Windows-specific GPU/compositor mitigations. Do **not** start with global `app.disableHardwareAcceleration()` unless the safer CSS/lifecycle fixes fail, because it may vary by machine and can regress other rendering.
 
 #### Verification plan
 
 Ask Windows testers to confirm:
 
-- Built-in pet has no gray/black rectangle.
-- Installed/gallery pets have no gray/black rectangle.
-- Pet bubbles do not create a gray/black rectangle when visible.
+- Built-in familiar has no gray/black rectangle.
+- Installed/gallery familiars have no gray/black rectangle.
+- Familiar bubbles do not create a gray/black rectangle when visible.
 - Behavior after app restart is still correct.
 
 #### Results log
 
 | Date | Version/Build | Attempt | Local result | Community result | Notes |
 | --- | --- | --- | --- | --- | --- |
-| 2026-05-14 | unreleased | Gate Windows `.pet-shell` `drop-shadow` and `.bubble` `backdrop-filter` to `none` | Pending checks | Pending | First low-risk compositor mitigation; needs Windows tester confirmation. |
+| 2026-05-14 | unreleased | Gate Windows `.familiar-shell` `drop-shadow` and `.bubble` `backdrop-filter` to `none` | Pending checks | Pending | First low-risk compositor mitigation; needs Windows tester confirmation. |
 
 ---
 
-### Bug B: cannot move or right-click pet after changing pet
+### Bug B: cannot move or right-click familiar after changing familiar
 
 #### Report
 
-On Windows, the pet can initially be moved and right-clicked. After changing to another pet, it cannot be moved or right-clicked anymore. Exiting and launching the app again restores interaction.
+On Windows, the familiar can initially be moved and right-clicked. After changing to another familiar, it cannot be moved or right-clicked anymore. Exiting and launching the app again restores interaction.
 
 #### Current input path
 
-- Default pet window is reused instead of recreated.
-- Pet change calls `refreshDefaultPetContent()`.
-- `refreshDefaultPetContent()` reloads the existing pet window content with `loadFile(...)`.
+- Default familiar window is reused instead of recreated.
+- Familiar change calls `refreshDefaultPetContent()`.
+- `refreshDefaultPetContent()` reloads the existing familiar window content with `loadFile(...)`.
 - Input handling uses Electron `setIgnoreMouseEvents(true, { forward: true })` on Windows/macOS so transparent background clicks pass through.
-- The renderer preload sends hit-test and drag IPC based on `elementFromPoint(...).closest(".pet-shell, .bubble")`.
+- The renderer preload sends hit-test and drag IPC based on `elementFromPoint(...).closest(".familiar-shell, .bubble")`.
 - Current passthrough setup only runs once after the first load:
   - `window.webContents.once("did-finish-load", () => setPassthrough(true));`
 
 #### Likely cause
 
-The `BrowserWindow` keeps OS-level mouse passthrough state across `loadFile(...)` reloads, but our code only re-arms/reset it once. After pet change, Windows can leave the window in ignored/pass-through mode or lose forwarded mouse events. Then mouse events do not reach the renderer, so drag and context-menu handling never start.
+The `BrowserWindow` keeps OS-level mouse passthrough state across `loadFile(...)` reloads, but our code only re-arms/reset it once. After familiar change, Windows can leave the window in ignored/pass-through mode or lose forwarded mouse events. Then mouse events do not reach the renderer, so drag and context-menu handling never start.
 
 Confidence: **high**.
 
@@ -127,30 +127,30 @@ Useful references:
 Try these in order:
 
 1. Make passthrough reload-safe:
-   - Reset `setIgnoreMouseEvents(false)` before every pet content navigation/reload.
+   - Reset `setIgnoreMouseEvents(false)` before every familiar content navigation/reload.
    - Clear any active drag state before navigation/reload.
    - Re-apply passthrough after every load, not only the first load.
-2. Add an explicit renderer-ready IPC from `pet-preload.cjs` after mouse handlers are installed, then resync passthrough from main.
-3. If Windows still fails, stop using full `loadFile(...)` as the pet-switch primitive:
+2. Add an explicit renderer-ready IPC from `familiar-preload.cjs` after mouse handlers are installed, then resync passthrough from main.
+3. If Windows still fails, stop using full `loadFile(...)` as the familiar-switch primitive:
    - update DOM/sprite data in-place, or
-   - recreate the pet window on pet change while preserving position and visibility.
+   - recreate the familiar window on familiar change while preserving position and visibility.
 
 #### Verification plan
 
 Ask Windows testers to confirm:
 
-- Pet can be dragged immediately after launch.
-- Pet right-click menu opens immediately after launch.
-- Change from built-in pet to installed pet, then drag and right-click still work.
-- Change from installed pet back to built-in pet, then drag and right-click still work.
-- Repeat pet switching multiple times without restarting.
+- Familiar can be dragged immediately after launch.
+- Familiar right-click menu opens immediately after launch.
+- Change from built-in familiar to installed familiar, then drag and right-click still work.
+- Change from installed familiar back to built-in familiar, then drag and right-click still work.
+- Repeat familiar switching multiple times without restarting.
 - Try while a bubble/status badge is visible.
 
 #### Results log
 
 | Date | Version/Build | Attempt | Local result | Community result | Notes |
 | --- | --- | --- | --- | --- | --- |
-| 2026-05-14 | unreleased | Reset passthrough before pet content reload, re-arm after every load, and add renderer-ready IPC | Pending checks | Pending | Targets Electron `setIgnoreMouseEvents(..., { forward: true })` reload/forwarding flake. |
+| 2026-05-14 | unreleased | Reset passthrough before familiar content reload, re-arm after every load, and add renderer-ready IPC | Pending checks | Pending | Targets Electron `setIgnoreMouseEvents(..., { forward: true })` reload/forwarding flake. |
 
 ---
 
@@ -158,11 +158,11 @@ Ask Windows testers to confirm:
 
 Recommended first patch scope:
 
-1. Update pet window passthrough lifecycle in `apps/desktop/src/pet-window.ts`.
-2. Update `apps/desktop/pet-preload.cjs` if adding renderer-ready IPC.
+1. Update familiar window passthrough lifecycle in `apps/desktop/src/familiar-window.ts`.
+2. Update `apps/desktop/familiar-preload.cjs` if adding renderer-ready IPC.
 3. Gate Windows-specific visual effects in `createPetWindowCss(...)`.
 4. Add or update contract checks in `apps/desktop/src/check-packaging-contract.ts` so future changes do not regress the Windows workaround.
 
 Potential release note wording after implementation:
 
-> Fixed Windows pet window transparency and interaction reliability when switching pets. This release removes fragile transparent-window visual effects on Windows and reinitializes click-through/drag handling after pet reloads. Please report whether gray pet backgrounds or lost drag/right-click behavior still occur on your Windows machine.
+> Fixed Windows familiar window transparency and interaction reliability when switching familiars. This release removes fragile transparent-window visual effects on Windows and reinitializes click-through/drag handling after familiar reloads. Please report whether gray familiar backgrounds or lost drag/right-click behavior still occur on your Windows machine.
diff --git a/docs/claude-integration.md b/docs/claude-integration.md
index 2f0bc1a2..8a54857f 100644
--- a/docs/claude-integration.md
+++ b/docs/claude-integration.md
@@ -1,72 +1,72 @@
 # Claude integration
 
-This document describes how OpenPets Desktop integrates with Claude Code, what files are configured, how Claude reaches the desktop app, and which Claude events trigger pet reactions or speech.
+This document describes how FamiliarOS Desktop integrates with Claude Code, what files are configured, how Claude reaches the desktop app, and which Claude events trigger familiar reactions or speech.
 
 ## Integration surfaces
 
 Claude support has three related surfaces:
 
-1. **MCP tools** — Claude gets the `openpets_status`, `openpets_react`, and `openpets_say` tools.
+1. **MCP tools** — Claude gets the `familiaros_status`, `familiaros_react`, and `familiaros_say` tools.
 2. **Claude memory instructions** — Claude is told when it should use those tools.
-3. **Claude hooks** — Claude lifecycle and tool events automatically trigger OpenPets reactions.
+3. **Claude hooks** — Claude lifecycle and tool events automatically trigger FamiliarOS reactions.
 
-The desktop setup UI for these surfaces is implemented in `apps/desktop/src/agent-setup.ts` and exposed to the renderer through `openpets:agent-setup-snapshot` and `openpets:agent-setup-action`.
+The desktop setup UI for these surfaces is implemented in `apps/desktop/src/agent-setup.ts` and exposed to the renderer through `familiaros:agent-setup-snapshot` and `familiaros:agent-setup-action`.
 
 This document primarily describes **Desktop user/global setup**. The CLI also supports **project-local Claude setup**; see [Project-local Claude setup](#project-local-claude-setup).
 
-## Files managed by OpenPets
+## Files managed by FamiliarOS
 
 ### Claude MCP entry
 
 The MCP entry is installed into Claude Code by running a Claude command shaped like:
 
 ```sh
-claude mcp add --scope user openpets -- npx -y @open-pets/mcp
+claude mcp add --scope user familiaros -- npx -y @familiaros/mcp
 ```
 
-If the user selected a specific pet in the desktop setup UI, the command includes that pet:
+If the user selected a specific familiar in the desktop setup UI, the command includes that familiar:
 
 ```sh
-claude mcp add --scope user openpets -- npx -y @open-pets/mcp --pet <petId>
+claude mcp add --scope user familiaros -- npx -y @familiaros/mcp --familiar <petId>
 ```
 
-In local development or packaged desktop mode, OpenPets can use `node <local-or-bundled-entry>` instead of `npx`.
+In local development or packaged desktop mode, FamiliarOS can use `node <local-or-bundled-entry>` instead of `npx`.
 
 Packaged and local `node <entry>` commands require `node` to be available on Claude Code's `PATH`. Desktop setup reports an error instead of installing a bundled command if `node --version` cannot run from the agent environment.
 
 ### Claude memory
 
-OpenPets writes two user-level Claude memory files:
+FamiliarOS writes two user-level Claude memory files:
 
 ```text
 ~/.claude/CLAUDE.md
-~/.claude/openpets.md
+~/.claude/familiaros.md
 ```
 
 `~/.claude/CLAUDE.md` receives a managed import block:
 
 ```md
-<!-- OPENPETS:IMPORT:START -->
-@~/.claude/openpets.md
-<!-- OPENPETS:IMPORT:END -->
+<!-- FAMILIAROS:IMPORT:START -->
+@~/.claude/familiaros.md
+<!-- FAMILIAROS:IMPORT:END -->
 ```
 
-`~/.claude/openpets.md` receives the managed instruction block:
+`~/.claude/familiaros.md` receives the managed instruction block:
 
 ```md
-<!-- OPENPETS:START -->
-## OpenPets
+<!-- FAMILIAROS:START -->
+## FamiliarOS
 
-OpenPets MCP tools may be available.
+FamiliarOS MCP tools may be available.
 
-Use OpenPets as a short visible status channel for meaningful coding progress:
-- Use `openpets_say` when starting, completing, blocking, or needing review on non-trivial work.
+Use FamiliarOS as a short visible status channel for meaningful coding progress:
+- Use `familiaros_say` when starting, completing, blocking, or needing review on non-trivial work.
 - Keep messages brief, user-facing, and non-sensitive.
 - Do not include code, logs, secrets, URLs, or file paths.
-- Use `openpets_react` for small visual or emotional feedback.
-- Use `openpets_status` only when checking availability or the targeted pet.
+- Use `familiaros_react` for small visual or emotional feedback.
+- Use `familiaros_status` only when checking availability or the targeted familiar.
 - Do not spam every internal step.
-<!-- OPENPETS:END -->
+<!-- FAMILIAROS:END -->
 ```
 
 The memory installer is idempotent. It updates only the managed blocks, avoids symlinks and unsafe files, writes private files, and uses atomic temp-file writes.
@@ -79,25 +79,25 @@ Claude hooks are installed into:
 ~/.claude/settings.json
 ```
 
-OpenPets-managed hook commands include this marker:
+FamiliarOS-managed hook commands include this marker:
 
 ```text
---openpets-managed
+--familiaros-managed
 ```
 
 The normal published hook command is:
 
 ```sh
-npx -y @open-pets/claude hook --openpets-managed
+npx -y @familiaros/claude hook --familiaros-managed
 ```
 
-If a pet is selected:
+If a familiar is selected:
 
 ```sh
-npx -y @open-pets/claude hook --openpets-managed --pet <petId>
+npx -y @familiaros/claude hook --familiaros-managed --familiar <petId>
 ```
 
-OpenPets installs the command for these Claude hook events:
+FamiliarOS installs the command for these Claude hook events:
 
 ```text
 UserPromptSubmit
@@ -113,54 +113,54 @@ Each hook entry is a Claude command hook with a short timeout and async executio
 ```json
 {
   "type": "command",
-  "command": "npx -y @open-pets/claude hook --openpets-managed",
+  "command": "npx -y @familiaros/claude hook --familiaros-managed",
   "timeout": 3,
   "async": true,
   "asyncRewake": false
 }
 ```
 
-OpenPets backs up `settings.json` before changing it and removes only hooks containing the `--openpets-managed` marker.
+FamiliarOS backs up `settings.json` before changing it and removes only hooks containing the `--familiaros-managed` marker.
 
 ## Project-local Claude setup
 
-The `@open-pets/cli` package can configure a project-local Claude integration from a project directory:
+The `@familiaros/cli` package can configure a project-local Claude integration from a project directory:
 
 ```sh
-openpets configure --agent claude --pet <petId>
+familiaros configure --agent claude --familiar <petId>
 ```
 
 Project-local setup differs from Desktop user/global setup:
 
-- It uses `claude mcp add-json openpets ... --scope local` from the target project directory.
+- It uses `claude mcp add-json familiaros ... --scope local` from the target project directory.
 - It writes hooks to `<project>/.claude/settings.local.json`.
-- Hook commands include both `--openpets-managed` and `--project-local`.
+- Hook commands include both `--familiaros-managed` and `--project-local`.
 - Project-local hook entries use `timeout: 10`, `async: true`, and `asyncRewake: false`.
-- The MCP and hooks are always configured with a selected `--pet <petId>`.
+- The MCP and hooks are always configured with a selected `--familiar <petId>`.
 
-When a global OpenPets Claude hook runs, it checks whether the current Claude project already has a project-local OpenPets hook. If it finds one, the global hook does not send a duplicate reaction. This avoids double pet events when both global Desktop setup and project-local CLI setup exist.
+When a global FamiliarOS Claude hook runs, it checks whether the current Claude project already has a project-local FamiliarOS hook. If it finds one, the global hook does not send a duplicate reaction. This avoids double familiar events when both global Desktop setup and project-local CLI setup exist.
 
-Project-local files live inside the project and may be committed depending on the user's repository policy. They can contain the selected pet id.
+Project-local files live inside the project and may be committed depending on the user's repository policy. They can contain the selected familiar id.
 
 ## Runtime path
 
-When Claude calls an OpenPets tool or when a Claude hook fires, the runtime path is:
+When Claude calls an FamiliarOS tool or when a Claude hook fires, the runtime path is:
 
 ```text
 Claude Code
-  -> @open-pets/mcp or @open-pets/claude hook
-  -> @open-pets/client
-  -> OpenPets desktop local IPC discovery file
-  -> OpenPets desktop IPC socket/pipe
-  -> default pet controller or explicit agent pet controller
+  -> @familiaros/mcp or @familiaros/claude hook
+  -> @familiaros/client
+  -> FamiliarOS desktop local IPC discovery file
+  -> FamiliarOS desktop IPC socket/pipe
+  -> default familiar controller or explicit agent familiar controller
 ```
 
 The desktop app writes a discovery file such as:
 
 ```text
-macOS: ~/Library/Application Support/OpenPets/runtime/ipc.json
-Windows: %APPDATA%/OpenPets/runtime/ipc.json
-Linux: $XDG_RUNTIME_DIR/openpets/ipc.json, or ~/.config/OpenPets/runtime/ipc.json fallback
+macOS: ~/Library/Application Support/FamiliarOS/runtime/ipc.json
+Windows: %APPDATA%/FamiliarOS/runtime/ipc.json
+Linux: $XDG_RUNTIME_DIR/familiaros/ipc.json, or ~/.config/FamiliarOS/runtime/ipc.json fallback
 ```
 
 That file contains the IPC endpoint and a per-run token. Clients must send that token with every request.
@@ -171,23 +171,23 @@ Claude sees these tools when the MCP server is configured:
 
 | Tool | Purpose | Desktop IPC method |
 | --- | --- | --- |
-| `openpets_status` | Check whether OpenPets is reachable and which pet is targeted. | `status` |
-| `openpets_react` | Set a short reaction on the target pet. | `pet.react` |
-| `openpets_say` | Show a short safe speech bubble, optionally with a reaction. | `pet.say` |
+| `familiaros_status` | Check whether FamiliarOS is reachable and which familiar is targeted. | `status` |
+| `familiaros_react` | Set a short reaction on the target familiar. | `familiar.react` |
+| `familiaros_say` | Show a short safe speech bubble, optionally with a reaction. | `familiar.say` |
 
-`openpets_say` is validated before it reaches the desktop app. Messages must be short, single-line, and must not look like code, logs, secrets, URLs, or file paths.
+`familiaros_say` is validated before it reaches the desktop app. Messages must be short, single-line, and must not look like code, logs, secrets, URLs, or file paths.
 
-## Pet targeting
+## Familiar targeting
 
-If the MCP server or hook command was configured without `--pet`, events target the desktop default pet.
+If the MCP server or hook command was configured without `--familiar`, events target the desktop default familiar.
 
-If it was configured with `--pet <petId>`, the process asks the desktop app for a lease. A valid installed non-default pet opens as an explicit agent pet window. Missing, invalid, broken, built-in, or default pet requests fall back to the default pet.
+If it was configured with `--familiar <petId>`, the process asks the desktop app for a lease. A valid installed non-default familiar opens as an explicit agent familiar window. Missing, invalid, broken, built-in, or default familiar requests fall back to the default familiar.
 
-Explicit leases expire after a short TTL unless refreshed. When the last explicit lease for a pet expires or is released, OpenPets clears and closes that agent pet window.
+Explicit leases expire after a short TTL unless refreshed. When the last explicit lease for a familiar expires or is released, FamiliarOS clears and closes that agent familiar window.
 
 ## Claude hook reaction and speech mapping
 
-Claude hooks are decorative and best-effort. They must not block, approve, deny, or change Claude's behavior. If OpenPets is closed or IPC is unavailable, the hook exits successfully and silently.
+Claude hooks are decorative and best-effort. They must not block, approve, deny, or change Claude's behavior. If FamiliarOS is closed or IPC is unavailable, the hook exits successfully and silently.
 
 | Claude event | Trigger condition | Reaction | Speech bubble |
 | --- | --- | --- | --- |
@@ -204,7 +204,7 @@ Claude hooks are decorative and best-effort. They must not block, approve, deny,
 
 Test-like Bash detection is intentionally coarse and private. It may inspect only a bounded command string to classify the reaction. The command text is never sent to speech.
 
-Claude hooks do **not** use the left/right walking animations or the `running` reaction. The `running-right` and `running-left` sprite rows are reserved for pet drag/move motion, and generic Bash/shell activity is silent by default. Hook reactions use quieter phase changes instead: editing maps to the generic active-work row, thinking maps to `review`, waiting/testing maps to `waiting`, success maps to `jumping`, and errors map to `failed`.
+Claude hooks do **not** use the left/right walking animations or the `running` reaction. The `running-right` and `running-left` sprite rows are reserved for familiar drag/move motion, and generic Bash/shell activity is silent by default. Hook reactions use quieter phase changes instead: editing maps to the generic active-work row, thinking maps to `review`, waiting/testing maps to `waiting`, success maps to `jumping`, and errors map to `failed`.
 
 ## Hook speech pools
 
@@ -235,4 +235,4 @@ Throttle state stores only speech-category and reaction timestamp keys, never pr
 - Hook debug logs sanitize path-like values. MCP/client-side validation separately rejects secret-looking speech.
 - Speech is static and local; it does not include model-generated text.
 - Tool input and command text are used only for coarse reaction classification.
-- Managed setup refuses unsafe symlinks and non-regular files. Claude memory files also have an oversized-file safety limit before OpenPets edits them.
+- Managed setup refuses unsafe symlinks and non-regular files. Claude memory files also have an oversized-file safety limit before FamiliarOS edits them.
diff --git a/docs/cursor-integration.md b/docs/cursor-integration.md
index ece0e0aa..58918e4f 100644
--- a/docs/cursor-integration.md
+++ b/docs/cursor-integration.md
@@ -1,16 +1,16 @@
 # Cursor Integration
 
-OpenPets supports Cursor through MCP configuration plus optional project rules. This document is the user and developer reference for the current integration, safety model, implementation files, and future phases.
+FamiliarOS supports Cursor through MCP configuration plus optional project rules. This document is the user and developer reference for the current integration, safety model, implementation files, and future phases.
 
 ## Current status
 
 | Capability | Status | How it works |
 | --- | --- | --- |
-| Cursor MCP tools | Implemented | Cursor runs `@open-pets/mcp` as a stdio MCP server. |
-| Desktop global setup | Implemented | Desktop Agent Setup manages `~/.cursor/mcp.json`, only `mcpServers.openpets`. |
-| CLI project setup | Implemented | `openpets configure --agent cursor` manages `<project>/.cursor/mcp.json`. |
-| Project rules | Implemented | `openpets configure --agent cursor --rules-only` manages `<project>/.cursor/rules/openpets.mdc`. |
-| Global/user rules | Not implemented | Cursor exposes user rules through Settings; OpenPets does not assume a safe editable file path. |
+| Cursor MCP tools | Implemented | Cursor runs `@familiaros/mcp` as a stdio MCP server. |
+| Desktop global setup | Implemented | Desktop Agent Setup manages `~/.cursor/mcp.json`, only `mcpServers.familiaros`. |
+| CLI project setup | Implemented | `familiaros configure --agent cursor` manages `<project>/.cursor/mcp.json`. |
+| Project rules | Implemented | `familiaros configure --agent cursor --rules-only` manages `<project>/.cursor/rules/familiaros.mdc`. |
+| Global/user rules | Not implemented | Cursor exposes user rules through Settings; FamiliarOS does not assume a safe editable file path. |
 | Hooks / ambient lifecycle reactions | Future phase | Requires a dedicated validation spike before writing hooks config. |
 | Cursor extension/plugin | Future phase | Optional polish after config and hook behavior are proven. |
 
@@ -20,19 +20,19 @@ For now, Cursor integration is complete enough for MCP + project guidance. The n
 
 ### Prerequisites
 
-- OpenPets desktop app is running.
+- FamiliarOS desktop app is running.
 - Cursor is installed.
 - Node/npm are available for published `npx` mode, or the package is already cached.
 - For project-local CLI setup, run commands from the project you want Cursor to use.
 
 ### Desktop: global Cursor MCP setup
 
-Use this when you want Cursor to see OpenPets tools in every Cursor project.
+Use this when you want Cursor to see FamiliarOS tools in every Cursor project.
 
-1. Open OpenPets desktop.
+1. Open FamiliarOS desktop.
 2. Open **Integrations**.
 3. Choose **Cursor**.
-4. Pick a pet if desired.
+4. Pick a familiar if desired.
 5. Click **Install global setup**.
 6. Restart/reload Cursor or start a fresh chat if Cursor does not pick up the server immediately.
 
@@ -45,7 +45,7 @@ Desktop writes only this global file:
 It manages only:
 
 ```text
-mcpServers.openpets
+mcpServers.familiaros
 ```
 
 Unrelated Cursor MCP servers and top-level config are preserved.
@@ -55,13 +55,13 @@ Unrelated Cursor MCP servers and top-level config are preserved.
 Use this when you want the current repository to own its Cursor MCP config.
 
 ```bash
-openpets configure --agent cursor --pet PET_ID
+familiaros configure --agent cursor --familiar PET_ID
 ```
 
 or from another directory:
 
 ```bash
-openpets configure --agent cursor --cwd /path/to/project --pet PET_ID
+familiaros configure --agent cursor --cwd /path/to/project --familiar PET_ID
 ```
 
 The CLI writes:
@@ -70,53 +70,53 @@ The CLI writes:
 <project>/.cursor/mcp.json
 ```
 
-`--pet` is optional. If omitted, the CLI may prompt from installed pets through the running desktop app.
+`--familiar` is optional. If omitted, the CLI may prompt from installed familiars through the running desktop app.
 
 ### CLI: project Cursor rules
 
-Cursor rules tell Cursor when and how to use the OpenPets MCP tools safely. They are prompt guidance, not event hooks.
+Cursor rules tell Cursor when and how to use the FamiliarOS MCP tools safely. They are prompt guidance, not event hooks.
 
 Install or update only the project rule:
 
 ```bash
-openpets configure --agent cursor --rules-only
+familiaros configure --agent cursor --rules-only
 ```
 
 Install MCP config and rules together:
 
 ```bash
-openpets configure --agent cursor --pet PET_ID --with-rules
+familiaros configure --agent cursor --familiar PET_ID --with-rules
 ```
 
 Remove only the managed project rule:
 
 ```bash
-openpets configure --agent cursor --remove-rules
+familiaros configure --agent cursor --remove-rules
 ```
 
 The rules file is:
 
 ```text
-<project>/.cursor/rules/openpets.mdc
+<project>/.cursor/rules/familiaros.mdc
 ```
 
-`--rules-only` and `--remove-rules` do not need `--pet` and do not need the OpenPets desktop app to be reachable.
+`--rules-only` and `--remove-rules` do not need `--familiar` and do not need the FamiliarOS desktop app to be reachable.
 
 ### Force / conflict behavior
 
-OpenPets refuses to overwrite unknown user content by default.
+FamiliarOS refuses to overwrite unknown user content by default.
 
-Use `--force` only when you intentionally want to replace the dedicated OpenPets entry/file:
+Use `--force` only when you intentionally want to replace the dedicated FamiliarOS entry/file:
 
 ```bash
-openpets configure --agent cursor --rules-only --force
-openpets configure --agent cursor --pet PET_ID --with-rules --force
+familiaros configure --agent cursor --rules-only --force
+familiaros configure --agent cursor --familiar PET_ID --with-rules --force
 ```
 
 `--force` is scoped:
 
-- MCP replacement touches only `mcpServers.openpets`.
-- Rules replacement touches only `.cursor/rules/openpets.mdc`.
+- MCP replacement touches only `mcpServers.familiaros`.
+- Rules replacement touches only `.cursor/rules/familiaros.mdc`.
 
 Backups are created before replace/remove operations.
 
@@ -124,52 +124,52 @@ Backups are created before replace/remove operations.
 
 ### MCP tools
 
-OpenPets exposes these tools through `@open-pets/mcp`:
+FamiliarOS exposes these tools through `@familiaros/mcp`:
 
-- `openpets_status`
-- `openpets_react`
-- `openpets_say`
+- `familiaros_status`
+- `familiaros_react`
+- `familiaros_say`
 
 The expected Cursor MCP entry is strict JSON:
 
 ```json
 {
   "mcpServers": {
-    "openpets": {
+    "familiaros": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@open-pets/mcp@VERSION", "--pet", "PET_ID"]
+      "args": ["-y", "@familiaros/mcp@VERSION", "--familiar", "PET_ID"]
     }
   }
 }
 ```
 
-If no pet is selected, `--pet PET_ID` is omitted and OpenPets routes to the default pet.
+If no familiar is selected, `--familiar PET_ID` is omitted and FamiliarOS routes to the default familiar.
 
 ### Project rule content
 
-OpenPets writes a short `.mdc` rule with managed markers:
+FamiliarOS writes a short `.mdc` rule with managed markers:
 
 ```mdc
 ---
-description: Use OpenPets MCP tools for lightweight coding-status feedback.
+description: Use FamiliarOS MCP tools for lightweight coding-status feedback.
 ---
 
-<!-- OPENPETS:CURSOR_RULES:START -->
-# OpenPets status feedback
+<!-- FAMILIAROS:CURSOR_RULES:START -->
+# FamiliarOS status feedback
 
-You may use the OpenPets MCP tools as a brief, safe status channel during meaningful coding work.
+You may use the FamiliarOS MCP tools as a brief, safe status channel during meaningful coding work.
 
-- Use `openpets_say` sparingly for major milestones, blocking states, completion, or when review is needed.
-- Prefer `openpets_react` over speech for lightweight progress such as thinking, working, testing, success, or error.
+- Use `familiaros_say` sparingly for major milestones, blocking states, completion, or when review is needed.
+- Prefer `familiaros_react` over speech for lightweight progress such as thinking, working, testing, success, or error.
 - Keep messages short, user-facing, and safe.
-- Do not send prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, file paths, or other sensitive content through OpenPets.
-- Do not spam every internal step; use OpenPets only for meaningful progress changes and continue normally if a status update is unnecessary.
-- If OpenPets is unavailable, continue the coding task without failing.
-<!-- OPENPETS:CURSOR_RULES:END -->
+- Do not send prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, file paths, or other sensitive content through FamiliarOS.
+- Do not spam every internal step; use FamiliarOS only for meaningful progress changes and continue normally if a status update is unnecessary.
+- If FamiliarOS is unavailable, continue the coding task without failing.
+<!-- FAMILIAROS:CURSOR_RULES:END -->
 ```
 
-OpenPets intentionally does **not** write `alwaysApply: true` by default to reduce context noise and tool spam.
+FamiliarOS intentionally does **not** write `alwaysApply: true` by default to reduce context noise and tool spam.
 
 ## Cursor behavior and caveats
 
@@ -180,11 +180,11 @@ Cursor documents:
 - Global MCP config: `~/.cursor/mcp.json`
 - Project MCP config: `.cursor/mcp.json`
 
-Cursor merges global and project config. Project config takes priority for duplicate server names. OpenPets uses the server name `openpets`, so a project-local `mcpServers.openpets` can override the global OpenPets server.
+Cursor merges global and project config. Project config takes priority for duplicate server names. FamiliarOS uses the server name `familiaros`, so a project-local `mcpServers.familiaros` can override the global FamiliarOS server.
 
 ### Restart/reload/new chat
 
-Cursor MCP docs and behavior can vary by version and environment. If Cursor does not show OpenPets tools after setup:
+Cursor MCP docs and behavior can vary by version and environment. If Cursor does not show FamiliarOS tools after setup:
 
 1. Start a new chat.
 2. Reload Cursor.
@@ -195,23 +195,23 @@ Rules are included as chat context. A new or refreshed chat may be needed for ch
 
 ### WSL, remote, and devcontainer caveats
 
-OpenPets desktop runs on the local OS and the MCP server connects to its local IPC endpoint. If Cursor runs MCP commands inside WSL, a remote host, or a devcontainer, the command may run somewhere that cannot reach the desktop app.
+FamiliarOS desktop runs on the local OS and the MCP server connects to its local IPC endpoint. If Cursor runs MCP commands inside WSL, a remote host, or a devcontainer, the command may run somewhere that cannot reach the desktop app.
 
 Symptoms:
 
 - Cursor shows MCP connection failures.
-- `openpets_status` reports the app is unreachable.
+- `familiaros_status` reports the app is unreachable.
 - The configured `npx` or `node` command is available in one environment but not the one Cursor uses.
 
-Workarounds may require environment-specific command wrappers. OpenPets does not currently write WSL/devcontainer-specific MCP entries automatically.
+Workarounds may require environment-specific command wrappers. FamiliarOS does not currently write WSL/devcontainer-specific MCP entries automatically.
 
 ## Security and privacy model
 
-OpenPets treats Cursor config as user-owned.
+FamiliarOS treats Cursor config as user-owned.
 
 ### MCP config safety
 
-The `@open-pets/cursor` helpers:
+The `@familiaros/cursor` helpers:
 
 - read strict JSON only;
 - cap MCP config files at 256 KiB;
@@ -220,34 +220,34 @@ The `@open-pets/cursor` helpers:
 - reject unsafe/symlinked parent paths;
 - classify missing, installed, needs-update, conflict, invalid, and error states;
 - preserve unrelated MCP servers and top-level fields;
-- preview only the OpenPets entry by default;
+- preview only the FamiliarOS entry by default;
 - redact sensitive fields if broader config previewing is needed;
 - write with temp files and atomic rename;
 - create backups before overwrite/remove operations;
-- remove only recognized OpenPets-managed entries.
+- remove only recognized FamiliarOS-managed entries.
 
 ### Rules safety
 
 The rules helper:
 
-- writes only `<project>/.cursor/rules/openpets.mdc`;
-- treats the file as managed only when the exact OpenPets frontmatter and a single ordered marker pair are present;
+- writes only `<project>/.cursor/rules/familiaros.mdc`;
+- treats the file as managed only when the exact FamiliarOS frontmatter and a single ordered marker pair are present;
 - classifies user-authored content as a conflict;
 - caps rule file reads at 64 KiB;
 - rejects symlinks, non-regular files, unsafe parents, and dangling symlinks;
 - backs up before replacement/removal;
-- removes only the managed `openpets.mdc` file and leaves `.cursor` directories in place.
+- removes only the managed `familiaros.mdc` file and leaves `.cursor` directories in place.
 
-### What OpenPets does not do
+### What FamiliarOS does not do
 
-OpenPets does not:
+FamiliarOS does not:
 
 - edit Cursor user/global rules settings;
 - edit `~/.cursor/permissions.json`;
 - add broad MCP/tool allowlists;
 - write Cursor hooks yet;
 - write project rules from desktop without a reviewed project picker;
-- include prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, or paths in pet messages.
+- include prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, or paths in familiar messages.
 
 ## Developer implementation map
 
@@ -260,12 +260,12 @@ Key files:
 - `packages/cursor/src/cursor-mcp.ts`
   - MCP entry builders.
   - Global/project MCP path helpers.
-  - Pet id and version validation.
+  - Familiar id and version validation.
 - `packages/cursor/src/cursor-status.ts`
   - MCP config safe read/classification/write/remove planning.
-  - Managed OpenPets MCP entry detection.
+  - Managed FamiliarOS MCP entry detection.
 - `packages/cursor/src/cursor-previews.ts`
-  - OpenPets-only preview and secret redaction helpers.
+  - FamiliarOS-only preview and secret redaction helpers.
 - `packages/cursor/src/cursor-rules.ts`
   - Project rules content builder.
   - Rules status classification.
@@ -284,12 +284,12 @@ Files:
 Supported Cursor flags:
 
 ```bash
-openpets configure --agent cursor --pet PET_ID
-openpets configure --agent cursor --cwd /path/to/project --pet PET_ID
-openpets configure --agent cursor --pet PET_ID --with-rules
-openpets configure --agent cursor --rules-only
-openpets configure --agent cursor --remove-rules
-openpets configure --agent cursor --rules-only --force
+familiaros configure --agent cursor --familiar PET_ID
+familiaros configure --agent cursor --cwd /path/to/project --familiar PET_ID
+familiaros configure --agent cursor --familiar PET_ID --with-rules
+familiaros configure --agent cursor --rules-only
+familiaros configure --agent cursor --remove-rules
+familiaros configure --agent cursor --rules-only --force
 ```
 
 Important semantics:
@@ -297,7 +297,7 @@ Important semantics:
 - Existing `configure --agent cursor` remains MCP-only.
 - `--with-rules`, `--rules-only`, and `--remove-rules` are mutually exclusive.
 - Cursor rules flags are rejected for non-Cursor agents.
-- `--rules-only` and `--remove-rules` avoid pet resolution and desktop connectivity.
+- `--rules-only` and `--remove-rules` avoid familiar resolution and desktop connectivity.
 - `--with-rules` preflights MCP and rules plans before writing either file, preventing surprising partial setup.
 
 ### Desktop integration
@@ -314,14 +314,14 @@ Desktop behavior:
 
 - global Cursor MCP install/update/replace/remove in `~/.cursor/mcp.json`;
 - Cursor detail pane with global warning;
-- OpenPets-only MCP preview;
+- FamiliarOS-only MCP preview;
 - project rules preview and copy button;
 - no desktop project rules writes;
 - no new Cursor rules IPC actions.
 
 ### Release plumbing
 
-`@open-pets/cursor` is a public workspace package and is published before packages that consume it.
+`@familiaros/cursor` is a public workspace package and is published before packages that consume it.
 
 Relevant files:
 
@@ -341,8 +341,8 @@ Validated:
 - restart/reload guidance;
 - global/project merge and project priority;
 - documented stdio fields: `type`, `command`, `args`, optional `env`, optional `envFile`;
-- direct pinned command strategy: `npx -y @open-pets/mcp@VERSION`;
-- real Cursor MCP smoke on 2026-05-14 with `@open-pets/mcp@2.0.6`, showing connected with three tools enabled.
+- direct pinned command strategy: `npx -y @familiaros/mcp@VERSION`;
+- real Cursor MCP smoke on 2026-05-14 with `@familiaros/mcp@2.0.6`, showing connected with three tools enabled.
 
 ### Phase 2 rules
 
@@ -365,15 +365,15 @@ Implementation was reviewed with Oracle gates:
 Checks passed during implementation:
 
 ```bash
-pnpm --filter @open-pets/cursor check
-pnpm --filter @open-pets/cli check
-pnpm --filter @open-pets/desktop check
+pnpm --filter @familiaros/cursor check
+pnpm --filter @familiaros/cli check
+pnpm --filter @familiaros/desktop check
 pnpm check
 ```
 
 ## What is next?
 
-Cursor MCP + project rules are done for now. The next integration phase would be **Cursor hooks** if we want automatic pet reactions during Cursor agent lifecycle events.
+Cursor MCP + project rules are done for now. The next integration phase would be **Cursor hooks** if we want automatic familiar reactions during Cursor agent lifecycle events.
 
 Before implementing hooks, run a validation spike and record:
 
@@ -387,7 +387,7 @@ Before implementing hooks, run a validation spike and record:
 - execution location for local, WSL, remote, and devcontainer setups;
 - whether hook commands can avoid leaking prompt/tool/path data.
 
-Until that spike is complete, OpenPets should not write Cursor hook config.
+Until that spike is complete, FamiliarOS should not write Cursor hook config.
 
 ## Official references
 
diff --git a/docs/cursor-phase-1-spec.md b/docs/cursor-phase-1-spec.md
index 7126b321..5663d81c 100644
--- a/docs/cursor-phase-1-spec.md
+++ b/docs/cursor-phase-1-spec.md
@@ -11,7 +11,7 @@ This spec turns `docs/cursor-integration.md` into an implementation-ready Phase
 
 ## Goals
 
-1. Let users configure Cursor to use OpenPets MCP tools.
+1. Let users configure Cursor to use FamiliarOS MCP tools.
 2. Preserve all unrelated Cursor config safely.
 3. Provide clear status, preview, install, replace, remove, and doctor flows.
 4. Avoid leaking unrelated Cursor secrets in previews, logs, or errors.
@@ -75,13 +75,13 @@ Required desktop UX:
 
 - Cursor card status.
 - Cursor detail pane.
-- pet selector.
+- familiar selector.
 - command mode or preview matching existing Claude/OpenCode patterns.
 - install integration.
 - replace configuration for conflicts.
 - remove integration.
 - refresh status.
-- copy OpenPets-only config preview.
+- copy FamiliarOS-only config preview.
 - warning that Cursor may need restart/reload.
 - warning that published `npx` mode may need npm/network/cache availability.
 
@@ -92,8 +92,8 @@ Cursor status text must be **configuration status**, not “Cursor app installed
 If CLI work is included in Phase 1, support:
 
 ```bash
-openpets configure --agent cursor --pet PET_ID
-openpets configure --agent cursor --cwd /path/to/project --pet PET_ID
+familiaros configure --agent cursor --familiar PET_ID
+familiaros configure --agent cursor --cwd /path/to/project --familiar PET_ID
 ```
 
 CLI scope must match existing `configure` patterns:
@@ -108,9 +108,9 @@ Global CLI setup must require an explicit future flag such as `--global`. If glo
 Update:
 
 - root workspace build/check coverage through existing `packages/*` workspace matching;
-- `packages/cli/package.json` dependency on `@open-pets/cursor` if CLI consumes it;
-- `apps/desktop/package.json` dependency on `@open-pets/cursor` if desktop consumes it;
-- `scripts/release-npm.mjs` publish order if `@open-pets/cursor` is public;
+- `packages/cli/package.json` dependency on `@familiaros/cursor` if CLI consumes it;
+- `apps/desktop/package.json` dependency on `@familiaros/cursor` if desktop consumes it;
+- `scripts/release-npm.mjs` publish order if `@familiaros/cursor` is public;
 - `apps/desktop/src/check-packaging-contract.ts` if bundled desktop runtime needs cursor helpers packaged.
 
 ## Validation spike before writes ship
@@ -122,12 +122,12 @@ Required validation:
 1. Confirm Cursor accepts strict JSON in `~/.cursor/mcp.json` and `.cursor/mcp.json`. **Validated from docs:** Cursor documents MCP config as JSON.
 2. Confirm whether Cursor accepts JSONC. **Validated from docs:** no JSONC evidence for MCP config; implementation must assume strict JSON.
 3. Confirm whether Cursor requires restart/reload after MCP config changes. **Validated from docs:** manual install guidance says save file and restart Cursor.
-4. Confirm global/project precedence when both define `mcpServers.openpets`. **Validated from docs:** global and project configs are merged; project scope takes priority.
-5. Confirm duplicate `openpets` server behavior across scopes. **Partially validated:** project priority is documented; UI duplicate behavior has community reports and needs real smoke confirmation.
+4. Confirm global/project precedence when both define `mcpServers.familiaros`. **Validated from docs:** global and project configs are merged; project scope takes priority.
+5. Confirm duplicate `familiaros` server behavior across scopes. **Partially validated:** project priority is documented; UI duplicate behavior has community reports and needs real smoke confirmation.
 6. Confirm documented fields for stdio config: `type`, `command`, `args`, and optional supported fields such as `env` or `envFile` if needed. **Validated from docs:** use `type`, `command`, `args`, optional `env`, optional `envFile`; do not use `cwd` in MCP file entries unless later verified.
 7. Confirm unknown fields are not needed. **Validated from docs:** unknown fields are not documented; do not write them in Phase 1.
-8. Confirm whether command mode should prefer direct `@open-pets/mcp@VERSION` or `@open-pets/cli@VERSION mcp`. **Decision:** prefer direct pinned `@open-pets/mcp@VERSION` for Phase 1.
-9. Smoke test a real Cursor MCP connection on at least one machine before marking active in docs. **Passed 2026-05-14:** global `~/.cursor/mcp.json` using direct pinned `@open-pets/mcp@2.0.6` showed connected in Cursor with 3 OpenPets tools enabled.
+8. Confirm whether command mode should prefer direct `@familiaros/mcp@VERSION` or `@familiaros/cli@VERSION mcp`. **Decision:** prefer direct pinned `@familiaros/mcp@VERSION` for Phase 1.
+9. Smoke test a real Cursor MCP connection on at least one machine before marking active in docs. **Passed 2026-05-14:** global `~/.cursor/mcp.json` using direct pinned `@familiaros/mcp@2.0.6` showed connected in Cursor with 3 FamiliarOS tools enabled.
 
 Do not code final entry builders beyond temporary validation helpers until the command strategy is chosen and recorded in the validation log.
 
@@ -143,7 +143,7 @@ Two acceptable strategies:
 {
   "type": "stdio",
   "command": "npx",
-  "args": ["-y", "@open-pets/mcp@2.0.6", "--pet", "PET_ID"]
+  "args": ["-y", "@familiaros/mcp@2.0.6", "--familiar", "PET_ID"]
 }
 ```
 
@@ -156,7 +156,7 @@ Pros:
 Cons:
 
 - durable config points at `npx` and may need npm/network/cache;
-- published version must be updated when OpenPets upgrades.
+- published version must be updated when FamiliarOS upgrades.
 
 ### Option B: CLI wrapper
 
@@ -164,7 +164,7 @@ Cons:
 {
   "type": "stdio",
   "command": "npx",
-  "args": ["-y", "@open-pets/cli@2.0.6", "mcp", "--pet", "PET_ID"]
+  "args": ["-y", "@familiaros/cli@2.0.6", "mcp", "--familiar", "PET_ID"]
 }
 ```
 
@@ -178,7 +178,7 @@ Cons:
 - extra package layer;
 - ensure CLI MCP wrapper is stable and quiet for stdio use.
 
-Phase 1 command decision: use direct pinned `@open-pets/mcp@VERSION` in durable configs. Do not ship unpinned `@open-pets/mcp` in durable config unless release policy explicitly accepts floating latest.
+Phase 1 command decision: use direct pinned `@familiaros/mcp@VERSION` in durable configs. Do not ship unpinned `@familiaros/mcp` in durable config unless release policy explicitly accepts floating latest.
 
 ## Config model
 
@@ -192,16 +192,16 @@ Expected top-level shape:
 ```json
 {
   "mcpServers": {
-    "openpets": {
+    "familiaros": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@open-pets/mcp@VERSION", "--pet", "PET_ID"]
+      "args": ["-y", "@familiaros/mcp@VERSION", "--familiar", "PET_ID"]
     }
   }
 }
 ```
 
-OpenPets must write only documented fields in Phase 1. No `openpets` metadata object, comments, or custom marker fields.
+FamiliarOS must write only documented fields in Phase 1. No `familiaros` metadata object, comments, or custom marker fields.
 
 ## Status classification
 
@@ -209,10 +209,10 @@ Define statuses with enough detail for desktop, CLI, and tests.
 
 Suggested status union:
 
-- `missing`: config file or `mcpServers.openpets` does not exist.
-- `installed`: managed-looking OpenPets entry matches expected command mode and selected pet.
-- `needs-update`: OpenPets entry exists but package version, command, args, or pet id differs from expected managed output.
-- `conflict`: `mcpServers.openpets` exists but does not look like an OpenPets-managed entry.
+- `missing`: config file or `mcpServers.familiaros` does not exist.
+- `installed`: managed-looking FamiliarOS entry matches expected command mode and selected familiar.
+- `needs-update`: FamiliarOS entry exists but package version, command, args, or familiar id differs from expected managed output.
+- `conflict`: `mcpServers.familiaros` exists but does not look like an FamiliarOS-managed entry.
 - `invalid`: config exists but is too large, not regular, symlinked, unsafe, or parse-invalid.
 - `error`: unexpected I/O or classification failure.
 
@@ -220,10 +220,10 @@ Suggested status union:
 
 | Status | canInstall | canReplace | canRemove | Write behavior |
 | --- | --- | --- | --- | --- |
-| `missing` | yes | no | no | Install may create config and add `mcpServers.openpets`. |
-| `installed` | no | no | yes | Remove may delete only `mcpServers.openpets`; install is no-op. |
-| `needs-update` | yes | yes | yes | Install/update may replace the recognized OpenPets entry with expected output; remove may delete only the recognized OpenPets entry. |
-| `conflict` | no | yes | no | Replace may overwrite `mcpServers.openpets` only after explicit user confirmation; remove is disallowed because ownership is unknown. |
+| `missing` | yes | no | no | Install may create config and add `mcpServers.familiaros`. |
+| `installed` | no | no | yes | Remove may delete only `mcpServers.familiaros`; install is no-op. |
+| `needs-update` | yes | yes | yes | Install/update may replace the recognized FamiliarOS entry with expected output; remove may delete only the recognized FamiliarOS entry. |
+| `conflict` | no | yes | no | Replace may overwrite `mcpServers.familiaros` only after explicit user confirmation; remove is disallowed because ownership is unknown. |
 | `invalid` | no | no | no | No writes. User must fix config/path manually. |
 | `error` | no | no | no | No writes. User must retry or inspect diagnostics. |
 
@@ -242,20 +242,20 @@ Classification should return:
 - whether install is available;
 - whether replace is available;
 - whether remove is available;
-- OpenPets-only preview entry;
+- FamiliarOS-only preview entry;
 - redacted details only.
 
 ## Managed entry detection
 
 Since Phase 1 writes no custom marker, managed-looking detection is structural:
 
-- server key is exactly `openpets`;
+- server key is exactly `familiaros`;
 - `type` is `stdio`;
-- command/args match one of the accepted OpenPets command strategies;
-- args include a pinned OpenPets package or a bundled/local OpenPets MCP entry;
-- optional `--pet PET_ID` is recognized and validated.
+- command/args match one of the accepted FamiliarOS command strategies;
+- args include a pinned FamiliarOS package or a bundled/local FamiliarOS MCP entry;
+- optional `--familiar PET_ID` is recognized and validated.
 
-Unknown `openpets` entries should be `conflict`, not overwritten without explicit replace.
+Unknown `familiaros` entries should be `conflict`, not overwritten without explicit replace.
 
 ## Schema validation
 
@@ -263,14 +263,14 @@ Before classification or writing:
 
 - top-level config must be an object;
 - `mcpServers`, if present, must be an object;
-- `mcpServers.openpets`, if present, must be an object;
-- for an OpenPets-managed entry, `type` must be `stdio`;
-- for an OpenPets-managed entry, `command` must be a string;
-- for an OpenPets-managed entry, `args` must be an array of strings;
-- malformed non-OpenPets `mcpServers.openpets` should classify as `conflict` if the surrounding config is otherwise safe;
+- `mcpServers.familiaros`, if present, must be an object;
+- for an FamiliarOS-managed entry, `type` must be `stdio`;
+- for an FamiliarOS-managed entry, `command` must be a string;
+- for an FamiliarOS-managed entry, `args` must be an array of strings;
+- malformed non-FamiliarOS `mcpServers.familiaros` should classify as `conflict` if the surrounding config is otherwise safe;
 - malformed top-level config or malformed `mcpServers` should classify as `invalid`;
 - no writes are allowed for `invalid` or `error`;
-- no writes are allowed for `conflict` except explicit replace of only `mcpServers.openpets` after user confirmation.
+- no writes are allowed for `conflict` except explicit replace of only `mcpServers.familiaros` after user confirmation.
 
 ## Read safety
 
@@ -283,7 +283,7 @@ Implement config reads defensively:
 - Enforce max file size before reading. Suggested maximum: 256 KiB.
 - Parse strict JSON unless JSONC support is validated.
 - Treat empty/missing config as `{ "mcpServers": {} }` for preview only.
-- Existing empty config files are `missing` and installable if the file path is otherwise safe; install should replace the empty file with a valid object containing `mcpServers.openpets`.
+- Existing empty config files are `missing` and installable if the file path is otherwise safe; install should replace the empty file with a valid object containing `mcpServers.familiaros`.
 - Do not write after parse or safety errors.
 
 ## Write safety
@@ -298,12 +298,12 @@ Implement config writes defensively:
 - Use private/safe permissions where supported.
 - If creating `.cursor`, create it only after validating nearest existing parent.
 - Do not follow symlinks.
-- Remove only `mcpServers.openpets` on uninstall.
+- Remove only `mcpServers.familiaros` on uninstall.
 - If removing leaves `mcpServers` empty, keep or remove `mcpServers` consistently and document behavior.
 
 ## Preview and diagnostics safety
 
-Default preview must show only the OpenPets entry that would be written.
+Default preview must show only the FamiliarOS entry that would be written.
 
 Do not display the full merged Cursor config unless all unrelated sensitive fields are redacted.
 
@@ -341,10 +341,10 @@ Possible labels:
 Sections:
 
 1. Status summary.
-2. Pet routing selector.
+2. Familiar routing selector.
 3. Command mode and warnings.
 4. Install/replace/remove actions.
-5. OpenPets-only MCP preview.
+5. FamiliarOS-only MCP preview.
 6. Restart/reload note.
 
 ### Warnings
@@ -353,22 +353,22 @@ Include:
 
 - “Cursor may need to be restarted or reloaded after MCP config changes.”
 - “Published mode uses `npx` and may require npm/network/cache access.”
-- “OpenPets only edits its own `mcpServers.openpets` entry.”
+- “FamiliarOS only edits its own `mcpServers.familiaros` entry.”
 
 ## CLI UX details
 
 If included:
 
 ```bash
-openpets configure --agent cursor --pet PET_ID
-openpets configure --agent cursor --cwd /path/to/project --pet PET_ID
+familiaros configure --agent cursor --familiar PET_ID
+familiaros configure --agent cursor --cwd /path/to/project --familiar PET_ID
 ```
 
 CLI should print:
 
 - target config path;
 - status before write;
-- OpenPets-only preview;
+- FamiliarOS-only preview;
 - backup path if written;
 - restart/reload note;
 - command to remove or repair.
@@ -386,24 +386,24 @@ If CLI support is included in Phase 1, it must not make no-`--cwd` mean global o
 - missing config classification;
 - empty config classification;
 - existing unrelated MCP servers preserved;
-- installed status for expected OpenPets entry;
+- installed status for expected FamiliarOS entry;
 - needs-update status for old package version;
-- needs-update status for different pet id;
-- conflict status for non-OpenPets `mcpServers.openpets`;
+- needs-update status for different familiar id;
+- conflict status for non-FamiliarOS `mcpServers.familiaros`;
 - invalid status for parse error;
 - invalid status for oversized file;
 - symlink rejection;
 - non-regular file rejection if feasible in temp tests;
 - backup creation;
 - atomic write result;
-- uninstall removes only OpenPets entry;
+- uninstall removes only FamiliarOS entry;
 - preview redacts or excludes unrelated secrets.
 - non-object top-level config;
 - non-object `mcpServers`;
-- malformed `mcpServers.openpets`;
+- malformed `mcpServers.familiaros`;
 - no write on `invalid`;
 - no write on `conflict` unless explicit replace;
-- explicit replace overwrites only `mcpServers.openpets` and preserves unrelated servers/top-level fields;
+- explicit replace overwrites only `mcpServers.familiaros` and preserves unrelated servers/top-level fields;
 - recursive and case-insensitive redaction.
 
 ### Desktop contract tests
@@ -413,7 +413,7 @@ Update `apps/desktop/src/check-packaging-contract.ts` to assert:
 - Cursor card is active, not `Soon`.
 - Cursor detail pane exists.
 - Cursor actions are bound in preload.
-- `@open-pets/cursor` runtime is packaged if desktop imports it.
+- `@familiaros/cursor` runtime is packaged if desktop imports it.
 - Cursor icon remains bundled.
 
 ### CLI tests
@@ -457,6 +457,6 @@ Record answers here before implementation ships:
 | Duplicate server behavior? | Project priority documented; UI duplicate reports exist | 2026-05-14 | Avoid writing both scopes for same user path; desktop uses global only in Phase 1. |
 | Documented stdio fields? | `type`, `command`, `args`, optional `env`, optional `envFile` | 2026-05-14 | `cwd` is not documented for MCP file entries. |
 | Unknown fields? | Avoid in Phase 1 | 2026-05-14 | No official tolerance guarantee. |
-| Command strategy chosen? | Direct `@open-pets/mcp@VERSION` | 2026-05-14 | Smaller process surface and aligns with existing MCP package. |
+| Command strategy chosen? | Direct `@familiaros/mcp@VERSION` | 2026-05-14 | Smaller process surface and aligns with existing MCP package. |
 | WSL/remote/devcontainer behavior? | Caveat required | 2026-05-14 | No clear official MCP execution-location guarantee; document local command environment requirements. |
-| Real Cursor MCP smoke result? | Passed | 2026-05-14 | Global `~/.cursor/mcp.json` using direct pinned `@open-pets/mcp@2.0.6` showed connected in Cursor with 3 OpenPets tools enabled. |
+| Real Cursor MCP smoke result? | Passed | 2026-05-14 | Global `~/.cursor/mcp.json` using direct pinned `@familiaros/mcp@2.0.6` showed connected in Cursor with 3 FamiliarOS tools enabled. |
diff --git a/docs/cursor-phase-2-rules-spec.md b/docs/cursor-phase-2-rules-spec.md
index d639d788..788ee96e 100644
--- a/docs/cursor-phase-2-rules-spec.md
+++ b/docs/cursor-phase-2-rules-spec.md
@@ -1,17 +1,17 @@
 # Cursor Phase 2 Implementation Spec: Project Rules Guidance
 
-This spec covers the next Cursor integration phase after MCP-only setup. Phase 2 adds optional project-local Cursor rules so Cursor knows when and how to use the OpenPets MCP tools.
+This spec covers the next Cursor integration phase after MCP-only setup. Phase 2 adds optional project-local Cursor rules so Cursor knows when and how to use the FamiliarOS MCP tools.
 
 ## Status
 
 - **Scope:** Cursor project rules only.
-- **Target UX:** CLI-managed project rules in `.cursor/rules/openpets.mdc`, with desktop preview/copy support only unless a separate project-picker UX is designed.
+- **Target UX:** CLI-managed project rules in `.cursor/rules/familiaros.mdc`, with desktop preview/copy support only unless a separate project-picker UX is designed.
 - **Required before implementation ships:** validate current Cursor rule format behavior and record results in this document.
 - **Oracle approval:** approved before implementation; helper, CLI, and desktop phases reviewed between phases.
 
 ## Goals
 
-1. Give Cursor concise guidance for using OpenPets MCP tools during coding sessions.
+1. Give Cursor concise guidance for using FamiliarOS MCP tools during coding sessions.
 2. Keep MCP setup and rules setup separable, explicit, and reversible.
 3. Preserve all unrelated Cursor rules and project files safely.
 4. Avoid editing user/global Cursor settings because no safe editable user rules path is assumed.
@@ -31,13 +31,13 @@ This spec covers the next Cursor integration phase after MCP-only setup. Phase 2
 Default managed file:
 
 ```text
-<project>/.cursor/rules/openpets.mdc
+<project>/.cursor/rules/familiaros.mdc
 ```
 
 Rationale:
 
 - Cursor documents project rules under `.cursor/rules`.
-- A dedicated `openpets.mdc` file avoids modifying user-authored rules.
+- A dedicated `familiaros.mdc` file avoids modifying user-authored rules.
 - Project-local rules can be committed or ignored according to the user's project policy.
 - A dedicated file makes ownership, preview, replace, and remove semantics straightforward.
 
@@ -45,52 +45,52 @@ Do not write legacy `.cursorrules` in Phase 2 unless validation proves it is nec
 
 ## Proposed rule content
 
-The rule should be short and tool-oriented. It should teach Cursor to use OpenPets as lightweight status feedback, not as a required step for every task.
+The rule should be short and tool-oriented. It should teach Cursor to use FamiliarOS as lightweight status feedback, not as a required step for every task.
 
 Proposed managed file:
 
 ```mdc
 ---
-description: Use OpenPets MCP tools for lightweight coding-status feedback.
+description: Use FamiliarOS MCP tools for lightweight coding-status feedback.
 ---
 
-<!-- OPENPETS:CURSOR_RULES:START -->
-# OpenPets status feedback
+<!-- FAMILIAROS:CURSOR_RULES:START -->
+# FamiliarOS status feedback
 
-You may use the OpenPets MCP tools as a brief, safe status channel during meaningful coding work.
+You may use the FamiliarOS MCP tools as a brief, safe status channel during meaningful coding work.
 
-- Use `openpets_say` sparingly for major milestones, blocking states, completion, or when review is needed.
-- Prefer `openpets_react` over speech for lightweight progress such as thinking, working, testing, success, or error.
+- Use `familiaros_say` sparingly for major milestones, blocking states, completion, or when review is needed.
+- Prefer `familiaros_react` over speech for lightweight progress such as thinking, working, testing, success, or error.
 - Keep messages short, user-facing, and safe.
-- Do not send prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, file paths, or other sensitive content through OpenPets.
-- Do not spam every internal step; use OpenPets only for meaningful progress changes and continue normally if a status update is unnecessary.
-- If OpenPets is unavailable, continue the coding task without failing.
-<!-- OPENPETS:CURSOR_RULES:END -->
+- Do not send prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, file paths, or other sensitive content through FamiliarOS.
+- Do not spam every internal step; use FamiliarOS only for meaningful progress changes and continue normally if a status update is unnecessary.
+- If FamiliarOS is unavailable, continue the coding task without failing.
+<!-- FAMILIAROS:CURSOR_RULES:END -->
 ```
 
 Validation must confirm whether the frontmatter keys above are supported in current Cursor. If not, use the simplest documented `.mdc` form that Cursor accepts. Do not add `alwaysApply: true` by default unless smoke testing proves it does not cause excessive tool calls during ordinary coding tasks.
 
 ## Ownership model
 
-Phase 2 should treat the whole `openpets.mdc` file as OpenPets-managed only when the managed markers are present:
+Phase 2 should treat the whole `familiaros.mdc` file as FamiliarOS-managed only when the managed markers are present:
 
-- `<!-- OPENPETS:CURSOR_RULES:START -->`
-- `<!-- OPENPETS:CURSOR_RULES:END -->`
+- `<!-- FAMILIAROS:CURSOR_RULES:START -->`
+- `<!-- FAMILIAROS:CURSOR_RULES:END -->`
 
 Exact managed-file rules:
 
 - exactly one start marker and one end marker;
 - start marker must appear before the end marker;
-- content outside the marker block must be only recognized OpenPets frontmatter and whitespace;
-- recognized OpenPets frontmatter is only the frontmatter generated by `buildCursorOpenPetsRule()` for the current supported format;
+- content outside the marker block must be only recognized FamiliarOS frontmatter and whitespace;
+- recognized FamiliarOS frontmatter is only the frontmatter generated by `buildCursorFamiliarOSRule()` for the current supported format;
 - any duplicate markers, reversed markers, user-authored text outside the managed shape, or unknown frontmatter fields must classify as `conflict`, not `needs-update`.
 
 Classification:
 
-- `missing`: `.cursor/rules/openpets.mdc` does not exist.
+- `missing`: `.cursor/rules/familiaros.mdc` does not exist.
 - `installed`: managed file exists and matches expected content.
 - `needs-update`: managed file has the exact managed shape but generated content differs from expected content.
-- `conflict`: file exists but lacks managed markers, has malformed managed markers, has duplicate markers, has unknown frontmatter, or contains non-OpenPets content outside the expected managed shape.
+- `conflict`: file exists but lacks managed markers, has malformed managed markers, has duplicate markers, has unknown frontmatter, or contains non-FamiliarOS content outside the expected managed shape.
 - `invalid`: unsafe path, symlinked file/parent, non-regular file, oversized file, unreadable file, or invalid parent structure.
 - `error`: unexpected I/O or classification failure.
 
@@ -98,8 +98,8 @@ Classification:
 
 | Status | canInstall | canReplace | canRemove | Write behavior |
 | --- | --- | --- | --- | --- |
-| `missing` | yes | no | no | Create `.cursor/rules/openpets.mdc`. |
-| `installed` | no | no | yes | Remove only the managed `openpets.mdc` file. |
+| `missing` | yes | no | no | Create `.cursor/rules/familiaros.mdc`. |
+| `installed` | no | no | yes | Remove only the managed `familiaros.mdc` file. |
 | `needs-update` | yes | yes | yes | Update/replace the managed file. |
 | `conflict` | no | yes | no | Replace only after explicit user confirmation. |
 | `invalid` | no | no | no | No writes; user must fix manually. |
@@ -111,7 +111,7 @@ If removal leaves `.cursor/rules` empty, Phase 2 may leave the empty directory i
 
 - Accept explicit `projectDir` inputs for production callers.
 - If an explicit `rulesPath` exists for tests, mark it internal/test-only and still enforce containment under the test project root.
-- Resolve the final path and ensure it remains under `<project>/.cursor/rules/openpets.mdc`.
+- Resolve the final path and ensure it remains under `<project>/.cursor/rules/familiaros.mdc`.
 - Reject symlinks for the rule file and relevant parent directories before writing.
 - Reject non-regular files.
 - Use an upper size limit for existing rule files before reading. Suggested max: 64 KiB.
@@ -119,11 +119,11 @@ If removal leaves `.cursor/rules` empty, Phase 2 may leave the empty directory i
 - Write atomically via temp file + rename.
 - Create backups before replacing/removing existing managed files.
 - Never print unrelated project rule file contents.
-- Preview only the OpenPets managed rule content.
+- Preview only the FamiliarOS managed rule content.
 
 ## Package/API design
 
-Extend `@open-pets/cursor` with rule helpers rather than duplicating logic in CLI or desktop.
+Extend `@familiaros/cursor` with rule helpers rather than duplicating logic in CLI or desktop.
 
 Suggested new file:
 
@@ -132,8 +132,8 @@ Suggested new file:
 Suggested exports:
 
 - `getCursorProjectRulesPath(projectDir)`
-- `buildCursorOpenPetsRule(options)`
-- `readCursorOpenPetsRules(path)`
+- `buildCursorFamiliarOSRule(options)`
+- `readCursorFamiliarOSRules(path)`
 - `classifyCursorRulesStatus(result, path, expected)`
 - `planCursorRulesInstall(path, options, allowReplace?)`
 - `planCursorRulesReplace(path, options)`
@@ -150,34 +150,34 @@ Phase 2 should add explicit rules commands/flags without changing the meaning of
 Recommended commands:
 
 ```bash
-openpets configure --agent cursor --pet PET_ID --with-rules
-openpets configure --agent cursor --rules-only
-openpets configure --agent cursor --remove-rules
-openpets configure --agent cursor --rules-only --force
+familiaros configure --agent cursor --familiar PET_ID --with-rules
+familiaros configure --agent cursor --rules-only
+familiaros configure --agent cursor --remove-rules
+familiaros configure --agent cursor --rules-only --force
 ```
 
 Semantics:
 
-- Existing `openpets configure --agent cursor` remains MCP setup.
+- Existing `familiaros configure --agent cursor` remains MCP setup.
 - `--with-rules` performs MCP setup and project rules setup.
 - `--rules-only` writes only the project rules file.
 - `--remove-rules` removes only the managed project rules file.
-- `--force` is required to replace a conflicting `openpets.mdc`.
-- `--cwd` keeps existing project-local behavior and points rules at `<cwd>/.cursor/rules/openpets.mdc`.
+- `--force` is required to replace a conflicting `familiaros.mdc`.
+- `--cwd` keeps existing project-local behavior and points rules at `<cwd>/.cursor/rules/familiaros.mdc`.
 - No global rules CLI behavior in Phase 2.
 
 Flag interaction rules:
 
 - `--with-rules`, `--rules-only`, and `--remove-rules` are mutually exclusive.
-- `--rules-only` and `--remove-rules` do not require `--pet` and must not require OpenPets desktop connectivity.
-- `--with-rules` continues to require the same inputs as MCP setup, including pet selection where currently required.
+- `--rules-only` and `--remove-rules` do not require `--familiar` and must not require FamiliarOS desktop connectivity.
+- `--with-rules` continues to require the same inputs as MCP setup, including familiar selection where currently required.
 - `--with-rules` must preflight both the MCP write plan and the rules write plan before writing either file, so a conflict or invalid state does not create surprising partial setup.
 
 The CLI should print:
 
 - target rule path;
 - rules status;
-- OpenPets-only rule preview;
+- FamiliarOS-only rule preview;
 - backup path when a write removes or replaces an existing file;
 - note that Cursor may need reload/restart or a new chat for rule changes to apply.
 
@@ -190,7 +190,7 @@ Desktop Agent Setup Phase 2 should not write project-local rules by default beca
 Allowed desktop Phase 2 UX:
 
 - show a Cursor rules preview;
-- copy the recommended `.cursor/rules/openpets.mdc` content;
+- copy the recommended `.cursor/rules/familiaros.mdc` content;
 - explain where to save it in a project;
 - link or route users to the CLI command for project-local install.
 
@@ -200,14 +200,14 @@ Do not add desktop project writes unless a separate project-directory picker, pa
 
 Record results here before enabling writes:
 
-- [x] Confirm current Cursor stable accepts `.cursor/rules/openpets.mdc`. Official docs document project rules under `.cursor/rules` and support `.mdc`.
+- [x] Confirm current Cursor stable accepts `.cursor/rules/familiaros.mdc`. Official docs document project rules under `.cursor/rules` and support `.mdc`.
 - [x] Confirm whether `.mdc` frontmatter keys `description` and `alwaysApply` are accepted and produce the intended always-on guidance behavior. Official docs document `description`, `globs`, and `alwaysApply`; Phase 2 intentionally omits `alwaysApply: true` by default.
 - [x] Confirm whether a plain Markdown body without frontmatter is accepted as a fallback. Official docs document both `.md` and `.mdc`; `.mdc` is retained for frontmatter control.
 - [x] Confirm whether Cursor requires reload/restart/new chat before rule changes apply. Official docs do not require reload; UX says Cursor may use changed rules in a new or refreshed chat.
-- [x] Confirm whether `.cursor/rules/openpets.md` is equally supported or if `.mdc` is preferred. Official docs support `.md` and `.mdc`; OpenPets uses `.mdc` for explicit frontmatter.
+- [x] Confirm whether `.cursor/rules/familiaros.md` is equally supported or if `.mdc` is preferred. Official docs support `.md` and `.mdc`; FamiliarOS uses `.mdc` for explicit frontmatter.
 - [x] Confirm that project rules do not require permissions file edits. Official docs do not require permissions file edits for project rules.
-- [ ] Smoke test that Cursor sees the OpenPets rule and still connects to the Phase 1 MCP server.
-- [ ] Smoke test that the rule does not cause excessive OpenPets tool calls during ordinary coding tasks.
+- [ ] Smoke test that Cursor sees the FamiliarOS rule and still connects to the Phase 1 MCP server.
+- [ ] Smoke test that the rule does not cause excessive FamiliarOS tool calls during ordinary coding tasks.
 
 Official docs checked:
 
@@ -223,14 +223,14 @@ Official docs checked:
 
 ## Tests/checks
 
-Add `@open-pets/cursor` checks for:
+Add `@familiaros/cursor` checks for:
 
 - valid rule content generation;
 - project rule path resolution;
 - missing/installed/needs-update/conflict/invalid/error classification;
 - managed marker detection;
 - duplicate, reversed, and missing marker classification;
-- unmanaged `openpets.mdc` conflict behavior;
+- unmanaged `familiaros.mdc` conflict behavior;
 - user text before/after markers and unknown/modified frontmatter conflict behavior;
 - no writes on invalid/error/conflict without force;
 - explicit replace preserving backups;
@@ -244,9 +244,9 @@ Add `@open-pets/cursor` checks for:
 Run at minimum:
 
 ```bash
-pnpm --filter @open-pets/cursor check # passed during implementation
-pnpm --filter @open-pets/cli check # passed during implementation
-pnpm --filter @open-pets/desktop check # passed during implementation
+pnpm --filter @familiaros/cursor check # passed during implementation
+pnpm --filter @familiaros/cli check # passed during implementation
+pnpm --filter @familiaros/desktop check # passed during implementation
 pnpm check # passed during implementation
 ```
 
diff --git a/docs/cursor_todos.md b/docs/cursor_todos.md
index bd710583..f3f44064 100644
--- a/docs/cursor_todos.md
+++ b/docs/cursor_todos.md
@@ -6,12 +6,12 @@ This checklist tracks Cursor implementation work. Each phase has an Oracle appro
 
 - [x] Validate strict JSON vs JSONC support in Cursor MCP config.
 - [x] Validate whether Cursor requires restart/reload after MCP config changes.
-- [x] Validate global/project precedence for duplicate `mcpServers.openpets`.
+- [x] Validate global/project precedence for duplicate `mcpServers.familiaros`.
 - [x] Validate duplicate server behavior across scopes. Project priority is documented; UI duplicate behavior still needs smoke-test awareness.
 - [x] Validate documented stdio fields for Cursor MCP entries.
 - [x] Choose final command strategy:
-  - [x] direct `@open-pets/mcp@VERSION`, or
-  - [ ] `@open-pets/cli@VERSION mcp`.
+  - [x] direct `@familiaros/mcp@VERSION`, or
+  - [ ] `@familiaros/cli@VERSION mcp`.
 - [x] Smoke test real Cursor MCP connection.
 - [x] Record validation results in `docs/cursor-phase-1-spec.md` and/or `docs/cursor-integration.md`.
 - [x] **Oracle review/approval gate.**
@@ -24,7 +24,7 @@ This checklist tracks Cursor implementation work. Each phase has an Oracle appro
 - [x] Add status/classification helpers.
 - [x] Add safe read helpers.
 - [x] Add safe write/remove helpers.
-- [x] Add OpenPets-only preview helpers.
+- [x] Add FamiliarOS-only preview helpers.
 - [x] Add redaction helpers.
 - [x] Add package build/typecheck/test/check scripts.
 - [x] Add temp-file tests for missing/empty config.
@@ -40,13 +40,13 @@ This checklist tracks Cursor implementation work. Each phase has an Oracle appro
 
 ## Phase 1C — CLI integration
 
-- [x] Add `@open-pets/cursor` dependency to CLI if CLI consumes shared helpers.
+- [x] Add `@familiaros/cursor` dependency to CLI if CLI consumes shared helpers.
 - [x] Add `cursor` to accepted configure agents.
 - [x] Implement project-local default behavior matching existing configure semantics:
   - [x] no `--cwd` → `process.cwd()/.cursor/mcp.json`;
   - [x] `--cwd` → `<cwd>/.cursor/mcp.json`.
 - [x] Do not add global CLI behavior unless explicit `--global` is designed and reviewed.
-- [x] Print target path, status, OpenPets-only preview, backup path, and restart/reload note.
+- [x] Print target path, status, FamiliarOS-only preview, backup path, and restart/reload note.
 - [x] Ensure unrelated Cursor config secrets are never printed.
 - [x] Add CLI contract tests.
 - [x] Run CLI/package checks.
@@ -54,15 +54,15 @@ This checklist tracks Cursor implementation work. Each phase has an Oracle appro
 
 ## Phase 1D — Desktop Agent Setup
 
-- [x] Add `@open-pets/cursor` dependency to desktop if desktop consumes shared helpers.
+- [x] Add `@familiaros/cursor` dependency to desktop if desktop consumes shared helpers.
 - [x] Replace Cursor “Soon” card with active config-status card.
 - [x] Add Cursor detail pane.
-- [x] Add pet selector.
+- [x] Add familiar selector.
 - [x] Add install/update/replace/remove/refresh/copy-preview actions.
 - [x] Use global `~/.cursor/mcp.json` only in desktop Phase 1.
 - [x] Show warning that Cursor may need restart/reload.
 - [x] Show warning that published `npx` mode may need npm/network/cache access.
-- [x] Show warning that OpenPets edits only `mcpServers.openpets`.
+- [x] Show warning that FamiliarOS edits only `mcpServers.familiaros`.
 - [x] Bind preload actions.
 - [x] Add desktop contract checks.
 - [x] Run desktop checks.
@@ -88,7 +88,7 @@ This checklist tracks Cursor implementation work. Each phase has an Oracle appro
 - [x] Draft Phase 2 rules spec in `docs/cursor-phase-2-rules-spec.md`.
 - [x] **Oracle review before implementation.**
 - [x] Run/record Cursor rules validation spike.
-- [x] Implement `@open-pets/cursor` rules helpers.
+- [x] Implement `@familiaros/cursor` rules helpers.
 - [x] Add CLI project-local rules install/update/remove flow.
 - [x] Add desktop rules preview/copy guidance only, unless separately reviewed.
 - [x] Run package and full checks.
diff --git a/docs/front_refactor.md b/docs/front_refactor.md
index 28e04399..0b4e4136 100644
--- a/docs/front_refactor.md
+++ b/docs/front_refactor.md
@@ -2,24 +2,24 @@
 
 ## Current Situation
 
-The desktop app now uses the React Control Center as the production management UI. Pets, Settings, Plugins, and Integrations are routed inside the singleton Control Center window, and tray actions target those routes directly.
+The desktop app now uses the React Control Center as the production management UI. Familiars, Settings, Plugins, and Integrations are routed inside the singleton Control Center window, and tray actions target those routes directly.
 
-The legacy generated task-window UI has been removed: `apps/desktop/preload.cjs`, `apps/desktop/src/plugins-window.ts`, and the legacy plugins-window test are gone. Transparent pet windows and plugin SDK windows remain separate lightweight renderers.
+The legacy generated task-window UI has been removed: `apps/desktop/preload.cjs`, `apps/desktop/src/plugins-window.ts`, and the legacy plugins-window test are gone. Transparent familiar windows and plugin SDK windows remain separate lightweight renderers.
 
 ## Goal
 
-Move the desktop management UI from generated HTML/CSS strings and preload-driven DOM updates to a React + Tailwind Control Center, while keeping desktop pet windows lightweight and separate.
+Move the desktop management UI from generated HTML/CSS strings and preload-driven DOM updates to a React + Tailwind Control Center, while keeping desktop familiar windows lightweight and separate.
 
 ## End Goal
 
-The end goal is a single polished desktop management experience for OpenPets:
+The end goal is a single polished desktop management experience for FamiliarOS:
 
 ```text
 Tray app
-  ├─ animated desktop pet windows
+  ├─ animated desktop familiar windows
   └─ one React/Tailwind Control Center
        ├─ Dashboard
-       ├─ Pets
+       ├─ Familiars
        ├─ Integrations
        ├─ Plugins
        └─ Settings
@@ -27,7 +27,7 @@ Tray app
 
 The Control Center should become the one place where users manage everything:
 
-- choose and install pets
+- choose and install familiars
 - configure coding-agent integrations
 - manage plugins
 - tune settings
@@ -35,46 +35,46 @@ The Control Center should become the one place where users manage everything:
 
 The old separate task windows should eventually disappear. The tray should still exist, but tray actions should route into the Control Center instead of opening independent windows.
 
-The pet windows themselves should stay separate from React. They are performance- and behavior-sensitive transparent desktop windows, so they should remain small, focused renderers responsible only for showing pets, speech bubbles, and reactions.
+The familiar windows themselves should stay separate from React. They are performance- and behavior-sensitive transparent desktop windows, so they should remain small, focused renderers responsible only for showing familiars, speech bubbles, and reactions.
 
 Final architecture target:
 
-- **Main process**: app lifecycle, tray, state, IPC handlers, services, pet/plugin/integration logic.
+- **Main process**: app lifecycle, tray, state, IPC handlers, services, familiar/plugin/integration logic.
 - **Control Center renderer**: React UI, routes, forms, visual polish, local UI state.
 - **Preloads**: narrow typed bridges only, no DOM rendering.
-- **Pet renderers**: lightweight sprite/speech renderers, not part of Control Center.
+- **Familiar renderers**: lightweight sprite/speech renderers, not part of Control Center.
 
 From a product perspective, the end state should feel like a clean native-quality companion app rather than a set of separate utility dialogs.
 
 ## Current Direction
 
 - Keep the app tray-first.
-- Keep existing transparent pet windows outside React.
+- Keep existing transparent familiar windows outside React.
 - Use a single Control Center window for management UI.
 - Route tray actions into Control Center pages instead of independent task windows.
-- Keep transparent pet windows separate from React.
+- Keep transparent familiar windows separate from React.
 
-## Phase 1: Pets Preview
+## Phase 1: Familiars Preview
 
 Implemented first as a reviewable prototype and now promoted into the primary management shell:
 
 - `Control Center...` opens the React renderer.
-- Pet management opens through the Control Center Pets route.
+- Familiar management opens through the Control Center Familiars route.
 - Renderer lives under `apps/desktop/src/renderer/`.
 - Vite outputs packaged assets to `apps/desktop/dist/renderer/`.
 - `control-center-preload.cjs` exposes narrow page-specific APIs.
 
-The Pets page includes:
+The Familiars page includes:
 
-- installed pets
-- catalog pets
+- installed familiars
+- catalog familiars
 - catalog pagination
 - catalog search
-- Codex pets
-- pet selection/detail pane
+- Codex familiars
+- familiar selection/detail pane
 - install/import/set default/remove actions
 - animated sprite-frame preview
-- styling based on the existing Pet Manager and Integrations pages
+- styling based on the existing Familiar Manager and Integrations pages
 
 ## What We Changed
 
@@ -115,7 +115,7 @@ Important details:
   - Node integration disabled
   - navigation blocked
   - `window.open` blocked
-- In development, it can load `OPENPETS_RENDERER_URL`, but only from loopback hosts.
+- In development, it can load `FAMILIAROS_RENDERER_URL`, but only from loopback hosts.
 - In packaged builds, it loads `dist/renderer/index.html`.
 
 ### Tray integration
@@ -123,7 +123,7 @@ Important details:
 Tray items now route to the Control Center singleton:
 
 - `Control Center...`
-- `Manage Pets...` → Pets route
+- `Manage Familiars...` → Familiars route
 - Plugins, Integrations, and Settings → matching Control Center routes
 
 ### Narrow preload bridge
@@ -134,9 +134,9 @@ Added:
 apps/desktop/control-center-preload.cjs
 ```
 
-It exposes narrow, page-specific methods to the React renderer. It now covers Pets, Settings, Plugins, and Integrations without exposing `ipcRenderer` directly.
+It exposes narrow, page-specific methods to the React renderer. It now covers Familiars, Settings, Plugins, and Integrations without exposing `ipcRenderer` directly.
 
-Pets methods include:
+Familiars methods include:
 
 - `getPetsState`
 - `getCatalog`
@@ -148,7 +148,7 @@ Pets methods include:
 - `importCodexPet`
 - `removePet`
 
-Settings methods include startup preferences, launch-at-login, pet scale, reaction animation mapping, update checks, and default pet position reset.
+Settings methods include startup preferences, launch-at-login, familiar scale, reaction animation mapping, update checks, and default familiar position reset.
 
 Plugins methods include plugin snapshots, catalog snapshots, enable/disable, config save, reload, command execution, local plugin loading, catalog install/update, and uninstall.
 
@@ -160,33 +160,33 @@ It does not expose `ipcRenderer` directly.
 
 The Control Center does not receive the full app state. It receives narrowed page snapshots only.
 
-The Pets page receives:
+The Familiars page receives:
 
-- default pet id
-- installed pets
+- default familiar id
+- installed familiars
 
 The Settings page receives only settings preferences/options needed by the route.
 
 The Plugins page receives safe plugin and catalog records from `PluginService`, intentionally excluding raw install paths and manifest paths.
 
-The Integrations page receives the existing narrowed agent setup snapshot used by the legacy task window: status/details for Claude Code, OpenCode, Cursor, Pi guidance, command paths, pet routing choices, and safe previews.
+The Integrations page receives the existing narrowed agent setup snapshot used by the legacy task window: status/details for Claude Code, OpenCode, Cursor, Pi guidance, command paths, familiar routing choices, and safe previews.
 
 This avoids exposing unrelated state to the new renderer.
 
-### Pets page UI
+### Familiars page UI
 
-The new Pets page now supports:
+The new Familiars page now supports:
 
-- installed pet list
-- remote catalog pets
+- installed familiar list
+- remote catalog familiars
 - catalog pagination
 - catalog search
-- Codex pets
+- Codex familiars
 - search/filter UI
 - set default
-- install catalog pet
-- import Codex pet
-- remove pet
+- install catalog familiar
+- import Codex familiar
+- remove familiar
 - detail panel
 - animated sprite-frame preview
 
@@ -194,13 +194,13 @@ The new Pets page now supports:
 
 The Control Center Settings page now supports:
 
-- show-pet-on-launch preference
+- show-familiar-on-launch preference
 - launch-at-login preference
-- pet scale selection
+- familiar scale selection
 - reaction-to-animation mapping
-- default pet position reset
+- default familiar position reset
 - compact system/update status
-- default-pet reaction previews using the `openpets-pet-preview:` protocol
+- default-familiar reaction previews using the `familiaros-familiar-preview:` protocol
 - bottom-center floating notifications that do not shift layout
 
 Settings is now served by the Control Center route.
@@ -229,9 +229,9 @@ The Control Center Integrations page now supports:
 - grid-first integration hub with icons and status pills
 - direct install/connect actions from Claude Code, OpenCode, and Cursor cards
 - detail inspector opened by Configure/View setup buttons
-- Claude MCP setup, replace/remove, hooks, instructions, pet routing, command paths, and advanced previews
-- OpenCode global setup, remove, pet routing, command paths, and config preview
-- Cursor MCP setup, replace/remove, pet routing, MCP preview, and Cursor rules preview
+- Claude MCP setup, replace/remove, hooks, instructions, familiar routing, command paths, and advanced previews
+- OpenCode global setup, remove, familiar routing, command paths, and config preview
+- Cursor MCP setup, replace/remove, familiar routing, MCP preview, and Cursor rules preview
 - Pi manual setup guidance
 - polished disabled cards for future editor integrations
 
@@ -242,11 +242,11 @@ Integrations is now served by the Control Center route, including command-source
 The Control Center Dashboard now supports:
 
 - default companion overview with animated sprite preview
-- quick navigation into pet selection
+- quick navigation into familiar selection
 - message and reaction activity totals
 - top companion and top reaction summaries
 - last-interaction timestamp
-- compact system health for installed pets, plugins, catalog, updates, and app version
+- compact system health for installed familiars, plugins, catalog, updates, and app version
 
 Dashboard is now the default Control Center landing route.
 
@@ -267,9 +267,9 @@ Important files:
 Validated with:
 
 ```bash
-pnpm --filter @open-pets/desktop typecheck
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop typecheck
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 node --check apps/desktop/control-center-preload.cjs
 ```
 
@@ -302,7 +302,7 @@ Reuse the current polished desktop visual language:
 
 Completed phases:
 
-- Manual Pets review and refinement
+- Manual Familiars review and refinement
 - Control Center routing/shell
 - Settings migration
 - Plugins migration
@@ -319,8 +319,8 @@ Remaining follow-up:
 Use these after each phase:
 
 ```bash
-pnpm --filter @open-pets/desktop typecheck
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop typecheck
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 node --check apps/desktop/control-center-preload.cjs
 ```
diff --git a/docs/implementation-process.md b/docs/implementation-process.md
index becac0a6..1e965025 100644
--- a/docs/implementation-process.md
+++ b/docs/implementation-process.md
@@ -1,8 +1,8 @@
-# OpenPets 2.0 implementation process
+# FamiliarOS 2.0 implementation process
 
 ## Goal
 
-OpenPets 2.0 should be implemented in clear, manually verifiable phases.
+FamiliarOS 2.0 should be implemented in clear, manually verifiable phases.
 
 The process should optimize for:
 
@@ -86,16 +86,16 @@ Avoid phases that are too small, such as:
 
 Avoid phases that are too large, such as:
 
-- Build all Electron, MCP, Claude, pet catalog, onboarding, and packaging in one pass.
+- Build all Electron, MCP, Claude, familiar catalog, onboarding, and packaging in one pass.
 - Implement all supported agents before Claude works end-to-end.
 
 A good phase should produce a concrete checkpoint the user can confirm, for example:
 
 - “I can launch the desktop app and see the tray menu.”
-- “I can see and drag the default pet.”
+- “I can see and drag the default familiar.”
 - “Claude Code is detected correctly on my machine.”
 - “Claude Code configuration preview looks correct and backups are created.”
-- “A real Claude session makes the pet react.”
+- “A real Claude session makes the familiar react.”
 
 ## Proposed implementation phases
 
@@ -111,7 +111,7 @@ Acceptance criteria:
 - Development uses Node-based tooling and does not require Bun at runtime.
 - Basic scripts are clear and documented.
 - Type checking/lint/build commands are defined.
-- The package shape matches the planned `@open-pets/*` architecture.
+- The package shape matches the planned `@familiaros/*` architecture.
 
 Manual confirmation:
 
@@ -127,77 +127,77 @@ Acceptance criteria:
 
 - App launches as a tray/menu bar app.
 - Tray menu matches the agreed initial menu.
-- Manage Pets, Configure Agents, and Settings open placeholder windows.
+- Manage Familiars, Configure Agents, and Settings open placeholder windows.
 - Quit exits cleanly.
 
 Manual confirmation:
 
 - User can launch the app, inspect tray/menu items, open placeholder windows, and quit cleanly.
 
-### Phase 2: Default pet window foundation
+### Phase 2: Default familiar window foundation
 
 Goal:
 
-Show the bundled default pet reliably as a floating desktop companion.
+Show the bundled default familiar reliably as a floating desktop companion.
 
 Acceptance criteria:
 
-- Bundled default pet appears on launch.
-- Pet window is frameless/transparent/always-on-top where supported.
-- Pet does not steal focus from the editor/terminal.
-- Pet is draggable.
-- Pet position is persisted.
-- Show/hide default pet works from tray.
-- Pause/resume all pets has visible behavior.
+- Bundled default familiar appears on launch.
+- Familiar window is frameless/transparent/always-on-top where supported.
+- Familiar does not steal focus from the editor/terminal.
+- Familiar is draggable.
+- Familiar position is persisted.
+- Show/hide default familiar works from tray.
+- Pause/resume all familiars has visible behavior.
 - Platform-specific limitations for transparency, focus, dragging, and always-on-top behavior are documented.
 
 Manual confirmation:
 
-- User can see, drag, hide/show, pause/resume, restart, and confirm the pet position persists.
+- User can see, drag, hide/show, pause/resume, restart, and confirm the familiar position persists.
 
-### Phase 3: Local app state and pet manager basics
+### Phase 3: Local app state and familiar manager basics
 
 Goal:
 
-Make pet ownership and default-pet behavior real in the app.
+Make familiar ownership and default-familiar behavior real in the app.
 
 Acceptance criteria:
 
 - App persists core preferences.
-- Built-in pet is protected from removal.
-- Pet Manager can show installed pets.
-- User can set default pet among installed pets.
-- Settings can control important early preferences such as speech enabled and open default pet on launch.
+- Built-in familiar is protected from removal.
+- Familiar Manager can show installed familiars.
+- User can set default familiar among installed familiars.
+- Settings can control important early preferences such as speech enabled and open default familiar on launch.
 
 Manual confirmation:
 
 - User can change default-related settings, restart app, and see preferences persist.
 
-### Phase 4: V2 pet catalog and installation
+### Phase 4: V2 familiar catalog and installation
 
 Goal:
 
-Support browsing and installing remote pets from the v2 catalog flow.
+Support browsing and installing remote familiars from the v2 catalog flow.
 
 Acceptance criteria:
 
 - App fetches the v2 catalog.
-- Pet Manager shows catalog pets with loading/error states.
-- User can install a pet from zip.
-- Installed pet is validated before use.
+- Familiar Manager shows catalog familiars with loading/error states.
+- User can install a familiar from zip.
+- Installed familiar is validated before use.
 - Zip install path prevents zip-slip/path traversal.
 - Zip size/file count limits exist.
-- Installation never executes scripts from downloaded pets.
+- Installation never executes scripts from downloaded familiars.
 - Failed installs clean up partial files.
-- User can remove removable installed pets.
-- User can set installed pet as default.
+- User can remove removable installed familiars.
+- User can set installed familiar as default.
 - App remains usable if catalog fetch fails.
 
 Manual confirmation:
 
-- User can install a real catalog pet, set it as default, restart, and see it work.
+- User can install a real catalog familiar, set it as default, restart, and see it work.
 
-### Phase 5: Local IPC and `@open-pets/client`
+### Phase 5: Local IPC and `@familiaros/client`
 
 Goal:
 
@@ -211,26 +211,26 @@ Acceptance criteria:
 - Startup token/version validation exists.
 - Token lifetime and stale discovery cleanup are defined.
 - Local-only threat model is documented.
-- `@open-pets/client` can connect and call status/say/react-style methods.
+- `@familiaros/client` can connect and call status/say/react-style methods.
 - Invalid token/version requests are rejected.
 
 Manual confirmation:
 
-- User/developer can run a local test command and see the pet react through IPC.
+- User/developer can run a local test command and see the familiar react through IPC.
 
-### Phase 6: `@open-pets/mcp` agent-neutral integration
+### Phase 6: `@familiaros/mcp` agent-neutral integration
 
 Goal:
 
-Make OpenPets usable from MCP-capable coding agents through the minimal public tool set.
+Make FamiliarOS usable from MCP-capable coding agents through the minimal public tool set.
 
 Acceptance criteria:
 
 - MCP server runs with Node/npx.
-- Tools exist: `openpets_status`, `openpets_say`, `openpets_react`.
-- MCP startup immediately acquires a lease and opens/shows the configured/default pet.
-- `--pet` chooses target pet.
-- Missing explicit pet falls back to default and reports fallback.
+- Tools exist: `familiaros_status`, `familiaros_say`, `familiaros_react`.
+- MCP startup immediately acquires a lease and opens/shows the configured/default familiar.
+- `--familiar` chooses target familiar.
+- Missing explicit familiar falls back to default and reports fallback.
 - If app is installed but not running, MCP attempts to launch it.
 - If app is missing, MCP stays alive in degraded mode and reports clearly.
 - Lease cleanup works on process exit and TTL fallback.
@@ -258,8 +258,8 @@ Acceptance criteria:
 - Backup restore behavior is defined.
 - Expected Claude config paths are documented per platform.
 - Doctor/check reports actionable status.
-- Uninstall/remove integration path exists for changes made by OpenPets.
-- Uninstall verification confirms OpenPets-managed config was removed without damaging unrelated user config.
+- Uninstall/remove integration path exists for changes made by FamiliarOS.
+- Uninstall verification confirms FamiliarOS-managed config was removed without damaging unrelated user config.
 
 Manual confirmation:
 
@@ -273,14 +273,14 @@ Make Claude Code feel polished through hook-driven reactions and short safe spee
 
 Acceptance criteria:
 
-- `@open-pets/claude` installs global Claude hooks safely.
+- `@familiaros/claude` installs global Claude hooks safely.
 - Hook events map to agreed reactions.
 - Speech comes from local short message pools/templates.
 - Speech is throttled/selective.
 - Permission/approval cases use clear fixed messages.
 - Notification hooks do not speak by default.
 - Speech safety rules are enforced.
-- Hooks route to active Claude MCP leases when reliable and otherwise fall back to default pet.
+- Hooks route to active Claude MCP leases when reliable and otherwise fall back to default familiar.
 - Hook event contract is documented.
 - Ambiguous Claude/MCP/app routing states have defined fallback behavior.
 
@@ -297,10 +297,10 @@ Connect the already-working pieces into the agreed first-run experience.
 Acceptance criteria:
 
 - First-run onboarding opens appropriately.
-- Default pet appears early.
-- Optional pet install step works or gracefully skips on catalog failure.
+- Default familiar appears early.
+- Optional familiar install step works or gracefully skips on catalog failure.
 - Agent setup step uses the real Agent Setup flow.
-- Done state clearly says OpenPets is ready.
+- Done state clearly says FamiliarOS is ready.
 - Onboarding completion persists.
 
 Manual confirmation:
@@ -319,14 +319,14 @@ Acceptance criteria:
 - Packaging path is tested against the agreed validation matrix.
 - App lifecycle edge cases are handled.
 - IPC cleanup and stale discovery behavior are reliable.
-- Pet install failure cases are understandable.
+- Familiar install failure cases are understandable.
 - Claude install/uninstall/doctor paths are robust.
 - Core automated tests/checks pass.
 - Manual MVP demo checklist passes.
 
 Manual confirmation:
 
-- User can install or run the packaged app and complete the full MVP demo: app launch, default pet, pet install/default change, Claude setup, real Claude reactions/speech, cleanup, quit.
+- User can install or run the packaged app and complete the full MVP demo: app launch, default familiar, familiar install/default change, Claude setup, real Claude reactions/speech, cleanup, quit.
 
 ## Oracle review policy
 
diff --git a/docs/mapping.md b/docs/mapping.md
index 4f99c734..b4df951a 100644
--- a/docs/mapping.md
+++ b/docs/mapping.md
@@ -1,17 +1,17 @@
-# OpenPets reaction, speech, and Claude hook mapping
+# FamiliarOS reaction, speech, and Claude hook mapping
 
-This document explains how OpenPets decides which pet reaction is shown, when the pet says something, and how Claude Code hooks and OpenCode plugin events map to reactions/messages.
+This document explains how FamiliarOS decides which familiar reaction is shown, when the familiar says something, and how Claude Code hooks and OpenCode plugin events map to reactions/messages.
 
 ## Important terms
 
-- **Reaction**: one of the allowed OpenPets reaction names, for example `thinking`, `success`, or `error`.
-- **Speech/message**: a short text bubble sent with `openpets_say` or generated by a Claude hook.
+- **Reaction**: one of the allowed FamiliarOS reaction names, for example `thinking`, `success`, or `error`.
+- **Speech/message**: a short text bubble sent with `familiaros_say` or generated by a Claude hook.
 - **Hook speech**: automatic short speech generated by Claude Code hook events.
-- **Target pet**: the pet that receives the reaction/message. This is either the desktop default pet or a project/agent-selected pet through a lease.
+- **Target familiar**: the familiar that receives the reaction/message. This is either the desktop default familiar or a project/agent-selected familiar through a lease.
 
 ## Allowed reactions
 
-OpenPets currently accepts these reactions:
+FamiliarOS currently accepts these reactions:
 
 | Reaction | Intended meaning |
 | --- | --- |
@@ -22,7 +22,7 @@ OpenPets currently accepts these reactions:
 | `running` | The agent is running a command that is not classified as tests. |
 | `testing` | The agent is running tests. |
 | `waiting` | The agent is waiting for permission or another blocking state. |
-| `waving` | The pet waves for notifications/attention. |
+| `waving` | The familiar waves for notifications/attention. |
 | `success` | The agent completed successfully. |
 | `error` | The agent failed or hit a problem. |
 | `celebrating` | Positive manual reaction; not currently emitted by Claude hooks. |
@@ -31,11 +31,11 @@ Source of truth: `packages/client/src/protocol.ts` and `apps/desktop/src/local-i
 
 ## What a reaction visually does today
 
-Reactions drive the pet spritesheet animation and can also show temporary bubble text above the pet. For example, `thinking` uses the review/thinking animation row and, when sent as a reaction-only event, displays a short randomized status line such as `Thinking it through` or `Checking the clues`.
+Reactions drive the familiar spritesheet animation and can also show temporary bubble text above the familiar. For example, `thinking` uses the review/thinking animation row and, when sent as a reaction-only event, displays a short randomized status line such as `Thinking it through` or `Checking the clues`.
 
-The defaults below are defined in `apps/desktop/src/reaction-animation-mapping.ts`. Users can override reaction-to-animation defaults in Settings → Reaction animations. Overrides apply globally to the default pet and explicit/agent pet windows. Drag-only rows (`running-left`, `running-right`) are never user-selectable because they are controlled by pet movement.
+The defaults below are defined in `apps/desktop/src/reaction-animation-mapping.ts`. Users can override reaction-to-animation defaults in Settings → Reaction animations. Overrides apply globally to the default familiar and explicit/agent familiar windows. Drag-only rows (`running-left`, `running-right`) are never user-selectable because they are controlled by familiar movement.
 
-The universal Codex/OpenPets spritesheet has these animation rows:
+The universal Codex/FamiliarOS spritesheet has these animation rows:
 
 | Row | Spritesheet state | Trigger/reaction mapping |
 | --- | --- | --- |
@@ -49,7 +49,7 @@ The universal Codex/OpenPets spritesheet has these animation rows:
 | 7 | `running` | `working`, `editing`, `running`. |
 | 8 | `review` | `thinking`. |
 
-Drag motion overrides reaction animation while the pet is being moved. When dragging stops, the sprite returns to the active reaction animation until the transient display clears, then returns to idle.
+Drag motion overrides reaction animation while the familiar is being moved. When dragging stops, the sprite returns to the active reaction animation until the transient display clears, then returns to idle.
 
 One-shot feedback animations do not loop for the full 4-second bubble lifetime:
 
@@ -67,13 +67,13 @@ When a transient display has both a message and a reaction, the message wins.
 
 | Input | Bubble text shown |
 | --- | --- |
-| Reaction only: `openpets_react({ reaction: "testing" })` | A stable randomized status line from the `testing` message pool, for example `Running the checks`. |
-| Message only: `openpets_say({ message: "Done" })` | `Done` |
-| Message + reaction: `openpets_say({ message: "Done", reaction: "success" })` | `Done` |
+| Reaction only: `familiaros_react({ reaction: "testing" })` | A stable randomized status line from the `testing` message pool, for example `Running the checks`. |
+| Message only: `familiaros_say({ message: "Done" })` | `Done` |
+| Message + reaction: `familiaros_say({ message: "Done", reaction: "success" })` | `Done` |
 
 The reaction is still sent with the message, but the visible bubble text is the message.
 
-Source of truth: `apps/desktop/src/pet-window.ts` (`createBubbleMarkup`).
+Source of truth: `apps/desktop/src/familiar-window.ts` (`createBubbleMarkup`).
 
 ## How long bubbles stay visible
 
@@ -85,11 +85,11 @@ Reaction/message bubbles are transient and clear after a length-aware duration:
 | `success` / `error` reactions | At least 5 seconds. |
 | Longer explicit messages | Extended by message length, capped at 12 seconds. |
 
-Source of truth: `apps/desktop/src/pet-window.ts` (`getTransientDisplayDurationMs`).
+Source of truth: `apps/desktop/src/familiar-window.ts` (`getTransientDisplayDurationMs`).
 
 ## Claude hook event mapping
 
-When OpenPets Claude hooks are installed, these Claude Code hook events are registered:
+When FamiliarOS Claude hooks are installed, these Claude Code hook events are registered:
 
 ```text
 UserPromptSubmit
@@ -122,7 +122,7 @@ Source of truth: `packages/claude/src/hooks.ts` and `packages/claude/src/hook-me
 
 ### Bash test detection
 
-For `PreToolUse` with `tool_name: "Bash"`, OpenPets classifies the command as `testing` if the command contains one of these patterns:
+For `PreToolUse` with `tool_name: "Bash"`, FamiliarOS classifies the command as `testing` if the command contains one of these patterns:
 
 ```text
 test
@@ -140,7 +140,7 @@ Otherwise Bash maps to `running`.
 
 ## Hook speech throttling
 
-Hooks do not speak on every matching event. Speech is throttled so the pet does not spam bubbles.
+Hooks do not speak on every matching event. Speech is throttled so the familiar does not spam bubbles.
 
 | Speech category | Events that use it | Cooldown |
 | --- | --- | --- |
@@ -149,13 +149,13 @@ Hooks do not speak on every matching event. Speech is throttled so the pet does
 | `error` | `StopFailure` | 20 seconds |
 | `permission` | `PermissionRequest` | 3 seconds |
 
-If speech is throttled, OpenPets still sends the reaction with `pet.react`. Example: if `Stop` happens twice within 20 seconds, the second one sends `success` as a reaction only instead of saying another success phrase.
+If speech is throttled, FamiliarOS still sends the reaction with `familiar.react`. Example: if `Stop` happens twice within 20 seconds, the second one sends `success` as a reaction only instead of saying another success phrase.
 
 Source of truth: `packages/claude/src/hooks.ts` (`speechCooldownMs`, `permissionCooldownMs`, `shouldSendSpeech`).
 
 ## OpenCode plugin event mapping
 
-When OpenPets OpenCode setup is installed, OpenCode loads the `@open-pets/opencode` plugin. Plugin hooks return immediately and schedule OpenPets IPC calls in the background so OpenCode is not blocked by pet activity.
+When FamiliarOS OpenCode setup is installed, OpenCode loads the `@familiaros/opencode` plugin. Plugin hooks return immediately and schedule FamiliarOS IPC calls in the background so OpenCode is not blocked by familiar activity.
 
 | OpenCode hook/event | Condition | Reaction sent | Does it speak? |
 | --- | --- | --- | --- |
@@ -165,7 +165,7 @@ When OpenPets OpenCode setup is installed, OpenCode loads the `@open-pets/openco
 | `tool.execute.before` | Shell/bash-like tool name, not test-like. | `running` | No. |
 | `tool.execute.before` | Other tools. | `working` | No. |
 | `event` | Bus event `permission.asked`. | `waiting` | Yes, short approval-needed speech. |
-| Internal/self OpenPets tools | OpenPets MCP/status/say/react calls. | None. | No. |
+| Internal/self FamiliarOS tools | FamiliarOS MCP/status/say/react calls. | None. | No. |
 
 OpenCode speech uses the same safe shared message pools as Claude hooks. It never includes prompt text, commands, output, code, logs, paths, URLs, or secrets.
 
@@ -192,13 +192,13 @@ The public MCP tools are intentionally small:
 
 | MCP tool | Input | Effect |
 | --- | --- | --- |
-| `openpets_status` | none | Checks whether OpenPets is running and which pet is targeted. Does not change pet state. |
-| `openpets_react` | `{ reaction }` | Drives the reaction animation and may show a short randomized temporary bubble from that reaction's message pool. |
-| `openpets_say` | `{ message, reaction? }` | Sends a message bubble, optionally with a reaction. The message is what appears in the bubble. |
+| `familiaros_status` | none | Checks whether FamiliarOS is running and which familiar is targeted. Does not change familiar state. |
+| `familiaros_react` | `{ reaction }` | Drives the reaction animation and may show a short randomized temporary bubble from that reaction's message pool. |
+| `familiaros_say` | `{ message, reaction? }` | Sends a message bubble, optionally with a reaction. The message is what appears in the bubble. |
 
 ### MCP message validation
 
-`openpets_say` messages must be:
+`familiaros_say` messages must be:
 
 - 1–140 characters after trimming.
 - Single-line.
@@ -209,48 +209,48 @@ The public MCP tools are intentionally small:
 
 Source of truth: `packages/mcp/src/tools.ts` and `apps/desktop/src/local-ipc-protocol.ts`.
 
-## Target pet routing
+## Target familiar routing
 
-OpenPets decides which pet gets the reaction/message as follows:
+FamiliarOS decides which familiar gets the reaction/message as follows:
 
 | Situation | Target |
 | --- | --- |
-| No selected/configured pet. | Desktop default pet. |
-| Selected/configured pet is the built-in pet or current default pet. | Desktop default pet. |
-| Selected/configured pet is installed and not broken. | Explicit agent pet window for that pet. |
-| Selected/configured pet is invalid, missing, or broken. | Falls back to desktop default pet. |
+| No selected/configured familiar. | Desktop default familiar. |
+| Selected/configured familiar is the built-in familiar or current default familiar. | Desktop default familiar. |
+| Selected/configured familiar is installed and not broken. | Explicit agent familiar window for that familiar. |
+| Selected/configured familiar is invalid, missing, or broken. | Falls back to desktop default familiar. |
 
-Claude hooks, OpenCode plugin events, and MCP use a short-lived lease when a project/configured pet is specified. That lease routes `say`/`react` to the explicit pet window.
+Claude hooks, OpenCode plugin events, and MCP use a short-lived lease when a project/configured familiar is specified. That lease routes `say`/`react` to the explicit familiar window.
 
 Source of truth: `apps/desktop/src/local-ipc.ts` (`resolveLeaseTarget`), `packages/claude/src/hooks.ts` (`acquireHookLease`), and `packages/opencode/src/opencode-plugin-runtime.ts`.
 
 ## Paused behavior
 
-If the default pet is paused:
+If the default familiar is paused:
 
-- Default-pet reactions/messages are not shown and return `reason: "paused"`.
-- Explicit agent pet reactions/messages also check the default paused state and are not shown when paused.
+- Default-familiar reactions/messages are not shown and return `reason: "paused"`.
+- Explicit agent familiar reactions/messages also check the default paused state and are not shown when paused.
 
-Source of truth: `apps/desktop/src/default-pet-controller.ts` and `apps/desktop/src/local-ipc.ts`.
+Source of truth: `apps/desktop/src/default-familiar-controller.ts` and `apps/desktop/src/local-ipc.ts`.
 
 ## Visibility behavior
 
-Default pet:
+Default familiar:
 
-- A reaction/message refreshes the default pet content.
-- The default pet is only shown for external events if it is already visible or `openDefaultPetOnLaunch` is enabled.
+- A reaction/message refreshes the default familiar content.
+- The default familiar is only shown for external events if it is already visible or `openDefaultPetOnLaunch` is enabled.
 
-Explicit agent pet:
+Explicit agent familiar:
 
-- A reaction/message opens/shows that agent pet window.
-- The agent pet window is closed when its explicit lease expires and no explicit lease remains.
+- A reaction/message opens/shows that agent familiar window.
+- The agent familiar window is closed when its explicit lease expires and no explicit lease remains.
 
-Source of truth: `apps/desktop/src/default-pet-controller.ts`, `apps/desktop/src/agent-pet-controller.ts`, and `apps/desktop/src/local-ipc.ts`.
+Source of truth: `apps/desktop/src/default-familiar-controller.ts`, `apps/desktop/src/agent-familiar-controller.ts`, and `apps/desktop/src/local-ipc.ts`.
 
 ## Current product implications
 
 1. Hook emotions now change sprite animation rows; bubbles are still used for short visible text.
-2. Only some hooks/events make the pet speak. Claude prompt/permission/stop events and OpenCode chat/permission events can produce speech. Tool-use hooks only react.
+2. Only some hooks/events make the familiar speak. Claude prompt/permission/stop events and OpenCode chat/permission events can produce speech. Tool-use hooks only react.
 3. Speech is intentionally short and safe. Hooks/plugins never display prompts, command output, code, logs, paths, URLs, or secrets.
 4. Messages override reaction text visually. If a message is present, the bubble shows the message, not a randomized reaction line, while the reaction still controls animation.
 5. `celebrating` exists as an allowed manual reaction but is not emitted by Claude hooks today.
diff --git a/docs/mvp-validation.md b/docs/mvp-validation.md
index 44322c9e..276bcee6 100644
--- a/docs/mvp-validation.md
+++ b/docs/mvp-validation.md
@@ -1,6 +1,6 @@
-# OpenPets MVP validation
+# FamiliarOS MVP validation
 
-This is the authoritative local MVP closeout checklist for OpenPets 2.0.
+This is the authoritative local MVP closeout checklist for FamiliarOS 2.0.
 
 The current checkpoint is a macOS local dogfooding package built with `electron-builder --dir`. It is not a public distribution release.
 
@@ -9,10 +9,10 @@ The current checkpoint is a macOS local dogfooding package built with `electron-
 | Area | Status | Notes |
 | --- | --- | --- |
 | Tray/menu bar app | Ready for macOS local validation | Validate from the packaged app, not only `pnpm dev:desktop`. |
-| Default pet | Ready for macOS local validation | Confirm show/hide, pause/resume, dragging, and restart persistence basics. |
-| Default pet animation | Ready for macOS local validation | Confirm bundled sprite animation, left/right drag direction changes, and idle settle. |
-| First-run onboarding | Ready for macOS local validation | Can be retested by removing OpenPets app data. |
-| Pet Manager | Ready for macOS local validation | Catalog availability may affect install verification. |
+| Default familiar | Ready for macOS local validation | Confirm show/hide, pause/resume, dragging, and restart persistence basics. |
+| Default familiar animation | Ready for macOS local validation | Confirm bundled sprite animation, left/right drag direction changes, and idle settle. |
+| First-run onboarding | Ready for macOS local validation | Can be retested by removing FamiliarOS app data. |
+| Familiar Manager | Ready for macOS local validation | Catalog availability may affect install verification. |
 | Settings persistence | Ready for macOS local validation | Toggle a preference, restart, and confirm persistence. |
 | Local IPC/client smoke | Ready for macOS local validation | Run while the packaged app is open. |
 | Claude Agent Setup preview | Ready for macOS local validation | Preview should use packaged bundled `node .../app.asar.unpacked/...` paths. |
@@ -28,7 +28,7 @@ The current checkpoint is a macOS local dogfooding package built with `electron-
 | Desktop package version | `2.0.0` |
 | Local package command | `pnpm package:desktop:dir` |
 | Package output | `apps/desktop/dist-electron/` |
-| macOS app output | `apps/desktop/dist-electron/mac-arm64/OpenPets.app` on Apple Silicon |
+| macOS app output | `apps/desktop/dist-electron/mac-arm64/FamiliarOS.app` on Apple Silicon |
 | Manual tester/date/result | Fill in during validation |
 
 ## Prerequisites
@@ -59,7 +59,7 @@ Phase 10C enables ASAR packaging for Electron app contents and unpacks `node_mod
 
 The builder config sets `npmRebuild: false` because the current desktop runtime dependencies are JavaScript-only. Revisit that setting if native modules are added.
 
-The macOS package uses an OpenPets MVP `.icns` derived from the current 64×64 tray icon. It may look soft at large sizes. Higher-resolution branding and Windows/Linux icon assets remain future polish.
+The macOS package uses an FamiliarOS MVP `.icns` derived from the current 64×64 tray icon. It may look soft at large sizes. Higher-resolution branding and Windows/Linux icon assets remain future polish.
 
 ## Platform matrix
 
@@ -76,72 +76,72 @@ Installer targets, notarization, code signing, auto-update, and public distribut
 Run this checklist after the automated commands pass.
 
 1. Launch the generated packaged app from `apps/desktop/dist-electron/`.
-   - Expected: OpenPets starts without using the dev Electron entrypoint.
+   - Expected: FamiliarOS starts without using the dev Electron entrypoint.
 2. Confirm the tray/menu bar icon appears.
-   - Expected: Tray/menu items are available, including Manage Pets, Configure Agents, Settings, show/hide, pause/resume, and Quit.
-3. Confirm the default pet behavior.
-   - Expected: The default pet appears as an animated bundled sprite, can be shown/hidden, paused/resumed, dragged, and still behaves correctly after app restart.
+   - Expected: Tray/menu items are available, including Manage Familiars, Configure Agents, Settings, show/hide, pause/resume, and Quit.
+3. Confirm the default familiar behavior.
+   - Expected: The default familiar appears as an animated bundled sprite, can be shown/hidden, paused/resumed, dragged, and still behaves correctly after app restart.
    - Expected: Dragging right switches to a right-facing/running animation; dragging left switches to a left-facing/running animation; stopping settles back to idle without jitter.
 4. Complete onboarding if it appears.
-   - Expected: Onboarding can be completed or skipped according to the UI, and does not block using the built-in default pet.
-   - To retest first-run onboarding, remove the OpenPets app data directory for your platform before launching again.
-5. Open Pet Manager.
-   - Expected: Installed pets and catalog state render. If the catalog is unavailable, record the catalog error and mark catalog install unverified for that run.
-6. If a catalog pet is available, install it and set it as default.
-   - Expected: Install succeeds, the pet can become default, and the app remains usable after restart.
-   - Expected: The installed default pet shows one animated frame sequence, not the full square spritesheet, and drag left/right changes its animation direction.
-   - Expected: Pet Manager keeps the current default card actionable; removable default pets can still be removed safely.
+   - Expected: Onboarding can be completed or skipped according to the UI, and does not block using the built-in default familiar.
+   - To retest first-run onboarding, remove the FamiliarOS app data directory for your platform before launching again.
+5. Open Familiar Manager.
+   - Expected: Installed familiars and catalog state render. If the catalog is unavailable, record the catalog error and mark catalog install unverified for that run.
+6. If a catalog familiar is available, install it and set it as default.
+   - Expected: Install succeeds, the familiar can become default, and the app remains usable after restart.
+   - Expected: The installed default familiar shows one animated frame sequence, not the full square spritesheet, and drag left/right changes its animation direction.
+   - Expected: Familiar Manager keeps the current default card actionable; removable default familiars can still be removed safely.
 7. Open Settings, toggle a preference, quit, relaunch, and confirm persistence.
    - Expected: The changed preference persists across restart.
 8. While the packaged app is running, run the local IPC smoke command from the workspace root:
 
    ```bash
-   pnpm --filter @open-pets/client smoke:status
+   pnpm --filter @familiaros/client smoke:status
    ```
 
    - Expected: The client discovers the running packaged app and receives status without token/version errors.
 9. Open Agent Setup and inspect the Claude preview without applying changes.
-   - Expected: Packaged previews use `node` commands pointing inside the packaged app, not unpublished `npx -y @open-pets/*` commands.
-   - Expected MCP shape: `node .../app.asar.unpacked/node_modules/@open-pets/mcp/dist/index.js`.
-   - Expected hooks shape: `node .../app.asar.unpacked/node_modules/@open-pets/claude/dist/cli.js hook --openpets-managed`.
+   - Expected: Packaged previews use `node` commands pointing inside the packaged app, not unpublished `npx -y @familiaros/*` commands.
+   - Expected MCP shape: `node .../app.asar.unpacked/node_modules/@familiaros/mcp/dist/index.js`.
+   - Expected hooks shape: `node .../app.asar.unpacked/node_modules/@familiaros/claude/dist/cli.js hook --familiaros-managed`.
 10. Optional mutating Claude validation: configure/install Claude MCP/hooks only if you intentionally want to modify your real Claude settings.
-    - Expected: OpenPets shows what it will change and creates backups before editing.
+    - Expected: FamiliarOS shows what it will change and creates backups before editing.
     - Cleanup: use Agent Setup remove/uninstall actions when done if you do not want to keep the integration.
-11. Quit OpenPets from the tray.
+11. Quit FamiliarOS from the tray.
     - Expected: The app exits cleanly and removes transient local IPC discovery state.
 
-## Pet and chat bubble quality checks
+## Familiar and chat bubble quality checks
 
-While OpenPets is running, trigger a speech bubble from the workspace root:
+While FamiliarOS is running, trigger a speech bubble from the workspace root:
 
 ```bash
-pnpm --filter @open-pets/client smoke:say "Working on it" thinking
+pnpm --filter @familiaros/client smoke:say "Working on it" thinking
 ```
 
-Expected: the bubble is compact, readable, visually attached to the pet, and does not look like an oversized wireframe card.
+Expected: the bubble is compact, readable, visually attached to the familiar, and does not look like an oversized wireframe card.
 
 Trigger a reaction:
 
 ```bash
-pnpm --filter @open-pets/client smoke:react success
+pnpm --filter @familiaros/client smoke:react success
 ```
 
-Expected: the pet remains animated and the bubble/reaction presentation stays readable and short.
+Expected: the familiar remains animated and the bubble/reaction presentation stays readable and short.
 
 ## Claude packaged command notes
 
-Packaged Claude integration uses bundled commands inside the packaged OpenPets app instead of unpublished package names.
+Packaged Claude integration uses bundled commands inside the packaged FamiliarOS app instead of unpublished package names.
 
 Expected command resources live under `app.asar.unpacked`, not `app.asar`, because Claude launches them through external `node`:
 
 ```text
-.../OpenPets.app/Contents/Resources/app.asar.unpacked/node_modules/@open-pets/mcp/dist/index.js
-.../OpenPets.app/Contents/Resources/app.asar.unpacked/node_modules/@open-pets/claude/dist/cli.js
+.../FamiliarOS.app/Contents/Resources/app.asar.unpacked/node_modules/@familiaros/mcp/dist/index.js
+.../FamiliarOS.app/Contents/Resources/app.asar.unpacked/node_modules/@familiaros/claude/dist/cli.js
 ```
 
 Packaged bundled Claude commands require `node` to be available on Claude's PATH.
 
-Claude settings may contain absolute paths into the packaged OpenPets app. Moving, deleting, or replacing the app may require opening Agent Setup and using Replace/Install again. Use Agent Setup remove/uninstall before deleting the app if you want to remove OpenPets-managed Claude entries.
+Claude settings may contain absolute paths into the packaged FamiliarOS app. Moving, deleting, or replacing the app may require opening Agent Setup and using Replace/Install again. Use Agent Setup remove/uninstall before deleting the app if you want to remove FamiliarOS-managed Claude entries.
 
 ## Safe vs mutating validation
 
@@ -150,28 +150,28 @@ Safe validation:
 - Running workspace tests/checks/package commands.
 - Launching the packaged app.
 - Inspecting Agent Setup previews.
-- Running `pnpm --filter @open-pets/client smoke:status` against the local packaged app.
+- Running `pnpm --filter @familiaros/client smoke:status` against the local packaged app.
 
 Mutating validation:
 
 - Applying Claude MCP configuration.
 - Installing Claude hooks.
 - Removing/uninstalling Claude integration.
-- Deleting OpenPets app data to retest onboarding.
+- Deleting FamiliarOS app data to retest onboarding.
 
-Only run mutating steps intentionally. Automated tests must use temp fixtures and must not edit real Claude settings or real OpenPets user data.
+Only run mutating steps intentionally. Automated tests must use temp fixtures and must not edit real Claude settings or real FamiliarOS user data.
 
 ## Cleanup and data-loss notes
 
-OpenPets stores normal app state in Electron's per-user app data directory. The app logs the exact state file path on startup:
+FamiliarOS stores normal app state in Electron's per-user app data directory. The app logs the exact state file path on startup:
 
 ```text
-OpenPets state initialized at <path>/openpets-state.json.
+FamiliarOS state initialized at <path>/familiaros-state.json.
 ```
 
-Deleting that app data directory removes installed pets, default-pet selection, onboarding completion, and preferences for that platform user.
+Deleting that app data directory removes installed familiars, default-familiar selection, onboarding completion, and preferences for that platform user.
 
-Claude configuration is separate from OpenPets app data. Uninstalling or deleting OpenPets does not automatically remove Claude MCP entries or Claude hooks.
+Claude configuration is separate from FamiliarOS app data. Uninstalling or deleting FamiliarOS does not automatically remove Claude MCP entries or Claude hooks.
 
 Package output can be removed safely:
 
@@ -195,5 +195,5 @@ These warnings are expected for local MVP validation and are not acceptable for
 - Windows and Linux package behavior need real platform validation.
 - Windows/Linux app icon assets are not configured yet.
 - The current macOS app icon is MVP-quality and generated from a 64×64 source.
-- Published `npx -y @open-pets/*` package flows remain future distribution work; local packaged Claude setup uses bundled app paths.
+- Published `npx -y @familiaros/*` package flows remain future distribution work; local packaged Claude setup uses bundled app paths.
 - `asarUnpack: node_modules/**` is broad for MVP reliability and can be narrowed after packaged command needs are fully characterized.
diff --git a/docs/opencode.md b/docs/opencode.md
index f6dfd05e..83f040c9 100644
--- a/docs/opencode.md
+++ b/docs/opencode.md
@@ -1,22 +1,22 @@
 # OpenCode integration
 
-This document describes how OpenPets Desktop integrates with OpenCode, what files are configured, how OpenCode reaches the desktop app, and which OpenCode events trigger pet reactions or speech.
+This document describes how FamiliarOS Desktop integrates with OpenCode, what files are configured, how OpenCode reaches the desktop app, and which OpenCode events trigger familiar reactions or speech.
 
 ## Integration surfaces
 
 OpenCode support has three related surfaces:
 
-1. **MCP tools** — OpenCode gets the `openpets_status`, `openpets_react`, and `openpets_say` tools through `@open-pets/cli mcp`.
-2. **OpenCode instructions** — OpenCode loads a managed `openpets.md` instruction file telling agents when to use the tools.
-3. **OpenCode plugin hooks** — `@open-pets/opencode` turns OpenCode activity into automatic pet reactions and short safe speech.
+1. **MCP tools** — OpenCode gets the `familiaros_status`, `familiaros_react`, and `familiaros_say` tools through `@familiaros/cli mcp`.
+2. **OpenCode instructions** — OpenCode loads a managed `familiaros.md` instruction file telling agents when to use the tools.
+3. **OpenCode plugin hooks** — `@familiaros/opencode` turns OpenCode activity into automatic familiar reactions and short safe speech.
 
-The desktop setup UI for OpenCode is implemented in `apps/desktop/src/agent-setup.ts`. It previews, installs, doctors, and removes global OpenCode setup through `@open-pets/opencode` helpers.
+The desktop setup UI for OpenCode is implemented in `apps/desktop/src/agent-setup.ts`. It previews, installs, doctors, and removes global OpenCode setup through `@familiaros/opencode` helpers.
 
 This document covers **Desktop global setup** first. The CLI also supports **project-local OpenCode setup**; see [Project-local OpenCode setup](#project-local-opencode-setup).
 
 ## Global config location
 
-OpenPets uses OpenCode's global config directory:
+FamiliarOS uses OpenCode's global config directory:
 
 ```text
 OPENCODE_CONFIG_DIR, if set
@@ -24,7 +24,7 @@ Windows: %APPDATA%/opencode
 macOS/Linux: $XDG_CONFIG_HOME/opencode, or ~/.config/opencode fallback
 ```
 
-Inside that directory OpenPets considers these config files, in order:
+Inside that directory FamiliarOS considers these config files, in order:
 
 ```text
 config.json
@@ -38,13 +38,13 @@ If no file exists, the default creation target is:
 opencode.jsonc
 ```
 
-OpenPets also writes a global instruction file:
+FamiliarOS also writes a global instruction file:
 
 ```text
-<opencode-config-dir>/openpets.md
+<opencode-config-dir>/familiaros.md
 ```
 
-## Files and config managed by OpenPets
+## Files and config managed by FamiliarOS
 
 OpenCode global setup writes or updates three config fields.
 
@@ -55,22 +55,22 @@ Published setup creates an MCP entry like:
 ```jsonc
 {
   "mcp": {
-    "openpets": {
+    "familiaros": {
       "type": "local",
-      "command": ["npx", "-y", "@open-pets/cli@<version>", "mcp"],
+      "command": ["npx", "-y", "@familiaros/cli@<version>", "mcp"],
       "enabled": true
     }
   }
 }
 ```
 
-If a pet is selected, the command includes it:
+If a familiar is selected, the command includes it:
 
 ```jsonc
-"command": ["npx", "-y", "@open-pets/cli@<version>", "mcp", "--pet", "<petId>"]
+"command": ["npx", "-y", "@familiaros/cli@<version>", "mcp", "--familiar", "<petId>"]
 ```
 
-In local development or packaged desktop mode, OpenPets can use:
+In local development or packaged desktop mode, FamiliarOS can use:
 
 ```jsonc
 "command": ["node", "<local-or-bundled-cli-entry>", "mcp", ...]
@@ -80,113 +80,113 @@ Packaged and local `node <entry>` commands require `node` to be available on Ope
 
 ### Instructions
 
-OpenPets adds the managed instruction file to OpenCode's `instructions` array:
+FamiliarOS adds the managed instruction file to OpenCode's `instructions` array:
 
 ```jsonc
 {
-  "instructions": ["<opencode-config-dir>/openpets.md"]
+  "instructions": ["<opencode-config-dir>/familiaros.md"]
 }
 ```
 
 That file contains:
 
 ```md
-<!-- OPENPETS:START -->
-## OpenPets
+<!-- FAMILIAROS:START -->
+## FamiliarOS
 
-OpenPets MCP tools may be available.
+FamiliarOS MCP tools may be available.
 
-Use OpenPets as a short visible status channel for meaningful coding progress:
-- Use `openpets_say` when starting, completing, blocking, or needing review on non-trivial work.
+Use FamiliarOS as a short visible status channel for meaningful coding progress:
+- Use `familiaros_say` when starting, completing, blocking, or needing review on non-trivial work.
 - Keep messages brief, user-facing, and non-sensitive.
 - Do not include code, logs, secrets, URLs, or file paths.
-- Use `openpets_react` for small visual or emotional feedback.
-- Use `openpets_status` only when checking availability or the targeted pet.
+- Use `familiaros_react` for small visual or emotional feedback.
+- Use `familiaros_status` only when checking availability or the targeted familiar.
 - Do not spam every internal step.
-<!-- OPENPETS:END -->
+<!-- FAMILIAROS:END -->
 ```
 
 ### Plugin
 
-OpenPets adds the OpenCode plugin:
+FamiliarOS adds the OpenCode plugin:
 
 ```jsonc
 {
-  "plugin": ["@open-pets/opencode@<version>"]
+  "plugin": ["@familiaros/opencode@<version>"]
 }
 ```
 
-If a pet is selected, the plugin entry includes options:
+If a familiar is selected, the plugin entry includes options:
 
 ```jsonc
 {
-  "plugin": [["@open-pets/opencode@<version>", { "pet": "<petId>" }]]
+  "plugin": [["@familiaros/opencode@<version>", { "familiar": "<petId>" }]]
 }
 ```
 
 The plugin id is:
 
 ```text
-open-pets-opencode
+familiaros-opencode
 ```
 
 ## Setup behavior
 
-OpenPets global setup is conservative:
+FamiliarOS global setup is conservative:
 
 - It parses OpenCode config as JSONC, not strict JSON.
 - It preserves unrelated user config.
 - It avoids unsafe symlinks and oversized files.
 - It writes temp files and backups before replacing existing files.
-- It refuses to overwrite custom OpenPets-like config entries that it cannot prove are managed by OpenPets.
+- It refuses to overwrite custom FamiliarOS-like config entries that it cannot prove are managed by FamiliarOS.
 - It cleans up stale managed entries from any non-selected global config file when one selected config file becomes the owner.
 
-OpenPets chooses one global config file as the owner for the managed MCP, instructions, and plugin entries. It first prefers the effective owner of relevant array fields such as `plugin` or `instructions`, then reuses an existing managed OpenPets owner, then uses the highest-precedence existing global config file, and finally creates `opencode.jsonc` if none exists. Setup refuses ambiguous cases, such as plugin and instruction arrays living in different files, managed OpenPets entries appearing in multiple global files, or higher-precedence arrays shadowing lower-precedence user entries.
+FamiliarOS chooses one global config file as the owner for the managed MCP, instructions, and plugin entries. It first prefers the effective owner of relevant array fields such as `plugin` or `instructions`, then reuses an existing managed FamiliarOS owner, then uses the highest-precedence existing global config file, and finally creates `opencode.jsonc` if none exists. Setup refuses ambiguous cases, such as plugin and instruction arrays living in different files, managed FamiliarOS entries appearing in multiple global files, or higher-precedence arrays shadowing lower-precedence user entries.
 
-Removal deletes only OpenPets-managed MCP, instructions, and plugin entries. It leaves unrelated OpenCode config intact.
+Removal deletes only FamiliarOS-managed MCP, instructions, and plugin entries. It leaves unrelated OpenCode config intact.
 
 ## Project-local OpenCode setup
 
-The `@open-pets/cli` package can configure OpenCode inside a project:
+The `@familiaros/cli` package can configure OpenCode inside a project:
 
 ```sh
-openpets configure --agent opencode --pet <petId>
+familiaros configure --agent opencode --familiar <petId>
 ```
 
 Project-local setup writes inside the current project directory:
 
 ```text
 .opencode/opencode.jsonc
-.opencode/openpets.md
+.opencode/familiaros.md
 ```
 
-If another supported OpenCode project config already exists, OpenPets updates that file instead of creating `.opencode/opencode.jsonc`. Project-local setup adds the same three kinds of entries as global setup:
+If another supported OpenCode project config already exists, FamiliarOS updates that file instead of creating `.opencode/opencode.jsonc`. Project-local setup adds the same three kinds of entries as global setup:
 
-- `mcp.openpets` using `@open-pets/cli mcp --pet <petId>`.
-- `instructions` pointing to `.opencode/openpets.md`.
-- `plugin` using `@open-pets/opencode` with `{ "pet": "<petId>" }`.
+- `mcp.familiaros` using `@familiaros/cli mcp --familiar <petId>`.
+- `instructions` pointing to `.opencode/familiaros.md`.
+- `plugin` using `@familiaros/opencode` with `{ "familiar": "<petId>" }`.
 
-Project-local config and instructions can be committed to the repository and include the selected pet id. That is useful for shared project identity, but users should review those files before committing.
+Project-local config and instructions can be committed to the repository and include the selected familiar id. That is useful for shared project identity, but users should review those files before committing.
 
 ## Runtime path
 
-When OpenCode calls an OpenPets MCP tool or when the OpenCode plugin reacts to an event, the runtime path is:
+When OpenCode calls an FamiliarOS MCP tool or when the OpenCode plugin reacts to an event, the runtime path is:
 
 ```text
 OpenCode
-  -> @open-pets/cli mcp or @open-pets/opencode plugin
-  -> @open-pets/client
-  -> OpenPets desktop local IPC discovery file
-  -> OpenPets desktop IPC socket/pipe
-  -> default pet controller or explicit agent pet controller
+  -> @familiaros/cli mcp or @familiaros/opencode plugin
+  -> @familiaros/client
+  -> FamiliarOS desktop local IPC discovery file
+  -> FamiliarOS desktop IPC socket/pipe
+  -> default familiar controller or explicit agent familiar controller
 ```
 
 The desktop app writes a discovery file such as:
 
 ```text
-macOS: ~/Library/Application Support/OpenPets/runtime/ipc.json
-Windows: %APPDATA%/OpenPets/runtime/ipc.json
-Linux: $XDG_RUNTIME_DIR/openpets/ipc.json, or ~/.config/OpenPets/runtime/ipc.json fallback
+macOS: ~/Library/Application Support/FamiliarOS/runtime/ipc.json
+Windows: %APPDATA%/FamiliarOS/runtime/ipc.json
+Linux: $XDG_RUNTIME_DIR/familiaros/ipc.json, or ~/.config/FamiliarOS/runtime/ipc.json fallback
 ```
 
 That file contains the IPC endpoint and a per-run token. Clients must send that token with every request.
@@ -197,19 +197,19 @@ OpenCode sees these tools when the MCP entry is enabled:
 
 | Tool | Purpose | Desktop IPC method |
 | --- | --- | --- |
-| `openpets_status` | Check whether OpenPets is reachable and which pet is targeted. | `status` |
-| `openpets_react` | Set a short reaction on the target pet. | `pet.react` |
-| `openpets_say` | Show a short safe speech bubble, optionally with a reaction. | `pet.say` |
+| `familiaros_status` | Check whether FamiliarOS is reachable and which familiar is targeted. | `status` |
+| `familiaros_react` | Set a short reaction on the target familiar. | `familiar.react` |
+| `familiaros_say` | Show a short safe speech bubble, optionally with a reaction. | `familiar.say` |
 
-Depending on OpenCode's MCP naming, tool names may appear with a server prefix, for example `openpets_openpets_say`. The OpenCode plugin explicitly ignores OpenPets tool calls so the pet does not react to its own status messages.
+Depending on OpenCode's MCP naming, tool names may appear with a server prefix, for example `familiaros_familiaros_say`. The OpenCode plugin explicitly ignores FamiliarOS tool calls so the familiar does not react to its own status messages.
 
-`openpets_say` is validated before it reaches the desktop app. Messages must be short, single-line, and must not look like code, logs, secrets, URLs, or file paths.
+`familiaros_say` is validated before it reaches the desktop app. Messages must be short, single-line, and must not look like code, logs, secrets, URLs, or file paths.
 
-## Pet targeting
+## Familiar targeting
 
-If the MCP command or plugin was configured without a pet, events target the desktop default pet.
+If the MCP command or plugin was configured without a familiar, events target the desktop default familiar.
 
-If configured with a pet, OpenPets asks the desktop app for a lease:
+If configured with a familiar, FamiliarOS asks the desktop app for a lease:
 
 ```text
 lease.acquire({ requestedPetId: "<petId>" })
@@ -217,16 +217,16 @@ lease.acquire({ requestedPetId: "<petId>" })
 
 Routing rules:
 
-- Missing `pet` option -> default pet.
-- Requested pet is the default pet or built-in pet -> default pet.
-- Invalid, missing, or broken pet -> default pet with a fallback reason.
-- Valid installed non-default pet -> explicit agent pet window.
+- Missing `familiar` option -> default familiar.
+- Requested familiar is the default familiar or built-in familiar -> default familiar.
+- Invalid, missing, or broken familiar -> default familiar with a fallback reason.
+- Valid installed non-default familiar -> explicit agent familiar window.
 
-Explicit leases expire after a short TTL unless refreshed. The plugin caches and reuses a lease while it is still valid. When the last explicit lease for a pet expires or is released, OpenPets clears and closes that agent pet window.
+Explicit leases expire after a short TTL unless refreshed. The plugin caches and reuses a lease while it is still valid. When the last explicit lease for a familiar expires or is released, FamiliarOS clears and closes that agent familiar window.
 
 ## OpenCode plugin reaction and speech mapping
 
-The OpenCode plugin is decorative and best-effort. It schedules OpenPets work in the background and returns immediately so it does not slow down OpenCode hooks. If OpenPets is closed or IPC is unavailable, the plugin swallows the error.
+The OpenCode plugin is decorative and best-effort. It schedules FamiliarOS work in the background and returns immediately so it does not slow down OpenCode hooks. If FamiliarOS is closed or IPC is unavailable, the plugin swallows the error.
 
 | OpenCode event/hook | Trigger condition | Reaction | Speech bubble |
 | --- | --- | --- | --- |
@@ -234,17 +234,17 @@ The OpenCode plugin is decorative and best-effort. It schedules OpenPets work in
 | `tool.execute.before` | Tool name contains `edit`, `write`, `patch`, or `apply_patch`. | `editing` | None. |
 | `tool.execute.before` | Tool name contains `bash`, `shell`, or `terminal`, and command args look test-like. | `testing` | None. |
 | `tool.execute.before` | Tool name contains `bash`, `shell`, or `terminal`, and command args do not look test-like. | None. | None. |
-| `tool.execute.before` | Any other non-OpenPets tool. | None. | None. |
-| `event` | Bus event type is `permission.asked` for a non-OpenPets tool. | `waiting` | `Approval needed`, throttled with a short cooldown. |
+| `tool.execute.before` | Any other non-FamiliarOS tool. | None. | None. |
+| `event` | Bus event type is `permission.asked` for a non-FamiliarOS tool. | `waiting` | `Approval needed`, throttled with a short cooldown. |
 | `event` | Bus event type is `session.error`. | `error` | One error-pool message, throttled. |
 | `event` | Bus event type is `session.status` and status type is `idle`. | `success`, throttled. | None. |
 | `tool.execute.after` | Any tool completed. | None | None. |
-| OpenPets MCP tool | Tool name is `openpets_status`, `openpets_say`, `openpets_react`, or server-prefixed equivalent. | None | None. |
+| FamiliarOS MCP tool | Tool name is `familiaros_status`, `familiaros_say`, `familiaros_react`, or server-prefixed equivalent. | None | None. |
 | Unknown event | Event is not recognized. | None | None. |
 
 Test-like command detection is intentionally coarse and private. It may inspect only a bounded command string to classify the reaction. The command text is never sent to speech.
 
-OpenCode hooks do **not** use the left/right walking animations or the `running` reaction. The `running-right` and `running-left` sprite rows are reserved for pet drag/move motion, and generic shell activity is silent by default. Hook reactions use quieter phase changes instead: editing maps to the generic active-work row, thinking maps to `review`, waiting/testing maps to `waiting`, success maps to `jumping`, and errors map to `failed`.
+OpenCode hooks do **not** use the left/right walking animations or the `running` reaction. The `running-right` and `running-left` sprite rows are reserved for familiar drag/move motion, and generic shell activity is silent by default. Hook reactions use quieter phase changes instead: editing maps to the generic active-work row, thinking maps to `review`, waiting/testing maps to `waiting`, success maps to `jumping`, and errors map to `failed`.
 
 ## Plugin speech pools
 
@@ -269,19 +269,19 @@ Normal thinking and success hooks no longer speak, so their speech pools are ret
 OpenCode stores throttle state separately from Claude in an OpenCode-specific file, for example:
 
 ```text
-Windows: %LOCALAPPDATA%/OpenPets/opencode-hook-throttle.json
-macOS/Linux: ${XDG_STATE_HOME:-~/.local/state}/openpets/opencode-hook-throttle.json
-fallback: os.tmpdir()/openpets-<uid>/opencode-hook-throttle.json
+Windows: %LOCALAPPDATA%/FamiliarOS/opencode-hook-throttle.json
+macOS/Linux: ${XDG_STATE_HOME:-~/.local/state}/familiaros/opencode-hook-throttle.json
+fallback: os.tmpdir()/familiaros-<uid>/opencode-hook-throttle.json
 ```
 
 Throttle state stores only speech-category and reaction timestamp keys, never prompts, commands, tool input, output, code, logs, or transcripts.
 
 ## Safety rules
 
-- Plugin hooks return immediately and never await OpenPets IPC directly.
+- Plugin hooks return immediately and never await FamiliarOS IPC directly.
 - Plugin errors are swallowed unless debug logging is enabled.
 - Debug logs sanitize paths and secret-looking values.
 - Speech is static and local; it does not include model-generated text.
 - Tool args and command text are used only for coarse reaction classification.
-- The plugin ignores OpenPets MCP tools to avoid feedback loops.
-- Managed setup refuses unsafe symlinks, non-regular files, oversized config files, and conflicting custom OpenPets-like config.
+- The plugin ignores FamiliarOS MCP tools to avoid feedback loops.
+- Managed setup refuses unsafe symlinks, non-regular files, oversized config files, and conflicting custom FamiliarOS-like config.
diff --git a/docs/ops/GIT_CLEANUP_HYGIENE_PROTOCOL_2026-06-09.md b/docs/ops/GIT_CLEANUP_HYGIENE_PROTOCOL_2026-06-09.md
index 78bc8c15..d032d0d6 100644
--- a/docs/ops/GIT_CLEANUP_HYGIENE_PROTOCOL_2026-06-09.md
+++ b/docs/ops/GIT_CLEANUP_HYGIENE_PROTOCOL_2026-06-09.md
@@ -1,4 +1,4 @@
-# openpets Git Cleanup Hygiene Protocol
+# familiaros Git Cleanup Hygiene Protocol
 ## Date
 2026-06-09
 
diff --git a/docs/phases/phase-00-workspace-foundation.md b/docs/phases/phase-00-workspace-foundation.md
index 1b7814a9..bbdb0dc1 100644
--- a/docs/phases/phase-00-workspace-foundation.md
+++ b/docs/phases/phase-00-workspace-foundation.md
@@ -2,7 +2,7 @@
 
 ## Goal
 
-Create the fresh OpenPets 2.0 workspace foundation with excellent developer experience and Node/npm-compatible runtime behavior.
+Create the fresh FamiliarOS 2.0 workspace foundation with excellent developer experience and Node/npm-compatible runtime behavior.
 
 This phase should establish the project skeleton and basic commands needed for later implementation phases, without building real product features yet.
 
@@ -11,9 +11,9 @@ This phase should establish the project skeleton and basic commands needed for l
 This phase does not implement:
 
 - Tray/menu app behavior.
-- Floating pet windows.
-- Pet rendering.
-- Pet catalog browsing or installation.
+- Floating familiar windows.
+- Familiar rendering.
+- Familiar catalog browsing or installation.
 - Local IPC.
 - MCP tools.
 - Claude detection/configuration/hooks.
@@ -43,7 +43,7 @@ I can install dependencies, inspect the v2 workspace structure, and run basic ch
 - Workspace boundaries exclude v1 and web app code from v2 workspace commands.
 - Initial packages are protected from accidental publishing while they are skeletons.
 - Basic workspace scripts exist for checking/building the initial skeleton.
-- Package names align with the agreed `@open-pets/*` organization.
+- Package names align with the agreed `@familiaros/*` organization.
 - The initial package/app structure supports later phases without overbuilding empty abstractions.
 - The repo clearly distinguishes current v2 code from v1 reference code.
 
@@ -87,7 +87,7 @@ packages/
     tsconfig.json
     src/index.ts
 
-  pet-format/
+  familiar-format/
     package.json
     tsconfig.json
     src/index.ts
@@ -127,8 +127,8 @@ This means:
 - Contributors may run `pnpm install` and `pnpm check` during development.
 - Contributors should use Corepack or an explicitly documented pnpm version from the root `packageManager` field.
 - Published packages must be usable through normal Node/npm/npx flows.
-- `@open-pets/mcp` should eventually support `npx -y @open-pets/mcp`.
-- `@open-pets/cli` should eventually support `npx -y @open-pets/cli ...`.
+- `@familiaros/mcp` should eventually support `npx -y @familiaros/mcp`.
+- `@familiaros/cli` should eventually support `npx -y @familiaros/cli ...`.
 - No v2 package should rely on Bun runtime APIs.
 
 Workspace inclusion rule:
@@ -190,7 +190,7 @@ Recommended package intent:
 - `packages/mcp` — MCP stdio server, implemented in Phase 06.
 - `packages/claude` — Claude detection/configuration/hooks package, implemented in Phases 07–08.
 - `packages/cli` — explicit user-run CLI commands, implemented after core app/client behavior exists.
-- `packages/pet-format` — shared pet manifest/catalog validation types, used by pet manager/catalog install phases.
+- `packages/familiar-format` — shared familiar manifest/catalog validation types, used by familiar manager/catalog install phases.
 
 Deferred package:
 
@@ -264,7 +264,7 @@ Mitigation:
 
 ## Security/privacy notes
 
-This phase should not introduce network behavior, local IPC, config editing, pet zip extraction, or agent hooks.
+This phase should not introduce network behavior, local IPC, config editing, familiar zip extraction, or agent hooks.
 
 Security/privacy expectations for this phase:
 
@@ -330,7 +330,7 @@ After implementation, the user should verify:
    packages/mcp
    packages/claude
    packages/cli
-   packages/pet-format
+   packages/familiar-format
    ```
 
 6. Confirm no Bun command is required for v2 checks/builds.
diff --git a/docs/phases/phase-01-tray-desktop-shell.md b/docs/phases/phase-01-tray-desktop-shell.md
index dc003e95..6ced9f77 100644
--- a/docs/phases/phase-01-tray-desktop-shell.md
+++ b/docs/phases/phase-01-tray-desktop-shell.md
@@ -2,18 +2,18 @@
 
 ## Goal
 
-Create the first runnable OpenPets desktop app shell as a tray/menu-bar-first Electron app.
+Create the first runnable FamiliarOS desktop app shell as a tray/menu-bar-first Electron app.
 
-This phase should prove the desktop process, tray icon/menu, placeholder task windows, and clean quit flow work before building pet rendering or integrations.
+This phase should prove the desktop process, tray icon/menu, placeholder task windows, and clean quit flow work before building familiar rendering or integrations.
 
 ## Non-goals
 
 This phase does not implement:
 
-- Floating pet windows.
-- Transparent/always-on-top pet rendering.
-- Pet dragging or persisted pet position.
-- Real Pet Manager catalog behavior.
+- Floating familiar windows.
+- Transparent/always-on-top familiar rendering.
+- Familiar dragging or persisted familiar position.
+- Real Familiar Manager catalog behavior.
 - Real Agent Setup detection/configuration.
 - Real Settings persistence.
 - Local IPC.
@@ -27,7 +27,7 @@ This phase does not implement:
 After this phase, the user/developer should be able to run the desktop app and confirm:
 
 ```text
-OpenPets launches as a tray/menu-bar app, exposes the agreed tray menu, opens placeholder windows, and quits cleanly.
+FamiliarOS launches as a tray/menu-bar app, exposes the agreed tray menu, opens placeholder windows, and quits cleanly.
 ```
 
 ## Acceptance criteria
@@ -38,30 +38,30 @@ OpenPets launches as a tray/menu-bar app, exposes the agreed tray menu, opens pl
 - Tray menu contains the agreed initial entries:
 
   ```text
-  OpenPets
+  FamiliarOS
   ────────────────
-  Default Pet: <name>
-  Show Default Pet / Hide Default Pet
-  Pause All Pets / Resume All Pets
+  Default Familiar: <name>
+  Show Default Familiar / Hide Default Familiar
+  Pause All Familiars / Resume All Familiars
   ────────────────
-  Manage Pets...
+  Manage Familiars...
   Configure Agents...
   Settings...
   ────────────────
-  Quit OpenPets
+  Quit FamiliarOS
   ```
 
-- `OpenPets` is a disabled title row.
-- `Default Pet: <name>` exists and can open the placeholder Pet Manager window.
-- `Show Default Pet / Hide Default Pet` exists but may be disabled or no-op until Phase 02.
-- `Pause All Pets / Resume All Pets` exists and toggles visible menu state, even if no pets exist yet.
-- `Manage Pets...` opens a placeholder Pet Manager window.
+- `FamiliarOS` is a disabled title row.
+- `Default Familiar: <name>` exists and can open the placeholder Familiar Manager window.
+- `Show Default Familiar / Hide Default Familiar` exists but may be disabled or no-op until Phase 02.
+- `Pause All Familiars / Resume All Familiars` exists and toggles visible menu state, even if no familiars exist yet.
+- `Manage Familiars...` opens a placeholder Familiar Manager window.
 - `Configure Agents...` opens a placeholder Agent Setup window.
 - `Settings...` opens a placeholder Settings window.
 - Placeholder windows are single-instance: choosing the same menu item focuses/reopens the existing window instead of spawning duplicates.
 - Closing a placeholder window destroys only that window, clears its window reference, and does not quit the app.
 - The app process is single-instance: a second launch must not create duplicate tray icons.
-- `Quit OpenPets` exits the app cleanly.
+- `Quit FamiliarOS` exits the app cleanly.
 - macOS behavior is handled intentionally: closing placeholder windows does not quit; explicit quit does quit.
 - Basic app lifecycle errors are logged clearly during development.
 - Existing Phase 00 checks continue to pass.
@@ -96,7 +96,7 @@ Use Electron for the desktop shell.
 Recommended Phase 01 behavior:
 
 - Add Electron as a development/runtime dependency of `apps/desktop` only.
-- Add a dev command such as `pnpm --filter @open-pets/desktop dev`.
+- Add a dev command such as `pnpm --filter @familiaros/desktop dev`.
 - Keep renderer placeholders minimal; do not introduce a frontend framework yet unless required.
 - Use simple BrowserWindow placeholder windows with hardcoded data URLs for Phase 01.
 - Keep all real product logic out of placeholders.
@@ -134,10 +134,10 @@ Electron lifecycle rules:
 - No window opens on startup.
 - `window-all-closed` does not quit the app.
 - macOS `activate` does not create a dashboard/main window.
-- `Quit OpenPets` sets an intentional quit flag and calls `app.quit()`.
+- `Quit FamiliarOS` sets an intentional quit flag and calls `app.quit()`.
 - Use `app.requestSingleInstanceLock()` so a second launch does not create duplicate tray icons.
 - On second instance, keep/focus the existing app where practical and exit the second process.
-- Set the app name to `OpenPets` where practical.
+- Set the app name to `FamiliarOS` where practical.
 
 macOS tray/Dock decision:
 
@@ -147,16 +147,16 @@ macOS tray/Dock decision:
 
 Tray/menu state:
 
-- Default pet label can use a hardcoded placeholder name such as `Default Pet: Built-in Pet` or `Default Pet: Snoopy` until real pet state exists.
-- Use `Default Pet: Built-in Pet` for Phase 01.
-- `Default Pet: Built-in Pet` opens the placeholder Pet Manager window.
-- `Show Default Pet` is disabled until Phase 02.
+- Default familiar label can use a hardcoded placeholder name such as `Default Familiar: Built-in Familiar` or `Default Familiar: Snoopy` until real familiar state exists.
+- Use `Default Familiar: Built-in Familiar` for Phase 01.
+- `Default Familiar: Built-in Familiar` opens the placeholder Familiar Manager window.
+- `Show Default Familiar` is disabled until Phase 02.
 - Pause state can be an in-memory boolean for now.
-- Pause toggle only changes the in-memory menu label between `Pause All Pets` and `Resume All Pets`.
+- Pause toggle only changes the in-memory menu label between `Pause All Familiars` and `Resume All Familiars`.
 
 Placeholder windows:
 
-- Pet Manager placeholder should make clear it is placeholder UI.
+- Familiar Manager placeholder should make clear it is placeholder UI.
 - Agent Setup placeholder should make clear it is placeholder UI.
 - Settings placeholder should make clear it is placeholder UI.
 - Each placeholder window should have a stable title.
@@ -201,7 +201,7 @@ Mitigation:
 
 - Manage app quit explicitly.
 - Closing placeholder task windows should not quit the app.
-- `Quit OpenPets` should be the clear exit path.
+- `Quit FamiliarOS` should be the clear exit path.
 
 ### Risk: static assets fail at runtime
 
@@ -214,7 +214,7 @@ Mitigation:
 
 ## Security/privacy notes
 
-This phase should not touch user agent configuration, shell profiles, Claude settings, local IPC sockets, network, pet zips, or user data beyond normal Electron app startup.
+This phase should not touch user agent configuration, shell profiles, Claude settings, local IPC sockets, network, familiar zips, or user data beyond normal Electron app startup.
 
 Security/privacy expectations:
 
@@ -251,7 +251,7 @@ pnpm build
 Manual app run command should be documented after implementation, likely:
 
 ```bash
-pnpm --filter @open-pets/desktop dev
+pnpm --filter @familiaros/desktop dev
 ```
 
 Expected automated result:
@@ -266,15 +266,15 @@ After implementation, the user should verify:
 
 1. Start the desktop app with the documented command.
 2. Confirm no dashboard/main window opens automatically.
-3. Confirm OpenPets appears in the tray/menu bar.
+3. Confirm FamiliarOS appears in the tray/menu bar.
 4. Open the tray menu and verify entries match the Phase 01 menu.
-5. Click `Manage Pets...` and confirm one placeholder Pet Manager window opens.
-6. Click `Manage Pets...` again and confirm it focuses/reuses the existing window instead of spawning duplicates.
+5. Click `Manage Familiars...` and confirm one placeholder Familiar Manager window opens.
+6. Click `Manage Familiars...` again and confirm it focuses/reuses the existing window instead of spawning duplicates.
 7. Repeat for `Configure Agents...`.
 8. Repeat for `Settings...`.
-9. Toggle `Pause All Pets` and confirm the menu changes to `Resume All Pets`.
+9. Toggle `Pause All Familiars` and confirm the menu changes to `Resume All Familiars`.
 10. Close placeholder windows and confirm the app stays running in tray/menu bar.
-11. Choose `Quit OpenPets` and confirm the app exits cleanly.
+11. Choose `Quit FamiliarOS` and confirm the app exits cleanly.
 
 Manual acceptance question:
 
@@ -304,7 +304,7 @@ Summary of required Oracle feedback:
 - Fixed: Chose data URLs/generated icon strategy to avoid asset-copy issues in Phase 01.
 - Fixed: Made BrowserWindow security defaults mandatory.
 - Fixed: Chose destroy-on-close semantics for placeholder windows.
-- Fixed: Chose `Default Pet: Built-in Pet`, disabled `Show Default Pet`, and in-memory pause-label toggle for Phase 01.
+- Fixed: Chose `Default Familiar: Built-in Familiar`, disabled `Show Default Familiar`, and in-memory pause-label toggle for Phase 01.
 - Fixed: Added exact `dev` script shape: `pnpm build && electron .`.
 - Fixed: Added macOS `app.dock.hide()` decision.
 
@@ -313,7 +313,7 @@ Summary of required Oracle feedback:
 Oracle reviewed the implemented Phase 01 diff after successful validation with:
 
 ```bash
-pnpm check && pnpm typecheck && pnpm build && pnpm --filter @open-pets/desktop exec electron --version
+pnpm check && pnpm typecheck && pnpm build && pnpm --filter @familiaros/desktop exec electron --version
 ```
 
 Initial implementation review blocked manual verification until two issues were fixed:
diff --git a/docs/phases/phase-02-default-pet-window.md b/docs/phases/phase-02-default-pet-window.md
index 3e5ab48d..dd0262d1 100644
--- a/docs/phases/phase-02-default-pet-window.md
+++ b/docs/phases/phase-02-default-pet-window.md
@@ -1,18 +1,18 @@
-# Phase 02: Default pet window foundation
+# Phase 02: Default familiar window foundation
 
 ## Goal
 
-Show the bundled default pet as a real floating desktop companion window.
+Show the bundled default familiar as a real floating desktop companion window.
 
-This phase should prove the core visible OpenPets experience: a small pet appears, can be dragged, can be shown/hidden from the tray, can be paused/resumed, and remembers its position across app restarts.
+This phase should prove the core visible FamiliarOS experience: a small familiar appears, can be dragged, can be shown/hidden from the tray, can be paused/resumed, and remembers its position across app restarts.
 
 ## Non-goals
 
 This phase does not implement:
 
-- Pet catalog browsing or installation.
-- Multiple installed pets.
-- Non-default temporary agent pets.
+- Familiar catalog browsing or installation.
+- Multiple installed familiars.
+- Non-default temporary agent familiars.
 - MCP leases.
 - Local IPC.
 - Claude integration.
@@ -28,30 +28,30 @@ This phase does not implement:
 After this phase, the user/developer should be able to run the desktop app and confirm:
 
 ```text
-The bundled default pet appears as a small floating window, can be dragged, can be hidden/shown from the tray, pause/resume visibly affects it, and its position persists across restarts.
+The bundled default familiar appears as a small floating window, can be dragged, can be hidden/shown from the tray, pause/resume visibly affects it, and its position persists across restarts.
 ```
 
 ## Acceptance criteria
 
 - Desktop app still launches tray-first.
-- Bundled default pet appears automatically on app launch.
-- Pet window is frameless.
-- Pet window has transparent background where supported by the platform.
-- Pet window is always-on-top by default.
-- Pet window does not steal focus from the active editor/terminal where supported.
-- Pet window is draggable by the user.
-- Pet window remembers its last position across app restarts.
+- Bundled default familiar appears automatically on app launch.
+- Familiar window is frameless.
+- Familiar window has transparent background where supported by the platform.
+- Familiar window is always-on-top by default.
+- Familiar window does not steal focus from the active editor/terminal where supported.
+- Familiar window is draggable by the user.
+- Familiar window remembers its last position across app restarts.
 - Initial default position is near the bottom-right of the primary display work area.
 - Initial position is clamped to the visible work area.
 - Stored position is clamped if it is no longer visible/safe.
-- `Show Default Pet` / `Hide Default Pet` tray item works for the persistent default pet.
-- `Pause All Pets` / `Resume All Pets` visibly affects the pet.
-- Closing placeholder task windows does not close the pet or quit the app.
-- Quitting OpenPets closes the pet window cleanly.
+- `Show Default Familiar` / `Hide Default Familiar` tray item works for the persistent default familiar.
+- `Pause All Familiars` / `Resume All Familiars` visibly affects the familiar.
+- Closing placeholder task windows does not close the familiar or quit the app.
+- Quitting FamiliarOS closes the familiar window cleanly.
 - Phase 01 placeholder windows and tray behavior continue to work.
 - Known platform limitations are documented after manual testing.
-- Hidden state is session-only in Phase 02: every fresh app launch shows the default pet.
-- Display changes while running re-clamp the pet to a visible work area.
+- Hidden state is session-only in Phase 02: every fresh app launch shows the default familiar.
+- Display changes while running re-clamp the familiar to a visible work area.
 
 ## Proposed files/directories
 
@@ -69,9 +69,9 @@ README.md
 Likely add:
 
 ```text
-apps/desktop/src/pet-window.ts
-apps/desktop/src/pet-state.ts
-apps/desktop/src/default-pet-controller.ts
+apps/desktop/src/familiar-window.ts
+apps/desktop/src/familiar-state.ts
+apps/desktop/src/default-familiar-controller.ts
 apps/desktop/src/display.ts
 ```
 
@@ -81,24 +81,24 @@ Exact file names can change if a simpler structure is better.
 
 Keep this phase intentionally simple and stable.
 
-### Pet rendering
+### Familiar rendering
 
-Use a minimal bundled default pet renderer for Phase 02.
+Use a minimal bundled default familiar renderer for Phase 02.
 
 Recommended approach:
 
-- Render a small hardcoded pet placeholder using inline generated HTML/CSS/SVG or canvas from TypeScript.
-- Avoid adding a real spritesheet animation system until the pet format/catalog phases unless it is simpler to reuse a safe bundled asset.
-- The pet should visibly look like a pet/companion, not a blank test square.
-- Pause/resume should visibly change the pet state, for example normal idle animation vs still/dimmed/paused label.
-- Do not put required runtime pet assets under `src/` unless an explicit copy strategy is added.
+- Render a small hardcoded familiar placeholder using inline generated HTML/CSS/SVG or canvas from TypeScript.
+- Avoid adding a real spritesheet animation system until the familiar format/catalog phases unless it is simpler to reuse a safe bundled asset.
+- The familiar should visibly look like a familiar/companion, not a blank test square.
+- Pause/resume should visibly change the familiar state, for example normal idle animation vs still/dimmed/paused label.
+- Do not put required runtime familiar assets under `src/` unless an explicit copy strategy is added.
 - Prefer inline generated content for Phase 02 so plain `tsc` builds remain sufficient.
 
-This phase is about window behavior, not final pet art or animation fidelity.
+This phase is about window behavior, not final familiar art or animation fidelity.
 
-### Pet window behavior
+### Familiar window behavior
 
-Use a dedicated `BrowserWindow` for the default pet.
+Use a dedicated `BrowserWindow` for the default familiar.
 
 Use fixed Phase 02 window bounds:
 
@@ -108,7 +108,7 @@ height: 180 DIP
 margin from work area: 24 DIP
 ```
 
-The window should be tight around the visible pet to avoid a large transparent click-blocking overlay.
+The window should be tight around the visible familiar to avoid a large transparent click-blocking overlay.
 
 Recommended BrowserWindow properties:
 
@@ -123,29 +123,29 @@ Use conservative always-on-top behavior. Do not use aggressive screen-saver/topm
 
 Focus behavior:
 
-- When showing the pet automatically or from tray, use `showInactive()` where practical so the pet does not steal focus from the active editor/terminal.
-- Clicking or dragging the pet may focus the pet window on some platforms; this is best-effort and should be documented after manual testing.
+- When showing the familiar automatically or from tray, use `showInactive()` where practical so the familiar does not steal focus from the active editor/terminal.
+- Clicking or dragging the familiar may focus the familiar window on some platforms; this is best-effort and should be documented after manual testing.
 - Do not use fragile native hacks in Phase 02.
 - If perfect no-focus behavior is not possible on a platform, document it as a known limitation.
 
 Dragging:
 
-- The user should be able to drag the pet window.
-- Preferred implementation: CSS `-webkit-app-region: drag` for the pet surface so no IPC/preload is needed.
+- The user should be able to drag the familiar window.
+- Preferred implementation: CSS `-webkit-app-region: drag` for the familiar surface so no IPC/preload is needed.
 - If CSS app-region cannot satisfy the behavior, use a narrow preload bridge only for drag movement.
 - Do not introduce broad renderer privileges for dragging.
 
 Pause/resume renderer updates:
 
-- Preferred implementation: reload/regenerate the local pet HTML with the paused state.
+- Preferred implementation: reload/regenerate the local familiar HTML with the paused state.
 - Alternative: use a narrow preload bridge only if needed.
 - Do not use a broad `executeJavaScript` control channel.
 
-### Default pet ownership model
+### Default familiar ownership model
 
-Add a small default-pet controller/module to own default pet lifecycle.
+Add a small default-familiar controller/module to own default familiar lifecycle.
 
-The tray should not directly manage pet window internals.
+The tray should not directly manage familiar window internals.
 
 Recommended controller API shape:
 
@@ -159,25 +159,25 @@ destroyDefaultPet(): void
 
 Responsibilities:
 
-- Create the pet window on app launch.
-- Show/hide default pet.
+- Create the familiar window on app launch.
+- Show/hide default familiar.
 - Track visible state for the current app session.
 - Apply paused state to the renderer.
 - Persist and restore position.
-- Destroy the pet window on app quit.
+- Destroy the familiar window on app quit.
 
 Hidden state rule:
 
-- `Hide Default Pet` hides the window but does not destroy it.
+- `Hide Default Familiar` hides the window but does not destroy it.
 - Hidden state is session-only in Phase 02.
-- On fresh app launch, the default pet appears automatically again.
+- On fresh app launch, the default familiar appears automatically again.
 - Position persists; hidden/visible preference does not persist yet.
 
 ### Persistence
 
 Persist only the minimum state needed for Phase 02:
 
-- Default pet position.
+- Default familiar position.
 - Paused state may remain in-memory for this phase unless persistence is trivial.
 
 Use Electron `app.getPath("userData")` for local app state.
@@ -185,7 +185,7 @@ Use Electron `app.getPath("userData")` for local app state.
 Recommended state file:
 
 ```text
-<userData>/openpets-state.json
+<userData>/familiaros-state.json
 ```
 
 State writes should be simple and safe:
@@ -202,29 +202,29 @@ Use the primary display work area for Phase 02.
 Rules:
 
 - Position values use Electron DIP coordinates.
-- Store integer `x` and `y` values for the full pet window bounds.
+- Store integer `x` and `y` values for the full familiar window bounds.
 - Initial position: bottom-right of primary display work area with 24 DIP margin.
 - Stored position: clamp to visible work area on launch.
 - Clamp the full 180x180 DIP window so it remains fully visible.
 - Do not attempt advanced multi-monitor restoration yet.
-- If displays change, keep the pet visible rather than preserving exact off-screen coordinates.
-- Listen for display changes where practical and re-clamp the default pet to the primary work area.
+- If displays change, keep the familiar visible rather than preserving exact off-screen coordinates.
+- Listen for display changes where practical and re-clamp the default familiar to the primary work area.
 
 ### Tray integration
 
 Update the Phase 01 tray item:
 
-- If default pet visible: show `Hide Default Pet`.
-- If default pet hidden: show `Show Default Pet`.
-- Clicking toggles the default pet window.
-- `Pause All Pets` / `Resume All Pets` updates the pet visual state.
+- If default familiar visible: show `Hide Default Familiar`.
+- If default familiar hidden: show `Show Default Familiar`.
+- Clicking toggles the default familiar window.
+- `Pause All Familiars` / `Resume All Familiars` updates the familiar visual state.
 
-Default pet lifetime:
+Default familiar lifetime:
 
-- Default pet is persistent.
+- Default familiar is persistent.
 - It is not closed due to agent lifecycle in future phases.
-- In this phase, hiding does not destroy the pet window.
-- The pet window is destroyed only when OpenPets quits.
+- In this phase, hiding does not destroy the familiar window.
+- The familiar window is destroyed only when FamiliarOS quits.
 
 ## Risks and tradeoffs
 
@@ -245,7 +245,7 @@ Transparent frameless windows can vary on Linux/window managers.
 Mitigation:
 
 - Implement best-effort Electron transparent window behavior.
-- Keep fallback acceptable: pet remains visible even if transparency is imperfect.
+- Keep fallback acceptable: familiar remains visible even if transparency is imperfect.
 - Document limitations.
 
 ### Risk: dragging requires IPC/preload before local IPC phase
@@ -254,9 +254,9 @@ Dragging may require communication between renderer and main process, but Phase
 
 Mitigation:
 
-- If needed, use a very narrow Electron preload bridge only for pet window dragging.
-- Do not implement external/local OpenPets IPC in this phase.
-- Keep the bridge private to the pet renderer.
+- If needed, use a very narrow Electron preload bridge only for familiar window dragging.
+- Do not implement external/local FamiliarOS IPC in this phase.
+- Keep the bridge private to the familiar renderer.
 
 ### Risk: state file corruption
 
@@ -269,41 +269,41 @@ Mitigation:
 - Atomic write where practical.
 - Fall back to defaults without crashing.
 
-### Risk: scope creep into pet engine
+### Risk: scope creep into familiar engine
 
 It is tempting to build the final sprite/animation system now.
 
 Mitigation:
 
 - Keep rendering minimal.
-- Build only enough to verify floating pet behavior.
-- Defer final manifest/spritesheet rendering to catalog/pet-format phases.
+- Build only enough to verify floating familiar behavior.
+- Defer final manifest/spritesheet rendering to catalog/familiar-format phases.
 
-### Risk: pet window blocks clicks over transparent areas
+### Risk: familiar window blocks clicks over transparent areas
 
 Transparent BrowserWindows still have rectangular bounds and may intercept clicks.
 
 Mitigation:
 
-- Keep the Phase 02 pet window small and tight around the pet.
+- Keep the Phase 02 familiar window small and tight around the familiar.
 - Do not create a large transparent overlay.
 - Defer click-through/advanced hit-testing behavior unless it becomes necessary.
 
 ## Security/privacy notes
 
-This phase should not touch coding-agent configs, Claude settings, MCP, local adapter IPC, network, or pet zip extraction.
+This phase should not touch coding-agent configs, Claude settings, MCP, local adapter IPC, network, or familiar zip extraction.
 
 Security/privacy expectations:
 
 - No telemetry.
 - No network calls.
-- No remote content loaded in pet window.
-- No config file edits outside OpenPets own userData state file.
+- No remote content loaded in familiar window.
+- No config file edits outside FamiliarOS own userData state file.
 - No shell command execution.
-- Pet renderer uses hardcoded local content only.
-- Pet renderer includes a restrictive CSP.
-- Pet renderer denies navigation, redirects, and new windows.
-- Pet renderer logs load failures and renderer crashes clearly during development.
+- Familiar renderer uses hardcoded local content only.
+- Familiar renderer includes a restrictive CSP.
+- Familiar renderer denies navigation, redirects, and new windows.
+- Familiar renderer logs load failures and renderer crashes clearly during development.
 - BrowserWindow security defaults are mandatory:
   - `nodeIntegration: false`
   - `contextIsolation: true`
@@ -326,7 +326,7 @@ pnpm build
 Manual app run command:
 
 ```bash
-pnpm --filter @open-pets/desktop dev
+pnpm --filter @familiaros/desktop dev
 ```
 
 Expected automated result:
@@ -342,31 +342,31 @@ After implementation, the user should verify:
 1. Start the desktop app:
 
    ```bash
-   pnpm --filter @open-pets/desktop dev
+   pnpm --filter @familiaros/desktop dev
    ```
 
 2. Confirm no dashboard/main window opens automatically.
 3. Confirm tray icon/menu still appears.
-4. Confirm the default pet appears automatically.
-5. Confirm the pet is a small frameless floating window.
-6. Confirm the pet stays above normal windows where supported.
-7. Confirm clicking/dragging the pet does not unexpectedly steal focus from the active app where supported.
-8. Drag the pet to a new position.
-9. Quit OpenPets from the tray.
-10. Restart OpenPets and confirm the pet position persists.
-11. Use tray `Hide Default Pet` and confirm the pet hides without quitting the app.
-12. Use tray `Show Default Pet` and confirm the same default pet returns.
-13. Hide the pet, quit OpenPets, restart OpenPets, and confirm the pet appears again because hidden state is not persisted in Phase 02.
-14. Toggle `Pause All Pets` and confirm the pet visibly changes to paused/quiet state.
-15. Toggle `Resume All Pets` and confirm the pet returns to normal state.
-16. Open/close placeholder Pet Manager, Configure Agents, and Settings windows and confirm the pet remains alive.
-17. If practical, move/change displays and confirm the pet remains visible or is re-clamped on restart.
-18. Quit OpenPets and confirm all windows close cleanly.
+4. Confirm the default familiar appears automatically.
+5. Confirm the familiar is a small frameless floating window.
+6. Confirm the familiar stays above normal windows where supported.
+7. Confirm clicking/dragging the familiar does not unexpectedly steal focus from the active app where supported.
+8. Drag the familiar to a new position.
+9. Quit FamiliarOS from the tray.
+10. Restart FamiliarOS and confirm the familiar position persists.
+11. Use tray `Hide Default Familiar` and confirm the familiar hides without quitting the app.
+12. Use tray `Show Default Familiar` and confirm the same default familiar returns.
+13. Hide the familiar, quit FamiliarOS, restart FamiliarOS, and confirm the familiar appears again because hidden state is not persisted in Phase 02.
+14. Toggle `Pause All Familiars` and confirm the familiar visibly changes to paused/quiet state.
+15. Toggle `Resume All Familiars` and confirm the familiar returns to normal state.
+16. Open/close placeholder Familiar Manager, Configure Agents, and Settings windows and confirm the familiar remains alive.
+17. If practical, move/change displays and confirm the familiar remains visible or is re-clamped on restart.
+18. Quit FamiliarOS and confirm all windows close cleanly.
 
 Manual acceptance question:
 
 ```text
-Does Phase 02 pass on your machine: default pet appears, can be dragged, persists position, show/hide works, pause/resume is visible, and quit is clean?
+Does Phase 02 pass on your machine: default familiar appears, can be dragged, persists position, show/hide works, pause/resume is visible, and quit is clean?
 ```
 
 ## Oracle plan review
@@ -375,28 +375,28 @@ Oracle reviewed the initial Phase 02 spec and blocked implementation until lifec
 
 Summary of required Oracle feedback:
 
-- Clarify default pet launch visibility and hidden-state persistence.
+- Clarify default familiar launch visibility and hidden-state persistence.
 - Clarify hide vs destroy behavior.
-- Add a default-pet controller ownership model instead of tray owning lifecycle.
-- Replace required `src/assets/default-pet.svg` asset idea with inline generated content or explicit copy strategy.
+- Add a default-familiar controller ownership model instead of tray owning lifecycle.
+- Replace required `src/assets/default-familiar.svg` asset idea with inline generated content or explicit copy strategy.
 - Define fixed window size and clamping rules.
 - Define focus behavior precisely, especially `showInactive()` and click/drag limitations.
 - Choose drag strategy order.
 - Define pause/resume renderer update mechanism.
-- Add pet-window security hardening details.
+- Add familiar-window security hardening details.
 - Add manual verification for hidden/restart and display re-clamping behavior.
 
 ## Oracle feedback disposition
 
-- Fixed: Default pet appears on every fresh launch; hidden state is session-only in Phase 02.
-- Fixed: `Hide Default Pet` hides but does not destroy the pet window; destroy happens on app quit.
-- Fixed: Added default-pet controller ownership model and API shape.
-- Fixed: Replaced runtime asset recommendation with inline generated pet HTML/CSS/SVG/canvas.
+- Fixed: Default familiar appears on every fresh launch; hidden state is session-only in Phase 02.
+- Fixed: `Hide Default Familiar` hides but does not destroy the familiar window; destroy happens on app quit.
+- Fixed: Added default-familiar controller ownership model and API shape.
+- Fixed: Replaced runtime asset recommendation with inline generated familiar HTML/CSS/SVG/canvas.
 - Fixed: Added fixed 180x180 DIP window size, 24 DIP margin, integer DIP coordinates, and full-window clamping rules.
 - Fixed: Clarified `showInactive()` focus behavior and click/drag best-effort limitations.
 - Fixed: Chose CSS `-webkit-app-region: drag` first; narrow preload bridge only if necessary.
-- Fixed: Chose reload/regenerate local pet HTML for pause/resume first; narrow preload only if necessary.
-- Fixed: Added CSP/navigation/new-window/load-failure/render-crash security requirements for pet renderer.
+- Fixed: Chose reload/regenerate local familiar HTML for pause/resume first; narrow preload only if necessary.
+- Fixed: Added CSP/navigation/new-window/load-failure/render-crash security requirements for familiar renderer.
 - Fixed: Added manual verification for hidden/restart behavior and display re-clamping.
 
 ## Oracle implementation review
@@ -409,12 +409,12 @@ pnpm check && pnpm typecheck && pnpm build
 
 Initial implementation review blocked manual verification until two issues were fixed:
 
-- The initial tray menu label could be stale because the tray was created before the default pet was shown.
-- A pending debounced position save could read from a destroyed pet window if the user dragged and quit quickly.
+- The initial tray menu label could be stale because the tray was created before the default familiar was shown.
+- A pending debounced position save could read from a destroyed familiar window if the user dragged and quit quickly.
 
 Implementation review disposition:
 
-- Fixed: Exported `refreshTrayMenu()` and called it after `showDefaultPet()` on startup so the tray label reflects the visible pet.
+- Fixed: Exported `refreshTrayMenu()` and called it after `showDefaultPet()` on startup so the tray label reflects the visible familiar.
 - Fixed: Guarded the debounced position save with `window.isDestroyed()` before reading window position.
 
 Oracle re-reviewed the fixes and approved Phase 02 for manual user verification.
diff --git a/docs/phases/phase-03-local-state-pet-manager-basics.md b/docs/phases/phase-03-local-state-pet-manager-basics.md
index a7811054..626de47c 100644
--- a/docs/phases/phase-03-local-state-pet-manager-basics.md
+++ b/docs/phases/phase-03-local-state-pet-manager-basics.md
@@ -1,20 +1,20 @@
-# Phase 03: Local state and Pet Manager basics
+# Phase 03: Local state and Familiar Manager basics
 
 ## Goal
 
-Turn the current desktop shell into a minimally real local-first app by formalizing app state and making Pet Manager / Settings show and update the built-in default pet behavior.
+Turn the current desktop shell into a minimally real local-first app by formalizing app state and making Familiar Manager / Settings show and update the built-in default familiar behavior.
 
-This phase should prove that OpenPets owns local preferences and installed-pet state before remote catalog installation, MCP, or Claude integration are added.
+This phase should prove that FamiliarOS owns local preferences and installed-familiar state before remote catalog installation, MCP, or Claude integration are added.
 
 ## Non-goals
 
 This phase does not implement:
 
-- Remote v2 pet catalog fetching.
-- Downloading or installing pet zip files.
-- Removing downloaded pets.
-- Multiple real pet assets beyond the bundled built-in pet.
-- Full pet manifest/spritesheet engine.
+- Remote v2 familiar catalog fetching.
+- Downloading or installing familiar zip files.
+- Removing downloaded familiars.
+- Multiple real familiar assets beyond the bundled built-in familiar.
+- Full familiar manifest/spritesheet engine.
 - Agent setup detection/configuration.
 - Local adapter IPC.
 - MCP integration.
@@ -28,37 +28,37 @@ This phase does not implement:
 After this phase, the user/developer should be able to run the app and confirm:
 
 ```text
-Pet Manager shows the bundled built-in pet as installed/default/protected, Settings controls core local preferences, and those preferences persist across restarts.
+Familiar Manager shows the bundled built-in familiar as installed/default/protected, Settings controls core local preferences, and those preferences persist across restarts.
 ```
 
 ## Acceptance criteria
 
-- Existing tray shell and default pet window behavior continue to work.
+- Existing tray shell and default familiar window behavior continue to work.
 - App state has a clear versioned schema.
 - State is loaded after `app.whenReady()` and not at module import time.
 - State remains local-only under Electron `app.getPath("userData")`.
 - State reads are defensive and corrupted/invalid state falls back safely.
 - State writes are atomic where practical.
-- `app-state.ts` is the only owner/writer of `openpets-state.json`.
-- Phase 02 `pet-state.ts` is retired or delegates to `app-state.ts` so pet position writes cannot clobber preferences/pets.
-- Existing unversioned Phase 02 state is migrated to V1 while preserving default pet position.
-- Built-in pet exists in app state as an installed/protected pet.
-- Built-in pet cannot be removed.
-- Built-in pet is the default pet unless the state says otherwise.
-- Pet Manager is upgraded from placeholder to a minimal real local view.
-- Pet Manager shows installed pets, including the built-in pet.
-- Pet Manager shows badges/states for `Built-in`, `Installed`, `Default`, and `Protected` where applicable.
-- Pet Manager shows that built-in pet removal is unavailable/disabled.
-- Pet Manager can set an installed pet as default; in Phase 03 this may be a no-op if only the built-in pet exists, but the UI/state path should be real.
+- `app-state.ts` is the only owner/writer of `familiaros-state.json`.
+- Phase 02 `familiar-state.ts` is retired or delegates to `app-state.ts` so familiar position writes cannot clobber preferences/familiars.
+- Existing unversioned Phase 02 state is migrated to V1 while preserving default familiar position.
+- Built-in familiar exists in app state as an installed/protected familiar.
+- Built-in familiar cannot be removed.
+- Built-in familiar is the default familiar unless the state says otherwise.
+- Familiar Manager is upgraded from placeholder to a minimal real local view.
+- Familiar Manager shows installed familiars, including the built-in familiar.
+- Familiar Manager shows badges/states for `Built-in`, `Installed`, `Default`, and `Protected` where applicable.
+- Familiar Manager shows that built-in familiar removal is unavailable/disabled.
+- Familiar Manager can set an installed familiar as default; in Phase 03 this may be a no-op if only the built-in familiar exists, but the UI/state path should be real.
 - Settings is upgraded from placeholder to a minimal real preferences view.
-- Settings can control `open default pet on app launch`.
+- Settings can control `open default familiar on app launch`.
 - Settings can control `speech bubbles enabled`, even though speech bubbles are not implemented yet.
-- `petScale` may exist as inert schema state with default `1`, but visible pet scale controls are deferred to a later phase.
-- Settings can reset the default pet position.
+- `petScale` may exist as inert schema state with default `1`, but visible familiar scale controls are deferred to a later phase.
+- Settings can reset the default familiar position.
 - Preferences persist across app restarts.
-- If `open default pet on app launch` is disabled, app starts tray-first without showing the default pet.
-- `Show Default Pet` can still show the default pet manually when launch-open is disabled.
-- If `open default pet on app launch` is re-enabled, the pet appears on future launches.
+- If `open default familiar on app launch` is disabled, app starts tray-first without showing the default familiar.
+- `Show Default Familiar` can still show the default familiar manually when launch-open is disabled.
+- If `open default familiar on app launch` is re-enabled, the familiar appears on future launches.
 - Phase 02 hidden-state rule remains: hiding from tray is session-only and is not the same as disabling open-on-launch.
 - Automated checks pass.
 
@@ -70,9 +70,9 @@ Likely update:
 apps/desktop/src/main.ts
 apps/desktop/src/tray.ts
 apps/desktop/src/windows.ts
-apps/desktop/src/default-pet-controller.ts
-apps/desktop/src/pet-state.ts
-apps/desktop/src/pet-window.ts
+apps/desktop/src/default-familiar-controller.ts
+apps/desktop/src/familiar-state.ts
+apps/desktop/src/familiar-window.ts
 README.md
 ```
 
@@ -80,9 +80,9 @@ Likely add:
 
 ```text
 apps/desktop/src/app-state.ts
-apps/desktop/src/built-in-pet.ts
+apps/desktop/src/built-in-familiar.ts
 apps/desktop/src/settings-controller.ts
-apps/desktop/src/pet-manager-controller.ts
+apps/desktop/src/familiar-manager-controller.ts
 apps/desktop/src/renderer-html.ts
 apps/desktop/src/preload.ts            # only if needed for safe internal Electron UI actions
 ```
@@ -100,13 +100,13 @@ Formalize a versioned local app state file.
 Recommended state path:
 
 ```text
-<userData>/openpets-state.json
+<userData>/familiaros-state.json
 ```
 
 Recommended state shape:
 
 ```ts
-interface OpenPetsStateV1 {
+interface FamiliarOSStateV1 {
   version: 1;
   preferences: {
     defaultPetId: string;
@@ -114,7 +114,7 @@ interface OpenPetsStateV1 {
     speechBubblesEnabled: boolean;
     petScale: number;
   };
-  pets: {
+  familiars: {
     installed: Array<{
       id: string;
       displayName: string;
@@ -133,17 +133,17 @@ interface OpenPetsStateV1 {
 
 Default state:
 
-- `defaultPetId`: built-in pet id.
+- `defaultPetId`: built-in familiar id.
 - `openDefaultPetOnLaunch`: `true`.
 - `speechBubblesEnabled`: `true`.
 - `petScale`: `1`.
-- Installed pets contains the built-in pet.
+- Installed familiars contains the built-in familiar.
 
 State rules:
 
-- Built-in pet is always present, even if an old/corrupt state omits it.
-- Default pet falls back to built-in pet if missing/invalid.
-- Canonical built-in pet metadata wins over state file metadata.
+- Built-in familiar is always present, even if an old/corrupt state omits it.
+- Default familiar falls back to built-in familiar if missing/invalid.
+- Canonical built-in familiar metadata wins over state file metadata.
 - Protected/built-in flags cannot be disabled by a user-edited/corrupt state file.
 - `petScale` remains `1` in Phase 03 unless later implemented.
 - Position should continue to use safe Phase 02 clamping rules.
@@ -157,24 +157,24 @@ Avoid split-brain state where different modules write unrelated JSON shapes to t
 
 Recommended ownership:
 
-- `app-state.ts` owns reading/writing `openpets-state.json`.
+- `app-state.ts` owns reading/writing `familiaros-state.json`.
 - Controllers request state updates through narrow functions.
 - State is loaded only after `app.whenReady()`.
 - No app state reads happen at module import time.
-- `pet-state.ts` should be removed or changed to delegate to `app-state.ts`.
-- No module other than `app-state.ts` writes directly to `openpets-state.json`.
+- `familiar-state.ts` should be removed or changed to delegate to `app-state.ts`.
+- No module other than `app-state.ts` writes directly to `familiaros-state.json`.
 - All state updates are read/modify/write against one in-memory normalized state object.
-- State updates should be serialized in-process to avoid debounced pet-position saves clobbering Settings updates.
+- State updates should be serialized in-process to avoid debounced familiar-position saves clobbering Settings updates.
 
 Recommended `app-state.ts` API shape:
 
 ```ts
 initializeAppState(): void
-getAppStateSnapshot(): OpenPetsStateV1
-updatePreferences(patch: Partial<OpenPetsStateV1["preferences"]>): OpenPetsStateV1
-setDefaultPet(defaultPetId: string): OpenPetsStateV1
-setDefaultPetPosition(position: { x: number; y: number }): OpenPetsStateV1
-resetDefaultPetPosition(): OpenPetsStateV1
+getAppStateSnapshot(): FamiliarOSStateV1
+updatePreferences(patch: Partial<FamiliarOSStateV1["preferences"]>): FamiliarOSStateV1
+setDefaultPet(defaultPetId: string): FamiliarOSStateV1
+setDefaultPetPosition(position: { x: number; y: number }): FamiliarOSStateV1
+resetDefaultPetPosition(): FamiliarOSStateV1
 ```
 
 The API can differ if implementation finds a simpler shape, but the ownership rules must remain.
@@ -182,12 +182,12 @@ The API can differ if implementation finds a simpler shape, but the ownership ru
 Startup ordering:
 
 1. `app.whenReady()` resolves.
-2. `app.setName("OpenPets")` runs.
+2. `app.setName("FamiliarOS")` runs.
 3. App state is loaded/normalized through `initializeAppState()`.
 4. Tray is created.
 5. Display/lifecycle handlers are installed.
-6. Default pet is shown only if `openDefaultPetOnLaunch` is true.
-7. Tray menu is refreshed so labels match actual pet visibility.
+6. Default familiar is shown only if `openDefaultPetOnLaunch` is true.
+7. Tray menu is refreshed so labels match actual familiar visibility.
 
 Migration rule:
 
@@ -196,33 +196,33 @@ Migration rule:
 - The migrated V1 state must preserve valid `defaultPet.position`.
 - Unknown/corrupt state should not crash the app.
 
-### Built-in pet model
+### Built-in familiar model
 
-Define one bundled built-in pet record in code.
+Define one bundled built-in familiar record in code.
 
 Recommended values:
 
 ```ts
 id: "builtin"
-displayName: "Built-in Pet"
+displayName: "Built-in Familiar"
 builtIn: true
 protected: true
 ```
 
-This is a local app-state pet record, not the final downloadable pet manifest contract.
+This is a local app-state familiar record, not the final downloadable familiar manifest contract.
 
-### Pet Manager basics
+### Familiar Manager basics
 
-Upgrade the Pet Manager placeholder into a minimal real local view.
+Upgrade the Familiar Manager placeholder into a minimal real local view.
 
 Recommended UI content:
 
-- Title: `Pet Manager`.
-- Installed pets section.
-- Built-in pet card/row.
+- Title: `Familiar Manager`.
+- Installed familiars section.
+- Built-in familiar card/row.
 - Badges: `Built-in`, `Installed`, `Default`, `Protected`.
-- Disabled remove action for built-in pet.
-- `Set Default` action for installed pets that are not default.
+- Disabled remove action for built-in familiar.
+- `Set Default` action for installed familiars that are not default.
 - Empty/loading/catalog messaging should clearly say catalog browsing arrives in a later phase.
 
 Phase 03 does not need a polished catalog grid. It only needs to prove local installed/default state.
@@ -233,23 +233,23 @@ Upgrade the Settings placeholder into a minimal real preferences view.
 
 Initial settings:
 
-- `Open default pet on app launch` toggle.
+- `Open default familiar on app launch` toggle.
 - `Speech bubbles enabled` toggle.
-- `Pet scale` visible disabled/deferred row or omitted from UI; do not implement scaling controls in Phase 03.
-- `Reset default pet position` button.
+- `Familiar scale` visible disabled/deferred row or omitted from UI; do not implement scaling controls in Phase 03.
+- `Reset default familiar position` button.
 
 Settings behavior:
 
 - Changes persist to local state.
-- Toggling `Open default pet on app launch` affects next app launch, not necessarily the current pet visibility.
-- Reset position should move the visible default pet back to bottom-right immediately if visible and update persisted state.
-- If the pet is hidden, reset position updates persisted state; the next show/restart uses the reset position.
-- If the pet window has not been created because `openDefaultPetOnLaunch` is disabled, reset position updates persisted state only.
+- Toggling `Open default familiar on app launch` affects next app launch, not necessarily the current familiar visibility.
+- Reset position should move the visible default familiar back to bottom-right immediately if visible and update persisted state.
+- If the familiar is hidden, reset position updates persisted state; the next show/restart uses the reset position.
+- If the familiar window has not been created because `openDefaultPetOnLaunch` is disabled, reset position updates persisted state only.
 - Speech setting persists but has no visible speech behavior yet.
 
 ### Internal renderer interaction
 
-If Pet Manager/Settings need clickable controls, use safe internal Electron IPC/preload only for those task windows.
+If Familiar Manager/Settings need clickable controls, use safe internal Electron IPC/preload only for those task windows.
 
 Important distinction:
 
@@ -269,13 +269,13 @@ Required preload/security behavior if used:
 Recommended preload/API contract:
 
 ```ts
-window.openPets.getState(): Promise<OpenPetsStateV1>
+window.openPets.getState(): Promise<FamiliarOSStateV1>
 window.openPets.updatePreferences(patch: {
   openDefaultPetOnLaunch?: boolean;
   speechBubblesEnabled?: boolean;
-}): Promise<OpenPetsStateV1>
-window.openPets.setDefaultPet(petId: string): Promise<OpenPetsStateV1>
-window.openPets.resetDefaultPetPosition(): Promise<OpenPetsStateV1>
+}): Promise<FamiliarOSStateV1>
+window.openPets.setDefaultPet(petId: string): Promise<FamiliarOSStateV1>
+window.openPets.resetDefaultPetPosition(): Promise<FamiliarOSStateV1>
 ```
 
 Rules:
@@ -283,7 +283,7 @@ Rules:
 - Do not expose a generic `invoke(action, payload)` API.
 - Do not expose filesystem/shell/Electron access.
 - Validate booleans as booleans.
-- Validate `petId` as a known installed pet id before setting default.
+- Validate `petId` as a known installed familiar id before setting default.
 - Validate that reset-position requests come from Settings.
 - Renderer should query latest state when opened/focused and after mutations.
 - Avoid `webContents.executeJavaScript` as a state/control channel.
@@ -294,7 +294,7 @@ If a simpler approach can keep views read-only and use tray/menu actions for sta
 
 Do not introduce React/Vue/Vite yet.
 
-Use generated local HTML for Pet Manager and Settings, similar to prior phases, unless implementation complexity becomes unreasonable.
+Use generated local HTML for Familiar Manager and Settings, similar to prior phases, unless implementation complexity becomes unreasonable.
 
 Renderer content should:
 
@@ -319,11 +319,11 @@ Mitigation:
 
 ### Risk: overbuilding UI before real catalog
 
-Pet Manager could become a dashboard or fake catalog.
+Familiar Manager could become a dashboard or fake catalog.
 
 Mitigation:
 
-- Only show installed local pets in Phase 03.
+- Only show installed local familiars in Phase 03.
 - Clearly label catalog browsing as a later phase.
 - Do not add search/categories/catalog fetch yet.
 
@@ -360,10 +360,10 @@ Security/privacy expectations:
 - No remote content.
 - No coding-agent config edits.
 - No shell command execution.
-- No pet zip extraction.
+- No familiar zip extraction.
 - App writes only its own local state file under `app.getPath("userData")`.
 - Renderer IPC, if used, is narrow and validated.
-- Built-in pet cannot be removed through UI or state corruption.
+- Built-in familiar cannot be removed through UI or state corruption.
 - State files are treated as untrusted input.
 - State-derived renderer content is escaped.
 
@@ -380,7 +380,7 @@ pnpm build
 Manual app run command:
 
 ```bash
-pnpm --filter @open-pets/desktop dev
+pnpm --filter @familiaros/desktop dev
 ```
 
 Expected automated result:
@@ -396,30 +396,30 @@ After implementation, the user should verify:
 1. Start the desktop app:
 
    ```bash
-   pnpm --filter @open-pets/desktop dev
+   pnpm --filter @familiaros/desktop dev
    ```
 
-2. Confirm tray and default pet still appear.
-3. Open `Manage Pets...`.
-4. Confirm the built-in pet is shown as installed/default/protected.
-5. Confirm built-in pet cannot be removed.
-6. Confirm setting built-in pet as default is disabled/no-op because it is already default.
+2. Confirm tray and default familiar still appear.
+3. Open `Manage Familiars...`.
+4. Confirm the built-in familiar is shown as installed/default/protected.
+5. Confirm built-in familiar cannot be removed.
+6. Confirm setting built-in familiar as default is disabled/no-op because it is already default.
 7. Open `Settings...`.
 8. Toggle `Speech bubbles enabled`, quit, restart, and confirm the setting persisted.
-9. Toggle `Open default pet on app launch` off, quit, restart, and confirm the default pet does not appear automatically.
-10. Use tray `Show Default Pet` and confirm the default pet can still be shown manually.
-11. Toggle `Open default pet on app launch` back on, quit, restart, and confirm the default pet appears automatically again.
-12. Drag the pet to a new position, quit, restart, and confirm position still persists.
-13. Use `Reset default pet position` and confirm the pet moves back near bottom-right and persists there after restart.
+9. Toggle `Open default familiar on app launch` off, quit, restart, and confirm the default familiar does not appear automatically.
+10. Use tray `Show Default Familiar` and confirm the default familiar can still be shown manually.
+11. Toggle `Open default familiar on app launch` back on, quit, restart, and confirm the default familiar appears automatically again.
+12. Drag the familiar to a new position, quit, restart, and confirm position still persists.
+13. Use `Reset default familiar position` and confirm the familiar moves back near bottom-right and persists there after restart.
 14. If a Phase 02 unversioned state file exists, confirm position is preserved after Phase 03 migration.
-15. If practical, temporarily corrupt `openpets-state.json`, restart, and confirm app falls back safely with built-in pet/default preferences.
+15. If practical, temporarily corrupt `familiaros-state.json`, restart, and confirm app falls back safely with built-in familiar/default preferences.
 16. Confirm placeholder/real task windows still do not quit the app when closed.
-17. Quit OpenPets and confirm clean exit.
+17. Quit FamiliarOS and confirm clean exit.
 
 Manual acceptance question:
 
 ```text
-Does Phase 03 pass on your machine: Pet Manager shows built-in pet state, Settings preferences persist, open-on-launch works, reset position works, and Phase 02 pet behavior still works?
+Does Phase 03 pass on your machine: Familiar Manager shows built-in familiar state, Settings preferences persist, open-on-launch works, reset position works, and Phase 02 familiar behavior still works?
 ```
 
 ## Oracle plan review
@@ -429,30 +429,30 @@ Oracle reviewed the initial Phase 03 spec and blocked implementation until state
 Summary of required Oracle feedback:
 
 - Make Phase 02 state migration mandatory.
-- Retire or delegate `pet-state.ts` so there is one state-file writer.
+- Retire or delegate `familiar-state.ts` so there is one state-file writer.
 - Add V0/unversioned state migration preserving position.
 - Define startup ordering and open-on-launch gating.
 - Define app-state API and whole-state write semantics.
 - Define preload/API contract and validation rules.
 - Require escaping state-derived renderer content.
 - Require windows to render/query latest state after mutations.
-- Defer visible pet scale controls.
-- Define reset-position behavior for visible, hidden, and not-created pet states.
+- Defer visible familiar scale controls.
+- Define reset-position behavior for visible, hidden, and not-created familiar states.
 - Add manual verification for corrupted state and V0 migration.
 
 ## Oracle feedback disposition
 
 - Fixed: Made Phase 02 position migration into `app-state.ts` mandatory.
-- Fixed: Required `app-state.ts` to be the only owner/writer of `openpets-state.json`.
+- Fixed: Required `app-state.ts` to be the only owner/writer of `familiaros-state.json`.
 - Fixed: Added V0/unversioned migration preserving `defaultPet.position`.
-- Fixed: Added startup ordering with `initializeAppState()` before tray/show-default-pet logic.
+- Fixed: Added startup ordering with `initializeAppState()` before tray/show-default-familiar logic.
 - Fixed: Added recommended app-state API and whole-state update semantics.
 - Fixed: Added concrete preload/API contract and validation rules.
 - Fixed: Required sender validation for internal renderer IPC.
 - Fixed: Required escaping all state-derived renderer content.
 - Fixed: Required renderer state refresh after mutations.
-- Fixed: Deferred visible pet scale controls; `petScale` remains inert default state only.
-- Fixed: Defined reset-position behavior for visible, hidden, and not-yet-created pet states.
+- Fixed: Deferred visible familiar scale controls; `petScale` remains inert default state only.
+- Fixed: Defined reset-position behavior for visible, hidden, and not-yet-created familiar states.
 - Fixed: Added manual verification for V0 migration and corrupt-state fallback.
 
 ## Oracle implementation review
@@ -467,10 +467,10 @@ Oracle found no blocking correctness, security, state migration, or scope issues
 
 Implementation review disposition:
 
-- Approved: Versioned app state and V0 migration preserve Phase 02 pet position.
-- Approved: `pet-state.ts` was removed and `app-state.ts` owns `openpets-state.json`.
+- Approved: Versioned app state and V0 migration preserve Phase 02 familiar position.
+- Approved: `familiar-state.ts` was removed and `app-state.ts` owns `familiaros-state.json`.
 - Approved: Open-on-launch gating and reset-position behavior are implemented.
-- Approved: Pet Manager and Settings use narrow internal Electron IPC with sender and payload validation.
+- Approved: Familiar Manager and Settings use narrow internal Electron IPC with sender and payload validation.
 - Approved: Generated UI uses DOM/text rendering for state-derived values instead of HTML injection.
 - Fixed optional: Added `node --check preload.cjs` to the desktop `check` script so the plain JS preload gets syntax validation.
 
@@ -478,4 +478,4 @@ Deferred optional improvements:
 
 - Back up corrupt JSON before overwriting with normalized defaults.
 - Add pure tests for state normalization/migration once a test framework exists.
-- Derive tray default-pet label from app state when multiple real pets exist.
+- Derive tray default-familiar label from app state when multiple real familiars exist.
diff --git a/docs/phases/phase-04-v2-pet-catalog-installation.md b/docs/phases/phase-04-v2-pet-catalog-installation.md
index ca82749c..b02d9420 100644
--- a/docs/phases/phase-04-v2-pet-catalog-installation.md
+++ b/docs/phases/phase-04-v2-pet-catalog-installation.md
@@ -1,4 +1,4 @@
-# Phase 04: V2 pet catalog and installation
+# Phase 04: V2 familiar catalog and installation
 
 Status: superseded by split phases after Oracle review.
 
@@ -6,24 +6,24 @@ Oracle blocked this combined phase because the v2 catalog endpoint is not availa
 
 Split replacement:
 
-- `phase-04a-v2-catalog-read-only.md` — v2 catalog contract/generation/fetch validation and read-only searchable Pet Manager UI.
-- `phase-04b-safe-pet-installation.md` — safe zip install/remove/default switching/local rendering.
+- `phase-04a-v2-catalog-read-only.md` — v2 catalog contract/generation/fetch validation and read-only searchable Familiar Manager UI.
+- `phase-04b-safe-familiar-installation.md` — safe zip install/remove/default switching/local rendering.
 
 ## Goal
 
-Make Pet Manager browse the remote v2 pet catalog and install/remove real downloaded pets locally, while keeping the built-in pet as protected fallback.
+Make Familiar Manager browse the remote v2 familiar catalog and install/remove real downloaded familiars locally, while keeping the built-in familiar as protected fallback.
 
-This phase should prove the core pet ownership loop:
+This phase should prove the core familiar ownership loop:
 
 ```text
-Fetch catalog → browse/search pets → install pet zip safely → show installed state → set default → remove removable pets
+Fetch catalog → browse/search familiars → install familiar zip safely → show installed state → set default → remove removable familiars
 ```
 
 ## Non-goals
 
 This phase does not implement:
 
-- Pet update system.
+- Familiar update system.
 - Categories/tags/favorites/ratings/popularity UI.
 - Advanced sorting.
 - CLI install commands.
@@ -32,47 +32,47 @@ This phase does not implement:
 - Speech bubbles.
 - First-run onboarding.
 - Production packaging.
-- Full animation/physics engine beyond rendering installed pet enough to verify default switching.
+- Full animation/physics engine beyond rendering installed familiar enough to verify default switching.
 
 ## User-visible/manual outcome
 
 After this phase, the user/developer should be able to run the app and confirm:
 
 ```text
-Pet Manager fetches the v2 catalog, shows available pets, installs a pet, lets the user set it as default, persists it across restart, and can remove removable installed pets.
+Familiar Manager fetches the v2 catalog, shows available familiars, installs a familiar, lets the user set it as default, persists it across restart, and can remove removable installed familiars.
 ```
 
-If the catalog cannot be fetched, OpenPets should remain usable with the built-in pet and already-installed pets.
+If the catalog cannot be fetched, FamiliarOS should remain usable with the built-in familiar and already-installed familiars.
 
 ## Acceptance criteria
 
-- Existing tray, default pet, Pet Manager, and Settings behavior continue to work.
-- Pet Manager fetches catalog from:
+- Existing tray, default familiar, Familiar Manager, and Settings behavior continue to work.
+- Familiar Manager fetches catalog from:
 
   ```text
-  https://openpets.dev/pets/catalog.v2.json
+  https://familiaros.dev/familiars/catalog.v2.json
   ```
 
 - Catalog fetch has loading and error states.
-- Catalog fetch failure does not break built-in pet behavior.
+- Catalog fetch failure does not break built-in familiar behavior.
 - Catalog data is validated before use.
-- Pet Manager shows catalog pets in a simple searchable list/grid.
-- Pet Manager shows installed/default/protected states.
-- User can install a catalog pet from its `zip` URL.
+- Familiar Manager shows catalog familiars in a simple searchable list/grid.
+- Familiar Manager shows installed/default/protected states.
+- User can install a catalog familiar from its `zip` URL.
 - Downloaded zip is validated before extraction/install.
 - Zip install prevents zip-slip/path traversal.
 - Zip install has size and file-count limits.
-- Zip install never executes scripts from downloaded pets.
+- Zip install never executes scripts from downloaded familiars.
 - Failed installs clean up partial files.
-- Installed pets are stored locally under OpenPets user data.
-- Installed pet metadata is persisted in app state.
-- User can set an installed non-built-in pet as default.
-- Default pet window reflects the selected default pet after setting default.
-- Default pet selection persists across restart.
-- User can remove removable installed pets.
-- Built-in pet cannot be removed.
-- Removing the current default pet falls back to the built-in pet.
-- App remains usable if installed pet files are missing/corrupt; fallback to built-in pet.
+- Installed familiars are stored locally under FamiliarOS user data.
+- Installed familiar metadata is persisted in app state.
+- User can set an installed non-built-in familiar as default.
+- Default familiar window reflects the selected default familiar after setting default.
+- Default familiar selection persists across restart.
+- User can remove removable installed familiars.
+- Built-in familiar cannot be removed.
+- Removing the current default familiar falls back to the built-in familiar.
+- App remains usable if installed familiar files are missing/corrupt; fallback to built-in familiar.
 - Automated checks pass.
 
 ## Proposed files/directories
@@ -81,20 +81,20 @@ Likely update:
 
 ```text
 apps/desktop/src/app-state.ts
-apps/desktop/src/default-pet-controller.ts
-apps/desktop/src/pet-window.ts
+apps/desktop/src/default-familiar-controller.ts
+apps/desktop/src/familiar-window.ts
 apps/desktop/src/windows.ts
 apps/desktop/preload.cjs
 README.md
-packages/pet-format/src/index.ts
+packages/familiar-format/src/index.ts
 ```
 
 Likely add:
 
 ```text
 apps/desktop/src/catalog.ts
-apps/desktop/src/pet-install.ts
-apps/desktop/src/installed-pets.ts
+apps/desktop/src/familiar-install.ts
+apps/desktop/src/installed-familiars.ts
 apps/desktop/src/download.ts
 apps/desktop/src/zip.ts
 ```
@@ -110,7 +110,7 @@ Keep this phase focused on safe catalog/install basics, not marketplace polish.
 Use the agreed v2 catalog URL:
 
 ```text
-https://openpets.dev/pets/catalog.v2.json
+https://familiaros.dev/familiars/catalog.v2.json
 ```
 
 Expected minimal catalog shape:
@@ -119,7 +119,7 @@ Expected minimal catalog shape:
 interface CatalogV2 {
   version: 2;
   generatedAt: string;
-  pets: CatalogPetV2[];
+  familiars: CatalogPetV2[];
 }
 
 interface CatalogPetV2 {
@@ -141,22 +141,22 @@ interface CatalogPetV2 {
 Validation rules:
 
 - `version` must be `2`.
-- `pets` must be an array.
+- `familiars` must be an array.
 - `id`, `displayName`, `description`, `preview`, and `zip` must be strings.
 - `id` must be a safe local identifier, for example `/^[a-z0-9][a-z0-9_-]{0,63}$/`.
 - `zip` and `preview` must be `https:` URLs.
 - `format.type` must be `spritesheet`.
 - Format dimensions/counts must be positive finite integers within safe bounds.
 
-Use `packages/pet-format` for shared catalog/pet types and validation helpers if practical.
+Use `packages/familiar-format` for shared catalog/familiar types and validation helpers if practical.
 
 ### Catalog UI
 
-Pet Manager should show:
+Familiar Manager should show:
 
 - Search input.
-- Installed pets and catalog pets in one simple view or clearly separated sections.
-- Pet name.
+- Installed familiars and catalog familiars in one simple view or clearly separated sections.
+- Familiar name.
 - Short description.
 - Preview image if safe/practical.
 - Badges: `Built-in`, `Installed`, `Default`, `Protected`.
@@ -165,17 +165,17 @@ Pet Manager should show:
 
 Do not add categories/tags/favorites/sorting beyond search.
 
-### Installed pet storage
+### Installed familiar storage
 
-Store installed pets under app user data.
+Store installed familiars under app user data.
 
 Recommended directory:
 
 ```text
-<userData>/pets/<petId>/
+<userData>/familiars/<petId>/
 ```
 
-Installed pet state should include enough metadata to render/manage it later:
+Installed familiar state should include enough metadata to render/manage it later:
 
 ```ts
 interface InstalledPetState {
@@ -195,7 +195,7 @@ interface InstalledPetState {
 }
 ```
 
-The built-in pet remains a code-defined protected pet and does not need localPath.
+The built-in familiar remains a code-defined protected familiar and does not need localPath.
 
 ### Zip download/install safety
 
@@ -212,9 +212,9 @@ Required behavior:
 - Reject paths containing `..` after normalization.
 - Reject entries that would escape the temp install directory.
 - Reject symlinks/hardlinks if zip library exposes them.
-- Never execute files from downloaded pets.
-- Validate required pet files/manifest before finalizing install.
-- Move temp install directory into final `<userData>/pets/<petId>` atomically where practical.
+- Never execute files from downloaded familiars.
+- Validate required familiar files/manifest before finalizing install.
+- Move temp install directory into final `<userData>/familiars/<petId>` atomically where practical.
 - Clean temp directory on failure.
 
 Recommended limits for initial phase:
@@ -225,32 +225,32 @@ max extracted total: 200 MB
 max files: 500
 ```
 
-These can be adjusted by implementation if real catalog pets need different limits, but the final chosen limits must be documented.
+These can be adjusted by implementation if real catalog familiars need different limits, but the final chosen limits must be documented.
 
-### Installed pet validation
+### Installed familiar validation
 
-Initial installed pet validation can be minimal but real.
+Initial installed familiar validation can be minimal but real.
 
 Required:
 
 - Installation directory exists.
 - At least one plausible sprite/preview file exists, or the catalog `preview` was cached successfully.
 - Catalog format metadata is persisted.
-- Pet id/displayName in state match the validated catalog entry.
+- Familiar id/displayName in state match the validated catalog entry.
 
-If the actual zip structure from current catalog is known to contain a manifest, validate that manifest too. Do not invent a complex new manifest requirement if current pets do not have it yet; record the discovered shape in this phase doc after implementation.
+If the actual zip structure from current catalog is known to contain a manifest, validate that manifest too. Do not invent a complex new manifest requirement if current familiars do not have it yet; record the discovered shape in this phase doc after implementation.
 
-### Default pet rendering after install
+### Default familiar rendering after install
 
 Phase 04 does not need final spritesheet animation quality.
 
-But when a user sets an installed pet as default, the default pet window should visibly reflect that choice.
+But when a user sets an installed familiar as default, the default familiar window should visibly reflect that choice.
 
 Acceptable Phase 04 rendering:
 
-- Built-in pet keeps current generated pet rendering.
-- Installed pet default can show cached preview/spritesheet image in the pet window, scaled into the 180x180 pet window.
-- If preview/spritesheet fails, fallback to built-in generated pet and show installed/default state in Pet Manager.
+- Built-in familiar keeps current generated familiar rendering.
+- Installed familiar default can show cached preview/spritesheet image in the familiar window, scaled into the 180x180 familiar window.
+- If preview/spritesheet fails, fallback to built-in generated familiar and show installed/default state in Familiar Manager.
 
 Do not build the full animation-state engine yet unless it is simpler than a static preview.
 
@@ -260,9 +260,9 @@ Extend V1 state conservatively or introduce V2 state if necessary.
 
 Rules:
 
-- Built-in pet must always be present and protected.
-- Installed pet records are normalized on read.
-- Default pet id must point to an installed pet or fallback to built-in.
+- Built-in familiar must always be present and protected.
+- Installed familiar records are normalized on read.
+- Default familiar id must point to an installed familiar or fallback to built-in.
 - Removing current default sets default to built-in.
 - State writes remain owned by `app-state.ts`.
 
@@ -274,16 +274,16 @@ Candidate methods:
 
 ```ts
 getCatalog(): Promise<CatalogUiState>
-installPet(petId: string): Promise<OpenPetsStateV1>
-removePet(petId: string): Promise<OpenPetsStateV1>
-setDefaultPet(petId: string): Promise<OpenPetsStateV1>
+installPet(petId: string): Promise<FamiliarOSStateV1>
+removePet(petId: string): Promise<FamiliarOSStateV1>
+setDefaultPet(petId: string): Promise<FamiliarOSStateV1>
 ```
 
 Rules:
 
 - No generic `invoke(action, payload)`.
 - Validate sender window.
-- Validate pet id.
+- Validate familiar id.
 - Do not expose filesystem/shell/Electron.
 - Render state-derived/catalog-derived strings through DOM text APIs or HTML escaping.
 
@@ -313,15 +313,15 @@ Mitigation:
 - Clean up on failure.
 - Oracle implementation review should focus heavily on install safety.
 
-### Risk: unknown current pet zip structure
+### Risk: unknown current familiar zip structure
 
-Current web/catalog pets may not match a clean v2 manifest structure yet.
+Current web/catalog familiars may not match a clean v2 manifest structure yet.
 
 Mitigation:
 
-- Scout current `web/public/pets` metadata and one real zip before implementation.
+- Scout current `web/public/familiars` metadata and one real zip before implementation.
 - Do not blindly copy v1 assumptions.
-- Keep validation compatible with real available pets while still safe.
+- Keep validation compatible with real available familiars while still safe.
 - Record discovered zip shape in this phase doc after implementation.
 
 ### Risk: remote images/content in Electron UI
@@ -341,15 +341,15 @@ This phase introduces network and untrusted zip handling.
 
 Security/privacy expectations:
 
-- Only fetch the catalog URL and validated `https:` pet assets/zips.
+- Only fetch the catalog URL and validated `https:` familiar assets/zips.
 - No telemetry.
 - No cookies/auth/accounts.
 - No remote HTML content.
-- No script execution from downloaded pets.
+- No script execution from downloaded familiars.
 - No shell command execution.
 - All downloaded zip contents are treated as untrusted.
 - All catalog/download strings rendered in UI are escaped or inserted as text.
-- Pet install writes only under OpenPets user data paths.
+- Familiar install writes only under FamiliarOS user data paths.
 - Fail closed on validation errors.
 
 ## Test/check plan
@@ -365,7 +365,7 @@ pnpm build
 Manual app run command:
 
 ```bash
-pnpm --filter @open-pets/desktop dev
+pnpm --filter @familiaros/desktop dev
 ```
 
 Implementation should add unit-style tests for pure validation/path-safety helpers if a lightweight test approach is practical in this phase. If no test framework is added, document why and rely on manual verification plus Oracle review.
@@ -377,29 +377,29 @@ After implementation, the user should verify:
 1. Start the desktop app:
 
    ```bash
-   pnpm --filter @open-pets/desktop dev
+   pnpm --filter @familiaros/desktop dev
    ```
 
-2. Open `Manage Pets...`.
-3. Confirm built-in pet still appears as installed/default/protected.
-4. Confirm catalog loading state appears, then catalog pets appear.
-5. Search for a pet by name and confirm filtering works.
-6. Install one real catalog pet.
+2. Open `Manage Familiars...`.
+3. Confirm built-in familiar still appears as installed/default/protected.
+4. Confirm catalog loading state appears, then catalog familiars appear.
+5. Search for a familiar by name and confirm filtering works.
+6. Install one real catalog familiar.
 7. Confirm it appears as installed.
-8. Set the installed pet as default.
-9. Confirm the default pet window visibly changes or shows that pet's preview.
-10. Quit and restart; confirm installed pet and default selection persist.
-11. Remove the installed pet.
-12. Confirm default falls back to built-in if removed pet was default.
-13. Confirm built-in pet still cannot be removed.
-14. Temporarily disconnect network or block catalog fetch and confirm the app remains usable with installed/built-in pets.
+8. Set the installed familiar as default.
+9. Confirm the default familiar window visibly changes or shows that familiar's preview.
+10. Quit and restart; confirm installed familiar and default selection persist.
+11. Remove the installed familiar.
+12. Confirm default falls back to built-in if removed familiar was default.
+13. Confirm built-in familiar still cannot be removed.
+14. Temporarily disconnect network or block catalog fetch and confirm the app remains usable with installed/built-in familiars.
 15. Confirm Settings and Phase 03 preferences still work.
-16. Quit OpenPets and confirm clean exit.
+16. Quit FamiliarOS and confirm clean exit.
 
 Manual acceptance question:
 
 ```text
-Does Phase 04 pass on your machine: catalog loads, search works, a pet installs safely, default switching persists, removal works, and built-in fallback remains reliable?
+Does Phase 04 pass on your machine: catalog loads, search works, a familiar installs safely, default switching persists, removal works, and built-in fallback remains reliable?
 ```
 
 ## Oracle plan review
diff --git a/docs/phases/phase-04a-v2-catalog-read-only.md b/docs/phases/phase-04a-v2-catalog-read-only.md
index faf4c06d..c886fbad 100644
--- a/docs/phases/phase-04a-v2-catalog-read-only.md
+++ b/docs/phases/phase-04a-v2-catalog-read-only.md
@@ -1,17 +1,17 @@
-# Phase 04A: V2 catalog contract and read-only Pet Manager catalog
+# Phase 04A: V2 catalog contract and read-only Familiar Manager catalog
 
 ## Goal
 
-Establish the v2 pet catalog contract and make Pet Manager fetch, validate, cache, search, and display the catalog in read-only mode.
+Establish the v2 familiar catalog contract and make Familiar Manager fetch, validate, cache, search, and display the catalog in read-only mode.
 
-This phase does **not** install pets yet. It prepares the catalog foundation safely before the security-critical zip install phase.
+This phase does **not** install familiars yet. It prepares the catalog foundation safely before the security-critical zip install phase.
 
 ## Non-goals
 
-- Downloading/installing pet zips.
-- Removing downloaded pets.
-- Setting downloaded pets as default.
-- Rendering downloaded pet sprites in the default pet window.
+- Downloading/installing familiar zips.
+- Removing downloaded familiars.
+- Setting downloaded familiars as default.
+- Rendering downloaded familiar sprites in the default familiar window.
 - CLI/MCP/Claude/onboarding/packaging.
 - Categories/tags/favorites/ratings/popularity UI.
 
@@ -20,48 +20,48 @@ This phase does **not** install pets yet. It prepares the catalog foundation saf
 After this phase:
 
 ```text
-Pet Manager shows the built-in installed pet and a searchable read-only catalog of available pets from the v2 catalog contract.
+Familiar Manager shows the built-in installed familiar and a searchable read-only catalog of available familiars from the v2 catalog contract.
 ```
 
-If catalog fetch fails, Pet Manager still works for installed/built-in pets and shows a clear catalog error.
+If catalog fetch fails, Familiar Manager still works for installed/built-in familiars and shows a clear catalog error.
 
 ## Blocking context from Oracle
 
 Oracle found that the target URL is currently not available:
 
 ```text
-https://openpets.dev/pets/catalog.v2.json
+https://familiaros.dev/familiars/catalog.v2.json
 ```
 
 Phase 04A must therefore include making a real v2 catalog artifact available in the repository/deploy path, or explicitly add a temporary development fallback while the production endpoint is being deployed.
 
 Updated decision for Phase 04A:
 
-- Also create the real web artifact at `web/public/pets/catalog.v2.json` now that updating `web/` is explicitly approved.
-- Update `web/scripts/sync-pets.js` so future `sync:pets` runs regenerate `catalog.v2.json`.
+- Also create the real web artifact at `web/public/familiars/catalog.v2.json` now that updating `web/` is explicitly approved.
+- Update `web/scripts/sync-familiars.js` so future `sync:familiars` runs regenerate `catalog.v2.json`.
 - Create a tracked v2-shaped development fixture under the tracked v2 workspace.
 - Desktop app attempts the final production URL first.
 - If production URL is unavailable, desktop app falls back only to the tracked v2-shaped fixture.
-- Production deployment of `web/public/pets/catalog.v2.json` can be tested after the web app is redeployed.
+- Production deployment of `web/public/familiars/catalog.v2.json` can be tested after the web app is redeployed.
 - Because `web/` is root-ignored, any required web files must be force-added intentionally when committing from the root repo.
 
 ## Acceptance criteria
 
-- Existing tray/default pet/Pet Manager/Settings behavior continues to work.
+- Existing tray/default familiar/Familiar Manager/Settings behavior continues to work.
 - A v2 catalog contract is defined in code with validation helpers.
-- The v2 catalog artifact shape is based on real current pet metadata, not invented fields.
+- The v2 catalog artifact shape is based on real current familiar metadata, not invented fields.
 - A deterministic tracked v2 catalog fixture exists for local development and manual verification.
-- The real web v2 catalog artifact exists at `web/public/pets/catalog.v2.json`.
-- `web/scripts/sync-pets.js` regenerates the v2 catalog artifact.
+- The real web v2 catalog artifact exists at `web/public/familiars/catalog.v2.json`.
+- `web/scripts/sync-familiars.js` regenerates the v2 catalog artifact.
 - The tracked fixture is v2-shaped; no silent v1 `install.json` fallback is allowed.
 - Web changes are intentionally included despite `web/` being root-ignored.
 - Desktop catalog fetch validates data before use.
 - Catalog fetch has loading, success, and error states.
-- Catalog fetch failure does not break built-in pet behavior.
-- Pet Manager shows installed local pets plus read-only catalog entries.
-- Pet Manager search filters catalog pets by display name/description/id.
+- Catalog fetch failure does not break built-in familiar behavior.
+- Familiar Manager shows installed local familiars plus read-only catalog entries.
+- Familiar Manager search filters catalog familiars by display name/description/id.
 - Catalog entries show `Install coming in Phase 04B` or disabled install actions.
-- Pet Manager does not fetch remote HTML.
+- Familiar Manager does not fetch remote HTML.
 - Remote preview rendering is safe or deferred. If preview rendering is included, images are fetched/validated by main process or constrained to safe image-only rendering.
 - Automated checks pass.
 
@@ -73,7 +73,7 @@ The Phase 04A canonical v2 catalog shape is:
 interface CatalogV2 {
   version: 2;
   generatedAt: string;
-  pets: CatalogPetV2[];
+  familiars: CatalogPetV2[];
 }
 
 interface CatalogPetV2 {
@@ -85,22 +85,22 @@ interface CatalogPetV2 {
 }
 ```
 
-Do not require spritesheet `format` fields in Phase 04A unless the catalog generator can derive them from real current pet data.
+Do not require spritesheet `format` fields in Phase 04A unless the catalog generator can derive them from real current familiar data.
 
 Validation rules:
 
 - `version` is `2`.
 - `generatedAt` is a string.
-- `pets` is an array.
+- `familiars` is an array.
 - `id` matches `/^[a-z0-9][a-z0-9_-]{0,63}$/`.
-- `id` must not be `builtin`; `builtin` is reserved for the protected bundled pet.
+- `id` must not be `builtin`; `builtin` is reserved for the protected bundled familiar.
 - Duplicate ids are rejected.
 - `displayName`, `description`, `preview`, and `zip` are strings.
 - `preview` and `zip` are `https:` URLs.
 - Allowed hostnames are explicit and documented. Initial expected hosts:
-  - `openpets.dev`
-  - `zip.openpets.dev`
-- Maximum pets: 1000.
+  - `familiaros.dev`
+  - `zip.familiaros.dev`
+- Maximum familiars: 1000.
 - Maximum `id` length: 64.
 - Maximum `displayName` length: 120.
 - Maximum `description` length: 500.
@@ -108,29 +108,29 @@ Validation rules:
 - `generatedAt` must parse as a valid date.
 - URL credentials are rejected.
 - URLs with non-default ports are rejected.
-- Catalog URL is exactly `https://openpets.dev/pets/catalog.v2.json`.
-- `preview` URLs must use host `openpets.dev` and path under `/pets/`.
-- `zip` URLs must use host `zip.openpets.dev` and path under `/pets/`, even though zips are not downloaded in Phase 04A.
+- Catalog URL is exactly `https://familiaros.dev/familiars/catalog.v2.json`.
+- `preview` URLs must use host `familiaros.dev` and path under `/familiars/`.
+- `zip` URLs must use host `zip.familiaros.dev` and path under `/familiars/`, even though zips are not downloaded in Phase 04A.
 
 Mapping from current web metadata to v2:
 
 - v2 `id` = existing `installId`.
 - v2 `displayName` = existing `displayName`.
 - v2 `description` = existing `description` if present, otherwise `""`.
-- v2 `preview` = absolute `https://openpets.dev` URL from existing `spritesheetPath`.
+- v2 `preview` = absolute `https://familiaros.dev` URL from existing `spritesheetPath`.
 - v2 `zip` = absolute zip URL from existing `zipPath`.
 
-`builtin` is reserved and rejected as a catalog pet id.
+`builtin` is reserved and rejected as a catalog familiar id.
 
 ## Current metadata source
 
 Existing useful web files:
 
 ```text
-web/public/pets/manifest.json
-web/public/pets/install.json
-web/app/lib/pets.generated.js
-web/scripts/sync-pets.js
+web/public/familiars/manifest.json
+web/public/familiars/install.json
+web/app/lib/familiars.generated.js
+web/scripts/sync-familiars.js
 ```
 
 Phase 04A should scout these before implementation and create both:
@@ -147,14 +147,14 @@ apps/desktop/catalog.v2.fixture.json
 Production artifact:
 
 ```text
-web/public/pets/catalog.v2.json
+web/public/familiars/catalog.v2.json
 ```
 
 Because `web/` is currently ignored by root `.gitignore` and outside the v2 pnpm workspace, web changes must be added intentionally with force-add from the root repo if committing them there.
 
 ## Desktop catalog service
 
-Add a small catalog service in the desktop app or `packages/pet-format`:
+Add a small catalog service in the desktop app or `packages/familiar-format`:
 
 - Fetch catalog from the target URL.
 - Validate response shape.
@@ -162,16 +162,16 @@ Add a small catalog service in the desktop app or `packages/pet-format`:
 - Add and track the v2 fixture at `apps/desktop/catalog.v2.fixture.json` during implementation.
 - On fetch failure, load the tracked v2 fixture as a development fallback.
 - Defer cache file behavior to a later phase unless implementation discovers it is trivial and safe.
-- Do not store catalog cache in `openpets-state.json` in Phase 04A.
+- Do not store catalog cache in `familiaros-state.json` in Phase 04A.
 - Return UI state that clearly distinguishes live catalog, fixture fallback, cached catalog, and error.
 
 Do not cache unvalidated catalog data.
 
 Phase 04A catalog source precedence:
 
-1. Remote live catalog from `https://openpets.dev/pets/catalog.v2.json`.
+1. Remote live catalog from `https://familiaros.dev/familiars/catalog.v2.json`.
 2. If remote fetch/validation fails, validated tracked fixture at `apps/desktop/catalog.v2.fixture.json`.
-3. If fixture validation also fails, show catalog error while keeping installed/built-in pets usable.
+3. If fixture validation also fails, show catalog error while keeping installed/built-in familiars usable.
 
 Do not use v1 `install.json` or `manifest.json` as runtime fallback in the desktop app.
 
@@ -184,17 +184,17 @@ Fetch requirements:
 - Allowed hosts only.
 - No cookies/auth.
 
-## Pet Manager read-only UI
+## Familiar Manager read-only UI
 
-Pet Manager should show:
+Familiar Manager should show:
 
-- Installed pets section, including built-in protected pet.
+- Installed familiars section, including built-in protected familiar.
 - Catalog section.
 - Search input.
 - Catalog loading state.
 - Catalog error state.
 - Catalog empty state.
-- Disabled `Install` button/label for catalog pets: `Install in next phase`.
+- Disabled `Install` button/label for catalog familiars: `Install in next phase`.
 
 Preview policy for Phase 04A:
 
@@ -203,7 +203,7 @@ Preview policy for Phase 04A:
 - If preview rendering is added, it must be main-process fetched/validated/cached and rendered as `data:` with `img-src data:` CSP.
 - Renderer must not directly fetch arbitrary remote previews.
 
-Do not implement install/remove/default switching for remote catalog pets in Phase 04A.
+Do not implement install/remove/default switching for remote catalog familiars in Phase 04A.
 
 ## Security/privacy notes
 
@@ -248,22 +248,22 @@ At minimum, the check should validate:
 1. Run:
 
    ```bash
-   pnpm --filter @open-pets/desktop dev
+   pnpm --filter @familiaros/desktop dev
    ```
 
-2. Open `Manage Pets...`.
-3. Confirm built-in pet still appears as installed/default/protected.
+2. Open `Manage Familiars...`.
+3. Confirm built-in familiar still appears as installed/default/protected.
 4. Confirm catalog loading state appears.
-5. Confirm catalog pets appear if the catalog source is reachable.
-6. Search by pet name and confirm filtering works.
-7. Confirm catalog pet install buttons/actions are disabled/read-only for Phase 04A.
-8. Simulate catalog failure if practical and confirm built-in/installed pets still work with a clear error.
-9. Confirm Settings and default pet behavior from Phase 03 still work.
+5. Confirm catalog familiars appear if the catalog source is reachable.
+6. Search by familiar name and confirm filtering works.
+7. Confirm catalog familiar install buttons/actions are disabled/read-only for Phase 04A.
+8. Simulate catalog failure if practical and confirm built-in/installed familiars still work with a clear error.
+9. Confirm Settings and default familiar behavior from Phase 03 still work.
 
 Manual acceptance question:
 
 ```text
-Does Phase 04A pass on your machine: Pet Manager shows a validated searchable read-only catalog, handles catalog failure, and preserves built-in/default pet behavior?
+Does Phase 04A pass on your machine: Familiar Manager shows a validated searchable read-only catalog, handles catalog failure, and preserves built-in/default familiar behavior?
 ```
 
 ## Oracle plan review
@@ -279,7 +279,7 @@ Summary of required Oracle feedback:
 - Add validation bounds and exact host/protocol rules.
 - Ensure catalog fetch is main-process-only with timeout/byte limits/redirect/final URL validation.
 - Decide preview policy; recommended text-only/defer previews.
-- Use a separate validated catalog cache file, not `openpets-state.json`.
+- Use a separate validated catalog cache file, not `familiaros-state.json`.
 - Make catalog validation checks mandatory under `pnpm check`.
 - Do not rely on ignored untracked `web/` files.
 
@@ -287,11 +287,11 @@ Summary of required Oracle feedback:
 
 - Fixed: Chose a tracked development fixture at `apps/desktop/catalog.v2.fixture.json`.
 - Fixed: Desktop attempts production URL first and falls back only to v2-shaped fixture if unavailable.
-- Fixed: Production `web/public/pets/catalog.v2.json` deployment is documented as separate unless explicitly approved.
+- Fixed: Production `web/public/familiars/catalog.v2.json` deployment is documented as separate unless explicitly approved.
 - Fixed: Defined v2 `id = installId` mapping from current web metadata.
 - Fixed: Made the Phase 04A v2 schema canonical.
 - Fixed: Disallowed silent v1 fallback.
-- Fixed: Added max pets/string/URL bounds, `generatedAt` validation, credential/port rejection, and explicit allowed hosts.
+- Fixed: Added max familiars/string/URL bounds, `generatedAt` validation, credential/port rejection, and explicit allowed hosts.
 - Fixed: Required main-process fetch with timeout, byte limit, redirect/final URL validation.
 - Fixed: Deferred preview rendering by default; renderer does not fetch remote previews.
 - Fixed: Required separate validated catalog cache if caching is implemented.
@@ -299,7 +299,7 @@ Summary of required Oracle feedback:
 - Fixed: Clarified implementation must add and track `apps/desktop/catalog.v2.fixture.json`.
 - Fixed: Clarified source precedence: remote live catalog, then validated fixture, then error.
 - Fixed: Clarified field-specific URL rules for catalog, preview, and zip URLs.
-- Updated: User approved updating `web/`, so Phase 04A now also creates `web/public/pets/catalog.v2.json` and updates `web/scripts/sync-pets.js`.
+- Updated: User approved updating `web/`, so Phase 04A now also creates `web/public/familiars/catalog.v2.json` and updates `web/scripts/sync-familiars.js`.
 
 ## Oracle implementation review
 
@@ -325,9 +325,9 @@ Implementation review disposition:
 
 After the user approved updating and redeploying `web/`, the implementation was extended to create the real production web catalog artifact:
 
-- `web/scripts/sync-pets.js` now writes `catalog.v2.json`.
-- `web/public/pets/catalog.v2.json` was generated from current web pet metadata.
-- `https://openpets.dev/pets/catalog.v2.json` was deployed and verified to return `200 application/json` with `version: 2`.
+- `web/scripts/sync-familiars.js` now writes `catalog.v2.json`.
+- `web/public/familiars/catalog.v2.json` was generated from current web familiar metadata.
+- `https://familiaros.dev/familiars/catalog.v2.json` was deployed and verified to return `200 application/json` with `version: 2`.
 
 Oracle re-reviewed the web update and approved Phase 04A for manual verification.
 
diff --git a/docs/phases/phase-04b-safe-pet-installation.md b/docs/phases/phase-04b-safe-pet-installation.md
index c7da537f..7f8d7176 100644
--- a/docs/phases/phase-04b-safe-pet-installation.md
+++ b/docs/phases/phase-04b-safe-pet-installation.md
@@ -1,18 +1,18 @@
-# Phase 04B: Safe pet installation, removal, and default switching
+# Phase 04B: Safe familiar installation, removal, and default switching
 
 ## Goal
 
-Allow users to install pets from the validated v2 catalog, set an installed pet as the default, render the selected default pet, and remove removable installed pets safely.
+Allow users to install familiars from the validated v2 catalog, set an installed familiar as the default, render the selected default familiar, and remove removable installed familiars safely.
 
-This phase turns the Phase 04A read-only catalog into the first real pet ownership flow:
+This phase turns the Phase 04A read-only catalog into the first real familiar ownership flow:
 
 ```text
-Catalog pet → safe download/install → installed state → set default → visible pet changes → remove → fallback
+Catalog familiar → safe download/install → installed state → set default → visible familiar changes → remove → fallback
 ```
 
 ## Non-goals
 
-- Pet update system.
+- Familiar update system.
 - Categories/tags/favorites/ratings/popularity UI.
 - CLI install command.
 - MCP/local adapter IPC.
@@ -21,17 +21,17 @@ Catalog pet → safe download/install → installed state → set default → vi
 - First-run onboarding.
 - Production packaging.
 - Full animation-state engine.
-- Remote preview rendering in Pet Manager.
+- Remote preview rendering in Familiar Manager.
 
 ## User-visible/manual outcome
 
-After this phase, the user can install a catalog pet, set it as default, see the floating pet window reflect the selected pet, restart and keep the selection, remove it, and safely fall back to the built-in pet.
+After this phase, the user can install a catalog familiar, set it as default, see the floating familiar window reflect the selected familiar, restart and keep the selection, remove it, and safely fall back to the built-in familiar.
 
 ## Acceptance criteria
 
 - Existing Phase 04A catalog fetch/search/read-only behavior continues to work.
-- Pet Manager enables `Install` for catalog pets that are not installed.
-- Installing a pet downloads only its validated catalog `zip` URL.
+- Familiar Manager enables `Install` for catalog familiars that are not installed.
+- Installing a familiar downloads only its validated catalog `zip` URL.
 - Zip download uses allowed host/protocol/path rules from Phase 04A.
 - Zip download has timeout and byte limits.
 - Zip extraction prevents zip-slip/path traversal.
@@ -39,22 +39,22 @@ After this phase, the user can install a catalog pet, set it as default, see the
 - Zip extraction does not preserve executable permissions.
 - Zip extraction never executes downloaded files.
 - Install extracts into a temp directory first.
-- Install validates required pet files before finalizing.
-- Failed installs clean up temp files and do not update installed pet state.
-- Successful install moves/copies validated files into `<userData>/pets/<petId>/`.
-- Installed pet state is persisted only after install finalization succeeds.
+- Install validates required familiar files before finalizing.
+- Failed installs clean up temp files and do not update installed familiar state.
+- Successful install moves/copies validated files into `<userData>/familiars/<petId>/`.
+- Installed familiar state is persisted only after install finalization succeeds.
 - Install/remove/default state write failures propagate to the UI and do not report success.
-- Pet Manager shows installed state after install.
-- User can set an installed pet as default.
-- Default pet id persists across restart.
-- Floating pet window visibly reflects the selected default pet.
-- If installed pet rendering fails, the app falls back to built-in pet rendering without crashing.
-- User can remove installed non-built-in pets.
-- Built-in pet cannot be removed.
-- Removing the current default pet sets default back to built-in and refreshes the pet window.
+- Familiar Manager shows installed state after install.
+- User can set an installed familiar as default.
+- Default familiar id persists across restart.
+- Floating familiar window visibly reflects the selected default familiar.
+- If installed familiar rendering fails, the app falls back to built-in familiar rendering without crashing.
+- User can remove installed non-built-in familiars.
+- Built-in familiar cannot be removed.
+- Removing the current default familiar sets default back to built-in and refreshes the familiar window.
 - Remove failures leave app state consistent and understandable.
-- Reinstall/overwrite of an already installed pet is not supported in Phase 04B.
-- Concurrent duplicate install/remove/default actions for the same pet are prevented.
+- Reinstall/overwrite of an already installed familiar is not supported in Phase 04B.
+- Concurrent duplicate install/remove/default actions for the same familiar are prevented.
 - Automated checks include zip/path safety tests.
 
 ## Required current zip shape
@@ -64,40 +64,40 @@ Phase 04B must inspect current real zips before implementation and document the
 Expected current shape from existing catalog zips:
 
 ```text
-<pet-id>/pet.json
-<pet-id>/spritesheet.webp
+<familiar-id>/familiar.json
+<familiar-id>/spritesheet.webp
 ```
 
 Required install validation for Phase 04B:
 
 - Exactly one top-level directory is allowed, or files may be normalized from a single safe top-level directory.
-- `pet.json` must exist.
+- `familiar.json` must exist.
 - `spritesheet.webp` must exist.
-- `pet.json` must be valid JSON.
+- `familiar.json` must be valid JSON.
 - `spritesheet.webp` must be present and under size limits.
-- The installed pet id comes from the catalog id, not from trusting zip paths.
-- Final installed directory contains only normalized `pet.json` and `spritesheet.webp`.
+- The installed familiar id comes from the catalog id, not from trusting zip paths.
+- Final installed directory contains only normalized `familiar.json` and `spritesheet.webp`.
 
 If real zips differ, update this section before implementation and re-check with Oracle.
 
 ## Install storage
 
-Store installed pets under:
+Store installed familiars under:
 
 ```text
-<userData>/pets/<petId>/
+<userData>/familiars/<petId>/
 ```
 
 Final installed shape for Phase 04B:
 
 ```text
-<userData>/pets/<petId>/pet.json
-<userData>/pets/<petId>/spritesheet.webp
+<userData>/familiars/<petId>/familiar.json
+<userData>/familiars/<petId>/spritesheet.webp
 ```
 
 Do not store or trust arbitrary absolute paths in app state.
 
-State should store safe metadata and derive local paths from `userData` + safe pet id.
+State should store safe metadata and derive local paths from `userData` + safe familiar id.
 
 ## Download and extraction limits
 
@@ -111,7 +111,7 @@ max individual file: 100 MB
 download timeout: 30 seconds
 ```
 
-If real catalog pets require different limits, update this spec before implementation.
+If real catalog familiars require different limits, update this spec before implementation.
 
 ## URL policy
 
@@ -120,8 +120,8 @@ Download URL must come from a validated v2 catalog entry.
 Zip URL rules:
 
 - `https:` only.
-- Host exactly `zip.openpets.dev`.
-- Path starts with `/pets/`.
+- Host exactly `zip.familiaros.dev`.
+- Path starts with `/familiars/`.
 - No credentials.
 - No custom port.
 - Redirects should be rejected or manually validated before following.
@@ -130,13 +130,13 @@ Zip URL rules:
 
 Install-from-fixture behavior:
 
-- Installing from the validated fixture fallback is allowed in development because fixture entries use the same `zip.openpets.dev` URLs and URL validation rules.
+- Installing from the validated fixture fallback is allowed in development because fixture entries use the same `zip.familiaros.dev` URLs and URL validation rules.
 - UI should not hide that the catalog source is fixture fallback.
 
 Reinstall policy:
 
-- If a pet is already installed, `Install` is disabled.
-- Phase 04B does not overwrite/reinstall installed pets.
+- If a familiar is already installed, `Install` is disabled.
+- Phase 04B does not overwrite/reinstall installed familiars.
 - A future update/reinstall flow can be designed later.
 
 ## Zip safety policy
@@ -166,12 +166,12 @@ For each entry:
 - Never execute files.
 - Do not preserve executable permissions.
 - Validate compressed and uncompressed sizes during extraction; do not trust metadata only.
-- Reject extra non-directory files beyond the accepted normalized final shape: `pet.json` and `spritesheet.webp`.
+- Reject extra non-directory files beyond the accepted normalized final shape: `familiar.json` and `spritesheet.webp`.
 
 Removal path safety:
 
-- Derive removal path only from `<userData>/pets/<safePetId>`.
-- Verify resolved path remains inside the pets root before deletion.
+- Derive removal path only from `<userData>/familiars/<safePetId>`.
+- Verify resolved path remains inside the familiars root before deletion.
 - Never remove paths from persisted state directly.
 
 Mandatory tests/checks must cover malicious path cases.
@@ -180,7 +180,7 @@ Mandatory tests/checks must cover malicious path cases.
 
 Extend the existing V1 app state shape in a backward-compatible way. Do not introduce a V2 state migration in Phase 04B unless implementation proves V1 extension is insufficient.
 
-Recommended installed pet state:
+Recommended installed familiar state:
 
 ```ts
 interface InstalledPetState {
@@ -202,13 +202,13 @@ interface InstalledPetState {
 
 Rules:
 
-- Built-in pet remains always present/protected.
-- Default pet id must point to an installed pet or fall back to built-in.
+- Built-in familiar remains always present/protected.
+- Default familiar id must point to an installed familiar or fall back to built-in.
 - Removing current default sets default to built-in before/with state update.
-- If installed files are missing/corrupt on startup, mark the pet broken and fall back to built-in if needed. Do not crash.
+- If installed files are missing/corrupt on startup, mark the familiar broken and fall back to built-in if needed. Do not crash.
 - App state is updated only after file operations succeed.
-- Broken installed pet policy: mark the pet as `broken: true`, keep it removable in Pet Manager, and fall back to built-in if it is/was the default.
-- Do not auto-remove broken pets in Phase 04B.
+- Broken installed familiar policy: mark the familiar as `broken: true`, keep it removable in Familiar Manager, and fall back to built-in if it is/was the default.
+- Do not auto-remove broken familiars in Phase 04B.
 - Persisted state should not store absolute local paths.
 
 State operation order:
@@ -216,27 +216,27 @@ State operation order:
 - Install: download zip → validate archive → extract to temp → validate final files → move to final directory → write state → report success.
 - Install failure before state write: clean temp/final partial files and leave state unchanged.
 - Remove non-default: validate derived removal path → remove installed record from state → delete files; if file deletion fails, keep state consistent and show a warning/error.
-- Remove current default: update state so default falls back to built-in and installed record is removed atomically, refresh pet window, then delete files.
-- Default switch: validate installed/non-broken pet → update state → refresh pet window; if state write fails, do not refresh/report success.
-- Operation locks prevent install/remove/default races for the same pet id.
+- Remove current default: update state so default falls back to built-in and installed record is removed atomically, refresh familiar window, then delete files.
+- Default switch: validate installed/non-broken familiar → update state → refresh familiar window; if state write fails, do not refresh/report success.
+- Operation locks prevent install/remove/default races for the same familiar id.
 
-## Default pet rendering
+## Default familiar rendering
 
 Phase 04B does not need final animation engine quality.
 
 Rendering rules:
 
-- Built-in pet keeps current generated renderer.
-- Installed default pet uses local installed `spritesheet.webp` as a static visible image inside the existing 180x180 pet window.
-- Do not load remote image URLs in the pet window.
-- Main process reads local installed `spritesheet.webp`, size-checks it, converts it to `data:image/webp;base64,...`, and passes that data URL into generated pet HTML.
-- Pet window CSP must allow `img-src data:` and continue to deny remote content.
-- Do not use broad `file://` access to `userData` in the pet renderer.
+- Built-in familiar keeps current generated renderer.
+- Installed default familiar uses local installed `spritesheet.webp` as a static visible image inside the existing 180x180 familiar window.
+- Do not load remote image URLs in the familiar window.
+- Main process reads local installed `spritesheet.webp`, size-checks it, converts it to `data:image/webp;base64,...`, and passes that data URL into generated familiar HTML.
+- Familiar window CSP must allow `img-src data:` and continue to deny remote content.
+- Do not use broad `file://` access to `userData` in the familiar renderer.
 - If installed image fails, fallback to built-in generated renderer and log clearly.
-- If installed image fails for the selected default, mark installed pet broken where practical and fall back to built-in rendering.
-- Setting default should refresh the visible pet window immediately.
+- If installed image fails for the selected default, mark installed familiar broken where practical and fall back to built-in rendering.
+- Setting default should refresh the visible familiar window immediately.
 
-## Pet Manager UI behavior
+## Familiar Manager UI behavior
 
 Catalog card actions:
 
@@ -248,21 +248,21 @@ Catalog card actions:
 
 Show clear errors for install/remove failures.
 
-Disable duplicate actions while an operation for a pet is in progress.
+Disable duplicate actions while an operation for a familiar is in progress.
 
 ## Internal IPC/preload API
 
 Extend the current narrow internal UI API:
 
 ```ts
-installPet(petId: string): Promise<OpenPetsStateV1>
-removePet(petId: string): Promise<OpenPetsStateV1>
-setDefaultPet(petId: string): Promise<OpenPetsStateV1>
+installPet(petId: string): Promise<FamiliarOSStateV1>
+removePet(petId: string): Promise<FamiliarOSStateV1>
+setDefaultPet(petId: string): Promise<FamiliarOSStateV1>
 ```
 
 Rules:
 
-- Sender must be Pet Manager.
+- Sender must be Familiar Manager.
 - `petId` must be a safe known catalog/installed id.
 - No generic invoke API.
 - No filesystem/shell/Electron exposure.
@@ -290,7 +290,7 @@ Final Phase 04B choice:
 
 - Use `yauzl@3.3.0` with `lazyEntries: true` and `validateEntrySizes: true`.
 - Rationale: pure JavaScript, works with Node/npm without Bun or native build steps, exposes central-directory entry metadata before extraction, supports sequential entry processing, exposes compressed/uncompressed sizes, encryption flags, compression method, and external file attributes needed for fail-closed validation.
-- Phase 04B extraction still applies OpenPets' own path, size, duplicate, collision, file type, and final-shape validation instead of relying only on the library defaults.
+- Phase 04B extraction still applies FamiliarOS' own path, size, duplicate, collision, file type, and final-shape validation instead of relying only on the library defaults.
 
 ## Risks and tradeoffs
 
@@ -324,9 +324,9 @@ Mitigation:
 - No telemetry.
 - No cookies/auth/accounts.
 - No remote HTML.
-- No script execution from downloaded pets.
+- No script execution from downloaded familiars.
 - No shell command execution.
-- No pet zip contents outside OpenPets userData paths.
+- No familiar zip contents outside FamiliarOS userData paths.
 - All downloaded files are untrusted.
 - Fail closed on validation errors.
 
@@ -353,16 +353,16 @@ Phase 04B must add automated checks for:
 1. Run:
 
    ```bash
-   pnpm --filter @open-pets/desktop dev
+   pnpm --filter @familiaros/desktop dev
    ```
 
-2. Open `Manage Pets...`.
-3. Install a catalog pet, for example Snoopy.
+2. Open `Manage Familiars...`.
+3. Install a catalog familiar, for example Snoopy.
 4. Confirm it appears installed.
 5. Set it as default.
-6. Confirm floating pet visibly changes to the installed pet image.
+6. Confirm floating familiar visibly changes to the installed familiar image.
 7. Quit/restart and confirm installed/default state persists.
-8. Remove the installed pet.
+8. Remove the installed familiar.
 9. Confirm default falls back to built-in.
 10. Confirm built-in cannot be removed.
 11. Confirm catalog/search/settings still work.
@@ -375,16 +375,16 @@ Does Phase 04B pass on your machine: safe install works, installed default rende
 
 ## Oracle plan review
 
-Oracle reviewed the initial Phase 04B spec and blocked implementation until state schema, broken pet policy, install/reinstall behavior, zip validation, removal safety, rendering strategy, and dependency choice were sharpened.
+Oracle reviewed the initial Phase 04B spec and blocked implementation until state schema, broken familiar policy, install/reinstall behavior, zip validation, removal safety, rendering strategy, and dependency choice were sharpened.
 
 ## Oracle feedback disposition
 
 - Fixed: Chose backward-compatible V1 state extension instead of V2 migration.
-- Fixed: Defined broken installed pet policy: mark broken/removable, fallback to built-in, do not auto-remove.
+- Fixed: Defined broken installed familiar policy: mark broken/removable, fallback to built-in, do not auto-remove.
 - Fixed: Explicitly allowed install from validated fixture fallback during development.
 - Fixed: Forbid reinstall/overwrite in Phase 04B.
 - Fixed: Required install/remove/default state write failures to propagate.
-- Fixed: Required final installed directory to contain only `pet.json` and `spritesheet.webp`.
+- Fixed: Required final installed directory to contain only `familiar.json` and `spritesheet.webp`.
 - Fixed: Added zip magic/central-directory validation requirement.
 - Fixed: Required streaming download byte limit and timeout through full body read.
 - Fixed: Added removal path safety rules.
@@ -395,8 +395,8 @@ Implementation review disposition:
 
 - Fixed: Open `yauzl` with `strictFileNames: true` so backslash entries are rejected before extraction instead of normalized.
 - Fixed: App state writes now write the candidate state to disk before mutating in-memory state, preventing state/disk divergence on write failure.
-- Fixed: Persisted installed pet ids are revalidated during normalization; invalid entries are dropped.
-- Fixed: Startup normalization marks installed pets broken when required local files are missing/corrupt and falls back to built-in if the persisted default is broken.
+- Fixed: Persisted installed familiar ids are revalidated during normalization; invalid entries are dropped.
+- Fixed: Startup normalization marks installed familiars broken when required local files are missing/corrupt and falls back to built-in if the persisted default is broken.
 - Fixed: Zip checks now include duplicate/case-collision entry sets, non-zip magic rejection, empty path segment rejection, and an archive-level `yauzl` `strictFileNames` backslash rejection check.
 - Fixed: Remove-file deletion failures now report that state removal succeeded but local files may require manual cleanup.
 - Fixed: Tightened initial zip magic acceptance to normal local-file and empty-archive signatures.
diff --git a/docs/phases/phase-05-local-ipc-client.md b/docs/phases/phase-05-local-ipc-client.md
index 728c567d..7512fbc8 100644
--- a/docs/phases/phase-05-local-ipc-client.md
+++ b/docs/phases/phase-05-local-ipc-client.md
@@ -2,9 +2,9 @@
 
 ## Goal
 
-Create the private local control plane between the Electron desktop app and Node-based adapters such as `@open-pets/mcp`, `@open-pets/claude`, and `@open-pets/cli`.
+Create the private local control plane between the Electron desktop app and Node-based adapters such as `@familiaros/mcp`, `@familiaros/claude`, and `@familiaros/cli`.
 
-After this phase, a developer can run the desktop app and use `@open-pets/client` from Node to call local IPC methods that report app status and make the visible default pet react in a small, manually verifiable way.
+After this phase, a developer can run the desktop app and use `@familiaros/client` from Node to call local IPC methods that report app status and make the visible default familiar react in a small, manually verifiable way.
 
 ## Non-goals
 
@@ -16,7 +16,7 @@ After this phase, a developer can run the desktop app and use `@open-pets/client
 - Full speech bubble product UI.
 - Rich animation-state engine.
 - Production installer integration.
-- Pet install/remove/default over public IPC.
+- Familiar install/remove/default over public IPC.
 
 ## User-visible/manual outcome
 
@@ -24,11 +24,11 @@ With the desktop app running, a developer can run a local Node command from `pac
 
 ```text
 status
-pet.react
-pet.say
+familiar.react
+familiar.say
 ```
 
-The desktop app rejects invalid tokens/versions. `pet.react` and `pet.say` produce a visible temporary state in the existing default pet window, enough to prove the local control plane works before MCP is built.
+The desktop app rejects invalid tokens/versions. `familiar.react` and `familiar.say` produce a visible temporary state in the existing default familiar window, enough to prove the local control plane works before MCP is built.
 
 ## Acceptance criteria
 
@@ -49,17 +49,17 @@ The desktop app rejects invalid tokens/versions. `pet.react` and `pet.say` produ
 - Malformed JSON and unknown methods return errors without crashing the app.
 - IPC request size is bounded.
 - The server handles socket/client errors without crashing.
-- `@open-pets/client` can read discovery, connect, send one request, and return typed results.
-- `@open-pets/client` has connection/request timeout behavior.
+- `@familiaros/client` can read discovery, connect, send one request, and return typed results.
+- `@familiaros/client` has connection/request timeout behavior.
 - Initial methods are implemented:
   - `hello`
   - `status`
-  - `pet.react`
-  - `pet.say`
-- `status` reports whether the app is reachable, app version, protocol version, default pet id, default pet display name, and paused/open-default-pet state where available.
-- `pet.react` accepts the initial public reaction names from `task.txt` and visibly updates the default pet label/state temporarily.
-- `pet.say` accepts a short message, enforces the Phase speech/message safety rules at a minimal level, and visibly updates the default pet label/message temporarily.
-- Public IPC does not expose pet installation, removal, default switching, filesystem, shell, Electron, or generic invoke access.
+  - `familiar.react`
+  - `familiar.say`
+- `status` reports whether the app is reachable, app version, protocol version, default familiar id, default familiar display name, and paused/open-default-familiar state where available.
+- `familiar.react` accepts the initial public reaction names from `task.txt` and visibly updates the default familiar label/state temporarily.
+- `familiar.say` accepts a short message, enforces the Phase speech/message safety rules at a minimal level, and visibly updates the default familiar label/message temporarily.
+- Public IPC does not expose familiar installation, removal, default switching, filesystem, shell, Electron, or generic invoke access.
 - Automated checks cover protocol validation and client request/response parsing where practical.
 
 ## Proposed files/directories
@@ -70,8 +70,8 @@ Expected additions/changes:
 docs/phases/phase-05-local-ipc-client.md
 apps/desktop/src/local-ipc.ts
 apps/desktop/src/local-ipc-protocol.ts
-apps/desktop/src/default-pet-controller.ts
-apps/desktop/src/pet-window.ts
+apps/desktop/src/default-familiar-controller.ts
+apps/desktop/src/familiar-window.ts
 apps/desktop/src/main.ts
 packages/client/src/index.ts
 packages/client/src/protocol.ts
@@ -86,12 +86,12 @@ Exact file split may change during implementation if a simpler structure is clea
 
 ### Transport
 
-Use Node `node:net` in the Electron main process and in `@open-pets/client`.
+Use Node `node:net` in the Electron main process and in `@familiaros/client`.
 
 Platform endpoint rules:
 
-- macOS/Linux: create a Unix socket under a user-owned OpenPets runtime directory.
-- Windows: create a named pipe path like `\\.\pipe\openpets-<user-or-session>-<pid>`.
+- macOS/Linux: create a Unix socket under a user-owned FamiliarOS runtime directory.
+- Windows: create a named pipe path like `\\.\pipe\familiaros-<user-or-session>-<pid>`.
 
 No TCP listener is used in Phase 05.
 
@@ -102,17 +102,17 @@ Use a shared deterministic discovery location so the app and client can agree wi
 Discovery file location:
 
 ```text
-macOS:   ~/Library/Application Support/OpenPets/runtime/ipc.json
-Linux:   $XDG_RUNTIME_DIR/openpets/ipc.json when secure, otherwise ~/.config/OpenPets/runtime/ipc.json
-Windows: %APPDATA%\OpenPets\runtime\ipc.json
+macOS:   ~/Library/Application Support/FamiliarOS/runtime/ipc.json
+Linux:   $XDG_RUNTIME_DIR/familiaros/ipc.json when secure, otherwise ~/.config/FamiliarOS/runtime/ipc.json
+Windows: %APPDATA%\FamiliarOS\runtime\ipc.json
 ```
 
 Socket/pipe endpoint location:
 
 ```text
-macOS:   /tmp/openpets-<uid>/openpets-<pid>.sock
-Linux:   $XDG_RUNTIME_DIR/openpets/openpets-<pid>.sock when secure, otherwise /tmp/openpets-<uid>/openpets-<pid>.sock
-Windows: \\.\pipe\openpets-<random>-<pid>
+macOS:   /tmp/familiaros-<uid>/familiaros-<pid>.sock
+Linux:   $XDG_RUNTIME_DIR/familiaros/familiaros-<pid>.sock when secure, otherwise /tmp/familiaros-<uid>/familiaros-<pid>.sock
+Windows: \\.\pipe\familiaros-<random>-<pid>
 ```
 
 Do not put Unix socket files under the longer application-support discovery directory because common Unix socket path length limits are around 103-107 bytes.
@@ -131,8 +131,8 @@ Discovery shape:
 ```json
 {
   "protocolVersion": 1,
-  "protocol": "openpets-ipc",
-  "endpoint": "/short/path/openpets.sock",
+  "protocol": "familiaros-ipc",
+  "endpoint": "/short/path/familiaros.sock",
   "token": "random-startup-token",
   "appVersion": "0.0.0",
   "pid": 12345,
@@ -142,9 +142,9 @@ Discovery shape:
 
 Write discovery atomically through a temp file then rename where practical. Remove the discovery file on normal app shutdown if it still points at the current pid/token.
 
-Treat discovery as untrusted in `@open-pets/client`: reject malformed JSON, wrong protocol, wrong protocol version, mismatched platform, unsupported endpoint shape, TCP-like host/port values, missing token, missing pid, and oversized discovery files.
+Treat discovery as untrusted in `@familiaros/client`: reject malformed JSON, wrong protocol, wrong protocol version, mismatched platform, unsupported endpoint shape, TCP-like host/port values, missing token, missing pid, and oversized discovery files.
 
-Threat model: the startup token protects against accidental or cross-user access when file permissions hold. It is not a strong same-user security boundary. A same-user process that can read the discovery file can control the pet for that app run.
+Threat model: the startup token protects against accidental or cross-user access when file permissions hold. It is not a strong same-user security boundary. A same-user process that can read the discovery file can control the familiar for that app run.
 
 ### Protocol
 
@@ -204,29 +204,29 @@ Error response:
 
 `status`:
 
-- Returns current default pet summary and basic app state.
+- Returns current default familiar summary and basic app state.
 
-`pet.react`:
+`familiar.react`:
 
 - Params: `{ "reaction": "testing" }`.
 - Valid reactions: `idle`, `thinking`, `working`, `editing`, `running`, `testing`, `waiting`, `success`, `error`, `celebrating`.
-- Updates the existing default pet renderer with a visible label/state for a short TTL.
+- Updates the existing default familiar renderer with a visible label/state for a short TTL.
 
-`pet.say`:
+`familiar.say`:
 
 - Params: `{ "message": "On it!", "reaction": "working" }`.
 - Message must be short, single-line, not code-block-like, and not obviously secret-like.
-- Updates the existing default pet renderer with a visible message for a short TTL.
+- Updates the existing default familiar renderer with a visible message for a short TTL.
 - Respects `speechBubblesEnabled` and paused state where practical.
 - Replaces the current transient message/reaction and resets its TTL instead of queuing unbounded messages.
 - All dynamic message/reaction/display text must be HTML-escaped before renderer insertion.
 
 ### Client package
 
-`@open-pets/client` should expose typed helpers:
+`@familiaros/client` should expose typed helpers:
 
 ```ts
-createOpenPetsClient(options?): OpenPetsClient
+createFamiliarOSClient(options?): FamiliarOSClient
 client.hello()
 client.status()
 client.react(reaction)
@@ -242,9 +242,9 @@ Unavailable/stale discovery semantics:
 
 ### Desktop integration
 
-- Start IPC after app state and default-pet display handlers are initialized.
+- Start IPC after app state and default-familiar display handlers are initialized.
 - Stop IPC during app shutdown.
-- `pet.react` / `pet.say` should show the default pet if open-default-pet-on-launch is enabled or if the default pet window is already visible. It should not create extra pet windows beyond the default pet in Phase 05.
+- `familiar.react` / `familiar.say` should show the default familiar if open-default-familiar-on-launch is enabled or if the default familiar window is already visible. It should not create extra familiar windows beyond the default familiar in Phase 05.
 - Keep renderer content generated by the main process with a strict CSP. No remote content.
 
 ## Risks and tradeoffs
@@ -271,7 +271,7 @@ Mitigation:
 
 Mitigation:
 
-- Phase 05 does not implement leases, heartbeats, MCP tools, auto-launch, or cleanup semantics for agent-owned temporary pets.
+- Phase 05 does not implement leases, heartbeats, MCP tools, auto-launch, or cleanup semantics for agent-owned temporary familiars.
 - It only proves the private app/client control plane.
 
 ## Security/privacy notes
@@ -279,10 +279,10 @@ Mitigation:
 - No remote API.
 - No TCP listener.
 - No shell command execution.
-- No pet install/remove/default mutation over this initial public IPC.
+- No familiar install/remove/default mutation over this initial public IPC.
 - Startup token is random and per app run.
 - Requests are bounded and parsed as untrusted input.
-- `pet.say` must not display multiline/code/secret-looking content.
+- `familiar.say` must not display multiline/code/secret-looking content.
 - Discovery file is a local convenience file, not durable account/auth state.
 
 ## Test/check plan
@@ -293,8 +293,8 @@ Automated checks:
 pnpm check
 pnpm typecheck
 pnpm build
-pnpm --filter @open-pets/desktop check
-pnpm --filter @open-pets/client check
+pnpm --filter @familiaros/desktop check
+pnpm --filter @familiaros/client check
 ```
 
 Phase 05 should add checks for:
@@ -305,7 +305,7 @@ Phase 05 should add checks for:
 - Request validation rejects unsupported protocol version.
 - Unknown methods return structured errors.
 - Malformed/oversized request handling is fail-closed.
-- `pet.say` message validation rejects multiline, code-block-like, overlong, URL/path-heavy, or secret-looking input where practical.
+- `familiar.say` message validation rejects multiline, code-block-like, overlong, URL/path-heavy, or secret-looking input where practical.
 - Client protocol parsing handles ok/error responses.
 
 ## Manual verification guide
@@ -313,26 +313,26 @@ Phase 05 should add checks for:
 1. Run the desktop app:
 
    ```bash
-   pnpm --filter @open-pets/desktop dev
+   pnpm --filter @familiaros/desktop dev
    ```
 
 2. In another terminal, run the client smoke command added by this phase, for example:
 
    ```bash
-   pnpm --filter @open-pets/client smoke:status
-   pnpm --filter @open-pets/client smoke:react testing
-   pnpm --filter @open-pets/client smoke:say "Working on it" working
+   pnpm --filter @familiaros/client smoke:status
+   pnpm --filter @familiaros/client smoke:react testing
+   pnpm --filter @familiaros/client smoke:say "Working on it" working
    ```
 
-3. Confirm status returns app/default-pet information.
+3. Confirm status returns app/default-familiar information.
 4. Confirm invalid token smoke check fails with a structured rejection.
-5. Confirm the visible default pet label/state changes for react/say.
-6. Quit OpenPets and confirm the client reports that the app is unavailable.
+5. Confirm the visible default familiar label/state changes for react/say.
+6. Quit FamiliarOS and confirm the client reports that the app is unavailable.
 
 Manual acceptance question:
 
 ```text
-Does Phase 05 pass on your machine: local IPC discovery works, @open-pets/client can call status/react/say, invalid tokens are rejected, and quitting the app makes the client report unavailable?
+Does Phase 05 pass on your machine: local IPC discovery works, @familiaros/client can call status/react/say, invalid tokens are rejected, and quitting the app makes the client report unavailable?
 ```
 
 ## Oracle plan review
@@ -347,22 +347,22 @@ Oracle reviewed the Phase 05 plan and approved the architecture/scope with shoul
 - Fixed: Clarified same-user threat model: startup token is not a strong same-user security boundary.
 - Fixed: Defined stale/unavailable discovery semantics for `client.status()`.
 - Fixed: Added numeric protocol limits for request/response bytes and timeouts.
-- Fixed: Required `pet.say` to respect speech/paused controls where practical, replace transient messages, and HTML-escape dynamic text.
+- Fixed: Required `familiar.say` to respect speech/paused controls where practical, replace transient messages, and HTML-escape dynamic text.
 - Fixed: Tightened automated check requirements for discovery validation, endpoint generation, invalid token/version/method, malformed/oversized input, say validation, and client response parsing.
-- Fixed: Noted package Node typings/build requirement for `@open-pets/client`.
-- Deferred: Environment override such as `OPENPETS_DISCOVERY_FILE` is useful for smoke tests and may be implemented if it stays simple.
+- Fixed: Noted package Node typings/build requirement for `@familiaros/client`.
+- Deferred: Environment override such as `FAMILIAROS_DISCOVERY_FILE` is useful for smoke tests and may be implemented if it stays simple.
 
 Implementation review disposition:
 
-- Fixed: Escaped built-in pet transient label/message text before injecting into generated pet HTML.
-- Fixed: External `pet.react`/`pet.say` no longer force-show the default pet when the user has hidden it and disabled open-default-pet-on-launch; events only show an already-visible pet or the normal open-on-launch default pet.
-- Fixed: Hardened fallback `/tmp/openpets-<uid>` runtime directory handling with ownership, symlink, and mode checks before trusting it.
+- Fixed: Escaped built-in familiar transient label/message text before injecting into generated familiar HTML.
+- Fixed: External `familiar.react`/`familiar.say` no longer force-show the default familiar when the user has hidden it and disabled open-default-familiar-on-launch; events only show an already-visible familiar or the normal open-on-launch default familiar.
+- Fixed: Hardened fallback `/tmp/familiaros-<uid>` runtime directory handling with ownership, symlink, and mode checks before trusting it.
 - Fixed: Discovery file parsing now checks file size before read and wraps malformed JSON in structured client errors.
 - Fixed: Discovery cleanup now removes the file only if it still points at the current pid/token/endpoint.
-- Fixed: Client-side Unix endpoint validation now only accepts expected OpenPets runtime socket filename/directory patterns.
-- Fixed: Paused behavior is quiet: `pet.say` and `pet.react` do not show/update visible transient state while paused.
+- Fixed: Client-side Unix endpoint validation now only accepts expected FamiliarOS runtime socket filename/directory patterns.
+- Fixed: Paused behavior is quiet: `familiar.say` and `familiar.react` do not show/update visible transient state while paused.
 - Fixed: Windows pipe suffix now uses cryptographic random bytes instead of `Math.random()`.
 - Fixed: Reused the protocol transient display TTL constant instead of a hardcoded value.
-- Fixed: Corrected macOS/Linux fallback socket endpoint generation to use literal `/tmp/openpets-<uid>` so it matches the documented path and client validation.
+- Fixed: Corrected macOS/Linux fallback socket endpoint generation to use literal `/tmp/familiaros-<uid>` so it matches the documented path and client validation.
 - Fixed: Malformed/oversized local IPC requests now return `invalid_request` structured errors instead of generic internal errors where possible.
 - Deferred: Response id matching, stronger Windows pipe ACLs, and broader cross-platform endpoint-generation tests can be added with the MCP/packaging phases if needed.
diff --git a/docs/phases/phase-06a-thin-mcp-tools.md b/docs/phases/phase-06a-thin-mcp-tools.md
index dbf4b2d7..5f93d49b 100644
--- a/docs/phases/phase-06a-thin-mcp-tools.md
+++ b/docs/phases/phase-06a-thin-mcp-tools.md
@@ -1,13 +1,13 @@
-# Phase 06A: Thin `@open-pets/mcp` tools over local IPC
+# Phase 06A: Thin `@familiaros/mcp` tools over local IPC
 
 ## Goal
 
-Make OpenPets minimally usable from MCP-capable coding agents through a thin Node/npm/npx MCP server package over the existing Phase 05 local IPC methods.
+Make FamiliarOS minimally usable from MCP-capable coding agents through a thin Node/npm/npx MCP server package over the existing Phase 05 local IPC methods.
 
 This sub-phase turns the Phase 05 local IPC control plane into the first agent-facing integration:
 
 ```text
-MCP-capable agent → @open-pets/mcp stdio server → @open-pets/client → desktop local IPC → visible pet
+MCP-capable agent → @familiaros/mcp stdio server → @familiaros/client → desktop local IPC → visible familiar
 ```
 
 ## Non-goals
@@ -15,7 +15,7 @@ MCP-capable agent → @open-pets/mcp stdio server → @open-pets/client → desk
 - Claude Code config detection/setup UI.
 - Claude enhanced hooks.
 - Agent Setup window implementation.
-- Pet install/remove/default tools exposed to agents.
+- Familiar install/remove/default tools exposed to agents.
 - Remote HTTP/TCP MCP server.
 - Full packaging/release publishing.
 - Complex session/project routing.
@@ -24,57 +24,57 @@ MCP-capable agent → @open-pets/mcp stdio server → @open-pets/client → desk
 
 ## User-visible/manual outcome
 
-After this phase, a developer can run the local `@open-pets/mcp` package as a stdio MCP server, call:
+After this phase, a developer can run the local `@familiaros/mcp` package as a stdio MCP server, call:
 
 ```text
-openpets_status
-openpets_say
-openpets_react
+familiaros_status
+familiaros_say
+familiaros_react
 ```
 
-and see the running OpenPets desktop pet respond through local IPC.
+and see the running FamiliarOS desktop familiar respond through local IPC.
 
-If OpenPets is not running, the MCP server remains alive and `openpets_status` reports a clear degraded/unavailable status instead of crashing.
+If FamiliarOS is not running, the MCP server remains alive and `familiaros_status` reports a clear degraded/unavailable status instead of crashing.
 
-This phase is explicitly **not** the full Phase 06 lease lifecycle. Full real `--pet` routing, non-default temporary pet windows, lease heartbeat/release, fallback for missing explicit pets, and TTL cleanup are split into follow-up Phase 06B.
+This phase is explicitly **not** the full Phase 06 lease lifecycle. Full real `--familiar` routing, non-default temporary familiar windows, lease heartbeat/release, fallback for missing explicit familiars, and TTL cleanup are split into follow-up Phase 06B.
 
 ## Acceptance criteria
 
-- `@open-pets/mcp` builds and runs with Node/npm/pnpm and is shaped for future `npx -y @open-pets/mcp` usage.
+- `@familiaros/mcp` builds and runs with Node/npm/pnpm and is shaped for future `npx -y @familiaros/mcp` usage.
 - Package has a `bin` entry and compiled entrypoint has a Node shebang.
 - MCP server uses stdio transport and never writes logs to stdout.
 - MCP server exposes exactly these initial tools:
-  - `openpets_status`
-  - `openpets_say`
-  - `openpets_react`
-- `openpets_status` calls `@open-pets/client.status()` and reports reachable/degraded app state as both human-readable text and structured content where supported.
-- `openpets_say` calls `@open-pets/client.say()` with the user-provided short message and optional reaction.
-- `openpets_react` calls `@open-pets/client.react()` with one allowed reaction.
+  - `familiaros_status`
+  - `familiaros_say`
+  - `familiaros_react`
+- `familiaros_status` calls `@familiaros/client.status()` and reports reachable/degraded app state as both human-readable text and structured content where supported.
+- `familiaros_say` calls `@familiaros/client.say()` with the user-provided short message and optional reaction.
+- `familiaros_react` calls `@familiaros/client.react()` with one allowed reaction.
 - MCP tool schemas enforce the public reaction list from `task.txt`.
-- MCP tool schemas keep `openpets_say.message` short enough for Phase 05 IPC limits and speech safety.
+- MCP tool schemas keep `familiaros_say.message` short enough for Phase 05 IPC limits and speech safety.
 - Tool errors return MCP tool errors (`isError: true`) rather than crashing the server.
-- If desktop app/discovery/local IPC is unavailable, `openpets_status` reports degraded state clearly.
-- If desktop app/discovery/local IPC is unavailable, `openpets_say` and `openpets_react` return clear tool errors.
-- No tool can install pets, remove pets, set default pet, browse catalog, edit settings, access filesystem, run shell commands, or expose generic IPC.
-- `--pet <id>` is parsed and included in MCP status/config output.
-- `--pet` is clearly reported as configured-but-not-yet-routed in Phase 06A; actual tools still affect the desktop app's current default pet through Phase 05 IPC.
-- `openpets_status` clearly distinguishes `configuredPetId` from `actualTargetPetId`.
-- If `--pet` is omitted, status reports that the MCP server targets the user's current default pet.
+- If desktop app/discovery/local IPC is unavailable, `familiaros_status` reports degraded state clearly.
+- If desktop app/discovery/local IPC is unavailable, `familiaros_say` and `familiaros_react` return clear tool errors.
+- No tool can install familiars, remove familiars, set default familiar, browse catalog, edit settings, access filesystem, run shell commands, or expose generic IPC.
+- `--familiar <id>` is parsed and included in MCP status/config output.
+- `--familiar` is clearly reported as configured-but-not-yet-routed in Phase 06A; actual tools still affect the desktop app's current default familiar through Phase 05 IPC.
+- `familiaros_status` clearly distinguishes `configuredPetId` from `actualTargetPetId`.
+- If `--familiar` is omitted, status reports that the MCP server targets the user's current default familiar.
 - MCP process lifecycle handlers close the MCP server cleanly on `SIGINT`/`SIGTERM` where available.
 - No Bun runtime requirement.
 - Automated checks cover MCP argument parsing, tool input validation helpers, and degraded status formatting where practical.
 
 ## Scope note: Phase 06A versus 06B
 
-The high-level Phase 06 target in `docs/implementation-process.md` includes immediate lease acquire/release, `--pet` opening explicit non-default pets, fallback for missing explicit pets, and TTL cleanup.
+The high-level Phase 06 target in `docs/implementation-process.md` includes immediate lease acquire/release, `--familiar` opening explicit non-default familiars, fallback for missing explicit familiars, and TTL cleanup.
 
-Current implementation state after Phase 05 provides `hello`, `status`, `pet.react`, and `pet.say` over local IPC, but does not yet expose `lease.acquire`, `lease.heartbeat`, or `lease.release`, and the desktop app still has only a persistent default-pet window.
+Current implementation state after Phase 05 provides `hello`, `status`, `familiar.react`, and `familiar.say` over local IPC, but does not yet expose `lease.acquire`, `lease.heartbeat`, or `lease.release`, and the desktop app still has only a persistent default-familiar window.
 
 Oracle plan review required this split. This spec is Phase 06A:
 
 ```text
-Phase 06A: thin MCP tools over default-pet IPC
-Phase 06B: MCP lease lifecycle and explicit non-default pet windows
+Phase 06A: thin MCP tools over default-familiar IPC
+Phase 06B: MCP lease lifecycle and explicit non-default familiar windows
 ```
 
 Do not silently expand Phase 06A into lease lifecycle work.
@@ -113,8 +113,8 @@ Do not use alpha split SDK packages unless the stable SDK proves incompatible an
 ### Server shape
 
 - Entry file starts with `#!/usr/bin/env node`.
-- `@open-pets/client`, `@modelcontextprotocol/sdk`, and the schema validation library are runtime dependencies when used by the MCP server.
-- Create MCP server with name `open-pets` / package name `@open-pets/mcp`.
+- `@familiaros/client`, `@modelcontextprotocol/sdk`, and the schema validation library are runtime dependencies when used by the MCP server.
+- Create MCP server with name `familiaros` / package name `@familiaros/mcp`.
 - Connect using stdio transport.
 - Use stderr for diagnostics only.
 - Keep stdout reserved for MCP protocol.
@@ -123,17 +123,17 @@ Do not use alpha split SDK packages unless the stable SDK proves incompatible an
 
 ### Tools
 
-`openpets_status`:
+`familiaros_status`:
 
 - No required params.
-- Returns app availability, configured `--pet` target if present, default-pet status from the desktop app, and guidance if unavailable.
+- Returns app availability, configured `--familiar` target if present, default-familiar status from the desktop app, and guidance if unavailable.
 - Should be safe/read-only/idempotent.
 - Sanitizes degraded/unavailable errors before returning them to agents; do not expose home paths, socket paths, tokens, or raw Node stack details.
 
 Structured status shape:
 
 ```ts
-interface OpenPetsMcpStatus {
+interface FamiliarOSMcpStatus {
   ok: boolean;
   appRunning: boolean;
   configuredPetId?: string;
@@ -146,7 +146,7 @@ interface OpenPetsMcpStatus {
 }
 ```
 
-`openpets_react`:
+`familiaros_react`:
 
 Params:
 
@@ -171,7 +171,7 @@ error
 celebrating
 ```
 
-`openpets_say`:
+`familiaros_say`:
 
 Params:
 
@@ -197,34 +197,34 @@ The desktop IPC remains the final enforcement layer; MCP schemas are an early va
 Parse only the initial simple args:
 
 ```text
---pet <petId>
+--familiar <petId>
 --help
 --version
 ```
 
 Rules:
 
-- Pet id uses the same safe id shape as catalog pets.
+- Familiar id uses the same safe id shape as catalog familiars.
 - Do not add `--agent` or `--workspace`.
-- Do not make `--pet` silently install pets.
-- For Phase 06A-style behavior, `--pet` is reported in status but may not yet open non-default pets until lease lifecycle is implemented.
-- If `--pet` is provided, `openpets_status` must explicitly say explicit pet routing is not implemented in Phase 06A and the actual target remains the desktop default pet.
+- Do not make `--familiar` silently install familiars.
+- For Phase 06A-style behavior, `--familiar` is reported in status but may not yet open non-default familiars until lease lifecycle is implemented.
+- If `--familiar` is provided, `familiaros_status` must explicitly say explicit familiar routing is not implemented in Phase 06A and the actual target remains the desktop default familiar.
 
 ### Degraded behavior
 
-`@open-pets/client.status()` already returns a typed unavailable result when discovery/connect fails. MCP should preserve this behavior in `openpets_status`.
+`@familiaros/client.status()` already returns a typed unavailable result when discovery/connect fails. MCP should preserve this behavior in `familiaros_status`.
 
 For `say`/`react`, return `isError: true` with a concise message such as:
 
 ```text
-OpenPets desktop app is not running or local IPC is unavailable. Open OpenPets and try again.
+FamiliarOS desktop app is not running or local IPC is unavailable. Open FamiliarOS and try again.
 ```
 
 ### Lifecycle
 
 - Handle `SIGINT`/`SIGTERM` by closing MCP server/transport where supported.
-- Keep server alive even if OpenPets desktop app is unavailable.
-- Do not implement public `openpets_release`.
+- Keep server alive even if FamiliarOS desktop app is unavailable.
+- Do not implement public `familiaros_release`.
 
 Phase 06B lease lifecycle must later:
 
@@ -232,7 +232,7 @@ Phase 06B lease lifecycle must later:
 - Heartbeat while alive.
 - Release on shutdown/signals/stdin close where practical.
 - Use desktop TTL fallback for orphan cleanup.
-- Fall back to default pet for missing explicit pet and report fallback in status.
+- Fall back to default familiar for missing explicit familiar and report fallback in status.
 
 ## Risks and tradeoffs
 
@@ -251,14 +251,14 @@ Mitigation:
 - Never use `console.log` in MCP runtime path.
 - Use stderr for diagnostics.
 
-### Risk: scope creep into full lease/multi-pet lifecycle
+### Risk: scope creep into full lease/multi-familiar lifecycle
 
 Mitigation:
 
 - Thin MCP tools over existing local IPC are the manually verifiable Phase 06A checkpoint.
 - Lease lifecycle is explicitly Phase 06B.
 
-### Risk: agents displaying private content through `openpets_say`
+### Risk: agents displaying private content through `familiaros_say`
 
 Mitigation:
 
@@ -272,8 +272,8 @@ Mitigation:
 - No TCP/HTTP listener.
 - No filesystem/shell/Electron access exposed to agents.
 - Agent-facing tool surface stays minimal.
-- Pet management remains user-controlled in the desktop app.
-- `openpets_say` is for short status/personality messages only.
+- Familiar management remains user-controlled in the desktop app.
+- `familiaros_say` is for short status/personality messages only.
 - No Bun runtime dependency.
 
 ## Test/check plan
@@ -282,18 +282,18 @@ Automated checks:
 
 ```bash
 pnpm check
-pnpm --filter @open-pets/mcp check
-pnpm --filter @open-pets/mcp build
+pnpm --filter @familiaros/mcp check
+pnpm --filter @familiaros/mcp build
 ```
 
 Phase 06A should add checks for:
 
-- CLI arg parsing for `--pet`, `--help`, `--version`, invalid args.
+- CLI arg parsing for `--familiar`, `--help`, `--version`, invalid args.
 - Reaction validation accepts only public reactions.
-- `openpets_say` validation rejects overlong/multiline/code/secret/path/URL-like messages.
+- `familiaros_say` validation rejects overlong/multiline/code/secret/path/URL-like messages.
 - Degraded status formatting when client reports unavailable.
 - Built output has a shebang or package bin points at the expected executable.
-- MCP contract check starts the stdio server and verifies `tools/list` returns exactly `openpets_status`, `openpets_say`, and `openpets_react`.
+- MCP contract check starts the stdio server and verifies `tools/list` returns exactly `familiaros_status`, `familiaros_say`, and `familiaros_react`.
 - Contract check verifies unavailable app does not crash the MCP server.
 - Contract check verifies no unexpected stdout noise outside MCP protocol messages.
 
@@ -302,42 +302,42 @@ Phase 06A should add checks for:
 1. Run desktop app:
 
    ```bash
-   pnpm --filter @open-pets/desktop dev
+   pnpm --filter @familiaros/desktop dev
    ```
 
 2. Build MCP package:
 
    ```bash
-   pnpm --filter @open-pets/mcp build
+   pnpm --filter @familiaros/mcp build
    ```
 
 3. Run an MCP inspector or local MCP client against the package entrypoint.
 
-4. Call `openpets_status` and confirm it reports OpenPets reachable/default pet info.
+4. Call `familiaros_status` and confirm it reports FamiliarOS reachable/default familiar info.
 
-5. Call `openpets_react` with `testing` and confirm the visible pet reacts.
+5. Call `familiaros_react` with `testing` and confirm the visible familiar reacts.
 
-6. Call `openpets_say` with `Working on it` and `working` and confirm the visible pet message appears.
+6. Call `familiaros_say` with `Working on it` and `working` and confirm the visible familiar message appears.
 
-7. Quit OpenPets and call `openpets_status` again; confirm it reports degraded/unavailable clearly while MCP remains alive.
+7. Quit FamiliarOS and call `familiaros_status` again; confirm it reports degraded/unavailable clearly while MCP remains alive.
 
 Manual acceptance question:
 
 ```text
-Does Phase 06A pass on your machine: @open-pets/mcp runs over stdio, exposes status/say/react, talks to the running desktop app through local IPC, reports configured `--pet` as not-yet-routed, and reports degraded status when OpenPets is unavailable?
+Does Phase 06A pass on your machine: @familiaros/mcp runs over stdio, exposes status/say/react, talks to the running desktop app through local IPC, reports configured `--familiar` as not-yet-routed, and reports degraded status when FamiliarOS is unavailable?
 ```
 
 ## Oracle plan review
 
-Oracle reviewed the initial Phase 06 plan and blocked calling it complete Phase 06 because real lease lifecycle and `--pet` routing are larger cross-cutting desktop/client work. Oracle approved the architecture only as Phase 06A.
+Oracle reviewed the initial Phase 06 plan and blocked calling it complete Phase 06 because real lease lifecycle and `--familiar` routing are larger cross-cutting desktop/client work. Oracle approved the architecture only as Phase 06A.
 
 ## Oracle feedback disposition
 
 - Fixed: Renamed/split scope to Phase 06A thin MCP tools over local IPC.
-- Fixed: Deferred lease lifecycle, real non-default `--pet` windows, heartbeat/release, fallback, and TTL cleanup to Phase 06B.
-- Fixed: Required status/manual docs to clearly distinguish configured `--pet` from actual default-pet target in Phase 06A.
+- Fixed: Deferred lease lifecycle, real non-default `--familiar` windows, heartbeat/release, fallback, and TTL cleanup to Phase 06B.
+- Fixed: Required status/manual docs to clearly distinguish configured `--familiar` from actual default-familiar target in Phase 06A.
 - Fixed: Switched SDK plan to stable `@modelcontextprotocol/sdk` instead of alpha split package.
-- Fixed: Required runtime dependencies for `@open-pets/client`, MCP SDK, and schema validation library.
+- Fixed: Required runtime dependencies for `@familiaros/client`, MCP SDK, and schema validation library.
 - Fixed: Promoted runtime dependency requirement into the package/server acceptance criteria.
 - Fixed: Corrected expected spec path and Phase 06A check wording after rename.
 - Fixed: Tightened package/npx acceptance: bin entry, shebang, executable compiled entry, no Bun, no stdout logs.
@@ -345,12 +345,12 @@ Oracle reviewed the initial Phase 06 plan and blocked calling it complete Phase
 - Fixed: Required sanitized degraded errors so local paths/tokens/raw Node details are not returned to agents.
 - Fixed: Required MCP contract check for tool list, invalid inputs, unavailable app behavior, and stdout protocol cleanliness.
 - Fixed: Clarified tool error semantics: unavailable app returns `isError: true` for say/react rather than crashing the server.
-- Deferred: Auto-launch of installed OpenPets app is explicitly left for Phase 06B or packaging phase.
+- Deferred: Auto-launch of installed FamiliarOS app is explicitly left for Phase 06B or packaging phase.
 
 Implementation review disposition:
 
 - Fixed: Replaced POSIX-only `chmod +x` build script with a Node-based post-build executable step that no-ops on Windows.
 - Fixed: Replaced POSIX `X_OK` contract assertion with shebang/bin validation.
-- Fixed: MCP package `check` builds `@open-pets/client` first so package-local checks do not depend on stale client `dist` output.
-- Fixed: Added stdio smoke contract coverage using the built `dist/index.js`, verifying tool list and degraded `openpets_status` with a missing discovery file.
-- Fixed: Unavailable `openpets_status` human text now still explains configured `--pet` and Phase 06A deferred routing.
+- Fixed: MCP package `check` builds `@familiaros/client` first so package-local checks do not depend on stale client `dist` output.
+- Fixed: Added stdio smoke contract coverage using the built `dist/index.js`, verifying tool list and degraded `familiaros_status` with a missing discovery file.
+- Fixed: Unavailable `familiaros_status` human text now still explains configured `--familiar` and Phase 06A deferred routing.
diff --git a/docs/phases/phase-06b-mcp-lease-lifecycle.md b/docs/phases/phase-06b-mcp-lease-lifecycle.md
index c563a4e8..67be60e5 100644
--- a/docs/phases/phase-06b-mcp-lease-lifecycle.md
+++ b/docs/phases/phase-06b-mcp-lease-lifecycle.md
@@ -1,15 +1,15 @@
-# Phase 06B: MCP lease lifecycle and explicit pet routing
+# Phase 06B: MCP lease lifecycle and explicit familiar routing
 
 ## Goal
 
-Complete the core MCP runtime behavior that Phase 06A intentionally deferred: MCP startup should acquire a desktop-app lease for the configured/default pet, explicit non-default `--pet` values should open temporary pet windows, leases should heartbeat while alive, and temporary explicit pets should close when their last active lease ends or expires.
+Complete the core MCP runtime behavior that Phase 06A intentionally deferred: MCP startup should acquire a desktop-app lease for the configured/default familiar, explicit non-default `--familiar` values should open temporary familiar windows, leases should heartbeat while alive, and temporary explicit familiars should close when their last active lease ends or expires.
 
 This phase turns the Phase 06A thin tool path into the real agent-neutral lifecycle described in `task.txt`:
 
 ```text
-@open-pets/mcp --pet snoopy starts
+@familiaros/mcp --familiar snoopy starts
   → desktop app receives lease.acquire
-  → snoopy window opens as temporary agent pet
+  → snoopy window opens as temporary agent familiar
   → tools target snoopy through lease id
   → MCP exits or crashes
   → release or TTL cleanup removes lease
@@ -21,10 +21,10 @@ This phase turns the Phase 06A thin tool path into the real agent-neutral lifecy
 - Claude Code detection/configuration UI.
 - Claude enhanced hooks.
 - Agent Setup window implementation.
-- Auto-launching installed OpenPets desktop app from MCP.
+- Auto-launching installed FamiliarOS desktop app from MCP.
 - Production packaging/release validation.
-- Pet install/remove/default tools exposed to agents.
-- Complex agent/session/workspace routing beyond one target pet per MCP process.
+- Familiar install/remove/default tools exposed to agents.
+- Complex agent/session/workspace routing beyond one target familiar per MCP process.
 - Remote HTTP/TCP MCP server.
 - Advanced animation engine.
 
@@ -32,12 +32,12 @@ This phase turns the Phase 06A thin tool path into the real agent-neutral lifecy
 
 After this phase:
 
-- Running `@open-pets/mcp` without `--pet` acquires a lease for the desktop default pet and tools affect the default pet.
-- Running `@open-pets/mcp --pet <installed-non-default-id>` opens that installed pet as a temporary agent pet and tools affect that pet.
+- Running `@familiaros/mcp` without `--familiar` acquires a lease for the desktop default familiar and tools affect the default familiar.
+- Running `@familiaros/mcp --familiar <installed-non-default-id>` opens that installed familiar as a temporary agent familiar and tools affect that familiar.
 - Quitting the MCP process releases the lease.
-- A temporary explicit non-default pet closes after the last active lease using it ends.
-- If MCP crashes, desktop TTL cleanup expires the orphaned lease and closes the temporary pet.
-- If `--pet` is missing or invalid/uninstalled, desktop falls back to the default pet and `openpets_status` reports the fallback clearly.
+- A temporary explicit non-default familiar closes after the last active lease using it ends.
+- If MCP crashes, desktop TTL cleanup expires the orphaned lease and closes the temporary familiar.
+- If `--familiar` is missing or invalid/uninstalled, desktop falls back to the default familiar and `familiaros_status` reports the fallback clearly.
 
 ## Acceptance criteria
 
@@ -45,17 +45,17 @@ After this phase:
   - `lease.acquire`
   - `lease.heartbeat`
   - `lease.release`
-  - lease-scoped `pet.react`
-  - lease-scoped `pet.say`
-- `@open-pets/client` exposes typed helpers for acquiring, heartbeating, releasing, status, say, and react with optional lease id.
-- `@open-pets/mcp` acquires a lease during startup after MCP server initialization, not on first tool call.
-- `@open-pets/mcp --pet <id>` sends requested pet id to `lease.acquire`.
-- `@open-pets/mcp` accepts a bounded raw `--pet` string and lets desktop validate/fallback; only values that exceed length/control-character limits are fatal CLI errors.
-- Raw `--pet` CLI bound: UTF-8 byte length must be 1-128 bytes and must not contain control characters, NUL, path separators, or whitespace-only content. Values that pass this bound but are not safe pet ids are sent to desktop and become `invalid_pet_id` fallback.
-- If `--pet` is omitted, lease acquisition targets the current desktop default pet.
-- If explicit `--pet` is installed and not broken, desktop opens/shows that pet as a temporary explicit agent pet.
-- If explicit `--pet` is missing, not installed, invalid, or broken, desktop falls back to built-in/current default pet and records fallback reason.
-- `openpets_status` reports:
+  - lease-scoped `familiar.react`
+  - lease-scoped `familiar.say`
+- `@familiaros/client` exposes typed helpers for acquiring, heartbeating, releasing, status, say, and react with optional lease id.
+- `@familiaros/mcp` acquires a lease during startup after MCP server initialization, not on first tool call.
+- `@familiaros/mcp --familiar <id>` sends requested familiar id to `lease.acquire`.
+- `@familiaros/mcp` accepts a bounded raw `--familiar` string and lets desktop validate/fallback; only values that exceed length/control-character limits are fatal CLI errors.
+- Raw `--familiar` CLI bound: UTF-8 byte length must be 1-128 bytes and must not contain control characters, NUL, path separators, or whitespace-only content. Values that pass this bound but are not safe familiar ids are sent to desktop and become `invalid_pet_id` fallback.
+- If `--familiar` is omitted, lease acquisition targets the current desktop default familiar.
+- If explicit `--familiar` is installed and not broken, desktop opens/shows that familiar as a temporary explicit agent familiar.
+- If explicit `--familiar` is missing, not installed, invalid, or broken, desktop falls back to built-in/current default familiar and records fallback reason.
+- `familiaros_status` reports:
   - `configuredPetId`
   - `leaseId`
   - `actualTargetPetId`
@@ -63,9 +63,9 @@ After this phase:
   - `usingDefaultPet`
   - `fallbackReason` when applicable
   - `routingImplemented: true`
-- `openpets_say` and `openpets_react` target the acquired lease's actual pet.
-- If lease acquisition fails because OpenPets is unavailable, MCP remains alive in degraded mode and `openpets_status` reports unavailable clearly.
-- In degraded mode, `openpets_say` and `openpets_react` return MCP tool errors without crashing the server.
+- `familiaros_say` and `familiaros_react` target the acquired lease's actual familiar.
+- If lease acquisition fails because FamiliarOS is unavailable, MCP remains alive in degraded mode and `familiaros_status` reports unavailable clearly.
+- In degraded mode, `familiaros_say` and `familiaros_react` return MCP tool errors without crashing the server.
 - MCP sends heartbeat while alive for an acquired lease.
 - MCP releases its lease on graceful shutdown paths where practical:
   - `SIGINT`
@@ -73,15 +73,15 @@ After this phase:
   - normal process exit path
   - stdio transport close when exposed by SDK/transport
 - Desktop expires stale leases by TTL if MCP crashes or release is not delivered.
-- Default pet remains persistent and is never auto-closed due to MCP lease release/expiry.
-- Explicit non-default pet windows close after the last active lease for that pet ends/expires.
-- Multiple MCP processes using the same explicit non-default pet keep one pet window open until all their leases end.
-- Multiple MCP processes using the default pet do not close the default pet on release.
-- Temporary explicit pet windows use local installed `spritesheet.webp` data URLs only; no remote images.
-- Temporary explicit pet windows are draggable and basic-positioned without needing final multi-monitor polish.
+- Default familiar remains persistent and is never auto-closed due to MCP lease release/expiry.
+- Explicit non-default familiar windows close after the last active lease for that familiar ends/expires.
+- Multiple MCP processes using the same explicit non-default familiar keep one familiar window open until all their leases end.
+- Multiple MCP processes using the default familiar do not close the default familiar on release.
+- Temporary explicit familiar windows use local installed `spritesheet.webp` data URLs only; no remote images.
+- Temporary explicit familiar windows are draggable and basic-positioned without needing final multi-monitor polish.
 - Operation is local-only; no TCP/HTTP.
-- Public MCP tool set remains exactly `openpets_status`, `openpets_say`, `openpets_react`.
-- No public MCP tool can install/remove/default pets, edit settings, access filesystem, run shell commands, or expose generic IPC.
+- Public MCP tool set remains exactly `familiaros_status`, `familiaros_say`, `familiaros_react`.
+- No public MCP tool can install/remove/default familiars, edit settings, access filesystem, run shell commands, or expose generic IPC.
 - Automated checks cover lease state transitions, fallback behavior, TTL cleanup logic, and MCP status mapping.
 
 ## Proposed files/directories
@@ -93,9 +93,9 @@ docs/phases/phase-06b-mcp-lease-lifecycle.md
 apps/desktop/src/local-ipc-protocol.ts
 apps/desktop/src/local-ipc.ts
 apps/desktop/src/lease-manager.ts
-apps/desktop/src/agent-pet-controller.ts
-apps/desktop/src/pet-window.ts
-apps/desktop/src/default-pet-controller.ts
+apps/desktop/src/agent-familiar-controller.ts
+apps/desktop/src/familiar-window.ts
+apps/desktop/src/default-familiar-controller.ts
 apps/desktop/src/app-state.ts (only if helper accessors are needed)
 apps/desktop/src/check-lease-manager.ts
 packages/client/src/index.ts
@@ -141,10 +141,10 @@ Use generated random lease ids from desktop app. Do not trust client-provided le
 
 Target-kind rules:
 
-- `targetKind: "default"` means tools route to the persistent default pet controller and release/expiry must never close the default pet.
-- `targetKind: "explicit"` means tools route to a temporary explicit non-default pet window and release/expiry participates in explicit pet refcount cleanup.
-- Fallback leases use `targetKind: "default"` even when the user requested an explicit pet.
-- If the desktop default changes after a `targetKind: "default"` lease is acquired, that lease continues to target the live default controller. Status should report the live current default pet as actual target.
+- `targetKind: "default"` means tools route to the persistent default familiar controller and release/expiry must never close the default familiar.
+- `targetKind: "explicit"` means tools route to a temporary explicit non-default familiar window and release/expiry participates in explicit familiar refcount cleanup.
+- Fallback leases use `targetKind: "default"` even when the user requested an explicit familiar.
+- If the desktop default changes after a `targetKind: "default"` lease is acquired, that lease continues to target the live default controller. Status should report the live current default familiar as actual target.
 
 ### Desktop target resolution
 
@@ -158,10 +158,10 @@ Target-kind rules:
 
 Resolution rules:
 
-1. If no `requestedPetId`, actual pet is current default pet.
-2. If requested pet is `builtin` or equals current default, actual pet is default pet and remains persistent. This check happens before installed-pet path helpers that reject `builtin`.
-3. If requested pet exists, is installed, is not broken, and is not built-in/default, actual pet is requested pet and its temporary window opens.
-4. If requested pet is missing/broken/invalid, actual pet is current default pet, `targetKind` is `default`, fallback reason is recorded, and status reports fallback.
+1. If no `requestedPetId`, actual familiar is current default familiar.
+2. If requested familiar is `builtin` or equals current default, actual familiar is default familiar and remains persistent. This check happens before installed-familiar path helpers that reject `builtin`.
+3. If requested familiar exists, is installed, is not broken, and is not built-in/default, actual familiar is requested familiar and its temporary window opens.
+4. If requested familiar is missing/broken/invalid, actual familiar is current default familiar, `targetKind` is `default`, fallback reason is recorded, and status reports fallback.
 5. If current default is somehow missing/broken, use built-in fallback.
 
 Fallback reasons must be short machine-readable codes, not raw exception text or local paths:
@@ -208,19 +208,19 @@ Stale status shape:
 }
 ```
 
-### Pet windows
+### Familiar windows
 
-Current default pet window remains controlled by `default-pet-controller.ts`.
+Current default familiar window remains controlled by `default-familiar-controller.ts`.
 
-Add a separate agent/leased pet controller for explicit non-default pets:
+Add a separate agent/leased familiar controller for explicit non-default familiars:
 
-- One `BrowserWindow` per explicit non-default pet id.
-- Window uses a safe rendering helper that takes an explicit pet id and reads only local installed `spritesheet.webp` as a data URL.
-- Initial position offsets from the default pet/primary work area so temporary pets do not fully overlap.
-- Windows are always-on-top/frameless/transparent like default pet.
-- Temporary pet windows use `showInactive` / non-focus-stealing behavior like the default pet.
-- Position persistence for temporary agent pets is not required in Phase 06B.
-- Close temporary window when no active lease targets that pet.
+- One `BrowserWindow` per explicit non-default familiar id.
+- Window uses a safe rendering helper that takes an explicit familiar id and reads only local installed `spritesheet.webp` as a data URL.
+- Initial position offsets from the default familiar/primary work area so temporary familiars do not fully overlap.
+- Windows are always-on-top/frameless/transparent like default familiar.
+- Temporary familiar windows use `showInactive` / non-focus-stealing behavior like the default familiar.
+- Position persistence for temporary agent familiars is not required in Phase 06B.
+- Close temporary window when no active lease targets that familiar.
 
 Avoid storing remote URLs or absolute paths in durable state.
 
@@ -232,11 +232,11 @@ Extend Phase 05 request methods:
 lease.acquire
 lease.heartbeat
 lease.release
-pet.react
-pet.say
+familiar.react
+familiar.say
 ```
 
-`pet.react` and `pet.say` should accept optional `leaseId`; without a lease id they keep Phase 05 default-pet behavior for backward compatibility.
+`familiar.react` and `familiar.say` should accept optional `leaseId`; without a lease id they keep Phase 05 default-familiar behavior for backward compatibility.
 
 Validation:
 
@@ -274,8 +274,8 @@ MCP startup flow:
 
 Tool behavior:
 
-- `openpets_status` reports lease/degraded state.
-- `openpets_say`/`openpets_react` require an active lease to target explicit/default pet; if no lease, return `isError: true` with clear unavailable guidance.
+- `familiaros_status` reports lease/degraded state.
+- `familiaros_say`/`familiaros_react` require an active lease to target explicit/default familiar; if no lease, return `isError: true` with clear unavailable guidance.
 
 Shutdown:
 
@@ -291,18 +291,18 @@ Do not write diagnostics to stdout.
 
 ### Auto-launch
 
-Auto-launch of installed OpenPets desktop app remains deferred. It is important product behavior, but packaging/app discovery is not mature enough yet. Phase 06B focuses on lease lifecycle when the app is already running.
+Auto-launch of installed FamiliarOS desktop app remains deferred. It is important product behavior, but packaging/app discovery is not mature enough yet. Phase 06B focuses on lease lifecycle when the app is already running.
 
 ## Risks and tradeoffs
 
-### Risk: phase grows into multi-pet architecture refactor
+### Risk: phase grows into multi-familiar architecture refactor
 
 Mitigation:
 
-- Keep Phase 06B to temporary explicit pet windows only.
-- Do not implement user-pinned non-default pets beyond leases.
-- Do not add persistent positions for temporary pets.
-- Split again if full multi-pet manager changes become necessary.
+- Keep Phase 06B to temporary explicit familiar windows only.
+- Do not implement user-pinned non-default familiars beyond leases.
+- Do not add persistent positions for temporary familiars.
+- Split again if full multi-familiar manager changes become necessary.
 
 ### Risk: orphaned windows after MCP crash
 
@@ -311,20 +311,20 @@ Mitigation:
 - Desktop TTL cleanup is mandatory.
 - MCP release is best-effort, not the only cleanup path.
 
-### Risk: wrong pet targeted
+### Risk: wrong familiar targeted
 
 Mitigation:
 
 - Desktop owns requested→actual resolution.
-- `openpets_status` reports requested/configured and actual target.
-- Missing/broken explicit pets fall back to default with reason.
-- `targetKind` separates persistent default-controller routing from explicit temporary pet-window routing.
+- `familiaros_status` reports requested/configured and actual target.
+- Missing/broken explicit familiars fall back to default with reason.
+- `targetKind` separates persistent default-controller routing from explicit temporary familiar-window routing.
 
 ### Risk: privacy/spam through lease-scoped speech
 
 Mitigation:
 
-- Reuse existing `pet.say` validation and speech settings.
+- Reuse existing `familiar.say` validation and speech settings.
 - Keep transient message replacement behavior; no unbounded queue.
 
 ## Security/privacy notes
@@ -334,7 +334,7 @@ Mitigation:
 - Fallback reasons are sanitized machine-readable codes only.
 - No remote API.
 - No shell execution.
-- No pet installation/removal/default mutation exposed to agents.
+- No familiar installation/removal/default mutation exposed to agents.
 - Speech safety rules still apply.
 - No durable agent session state is persisted.
 
@@ -344,17 +344,17 @@ Automated checks:
 
 ```bash
 pnpm check
-pnpm --filter @open-pets/desktop check
-pnpm --filter @open-pets/client check
-pnpm --filter @open-pets/mcp check
+pnpm --filter @familiaros/desktop check
+pnpm --filter @familiaros/client check
+pnpm --filter @familiaros/mcp check
 ```
 
 Phase 06B should add checks for:
 
 - Lease acquire default target.
 - Lease acquire explicit installed target.
-- Invalid CLI `--pet` string is passed to desktop fallback path when bounded.
-- Missing/broken requested pet fallback.
+- Invalid CLI `--familiar` string is passed to desktop fallback path when bounded.
+- Missing/broken requested familiar fallback.
 - Heartbeat extends expiry.
 - Heartbeat unknown lease returns structured stale/degraded behavior.
 - Release removes lease.
@@ -362,9 +362,9 @@ Phase 06B should add checks for:
 - TTL cleanup expires stale lease.
 - Status for expired lease reports stale/degraded behavior.
 - Status/errors do not leak local paths/tokens/raw filesystem messages.
-- Last lease release/expiry closes explicit temporary pet controller state.
-- Multiple leases for same explicit pet keep that window until the final lease ends.
-- Default pet lease release/expiry does not close persistent default pet.
+- Last lease release/expiry closes explicit temporary familiar controller state.
+- Multiple leases for same explicit familiar keep that window until the final lease ends.
+- Default familiar lease release/expiry does not close persistent default familiar.
 - Unknown/expired lease id rejects lease-scoped say/react.
 - MCP status maps configured/requested/actual/fallback/routing fields correctly.
 - MCP say/react checks prove handlers wait for lease init and pass `leaseId` to the client.
@@ -374,74 +374,74 @@ Phase 06B should add checks for:
 1. Start desktop:
 
    ```bash
-   pnpm --filter @open-pets/desktop dev
+   pnpm --filter @familiaros/desktop dev
    ```
 
-2. Ensure at least one extra pet is installed from Pet Manager, for example `snoopy`.
+2. Ensure at least one extra familiar is installed from Familiar Manager, for example `snoopy`.
 
-3. Run MCP without `--pet` in an MCP inspector/client:
+3. Run MCP without `--familiar` in an MCP inspector/client:
 
    ```bash
    node packages/mcp/dist/index.js
    ```
 
-4. Call `openpets_status`; confirm it reports the current default pet as actual target and `routingImplemented: true`.
+4. Call `familiaros_status`; confirm it reports the current default familiar as actual target and `routingImplemented: true`.
 
-5. Call `openpets_react` / `openpets_say`; confirm the default pet reacts/says.
+5. Call `familiaros_react` / `familiaros_say`; confirm the default familiar reacts/says.
 
-6. Run MCP with explicit installed pet:
+6. Run MCP with explicit installed familiar:
 
    ```bash
-   node packages/mcp/dist/index.js --pet snoopy
+   node packages/mcp/dist/index.js --familiar snoopy
    ```
 
-7. Confirm Snoopy opens as a separate temporary pet window and status reports actual target `snoopy`.
+7. Confirm Snoopy opens as a separate temporary familiar window and status reports actual target `snoopy`.
 
-8. Call `openpets_react` / `openpets_say`; confirm Snoopy reacts/says, not the default pet.
+8. Call `familiaros_react` / `familiaros_say`; confirm Snoopy reacts/says, not the default familiar.
 
-9. Stop the MCP process; confirm Snoopy closes after release/cleanup while the default pet remains.
+9. Stop the MCP process; confirm Snoopy closes after release/cleanup while the default familiar remains.
 
-10. Start two MCP processes for the same explicit pet; confirm closing one keeps the temp pet open and closing both closes it.
+10. Start two MCP processes for the same explicit familiar; confirm closing one keeps the temp familiar open and closing both closes it.
 
-11. Hard-kill/abruptly close one MCP process for an explicit pet; wait for TTL cleanup and confirm the temp pet closes.
+11. Hard-kill/abruptly close one MCP process for an explicit familiar; wait for TTL cleanup and confirm the temp familiar closes.
 
-12. Run MCP with missing pet:
+12. Run MCP with missing familiar:
 
     ```bash
-    node packages/mcp/dist/index.js --pet does-not-exist
+    node packages/mcp/dist/index.js --familiar does-not-exist
     ```
 
-13. Confirm status reports fallback to default pet and tools affect the default pet.
+13. Confirm status reports fallback to default familiar and tools affect the default familiar.
 
-14. Run MCP with malformed-but-bounded pet input and confirm desktop fallback is reported rather than exposing local errors.
+14. Run MCP with malformed-but-bounded familiar input and confirm desktop fallback is reported rather than exposing local errors.
 
 Manual acceptance question:
 
 ```text
-Does Phase 06B pass on your machine: MCP startup acquires leases, --pet opens an installed non-default temporary pet, tools target the leased pet, missing pets fall back clearly, and release/TTL cleanup closes only temporary explicit pets?
+Does Phase 06B pass on your machine: MCP startup acquires leases, --familiar opens an installed non-default temporary familiar, tools target the leased familiar, missing familiars fall back clearly, and release/TTL cleanup closes only temporary explicit familiars?
 ```
 
 ## Oracle plan review
 
-Oracle reviewed the initial Phase 06B plan and approved the overall architecture, but blocked implementation until `--pet` fallback behavior and default-versus-explicit lease targeting were sharpened.
+Oracle reviewed the initial Phase 06B plan and approved the overall architecture, but blocked implementation until `--familiar` fallback behavior and default-versus-explicit lease targeting were sharpened.
 
 ## Oracle feedback disposition
 
-- Fixed: `@open-pets/mcp` should accept bounded raw `--pet` strings and let desktop validate/fallback, so invalid/uninstalled requested pets can follow product fallback behavior.
-- Fixed: Added `targetKind: "default" | "explicit"` to distinguish persistent default-controller leases from explicit temporary pet-window leases.
+- Fixed: `@familiaros/mcp` should accept bounded raw `--familiar` strings and let desktop validate/fallback, so invalid/uninstalled requested familiars can follow product fallback behavior.
+- Fixed: Added `targetKind: "default" | "explicit"` to distinguish persistent default-controller leases from explicit temporary familiar-window leases.
 - Fixed: Defined IPC/result contracts for acquire, heartbeat, release, and lease-scoped status.
 - Fixed: Defined unknown heartbeat, idempotent release, and expired lease status behavior.
 - Fixed: Required lease-initialization promise so tools cannot race ahead of startup acquisition.
 - Fixed: Required heartbeat timer `unref()`, caught heartbeat failures, stale/degraded marking, and no reliance on async `exit` handlers.
 - Fixed: Required sanitized machine-readable fallback reason codes only.
-- Fixed: Required explicit-pet rendering helper that reads only local installed `spritesheet.webp` for a given pet id.
-- Fixed: Expanded automated and manual tests for invalid `--pet`, release idempotency, unknown heartbeat, expired status, leakage prevention, multi-lease refcount, crash TTL cleanup, and default-pet persistence.
-- Fixed: Defined exact raw `--pet` bounds and control/path/whitespace rejection before desktop fallback.
+- Fixed: Required explicit-familiar rendering helper that reads only local installed `spritesheet.webp` for a given familiar id.
+- Fixed: Expanded automated and manual tests for invalid `--familiar`, release idempotency, unknown heartbeat, expired status, leakage prevention, multi-lease refcount, crash TTL cleanup, and default-familiar persistence.
+- Fixed: Defined exact raw `--familiar` bounds and control/path/whitespace rejection before desktop fallback.
 - Fixed: Defined stale `status({ leaseId })` response shape.
-- Fixed: Required built-in/default requested ids to be special-cased before installed-pet path validation.
+- Fixed: Required built-in/default requested ids to be special-cased before installed-familiar path validation.
 - Fixed: Clarified default-target leases report the live current default controller target if default changes after acquisition.
 - Fixed: Required MCP say/react checks proving lease-init waiting and lease id forwarding.
-- Fixed: Required temporary pet windows to use non-focus-stealing `showInactive` behavior.
+- Fixed: Required temporary familiar windows to use non-focus-stealing `showInactive` behavior.
 - Fixed: Required heartbeat timer to stop after unknown/stale lease.
 
 Implementation review disposition:
@@ -449,13 +449,13 @@ Implementation review disposition:
 - Fixed: `LeaseManager.heartbeat()` and `get()` now reject/remove expired leases before cleanup can revive or use them.
 - Fixed: MCP status now preserves stale/unknown lease state instead of reporting cached active leases.
 - Fixed: MCP degraded reasons used in tool errors are sanitized before returning to agents.
-- Fixed: Explicit leases preserve `targetKind: "explicit"` for their lifetime instead of downcasting if the pet later becomes default.
-- Fixed: Explicit pet say/react respect paused and speech-disabled behavior through IPC before updating temporary windows.
-- Fixed: Explicit pet rendering errors are caught/logged to avoid unhandled rejections.
+- Fixed: Explicit leases preserve `targetKind: "explicit"` for their lifetime instead of downcasting if the familiar later becomes default.
+- Fixed: Explicit familiar say/react respect paused and speech-disabled behavior through IPC before updating temporary windows.
+- Fixed: Explicit familiar rendering errors are caught/logged to avoid unhandled rejections.
 - Fixed: `default_broken_fallback_builtin` fallback reason is emitted when the configured default is unusable.
-- Fixed: Raw `--pet` bounds reject all control characters.
+- Fixed: Raw `--familiar` bounds reject all control characters.
 - Deferred: Additional transport-close release handling beyond signals remains useful, but current release plus desktop TTL cleanup is sufficient for Phase 06B manual verification.
 - Fixed: MCP status prefers live desktop lease status fields over cached acquire-time lease data when available.
 - Fixed: Unavailable/degraded MCP status still reports `routingImplemented: true` for Phase 06B.
-- Fixed: MCP help text now describes real `--pet` routing and fallback instead of stale Phase 06A behavior.
+- Fixed: MCP help text now describes real `--familiar` routing and fallback instead of stale Phase 06A behavior.
 - Fixed: Added best-effort release on stdio transport close in addition to signal handling.
diff --git a/docs/phases/phase-07-claude-detection-configuration.md b/docs/phases/phase-07-claude-detection-configuration.md
index c7ddbfab..00168e9c 100644
--- a/docs/phases/phase-07-claude-detection-configuration.md
+++ b/docs/phases/phase-07-claude-detection-configuration.md
@@ -2,7 +2,7 @@
 
 ## Goal
 
-Implement the first real Agent Setup experience for Claude Code: detect whether Claude Code appears available, show current OpenPets MCP configuration status, preview the exact MCP configuration command/file shape, and apply/remove a safe MCP configuration only after explicit user confirmation.
+Implement the first real Agent Setup experience for Claude Code: detect whether Claude Code appears available, show current FamiliarOS MCP configuration status, preview the exact MCP configuration command/file shape, and apply/remove a safe MCP configuration only after explicit user confirmation.
 
 This phase makes Claude Code usable with the Phase 06 MCP lease routing path. It does not implement Claude hooks yet.
 
@@ -11,7 +11,7 @@ This phase makes Claude Code usable with the Phase 06 MCP lease routing path. It
 - No Claude hook install, uninstall, or hook event handling. That belongs in Phase 08.
 - No Cursor, VS Code, Windsurf, OpenCode, or Antigravity configuration.
 - No automatic silent edits during onboarding or app launch.
-- No agent-managed pet installation/removal/default-pet changes.
+- No agent-managed familiar installation/removal/default-familiar changes.
 - No attempt to parse or preserve every undocumented field in Claude's internal `~/.claude.json`; prefer official CLI commands for writes.
 - No auto-launch of Claude Code itself.
 
@@ -20,11 +20,11 @@ This phase makes Claude Code usable with the Phase 06 MCP lease routing path. It
 From the tray menu, **Configure Agents...** opens a real Claude Code setup window instead of a placeholder. The user can:
 
 - See Claude Code as detected, not detected, configured, needs setup, or error.
-- See the OpenPets MCP command that will be configured.
-- Choose default-pet routing or an explicit installed pet for the Claude MCP server.
+- See the FamiliarOS MCP command that will be configured.
+- Choose default-familiar routing or an explicit installed familiar for the Claude MCP server.
 - Run a doctor/check to see actionable status.
 - Click Configure only after seeing the planned change.
-- Remove the OpenPets MCP entry if it was configured by OpenPets.
+- Remove the FamiliarOS MCP entry if it was configured by FamiliarOS.
 
 ## Acceptance criteria
 
@@ -39,33 +39,33 @@ From the tray menu, **Configure Agents...** opens a real Claude Code setup windo
   - Check MCP status using `claude mcp list` with a short timeout when Claude is available.
   - If Claude is missing or commands fail, report actionable text without crashing the app.
 - Configuration target for Phase 07 is Claude Code user scope using the official CLI:
-  - `claude mcp add --scope user openpets -- npx -y @open-pets/mcp`
-  - With explicit pet: `claude mcp add --scope user openpets -- npx -y @open-pets/mcp --pet <petId>`
+  - `claude mcp add --scope user familiaros -- npx -y @familiaros/mcp`
+  - With explicit familiar: `claude mcp add --scope user familiaros -- npx -y @familiaros/mcp --familiar <petId>`
 - Preview shows the exact command and the equivalent intended MCP JSON shape before applying.
 - Configure requires an explicit button click in the UI.
 - Removal requires an explicit button click in the UI and uses:
-  - `claude mcp remove --scope user openpets`
-- Remove is enabled only when Claude reports an `openpets` MCP entry. If the entry cannot be verified as OpenPets-managed, the UI must warn that it will remove any Claude MCP server named `openpets`.
+  - `claude mcp remove --scope user familiaros`
+- Remove is enabled only when Claude reports an `familiaros` MCP entry. If the entry cannot be verified as FamiliarOS-managed, the UI must warn that it will remove any Claude MCP server named `familiaros`.
 - Config operations are conservative and idempotent where Claude exposes enough detail:
-  - If Claude reports an `openpets` MCP entry and a detail command/output lets OpenPets verify the command/args match, Configure reports already configured / no change.
-  - If Claude only reports `openpets` as present but does not expose reliable command/arg detail, Configure reports `Configured / needs manual verification` rather than replacing it.
-  - If an `openpets` MCP entry exists but differs or cannot be verified, OpenPets must not automatically remove it. The UI must show a separate Replace action with a strong warning before remove-then-add.
-  - If Replace removes an entry but add fails, OpenPets shows a clear failure and the action journal contains the previous detected summary and intended restore command; no OAuth/session config restoration is attempted.
-- Backups/restore behavior is defined and implemented for the files OpenPets directly edits.
-  - Because Phase 07 writes via the Claude CLI rather than directly editing `~/.claude.json`, OpenPets should not create a misleading full backup of that internal file by default.
-  - OpenPets records a local configuration action journal with timestamp, command preview, selected pet, and previous detected status where available.
-  - Restore behavior for Phase 07 is removal of the OpenPets MCP server entry through `claude mcp remove --scope user openpets`; it does not attempt to restore OAuth/session internals.
+  - If Claude reports an `familiaros` MCP entry and a detail command/output lets FamiliarOS verify the command/args match, Configure reports already configured / no change.
+  - If Claude only reports `familiaros` as present but does not expose reliable command/arg detail, Configure reports `Configured / needs manual verification` rather than replacing it.
+  - If an `familiaros` MCP entry exists but differs or cannot be verified, FamiliarOS must not automatically remove it. The UI must show a separate Replace action with a strong warning before remove-then-add.
+  - If Replace removes an entry but add fails, FamiliarOS shows a clear failure and the action journal contains the previous detected summary and intended restore command; no OAuth/session config restoration is attempted.
+- Backups/restore behavior is defined and implemented for the files FamiliarOS directly edits.
+  - Because Phase 07 writes via the Claude CLI rather than directly editing `~/.claude.json`, FamiliarOS should not create a misleading full backup of that internal file by default.
+  - FamiliarOS records a local configuration action journal with timestamp, command preview, selected familiar, and previous detected status where available.
+  - Restore behavior for Phase 07 is removal of the FamiliarOS MCP server entry through `claude mcp remove --scope user familiaros`; it does not attempt to restore OAuth/session internals.
 - Doctor/check reports:
   - Whether `claude` is found.
   - Whether `claude --version` works.
   - Whether `claude mcp list` works.
-  - Whether an `openpets` MCP entry appears present.
-  - What command OpenPets expects.
+  - Whether an `familiaros` MCP entry appears present.
+  - What command FamiliarOS expects.
   - That Claude Code may need restart/reload for MCP changes to take effect.
 - UI is CSP-safe and uses Electron IPC handlers with sender checks.
-- Renderer/main IPC is narrow: renderer sends only action names and `{ selectedPetId?: string }`; main constructs argv, revalidates selected pet against installed non-broken pets, and enforces sender checks for the Agent Setup window.
+- Renderer/main IPC is narrow: renderer sends only action names and `{ selectedPetId?: string }`; main constructs argv, revalidates selected familiar against installed non-broken familiars, and enforces sender checks for the Agent Setup window.
 - Configure/remove/replace operations are serialized so concurrent clicks cannot run overlapping Claude CLI commands.
-- Automated checks cover command construction, pet id argument handling, status parsing, and timeout/error classification.
+- Automated checks cover command construction, familiar id argument handling, status parsing, and timeout/error classification.
 - `pnpm check` passes.
 
 ## Proposed files/directories
@@ -83,7 +83,7 @@ From the tray menu, **Configure Agents...** opens a real Claude Code setup windo
 - `apps/desktop/src/windows.ts`
   - Replace Agent Setup placeholder with real Claude setup UI and preload access.
 - `apps/desktop/preload.cjs`
-  - Expose narrow `openpetsAgentSetup` methods to renderer, separate from broader app/window APIs.
+  - Expose narrow `familiarosAgentSetup` methods to renderer, separate from broader app/window APIs.
 - `apps/desktop/src/app-state.ts` or adjacent state helper
   - Persist lightweight agent setup status/action journal if needed.
 - `docs/phases/phase-07-claude-detection-configuration.md`
@@ -95,16 +95,16 @@ From the tray menu, **Configure Agents...** opens a real Claude Code setup windo
 Phase 07 configures the universal MCP path already built in Phase 06:
 
 ```text
-Claude Code → @open-pets/mcp → @open-pets/client → desktop IPC → pet lease
+Claude Code → @familiaros/mcp → @familiaros/client → desktop IPC → familiar lease
 ```
 
 Use a single MCP server name:
 
 ```text
-openpets
+familiaros
 ```
 
-Use user scope first because OpenPets is a personal companion integration and should not silently create team/project files. Project-scoped `.mcp.json` and per-project pet choices can be documented later.
+Use user scope first because FamiliarOS is a personal companion integration and should not silently create team/project files. Project-scoped `.mcp.json` and per-project familiar choices can be documented later.
 
 ### Detection
 
@@ -117,8 +117,8 @@ Best-effort command sequence:
    - macOS GUI apps may have a reduced `PATH`; include common Homebrew/npm paths such as `/opt/homebrew/bin`, `/usr/local/bin`, and inherited `PATH` entries.
    - Windows may expose `claude.cmd`; command resolution should try `claude` and `claude.cmd` where appropriate.
 3. Run `claude mcp list` if version works.
-4. If an official/detail command is available and works (for example `claude mcp get openpets` or a future JSON output), use it to verify command/args. Otherwise treat list output as present/absent only.
-5. Parse output conservatively for an `openpets` entry.
+4. If an official/detail command is available and works (for example `claude mcp get familiaros` or a future JSON output), use it to verify command/args. Otherwise treat list output as present/absent only.
+5. Parse output conservatively for an `familiaros` entry.
 6. Return a structured result to the UI.
 
 Each child process should:
@@ -131,27 +131,27 @@ Each child process should:
 
 ### Command construction
 
-Centralize command construction in `@open-pets/claude` so tests can verify it without Electron:
+Centralize command construction in `@familiaros/claude` so tests can verify it without Electron:
 
-Default pet:
+Default familiar:
 
 ```bash
-claude mcp add --scope user openpets -- npx -y @open-pets/mcp
+claude mcp add --scope user familiaros -- npx -y @familiaros/mcp
 ```
 
-Explicit pet:
+Explicit familiar:
 
 ```bash
-claude mcp add --scope user openpets -- npx -y @open-pets/mcp --pet snoopy
+claude mcp add --scope user familiaros -- npx -y @familiaros/mcp --familiar snoopy
 ```
 
 Removal:
 
 ```bash
-claude mcp remove --scope user openpets
+claude mcp remove --scope user familiaros
 ```
 
-Pet id values come from installed OpenPets pet ids in app state, not free-form UI entry. This avoids quoting/shell-injection complexity and aligns with the product rule that agents do not install/remove pets.
+Familiar id values come from installed FamiliarOS familiar ids in app state, not free-form UI entry. This avoids quoting/shell-injection complexity and aligns with the product rule that agents do not install/remove familiars.
 
 ### Preview
 
@@ -164,76 +164,76 @@ Before applying, show:
 ```json
 {
   "mcpServers": {
-    "openpets": {
+    "familiaros": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@open-pets/mcp"]
+      "args": ["-y", "@familiaros/mcp"]
     }
   }
 }
 ```
 
-With explicit pet:
+With explicit familiar:
 
 ```json
-"args": ["-y", "@open-pets/mcp", "--pet", "snoopy"]
+"args": ["-y", "@familiaros/mcp", "--familiar", "snoopy"]
 ```
 
 ### Applying changes
 
 Use Claude Code's official CLI rather than directly editing `~/.claude.json`:
 
-- Configure new entry: `claude mcp add --scope user openpets -- ...`
+- Configure new entry: `claude mcp add --scope user familiaros -- ...`
 - Update existing differing or unverifiable entry: only through a separate explicit Replace action with warning text.
-- Remove OpenPets entry: `claude mcp remove --scope user openpets`.
+- Remove FamiliarOS entry: `claude mcp remove --scope user familiaros`.
 
 If configure/remove commands fail before making changes, show the sanitized stderr/stdout summary and leave state unchanged.
 
-Exception: Replace is a two-step remove-then-add flow. If remove succeeds but add fails, Claude config has already changed; the UI must state that the previous `openpets` entry was removed and show the intended restore/add command from the action journal.
+Exception: Replace is a two-step remove-then-add flow. If remove succeeds but add fails, Claude config has already changed; the UI must state that the previous `familiaros` entry was removed and show the intended restore/add command from the action journal.
 
 The UI should include a **Copy command** fallback so users can apply configuration manually if Claude CLI invocation from the Electron app fails because of PATH, permissions, or shell environment differences.
 
 ### Action journal and restore
 
-Because user-scope MCP config lives inside Claude's internal `~/.claude.json`, which may include OAuth/session/private state, Phase 07 should not copy the whole file into OpenPets backups by default.
+Because user-scope MCP config lives inside Claude's internal `~/.claude.json`, which may include OAuth/session/private state, Phase 07 should not copy the whole file into FamiliarOS backups by default.
 
-Instead, persist an OpenPets-local action journal entry for each attempted configuration/removal:
+Instead, persist an FamiliarOS-local action journal entry for each attempted configuration/removal:
 
 - timestamp
 - action: configure/update/replace/remove
-- selected pet id or default
+- selected familiar id or default
 - command argv preview
-- detected previous OpenPets status, if known
+- detected previous FamiliarOS status, if known
 - success/failure and sanitized message
 
 Location:
 
 ```text
-<OpenPets userData>/agent-setup-actions.json
+<FamiliarOS userData>/agent-setup-actions.json
 ```
 
 Journal entries must be bounded and sanitized:
 
 - Keep only the latest 20 entries.
-- Store argv arrays and OpenPets status labels.
+- Store argv arrays and FamiliarOS status labels.
 - Store sanitized output summaries capped at 500 characters.
 - Do not store raw Claude config files, OAuth/session data, full stdout/stderr, home-directory paths, tokens, or environment variables.
 
 During implementation, verify current `claude mcp` CLI syntax against official docs/help output before wiring writes. If a detail/get command or output format is unavailable or unexpected, fail closed: classify the entry as present but unverifiable and require manual review/Replace rather than assuming ownership.
 
-Restore path in Phase 07 is explicit uninstall/remove of the OpenPets MCP entry via Claude CLI.
+Restore path in Phase 07 is explicit uninstall/remove of the FamiliarOS MCP entry via Claude CLI.
 
 ### UI shape
 
-Agent Setup can stay lightweight and inline-data-URL based for now, matching existing Pet Manager/Settings style:
+Agent Setup can stay lightweight and inline-data-URL based for now, matching existing Familiar Manager/Settings style:
 
 - Header: Configure Agents
 - Claude Code card
 - Status badge and details
-- Pet selection dropdown: Default pet + installed non-broken pets
+- Familiar selection dropdown: Default familiar + installed non-broken familiars
 - Preview box
 - Buttons: Refresh / Doctor, Configure, Remove
-- If an existing `openpets` MCP entry is present but unverifiable/different, show a separate Replace action with stronger warning copy instead of silently changing it.
+- If an existing `familiaros` MCP entry is present but unverifiable/different, show a separate Replace action with stronger warning copy instead of silently changing it.
 - Copy command fallback.
 - Note: restart Claude Code if MCP changes do not appear immediately.
 
@@ -241,17 +241,17 @@ Agent Setup can stay lightweight and inline-data-URL based for now, matching exi
 
 - Claude Code config behavior can change. Mitigation: use official CLI commands where possible and keep parsing conservative.
 - `claude mcp list` output may not be stable. Mitigation: use it for status hints only; failed parsing reports needs manual check rather than corrupting config.
-- Existing user config could be lost if OpenPets blindly removes an `openpets` entry. Mitigation: no automatic replacement; require explicit Replace with warning and action journal.
+- Existing user config could be lost if FamiliarOS blindly removes an `familiaros` entry. Mitigation: no automatic replacement; require explicit Replace with warning and action journal.
 - User-scope config is personal and may contain secrets. Mitigation: do not directly edit or back up full `~/.claude.json` in Phase 07.
-- `npx -y @open-pets/mcp` may use a published package in real installs, while local dev uses workspace packages. Mitigation: Phase 07 config preview targets the final product command; manual dev verification can inspect command preview without requiring published package behavior.
+- `npx -y @familiaros/mcp` may use a published package in real installs, while local dev uses workspace packages. Mitigation: Phase 07 config preview targets the final product command; manual dev verification can inspect command preview without requiring published package behavior.
 - Windows may need command resolution differences. Mitigation: command discovery tries platform variants, uses argv arrays, and includes Windows samples in checks.
 
 ## Security/privacy notes
 
 - No shell string execution for user-controlled values.
-- Pet choice is constrained to installed pet ids from app state.
+- Familiar choice is constrained to installed familiar ids from app state.
 - Renderer gets only narrow IPC methods for agent setup.
-- Main process revalidates selected pet id and never trusts renderer-supplied command/argv.
+- Main process revalidates selected familiar id and never trusts renderer-supplied command/argv.
 - Sanitize child-process output before showing it in UI; bound max displayed length.
 - Do not expose Claude config file contents or OAuth/session material in UI or logs.
 - No silent configuration changes; user must click Configure/Remove.
@@ -259,14 +259,14 @@ Agent Setup can stay lightweight and inline-data-URL based for now, matching exi
 ## Test/check plan
 
 - `packages/claude` contract checks:
-  - command argv for default pet.
-  - command argv for explicit pet.
+  - command argv for default familiar.
+  - command argv for explicit familiar.
   - remove argv.
   - equivalent JSON preview.
   - MCP list parsing for present/missing/error-ish samples.
   - unverifiable existing entry classification.
   - Windows/macOS command discovery/path sample helpers where factored.
-  - invalid/free-form pet id rejection when using helper directly.
+  - invalid/free-form familiar id rejection when using helper directly.
 - Desktop checks:
   - Agent setup IPC renderer sender restrictions.
   - Command result timeout/error classification helper if factored separately.
@@ -279,32 +279,32 @@ Agent Setup can stay lightweight and inline-data-URL based for now, matching exi
 After implementation:
 
 1. Run `pnpm check`.
-2. Start desktop: `pnpm --filter @open-pets/desktop dev`.
+2. Start desktop: `pnpm --filter @familiaros/desktop dev`.
 3. Open tray → **Configure Agents...**.
 4. Confirm Claude Code status appears and does not crash whether Claude is installed or not.
-5. Choose default pet and inspect preview.
-6. Choose an installed non-default pet and confirm preview adds `--pet <id>`.
+5. Choose default familiar and inspect preview.
+6. Choose an installed non-default familiar and confirm preview adds `--familiar <id>`.
 7. Use Copy command to verify the manual fallback text is correct.
 8. Click Configure only if you are comfortable modifying your Claude Code user MCP config.
-9. Run `claude mcp list` separately and confirm `openpets` appears.
-10. If using an unpublished local package, do not expect a real Claude session to load `npx -y @open-pets/mcp` until the package is available; treat command/config preview and `claude mcp list` as the Phase 07 verification target.
-11. Restart/open Claude Code and confirm OpenPets MCP tools appear only if the package is published or your dev environment routes the package name locally.
-12. Click Remove and confirm `claude mcp list` no longer shows `openpets`.
+9. Run `claude mcp list` separately and confirm `familiaros` appears.
+10. If using an unpublished local package, do not expect a real Claude session to load `npx -y @familiaros/mcp` until the package is available; treat command/config preview and `claude mcp list` as the Phase 07 verification target.
+11. Restart/open Claude Code and confirm FamiliarOS MCP tools appear only if the package is published or your dev environment routes the package name locally.
+12. Click Remove and confirm `claude mcp list` no longer shows `familiaros`.
 13. Optional safer test: create a fake `claude` executable earlier in `PATH` that records argv and returns sample `mcp list` output; launch the desktop app from that terminal so the modified `PATH` is inherited; use it to verify missing Claude, successful add, failed add, existing entry, replace warning, and remove flows without touching real Claude config.
 
 Expected results:
 
 - Detection and doctor statuses are actionable.
-- Preview matches the command OpenPets runs.
+- Preview matches the command FamiliarOS runs.
 - Configure/remove are explicit and idempotent.
-- OpenPets does not edit Claude config silently.
+- FamiliarOS does not edit Claude config silently.
 
 ## Oracle plan review
 
 Reviewed. Oracle found the phase boundary and official-CLI direction sound, but flagged two blockers:
 
 - Idempotency/update detection was underspecified because `claude mcp list` may not reliably prove command/args match.
-- Remove-then-add could lose an existing user `openpets` config if add fails.
+- Remove-then-add could lose an existing user `familiaros` config if add fails.
 
 Oracle also requested clearer remove semantics, platform command discovery, stricter renderer/main IPC rules, action journal schema/location, operation locking/timeouts, safer manual verification, and not promising real MCP tools appear before package publishing/dev override exists.
 
@@ -316,7 +316,7 @@ Fixed:
 - Added explicit Replace action for unverifiable/different existing entries; no automatic remove-then-add.
 - Defined Remove warning semantics for unverifiable entries.
 - Added macOS GUI PATH and Windows `claude.cmd` discovery considerations.
-- Tightened renderer/main IPC boundary and main-process pet revalidation.
+- Tightened renderer/main IPC boundary and main-process familiar revalidation.
 - Added action journal location/schema/redaction/bounds.
 - Added `replace` to the action journal action schema and clarified Replace add-failure state.
 - Added operation serialization and timeout kill behavior.
diff --git a/docs/phases/phase-08-claude-enhanced-hooks.md b/docs/phases/phase-08-claude-enhanced-hooks.md
index debdd967..109826ad 100644
--- a/docs/phases/phase-08-claude-enhanced-hooks.md
+++ b/docs/phases/phase-08-claude-enhanced-hooks.md
@@ -2,17 +2,17 @@
 
 ## Goal
 
-Make Claude Code feel polished by adding safe global Claude hooks that send automatic OpenPets reactions and short local speech through `@open-pets/claude` and `@open-pets/client`.
+Make Claude Code feel polished by adding safe global Claude hooks that send automatic FamiliarOS reactions and short local speech through `@familiaros/claude` and `@familiaros/client`.
 
-This phase builds on Phase 07's Claude Code detection/MCP configuration UI. Phase 08 should let the user install, doctor, and uninstall OpenPets-managed Claude hooks with explicit confirmation and backups.
+This phase builds on Phase 07's Claude Code detection/MCP configuration UI. Phase 08 should let the user install, doctor, and uninstall FamiliarOS-managed Claude hooks with explicit confirmation and backups.
 
 ## Non-goals
 
 - No direct changes to Claude MCP configuration beyond what Phase 07 already provides.
 - No Cursor, VS Code, Windsurf, OpenCode, or Antigravity hooks.
 - No model-generated speech.
-- No displaying user prompt text, code, logs, file paths, command text, transcript contents, or tool input in pet speech.
-- No blocking/denying Claude actions. OpenPets hooks are decorative/status-only and should fail open.
+- No displaying user prompt text, code, logs, file paths, command text, transcript contents, or tool input in familiar speech.
+- No blocking/denying Claude actions. FamiliarOS hooks are decorative/status-only and should fail open.
 - No shell scripts, Unix-only sockets, `nc`, `/tmp` socket paths, or Bun runtime dependency.
 - No durable persistence of Claude session payloads or transcripts.
 
@@ -21,12 +21,12 @@ This phase builds on Phase 07's Claude Code detection/MCP configuration UI. Phas
 From **Configure Agents...**, the Claude Code card gains enhanced hook controls:
 
 - Hook status: not installed / installed / needs update / error.
-- Preview of the exact hook entries OpenPets will add to Claude user settings.
+- Preview of the exact hook entries FamiliarOS will add to Claude user settings.
 - Install hooks with explicit confirmation and backup.
 - Doctor/check hooks.
-- Uninstall OpenPets-managed hooks only.
+- Uninstall FamiliarOS-managed hooks only.
 
-In a real Claude Code session, the pet reacts automatically:
+In a real Claude Code session, the familiar reacts automatically:
 
 - User prompt submitted → thinking, occasional short thinking speech.
 - Tool use → editing/running/testing reaction, usually silent.
@@ -37,12 +37,12 @@ In a real Claude Code session, the pet reacts automatically:
 
 ## Acceptance criteria
 
-- `@open-pets/claude` exposes a Node/npm/npx-friendly hook entry point, for example:
-  - `open-pets-claude hook`
-  - final published/dev preview command may be displayed as `npx -y @open-pets/claude hook` until packaging decides global/local binary details.
+- `@familiaros/claude` exposes a Node/npm/npx-friendly hook entry point, for example:
+  - `familiaros-claude hook`
+  - final published/dev preview command may be displayed as `npx -y @familiaros/claude hook` until packaging decides global/local binary details.
 - Hook command reads Claude hook JSON from stdin with a strict byte limit and timeout-friendly behavior.
 - Hook command never blocks Claude intentionally:
-  - returns exit code 0 for handled, ignored, and degraded OpenPets-unavailable cases.
+  - returns exit code 0 for handled, ignored, and degraded FamiliarOS-unavailable cases.
   - only uses non-zero exit for unrecoverable CLI/runtime invocation errors before hook handling begins.
 - Hook command stdout is always empty, including `UserPromptSubmit`, because Claude may ingest stdout as context.
 - Installed hook entries must not synchronously block Claude for decorative status updates:
@@ -50,7 +50,7 @@ In a real Claude Code session, the pet reacts automatically:
   - keep timeout short, initially 3 seconds.
   - if async hooks are not supported by the installed Claude version, doctor/install must warn and fail closed rather than installing cold-start `npx` hooks on high-frequency events.
   - future packaging may replace `npx` with a faster local/bundled binary, but Phase 08 should not rely on synchronous `npx` for `PreToolUse`.
-- Hook command sends OpenPets events through `@open-pets/client` only; no direct socket/manual JSON writes.
+- Hook command sends FamiliarOS events through `@familiaros/client` only; no direct socket/manual JSON writes.
 - Hook mapping handles the selected Claude hook events and ignores all others safely:
   - `UserPromptSubmit` → `thinking` + selective speech.
   - `PreToolUse` → `editing`, `testing`, `running`, or `working` based on `tool_name` and safe classification of `tool_input`.
@@ -73,8 +73,8 @@ In a real Claude Code session, the pet reacts automatically:
   - permission speech always allowed subject to a short cooldown to avoid duplicates.
   - lifecycle speech has a cooldown, initially at least 20 seconds per category.
   - throttle state is ephemeral and stored outside Claude settings, with bounded size and no payload content.
-- Hooks route through the default OpenPets desktop route in Phase 08:
-  - Because Claude hooks do not reliably know the active MCP lease id, they call `react`/`say` without `leaseId` and therefore affect the desktop default pet.
+- Hooks route through the default FamiliarOS desktop route in Phase 08:
+  - Because Claude hooks do not reliably know the active MCP lease id, they call `react`/`say` without `leaseId` and therefore affect the desktop default familiar.
   - Future lease-aware Claude routing is explicitly deferred until a reliable session↔lease correlation is available.
 - Global hook installation targets Claude Code user settings:
   - default path `~/.claude/settings.json` only for Phase 08.
@@ -85,24 +85,24 @@ In a real Claude Code session, the pet reacts automatically:
   - create parent directory with restrictive permissions where practical.
   - write temp file with restrictive permissions where practical before atomic rename.
   - preserves unrelated settings and unrelated hooks.
-  - installs only clearly OpenPets-managed command hooks.
-  - uninstall/update matching requires the `--openpets-managed` marker; package-name-only matching is not enough.
+  - installs only clearly FamiliarOS-managed command hooks.
+  - uninstall/update matching requires the `--familiaros-managed` marker; package-name-only matching is not enough.
   - idempotent reinstall/update.
   - atomic write where practical.
-- Uninstall removes only OpenPets-managed hook commands and leaves unrelated user/project hooks intact.
-- Agent Setup UI shows hook status, preview, install/update, doctor, and uninstall controls with explicit warning that hooks execute commands from Claude Code, are global user-scope across Claude projects, and route to the OpenPets default pet in Phase 08.
+- Uninstall removes only FamiliarOS-managed hook commands and leaves unrelated user/project hooks intact.
+- Agent Setup UI shows hook status, preview, install/update, doctor, and uninstall controls with explicit warning that hooks execute commands from Claude Code, are global user-scope across Claude projects, and route to the FamiliarOS default familiar in Phase 08.
 - Agent Setup provides a local dev command toggle so manual testing can install Claude MCP/hooks against this checkout's built `dist` files instead of published `npx` packages:
-  - production MCP: `npx -y @open-pets/mcp ...`
+  - production MCP: `npx -y @familiaros/mcp ...`
   - local MCP: `node <repo>/packages/mcp/dist/index.js ...`
-  - production hooks: `npx -y @open-pets/claude hook --openpets-managed`
-  - local hooks: `node <repo>/packages/claude/dist/cli.js hook --openpets-managed`
+  - production hooks: `npx -y @familiaros/claude hook --familiaros-managed`
+  - local hooks: `node <repo>/packages/claude/dist/cli.js hook --familiaros-managed`
 - Automated checks cover hook payload parsing, event mapping, speech safety, throttling decisions, settings merge/uninstall behavior, and command preview.
 - `pnpm check` passes.
 
 ## Proposed files/directories
 
 - `packages/claude/package.json`
-  - Add `bin` for `open-pets-claude`.
+  - Add `bin` for `familiaros-claude`.
   - Ensure check builds and validates hooks.
 - `packages/claude/src/cli.ts`
   - CLI dispatcher for `hook`, `doctor-hooks`, maybe install/uninstall helpers used by desktop/tests.
@@ -121,23 +121,23 @@ In a real Claude Code session, the pet reacts automatically:
 - `apps/desktop/src/windows.ts`
   - Add hook section to Claude Code card.
 - `apps/desktop/preload.cjs`
-  - Add narrow hook actions through `openpetsAgentSetup`.
+  - Add narrow hook actions through `familiarosAgentSetup`.
 - `docs/phases/phase-08-claude-enhanced-hooks.md`
 
 ## Technical approach
 
 ### Hook command behavior
 
-Claude Code command hooks receive JSON on stdin. The OpenPets hook command should:
+Claude Code command hooks receive JSON on stdin. The FamiliarOS hook command should:
 
 1. Read stdin up to a strict limit, initially 64 KiB.
 2. Parse JSON defensively.
 3. Determine `hook_event_name` and safe metadata such as `tool_name`.
-4. Map to an OpenPets reaction and optional static speech.
-5. Send via `createOpenPetsClient({ connectTimeoutMs: 500, responseTimeoutMs: 500 })`.
-6. Swallow OpenPets-unavailable errors and exit 0.
+4. Map to an FamiliarOS reaction and optional static speech.
+5. Send via `createFamiliarOSClient({ connectTimeoutMs: 500, responseTimeoutMs: 500 })`.
+6. Swallow FamiliarOS-unavailable errors and exit 0.
 
-The command should write debug output only to stderr when `OPENPETS_DEBUG=1`; stdout must stay empty so Claude does not receive unintended context.
+The command should write debug output only to stderr when `FAMILIAROS_DEBUG=1`; stdout must stay empty so Claude does not receive unintended context.
 
 ### Event mapping
 
@@ -175,14 +175,14 @@ Selection should be deterministic enough for tests but varied at runtime, for ex
 
 ### Throttling
 
-Throttle state should not include hook payload content. Store only timestamps/counters by category in an OpenPets-owned file, for example:
+Throttle state should not include hook payload content. Store only timestamps/counters by category in an FamiliarOS-owned file, for example:
 
 Use a pure Node cross-platform path because the hook runs outside Electron:
 
 ```text
-macOS/Linux: ${XDG_STATE_HOME:-~/.local/state}/openpets/claude-hook-throttle.json
-Windows: %LOCALAPPDATA%\OpenPets\claude-hook-throttle.json
-fallback: os.tmpdir()/openpets-<uid>/claude-hook-throttle.json
+macOS/Linux: ${XDG_STATE_HOME:-~/.local/state}/familiaros/claude-hook-throttle.json
+Windows: %LOCALAPPDATA%\FamiliarOS\claude-hook-throttle.json
+fallback: os.tmpdir()/familiaros-<uid>/claude-hook-throttle.json
 ```
 
 Requirements:
@@ -210,7 +210,7 @@ Hook config shape should follow current Claude docs:
         "hooks": [
           {
             "type": "command",
-            "command": "npx -y @open-pets/claude hook --openpets-managed",
+            "command": "npx -y @familiaros/claude hook --familiaros-managed",
             "timeout": 3,
             "async": true,
             "asyncRewake": false
@@ -222,7 +222,7 @@ Hook config shape should follow current Claude docs:
 }
 ```
 
-Use one OpenPets-managed command per event with the stable `--openpets-managed` marker in the command so uninstall can safely identify owned hooks.
+Use one FamiliarOS-managed command per event with the stable `--familiaros-managed` marker in the command so uninstall can safely identify owned hooks.
 
 Install algorithm:
 
@@ -232,17 +232,17 @@ Install algorithm:
 4. Validate top-level JSON object.
 5. Validate `hooks` is absent or object; if malformed, abort and ask user to fix manually.
 6. Verify Claude hook async support from current docs/known behavior and local checks where practical. If no reliable local check exists, install may proceed based on documented support but doctor must warn when support is uncertain.
-7. Create backup before write: `settings.json.openpets-backup-YYYYMMDD-HHMMSS.json`.
-8. Remove previous OpenPets-managed hook commands.
-9. Add current OpenPets-managed async hook entries.
+7. Create backup before write: `settings.json.familiaros-backup-YYYYMMDD-HHMMSS.json`.
+8. Remove previous FamiliarOS-managed hook commands.
+9. Add current FamiliarOS-managed async hook entries.
 10. Atomic write temp file + rename.
 
 Uninstall algorithm:
 
 1. Resolve/read/validate settings.
 2. Backup before write.
-3. Remove only hook commands containing the `--openpets-managed` marker.
-4. Prune empty arrays/objects created by OpenPets where safe.
+3. Remove only hook commands containing the `--familiaros-managed` marker.
+4. Prune empty arrays/objects created by FamiliarOS where safe.
 5. Atomic write.
 
 Doctor should report:
@@ -252,7 +252,7 @@ Doctor should report:
 - whether hooks object is valid.
 - installed/up-to-date/needs update/not installed.
 - backup path from last install/uninstall if applicable.
-- whether OpenPets desktop IPC is reachable.
+- whether FamiliarOS desktop IPC is reachable.
 - reminder that Claude hooks require trusted workspaces and Claude restart/reload if settings were changed.
 
 ### Agent Setup UI
@@ -262,17 +262,17 @@ Add an **Enhanced Claude hooks** section to the existing Claude Code card:
 - Status badge.
 - Preview JSON snippet.
 - Buttons: Doctor hooks, Install/Update hooks, Uninstall hooks.
-- Warning copy: Claude hooks execute command hooks automatically; OpenPets-managed hooks are status-only, fail open, and do not inspect/store code content.
+- Warning copy: Claude hooks execute command hooks automatically; FamiliarOS-managed hooks are status-only, fail open, and do not inspect/store code content.
 - Local dev command toggle shared with the MCP setup preview/actions.
 
 ## Risks and tradeoffs
 
 - Claude hook schemas/events can change. Mitigation: parse defensively, ignore unknowns, document event contract, keep doctor actionable.
-- Hooks are command execution. Mitigation: explicit confirmation, preview, OpenPets marker, uninstall, backups, no silent edits.
+- Hooks are command execution. Mitigation: explicit confirmation, preview, FamiliarOS marker, uninstall, backups, no silent edits.
 - Direct settings edits can corrupt user config if careless. Mitigation: validate JSON object, backup, atomic writes, preserve unrelated keys, abort on malformed hooks.
-- `npx -y @open-pets/claude hook` may be slow for frequent hooks. Mitigation: no speech on high-frequency tool events; hook timeout 3 seconds; future packaging can switch command to bundled/local binary.
+- `npx -y @familiaros/claude hook` may be slow for frequent hooks. Mitigation: no speech on high-frequency tool events; hook timeout 3 seconds; future packaging can switch command to bundled/local binary.
 - Hooks may be skipped in untrusted Claude workspaces. Mitigation: doctor/manual guide documents trust requirement.
-- Session-to-MCP-lease routing is ambiguous. Mitigation: Phase 08 explicitly routes hook events to default pet; MCP per-project pet routing remains available through tools/leases.
+- Session-to-MCP-lease routing is ambiguous. Mitigation: Phase 08 explicitly routes hook events to default familiar; MCP per-project familiar routing remains available through tools/leases.
 
 ## Security/privacy notes
 
@@ -280,9 +280,9 @@ Add an **Enhanced Claude hooks** section to the existing Claude Code card:
 - Do not read transcript files.
 - Do not store hook payloads, prompts, tool inputs, assistant messages, cwd, transcript paths, or session ids in durable logs.
 - Debug logs, if enabled, must be minimal and sanitized.
-- Hook stdout must stay empty; use stderr for debug only when `OPENPETS_DEBUG=1`.
+- Hook stdout must stay empty; use stderr for debug only when `FAMILIAROS_DEBUG=1`.
 - Hook commands must fail open and avoid blocking user work.
-- Settings installer must preserve unrelated hooks and avoid removing anything not OpenPets-managed.
+- Settings installer must preserve unrelated hooks and avoid removing anything not FamiliarOS-managed.
 - Hook settings must be async/background; do not install synchronous cold-start `npx` hooks for high-frequency events.
 - Speech safety filters should reuse or match MCP speech safety rules.
 
@@ -295,10 +295,10 @@ Add an **Enhanced Claude hooks** section to the existing Claude Code card:
   - throttling allows/blocks expected categories without storing payload content.
   - settings install preview/merge preserves unrelated settings and hooks.
   - settings reinstall is idempotent.
-  - settings uninstall removes only OpenPets-managed hooks.
+  - settings uninstall removes only FamiliarOS-managed hooks.
   - malformed settings/hook object aborts safely.
   - symlink/special-file settings path aborts safely.
-  - generated hook config includes `--openpets-managed`, `timeout: 3`, and `async: true`.
+  - generated hook config includes `--familiaros-managed`, `timeout: 3`, and `async: true`.
   - published/local command previews for MCP and hooks.
 - Desktop checks:
   - Agent Setup hook action validation/sender restrictions where practical.
@@ -310,7 +310,7 @@ Add an **Enhanced Claude hooks** section to the existing Claude Code card:
 After implementation:
 
 1. Run `pnpm check`.
-2. Start desktop: `pnpm --filter @open-pets/desktop dev`.
+2. Start desktop: `pnpm --filter @familiaros/desktop dev`.
 3. Open tray → **Configure Agents...**.
 4. In Claude Code, confirm MCP is configured from Phase 07 or configure it now.
 5. Inspect Enhanced Claude hooks preview.
@@ -323,24 +323,24 @@ After implementation:
 10. Confirm unrelated hook entries remain after install/update.
 11. Confirm reinstall is idempotent.
 12. Start/restart Claude Code in a trusted workspace.
-13. Invoke a hook command with a stdin fixture directly, for example a `UserPromptSubmit` fixture, and confirm it exits 0 with empty stdout even if OpenPets desktop is unavailable.
-    Example after build: `printf '{"hook_event_name":"UserPromptSubmit","prompt":"hello"}' | node packages/claude/dist/cli.js hook --openpets-managed`.
-14. Submit a real prompt and confirm the pet reacts thinking with occasional safe speech.
+13. Invoke a hook command with a stdin fixture directly, for example a `UserPromptSubmit` fixture, and confirm it exits 0 with empty stdout even if FamiliarOS desktop is unavailable.
+    Example after build: `printf '{"hook_event_name":"UserPromptSubmit","prompt":"hello"}' | node packages/claude/dist/cli.js hook --familiaros-managed`.
+14. Submit a real prompt and confirm the familiar reacts thinking with occasional safe speech.
 15. Run/edit/test from Claude and confirm reactions change without noisy speech.
 16. Trigger a permission request and confirm waiting + approval message.
 17. Finish a response and confirm success speech/reaction.
 18. If possible, trigger a failing turn and confirm error reaction/speech.
-19. Quit OpenPets desktop and confirm Claude hooks do not break Claude Code.
+19. Quit FamiliarOS desktop and confirm Claude hooks do not break Claude Code.
 20. Return to Agent Setup and click Uninstall hooks.
-21. Confirm OpenPets-managed hook entries are removed, uninstall is idempotent, and unrelated Claude settings remain.
+21. Confirm FamiliarOS-managed hook entries are removed, uninstall is idempotent, and unrelated Claude settings remain.
 
 Expected results:
 
 - Hooks are explicit, reversible, and backed up.
 - Backups may contain user-sensitive Claude settings; keep them local/private.
-- Pet reactions feel automatic and non-spammy.
+- Familiar reactions feel automatic and non-spammy.
 - Speech is short, local, safe, and never includes private prompt/tool content.
-- Broken/missing OpenPets desktop app does not break Claude Code.
+- Broken/missing FamiliarOS desktop app does not break Claude Code.
 
 ## Oracle plan review
 
@@ -348,16 +348,16 @@ Reviewed. Oracle found the phase boundary sound but flagged one blocker:
 
 - Decorative hooks cannot rely on synchronous cold-start `npx`, especially for frequent `PreToolUse`; hook entries must be async/background or use a fast local binary.
 
-Oracle also requested: marker in examples, no `CLAUDE_CONFIG_DIR` until verified, UI warnings about global/default-pet routing, pure Node throttle path, regular-file/no-symlink settings hardening, selected-events wording, and expanded manual verification.
+Oracle also requested: marker in examples, no `CLAUDE_CONFIG_DIR` until verified, UI warnings about global/default-familiar routing, pure Node throttle path, regular-file/no-symlink settings hardening, selected-events wording, and expanded manual verification.
 
 ## Oracle feedback disposition
 
 Fixed:
 
 - Required `async: true` hook entries with short timeout and fail-closed install if async support is unavailable/uncertain.
-- Added `--openpets-managed` marker to preview/config examples.
+- Added `--familiaros-managed` marker to preview/config examples.
 - Removed `CLAUDE_CONFIG_DIR` support from Phase 08 scope.
-- Added UI warning requirement for global user-scope hooks and Phase 08 default-pet routing.
+- Added UI warning requirement for global user-scope hooks and Phase 08 default-familiar routing.
 - Defined pure Node cross-platform throttle-state path.
 - Added settings path hardening: missing/regular file only, abort symlink/special files, restrictive permissions where practical.
 - Clarified Phase 08 handles selected Claude events and ignores others safely.
@@ -367,5 +367,5 @@ Fixed after re-review:
 
 - Required empty hook stdout for all events.
 - Clarified async support verification may rely on documented support with doctor warning if no reliable local check exists.
-- Tightened uninstall/update matching to require `--openpets-managed` marker.
+- Tightened uninstall/update matching to require `--familiaros-managed` marker.
 - Added `asyncRewake: false` to generated config, stdin fixture command example, and backup privacy note.
diff --git a/docs/phases/phase-08c-test-harness-regression-pack.md b/docs/phases/phase-08c-test-harness-regression-pack.md
index ec43c227..f3e38626 100644
--- a/docs/phases/phase-08c-test-harness-regression-pack.md
+++ b/docs/phases/phase-08c-test-harness-regression-pack.md
@@ -2,7 +2,7 @@
 
 ## Goal
 
-Add a lightweight, explicit test workflow for OpenPets before Phase 09 onboarding glues together pet management, MCP routing, Claude setup, and hooks.
+Add a lightweight, explicit test workflow for FamiliarOS before Phase 09 onboarding glues together familiar management, MCP routing, Claude setup, and hooks.
 
 The project already has useful `check-*.ts` contract checks. This phase standardizes how those checks are run, adds a top-level `pnpm test`, and expands regression coverage around the riskiest recent features without introducing a heavy test stack prematurely.
 
@@ -13,7 +13,7 @@ The project already has useful `check-*.ts` contract checks. This phase standard
 - No large migration to a test framework unless a clear gap appears.
 - No broad refactors of feature code solely to satisfy tests.
 - No network-dependent tests.
-- No tests that mutate real Claude user settings, real pet installs, or real desktop app state.
+- No tests that mutate real Claude user settings, real familiar installs, or real desktop app state.
 
 ## User-visible/manual outcome
 
@@ -24,7 +24,7 @@ pnpm test
 pnpm check
 ```
 
-and get clear regression coverage for core OpenPets behavior. `pnpm check` remains the pre-commit/phase gate; `pnpm test` becomes the focused regression test command.
+and get clear regression coverage for core FamiliarOS behavior. `pnpm check` remains the pre-commit/phase gate; `pnpm test` becomes the focused regression test command.
 
 ## Acceptance criteria
 
@@ -36,7 +36,7 @@ and get clear regression coverage for core OpenPets behavior. `pnpm check` remai
   - `packages/claude`
 - Packages without meaningful runtime checks yet may keep `test` as type/build-only or omit it with a documented reason:
   - `packages/cli`
-  - `packages/pet-format`
+  - `packages/familiar-format`
 - Existing `check-*.ts` files are either:
   - included in package `test`, or
   - clearly kept in `check` with `test` delegating to them.
@@ -49,7 +49,7 @@ and get clear regression coverage for core OpenPets behavior. `pnpm check` remai
   - a real Claude installation.
   - network access.
   - writes to real `~/.claude/settings.json`.
-  - writes to real OpenPets user data, except via isolated temp directories or pure in-memory checks.
+  - writes to real FamiliarOS user data, except via isolated temp directories or pure in-memory checks.
 - Tests using temp directories clean them up and do not depend on the current working directory except explicit repo-relative fixture paths.
 - Claude settings install/uninstall tests must pass explicit temp settings paths; they must never call install/uninstall against the default real Claude settings path.
 - Regression coverage includes at least:
@@ -62,7 +62,7 @@ and get clear regression coverage for core OpenPets behavior. `pnpm check` remai
   - Local dev command path validation failure cases where practical.
   - Desktop lease manager behavior.
   - Desktop IPC protocol validation.
-  - Pet zip safety/catalog validation checks.
+  - Familiar zip safety/catalog validation checks.
 - Test output names should make it obvious what failed.
 - `docs/implementation-process.md` or the phase spec documents the new test/check distinction.
 
@@ -131,7 +131,7 @@ Add or strengthen tests around bugs found during manual verification:
 - Local dev mode validates missing/invalid dist paths where practical.
 - Hook commands produce empty stdout.
 - Hook CLI direct invocation produces empty stdout for normal and malformed fixture payloads.
-- Explicit pet rendering should not regress to giant installed-pet image data URLs where this can be checked without Electron.
+- Explicit familiar rendering should not regress to giant installed-familiar image data URLs where this can be checked without Electron.
 - Benign IPC client disconnect errors should not fail response handling where factored.
 
 ## Risks and tradeoffs
@@ -139,7 +139,7 @@ Add or strengthen tests around bugs found during manual verification:
 - Adding a framework now may slow progress. Mitigation: standardize existing checks first.
 - Pure Node checks cannot catch every Electron UI issue. Mitigation: keep manual verification for tray/windows and add UI automation later.
 - Too many duplicated scripts can become hard to maintain. Mitigation: keep `test`/`check` scripts simple and consistent.
-- Tests that touch real Claude/OpenPets state would be risky. Mitigation: temp fixtures only.
+- Tests that touch real Claude/FamiliarOS state would be risky. Mitigation: temp fixtures only.
 
 ## Security/privacy notes
 
diff --git a/docs/phases/phase-09-first-run-onboarding.md b/docs/phases/phase-09-first-run-onboarding.md
index 880d6a36..31a61c56 100644
--- a/docs/phases/phase-09-first-run-onboarding.md
+++ b/docs/phases/phase-09-first-run-onboarding.md
@@ -2,42 +2,42 @@
 
 ## Goal
 
-Connect the existing pet manager, agent setup, default pet, and settings pieces into a clear first-run onboarding flow.
+Connect the existing familiar manager, agent setup, default familiar, and settings pieces into a clear first-run onboarding flow.
 
-Phase 09 should make a fresh OpenPets install feel ready: the default pet appears, the user can optionally browse/install pets, configure Claude from the real Agent Setup flow, and finish with onboarding completion persisted.
+Phase 09 should make a fresh FamiliarOS install feel ready: the default familiar appears, the user can optionally browse/install familiars, configure Claude from the real Agent Setup flow, and finish with onboarding completion persisted.
 
 ## Non-goals
 
 - No new agent integrations beyond the existing Claude Code setup/hook controls.
-- No new catalog install mechanics beyond the existing Pet Manager install flow.
+- No new catalog install mechanics beyond the existing Familiar Manager install flow.
 - No packaging/release installer work.
 - No account system, telemetry, analytics, or network calls beyond the existing catalog fetch.
-- No forced pet install; the bundled default pet remains enough to complete onboarding.
+- No forced familiar install; the bundled default familiar remains enough to complete onboarding.
 - No silent edits to Claude or other agent settings; existing confirmation/backup behavior remains required.
 - No destructive onboarding reset UI beyond developer/manual reset instructions for this phase.
 
 ## User-visible/manual outcome
 
-On a fresh app state, OpenPets opens a first-run onboarding window after startup.
+On a fresh app state, FamiliarOS opens a first-run onboarding window after startup.
 
 The onboarding window has a simple wizard shape:
 
 1. **Welcome**
-   - Explains that OpenPets lives in the tray/menu bar.
-   - Confirms the bundled default pet is already available.
+   - Explains that FamiliarOS lives in the tray/menu bar.
+   - Confirms the bundled default familiar is already available.
    - Provides a Continue button.
-2. **Pets**
-   - Shows the current default pet and a short explanation that installing more pets is optional.
-   - Provides an action to open the real Pet Manager.
+2. **Familiars**
+   - Shows the current default familiar and a short explanation that installing more familiars is optional.
+   - Provides an action to open the real Familiar Manager.
    - Provides Skip/Continue.
-   - If the catalog is unavailable, onboarding remains completable and points the user to try later from Pet Manager.
+   - If the catalog is unavailable, onboarding remains completable and points the user to try later from Familiar Manager.
 3. **Agents**
    - Shows Claude Code as the supported first integration for this MVP checkpoint.
    - Provides an action to open the real Agent Setup window.
    - Explains that setup is confirmation-based and can be skipped.
 4. **Ready**
-   - Confirms OpenPets is ready.
-   - Offers quick actions to open Pet Manager or Agent Setup.
+   - Confirms FamiliarOS is ready.
+   - Offers quick actions to open Familiar Manager or Agent Setup.
    - Finish persists onboarding completion and closes the onboarding window.
 
 The tray remains usable during onboarding. Closing onboarding without finishing should not mark onboarding complete; it should be possible to reopen onboarding from the tray until completed.
@@ -47,15 +47,15 @@ The tray remains usable during onboarding. Closing onboarding without finishing
 - App state persists onboarding completion, for example `preferences.onboardingCompleted` or equivalent versioned state.
 - State normalization handles missing/old state by treating onboarding as incomplete.
 - Fresh app state opens onboarding automatically after app initialization.
-- The default pet appears early when `openDefaultPetOnLaunch` is enabled, independent of onboarding completion.
+- The default familiar appears early when `openDefaultPetOnLaunch` is enabled, independent of onboarding completion.
 - Onboarding is implemented as a normal sandboxed/context-isolated Electron task window with the existing preload/security posture.
 - Onboarding uses dedicated IPC handlers with sender validation; only the onboarding renderer can complete onboarding.
 - Onboarding IPC sender validation must use the main-process `taskWindows` / `webContents.id` mapping, not renderer-declared DOM attributes.
-- If the shared preload exposes broad APIs, existing main-process IPC sender checks must deny pet install/remove, preference mutation, and agent setup mutation from the onboarding window.
-- Onboarding cannot directly mutate pet installs or agent configuration except by opening the existing Pet Manager / Agent Setup flows.
+- If the shared preload exposes broad APIs, existing main-process IPC sender checks must deny familiar install/remove, preference mutation, and agent setup mutation from the onboarding window.
+- Onboarding cannot directly mutate familiar installs or agent configuration except by opening the existing Familiar Manager / Agent Setup flows.
 - Onboarding includes actions to:
   - continue through steps,
-  - open Pet Manager,
+  - open Familiar Manager,
   - open Agent Setup,
   - finish onboarding,
   - close without completing.
@@ -77,7 +77,7 @@ The tray remains usable during onboarding. Closing onboarding without finishing
   - Add a narrow completion helper, e.g. `completeOnboarding()`.
 - `apps/desktop/src/windows.ts`
   - Add `onboarding` task window kind and HTML.
-  - Add IPC handlers for onboarding snapshot/completion and opening Pet Manager / Agent Setup from onboarding.
+  - Add IPC handlers for onboarding snapshot/completion and opening Familiar Manager / Agent Setup from onboarding.
   - Reuse existing CSP, sandbox, context isolation, navigation blocking, and sender validation patterns.
 - `apps/desktop/src/main.ts`
   - Decide when to open onboarding automatically after startup.
@@ -85,7 +85,7 @@ The tray remains usable during onboarding. Closing onboarding without finishing
   - Add **Continue Setup...** while onboarding is incomplete.
   - Refresh menu after onboarding completion.
 - `apps/desktop/preload.cjs`
-  - Expose a narrow `openpetsOnboarding` bridge only for onboarding actions.
+  - Expose a narrow `familiarosOnboarding` bridge only for onboarding actions.
 - `apps/desktop/src/check-onboarding-state.ts`
   - Contract checks for state migration/completion through extracted pure normalization/completion helpers or injected temp state paths.
   - Do not import Electron-bound `app-state.ts` directly from plain Node tests if that couples tests to Electron `app.getPath`.
@@ -115,7 +115,7 @@ Add narrow exported helpers:
 
 ```ts
 isOnboardingCompleted(): boolean
-completeOnboarding(): OpenPetsStateV1
+completeOnboarding(): FamiliarOSStateV1
 ```
 
 `completeOnboarding()` should only set the completion flag and persist via existing atomic state write behavior.
@@ -127,13 +127,13 @@ Startup order should stay stable:
 1. Initialize state.
 2. Install internal UI handlers.
 3. Create tray.
-4. Install default pet display handlers.
+4. Install default familiar display handlers.
 5. Start local IPC.
-6. Show default pet if preference says so.
+6. Show default familiar if preference says so.
 7. Open onboarding if incomplete.
 8. Refresh tray.
 
-Opening onboarding should not delay local IPC startup or default pet display. If opening the window fails, log the error and keep the app usable from tray.
+Opening onboarding should not delay local IPC startup or default familiar display. If opening the window fails, log the error and keep the app usable from tray.
 
 ### Window and IPC
 
@@ -144,26 +144,26 @@ The onboarding renderer should be static inline HTML loaded through the same dat
 Suggested bridge:
 
 ```ts
-window.openpetsOnboarding = {
+window.familiarosOnboarding = {
   getSnapshot(): Promise<{ defaultPetName: string; onboardingCompleted: boolean }>;
-  complete(): Promise<OpenPetsStateV1>;
+  complete(): Promise<FamiliarOSStateV1>;
   openPetManager(): Promise<void>;
   openAgentSetup(): Promise<void>;
 }
 ```
 
-Keep the snapshot lightweight: default pet/onboarding state only. Phase 09 does not need to duplicate the full Pet Manager or Agent Setup UIs inside onboarding; opening the real windows is enough and avoids parallel state/config logic. Do not expose Claude settings paths, Claude config previews, or detailed agent status in onboarding.
+Keep the snapshot lightweight: default familiar/onboarding state only. Phase 09 does not need to duplicate the full Familiar Manager or Agent Setup UIs inside onboarding; opening the real windows is enough and avoids parallel state/config logic. Do not expose Claude settings paths, Claude config previews, or detailed agent status in onboarding.
 
-Sender validation should allow onboarding access only through the existing main-process window-kind mapping from `webContents.id` to `taskWindows`. Renderer-declared values like `data-openpets-view="onboarding"` may be useful for the preload bridge but must not be the trust boundary.
+Sender validation should allow onboarding access only through the existing main-process window-kind mapping from `webContents.id` to `taskWindows`. Renderer-declared values like `data-familiaros-view="onboarding"` may be useful for the preload bridge but must not be the trust boundary.
 
 ### Onboarding UI details
 
 The UI should be intentionally small and clear, not a full dashboard:
 
 - One card/wizard window, roughly the same size as other task windows.
-- Step indicators for Welcome / Pets / Agents / Ready.
+- Step indicators for Welcome / Familiars / Agents / Ready.
 - Primary and secondary actions per step.
-- Clear skip language: pet installs and agent setup can be done later.
+- Clear skip language: familiar installs and agent setup can be done later.
 - Explicit reminder that Claude setup may edit user-level Claude settings only after confirmation and backups.
 
 ### Reopen behavior
@@ -178,7 +178,7 @@ After completion:
 
 - App startup does not auto-open onboarding.
 - Tray omits **Continue Setup...**.
-- Pet Manager, Agent Setup, and Settings remain available normally.
+- Familiar Manager, Agent Setup, and Settings remain available normally.
 
 ### Reset/manual testing behavior
 
@@ -188,15 +188,15 @@ If a small developer-only helper is cheaper and safer, it may be added only as a
 
 ## Risks and tradeoffs
 
-- **Onboarding could become a second implementation of Pet Manager/Agent Setup.** Avoid this by using onboarding as a guide that opens the real windows.
+- **Onboarding could become a second implementation of Familiar Manager/Agent Setup.** Avoid this by using onboarding as a guide that opens the real windows.
 - **Existing dev installs may see onboarding after the state schema changes.** This is acceptable for first-run behavior; manual instructions should include how to mark complete or reset state.
 - **Catalog/agent setup failures can make onboarding feel blocked.** The flow must make those steps optional and completable.
-- **Window focus could be annoying at startup.** The default pet and tray remain primary; onboarding should be a normal window and not repeatedly refocus if closed.
+- **Window focus could be annoying at startup.** The default familiar and tray remain primary; onboarding should be a normal window and not repeatedly refocus if closed.
 - **State tests may be coupled to Electron `app`.** Prefer extracting pure normalization/completion helpers if needed instead of brittle Electron test setup.
 
 ## Security/privacy notes
 
-- Onboarding must not silently configure agents or install pets.
+- Onboarding must not silently configure agents or install familiars.
 - Claude setup remains routed through the existing Agent Setup controls with explicit confirmation and backups.
 - No onboarding payload should include Claude config contents beyond what existing Agent Setup already exposes.
 - Renderer stays sandboxed/context-isolated with no Node integration.
@@ -209,7 +209,7 @@ If a small developer-only helper is cheaper and safer, it may be added only as a
   - missing/old state normalizes `onboardingCompleted` to `false`,
   - completion helper persists `true`,
   - preference updates preserve onboarding completion,
-  - onboarding completion does not alter installed pets/default pet/agent configuration state.
+  - onboarding completion does not alter installed familiars/default familiar/agent configuration state.
 - Run:
 
 ```bash
@@ -221,20 +221,20 @@ Manual verification should use a fresh or reset dev app state.
 
 ## Manual verification guide
 
-1. Reset the dev app state by deleting the OpenPets dev user data directory shown in the app startup log, or remove/edit `openpets-state.json` so onboarding is incomplete.
+1. Reset the dev app state by deleting the FamiliarOS dev user data directory shown in the app startup log, or remove/edit `familiaros-state.json` so onboarding is incomplete.
 2. Run:
 
 ```bash
 pnpm dev:desktop
 ```
 
-3. Confirm the default pet appears if `openDefaultPetOnLaunch` is enabled.
+3. Confirm the default familiar appears if `openDefaultPetOnLaunch` is enabled.
 4. Confirm the onboarding window opens automatically.
 5. On Welcome, click Continue.
-6. On Pets, click the Pet Manager action and confirm the real Pet Manager opens. Close or leave it open, then continue/skip.
+6. On Familiars, click the Familiar Manager action and confirm the real Familiar Manager opens. Close or leave it open, then continue/skip.
 7. On Agents, click the Agent Setup action and confirm the real Configure Agents window opens with Claude controls. Do not apply config unless intentionally testing Claude setup. Continue/skip.
 8. On Ready, click Finish.
-9. Quit OpenPets and launch again with `pnpm dev:desktop`.
+9. Quit FamiliarOS and launch again with `pnpm dev:desktop`.
 10. Confirm onboarding does not auto-open after completion.
 11. Reset onboarding state again, relaunch, close the onboarding window without finishing, and confirm **Continue Setup...** is available from the tray and reopens onboarding.
 12. Simulate catalog unavailable behavior if practical, for example by disconnecting network or using an invalid catalog URL if supported by the dev environment; confirm onboarding can still be completed.
@@ -243,8 +243,8 @@ pnpm dev:desktop
 
 Expected results:
 
-- Onboarding never blocks app/tray/default pet usage.
-- Skipping pet install and agent setup still allows finishing.
+- Onboarding never blocks app/tray/default familiar usage.
+- Skipping familiar install and agent setup still allows finishing.
 - Completion persists across restart.
 - No Claude settings are modified unless you explicitly use existing Agent Setup configure/install buttons.
 
@@ -260,16 +260,16 @@ Should-fix feedback:
 - Keep onboarding preload/API narrow; if shared preload exposes broad APIs, existing IPC sender checks must deny install/remove/preferences from onboarding.
 - Add acceptance criteria that Finish closes onboarding and refreshes tray so **Continue Setup...** disappears immediately.
 - Avoid importing Electron-bound `app-state.ts` directly from Node tests; extract pure normalization/completion helpers or inject temp state paths.
-- Keep onboarding snapshot minimal: default pet/onboarding state only; do not duplicate Claude detection/status or expose Claude settings paths in onboarding.
+- Keep onboarding snapshot minimal: default familiar/onboarding state only; do not duplicate Claude detection/status or expose Claude settings paths in onboarding.
 - Manual verification should include Claude unavailable/catalog unavailable cases and confirm no Claude settings changed unless Agent Setup buttons are explicitly used.
 
 Nice-to-have feedback:
 
-- Add a small “Start using OpenPets”/Finish action on Ready that closes onboarding.
+- Add a small “Start using FamiliarOS”/Finish action on Ready that closes onboarding.
 - Place tray **Continue Setup...** above manager/settings while incomplete for discoverability.
 - Consider a developer-only env var to force onboarding incomplete for manual testing.
 
-Verdict: implementation-ready after sender-validation/preload and state-test clarifications. Scope is appropriate as one phase because it connects existing surfaces instead of rebuilding pet/agent setup logic.
+Verdict: implementation-ready after sender-validation/preload and state-test clarifications. Scope is appropriate as one phase because it connects existing surfaces instead of rebuilding familiar/agent setup logic.
 
 ## Oracle feedback disposition
 
@@ -279,7 +279,7 @@ Fixed:
 - Added shared-preload/broad-API guard requirement.
 - Added finish-close/tray-refresh acceptance criterion.
 - Clarified state tests should use extracted pure helpers or injected temp state paths, not brittle Electron-bound imports.
-- Reduced onboarding snapshot to default pet/onboarding state only and forbade exposing Claude config paths/previews in onboarding.
+- Reduced onboarding snapshot to default familiar/onboarding state only and forbade exposing Claude config paths/previews in onboarding.
 - Added manual checks for catalog unavailable, Claude unavailable/error states, and no Claude settings mutation unless existing Agent Setup controls are explicitly used.
 
 Accepted nice-to-have:
@@ -298,11 +298,11 @@ Blockers: none.
 
 Should-fix feedback:
 
-- Remove onboarding access to the broad `openpets:get-state` handler; onboarding should use only its minimal snapshot.
+- Remove onboarding access to the broad `familiaros:get-state` handler; onboarding should use only its minimal snapshot.
 - Return a minimal completion result instead of the full app state from onboarding completion.
 - Wrap automatic onboarding startup so a window creation failure does not exit the tray app.
 - Improve onboarding state tests so completion remains true after preference-like updates, and prefer temp/injected persistence coverage if practical.
-- Show the current default pet on the Pets step, not only Welcome.
+- Show the current default familiar on the Familiars step, not only Welcome.
 
 Nice-to-have feedback:
 
@@ -322,11 +322,11 @@ Final Oracle re-check:
 Fixed:
 
 - Added root `pnpm dev:desktop` script so the manual verification command works from the workspace root.
-- Removed onboarding from `openpets:get-state` allowlist.
+- Removed onboarding from `familiaros:get-state` allowlist.
 - Onboarding completion now returns `{ onboardingCompleted: true }` instead of full app state.
-- Wrapped startup onboarding open in a try/catch so tray/default-pet startup continues on failure.
+- Wrapped startup onboarding open in a try/catch so tray/default-familiar startup continues on failure.
 - Added state-check coverage that onboarding completion remains true after a preference-like update while other preferences are preserved.
-- Added current default pet display to the Pets step.
+- Added current default familiar display to the Familiars step.
 - Disabled the Finish button while completion is in flight.
 
 Deferred:
diff --git a/docs/phases/phase-10a-desktop-package-hardening.md b/docs/phases/phase-10a-desktop-package-hardening.md
index be93056b..9b80cc1d 100644
--- a/docs/phases/phase-10a-desktop-package-hardening.md
+++ b/docs/phases/phase-10a-desktop-package-hardening.md
@@ -2,25 +2,25 @@
 
 ## Goal
 
-Add a reliable current-platform desktop packaging checkpoint for the OpenPets tray app and document the MVP validation matrix, while explicitly deferring the unresolved packaged Claude command distribution path to Phase 10B.
+Add a reliable current-platform desktop packaging checkpoint for the FamiliarOS tray app and document the MVP validation matrix, while explicitly deferring the unresolved packaged Claude command distribution path to Phase 10B.
 
-Phase 10A should prove that the packaged desktop app itself can launch and run the core local experience: tray, default pet, onboarding, Pet Manager, settings, local state, assets, and local IPC startup/cleanup behavior.
+Phase 10A should prove that the packaged desktop app itself can launch and run the core local experience: tray, default familiar, onboarding, Familiar Manager, settings, local state, assets, and local IPC startup/cleanup behavior.
 
 ## Non-goals
 
-- No real packaged Claude end-to-end demo unless the user already has published `@open-pets/*` packages available.
+- No real packaged Claude end-to-end demo unless the user already has published `@familiaros/*` packages available.
 - No npm package publishing.
 - No bundled packaged MCP/Claude resource command mode.
 - No signed/notarized public release.
 - No app store work.
 - No auto-update system.
 - No start-at-login feature.
-- No new pet/catalog/agent features.
+- No new familiar/catalog/agent features.
 - No broad UI redesign.
 
 Phase 10B should choose the Claude distribution path:
 
-- publish `@open-pets/mcp` and `@open-pets/claude`, or
+- publish `@familiaros/mcp` and `@familiaros/claude`, or
 - bundle unpacked MCP/Claude command resources inside the packaged app and point Agent Setup at those paths.
 
 ## User-visible/manual outcome
@@ -35,10 +35,10 @@ pnpm package:desktop:dir
 
 Then launch the generated current-platform packaged app and verify:
 
-- OpenPets starts as a tray/menu bar app.
-- The default pet appears and uses packaged assets.
+- FamiliarOS starts as a tray/menu bar app.
+- The default familiar appears and uses packaged assets.
 - First-run onboarding can complete.
-- Pet Manager opens and can show installed pets/catalog state.
+- Familiar Manager opens and can show installed familiars/catalog state.
 - Settings opens and can update preferences.
 - The app writes local IPC discovery state in the user-specific runtime location.
 - Quit exits cleanly.
@@ -58,8 +58,8 @@ The phase also creates `docs/mvp-validation.md` with a platform matrix, unsigned
   - compiled desktop `dist/**`,
   - `preload.cjs`,
   - `assets/tray-icon.png`,
-  - bundled/default pet runtime assets or generated-renderer code,
-  - workspace runtime dependencies required by the desktop app, including built `@open-pets/claude` and `@open-pets/client` files because Agent Setup imports Claude helpers at startup,
+  - bundled/default familiar runtime assets or generated-renderer code,
+  - workspace runtime dependencies required by the desktop app, including built `@familiaros/claude` and `@familiaros/client` files because Agent Setup imports Claude helpers at startup,
   - package metadata needed by Electron.
 - Packaging must not leave pnpm symlinks that escape the packaged app, especially symlinks back to `packages/*` in the checkout.
 - Packaging excludes obvious repo bulk/secrets/user data:
@@ -75,7 +75,7 @@ The phase also creates `docs/mvp-validation.md` with a platform matrix, unsigned
 - Packaged resource path assumptions are audited and fixed if needed:
   - tray icon loading,
   - preload loading,
-  - built-in pet loading,
+  - built-in familiar loading,
   - internal data URLs/task windows,
   - local IPC discovery file paths.
 - Renderer security remains unchanged:
@@ -85,7 +85,7 @@ The phase also creates `docs/mvp-validation.md` with a platform matrix, unsigned
   - CSP/navigation guards retained.
 - Local dev command mode for Agent Setup remains unavailable or clearly dev-only in packaged builds.
 - Published/npx Claude commands remain documented as requiring real published packages; packaged Claude end-to-end is explicitly deferred to Phase 10B.
-- In Phase 10A packaged app verification, do not apply Claude MCP/hooks unless `@open-pets/*` packages are actually published and intentionally being tested.
+- In Phase 10A packaged app verification, do not apply Claude MCP/hooks unless `@familiaros/*` packages are actually published and intentionally being tested.
 - `docs/mvp-validation.md` documents:
   - platform validation matrix for macOS/Windows/Linux,
   - current-platform package command,
@@ -109,8 +109,8 @@ The phase also creates `docs/mvp-validation.md` with a platform matrix, unsigned
   - Ensure package output directory is ignored.
 - `apps/desktop/src/assets.ts`
   - Harden packaged resource path lookup if needed.
-- `apps/desktop/src/built-in-pet.ts`, `apps/desktop/src/pet-window.ts`, or related files
-  - Harden packaged built-in pet asset lookup only if package testing exposes a failure.
+- `apps/desktop/src/built-in-familiar.ts`, `apps/desktop/src/familiar-window.ts`, or related files
+  - Harden packaged built-in familiar asset lookup only if package testing exposes a failure.
 - `apps/desktop/src/check-packaging-contract.ts`
   - Deterministic packaging config/content guard where practical.
 - `docs/mvp-validation.md`
@@ -139,7 +139,7 @@ Root scripts should build relevant workspace dependencies before packaging. For
 
 ```json
 {
-  "package:desktop:dir": "pnpm build && pnpm --filter @open-pets/desktop package:dir"
+  "package:desktop:dir": "pnpm build && pnpm --filter @familiaros/desktop package:dir"
 }
 ```
 
@@ -154,10 +154,10 @@ Candidate includes:
 - `dist/**`
 - `preload.cjs`
 - `assets/**`
-- built workspace runtime dependencies needed by desktop imports, especially `@open-pets/claude` and `@open-pets/client`
+- built workspace runtime dependencies needed by desktop imports, especially `@familiaros/claude` and `@familiaros/client`
 - `package.json`
 
-If built-in pet assets live outside those paths or are resolved through `app.getAppPath()`, include them explicitly and adjust path helpers. If the bundled default pet is generated/rendered from compiled code rather than external files, document that in the packaging contract.
+If built-in familiar assets live outside those paths or are resolved through `app.getAppPath()`, include them explicitly and adjust path helpers. If the bundled default familiar is generated/rendered from compiled code rather than external files, document that in the packaging contract.
 
 The generated package must not depend on symlinks that escape to the source checkout. If pnpm workspace layout causes symlink leakage, use an explicit staging/deploy step rather than shipping checkout-relative links.
 
@@ -175,7 +175,7 @@ If `electron-builder` fails because of pnpm workspace dependency layout:
 
 Phase 10A must not pretend packaged Claude works while packages are private/unpublished.
 
-Agent Setup published mode may still show `npx -y @open-pets/...`, but `docs/mvp-validation.md` should state that a packaged end-to-end Claude demo requires Phase 10B unless those packages have been published.
+Agent Setup published mode may still show `npx -y @familiaros/...`, but `docs/mvp-validation.md` should state that a packaged end-to-end Claude demo requires Phase 10B unless those packages have been published.
 
 Local dev command mode should stay disabled in packaged builds, because absolute checkout paths are not suitable for a distributed app.
 
@@ -185,9 +185,9 @@ Local dev command mode should stay disabled in packaged builds, because absolute
 
 ```text
 Area                      Phase 10A status
-Tray/default pet packaged  Verify now
+Tray/default familiar packaged  Verify now
 Onboarding packaged        Verify now
-Pet Manager packaged       Verify now
+Familiar Manager packaged       Verify now
 Claude MCP via npx         Deferred unless packages published
 Claude hooks via npx       Deferred unless packages published
 Packaged bundled commands  Phase 10B
@@ -244,15 +244,15 @@ pnpm package:desktop:dir
 
 2. Launch the generated app from the package output.
 3. Confirm tray icon appears.
-4. Confirm default pet appears and can be shown/hidden/paused/resumed.
+4. Confirm default familiar appears and can be shown/hidden/paused/resumed.
 5. Complete or reset onboarding and confirm it behaves correctly in packaged mode.
-6. Open Pet Manager and confirm installed pets/catalog state renders.
+6. Open Familiar Manager and confirm installed familiars/catalog state renders.
 7. Open Settings and toggle a preference; restart packaged app and confirm persistence.
 8. Confirm local IPC discovery is created in a per-user location while the app runs and cleaned/stale-safe on quit as documented.
    - While the packaged app is running, use an existing checkout client smoke/status command if available to verify discovery, token, and status endpoint against the packaged app.
 9. Open Agent Setup and confirm local dev mode is unavailable/clearly dev-only in packaged builds.
 10. Confirm docs clearly mark packaged Claude MCP/hooks as deferred to Phase 10B unless npm packages are published. Do not apply Claude MCP/hooks from the packaged app during Phase 10A unless intentionally testing published packages.
-11. If catalog/fixture is available, install a pet and set it as default in packaged mode; if unavailable, mark catalog install as unverified and record the catalog error.
+11. If catalog/fixture is available, install a familiar and set it as default in packaged mode; if unavailable, mark catalog install as unverified and record the catalog error.
 12. Quit from tray and confirm clean exit.
 
 ## Oracle plan review
@@ -261,7 +261,7 @@ Reviewed by Oracle after user chose to split broad Phase 10 into Phase 10A/10B.
 
 Blocker:
 
-- Even with Claude end-to-end deferred, desktop imports `@open-pets/claude` through Agent Setup, and that imports `@open-pets/client`. Phase 10A must explicitly include those workspace runtime deps' built files or use staging/deploy; packaging only desktop `dist`, preload, assets, and package metadata is likely insufficient.
+- Even with Claude end-to-end deferred, desktop imports `@familiaros/claude` through Agent Setup, and that imports `@familiaros/client`. Phase 10A must explicitly include those workspace runtime deps' built files or use staging/deploy; packaging only desktop `dist`, preload, assets, and package metadata is likely insufficient.
 
 Should-fix feedback:
 
@@ -270,13 +270,13 @@ Should-fix feedback:
 - Add post-package content checks, not only config checks.
 - Add manual local IPC smoke step from checkout against packaged app.
 - Strengthen Agent Setup warning: do not apply Claude MCP/hooks in Phase 10A packaged app unless packages are actually published.
-- Pet Manager verification should include install/set-default if catalog/fixture is available, or explicitly mark catalog install unverified if unavailable.
+- Familiar Manager verification should include install/set-default if catalog/fixture is available, or explicitly mark catalog install unverified if unavailable.
 
 Nice-to-have feedback:
 
 - Keep Phase 10A to `electron-builder --dir` first.
 - Prefer staging/deploy over root linker changes if pnpm fights builder.
-- Clarify bundled default pet assets if generated rather than file assets.
+- Clarify bundled default familiar assets if generated rather than file assets.
 
 Verdict: original packaged-Claude blocker is resolved by the split. Phase 10A is nearly implementation-ready after making workspace runtime dependency inclusion a hard acceptance criterion.
 
@@ -284,14 +284,14 @@ Verdict: original packaged-Claude blocker is resolved by the split. Phase 10A is
 
 Fixed:
 
-- Added hard acceptance criterion for packaged workspace runtime deps, especially `@open-pets/claude` and `@open-pets/client`.
+- Added hard acceptance criterion for packaged workspace runtime deps, especially `@familiaros/claude` and `@familiaros/client`.
 - Added no-escaping-symlink acceptance criterion.
 - Made electron-builder config expectations explicit.
 - Added post-package content check requirement.
 - Added local IPC smoke verification step.
 - Strengthened packaged Agent Setup warning not to apply Claude MCP/hooks unless packages are actually published.
-- Added Pet Manager install/set-default manual check when catalog/fixture is available, with explicit unverified note if unavailable.
-- Clarified default pet assets may be generated/runtime code rather than external files.
+- Added Familiar Manager install/set-default manual check when catalog/fixture is available, with explicit unverified note if unavailable.
+- Clarified default familiar assets may be generated/runtime code rather than external files.
 
 Accepted:
 
@@ -310,7 +310,7 @@ Blockers: none.
 
 Should-fix feedback:
 
-- Manually verify the packaged GUI before closing Phase 10A: tray, default pet, onboarding, Pet Manager, Settings, IPC smoke, quit cleanup.
+- Manually verify the packaged GUI before closing Phase 10A: tray, default familiar, onboarding, Familiar Manager, Settings, IPC smoke, quit cleanup.
 - Tighten or explicitly disposition package over-inclusion. Current unpacked app may include workspace package `src/`, `tsconfig.json`, built check scripts, and source maps. This is acceptable for local inspectable Phase 10A if documented, but does not fully match runtime-only packaging intent.
 - Extend package output contract checks to third-party runtime deps such as `yauzl` and transitive deps.
 
diff --git a/docs/phases/phase-10b-packaged-claude-command-distribution.md b/docs/phases/phase-10b-packaged-claude-command-distribution.md
index c0ae7182..8d6e1f02 100644
--- a/docs/phases/phase-10b-packaged-claude-command-distribution.md
+++ b/docs/phases/phase-10b-packaged-claude-command-distribution.md
@@ -2,7 +2,7 @@
 
 ## Goal
 
-Make the packaged OpenPets desktop app capable of configuring Claude Code without relying on unpublished `npx @open-pets/*` packages.
+Make the packaged FamiliarOS desktop app capable of configuring Claude Code without relying on unpublished `npx @familiaros/*` packages.
 
 Phase 10B should add a packaged/bundled command mode that points Claude MCP and Claude hooks at JavaScript entry points shipped inside the packaged app resources.
 
@@ -24,30 +24,30 @@ In the packaged app, Agent Setup no longer asks users to configure private/unpub
 Instead, packaged Agent Setup previews and installs commands like:
 
 ```text
-node <packaged-app-resource>/app/node_modules/@open-pets/mcp/dist/index.js
-node <packaged-app-resource>/app/node_modules/@open-pets/claude/dist/cli.js hook --openpets-managed
+node <packaged-app-resource>/app/node_modules/@familiaros/mcp/dist/index.js
+node <packaged-app-resource>/app/node_modules/@familiaros/claude/dist/cli.js hook --familiaros-managed
 ```
 
 The exact path is platform-specific, but it must be inside the packaged app output/resources and must be a regular file.
 
 In dev/unpackaged mode, the existing behavior remains:
 
-- published mode: `npx -y @open-pets/...`
+- published mode: `npx -y @familiaros/...`
 - local dev mode: built checkout `dist` paths
 
 ## Acceptance criteria
 
-- `@open-pets/desktop` packages the runtime packages required for bundled Claude commands:
-  - `@open-pets/mcp`,
-  - `@open-pets/claude`,
-  - `@open-pets/client`,
+- `@familiaros/desktop` packages the runtime packages required for bundled Claude commands:
+  - `@familiaros/mcp`,
+  - `@familiaros/claude`,
+  - `@familiaros/client`,
   - required third-party runtime dependencies.
 - Agent Setup chooses command mode by environment:
   - packaged app: bundled packaged mode,
   - dev app: published/local dev toggle remains available.
 - The Agent Setup renderer/preload accepts and renders bundled command mode snapshots without treating them as invalid.
 - Packaged Agent Setup checks Node availability for Claude-launched commands, or clearly disables configure/install with a warning if Node is unavailable/too old.
-- Packaged mode command previews use `node <packaged resource path>` and never `npx -y @open-pets/...` unless the user is explicitly in published mode in dev.
+- Packaged mode command previews use `node <packaged resource path>` and never `npx -y @familiaros/...` unless the user is explicitly in published mode in dev.
 - Packaged MCP command points at a regular file shipped inside package resources.
 - Packaged hook command points at a regular file shipped inside package resources.
 - Packaged command paths are not source-checkout paths and do not use `app.getAppPath()` assumptions that fail after packaging.
@@ -60,8 +60,8 @@ In dev/unpackaged mode, the existing behavior remains:
   - command contains no newline/null/unsupported shell characters.
 - Missing bundled resources produce an actionable Agent Setup status/error, not an unhandled IPC failure.
 - Claude MCP configure/replace/remove still uses `claude mcp ...` and still requires explicit user button actions.
-- Claude hook install/update/uninstall still writes only OpenPets-managed hooks and still creates backups.
-- Doctor/preview text clearly labels packaged bundled mode and explains commands point into the installed OpenPets app.
+- Claude hook install/update/uninstall still writes only FamiliarOS-managed hooks and still creates backups.
+- Doctor/preview text clearly labels packaged bundled mode and explains commands point into the installed FamiliarOS app.
 - If packaged bundled command resources are missing, Agent Setup shows an actionable error and disables configure/install actions rather than falling back silently to unpublished `npx` packages.
 - Existing contract checks cover packaged bundled command files in package output.
 - Existing Claude code/hooks contract checks cover bundled command preview/matching behavior.
@@ -87,7 +87,7 @@ In dev/unpackaged mode, the existing behavior remains:
 - `apps/desktop/preload.cjs`
   - Accept/render `commandMode: "bundled"` snapshots and label bundled mode clearly.
 - `apps/desktop/package.json`
-  - Add `@open-pets/mcp` as a desktop runtime dependency so packaged output includes it.
+  - Add `@familiaros/mcp` as a desktop runtime dependency so packaged output includes it.
 - `apps/desktop/src/check-packaging-contract.ts`
   - Require packaged MCP/Claude/client entry files and MCP runtime deps.
 - `docs/mvp-validation.md`
@@ -98,7 +98,7 @@ In dev/unpackaged mode, the existing behavior remains:
 
 ### Command mode model
 
-Extend `OpenPetsCommandMode` from:
+Extend `FamiliarOSCommandMode` from:
 
 ```ts
 "published" | "local"
@@ -114,13 +114,13 @@ Semantics:
 
 - `published`: npm/npx package names.
 - `local`: checkout-relative built `dist` files for development.
-- `bundled`: package-relative files shipped in the packaged app's `node_modules/@open-pets/*/dist` directories.
+- `bundled`: package-relative files shipped in the packaged app's `node_modules/@familiaros/*/dist` directories.
 
-For current unpacked Phase 10A packaging (`asar: false`), `bundled` paths can be resolved from `@open-pets/claude`'s own `import.meta.url` in packaged node_modules:
+For current unpacked Phase 10A packaging (`asar: false`), `bundled` paths can be resolved from `@familiaros/claude`'s own `import.meta.url` in packaged node_modules:
 
 ```text
-.../Resources/app/node_modules/@open-pets/claude/dist
-.../Resources/app/node_modules/@open-pets/mcp/dist/index.js
+.../Resources/app/node_modules/@familiaros/claude/dist
+.../Resources/app/node_modules/@familiaros/mcp/dist/index.js
 ```
 
 This mirrors the current `local` sibling-package resolution, but should be named `bundled` so the UI does not imply a fragile source checkout path.
@@ -135,15 +135,15 @@ In desktop Agent Setup:
 
 ### Hook settings
 
-Bundled hook settings should still use the OpenPets marker:
+Bundled hook settings should still use the FamiliarOS marker:
 
 ```text
-node "<path>/@open-pets/claude/dist/cli.js" hook --openpets-managed
+node "<path>/@familiaros/claude/dist/cli.js" hook --familiaros-managed
 ```
 
-Uninstall must continue to remove any OpenPets-managed hooks by marker, including old published/local commands.
+Uninstall must continue to remove any FamiliarOS-managed hooks by marker, including old published/local commands.
 
-Install/update should replace old OpenPets-managed published/local commands with bundled commands when running from packaged app.
+Install/update should replace old FamiliarOS-managed published/local commands with bundled commands when running from packaged app.
 
 ### MCP settings
 
@@ -153,23 +153,23 @@ Bundled MCP settings should configure Claude with:
 {
   "type": "stdio",
   "command": "node",
-  "args": ["<path>/@open-pets/mcp/dist/index.js"]
+  "args": ["<path>/@familiaros/mcp/dist/index.js"]
 }
 ```
 
-If a pet is selected:
+If a familiar is selected:
 
 ```json
-"args": ["<path>/@open-pets/mcp/dist/index.js", "--pet", "pet-id"]
+"args": ["<path>/@familiaros/mcp/dist/index.js", "--familiar", "familiar-id"]
 ```
 
 ### Packaging contract
 
 Package output checks should assert:
 
-- `node_modules/@open-pets/mcp/dist/index.js` exists.
-- `node_modules/@open-pets/claude/dist/cli.js` exists.
-- `node_modules/@open-pets/client/dist/index.js` exists.
+- `node_modules/@familiaros/mcp/dist/index.js` exists.
+- `node_modules/@familiaros/claude/dist/cli.js` exists.
+- `node_modules/@familiaros/client/dist/index.js` exists.
 - required MCP third-party dependencies exist (`@modelcontextprotocol/sdk`, `zod`, etc.) if included by builder.
 - no symlink escapes package output.
 
@@ -187,7 +187,7 @@ Do not silently fall back to `npx` in packaged app if bundled resources are miss
 
 ## Risks and tradeoffs
 
-- **Installed app path moves.** Claude settings will contain absolute paths into the installed app; if the user moves/deletes OpenPets, Agent Setup doctor should report needs update/error and the user should reinstall/update config.
+- **Installed app path moves.** Claude settings will contain absolute paths into the installed app; if the user moves/deletes FamiliarOS, Agent Setup doctor should report needs update/error and the user should reinstall/update config.
 - **ASAR disabled in Phase 10A.** Bundled commands rely on regular files. If ASAR is enabled later, MCP/Claude command files must move to `asarUnpack` or `extraResources`.
 - **Node availability.** Commands use `node`, so users still need Node available for Claude to launch MCP/hooks. This matches the project's Node/npm/npx direction and avoids bundling a separate runtime in this phase.
 - **Cross-platform paths.** Windows paths with spaces must be handled through Claude MCP arg arrays and shell-quoted hook command strings.
@@ -196,10 +196,10 @@ Do not silently fall back to `npx` in packaged app if bundled resources are miss
 
 - No silent Claude configuration changes.
 - Backups remain required before Claude settings hook writes.
-- Bundled commands are local files shipped with OpenPets, not remote downloads.
+- Bundled commands are local files shipped with FamiliarOS, not remote downloads.
 - No TCP/HTTP control plane is introduced.
 - Speech/privacy rules from earlier phases remain unchanged.
-- Uninstall removes only OpenPets-managed hooks by marker.
+- Uninstall removes only FamiliarOS-managed hooks by marker.
 
 ## Test/check plan
 
@@ -233,8 +233,8 @@ pnpm package:desktop:dir
 
 2. Launch the packaged app.
 3. Open Agent Setup.
-4. Confirm command preview uses `node <packaged .../node_modules/@open-pets/mcp/dist/index.js>`, not `npx -y @open-pets/mcp`.
-5. Confirm hook preview uses `node <packaged .../node_modules/@open-pets/claude/dist/cli.js> hook --openpets-managed`.
+4. Confirm command preview uses `node <packaged .../node_modules/@familiaros/mcp/dist/index.js>`, not `npx -y @familiaros/mcp`.
+5. Confirm hook preview uses `node <packaged .../node_modules/@familiaros/claude/dist/cli.js> hook --familiaros-managed`.
 6. Configure Claude MCP only if you are ready to update your user Claude settings; verify backup/config behavior as in earlier phases.
 7. Install/update hooks only if you are ready to update your user Claude settings; verify backup/config behavior as in earlier phases.
 8. Run Claude Code and confirm MCP/hook behavior if desired.
@@ -254,8 +254,8 @@ Should-fix feedback:
 - Validate bundled paths with `realpath` against the packaged app root, not simple string prefix. Reject missing files, directories, symlinks, `.asar` paths unless unpacked, newline/NUL/quote/shell-dangerous chars.
 - Ensure missing bundled resources produce actionable Agent Setup status/error instead of unhandled IPC failure.
 - Add cross-platform tests for paths with spaces/backslashes, MCP args arrays, hook shell quoting, and bundled `claude mcp get` parsing.
-- Extend package contract checks to require `@open-pets/mcp/dist/index.js` plus runtime deps like `@modelcontextprotocol/sdk` and `zod`.
-- Update docs to state Claude settings contain absolute OpenPets app paths; moving/deleting/updating the app may require Agent Setup replace/update/remove.
+- Extend package contract checks to require `@familiaros/mcp/dist/index.js` plus runtime deps like `@modelcontextprotocol/sdk` and `zod`.
+- Update docs to state Claude settings contain absolute FamiliarOS app paths; moving/deleting/updating the app may require Agent Setup replace/update/remove.
 
 Nice-to-have feedback:
 
@@ -302,7 +302,7 @@ Should-fix feedback:
 
 Nice-to-have feedback:
 
-- Make bundled tests explicitly depend on built `@open-pets/mcp` or avoid relying on stale sibling `dist` state.
+- Make bundled tests explicitly depend on built `@familiaros/mcp` or avoid relying on stale sibling `dist` state.
 - Clarify Node PATH check is best-effort because Claude's runtime environment may differ.
 - Keep ASAR/`extraResources` deferred as documented.
 
diff --git a/docs/phases/phase-10c-asar-runtime-packaging.md b/docs/phases/phase-10c-asar-runtime-packaging.md
index 3263690f..2b03561b 100644
--- a/docs/phases/phase-10c-asar-runtime-packaging.md
+++ b/docs/phases/phase-10c-asar-runtime-packaging.md
@@ -28,8 +28,8 @@ The generated app uses ASAR for the Electron app contents, but still includes un
 
 ```text
 app.asar
-app.asar.unpacked/node_modules/@open-pets/mcp/dist/index.js
-app.asar.unpacked/node_modules/@open-pets/claude/dist/cli.js
+app.asar.unpacked/node_modules/@familiaros/mcp/dist/index.js
+app.asar.unpacked/node_modules/@familiaros/claude/dist/cli.js
 ```
 
 Agent Setup packaged previews should point at `app.asar.unpacked/...` paths, not `app.asar/...` paths and not source checkout paths.
@@ -38,8 +38,8 @@ Agent Setup packaged previews should point at `app.asar.unpacked/...` paths, not
 
 - `electron-builder` ASAR packaging is enabled.
 - Externally executed bundled command files are unpacked:
-  - `@open-pets/mcp/dist/index.js`,
-  - `@open-pets/claude/dist/cli.js`,
+  - `@familiaros/mcp/dist/index.js`,
+  - `@familiaros/claude/dist/cli.js`,
   - package metadata (`package.json`) needed for ESM/package resolution,
   - all runtime files and transitive dependencies those commands need when launched by external `node`.
 - Packaged Agent Setup bundled MCP preview points at a regular file outside `app.asar`, preferably under `app.asar.unpacked`.
@@ -63,7 +63,7 @@ Agent Setup packaged previews should point at `app.asar.unpacked/...` paths, not
 ## Proposed files/directories
 
 - `apps/desktop/electron-builder.yml`
-  - Enable ASAR and configure unpacking for externally executed OpenPets command resources.
+  - Enable ASAR and configure unpacking for externally executed FamiliarOS command resources.
 - `packages/claude/src/claude-code.ts`
   - Resolve bundled MCP path to ASAR-unpacked location when running from ASAR.
 - `packages/claude/src/hook-settings.ts`
@@ -92,9 +92,9 @@ Use `asarUnpack` for externally executed command resources and their module meta
 
 ```yaml
 asarUnpack:
-  - node_modules/@open-pets/mcp/**
-  - node_modules/@open-pets/claude/**
-  - node_modules/@open-pets/client/**
+  - node_modules/@familiaros/mcp/**
+  - node_modules/@familiaros/claude/**
+  - node_modules/@familiaros/client/**
   - node_modules/@modelcontextprotocol/**
   - node_modules/zod/**
 ```
@@ -103,15 +103,15 @@ If runtime smoke testing shows additional MCP SDK transitive dependencies are re
 
 ### Path mapping
 
-When `@open-pets/claude` runs inside Electron from `app.asar`, its `import.meta.url` may include `app.asar`. Bundled command paths for Claude must map to `app.asar.unpacked`.
+When `@familiaros/claude` runs inside Electron from `app.asar`, its `import.meta.url` may include `app.asar`. Bundled command paths for Claude must map to `app.asar.unpacked`.
 
 Add a pure, tested path mapper with behavior:
 
 ```text
-.../Resources/app.asar/node_modules/@open-pets/claude/dist/index.js
+.../Resources/app.asar/node_modules/@familiaros/claude/dist/index.js
 =>
-.../Resources/app.asar.unpacked/node_modules/@open-pets/claude/dist/cli.js
-.../Resources/app.asar.unpacked/node_modules/@open-pets/mcp/dist/index.js
+.../Resources/app.asar.unpacked/node_modules/@familiaros/claude/dist/cli.js
+.../Resources/app.asar.unpacked/node_modules/@familiaros/mcp/dist/index.js
 ```
 
 In dev/non-ASAR mode, continue resolving sibling workspace package paths as today.
@@ -131,8 +131,8 @@ Because forbidden-file checks cannot simply walk inside `app.asar` as a director
 Post-package smoke checks should execute:
 
 ```bash
-node <app.asar.unpacked>/node_modules/@open-pets/mcp/dist/index.js --version
-node <app.asar.unpacked>/node_modules/@open-pets/claude/dist/cli.js hook --openpets-managed
+node <app.asar.unpacked>/node_modules/@familiaros/mcp/dist/index.js --version
+node <app.asar.unpacked>/node_modules/@familiaros/claude/dist/cli.js hook --familiaros-managed
 ```
 
 The hook smoke must use isolated/missing discovery input so it does not contact a real desktop app.
@@ -149,7 +149,7 @@ The hook smoke must use isolated/missing discovery input so it does not contact
 - Do not weaken renderer sandbox/context isolation/CSP.
 - Do not include user data, Claude settings, backups, or secrets in package output.
 - Claude config changes remain explicit/backup-protected.
-- Externally executed command files must be shipped by OpenPets, not downloaded dynamically.
+- Externally executed command files must be shipped by FamiliarOS, not downloaded dynamically.
 
 ## Test/check plan
 
diff --git a/docs/phases/phase-10e-app-icon-package-identity.md b/docs/phases/phase-10e-app-icon-package-identity.md
index addd1c06..e3d66f5a 100644
--- a/docs/phases/phase-10e-app-icon-package-identity.md
+++ b/docs/phases/phase-10e-app-icon-package-identity.md
@@ -2,7 +2,7 @@
 
 ## Goal
 
-Replace the default Electron packaged-app icon with OpenPets-owned package icon assets while keeping tray icon behavior unchanged.
+Replace the default Electron packaged-app icon with FamiliarOS-owned package icon assets while keeping tray icon behavior unchanged.
 
 This phase removes the remaining default-icon packaging warning for the current macOS package and documents Windows/Linux icon follow-up if needed.
 
@@ -16,7 +16,7 @@ This phase removes the remaining default-icon packaging warning for the current
 
 ## User-visible/manual outcome
 
-The packaged app no longer uses Electron's default app icon. On macOS package output, `OpenPets.app` has an OpenPets MVP app icon. If generated from the current 64×64 source, the icon is temporary and may look soft at large sizes.
+The packaged app no longer uses Electron's default app icon. On macOS package output, `FamiliarOS.app` has an FamiliarOS MVP app icon. If generated from the current 64×64 source, the icon is temporary and may look soft at large sizes.
 
 ## Acceptance criteria
 
@@ -35,7 +35,7 @@ The packaged app no longer uses Electron's default app icon. On macOS package ou
 ## Proposed files/directories
 
 - `apps/desktop/assets/app-icon.icns`
-  - macOS app icon generated from OpenPets-owned source art.
+  - macOS app icon generated from FamiliarOS-owned source art.
 - `apps/desktop/electron-builder.yml`
   - Add macOS icon config.
 - `apps/desktop/src/check-packaging-contract.ts`
diff --git a/docs/phases/phase-11-mvp-closeout-release-readiness.md b/docs/phases/phase-11-mvp-closeout-release-readiness.md
index a4635d47..db0d3fdc 100644
--- a/docs/phases/phase-11-mvp-closeout-release-readiness.md
+++ b/docs/phases/phase-11-mvp-closeout-release-readiness.md
@@ -2,7 +2,7 @@
 
 ## Goal
 
-Turn the current packaged OpenPets MVP into a clear, repeatable release-readiness checkpoint.
+Turn the current packaged FamiliarOS MVP into a clear, repeatable release-readiness checkpoint.
 
 This phase should consolidate the validation work from Phase 10A-10E into one broader MVP closeout pass: document exactly what is ready, what remains unverified, how to manually validate the package, and fix any small readiness gaps found while doing that review.
 
@@ -84,10 +84,10 @@ If small readiness bugs are found during this pass, they are fixed in this phase
 
 ## Security/privacy notes
 
-- Automated tests and package checks must keep using temp fixtures and must not modify real Claude settings or real user OpenPets state.
+- Automated tests and package checks must keep using temp fixtures and must not modify real Claude settings or real user FamiliarOS state.
 - MVP docs should warn users before they use Agent Setup actions that mutate Claude settings.
-- Speech/privacy rules from earlier phases remain unchanged: short safe pet messages only, no code/logs/secrets/URLs/path-like content.
-- Cleanup guidance should distinguish OpenPets app data from Claude configuration so users do not assume deleting the app removes agent integrations.
+- Speech/privacy rules from earlier phases remain unchanged: short safe familiar messages only, no code/logs/secrets/URLs/path-like content.
+- Cleanup guidance should distinguish FamiliarOS app data from Claude configuration so users do not assume deleting the app removes agent integrations.
 
 ## Test/check plan
 
@@ -109,14 +109,14 @@ The revised checklist must explicitly cover:
 
 1. Launching the packaged app from `apps/desktop/dist-electron/`.
 2. Tray icon/menu presence.
-3. Default pet show/hide, pause/resume, drag, and persistence basics.
+3. Default familiar show/hide, pause/resume, drag, and persistence basics.
 4. Onboarding presence/completion or documented reset path.
-5. Pet Manager installed/catalog state rendering.
+5. Familiar Manager installed/catalog state rendering.
 6. Settings preference toggle and restart persistence.
-7. Local IPC smoke with `pnpm --filter @open-pets/client smoke:status` while the packaged app is running.
-8. Agent Setup preview showing bundled `node .../app.asar.unpacked/...` commands, not unpublished `npx -y @open-pets/*` commands.
+7. Local IPC smoke with `pnpm --filter @familiaros/client smoke:status` while the packaged app is running.
+8. Agent Setup preview showing bundled `node .../app.asar.unpacked/...` commands, not unpublished `npx -y @familiaros/*` commands.
 9. Claude configure/install as an optional mutating step only, with backups and remove/uninstall cleanup called out.
-10. Quitting OpenPets from the tray.
+10. Quitting FamiliarOS from the tray.
 
 ## MVP scope statement
 
@@ -129,7 +129,7 @@ The readiness guide must clearly document these prerequisites and limitations:
 - The package is unsigned and not notarized.
 - Windows/Linux package behavior, installers, auto-update, and public distribution are unverified/deferred.
 - Claude settings may contain absolute paths into the packaged app and should be replaced/removed after moving or deleting the app.
-- OpenPets app data cleanup and Claude config cleanup are separate.
+- FamiliarOS app data cleanup and Claude config cleanup are separate.
 
 ## Oracle plan review
 
@@ -150,7 +150,7 @@ Nice-to-have feedback:
 
 - Add a concise readiness status table.
 - Include artifact identity details such as output path, app version, date/commit/manual tester fields.
-- Add cleanup/data-loss notes distinguishing OpenPets app data from Claude config.
+- Add cleanup/data-loss notes distinguishing FamiliarOS app data from Claude config.
 
 Verdict: not implementation-ready until command-order, checklist, and scope-boundary issues are fixed.
 
@@ -169,7 +169,7 @@ Accepted for implementation:
 
 - Add readiness status table.
 - Add artifact identity fields where useful.
-- Add cleanup/data-loss notes distinguishing OpenPets app data from Claude config.
+- Add cleanup/data-loss notes distinguishing FamiliarOS app data from Claude config.
 
 ## Oracle implementation review
 
diff --git a/docs/phases/phase-12-actual-pet-animation-polish.md b/docs/phases/phase-12-actual-pet-animation-polish.md
index 5a5f4a8b..4230605e 100644
--- a/docs/phases/phase-12-actual-pet-animation-polish.md
+++ b/docs/phases/phase-12-actual-pet-animation-polish.md
@@ -1,57 +1,57 @@
-# Phase 12: Actual Pet Animation Polish
+# Phase 12: Actual Familiar Animation Polish
 
 ## Goal
 
-Replace the placeholder-feeling built-in pet experience with an actual animated pet renderer and premium compact chat bubble that feel alive in the packaged app.
+Replace the placeholder-feeling built-in familiar experience with an actual animated familiar renderer and premium compact chat bubble that feel alive in the packaged app.
 
-This phase should make the default OpenPets experience look like a real desktop companion instead of a CSS/wireframe prototype, while preserving the stable packaging, IPC, Claude, and pet-install safety work already completed.
+This phase should make the default FamiliarOS experience look like a real desktop companion instead of a CSS/wireframe prototype, while preserving the stable packaging, IPC, Claude, and familiar-install safety work already completed.
 
 ## Non-goals
 
 - No public marketplace/catalog redesign.
 - No signing, notarization, installer, or distribution changes.
 - No new agent integrations.
-- No broad Pet Manager/Agent Setup UI redesign unless needed to preview the actual pet.
+- No broad Familiar Manager/Agent Setup UI redesign unless needed to preview the actual familiar.
 - No complex physics simulation.
 - No audio.
-- No unvalidated remote pet format expansion that weakens install safety.
+- No unvalidated remote familiar format expansion that weakens install safety.
 
 ## User-visible/manual outcome
 
-When the user launches OpenPets, the default pet appears as an actual animated sprite/visual companion, not a simple CSS mascot or static image.
+When the user launches FamiliarOS, the default familiar appears as an actual animated sprite/visual companion, not a simple CSS mascot or static image.
 
-The pet should:
+The familiar should:
 
 - idle with a high-quality loop,
 - switch to directional drag/move animation based on mouse drag direction,
 - react visibly to pause/resume,
 - show premium compact speech/reaction bubbles cleanly,
-- stay transparent/framed like a desktop pet,
+- stay transparent/framed like a desktop familiar,
 - remain draggable and non-disruptive,
 - package correctly in the macOS local app.
 
 ## Acceptance criteria
 
-- A real bundled default pet visual asset exists in `apps/desktop/assets/` or another packaged desktop asset location.
-- Bundled pet asset contract is explicit:
-  - source file: `apps/desktop/assets/default-pet-spritesheet.webp`, copied from the real catalog material for Claude (`https://zip.openpets.dev/pets/claude-f187e74a/claude.zip` / `web/public/pets/claude-f187e74a/spritesheet.webp`),
+- A real bundled default familiar visual asset exists in `apps/desktop/assets/` or another packaged desktop asset location.
+- Bundled familiar asset contract is explicit:
+  - source file: `apps/desktop/assets/default-familiar-spritesheet.webp`, copied from the real catalog material for Claude (`https://zip.familiaros.dev/familiars/claude-f187e74a/claude.zip` / `web/public/familiars/claude-f187e74a/spritesheet.webp`),
   - no remote runtime art fetch,
   - known frame layout/dimensions documented in code comments or constants: 1536×1872, 8 columns × 9 rows, 192×208 frames,
   - at minimum supports `idle`, `run-left`, and `run-right` visual states,
-  - no SVG-coded/generated substitute for the default pet.
-- The built-in default pet renderer uses the asset instead of the CSS-only mascot.
-- The pet renderer supports at least an idle animation loop for the bundled pet.
-- Dragging the pet changes animation/direction based on mouse movement:
+  - no SVG-coded/generated substitute for the default familiar.
+- The built-in default familiar renderer uses the asset instead of the CSS-only mascot.
+- The familiar renderer supports at least an idle animation loop for the bundled familiar.
+- Dragging the familiar changes animation/direction based on mouse movement:
   - dragging right uses a right-facing/running-right visual state,
   - dragging left uses a left-facing/running-left visual state,
   - stopping drag settles back to idle without jitter.
 - Drag-direction detection does not rely on renderer pointer events inside `-webkit-app-region: drag`.
-- Installed-pet rendering uses the same current catalog sprite contract as the built-in default pet: 1536×1872 WebP, 8 columns × 9 rows, 192×208 frames, with idle/run-right/run-left rows animated instead of showing the full spritesheet.
+- Installed-familiar rendering uses the same current catalog sprite contract as the built-in default familiar: 1536×1872 WebP, 8 columns × 9 rows, 192×208 frames, with idle/run-right/run-left rows animated instead of showing the full spritesheet.
 - Pause/resume visibly affects animation without breaking window transparency or input behavior.
 - Speech/reaction bubble styling is polished enough for MVP: premium compact text, readable typography, subtle depth, clean pointer, constrained dimensions, gentle entrance/exit, not huge, not wireframe, and does not expose unsafe message content beyond existing filtering.
-- Pet window sizing/clamping accounts for the actual visual asset and bubble space.
+- Familiar window sizing/clamping accounts for the actual visual asset and bubble space.
 - The tray icon and packaged app icon behavior remain unchanged.
-- Package contract checks cover the new bundled pet asset(s).
+- Package contract checks cover the new bundled familiar asset(s).
 - Package contract checks verify the source asset exists, is non-empty, and remains covered by packaged `assets/**` inclusion.
 - `pnpm test` passes.
 - `pnpm check` passes.
@@ -61,34 +61,34 @@ The pet should:
 ## Proposed files/directories
 
 - `apps/desktop/assets/`
-  - Add bundled default pet sprite/asset file(s).
-- `apps/desktop/src/pet-window.ts`
-  - Replace CSS-only built-in pet with asset-backed rendering.
-  - Add animation-state CSS/JS for bundled pet.
+  - Add bundled default familiar sprite/asset file(s).
+- `apps/desktop/src/familiar-window.ts`
+  - Replace CSS-only built-in familiar with asset-backed rendering.
+  - Add animation-state CSS/JS for bundled familiar.
   - Add drag-direction animation state handling driven from safe main-process window movement signals, not renderer pointer events in draggable regions.
   - Polish bubble/reaction presentation.
-- `apps/desktop/pet-preload.cjs`
-  - Optional narrow preload for pet windows if needed to receive main-process motion events and update DOM state without enabling Node in the renderer.
-- `apps/desktop/src/built-in-pet.ts`
-  - Document or reference bundled pet asset expectations if useful.
+- `apps/desktop/familiar-preload.cjs`
+  - Optional narrow preload for familiar windows if needed to receive main-process motion events and update DOM state without enabling Node in the renderer.
+- `apps/desktop/src/built-in-familiar.ts`
+  - Document or reference bundled familiar asset expectations if useful.
 - `apps/desktop/src/display.ts`
-  - Adjust default pet window sizing if the actual pet needs more space.
+  - Adjust default familiar window sizing if the actual familiar needs more space.
 - `apps/desktop/src/check-packaging-contract.ts`
-  - Assert bundled pet asset(s) are present and packaged.
+  - Assert bundled familiar asset(s) are present and packaged.
 - `docs/mvp-validation.md`
-  - Update manual validation checklist to include actual animated pet quality checks.
-- `docs/phases/phase-12-actual-pet-animation-polish.md`
+  - Update manual validation checklist to include actual animated familiar quality checks.
+- `docs/phases/phase-12-actual-familiar-animation-polish.md`
   - This phase spec, reviews, and dispositions.
 
 ## Technical approach
 
 1. Choose a safe MVP asset strategy:
    - Use a repository-owned bundled WebP/PNG sprite asset from the existing catalog materials.
-   - Do not use SVG-coded/generated substitute art for the default pet.
+   - Do not use SVG-coded/generated substitute art for the default familiar.
    - Initial target contract: one local 1536×1872 sprite sheet with 8 columns × 9 rows, 192×208 frames, and rows/states for `idle`, `run-left`, and `run-right`.
    - Do not fetch remote art at runtime.
-2. Implement asset-backed built-in pet rendering:
-   - Keep the pet window sandboxed/context-isolated.
+2. Implement asset-backed built-in familiar rendering:
+   - Keep the familiar window sandboxed/context-isolated.
    - Keep CSP strict and allow only the needed local/data image sources (`img-src file: data:` for file-backed images).
    - If renderer-side state JS is required, prefer a narrow preload listening for whitelisted IPC messages. Do not enable Node integration, remote scripts, eval, or broad renderer privileges.
    - Preserve transparent frameless always-on-top behavior.
@@ -97,38 +97,38 @@ The pet should:
    - Avoid heavy dependencies.
    - Respect pause/resume with `animation-play-state` or equivalent.
    - During drag, infer horizontal drag direction from main-process `BrowserWindow` movement deltas because Electron draggable regions do not reliably deliver renderer pointer events.
-   - Send only whitelisted motion states (`idle`, `run-left`, `run-right`) to the pet renderer, via narrow preload IPC or another bounded safe bridge.
-   - Use simple thresholding/debouncing so the pet does not flicker between left/right on tiny movements.
+   - Send only whitelisted motion states (`idle`, `run-left`, `run-right`) to the familiar renderer, via narrow preload IPC or another bounded safe bridge.
+   - Use simple thresholding/debouncing so the familiar does not flicker between left/right on tiny movements.
    - Return to idle after drag stops or after a short no-movement timeout.
    - Add `prefers-reduced-motion` handling where practical.
-4. Polish the pet and chat bubble presentation:
-   - Better shadow/depth around the pet image.
+4. Polish the familiar and chat bubble presentation:
+   - Better shadow/depth around the familiar image.
    - Speech bubble with small premium typography, constrained width/height, subtle entrance/exit, pointer styling, and layered shadow instead of harsh borders.
-   - Bubble copy should feel like a compact companion status, not a toast/card: short line length, balanced wrapping, soft radius, optical alignment to the pet, and no giant empty surface.
+   - Bubble copy should feel like a compact companion status, not a toast/card: short line length, balanced wrapping, soft radius, optical alignment to the familiar, and no giant empty surface.
    - Bubble content must be rendered as escaped text/textContent only, never `innerHTML` from message content.
-   - Apply shared bubble styling to both built-in and installed pet windows so the default and installed experiences do not diverge badly.
+   - Apply shared bubble styling to both built-in and installed familiar windows so the default and installed experiences do not diverge badly.
    - No `transition: all`; animate specific transform/opacity properties only.
-5. Preserve installed pet behavior:
-   - Current installed catalog pets provide `spritesheet.webp` using the 1536×1872 / 8×9 / 192×208 contract.
-   - Render installed pets through the same CSS sprite-frame approach as the built-in default pet, not as a full-sheet image.
-   - Do not show a decorative fallback square/box behind valid installed pets.
+5. Preserve installed familiar behavior:
+   - Current installed catalog familiars provide `spritesheet.webp` using the 1536×1872 / 8×9 / 192×208 contract.
+   - Render installed familiars through the same CSS sprite-frame approach as the built-in default familiar, not as a full-sheet image.
+   - Do not show a decorative fallback square/box behind valid installed familiars.
    - If future metadata parsing is added, keep it strict and backward-compatible.
 6. Update contract checks/docs and run full validation.
 
 ## Risks and tradeoffs
 
 - Art quality can consume too much time. This phase should improve the default from wireframe to delightful MVP, not solve final branding.
-- Sprite animation format changes can break installed pets if not backward-compatible. Phase 12 assumes the current catalog/v1 1536×1872 / 8×9 / 192×208 spritesheet contract; future custom formats need explicit validation/metadata work.
+- Sprite animation format changes can break installed familiars if not backward-compatible. Phase 12 assumes the current catalog/v1 1536×1872 / 8×9 / 192×208 spritesheet contract; future custom formats need explicit validation/metadata work.
 - `-webkit-app-region: drag` prevents reliable renderer pointer events. Drag animation must be driven from main-process window movement or a narrow custom drag architecture.
 - Window transparency, draggable regions, and speech bubbles are platform-sensitive; keep the implementation simple and test packaged output.
-- Chat bubble polish can expand into broad UI redesign. Keep scope to the pet window bubble only.
+- Chat bubble polish can expand into broad UI redesign. Keep scope to the familiar window bubble only.
 - Drag-direction animation can be jittery if based on every pointer event. Use thresholds and smoothing rather than instant direction flips.
-- Larger pet/bubble sizing can move the pet unexpectedly; clamp to work area and avoid stealing focus.
+- Larger familiar/bubble sizing can move the familiar unexpectedly; clamp to work area and avoid stealing focus.
 
 ## Security/privacy notes
 
-- Bundled pet assets must be local repository assets; no runtime remote fetch.
-- Installed pet safety rules remain: no script execution, zip-slip prevention, file limits, size limits.
+- Bundled familiar assets must be local repository assets; no runtime remote fetch.
+- Installed familiar safety rules remain: no script execution, zip-slip prevention, file limits, size limits.
 - Speech safety rules remain unchanged: short messages only; no code/logs/secrets/URLs/path-like content.
 - Renderer CSP must remain restrictive.
 - Chat bubble message content must use escaped text/textContent only and must not introduce `innerHTML` injection paths.
@@ -143,32 +143,32 @@ pnpm check
 pnpm package:desktop:dir
 ```
 
-Also run focused desktop checks during implementation if package contract or pet-window code changes.
+Also run focused desktop checks during implementation if package contract or familiar-window code changes.
 
 ## Manual verification guide
 
 Manual verification is provided after implementation. It should include:
 
-1. Run `pnpm dev:desktop` and confirm the default pet is an actual animated visual, not CSS/wireframe.
-2. Confirm the pet remains transparent, frameless, draggable, and non-focus-stealing.
-3. Drag the pet left and right and confirm the animation/direction changes with drag direction, then settles back to idle without flicker.
+1. Run `pnpm dev:desktop` and confirm the default familiar is an actual animated visual, not CSS/wireframe.
+2. Confirm the familiar remains transparent, frameless, draggable, and non-focus-stealing.
+3. Drag the familiar left and right and confirm the animation/direction changes with drag direction, then settles back to idle without flicker.
 4. Confirm pause/resume visibly pauses/resumes animation.
-5. Trigger or inspect speech/reaction bubble behavior and confirm it feels premium: compact, readable, visually attached to the pet, no oversized wireframe card, no jarring animation.
+5. Trigger or inspect speech/reaction bubble behavior and confirm it feels premium: compact, readable, visually attached to the familiar, no oversized wireframe card, no jarring animation.
 
-   Suggested speech command while OpenPets is running:
+   Suggested speech command while FamiliarOS is running:
 
    ```bash
-   pnpm --filter @open-pets/client smoke:say "Working on it" thinking
+   pnpm --filter @familiaros/client smoke:say "Working on it" thinking
    ```
 
    Suggested reaction command:
 
    ```bash
-   pnpm --filter @open-pets/client smoke:react success
+   pnpm --filter @familiaros/client smoke:react success
    ```
 
-6. If a catalog/installed pet is available, set it as default and confirm static installed-pet rendering still works with the shared polished bubble.
-7. Run `pnpm package:desktop:dir`, launch the packaged app, and repeat the default pet checks.
+6. If a catalog/installed familiar is available, set it as default and confirm static installed-familiar rendering still works with the shared polished bubble.
+7. Run `pnpm package:desktop:dir`, launch the packaged app, and repeat the default familiar checks.
 
 ## Oracle plan review
 
@@ -176,25 +176,25 @@ Reviewed by Oracle.
 
 Blockers:
 
-- Drag-direction plan was not implementable as initially written because the current pet window uses `-webkit-app-region: drag`, which makes renderer pointer events unreliable, and there was no preload/IPC bridge.
+- Drag-direction plan was not implementable as initially written because the current familiar window uses `-webkit-app-region: drag`, which makes renderer pointer events unreliable, and there was no preload/IPC bridge.
 
 Should-fix feedback:
 
-- Define the bundled pet asset contract: filenames, format, dimensions/frame layout/states, ownership/source, and fallback behavior.
+- Define the bundled familiar asset contract: filenames, format, dimensions/frame layout/states, ownership/source, and fallback behavior.
 - Be explicit about CSP and avoid broad renderer scripting privileges.
 - Require bubble text to use escaped text/textContent only.
-- Clarify that polished bubble styling applies to installed pets too.
+- Clarify that polished bubble styling applies to installed familiars too.
 - Add concrete manual bubble triggers using client smoke commands.
-- Add manual verification for installed-pet fallback/static rendering.
+- Add manual verification for installed-familiar fallback/static rendering.
 - Specify package contract checks for new assets in ASAR-era packaging.
-- If changing default pet window size, verify clamping/persistence.
+- If changing default familiar window size, verify clamping/persistence.
 
 Nice-to-have feedback:
 
 - Prefer CSS sprites or animated image formats over custom JS frame loops unless JS is needed for drag state.
 - Add lightweight asset checks for existence, size, and dimensions if easy.
 - Add `prefers-reduced-motion` support.
-- Use real catalog pet material rather than generated/SVG-coded art when available.
+- Use real catalog familiar material rather than generated/SVG-coded art when available.
 
 Verdict: not implementation-ready until drag-direction architecture and asset/CSP/manual-verification requirements are tightened.
 
@@ -203,11 +203,11 @@ Verdict: not implementation-ready until drag-direction architecture and asset/CS
 Fixed:
 
 - Drag-direction architecture now explicitly avoids renderer pointer events in draggable regions and uses main-process window movement deltas plus a narrow safe bridge/preload if needed.
-- Added bundled pet asset contract requirements, including local checked-in WebP source, known frame layout/states, and no SVG-coded/generated substitute.
+- Added bundled familiar asset contract requirements, including local checked-in WebP source, known frame layout/states, and no SVG-coded/generated substitute.
 - Added CSP requirements for file/data image sources and no Node integration/remote/eval/broad renderer privileges.
-- Required bubble content to be escaped/text-only and shared across built-in and installed pet windows.
+- Required bubble content to be escaped/text-only and shared across built-in and installed familiar windows.
 - Added concrete manual `smoke:say` and `smoke:react` triggers.
-- Added installed-pet fallback/static rendering manual verification.
+- Added installed-familiar fallback/static rendering manual verification.
 - Added package contract expectations for source asset existence/non-empty and packaged `assets/**` inclusion.
 - Added clamp/persistence verification if window sizing changes.
 
@@ -216,7 +216,7 @@ Accepted:
 - Prefer CSS sprites or animated image formats when practical.
 - Add lightweight asset checks where easy.
 - Add `prefers-reduced-motion` handling where practical.
-- Prefer real catalog pet material over generated art.
+- Prefer real catalog familiar material over generated art.
 
 ## Oracle implementation review
 
@@ -229,25 +229,25 @@ Should-fix: none before manual verification.
 Key checks:
 
 - Drag-direction architecture uses main-process window movement, not renderer pointer events in `-webkit-app-region: drag`.
-- Pet preload is narrow: only listens for whitelisted `openpets:pet-motion` states and mutates `dataset`.
+- Familiar preload is narrow: only listens for whitelisted `familiaros:familiar-motion` states and mutates `dataset`.
 - Renderer remains sandboxed/context-isolated with Node disabled.
 - Bubble content is escaped text, not unsafe HTML.
-- Installed pet fallback remains static/safe with shared bubble styling.
-- Packaging config includes `pet-preload.cjs` and assets; contract checks cover source asset/preload/config.
+- Installed familiar fallback remains static/safe with shared bubble styling.
+- Packaging config includes `familiar-preload.cjs` and assets; contract checks cover source asset/preload/config.
 
 Nice-to-have feedback:
 
-- Add an ASAR-content/package-output assertion for `pet-preload.cjs` and `default-pet-spritesheet.webp` later if convenient.
+- Add an ASAR-content/package-output assertion for `familiar-preload.cjs` and `default-familiar-spritesheet.webp` later if convenient.
 - If manual testing shows drag jitter, tune the `3px` threshold / `180ms` idle timeout.
-- Future installed-pet animation metadata remains out of Phase 12.
+- Future installed-familiar animation metadata remains out of Phase 12.
 
-Verdict: implementation is acceptable for manual verification. Focus manual testing on packaged sprite loading, left/right drag animation, idle settle, bubble quality, pause/resume, installed-pet fallback, and no focus/drag regressions.
+Verdict: implementation is acceptable for manual verification. Focus manual testing on packaged sprite loading, left/right drag animation, idle settle, bubble quality, pause/resume, installed-familiar fallback, and no focus/drag regressions.
 
 ## Oracle implementation feedback disposition
 
 Accepted:
 
 - ASAR-content assertions can be added as future package hardening; current source/config/package validation passed.
-- Additional bundled asset hygiene checks can be added if bundled pet assets become more complex.
+- Additional bundled asset hygiene checks can be added if bundled familiar assets become more complex.
 - Drag threshold/idle timing will be tuned only if manual testing shows jitter.
-- Richer installed-pet animation metadata is a future phase, not Phase 12.
+- Richer installed-familiar animation metadata is a future phase, not Phase 12.
diff --git a/docs/phases/phase-13a-pet-manager-ui-polish.md b/docs/phases/phase-13a-pet-manager-ui-polish.md
index 66a9ee84..005fdc16 100644
--- a/docs/phases/phase-13a-pet-manager-ui-polish.md
+++ b/docs/phases/phase-13a-pet-manager-ui-polish.md
@@ -1,16 +1,16 @@
-# Phase 13A: Pet Manager UI/UX Polish
+# Phase 13A: Familiar Manager UI/UX Polish
 
 ## Goal
 
-Make the Pet Manager feel like the first polished OpenPets desktop window and establish a reusable visual direction for later Settings, Agent Setup, and Onboarding polish.
+Make the Familiar Manager feel like the first polished FamiliarOS desktop window and establish a reusable visual direction for later Settings, Agent Setup, and Onboarding polish.
 
-This phase focuses on one window only: Pet Manager.
+This phase focuses on one window only: Familiar Manager.
 
 ## Non-goals
 
 - No Settings, Agent Setup, or Onboarding redesign.
 - No new install/remove/default product behavior beyond small UI affordances needed for clarity.
-- No new pet catalog backend, marketplace, or publishing flow.
+- No new familiar catalog backend, marketplace, or publishing flow.
 - No remote image rendering in the renderer.
 - No framework migration; keep the current vanilla preload-driven UI.
 - No weakening zip/catalog/install safety.
@@ -18,34 +18,34 @@ This phase focuses on one window only: Pet Manager.
 
 ## User-visible/manual outcome
 
-Opening **Manage Pets** from the tray shows a premium compact desktop UI instead of a wireframe list.
+Opening **Manage Familiars** from the tray shows a premium compact desktop UI instead of a wireframe list.
 
 The user should be able to quickly understand:
 
-- which pet is currently default,
-- which pets are installed,
-- which catalog pets can be installed,
+- which familiar is currently default,
+- which familiars are installed,
+- which catalog familiars can be installed,
 - what actions are safe/available,
 - whether catalog data is live, fixture, loading, empty, or errored.
 
 ## Acceptance criteria
 
-- Pet Manager copy no longer says or feels like placeholder/wireframe.
-- Pet Manager has a polished header, clear current-default summary, installed-pets section, catalog/search section, and error/status surfaces.
-- Installed cards clearly distinguish default, built-in/protected, broken, and removable pets.
+- Familiar Manager copy no longer says or feels like placeholder/wireframe.
+- Familiar Manager has a polished header, clear current-default summary, installed-familiars section, catalog/search section, and error/status surfaces.
+- Installed cards clearly distinguish default, built-in/protected, broken, and removable familiars.
 - Catalog cards clearly distinguish installable, installed, default, and unavailable/broken states.
 - Buttons have clear hierarchy and disabled/busy states; no tiny ambiguous controls.
-- Search has a polished empty state when no catalog pets match.
+- Search has a polished empty state when no catalog familiars match.
 - Catalog status explains live vs fixture vs error without looking like debug text.
 - The design uses consistent spacing, typography, radii, shadows, badges, and compact desktop proportions.
-- No external images are introduced into the Pet Manager renderer.
-- Pet install, remove, and set-default behavior remains unchanged and safe.
-- Pet Manager can still render if catalog fetch falls back to fixture or fails.
-- Pet Manager rendering continues to use DOM APIs and `textContent` for all catalog/state strings; no `innerHTML` for catalog-provided content.
+- No external images are introduced into the Familiar Manager renderer.
+- Familiar install, remove, and set-default behavior remains unchanged and safe.
+- Familiar Manager can still render if catalog fetch falls back to fixture or fails.
+- Familiar Manager rendering continues to use DOM APIs and `textContent` for all catalog/state strings; no `innerHTML` for catalog-provided content.
 - No CSP `img-src` expansion, no `<img>`, and no CSS `background-image` using catalog preview URLs in Phase 13A.
-- Existing visible placeholder copy is removed from Pet Manager window definitions and user-facing text.
-- `pnpm --filter @open-pets/desktop build` passes.
-- `pnpm --filter @open-pets/desktop test` passes.
+- Existing visible placeholder copy is removed from Familiar Manager window definitions and user-facing text.
+- `pnpm --filter @familiaros/desktop build` passes.
+- `pnpm --filter @familiaros/desktop test` passes.
 - If shared task-window styles are changed, verify Settings/Agent Setup/Onboarding are not obviously broken.
 - Designer review is completed before final manual verification.
 - Oracle implementation review is completed and feedback is dispositioned.
@@ -53,29 +53,29 @@ The user should be able to quickly understand:
 ## Proposed files/directories
 
 - `apps/desktop/src/windows.ts`
-  - Update Pet Manager HTML structure and Pet Manager-specific/shared styling.
-  - Remove placeholder Pet Manager description.
+  - Update Familiar Manager HTML structure and Familiar Manager-specific/shared styling.
+  - Remove placeholder Familiar Manager description.
 - `apps/desktop/preload.cjs`
   - Refactor `renderPetManager` / `renderCatalog` card DOM for polished UI states.
   - Add small helper functions for status labels, card metadata, action rows, and empty states.
-- `docs/phases/phase-13a-pet-manager-ui-polish.md`
+- `docs/phases/phase-13a-familiar-manager-ui-polish.md`
   - This phase spec, reviews, and dispositions.
 - Potentially `docs/mvp-validation.md`
-  - Add a short Pet Manager visual verification note if useful.
+  - Add a short Familiar Manager visual verification note if useful.
 
 ## Technical approach
 
-1. Keep scope to Pet Manager:
-   - Require Pet Manager selectors under `body[data-openpets-view="pet-manager"]` unless intentionally changing shared task-window tokens.
+1. Keep scope to Familiar Manager:
+   - Require Familiar Manager selectors under `body[data-familiaros-view="familiar-manager"]` unless intentionally changing shared task-window tokens.
    - Avoid broad restyling of Settings/Agent Setup/Onboarding unless shared base styles must be adjusted carefully.
-   - Remove the existing placeholder copy from `taskWindowDefinitions.pet-manager.description` and visible Pet Manager text.
+   - Remove the existing placeholder copy from `taskWindowDefinitions.familiar-manager.description` and visible Familiar Manager text.
 2. Improve information architecture:
    - Add a hero/header area with concise product copy.
-   - Add a current-default summary card derived from `state.preferences.defaultPetId` and installed pet state.
-   - Keep installed pets and catalog as separate sections.
+   - Add a current-default summary card derived from `state.preferences.defaultPetId` and installed familiar state.
+   - Keep installed familiars and catalog as separate sections.
 3. Polish cards:
-   - Installed cards: pet name, id/source metadata, status badges, concise description, broken reason if present, primary/default action, secondary/remove action.
-   - Catalog cards: pet name, id metadata, description, installed/default badges, install or set-default/remove actions.
+   - Installed cards: familiar name, id/source metadata, status badges, concise description, broken reason if present, primary/default action, secondary/remove action.
+   - Catalog cards: familiar name, id metadata, description, installed/default badges, install or set-default/remove actions.
 4. Improve state surfaces:
    - Catalog source/status pill for live/fixture/error.
    - Empty installed/catalog search states with plain helpful copy.
@@ -86,21 +86,21 @@ The user should be able to quickly understand:
    - Use specific CSS transitions only; no `transition: all`.
    - Add subtle card hover/focus/press feedback without distracting animations.
 6. Preserve security constraints:
-   - No remote images in Pet Manager renderer.
-   - Do not add `img-src` to the Pet Manager CSP, do not add `<img>`, and do not use catalog preview URLs as CSS backgrounds in this phase.
+   - No remote images in Familiar Manager renderer.
+   - Do not add `img-src` to the Familiar Manager CSP, do not add `<img>`, and do not use catalog preview URLs as CSS backgrounds in this phase.
    - Continue using textContent/DOM APIs for user/catalog strings.
    - Keep renderer CSP restrictive.
 
 ## Risks and tradeoffs
 
-- Pet Manager currently shares task-window CSS with other windows. Over-broad changes could accidentally regress Settings/Agent Setup/Onboarding.
+- Familiar Manager currently shares task-window CSS with other windows. Over-broad changes could accidentally regress Settings/Agent Setup/Onboarding.
 - Preview thumbnails would be desirable but can create CSP/cache/security work. Defer image previews unless implemented through a safe later design.
 - Pure vanilla DOM UI can become messy. Keep helpers small and avoid a framework rewrite.
-- Catalog can contain many pets; keep cards reasonably compact and avoid heavy DOM work or animations.
+- Catalog can contain many familiars; keep cards reasonably compact and avoid heavy DOM work or animations.
 
 ## Security/privacy notes
 
-- Pet Manager still must not execute pet content or scripts.
+- Familiar Manager still must not execute familiar content or scripts.
 - Catalog strings must be inserted with `textContent`, not `innerHTML`.
 - Install/remove/default actions must keep the existing IPC allowlist and validation.
 - No remote image URLs should be added to CSP for this phase.
@@ -111,8 +111,8 @@ The user should be able to quickly understand:
 Run:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 If shared styles or packaging-sensitive files change unexpectedly, also run:
@@ -126,14 +126,14 @@ pnpm check
 Manual verification is provided after implementation. It should include:
 
 1. Run `pnpm dev:desktop`.
-2. Open **Manage Pets** from the tray.
+2. Open **Manage Familiars** from the tray.
 3. Confirm the window feels polished, compact, and not wireframe.
-4. Confirm current default pet is obvious.
+4. Confirm current default familiar is obvious.
 5. Search the catalog and confirm empty/search states look good.
 6. Confirm live/fixture/error catalog status is understandable; simulate unavailable catalog only if feasible without expanding scope.
-7. Install a catalog pet if available and confirm busy state during install.
-8. Set an installed catalog pet as default.
-9. Remove a removable pet and confirm busy state during remove.
+7. Install a catalog familiar if available and confirm busy state during install.
+8. Set an installed catalog familiar as default.
+9. Remove a removable familiar and confirm busy state during remove.
 10. Confirm broken/protected/default button states are understandable.
 11. Open Settings/Agent Setup/Onboarding quickly to confirm shared styles were not obviously broken if shared styles changed.
 
@@ -145,17 +145,17 @@ Blockers: none.
 
 Should-fix feedback:
 
-- Tighten style isolation under `body[data-openpets-view="pet-manager"]` unless intentionally changing shared tokens.
+- Tighten style isolation under `body[data-familiaros-view="familiar-manager"]` unless intentionally changing shared tokens.
 - Add explicit acceptance that catalog/state strings use DOM APIs/`textContent`, no `innerHTML` for catalog content.
 - Add manual verification for catalog unavailable/error/fixture status if feasible, busy install/remove states, set default, remove, and shared window regression check.
 - Make “no remote image rendering” concrete: no CSP `img-src` expansion, no `<img>`, no catalog preview CSS backgrounds.
-- Explicitly remove existing Pet Manager placeholder copy.
+- Explicitly remove existing Familiar Manager placeholder copy.
 
 Nice-to-have feedback:
 
-- Add a small Pet Manager visual checklist to `docs/mvp-validation.md`.
+- Add a small Familiar Manager visual checklist to `docs/mvp-validation.md`.
 - Define a few grouped design tokens/comments without building a full design system.
-- Add compact empty states for no installed pets beyond built-in and no catalog matches.
+- Add compact empty states for no installed familiars beyond built-in and no catalog matches.
 - Keep helper extraction modest; avoid a mini framework.
 
 Verdict: implementation-ready after small spec tightening.
@@ -164,7 +164,7 @@ Verdict: implementation-ready after small spec tightening.
 
 Fixed:
 
-- Added selector isolation requirement under `body[data-openpets-view="pet-manager"]`.
+- Added selector isolation requirement under `body[data-familiaros-view="familiar-manager"]`.
 - Added explicit `textContent`/DOM API requirement and `innerHTML` prohibition for catalog/state strings.
 - Added concrete no-remote-image constraints.
 - Added placeholder-copy removal as an explicit implementation item.
@@ -172,7 +172,7 @@ Fixed:
 
 Accepted:
 
-- Add Pet Manager visual checklist to `docs/mvp-validation.md` if implementation changes warrant it.
+- Add Familiar Manager visual checklist to `docs/mvp-validation.md` if implementation changes warrant it.
 - Use modest grouped design tokens/comments only if helpful.
 - Add compact empty states for catalog/no-extra-installed states.
 - Keep helper extraction modest.
@@ -187,7 +187,7 @@ Should-fix: none.
 
 Nice-to-have feedback:
 
-- Make Pet Manager empty states span the full grid width.
+- Make Familiar Manager empty states span the full grid width.
 - Make the current default card heading slightly larger to reinforce hierarchy.
 
 Verdict: approved. The visual direction is a substantial step up from wireframe and establishes a good baseline for future windows.
@@ -205,7 +205,7 @@ Reviewed by Oracle after implementation and follow-up fixes.
 
 Initial should-fix feedback:
 
-- Restore remove affordance for a removable current default pet.
+- Restore remove affordance for a removable current default familiar.
 - Show broken state on catalog cards.
 - Avoid appending empty actions rows for current-default catalog cards.
 - Fix current-default remove busy-state restore so a newly rendered protected default does not get an enabled dead Protected button.
@@ -220,7 +220,7 @@ Nice-to-have feedback:
 
 - Manually verify Settings/Agent Setup/Onboarding because shared button/card/search styles changed.
 - Consider shortening catalog error pill text if it feels too debuggy.
-- Future: centralize small DOM helpers if Pet Manager grows further.
+- Future: centralize small DOM helpers if Familiar Manager grows further.
 
 Verdict: approved for manual verification. Removable defaults remain actionable, broken catalog states are visible, empty action rows are avoided, busy-state restoration is fixed, and CSP/textContent/no-remote-image constraints remain intact.
 
@@ -229,7 +229,7 @@ Verdict: approved for manual verification. Removable defaults remain actionable,
 Fixed:
 
 - Current default card now includes badges, broken reason, and Remove/Protected action.
-- Catalog cards now show Broken badge and broken reason for installed broken pets.
+- Catalog cards now show Broken badge and broken reason for installed broken familiars.
 - Empty catalog card action rows are no longer appended.
 - Current-default remove busy restore no longer runs after successful re-render, preventing stale enabled Protected buttons.
 
diff --git a/docs/phases/phase-13b-onboarding-greeting-polish.md b/docs/phases/phase-13b-onboarding-greeting-polish.md
index 08baf974..e9ba3c48 100644
--- a/docs/phases/phase-13b-onboarding-greeting-polish.md
+++ b/docs/phases/phase-13b-onboarding-greeting-polish.md
@@ -2,27 +2,27 @@
 
 ## Goal
 
-Turn the first onboarding screen into a polished OpenPets greeting inspired by `lfs/greeting.png`, without copying the screenshot literally.
+Turn the first onboarding screen into a polished FamiliarOS greeting inspired by `lfs/greeting.png`, without copying the screenshot literally.
 
-This phase should create a native onboarding welcome experience that feels premium, playful, and consistent with the Phase 13A Pet Manager polish direction.
+This phase should create a native onboarding welcome experience that feels premium, playful, and consistent with the Phase 13A Familiar Manager polish direction.
 
 ## Non-goals
 
 - No full onboarding redesign beyond the greeting/welcome step unless a small structural change is required to keep navigation coherent.
-- No Agent Setup, Settings, or Pet Manager changes.
+- No Agent Setup, Settings, or Familiar Manager changes.
 - No copying the screenshot pixel-for-pixel.
 - No using the screenshot as the final UI background.
 - No remote image loading.
 - No new onboarding business logic.
-- No new pet install/configuration behavior.
+- No new familiar install/configuration behavior.
 
 ## User-visible/manual outcome
 
 On first launch, the onboarding welcome screen should feel like a real product greeting:
 
-- clear OpenPets identity,
+- clear FamiliarOS identity,
 - friendly “AI coding companion” positioning,
-- playful pet/mascot atmosphere,
+- playful familiar/mascot atmosphere,
 - strong primary Next action,
 - subtle progress dots,
 - polished copy that is not generic placeholder text.
@@ -32,27 +32,27 @@ On first launch, the onboarding welcome screen should feel like a real product g
 - Onboarding step 0 has a polished greeting layout inspired by `lfs/greeting.png` but implemented as native HTML/CSS.
 - The welcome copy is concise and product-quality; avoid awkward/generic wording.
 - The greeting uses available local assets only. Current discovered local assets are:
-  - `apps/desktop/assets/default-pet-spritesheet.webp`
+  - `apps/desktop/assets/default-familiar-spritesheet.webp`
   - `apps/desktop/assets/tray-icon.png`
   - `lfs/greeting.png` as reference only, not packaged directly unless explicitly approved.
 - The implemented greeting may use extracted local WebP assets copied from `web/public` into `apps/desktop/assets/`:
-  - `apps/desktop/assets/onboarding-logo.webp` from `web/public/openpets.webp`
-  - `apps/desktop/assets/onboarding-pets.webp` from `web/public/petland.webp`
+  - `apps/desktop/assets/onboarding-logo.webp` from `web/public/familiaros.webp`
+  - `apps/desktop/assets/onboarding-familiars.webp` from `web/public/petland.webp`
 - `lfs/greeting.png` must not appear in runtime code, packaged assets, CSS URLs, or CSP assumptions.
 - Packaged image assets must be embedded as data URLs generated from local packaged files; onboarding CSP must remain `img-src data:` with no remote or `file:` image sources.
 - If a hero image/illustration is needed, use a safe local packaged asset or a CSS/native composition; do not fetch remote images.
 - Onboarding CSP remains restrictive; no remote image/script/style sources.
 - Dynamic text continues to use DOM APIs/textContent in preload.
-- Existing onboarding steps still work: Welcome → Pets → Agents → Ready → Finish.
+- Existing onboarding steps still work: Welcome → Familiars → Agents → Ready → Finish.
 - Existing onboarding buttons still work.
 - Window remains usable at current task-window size and does not require custom native titlebar/window controls.
 - Greeting fits in the increased 900×760 default task window without clipping the primary action, and remains usable at the 720×520 minimum window size.
 - Keyboard/tab access still reaches Next and later Finish controls.
 - Progress dots/steps still communicate the current step accessibly.
-- `pnpm --filter @open-pets/desktop build` passes.
-- `pnpm --filter @open-pets/desktop test` passes.
+- `pnpm --filter @familiaros/desktop build` passes.
+- `pnpm --filter @familiaros/desktop test` passes.
 - If any runtime asset is added/referenced, `pnpm package:desktop:dir` passes or packaged asset loading is otherwise verified.
-- If shared task-window styles are touched, Pet Manager, Settings, and Agent Setup are manually checked for obvious visual regressions.
+- If shared task-window styles are touched, Familiar Manager, Settings, and Agent Setup are manually checked for obvious visual regressions.
 - Designer review is completed before manual verification.
 - Oracle implementation review is completed and feedback is dispositioned.
 
@@ -60,11 +60,11 @@ On first launch, the onboarding welcome screen should feel like a real product g
 
 - `apps/desktop/src/windows.ts`
   - Update onboarding welcome markup and onboarding-specific scoped styles.
-  - Keep styles under `body[data-openpets-view="onboarding"]` where possible.
+  - Keep styles under `body[data-familiaros-view="onboarding"]` where possible.
 - `apps/desktop/preload.cjs`
   - Keep existing step navigation; adjust only if new welcome markup needs small class/state handling.
 - `apps/desktop/assets/`
-  - Add `onboarding-logo.webp` and `onboarding-pets.webp` if using the real WebP greeting assets. Do not package `lfs/greeting.png` as-is.
+  - Add `onboarding-logo.webp` and `onboarding-familiars.webp` if using the real WebP greeting assets. Do not package `lfs/greeting.png` as-is.
 - `docs/phases/phase-13b-onboarding-greeting-polish.md`
   - This phase spec, reviews, and dispositions.
 
@@ -73,8 +73,8 @@ On first launch, the onboarding welcome screen should feel like a real product g
 1. Use `lfs/greeting.png` as art direction, not implementation:
    - light airy background,
    - pixel/game feel,
-   - strong OpenPets brand block,
-   - mascot/pet visual area,
+   - strong FamiliarOS brand block,
+   - mascot/familiar visual area,
    - progress dots and primary Next button.
    - The file must remain reference-only and should not be copied into `apps/desktop/assets` or loaded by the app.
 2. Build native onboarding welcome UI:
@@ -84,11 +84,11 @@ On first launch, the onboarding welcome screen should feel like a real product g
    - Generate data URLs from packaged local asset files in the main process before creating the onboarding data URL, avoiding fragile `data:` document → `file:` image loading.
 3. Copy direction, not copy text:
    - Proposed headline direction: “Your AI coding companion” or similar.
-   - Proposed body direction: “OpenPets lives in your tray and gives your coding agents a friendly desktop companion.”
+   - Proposed body direction: “FamiliarOS lives in your tray and gives your coding agents a friendly desktop companion.”
    - Keep copy short and human.
 4. Preserve onboarding flow:
    - Step indicators still reflect current step.
-   - Next continues to Pets.
+   - Next continues to Familiars.
    - Existing later steps remain functional even if visually less polished for now.
 5. Preserve security:
    - No remote images.
@@ -115,8 +115,8 @@ On first launch, the onboarding welcome screen should feel like a real product g
 Run:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 If shared task-window styles are changed unexpectedly, also run:
@@ -136,15 +136,15 @@ pnpm package:desktop:dir
 Manual verification is provided after implementation. It should include:
 
 1. Run `pnpm dev:desktop`.
-2. Reset onboarding state if needed by deleting the logged OpenPets app data state file/directory.
+2. Reset onboarding state if needed by deleting the logged FamiliarOS app data state file/directory.
 3. Confirm the first onboarding screen looks like a polished greeting inspired by `lfs/greeting.png`, not a literal screenshot paste.
 4. Confirm copy feels good and not awkward.
 5. Confirm the primary action is visible and not clipped at the default task-window size.
 6. Confirm keyboard tab order reaches Next and later Finish controls.
 7. Confirm progress dots/steps still show the current step clearly.
-8. Confirm Next advances to Pets, then Agents, then Ready.
+8. Confirm Next advances to Familiars, then Agents, then Ready.
 9. Confirm Finish still completes onboarding.
-10. If shared styles changed, quickly inspect Pet Manager, Settings, and Agent Setup for obvious visual regressions.
+10. If shared styles changed, quickly inspect Familiar Manager, Settings, and Agent Setup for obvious visual regressions.
 
 ## Oracle plan review
 
@@ -222,8 +222,8 @@ Should-fix: none.
 Nice-to-have feedback:
 
 - Manually verify default-size fit and 720×520 minimum-size usability in real Electron rendering.
-- Manually inspect Pet Manager, Settings, and Agent Setup because shared body/button styles changed.
-- Future: replace emoji pet tokens with real brand/mascot assets if provided.
+- Manually inspect Familiar Manager, Settings, and Agent Setup because shared body/button styles changed.
+- Future: replace emoji familiar tokens with real brand/mascot assets if provided.
 
 Verdict: approved for manual verification. Hidden panels are protected, progress state has `aria-current`, no runtime image/CSP risk was introduced, and scope remains limited to the onboarding welcome/greeting step.
 
diff --git a/docs/phases/phase-13c-pet-manager-gallery.md b/docs/phases/phase-13c-pet-manager-gallery.md
index e69d5d77..2541ef8b 100644
--- a/docs/phases/phase-13c-pet-manager-gallery.md
+++ b/docs/phases/phase-13c-pet-manager-gallery.md
@@ -1,81 +1,81 @@
-# Phase 13C: Pet Manager Gallery
+# Phase 13C: Familiar Manager Gallery
 
 ## Goal
 
-Redesign the Pet Manager into a polished pet installation/gallery screen inspired by `lfs/pets.png`, while preserving the existing real catalog, install, set-default, and remove behavior.
+Redesign the Familiar Manager into a polished familiar installation/gallery screen inspired by `lfs/familiars.png`, while preserving the existing real catalog, install, set-default, and remove behavior.
 
 ## Non-goals
 
-- No changes to catalog source, pet zip validation, installation security, or state schema.
+- No changes to catalog source, familiar zip validation, installation security, or state schema.
 - No remote image loading beyond existing catalog preview URLs already used by catalog metadata.
-- No new pet categories in persisted data; filters can be UI-derived from current pet text/ids.
-- No using `lfs/pets.png` as a runtime image or packaged asset.
+- No new familiar categories in persisted data; filters can be UI-derived from current familiar text/ids.
+- No using `lfs/familiars.png` as a runtime image or packaged asset.
 - No full redesign of Agent Setup, Settings, or onboarding beyond shared task-window sizing/styles if required.
 
 ## User-visible/manual outcome
 
-Opening Pet Manager shows a light, polished two-column install page:
+Opening Familiar Manager shows a light, polished two-column install page:
 
-- OpenPets brand art at top-left,
+- FamiliarOS brand art at top-left,
 - search and simple gallery filter pills,
-- install/selectable pet cards with pixel-art previews where available,
-- a large right-side selected pet detail panel,
+- install/selectable familiar cards with pixel-art previews where available,
+- a large right-side selected familiar detail panel,
 - focused action buttons that install, set default, remove, or indicate selected/protected/broken state,
 - existing catalog/install behavior still works.
 
 ## Acceptance criteria
 
-- Pet Manager visually follows `lfs/pets.png` direction: light background, two-column gallery/detail layout, pixel-game product feel, rounded cards, strong primary actions.
-- `lfs/pets.png` remains reference-only and is not loaded by app code or copied into desktop assets.
-- Use existing bundled/local assets where safe, including `apps/desktop/assets/onboarding-logo.webp` for brand identity. Do not embed the large `default-pet-spritesheet.webp` in the Pet Manager data URL.
-- Catalog pet preview images may be shown only from validated `CatalogPetV2.preview` values returned by main-process catalog data. The renderer must not independently construct remote image URLs.
-- Pet Manager CSP must be exactly scoped for required image sources, e.g. `img-src data: https://openpets.dev`; no broad `https:`, `*`, or `file:` sources.
+- Familiar Manager visually follows `lfs/familiars.png` direction: light background, two-column gallery/detail layout, pixel-game product feel, rounded cards, strong primary actions.
+- `lfs/familiars.png` remains reference-only and is not loaded by app code or copied into desktop assets.
+- Use existing bundled/local assets where safe, including `apps/desktop/assets/onboarding-logo.webp` for brand identity. Do not embed the large `default-familiar-spritesheet.webp` in the Familiar Manager data URL.
+- Catalog familiar preview images may be shown only from validated `CatalogPetV2.preview` values returned by main-process catalog data. The renderer must not independently construct remote image URLs.
+- Familiar Manager CSP must be exactly scoped for required image sources, e.g. `img-src data: https://familiaros.dev`; no broad `https:`, `*`, or `file:` sources.
 - Do not use mutable `InstalledPetState.source.preview` for remote rendering unless it is revalidated against the same catalog preview rules.
 - Catalog previews are spritesheets; the UI must crop/display a single-frame thumbnail/preview, not show the whole sheet.
 - Image failures/offline state must degrade gracefully: no broken image icon, neutral/blank preview surface, and install/default/remove actions remain usable.
 - All catalog/state strings are inserted with DOM APIs/textContent, not `innerHTML`.
-- Existing Pet Manager operations continue to work:
-  - install catalog pet,
-  - set installed pet as default,
-  - remove non-protected installed pet,
-  - protected built-in/default pet cannot be removed,
-  - broken installed pets cannot be selected as default.
-- Search continues to filter catalog/gallery pets.
+- Existing Familiar Manager operations continue to work:
+  - install catalog familiar,
+  - set installed familiar as default,
+  - remove non-protected installed familiar,
+  - protected built-in/default familiar cannot be removed,
+  - broken installed familiars cannot be selected as default.
+- Search continues to filter catalog/gallery familiars.
 - Quick filters are limited to `All` and `Installed`; do not add category filters like `Cute`, `Helpers`, or `Robots` until backed by real catalog metadata.
 - The large detail panel does not include decorative metadata pills like `Free`, `Open source`, or `Works in terminal`; those are unnecessary until backed by real catalog metadata.
-- Detail actions are limited to real Pet Manager operations: `Install`, `Set Default`, and `Remove`, with disabled/status variants such as `Selected`, `Protected`, `Broken`, or `Installing…`.
-- Keyboard users can tab to search, filter pills, pet cards/actions, and detail actions.
-- The Pet Manager opens at 1160×780 and remains usable at 720×520 with vertical scrolling/responsive stacking.
-- `pnpm --filter @open-pets/desktop build` passes.
-- `pnpm --filter @open-pets/desktop test` passes.
-- `pnpm package:desktop:dir` passes because Pet Manager CSP/asset packaging contracts change.
+- Detail actions are limited to real Familiar Manager operations: `Install`, `Set Default`, and `Remove`, with disabled/status variants such as `Selected`, `Protected`, `Broken`, or `Installing…`.
+- Keyboard users can tab to search, filter pills, familiar cards/actions, and detail actions.
+- The Familiar Manager opens at 1160×780 and remains usable at 720×520 with vertical scrolling/responsive stacking.
+- `pnpm --filter @familiaros/desktop build` passes.
+- `pnpm --filter @familiaros/desktop test` passes.
+- `pnpm package:desktop:dir` passes because Familiar Manager CSP/asset packaging contracts change.
 - Designer review is completed before manual verification.
 - Oracle implementation review is completed and feedback is dispositioned.
 
 ## Proposed files/directories
 
 - `apps/desktop/src/windows.ts`
-  - Update Pet Manager markup and scoped CSS.
-  - Add Pet Manager image CSP for data/local catalog previews as needed.
+  - Update Familiar Manager markup and scoped CSS.
+  - Add Familiar Manager image CSP for data/local catalog previews as needed.
 - `apps/desktop/preload.cjs`
   - Replace the current section-card renderer with gallery/detail rendering.
   - Keep IPC calls and validation boundaries unchanged.
 - `apps/desktop/src/check-packaging-contract.ts`
-  - Update assertions if the Pet Manager starts depending on bundled image assets/CSP.
-- `docs/phases/phase-13c-pet-manager-gallery.md`
+  - Update assertions if the Familiar Manager starts depending on bundled image assets/CSP.
+- `docs/phases/phase-13c-familiar-manager-gallery.md`
   - This spec, reviews, and dispositions.
 
 ## Technical approach
 
 1. Keep backend/state/install behavior unchanged.
-2. Build one normalized UI list from installed pets plus catalog pets:
-   - installed/default state comes from `OpenPetsStateV1`,
+2. Build one normalized UI list from installed familiars plus catalog familiars:
+   - installed/default state comes from `FamiliarOSStateV1`,
    - catalog data comes from `getCatalog()`.
 3. Render a left gallery with:
    - search,
    - filter pills (`All`, `Installed`) derived from installed/default state,
    - cards showing thumbnail, name, subtitle, and selected/install state.
-4. Render a right detail panel for the selected pet:
+4. Render a right detail panel for the selected familiar:
    - title/description,
    - large preview image,
    - concise install/default/protected/broken status,
@@ -83,9 +83,9 @@ Opening Pet Manager shows a light, polished two-column install page:
    - primary action (`Install`, `Selected`, or `Set Default`) and secondary action (`Remove` or `Protected`) where applicable.
 5. Use safe image behavior:
    - bundled default uses data URL or local packaged asset strategy already established,
-   - catalog previews use only validated `CatalogPetV2.preview` URLs from main-process catalog data, scoped to `https://openpets.dev`,
+   - catalog previews use only validated `CatalogPetV2.preview` URLs from main-process catalog data, scoped to `https://familiaros.dev`,
    - card/mini preview images crop a single sprite frame from spritesheets using CSS background strategy,
-   - the detail spotlight animates the pet sprite itself without decorative platform/fallback art,
+   - the detail spotlight animates the familiar sprite itself without decorative platform/fallback art,
    - image error handling is attached with DOM listeners in preload (`addEventListener("error", ...)`), not inline attributes,
    - failures hide the broken image and leave a neutral preview surface.
 6. Preserve accessibility:
@@ -96,26 +96,26 @@ Opening Pet Manager shows a light, polished two-column install page:
 ## Risks and tradeoffs
 
 - Catalog previews are remote URLs; they can fail offline. The UI must remain usable with neutral/blank preview surfaces.
-- This is a bigger Pet Manager UI rewrite than Phase 13A; keep install/state/security code unchanged to limit risk.
-- Without real per-animation preview images, the Idle/Happy/Wave tiles will reuse available pet art rather than showing true animation states.
+- This is a bigger Familiar Manager UI rewrite than Phase 13A; keep install/state/security code unchanged to limit risk.
+- Without real per-animation preview images, the Idle/Happy/Wave tiles will reuse available familiar art rather than showing true animation states.
 - Category filters are intentionally omitted until catalog metadata includes real tags.
 
 ## Security/privacy notes
 
 - No new persisted data.
-- No broad install behavior changes; narrow stale-target cleanup is allowed when a previously failed/manual install leaves files on disk while state says the pet is not installed.
-- No direct use of `lfs/pets.png` at runtime.
+- No broad install behavior changes; narrow stale-target cleanup is allowed when a previously failed/manual install leaves files on disk while state says the familiar is not installed.
+- No direct use of `lfs/familiars.png` at runtime.
 - Keep Electron renderer sandbox/context isolation unchanged.
-- CSP should allow only the image sources needed for data bundled assets and exact existing catalog preview origin (`https://openpets.dev`); no remote script/style execution and no `file:` images.
-- Removing a removable current-default pet must preserve existing safe fallback behavior to the built-in pet.
+- CSP should allow only the image sources needed for data bundled assets and exact existing catalog preview origin (`https://familiaros.dev`); no remote script/style execution and no `file:` images.
+- Removing a removable current-default familiar must preserve existing safe fallback behavior to the built-in familiar.
 
 ## Test/check plan
 
 Run:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 ```bash
@@ -125,19 +125,19 @@ pnpm package:desktop:dir
 ## Manual verification guide
 
 1. Run `pnpm dev:desktop`.
-2. Open Pet Manager from the tray.
-3. Confirm the page resembles `lfs/pets.png` direction: light two-column gallery/detail layout, not a literal screenshot paste.
-4. Confirm the default/bundled pet is selected by default and shows a large detail panel.
+2. Open Familiar Manager from the tray.
+3. Confirm the page resembles `lfs/familiars.png` direction: light two-column gallery/detail layout, not a literal screenshot paste.
+4. Confirm the default/bundled familiar is selected by default and shows a large detail panel.
 5. Type in search and confirm gallery cards filter.
 6. Click `All` and `Installed` and confirm results update gracefully.
-7. Click a catalog pet and confirm the detail panel updates.
-8. Install a catalog pet and confirm it becomes installed/selectable without breaking the UI.
-9. Set an installed pet as default and confirm selected/default state updates.
-10. Remove a non-protected installed pet and confirm it disappears/falls back safely.
-11. If the current default is a removable installed pet, remove it and confirm OpenPets falls back safely to the built-in/default pet.
+7. Click a catalog familiar and confirm the detail panel updates.
+8. Install a catalog familiar and confirm it becomes installed/selectable without breaking the UI.
+9. Set an installed familiar as default and confirm selected/default state updates.
+10. Remove a non-protected installed familiar and confirm it disappears/falls back safely.
+11. If the current default is a removable installed familiar, remove it and confirm FamiliarOS falls back safely to the built-in/default familiar.
 12. Simulate offline/catalog error or use fixture/error state if available; confirm the gallery remains usable and image failures show neutral preview surfaces with no broken image icon.
-13. Confirm a broken installed pet, if present, is shown but cannot be selected as default.
-14. Confirm an installed pet missing from the current catalog still appears and remains manageable.
+13. Confirm a broken installed familiar, if present, is shown but cannot be selected as default.
+14. Confirm an installed familiar missing from the current catalog still appears and remains manageable.
 15. Resize to 720×520 and confirm the layout remains usable with scrolling.
 16. Quickly inspect onboarding, Settings, and Agent Setup for obvious shared-style regressions.
 
@@ -149,7 +149,7 @@ Blockers: none.
 
 Should-fix feedback:
 
-- Clarify remote preview policy: only validated `CatalogPetV2.preview` from main-process catalog data; exact CSP such as `img-src data: https://openpets.dev`; no broad `https:`, `*`, or `file:`; no mutable `InstalledPetState.source.preview` without revalidation.
+- Clarify remote preview policy: only validated `CatalogPetV2.preview` from main-process catalog data; exact CSP such as `img-src data: https://familiaros.dev`; no broad `https:`, `*`, or `file:`; no mutable `InstalledPetState.source.preview` without revalidation.
 - Require previews to crop a single sprite frame, not show full spritesheets.
 - Use DOM `addEventListener("error", ...)` for image failures, not inline `onerror` attributes.
 - Add offline/image-failure behavior: no broken image icon, visible fallback thumbnail/card/detail, install/default/remove still usable.
@@ -161,8 +161,8 @@ Nice-to-have feedback:
 
 - Use `loading="lazy"`, `decoding="async"`, and `referrerpolicy="no-referrer"` for remote preview images.
 - Keep gallery model helpers small.
-- Add manual checks for catalog offline/fixture/error, broken installed pet, and installed pet missing from current catalog.
-- Add package contract checks for Pet Manager CSP and bundled logo/default thumbnail assets if used.
+- Add manual checks for catalog offline/fixture/error, broken installed familiar, and installed familiar missing from current catalog.
+- Add package contract checks for Familiar Manager CSP and bundled logo/default thumbnail assets if used.
 
 Verdict: not implementation-ready until image/CSP rules and spritesheet cropping/fallback behavior are tightened.
 
@@ -183,7 +183,7 @@ Accepted:
 
 - Use lazy/async/no-referrer attributes for remote preview images.
 - Keep gallery helpers small and avoid framework-like preload code.
-- Add package contract checks for Pet Manager CSP and bundled assets when implemented.
+- Add package contract checks for Familiar Manager CSP and bundled assets when implemented.
 
 ## Implementation review
 
@@ -192,20 +192,20 @@ Reviewed by Designer and Oracle after implementation.
 Validation passed:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 pnpm package:desktop:dir
 ```
 
 Initial Designer should-fix feedback:
 
-- Add keyboard-visible focus styling for Pet Manager cards.
+- Add keyboard-visible focus styling for Familiar Manager cards.
 - Adjust spritesheet crop/container sizing to avoid distorting the first-frame preview.
 
 Initial Oracle should-fix feedback:
 
 - Fix nested interactive keyboard behavior where card-level Enter/Space handling could intercept nested action button keyboard activation.
-- Tighten packaging contract CSP assertions so onboarding and Pet Manager CSPs are checked separately and exactly.
+- Tighten packaging contract CSP assertions so onboarding and Familiar Manager CSPs are checked separately and exactly.
 
 Final Designer verdict: approved. Previous UI/accessibility feedback resolved.
 
@@ -215,23 +215,23 @@ Final Oracle verdict: approved for closeout. Previous security/CSP/data-integrit
 
 Fixed:
 
-- Added `.pm-pet-card:focus-visible` styling.
+- Added `.pm-familiar-card:focus-visible` styling.
 - Adjusted thumbnail/mini sprite containers to match the 8×9 spritesheet frame aspect more closely.
 - Guarded card keydown handling with `event.target !== card` so nested action buttons keep normal keyboard activation.
-- Tightened package contract checks to assert exact onboarding and Pet Manager CSP strings.
+- Tightened package contract checks to assert exact onboarding and Familiar Manager CSP strings.
 - Strengthened catalog preview URL validation with `URL` parsing, exact protocol/host/no credentials/no port/path/`.webp` checks.
-- Updated filter rendering so active visual state stays in sync and detail prefers visible filtered pets.
+- Updated filter rendering so active visual state stays in sync and detail prefers visible filtered familiars.
 
 ## Manual follow-up fixes
 
 Fixed after manual testing:
 
-- Pet Manager now opens at 1160×780 while other task windows keep their prior default sizing.
-- Removed the large embedded default spritesheet from Pet Manager HTML to avoid Electron `ERR_INVALID_URL` from oversized data URLs.
+- Familiar Manager now opens at 1160×780 while other task windows keep their prior default sizing.
+- Removed the large embedded default spritesheet from Familiar Manager HTML to avoid Electron `ERR_INVALID_URL` from oversized data URLs.
 - Replaced visible `<img>` sprite cropping with validated, preloaded CSS background sprites so previews do not show broken image icons.
-- Removed decorative platform/fallback art from the detail spotlight; the selected pet sprite is the focus.
+- Removed decorative platform/fallback art from the detail spotlight; the selected familiar sprite is the focus.
 - Added install cleanup for stale target directories before renaming a validated temp install directory into place.
-- Added Pet Manager `no-referrer` meta for CSS background preview requests.
+- Added Familiar Manager `no-referrer` meta for CSS background preview requests.
 
 Accepted:
 
diff --git a/docs/phases/phase-13d-agent-setup-polish.md b/docs/phases/phase-13d-agent-setup-polish.md
index 6d26f707..7d193ec7 100644
--- a/docs/phases/phase-13d-agent-setup-polish.md
+++ b/docs/phases/phase-13d-agent-setup-polish.md
@@ -2,7 +2,7 @@
 
 ## Goal
 
-Redesign the Agent Setup window into a polished **Integrations** hub that matches the new OpenPets visual direction while preserving all existing Claude MCP and hook behavior.
+Redesign the Agent Setup window into a polished **Integrations** hub that matches the new FamiliarOS visual direction while preserving all existing Claude MCP and hook behavior.
 
 The first screen is a grid of integrations. Claude is the only functional integration in this phase; future integrations are visible but inert/disabled. Claude can be quickly installed when safe, or opened into a Claude detail/configuration view.
 
@@ -31,7 +31,7 @@ Opening **Configure Agents** shows a polished integrations grid:
 
 ## Acceptance criteria
 
-- Agent Setup uses a polished light UI consistent with Pet Manager and onboarding.
+- Agent Setup uses a polished light UI consistent with Familiar Manager and onboarding.
 - Layout is usable at the current task window size and responsive at 720×520 with scrolling.
 - First view is an integrations grid, not a split Claude configuration view.
 - Bundled integration SVG icons from `apps/desktop/assets/integrations/` are used through data URLs.
@@ -54,14 +54,14 @@ Opening **Configure Agents** shows a polished integrations grid:
 - Exact CSP/asset policy is explicit:
   - if no images are used, keep the current restrictive CSP without `img-src`,
   - if bundled logos/icons are used, allow only `img-src data:`,
-  - do not allow `https://openpets.dev`, broad `https:`, `file:`, `*`, remote fonts, or remote assets in Agent Setup.
+  - do not allow `https://familiaros.dev`, broad `https:`, `file:`, `*`, remote fonts, or remote assets in Agent Setup.
 - Replace, Remove, Hook Install/Update, and Hook Uninstall keep visible risk copy and require an explicit user click.
 - The global Claude hooks warning remains visible near hook actions because hooks modify user-level Claude settings.
 - Command-mode behavior is preserved: packaged builds remain forced to bundled mode by existing validation, and UI polish must not allow packaged users to switch to local/published mode or bypass mode validation.
 - Inline SVG icons are created through static markup or DOM `createElementNS`; no `innerHTML` for icons or dynamic labels.
 - Action result/status copy is exposed in a visible status region so busy/result changes are understandable.
-- `pnpm --filter @open-pets/desktop build` passes.
-- `pnpm --filter @open-pets/desktop test` passes.
+- `pnpm --filter @familiaros/desktop build` passes.
+- `pnpm --filter @familiaros/desktop test` passes.
 - Designer review is completed for visual polish.
 - Oracle implementation review is completed and feedback is dispositioned.
 
@@ -69,7 +69,7 @@ Opening **Configure Agents** shows a polished integrations grid:
 
 - `apps/desktop/src/windows.ts`
   - Replace Agent Setup markup with integrations hub plus Claude detail structure.
-  - Add scoped Agent Setup CSS under `body[data-openpets-view="agent-setup"]`.
+  - Add scoped Agent Setup CSS under `body[data-familiaros-view="agent-setup"]`.
 - `apps/desktop/preload.cjs`
   - Render status classes, mode controls, button icons, and preview copy into the new structure.
   - Preserve existing IPC calls and action binding behavior.
@@ -81,7 +81,7 @@ Opening **Configure Agents** shows a polished integrations grid:
 1. Keep `agent-setup.ts` business logic unchanged.
 2. Build an integrations shell:
    - `.integrations-view`: logo/title plus integration card grid,
-   - `.claude-detail-view`: Claude status, pet routing, command mode, MCP actions, previews, hooks, and back navigation.
+   - `.claude-detail-view`: Claude status, familiar routing, command mode, MCP actions, previews, hooks, and back navigation.
 3. In preload:
    - map `status.state` and `hookStatus.status` to CSS classes,
    - render action buttons with inline SVG icons,
@@ -117,8 +117,8 @@ Opening **Configure Agents** shows a polished integrations grid:
 Run:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 If Agent Setup CSP/assets/package contracts change, also run:
@@ -137,10 +137,10 @@ pnpm check
 
 1. Run `pnpm dev:desktop`.
 2. Open Configure Agents from the tray.
-3. Confirm the page looks consistent with Pet Manager polish.
+3. Confirm the page looks consistent with Familiar Manager polish.
 4. Confirm Claude status, details, and available actions render clearly.
 5. Toggle local dev mode if available and confirm previews update.
-6. Change pet routing and confirm command/JSON previews update.
+6. Change familiar routing and confirm command/JSON previews update.
 7. Copy command and confirm result text updates.
 8. Run Refresh/Doctor and confirm status refreshes.
 9. If safe on your machine, verify Configure/Replace/Remove still respect existing enable/disable states and confirmation intent.
@@ -167,7 +167,7 @@ Blockers: none.
 
 Should-fix feedback:
 
-- Specify exact Agent Setup CSP/asset policy: no images means current CSP; bundled logo means `img-src data:` only; no remote assets or copied Pet Manager preview CSP.
+- Specify exact Agent Setup CSP/asset policy: no images means current CSP; bundled logo means `img-src data:` only; no remote assets or copied Familiar Manager preview CSP.
 - Tighten trust UX for destructive/global actions: Replace, Remove, Hook Install/Update, and Hook Uninstall keep visible risk copy and require explicit click; hook global warning remains visible.
 - Preserve command-mode behavior: packaged app remains forced to bundled mode, dev can toggle local/published only through existing validation.
 - Inline SVG icons must not use `innerHTML`; use static markup or DOM `createElementNS`.
@@ -224,8 +224,8 @@ Reviewed by Designer and Oracle after implementation.
 Validation passed:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 pnpm package:desktop:dir
 ```
 
@@ -233,7 +233,7 @@ Designer verdict: approved.
 
 Designer should-fix feedback:
 
-- Add accessible labels/live updates for command, MCP JSON, and hooks preview regions because they update when pet routing or command mode changes.
+- Add accessible labels/live updates for command, MCP JSON, and hooks preview regions because they update when familiar routing or command mode changes.
 
 Oracle verdict: approved.
 
@@ -266,22 +266,22 @@ Accepted:
 
 ## Claude detail redesign update
 
-User feedback after manual review: the Claude detail page was too dense and confusing, and mismatched/custom `openpets` MCP entries should not appear as scary errors by default.
+User feedback after manual review: the Claude detail page was too dense and confusing, and mismatched/custom `familiaros` MCP entries should not appear as scary errors by default.
 
 Updated UX direction:
 
 - Claude detail is a single-column page with three clear areas:
-  - **Connection**: status, pet routing, and only the actions that apply now.
+  - **Connection**: status, familiar routing, and only the actions that apply now.
   - **Optional Claude hooks**: hook status/actions with a global-settings warning.
   - **Advanced details**: collapsed command/MCP JSON/hooks JSON previews for inspection/manual fallback.
-- Existing/custom `openpets` MCP entries are treated as installed-but-custom/installed-but-unverified in the UI.
+- Existing/custom `familiaros` MCP entries are treated as installed-but-custom/installed-but-unverified in the UI.
 - `configure` still refuses to overwrite existing custom/unverified entries; `replace` remains explicit and separate.
 - Remove and hook actions stay visible only in the Claude detail view, never from the grid quick action.
 
 Review results:
 
 - Designer approved the simplified single-column detail flow with no blockers or should-fix issues.
-- Oracle approved safety/correctness with one should-fix: bundled-mode custom-entry warning must mention that Remove deletes the `openpets` MCP entry.
+- Oracle approved safety/correctness with one should-fix: bundled-mode custom-entry warning must mention that Remove deletes the `familiaros` MCP entry.
 
 Disposition:
 
@@ -291,8 +291,8 @@ Disposition:
 Validation passed after fixes:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 ## Claude detail loading/action refinement
diff --git a/docs/phases/phase-13e-onboarding-flow-polish.md b/docs/phases/phase-13e-onboarding-flow-polish.md
index e9d6f572..210f321f 100644
--- a/docs/phases/phase-13e-onboarding-flow-polish.md
+++ b/docs/phases/phase-13e-onboarding-flow-polish.md
@@ -2,13 +2,13 @@
 
 ## Goal
 
-Finish the first-run onboarding flow beyond the polished welcome screen so the Pets, Integrations, and Ready steps feel like a direct continuation of the welcome screen and guide users into the real product windows.
+Finish the first-run onboarding flow beyond the polished welcome screen so the Familiars, Integrations, and Ready steps feel like a direct continuation of the welcome screen and guide users into the real product windows.
 
-Phase 13B polished only the first welcome/greeting step. This phase polishes the remaining onboarding steps and makes the primary action on those steps open Pet Manager or Integrations.
+Phase 13B polished only the first welcome/greeting step. This phase polishes the remaining onboarding steps and makes the primary action on those steps open Familiar Manager or Integrations.
 
 ## Non-goals
 
-- No new pet installation behavior.
+- No new familiar installation behavior.
 - No new Claude MCP or hooks behavior.
 - No new persisted onboarding sub-step state.
 - No remote assets or new network calls.
@@ -19,48 +19,48 @@ Phase 13B polished only the first welcome/greeting step. This phase polishes the
 
 On first launch, onboarding should feel complete:
 
-- Step 0 remains the polished OpenPets welcome.
-- Step 1 explains choosing/managing pets and makes **Open Pet Manager** the primary action.
+- Step 0 remains the polished FamiliarOS welcome.
+- Step 1 explains choosing/managing familiars and makes **Open Familiar Manager** the primary action.
 - Step 2 explains connecting coding agents and makes **Open Integrations** the primary action.
-- Step 3 clearly explains that setup is done and where to reopen Pet Manager/Integrations later.
-- The user can still skip/continue without installing a pet or configuring Claude.
-- Pets/Integrations step copy makes focus behavior clear: if the user opens the product window, they should return to onboarding to continue.
+- Step 3 clearly explains that setup is done and where to reopen Familiar Manager/Integrations later.
+- The user can still skip/continue without installing a familiar or configuring Claude.
+- Familiars/Integrations step copy makes focus behavior clear: if the user opens the product window, they should return to onboarding to continue.
 
 ## Acceptance criteria
 
-- Onboarding still has four clear steps: Welcome, Pets, Integrations, Ready.
-- Later steps use the same light polished visual language as the welcome/Pet Manager/Integrations work, not the older dark generic card style.
-- Onboarding does not auto-open Pet Manager or Integrations on step entry.
-- Open Pet Manager and Open Integrations are primary actions; Continue remains secondary beside them.
-- If Pet Manager or Integrations is already open, clicking the primary action reuses/focuses the existing window through the existing `openTaskWindow` behavior and does not create duplicates.
+- Onboarding still has four clear steps: Welcome, Familiars, Integrations, Ready.
+- Later steps use the same light polished visual language as the welcome/Familiar Manager/Integrations work, not the older dark generic card style.
+- Onboarding does not auto-open Familiar Manager or Integrations on step entry.
+- Open Familiar Manager and Open Integrations are primary actions; Continue remains secondary beside them.
+- If Familiar Manager or Integrations is already open, clicking the primary action reuses/focuses the existing window through the existing `openTaskWindow` behavior and does not create duplicates.
 - Manual open is best-effort: if a window open fails, onboarding shows a readable status/error and the primary button remains usable.
 - Each open step has a dedicated status line with clear states: instruction text, `Opening…`, `Opened — return here to continue.`, and failure text.
 - Manual buttons remain available:
-  - Open Pet Manager / Continue,
+  - Open Familiar Manager / Continue,
   - Open Integrations / Continue,
-  - Start using OpenPets,
+  - Start using FamiliarOS,
   - optional Ready-step shortcuts.
 - Step labels/copy/buttons use current product naming: “Integrations” rather than “Agent Setup” everywhere user-facing. Internal IPC/function names may remain unchanged.
 - Onboarding completion behavior remains unchanged: Finish marks onboarding completed and closes the onboarding window.
 - Closing onboarding before Finish still leaves onboarding incomplete and available later.
-- Auto-opening Pet Manager/Integrations does not mutate pet catalog, Claude MCP config, or hook settings by itself.
+- Auto-opening Familiar Manager/Integrations does not mutate familiar catalog, Claude MCP config, or hook settings by itself.
 - Existing IPC sender allow-list remains local-only and only allows onboarding to open internal task windows.
 - Onboarding CSP remains `img-src data:` only; no remote assets.
 - Dynamic text/status updates use DOM APIs/textContent, not `innerHTML`.
 - Keyboard/tab access still reaches all actions.
 - Window remains usable at 900×760 and 720×520 with scrolling if needed.
-- `pnpm --filter @open-pets/desktop build` passes.
-- `pnpm --filter @open-pets/desktop test` passes.
+- `pnpm --filter @familiaros/desktop build` passes.
+- `pnpm --filter @familiaros/desktop test` passes.
 - Designer review is completed for the polished later-step UX.
 - Oracle implementation review is completed and feedback is dispositioned.
 
 ## Proposed files/directories
 
 - `apps/desktop/src/windows.ts`
-  - Update onboarding markup and scoped styles for Pets, Integrations, Ready steps.
+  - Update onboarding markup and scoped styles for Familiars, Integrations, Ready steps.
   - Rename visible Agent Setup copy to Integrations where appropriate.
 - `apps/desktop/preload.cjs`
-  - Trigger one-time Pet Manager/Integrations auto-open when entering steps 1 and 2.
+  - Trigger one-time Familiar Manager/Integrations auto-open when entering steps 1 and 2.
   - Keep manual buttons and completion behavior.
 - `apps/desktop/src/check-packaging-contract.ts`
   - Update assertions only if onboarding contract/copy/assets need coverage.
@@ -71,11 +71,11 @@ On first launch, onboarding should feel complete:
 
 1. Keep the existing four-step onboarding model.
 2. Replace the older dark generic card markup for steps 1–3 with polished light cards:
-   - Pets: short explanation, “Pet Manager opened” status, Open/Continue actions.
+   - Familiars: short explanation, “Familiar Manager opened” status, Open/Continue actions.
    - Integrations: short explanation, “Integrations opened” status, Open/Continue actions.
    - Ready: clear final call-to-action and shortcuts.
 3. In preload, keep `showStep(step)` focused on navigation only; do not auto-open child windows.
-4. Clicking Open Pet Manager calls `onboardingApi.openPetManager()` and updates a dedicated status line.
+4. Clicking Open Familiar Manager calls `onboardingApi.openPetManager()` and updates a dedicated status line.
 5. Clicking Open Integrations calls `onboardingApi.openAgentSetup()` and updates a dedicated status line.
 6. Continue buttons advance without opening windows.
 7. Do not make open actions install/configure anything; they only open internal windows.
@@ -84,13 +84,13 @@ On first launch, onboarding should feel complete:
 
 - Opening child windows can steal focus from onboarding. This now only happens after an explicit user click on the primary action.
 - Onboarding step copy/status must explicitly say that the product window opened and the user should return to onboarding to continue.
-- Pet Manager/Integrations are separate task windows, so users may need to return to onboarding manually after reviewing them. The onboarding copy should make that clear.
+- Familiar Manager/Integrations are separate task windows, so users may need to return to onboarding manually after reviewing them. The onboarding copy should make that clear.
 
 ## Security/privacy notes
 
 - No new external IPC or network behavior.
 - Auto-open only calls existing internal window-opening IPC from the onboarding renderer.
-- No automatic Claude configuration, hook installation, pet installation, file writes, or user settings mutation beyond final onboarding completion.
+- No automatic Claude configuration, hook installation, familiar installation, file writes, or user settings mutation beyond final onboarding completion.
 - Existing CSP restrictions remain.
 
 ## Test/check plan
@@ -98,8 +98,8 @@ On first launch, onboarding should feel complete:
 Run:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 If onboarding CSP/assets/package contracts change, also run:
@@ -111,17 +111,17 @@ pnpm package:desktop:dir
 ## Manual verification guide
 
 1. Run `pnpm dev:desktop`.
-2. Reset onboarding state if needed by deleting the OpenPets app data directory.
+2. Reset onboarding state if needed by deleting the FamiliarOS app data directory.
 3. Confirm Welcome still looks polished.
-4. Click Next and confirm Pet Manager does not auto-open.
-5. Confirm the Pets step visually matches the welcome screen direction and has Open Pet Manager as the primary action with Continue secondary beside it.
-6. Click Open Pet Manager and confirm it opens/focuses Pet Manager and updates the status line.
+4. Click Next and confirm Familiar Manager does not auto-open.
+5. Confirm the Familiars step visually matches the welcome screen direction and has Open Familiar Manager as the primary action with Continue secondary beside it.
+6. Click Open Familiar Manager and confirm it opens/focuses Familiar Manager and updates the status line.
 7. Return to onboarding and click Continue; confirm Integrations does not auto-open.
 8. Confirm the Integrations step visually matches the welcome screen direction and has Open Integrations as the primary action with Continue secondary beside it.
 9. Click Open Integrations and confirm it opens/focuses Integrations and updates the status line.
-10. Confirm neither auto-open action installs pets, configures Claude, installs hooks, or removes anything.
+10. Confirm neither auto-open action installs familiars, configures Claude, installs hooks, or removes anything.
 11. Confirm Ready step copy and shortcuts are clear.
-12. Click Start using OpenPets and confirm onboarding closes and does not reopen on next launch.
+12. Click Start using FamiliarOS and confirm onboarding closes and does not reopen on next launch.
 13. Confirm closing before Finish keeps onboarding incomplete.
 14. Resize to 720×520 and confirm all steps remain usable.
 
@@ -170,8 +170,8 @@ After an initial implementation pass, user feedback was that auto-open felt wron
 
 Updated direction:
 
-- Do not auto-open Pet Manager or Integrations on step entry.
-- Make **Open Pet Manager** / **Open Integrations** the primary action.
+- Do not auto-open Familiar Manager or Integrations on step entry.
+- Make **Open Familiar Manager** / **Open Integrations** the primary action.
 - Keep **Continue** as the secondary action next to the primary action.
 - Ensure the later onboarding cards use the same light background, rounded glass card, clouds, typography, and visual direction as the welcome screen.
 
@@ -179,9 +179,9 @@ Updated direction:
 
 Implemented:
 
-- Reworked Pets, Integrations, and Ready steps into polished light cards.
+- Reworked Familiars, Integrations, and Ready steps into polished light cards.
 - Renamed user-facing Agent Setup copy/buttons to Integrations.
-- Added dedicated auto-open status lines for Pet Manager and Integrations.
+- Added dedicated auto-open status lines for Familiar Manager and Integrations.
 - Added one-time auto-open behavior for steps 1 and 2 after user navigation.
 - Preserved manual open buttons and finish behavior.
 
diff --git a/docs/phases/phase-13f-settings-tray-polish.md b/docs/phases/phase-13f-settings-tray-polish.md
index ba9de4bf..9bffae8c 100644
--- a/docs/phases/phase-13f-settings-tray-polish.md
+++ b/docs/phases/phase-13f-settings-tray-polish.md
@@ -7,55 +7,55 @@ Polish the remaining basic desktop surfaces so Settings and tray/menu copy match
 ## Non-goals
 
 - No new settings schema.
-- No new pet behavior beyond existing preference/reset actions.
+- No new familiar behavior beyond existing preference/reset actions.
 - No new Integrations/Claude behavior.
 - No remote assets or network calls.
 - No changes to onboarding flow beyond label consistency if needed.
 
 ## User-visible/manual outcome
 
-- Settings opens as a polished light OpenPets window instead of the older dark generic card layout.
+- Settings opens as a polished light FamiliarOS window instead of the older dark generic card layout.
 - Settings groups current controls into clear cards/rows with better copy and consistent button/toggle styling.
 - Tray menu uses current product labels, especially **Integrations** instead of **Configure Agents**.
-- Tray menu order is clearer and still exposes setup, pet visibility, pause/resume, Pet Manager, Integrations, Settings, and Quit.
+- Tray menu order is clearer and still exposes setup, familiar visibility, pause/resume, Familiar Manager, Integrations, Settings, and Quit.
 
 ## Acceptance criteria
 
-- Settings uses a light background/card style consistent with Onboarding, Pet Manager, and Integrations.
+- Settings uses a light background/card style consistent with Onboarding, Familiar Manager, and Integrations.
 - Existing Settings controls are preserved:
-  - Open default pet on app launch,
+  - Open default familiar on app launch,
   - Speech bubbles enabled,
-  - Pet scale coming later,
-  - Reset default pet position.
+  - Familiar scale coming later,
+  - Reset default familiar position.
 - Settings controls remain wired to the existing preload/state behavior.
 - Settings result/error feedback remains visible.
 - Settings remains usable at 900×760 and minimum 720×520.
 - No remote assets are added; Settings CSP remains restrictive and does not need `img-src` unless images are added.
 - Tray menu user-facing copy uses current naming:
   - `Continue Setup...` can remain,
-  - `Manage Pets...` remains acceptable,
+  - `Manage Familiars...` remains acceptable,
   - `Configure Agents...` becomes `Integrations...`,
   - Quit and pause/show/hide labels remain clear.
 - Tray menu order remains:
-  - `OpenPets` disabled header,
+  - `FamiliarOS` disabled header,
   - separator,
   - conditional `Continue Setup...` plus separator when onboarding is incomplete,
-  - `Default Pet: Built-in Pet`,
-  - `Show/Hide Default Pet`,
-  - `Pause/Resume All Pets`,
+  - `Default Familiar: Built-in Familiar`,
+  - `Show/Hide Default Familiar`,
+  - `Pause/Resume All Familiars`,
   - separator,
-  - `Manage Pets...`,
+  - `Manage Familiars...`,
   - `Integrations...`,
   - `Settings...`,
   - separator,
-  - `Quit OpenPets`.
+  - `Quit FamiliarOS`.
 - Tray actions still call the same internal functions/windows.
-- Agent setup window title/user-facing definition uses **Integrations** (`OpenPets — Integrations`) while preserving internal `agent-setup` identifiers.
+- Agent setup window title/user-facing definition uses **Integrations** (`FamiliarOS — Integrations`) while preserving internal `agent-setup` identifiers.
 - Settings includes visible `aria-live` status feedback for successful preference saves and reset actions, plus existing error feedback.
-- Settings-specific light styles are scoped to `body[data-openpets-view="settings"]`; avoid broad edits to global `button`, `.card`, or `.setting-row` behavior.
+- Settings-specific light styles are scoped to `body[data-familiaros-view="settings"]`; avoid broad edits to global `button`, `.card`, or `.setting-row` behavior.
 - Settings has clear keyboard/focus behavior: labels toggle checkboxes, reset button is reachable, focus states are visible.
-- `pnpm --filter @open-pets/desktop build` passes.
-- `pnpm --filter @open-pets/desktop test` passes.
+- `pnpm --filter @familiaros/desktop build` passes.
+- `pnpm --filter @familiaros/desktop test` passes.
 - Designer review is completed for Settings polish.
 - Oracle implementation review is completed and feedback is dispositioned.
 
@@ -73,13 +73,13 @@ Polish the remaining basic desktop surfaces so Settings and tray/menu copy match
 ## Technical approach
 
 1. Keep `createSettingsHtml()` simple and data-free: no assets, no remote content.
-2. Add scoped CSS under `body[data-openpets-view="settings"]` to avoid broad regressions.
+2. Add scoped CSS under `body[data-familiaros-view="settings"]` to avoid broad regressions.
 3. Use native checkboxes/buttons with polished row/card styling; do not invent custom persistence.
 4. Preserve existing element IDs used by preload:
-   - `open-default-pet-on-launch`,
+   - `open-default-familiar-on-launch`,
    - `speech-bubbles-enabled`,
-   - `pet-scale-value`,
-   - `reset-default-pet-position`.
+   - `familiar-scale-value`,
+   - `reset-default-familiar-position`.
 5. Update tray label `Configure Agents...` to `Integrations...`; keep `openTaskWindow("agent-setup")` internally.
 6. Update any visible `Configure Agents` window title/heading copy to Integrations while preserving internal task kind names.
 
@@ -100,8 +100,8 @@ Polish the remaining basic desktop surfaces so Settings and tray/menu copy match
 Run:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 If shared styles unexpectedly affect multiple windows, also run/manual-check the app via:
@@ -113,18 +113,18 @@ pnpm dev:desktop
 ## Manual verification guide
 
 1. Run `pnpm dev:desktop`.
-2. Open Settings from the tray and confirm it matches the light OpenPets polish direction.
-3. Toggle “Open default pet on app launch” and confirm it persists after closing/reopening Settings.
+2. Open Settings from the tray and confirm it matches the light FamiliarOS polish direction.
+3. Toggle “Open default familiar on app launch” and confirm it persists after closing/reopening Settings.
 4. Toggle “Speech bubbles enabled” and confirm it persists after closing/reopening Settings.
 5. Toggle each checkbox twice in the same open Settings window and confirm controls re-enable after each save.
-6. Restart the desktop app and confirm both toggles persist; for “Open default pet on app launch,” confirm startup behavior matches the setting.
-7. Show the default pet, move it, click Reset default pet position twice, and confirm it returns near the bottom-right of the primary display and the button re-enables after each click.
+6. Restart the desktop app and confirm both toggles persist; for “Open default familiar on app launch,” confirm startup behavior matches the setting.
+7. Show the default familiar, move it, click Reset default familiar position twice, and confirm it returns near the bottom-right of the primary display and the button re-enables after each click.
 8. Confirm Settings status/success text updates after toggles and reset, and errors still display if something fails.
 9. Resize Settings to 720×520 and confirm no clipped controls, usable scrolling, and visible status/error feedback.
 10. Open tray menu and confirm `Integrations...` appears instead of `Configure Agents...` in the expected order.
-11. Click every tray menu item once where safe: Continue Setup (if visible), Show/Hide, Pause/Resume, Manage Pets, Integrations, Settings.
+11. Click every tray menu item once where safe: Continue Setup (if visible), Show/Hide, Pause/Resume, Manage Familiars, Integrations, Settings.
 12. Click `Integrations...` and confirm the Integrations window opens with the user-facing title/copy updated.
-13. Smoke-check Pet Manager and Onboarding for obvious style regressions.
+13. Smoke-check Familiar Manager and Onboarding for obvious style regressions.
 
 ## Oracle plan review
 
@@ -132,7 +132,7 @@ Reviewed by Oracle.
 
 Blockers:
 
-- Settings preload ID inventory omitted `pet-scale-value`, which current preload requires.
+- Settings preload ID inventory omitted `familiar-scale-value`, which current preload requires.
 
 Should-fix feedback:
 
@@ -141,7 +141,7 @@ Should-fix feedback:
 - Clarify Settings feedback behavior with visible `aria-live` success/status text or narrow to errors only.
 - Add explicit minimum-size manual checks.
 - Add restart persistence verification for settings toggles and startup behavior.
-- Strengthen reset-position manual verification by moving/showing the pet first.
+- Strengthen reset-position manual verification by moving/showing the familiar first.
 - Require Settings-specific scoped light overrides, not broad global style edits.
 
 Nice-to-have feedback:
@@ -156,7 +156,7 @@ Verdict: conditionally approved after spec fixes.
 
 Fixed:
 
-- Added `pet-scale-value` to required ID inventory.
+- Added `familiar-scale-value` to required ID inventory.
 - Added exact tray order.
 - Required user-facing Integrations naming for tray and window title/definition.
 - Required visible Settings status/success feedback.
@@ -172,7 +172,7 @@ Accepted:
 Implemented:
 
 - Redesigned Settings as scoped light UI with header, grouped panels, polished rows, focus states, and status feedback.
-- Preserved existing Settings controls and IDs, including `pet-scale-value`.
+- Preserved existing Settings controls and IDs, including `familiar-scale-value`.
 - Added `settings-status` as an `aria-live` region for saving/reset feedback.
 - Updated user-facing agent setup title/heading to Integrations while preserving internal `agent-setup` IDs.
 - Renamed tray `Configure Agents...` to `Integrations...` without changing the underlying action.
@@ -180,14 +180,14 @@ Implemented:
 Follow-up Settings changes:
 
 - Removed the Speech bubbles toggle because speech bubbles are now always enabled.
-- Added a Launch OpenPets at login toggle backed by Electron login item settings on supported platforms.
+- Added a Launch FamiliarOS at login toggle backed by Electron login item settings on supported platforms.
 - Kept unsupported platforms disabled with explanatory copy.
 
 Validation passed:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 Designer review: approved with no blockers or should-fix issues.
diff --git a/docs/phases/phase-14-pet-scale-setting.md b/docs/phases/phase-14-pet-scale-setting.md
index 9f1e19eb..f5fef4c1 100644
--- a/docs/phases/phase-14-pet-scale-setting.md
+++ b/docs/phases/phase-14-pet-scale-setting.md
@@ -1,58 +1,58 @@
-# Phase 14: Pet Scale Setting
+# Phase 14: Familiar Scale Setting
 
 ## Goal
 
-Make the existing `petScale` preference real: Settings should let users choose pet size, and the desktop pet should update without layout shift or cropping.
+Make the existing `petScale` preference real: Settings should let users choose familiar size, and the desktop familiar should update without layout shift or cropping.
 
 ## Non-goals
 
-- No new pet animation states.
-- No new pet window transparency/drag behavior beyond preserving current behavior.
+- No new familiar animation states.
+- No new familiar window transparency/drag behavior beyond preserving current behavior.
 - No new persisted schema version.
-- No custom per-pet scale; scale applies to the default desktop pet renderer.
+- No custom per-familiar scale; scale applies to the default desktop familiar renderer.
 - No changes to MCP speech safety or bubble content.
 
 ## User-visible/manual outcome
 
-- Settings shows a usable Pet scale control instead of “coming later.”
-- Changing scale updates the visible default pet shortly after save.
-- The pet remains unclipped at supported scale values.
-- Chat bubble remains an overlay above the pet and does not move the pet.
-- Reset position still places the pet near the bottom-right using the window bounds.
+- Settings shows a usable Familiar scale control instead of “coming later.”
+- Changing scale updates the visible default familiar shortly after save.
+- The familiar remains unclipped at supported scale values.
+- Chat bubble remains an overlay above the familiar and does not move the familiar.
+- Reset position still places the familiar near the bottom-right using the window bounds.
 
 ## Acceptance criteria
 
-- Settings exposes pet scale choices: XXS, XS, Small, Medium, Large, XL, XXL, XXXL.
+- Settings exposes familiar scale choices: XXS, XS, Small, Medium, Large, XL, XXL, XXXL.
 - Default scale is **Medium** (`0.56`).
-- A drag-to-resize handle appears on the pet window for interactive scale adjustment.
+- A drag-to-resize handle appears on the familiar window for interactive scale adjustment.
 - Persisted `preferences.petScale` accepts only supported numeric values and normalizes invalid/old values to the default.
 - `validatePreferencePatch()` accepts only supported `petScale` values from Settings IPC; unsupported/non-finite values are rejected.
 - Current and newly created state files use the new default scale.
-- Changing scale via Settings saves through existing `openpets:update-preferences` IPC.
-- Changing scale refreshes the default pet content immediately if it is visible.
+- Changing scale via Settings saves through existing `familiaros:update-preferences` IPC.
+- Changing scale refreshes the default familiar content immediately if it is visible.
 - Unrelated preference updates, including launch/speech toggles and tray show/hide writes, do not reset the selected scale.
-- Scale applies to built-in and installed default pet sprites.
-- Scale is passed explicitly through the default-pet render path; explicit agent pet windows are not accidentally changed unless deliberately passed a scale later.
-- Pet shell/card dimensions, sprite transform, and bubble offset all derive from the same scale constant/value.
-- Bubble vertical position is derived from scale and stays close to the pet without shifting the pet.
-- Pet and bubble do not get cropped at supported scales.
+- Scale applies to built-in and installed default familiar sprites.
+- Scale is passed explicitly through the default-familiar render path; explicit agent familiar windows are not accidentally changed unless deliberately passed a scale later.
+- Familiar shell/card dimensions, sprite transform, and bubble offset all derive from the same scale constant/value.
+- Bubble vertical position is derived from scale and stays close to the familiar without shifting the familiar.
+- Familiar and bubble do not get cropped at supported scales.
 - Existing IDs needed by Settings/preload remain stable or are intentionally updated together.
-- `pnpm --filter @open-pets/desktop build` passes.
-- `pnpm --filter @open-pets/desktop test` passes.
+- `pnpm --filter @familiaros/desktop build` passes.
+- `pnpm --filter @familiaros/desktop test` passes.
 
 ## Proposed files/directories
 
 - `apps/desktop/src/app-state.ts`
   - Normalize/validate `petScale`.
   - Change default scale to Medium.
-- `apps/desktop/src/pet-window.ts`
+- `apps/desktop/src/familiar-window.ts`
   - Use persisted `petScale` for sprite and bubble layout.
 - `apps/desktop/src/windows.ts`
-  - Replace disabled “Pet scale” row with a real select/segmented control.
-  - Refresh pet content after scale updates.
+  - Replace disabled “Familiar scale” row with a real select/segmented control.
+  - Refresh familiar content after scale updates.
 - `apps/desktop/preload.cjs`
   - Render and bind scale control.
-- `docs/phases/phase-14-pet-scale-setting.md`
+- `docs/phases/phase-14-familiar-scale-setting.md`
   - This spec, reviews, and dispositions.
 
 ## Technical approach
@@ -68,10 +68,10 @@ Make the existing `petScale` preference real: Settings should let users choose p
    - XXXL: `1.20`
 2. Make Medium (`0.56`) the default.
 3. Preserve old/corrupt state safety by normalizing any unsupported `petScale` to Medium. Old persisted `petScale: 1` should normalize to Medium because `1` was never the actual post-bugfix visual render scale.
-4. In Settings, add a `select id="pet-scale"` or equivalent simple control.
+4. In Settings, add a `select id="familiar-scale"` or equivalent simple control.
 5. On scale change, call existing `updatePreferences({ petScale })` and show status feedback.
 6. In main process preference update handler, compare previous vs next `petScale` and call `refreshDefaultPetContent()` only when scale actually changes.
-7. In pet renderer creation, read `state.preferences.petScale` and pass/use it for:
+7. In familiar renderer creation, read `state.preferences.petScale` and pass/use it for:
    - sprite transform scale,
    - scaled shell size,
    - installed card size,
@@ -80,7 +80,7 @@ Make the existing `petScale` preference real: Settings should let users choose p
 ## Risks and tradeoffs
 
 - Window size stays fixed at 220×260 for simplicity. Large scale is capped to fit within that viewport with the current bubble max height.
-- Position persistence stores top-left window position, not pet visual anchor. Changing scale may visually change the pet’s bottom/right footprint but should not jump the window unexpectedly.
+- Position persistence stores top-left window position, not familiar visual anchor. Changing scale may visually change the familiar’s bottom/right footprint but should not jump the window unexpectedly.
 - Existing old state files with `petScale: 1` will normalize to Medium, preserving the current corrected default size while allowing users to choose a smaller Small option.
 
 ## Security/privacy notes
@@ -95,21 +95,21 @@ Make the existing `petScale` preference real: Settings should let users choose p
 Run:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 ## Manual verification guide
 
 1. Run `pnpm dev:desktop`.
-2. Open Settings and confirm Pet scale offers Small, Medium, Large.
-3. With the pet visible, switch between Small/Medium/Large and confirm the visible pet updates.
+2. Open Settings and confirm Familiar scale offers Small, Medium, Large.
+3. With the familiar visible, switch between Small/Medium/Large and confirm the visible familiar updates.
 4. Change scale twice in the same Settings session and confirm controls stay enabled.
 5. Toggle launch/speech settings and confirm the selected scale does not reset.
-6. Test all scales with the built-in pet and with an installed pet set as default.
-7. Trigger short and long speech bubbles/reactions at each scale, especially Large, and confirm bubble/pet are not cropped and the pet does not move.
-8. Change scale while the pet is hidden, then show the pet and confirm the selected scale applies.
-9. Confirm Reset default pet position still moves the pet near bottom-right at Small and Large.
+6. Test all scales with the built-in familiar and with an installed familiar set as default.
+7. Trigger short and long speech bubbles/reactions at each scale, especially Large, and confirm bubble/familiar are not cropped and the familiar does not move.
+8. Change scale while the familiar is hidden, then show the familiar and confirm the selected scale applies.
+9. Confirm Reset default familiar position still moves the familiar near bottom-right at Small and Large.
 10. Restart the app and confirm selected scale persists.
 11. If manually editing state for verification, confirm fresh state defaults to Medium, old `petScale: 1` normalizes to Medium, and invalid values normalize to Medium.
 
@@ -127,17 +127,17 @@ Should-fix feedback:
 - Define scale constants/default in one main-process source of truth.
 - Clarify that old `petScale: 1` normalizes to the default because it was not the actual post-bugfix visual scale.
 - Ensure unrelated preference updates do not reset scale.
-- Pass scale explicitly through the default-pet path so explicit agent pet windows are not accidentally affected.
+- Pass scale explicitly through the default-familiar path so explicit agent familiar windows are not accidentally affected.
 - Require derived dimensions/offsets to use the same scale.
-- Refresh pet content only after real scale changes.
+- Refresh familiar content only after real scale changes.
 
 Manual verification gaps:
 
-- Test built-in and installed default pets.
+- Test built-in and installed default familiars.
 - Test long speech/reaction bubbles at each scale.
 - Test fresh state, old `petScale: 1`, invalid values.
 - Test repeated scale changes in one Settings session.
-- Test scale while pet hidden, then show pet.
+- Test scale while familiar hidden, then show familiar.
 - Test reset position at Small and Large.
 
 Verdict: conditionally approved after fixing scale sizing.
@@ -148,11 +148,11 @@ Fixed:
 
 - Added XXS, XS, XL, XXL, XXXL options.
 - Large kept at `0.72`; window dynamically sizes to fit larger scales.
-- Added a drag-to-resize handle on the pet window.
+- Added a drag-to-resize handle on the familiar window.
 - Added explicit Settings IPC validation requirement.
 - Added one-source-of-truth scale constants requirement.
 - Documented `petScale: 1` migration to the default.
-- Added unrelated preference preservation, explicit default-pet scale path, derived dimension, and refresh-on-real-change criteria.
+- Added unrelated preference preservation, explicit default-familiar scale path, derived dimension, and refresh-on-real-change criteria.
 - Expanded manual verification matrix.
 
 ## Implementation notes
@@ -162,17 +162,17 @@ Implemented:
 - Added supported scale constants in `app-state-core.ts`: XXS `0.24`, XS `0.32`, Small `0.44`, Medium `0.56`, Large `0.72`, XL `0.88`, XXL `1.04`, XXXL `1.20`.
 - Moved scale constants/normalization into pure `app-state-core.ts` so lightweight tests can cover scale normalization without importing Electron.
 - Changed default/invalid scale normalization to Medium.
-- Added real Settings Pet scale select and status feedback.
+- Added real Settings Familiar scale select and status feedback.
 - Added `petScale` validation to Settings preference IPC.
-- Refreshes default pet content only when scale changes.
-- Pet renderer derives shell size, sprite transform, installed-card size, and bubble offset from the selected scale.
-- Pet window dynamically resizes to accommodate larger scales so the pet and bubble are not cropped.
-- Drag-to-resize handle on the pet window allows interactive scale adjustment; changes are saved to preferences.
-- Explicit agent pet windows use the saved preference scale.
+- Refreshes default familiar content only when scale changes.
+- Familiar renderer derives shell size, sprite transform, installed-card size, and bubble offset from the selected scale.
+- Familiar window dynamically resizes to accommodate larger scales so the familiar and bubble are not cropped.
+- Drag-to-resize handle on the familiar window allows interactive scale adjustment; changes are saved to preferences.
+- Explicit agent familiar windows use the saved preference scale.
 
 Validation passed:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
diff --git a/docs/phases/phase-15-codex-pet-import.md b/docs/phases/phase-15-codex-pet-import.md
index df2f8d10..5ad3db22 100644
--- a/docs/phases/phase-15-codex-pet-import.md
+++ b/docs/phases/phase-15-codex-pet-import.md
@@ -1,44 +1,44 @@
-# Phase 15 — Codex Pet Import
+# Phase 15 — Codex Familiar Import
 
 ## Goal
 
-Let users import locally generated Codex pets from `~/.codex/pets/` directly in Pet Manager.
+Let users import locally generated Codex familiars from `~/.codex/familiars/` directly in Familiar Manager.
 
 ## Implemented
 
-- Added a **Codex** tab next to All and Installed in Pet Manager.
-- Added main-process discovery for `~/.codex/pets/<pet-id>/pet.json` and `spritesheet.webp`.
-- Codex pets are shown with local `data:image/webp` previews so the Pet Manager CSP does not need broader local-file image access.
-- Local previews are only inlined when the raw spritesheet bytes are small enough and the Codex tab remains under a total raw preview-byte cap; oversized valid pets can still be imported but show an empty preview.
-- Added Import action for Codex-only pets.
-- If a pet exists in both the catalog and Codex, the Pet Manager uses Codex metadata/preview and Import uses the local Codex copy.
-- Import copies only validated `pet.json` metadata and `spritesheet.webp` into OpenPets user data under the normal installed-pets directory.
-- Imported Codex pets are recorded in app state with `source.kind = "codex"`.
-- Missing `~/.codex/pets/` is treated as an empty Codex tab, not an error.
-- Discovery scans at most 100 sorted Codex pet directories per render.
+- Added a **Codex** tab next to All and Installed in Familiar Manager.
+- Added main-process discovery for `~/.codex/familiars/<familiar-id>/familiar.json` and `spritesheet.webp`.
+- Codex familiars are shown with local `data:image/webp` previews so the Familiar Manager CSP does not need broader local-file image access.
+- Local previews are only inlined when the raw spritesheet bytes are small enough and the Codex tab remains under a total raw preview-byte cap; oversized valid familiars can still be imported but show an empty preview.
+- Added Import action for Codex-only familiars.
+- If a familiar exists in both the catalog and Codex, the Familiar Manager uses Codex metadata/preview and Import uses the local Codex copy.
+- Import copies only validated `familiar.json` metadata and `spritesheet.webp` into FamiliarOS user data under the normal installed-familiars directory.
+- Imported Codex familiars are recorded in app state with `source.kind = "codex"`.
+- Missing `~/.codex/familiars/` is treated as an empty Codex tab, not an error.
+- Discovery scans at most 100 sorted Codex familiar directories per render.
 
 ## Safety Rules
 
-- Pet id must be safe and match the folder name.
+- Familiar id must be safe and match the folder name.
 - `spritesheetPath` must be exactly `spritesheet.webp`.
-- `pet.json` and `spritesheet.webp` have size limits.
-- The Codex root, source path, and pet files must stay inside `~/.codex/pets/`; root, pet directories, and files cannot be symlinks.
-- Destination path must stay inside OpenPets pets storage.
-- Import writes fresh regular files into OpenPets storage rather than copying links.
-- Existing installed pets cannot be imported again.
-- Import shares the same per-pet operation lock as catalog install/remove/default changes.
+- `familiar.json` and `spritesheet.webp` have size limits.
+- The Codex root, source path, and familiar files must stay inside `~/.codex/familiars/`; root, familiar directories, and files cannot be symlinks.
+- Destination path must stay inside FamiliarOS familiars storage.
+- Import writes fresh regular files into FamiliarOS storage rather than copying links.
+- Existing installed familiars cannot be imported again.
+- Import shares the same per-familiar operation lock as catalog install/remove/default changes.
 
 ## Automated Checks
 
-- `tests/codex-pets.test.ts` covers Codex metadata validation and preview-size gating.
+- `tests/codex-familiars.test.ts` covers Codex metadata validation and preview-size gating.
 - Desktop test script includes the Codex check.
 
 ## Manual Verification
 
-1. Ensure local pets exist under `~/.codex/pets/<id>/pet.json` and `spritesheet.webp`.
-2. Open Pet Manager.
+1. Ensure local familiars exist under `~/.codex/familiars/<id>/familiar.json` and `spritesheet.webp`.
+2. Open Familiar Manager.
 3. Confirm the Codex tab appears.
-4. Confirm Codex pets show previews and descriptions.
-5. Import a Codex pet.
+4. Confirm Codex familiars show previews and descriptions.
+5. Import a Codex familiar.
 6. Confirm it moves to Installed and can be set as default.
-7. Confirm removing it deletes the OpenPets copy, not the original Codex folder.
+7. Confirm removing it deletes the FamiliarOS copy, not the original Codex folder.
diff --git a/docs/phases/phase-16-claude-hook-pet-routing.md b/docs/phases/phase-16-claude-hook-pet-routing.md
index a3660a2e..01dc68c7 100644
--- a/docs/phases/phase-16-claude-hook-pet-routing.md
+++ b/docs/phases/phase-16-claude-hook-pet-routing.md
@@ -1,28 +1,28 @@
-# Phase 16 — Claude Hook Pet Routing
+# Phase 16 — Claude Hook Familiar Routing
 
 ## Goal
 
-When a Claude integration is configured with a selected pet, Claude hook speech/reactions should route to the same selected pet as the MCP server instead of always using the default desktop pet.
+When a Claude integration is configured with a selected familiar, Claude hook speech/reactions should route to the same selected familiar as the MCP server instead of always using the default desktop familiar.
 
 ## Non-goals
 
 - Per-project Claude hook installation. Current Claude hooks remain global user settings.
 - Changing MCP lease behavior.
-- Removing the default-pet fallback when no hook pet is configured.
+- Removing the default-familiar fallback when no hook familiar is configured.
 
 ## User-visible/manual outcome
 
-- Installing/updating Claude hooks from Integrations with pet `fixer` writes hook commands containing `--pet fixer`.
-- Prompt-submit hook speech appears on the fixer pet, matching the selected Claude integration pet.
-- If no selected pet is configured for hooks, hook events continue targeting the default pet.
+- Installing/updating Claude hooks from Integrations with familiar `fixer` writes hook commands containing `--familiar fixer`.
+- Prompt-submit hook speech appears on the fixer familiar, matching the selected Claude integration familiar.
+- If no selected familiar is configured for hooks, hook events continue targeting the default familiar.
 
 ## Acceptance criteria
 
-- `open-pets-claude hook --openpets-managed --pet <id>` validates `<id>` and passes it to hook handling.
-- Hook handling acquires a short OpenPets lease for the configured pet and passes that `leaseId` into `say`/`react`.
-- Integrations hook doctor/install uses the selected pet when checking/writing hooks.
+- `familiaros-claude hook --familiaros-managed --familiar <id>` validates `<id>` and passes it to hook handling.
+- Hook handling acquires a short FamiliarOS lease for the configured familiar and passes that `leaseId` into `say`/`react`.
+- Integrations hook doctor/install uses the selected familiar when checking/writing hooks.
 - Hook status text makes the target explicit.
-- Invalid hook `--pet` values are rejected at CLI boundary.
+- Invalid hook `--familiar` values are rejected at CLI boundary.
 
 ## Proposed files/directories
 
@@ -34,40 +34,40 @@ When a Claude integration is configured with a selected pet, Claude hook speech/
 
 ## Technical approach
 
-- Extend the Claude hook CLI with `--pet` parsing using the same pet-id validation as MCP setup.
-- Include `--pet <id>` in generated Claude hook commands when a selected pet exists.
-- During hook runtime, acquire a short lease for the configured pet and pass the returned lease id to the OpenPets client call.
-- Do not release hook leases immediately; rely on the existing short TTL so the explicit pet remains visible briefly after the hook event.
-- Preserve default-pet behavior when no `--pet` is present.
+- Extend the Claude hook CLI with `--familiar` parsing using the same familiar-id validation as MCP setup.
+- Include `--familiar <id>` in generated Claude hook commands when a selected familiar exists.
+- During hook runtime, acquire a short lease for the configured familiar and pass the returned lease id to the FamiliarOS client call.
+- Do not release hook leases immediately; rely on the existing short TTL so the explicit familiar remains visible briefly after the hook event.
+- Preserve default-familiar behavior when no `--familiar` is present.
 
 ## Risks and tradeoffs
 
 - Hooks are global in `~/.claude/settings.json`, so installing hooks for `fixer` makes hook events target `fixer` globally. Per-project hook routing is deferred.
-- If the selected pet is missing or broken, local IPC falls back to default pet using existing lease fallback behavior.
+- If the selected familiar is missing or broken, local IPC falls back to default familiar using existing lease fallback behavior.
 
 ## Security/privacy notes
 
-- Hook `--pet` is validated against the safe pet-id pattern before use.
+- Hook `--familiar` is validated against the safe familiar-id pattern before use.
 - Hook speech validation still rejects code, paths, URLs, and secret-like content.
 - No hook payload content is logged by default.
 
 ## Test/check plan
 
-- `pnpm --filter @open-pets/claude build`
-- `pnpm --filter @open-pets/claude test`
-- `pnpm --filter @open-pets/desktop build`
-- `pnpm --filter @open-pets/desktop test`
-- `pnpm --filter @open-pets/mcp test`
+- `pnpm --filter @familiaros/claude build`
+- `pnpm --filter @familiaros/claude test`
+- `pnpm --filter @familiaros/desktop build`
+- `pnpm --filter @familiaros/desktop test`
+- `pnpm --filter @familiaros/mcp test`
 
 ## Manual verification guide
 
 1. Open Integrations.
 2. Select `fixer` for Claude.
 3. Update/install optional Claude hooks.
-4. Confirm `~/.claude/settings.json` hook commands include `--pet fixer`.
-5. Start Claude in a project using the `--pet fixer` MCP config.
+4. Confirm `~/.claude/settings.json` hook commands include `--familiar fixer`.
+5. Start Claude in a project using the `--familiar fixer` MCP config.
 6. Submit a prompt.
-7. Confirm hook speech/reaction appears on the fixer pet, not the default pet.
+7. Confirm hook speech/reaction appears on the fixer familiar, not the default familiar.
 
 ## Oracle plan review
 
@@ -77,8 +77,8 @@ Skipped as emergency bugfix; implementation review requested immediately after t
 
 Implementation review via Oracle found no blocking issues.
 
-- Fixed: Added CLI-level regression coverage for `open-pets-claude hook --pet fixer` and invalid `--pet bad/pet`.
-- Fixed: Hook status message now states whether hook events target the selected pet or default pet.
-- Fixed: Hook CLI validates `--pet` at the boundary instead of relying only on IPC fallback.
-- Fixed: Hook action journal commands include `--pet <id>` when applicable.
-- Accepted: Hook leases are not immediately released; they rely on the existing 15s TTL to keep the explicit pet visible after hook events.
+- Fixed: Added CLI-level regression coverage for `familiaros-claude hook --familiar fixer` and invalid `--familiar bad/familiar`.
+- Fixed: Hook status message now states whether hook events target the selected familiar or default familiar.
+- Fixed: Hook CLI validates `--familiar` at the boundary instead of relying only on IPC fallback.
+- Fixed: Hook action journal commands include `--familiar <id>` when applicable.
+- Accepted: Hook leases are not immediately released; they rely on the existing 15s TTL to keep the explicit familiar visible after hook events.
diff --git a/docs/phases/phase-17-openpets-cli-project-setup.md b/docs/phases/phase-17-openpets-cli-project-setup.md
index aea1189a..99837da4 100644
--- a/docs/phases/phase-17-openpets-cli-project-setup.md
+++ b/docs/phases/phase-17-openpets-cli-project-setup.md
@@ -1,25 +1,25 @@
-# Phase 17 — OpenPets CLI Project Setup
+# Phase 17 — FamiliarOS CLI Project Setup
 
 ## Goal
 
-Add a real npm-distributed OpenPets CLI that lets users configure the current project to use a selected pet with Claude, using one simple command.
+Add a real npm-distributed FamiliarOS CLI that lets users configure the current project to use a selected familiar with Claude, using one simple command.
 
 Primary command:
 
 ```bash
-npx @open-pets/cli configure --pet fixer
+npx @familiaros/cli configure --familiar fixer
 ```
 
 This should configure both Claude MCP and Claude hooks for the current project. No extra MCP/hooks questions.
 
 ## Non-goals
 
-- App-installed `openpets` shim / Settings “Install CLI” button. Defer to a later phase.
+- App-installed `familiaros` shim / Settings “Install CLI” button. Defer to a later phase.
 - Shared/team project config by default.
 - Supporting agents other than Claude.
 - Remote/custom catalog flags.
-- `openpets install <pet-id>`; defer pet installation CLI to a later phase.
-- Exposing pet install/remove/default controls through MCP tools.
+- `familiaros install <familiar-id>`; defer familiar installation CLI to a later phase.
+- Exposing familiar install/remove/default controls through MCP tools.
 - Building a complex TUI. Keep interaction simple.
 
 ## User-visible/manual outcome
@@ -27,41 +27,41 @@ This should configure both Claude MCP and Claude hooks for the current project.
 From a project directory, users can run:
 
 ```bash
-npx @open-pets/cli configure --pet fixer
+npx @familiaros/cli configure --familiar fixer
 ```
 
 Expected result:
 
-- Claude MCP is configured locally for the current project with OpenPets `--pet fixer`.
-- Claude project-local hooks are configured with `--project-local --pet fixer`.
+- Claude MCP is configured locally for the current project with FamiliarOS `--familiar fixer`.
+- Claude project-local hooks are configured with `--project-local --familiar fixer`.
 - Starting Claude from that project makes MCP tools and hook speech/reactions target fixer.
 
 Users can also run:
 
 ```bash
-npx @open-pets/cli configure --agent claude --pet fixer --cwd /path/to/project --yes
+npx @familiaros/cli configure --agent claude --familiar fixer --cwd /path/to/project --yes
 ```
 
-If `--pet` is omitted, the CLI lists installed pets and prompts for one.
+If `--familiar` is omitted, the CLI lists installed familiars and prompts for one.
 
 ## Acceptance criteria
 
-- `packages/cli` exposes a real executable bin, `openpets`.
-- `openpets configure --pet <id>` runs non-interactively for Claude using current working directory.
+- `packages/cli` exposes a real executable bin, `familiaros`.
+- `familiaros configure --familiar <id>` runs non-interactively for Claude using current working directory.
 - `--agent claude` is accepted; unsupported agents fail clearly.
 - `--cwd <path>` targets another project directory; default is `process.cwd()`.
 - `--yes` is accepted as a compatibility/no-op flag; there is no final confirmation prompt in Phase 17.
-- If `--pet` is missing, CLI queries installed pets from the running OpenPets desktop app and prompts the user to choose.
+- If `--familiar` is missing, CLI queries installed familiars from the running FamiliarOS desktop app and prompts the user to choose.
 - CLI configures Claude MCP using local project scope, private to the current user.
 - CLI configures Claude hooks in `<project>/.claude/settings.local.json`, private to the project/user.
 - Claude MCP command is installed while spawning `claude` with `cwd` set to the resolved target project.
-- Long-lived generated Claude MCP/hook commands use a stable package command, not a temporary `npx @open-pets/cli` install path.
-- Hook commands include `--pet <id>`.
-- Existing non-OpenPets hooks in `.claude/settings.local.json` are preserved.
-- Existing OpenPets-managed hooks are replaced safely.
-- CLI fails with clear instructions if OpenPets desktop app is not running.
+- Long-lived generated Claude MCP/hook commands use a stable package command, not a temporary `npx @familiaros/cli` install path.
+- Hook commands include `--familiar <id>`.
+- Existing non-FamiliarOS hooks in `.claude/settings.local.json` are preserved.
+- Existing FamiliarOS-managed hooks are replaced safely.
+- CLI fails with clear instructions if FamiliarOS desktop app is not running.
 - CLI fails clearly if Claude Code is unavailable on `PATH`.
-- CLI validates selected pet ids and rejects unsafe values.
+- CLI validates selected familiar ids and rejects unsafe values.
 
 ## Proposed files/directories
 
@@ -79,7 +79,7 @@ If `--pet` is omitted, the CLI lists installed pets and prompts for one.
 ### CLI command shape
 
 ```bash
-openpets configure [--agent claude] [--pet <id>] [--cwd <path>] [--yes]
+familiaros configure [--agent claude] [--familiar <id>] [--cwd <path>] [--yes]
 ```
 
 Defaults:
@@ -89,12 +89,12 @@ Defaults:
 - configure both MCP and hooks
 - local/private project config
 
-### Installed pet discovery
+### Installed familiar discovery
 
 Add a narrow local IPC/client method for the user-run CLI:
 
 ```ts
-pets.list
+familiars.list
 ```
 
 Return only safe display data:
@@ -102,32 +102,32 @@ Return only safe display data:
 ```ts
 {
   ok: true,
-  pets: [
+  familiars: [
     { id, displayName, installed: true, builtIn, broken }
   ],
   defaultPetId
 }
 ```
 
-The CLI uses this to validate `--pet` and power the picker.
+The CLI uses this to validate `--familiar` and power the picker.
 
 ### Stable generated commands
 
-Do not write temp/cache paths from `npx @open-pets/cli` into Claude config. Instead make the CLI package self-contained and expose wrapper subcommands:
+Do not write temp/cache paths from `npx @familiaros/cli` into Claude config. Instead make the CLI package self-contained and expose wrapper subcommands:
 
 ```bash
-openpets mcp --pet fixer
-openpets hook --openpets-managed --project-local --pet fixer
+familiaros mcp --familiar fixer
+familiaros hook --familiaros-managed --project-local --familiar fixer
 ```
 
 Generated long-lived commands should use the package version being configured:
 
 ```bash
-npx -y @open-pets/cli@0.0.0 mcp --pet fixer
-npx -y @open-pets/cli@0.0.0 hook --openpets-managed --project-local --pet fixer
+npx -y @familiaros/cli@0.0.0 mcp --familiar fixer
+npx -y @familiaros/cli@0.0.0 hook --familiaros-managed --project-local --familiar fixer
 ```
 
-The `mcp` wrapper starts the existing OpenPets MCP server implementation. The `hook` wrapper delegates to the existing Claude hook handler.
+The `mcp` wrapper starts the existing FamiliarOS MCP server implementation. The `hook` wrapper delegates to the existing Claude hook handler.
 
 This avoids storing an absolute path into npm's temporary `npx` cache.
 
@@ -136,7 +136,7 @@ This avoids storing an absolute path into npm's temporary `npx` cache.
 Use Claude’s own CLI for local project MCP setup when available:
 
 ```bash
-claude mcp add-json openpets '<json>' --scope local
+claude mcp add-json familiaros '<json>' --scope local
 ```
 
 JSON shape:
@@ -145,7 +145,7 @@ JSON shape:
 {
   "type": "stdio",
   "command": "npx",
-  "args": ["-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"],
+  "args": ["-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"],
   "env": {}
 }
 ```
@@ -165,7 +165,7 @@ Write hooks directly to:
 Use existing `installClaudeHooks(settingsPath, commandMode, selectedPetId)` with a CLI-appropriate command mode/path if possible. If needed, add a small command builder option so the npm CLI writes hook commands that call the installed npm Claude CLI:
 
 ```bash
-npx -y @open-pets/cli@0.0.0 hook --openpets-managed --project-local --pet fixer
+npx -y @familiaros/cli@0.0.0 hook --familiaros-managed --project-local --familiar fixer
 ```
 
 Project-local hooks are private and should not require committing repo files.
@@ -175,13 +175,13 @@ Before writing hooks:
 - resolve and validate the target project directory;
 - reject symlinked `<project>/.claude` directories;
 - ensure `<project>/.claude/settings.local.json` resolves inside the target project;
-- preserve existing non-OpenPets settings and hooks.
+- preserve existing non-FamiliarOS settings and hooks.
 
 ### Interactive picker
 
-If `--pet` is missing:
+If `--familiar` is missing:
 
-- list usable installed non-broken pets, including built-in unless explicitly disallowed later
+- list usable installed non-broken familiars, including built-in unless explicitly disallowed later
 - use a simple stdin/stdout numbered picker
 - no extra MCP/hooks questions
 
@@ -189,70 +189,70 @@ If `--pet` is missing:
 
 Before writing anything:
 
-- verify OpenPets desktop is reachable and supports `pets.list`;
-- verify the selected pet is installed and usable;
+- verify FamiliarOS desktop is reachable and supports `familiars.list`;
+- verify the selected familiar is installed and usable;
 - verify Claude Code is available on PATH;
 - verify target project path and hook path safety;
 - build the version-pinned wrapper commands.
 
 If any preflight fails, do not write MCP or hooks.
 
-If a local Claude MCP entry named `openpets` already exists, `configure` should replace it by invoking Claude's add/update flow for the same server name when supported by `claude mcp add-json`; if Claude refuses, fail clearly before writing hooks.
+If a local Claude MCP entry named `familiaros` already exists, `configure` should replace it by invoking Claude's add/update flow for the same server name when supported by `claude mcp add-json`; if Claude refuses, fail clearly before writing hooks.
 
 ## Risks and tradeoffs
 
-- Adding public local IPC pet listing is a new surface. Keep it read-only and minimal.
+- Adding public local IPC familiar listing is a new surface. Keep it read-only and minimal.
 - Invoking `claude` CLI can fail if Claude Code is unavailable on PATH. CLI should print the exact failure and next step.
 - Project-local hooks and Claude local MCP scope are stored in different places by Claude design.
 - Npm `npx` hook commands may run package resolution at hook time. This is acceptable for npm-first CLI but may be slower than future app-installed shim.
-- Generated commands are version-pinned for stability; users may need to rerun configure after upgrading OpenPets CLI.
+- Generated commands are version-pinned for stability; users may need to rerun configure after upgrading FamiliarOS CLI.
 
 ## Security/privacy notes
 
 - Do not expose filesystem install/remove/default mutation over MCP.
-- Validate project path and pet id before writes.
+- Validate project path and familiar id before writes.
 - Only write inside `<project>/.claude/settings.local.json` for hooks.
 - Reject unsafe project-local hook paths, including symlinked `.claude` directories.
-- Preserve non-OpenPets settings/hooks.
+- Preserve non-FamiliarOS settings/hooks.
 - Do not log prompt/hook payloads or secrets.
 
 ## Test/check plan
 
 - Unit/contract check for CLI arg parsing and generated Claude config.
-- Contract check that existing hooks are preserved and OpenPets-managed hooks are replaced.
+- Contract check that existing hooks are preserved and FamiliarOS-managed hooks are replaced.
 - Mocked `claude` binary check for exact `add-json` argv, `--scope local`, JSON shape, and spawned cwd.
-- Noninteractive `--pet` check; missing `--pet` non-TTY failure/picker behavior.
+- Noninteractive `--familiar` check; missing `--familiar` non-TTY failure/picker behavior.
 - Generated command version pinning check.
 - Project hook writer rejects symlinked `.claude` / unsafe cwd.
-- IPC protocol check for `pets.list` validation/result shape.
-- MCP public tool list remains exactly `openpets_status`, `openpets_say`, `openpets_react`.
+- IPC protocol check for `familiars.list` validation/result shape.
+- MCP public tool list remains exactly `familiaros_status`, `familiaros_say`, `familiaros_react`.
 - Package build/test:
 
 ```bash
-pnpm --filter @open-pets/cli build
-pnpm --filter @open-pets/cli test
-pnpm --filter @open-pets/client test
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
-pnpm --filter @open-pets/claude test
+pnpm --filter @familiaros/cli build
+pnpm --filter @familiaros/cli test
+pnpm --filter @familiaros/client test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
+pnpm --filter @familiaros/claude test
 ```
 
 ## Manual verification guide
 
-1. Run OpenPets desktop.
+1. Run FamiliarOS desktop.
 2. In a test project, run:
 
    ```bash
-   npx @open-pets/cli configure --pet fixer
+   npx @familiaros/cli configure --familiar fixer
    ```
 
 3. Confirm command succeeds without MCP/hooks prompts.
-4. Confirm Claude local MCP entry for the project targets `--pet fixer`.
-5. Confirm `<project>/.claude/settings.local.json` contains OpenPets hooks with `--pet fixer`.
+4. Confirm Claude local MCP entry for the project targets `--familiar fixer`.
+5. Confirm `<project>/.claude/settings.local.json` contains FamiliarOS hooks with `--familiar fixer`.
 6. Start Claude in that project.
-7. Confirm `/mcp` shows OpenPets connected.
+7. Confirm `/mcp` shows FamiliarOS connected.
 8. Submit a prompt and confirm hook bubble appears on fixer.
-9. Call `openpets_status` and confirm actual target is fixer.
+9. Call `familiaros_status` and confirm actual target is fixer.
 
 ## Oracle plan review
 
@@ -260,26 +260,26 @@ Oracle reviewed the Phase 17 plan and recommended revision before implementation
 
 ## Oracle feedback disposition
 
-- Fixed: Changed long-lived generated commands from temporary absolute package paths to self-contained, version-pinned `npx -y @open-pets/cli@<version> mcp/hook ...` wrappers.
+- Fixed: Changed long-lived generated commands from temporary absolute package paths to self-contained, version-pinned `npx -y @familiaros/cli@<version> mcp/hook ...` wrappers.
 - Fixed: Removed final confirmation prompt from Phase 17; `--yes` is accepted as no-op compatibility only.
 - Fixed: Spec now requires spawning `claude mcp add-json` with `cwd` set to the target project.
 - Fixed: Added project-local hook path safety requirements for symlinked `.claude` and inside-project resolution.
-- Fixed: Deferred `openpets install <pet-id>` out of Phase 17 to avoid expanding mutation/security scope.
+- Fixed: Deferred `familiaros install <familiar-id>` out of Phase 17 to avoid expanding mutation/security scope.
 - Fixed: Added preflight/idempotency requirements before writing MCP/hooks.
 - Fixed: Added version pinning, mocked Claude CLI tests, project hook safety tests, noninteractive CLI tests, and MCP public tool-list regression to test plan.
 
 ## Implementation notes
 
-- Added `openpets` bin in `@open-pets/cli`.
+- Added `familiaros` bin in `@familiaros/cli`.
 - Added `configure`, `mcp`, and `hook` CLI command paths.
-- Added read-only `pets.list` local IPC/client method.
-- `configure --pet <id>` writes config without requiring the desktop app to be running; omitting `--pet` still queries the running desktop app for interactive pet selection.
-- Claude MCP config is written through `claude mcp add-json openpets <json> --scope local` with `cwd` set to the target project.
+- Added read-only `familiars.list` local IPC/client method.
+- `configure --familiar <id>` writes config without requiring the desktop app to be running; omitting `--familiar` still queries the running desktop app for interactive familiar selection.
+- Claude MCP config is written through `claude mcp add-json familiaros <json> --scope local` with `cwd` set to the target project.
 - Project-local hooks are prepared before MCP mutation and written only after MCP configuration succeeds.
-- Generated MCP/hook commands use version-pinned `npx -y @open-pets/cli@<version>` wrappers.
+- Generated MCP/hook commands use version-pinned `npx -y @familiaros/cli@<version>` wrappers.
 - CLI-generated npm hook timeout is `10` seconds to tolerate `npx` startup.
-- Project-local hooks include the internal `--project-local` marker so global OpenPets hooks can detect project-specific OpenPets hooks and skip themselves, preventing duplicate default/project pet reactions.
-- `--force` / `--replace` removes any existing local Claude MCP `openpets` entry before adding the new one.
+- Project-local hooks include the internal `--project-local` marker so global FamiliarOS hooks can detect project-specific FamiliarOS hooks and skip themselves, preventing duplicate default/project familiar reactions.
+- `--force` / `--replace` removes any existing local Claude MCP `familiaros` entry before adding the new one.
 - Hidden maintainer flag `--local-dev` writes local `node <repo>/packages/cli/dist/index.js ...` commands for pre-release testing; it is intentionally omitted from user help.
 
 ## Oracle implementation review
@@ -289,10 +289,10 @@ Oracle approved the implementation after one revision pass.
 - Fixed: Avoid partial config by parsing/merging hook settings before MCP mutation and writing hooks only after MCP succeeds.
 - Fixed: Reject symlinked `.claude`, non-file `settings.local.json`, malformed hook event arrays, and unsafe project-local hook paths.
 - Fixed: Added `publishConfig.access = public` for npm-distributed packages.
-- Fixed: Added `pets.list` response shape validation.
+- Fixed: Added `familiars.list` response shape validation.
 - Fixed: Added mocked Claude CLI cwd/argv/JSON test.
 - Fixed: Increased CLI-generated hook timeout and added MCP wrapper signal forwarding.
 - Fixed: Added global-hook duplicate prevention using explicit project-local hook marker detection.
 - Fixed: Hardened project-local hook detection to reject symlinks/non-files, cap settings size, and ensure the settings path stays under the Claude project dir.
-- Fixed: Hook CLI boundaries reject `--pet` with a missing value.
-- Accepted: Generated commands are pinned to the package version; release must publish `@open-pets/cli`, `@open-pets/client`, `@open-pets/claude`, and `@open-pets/mcp` at the same version.
+- Fixed: Hook CLI boundaries reject `--familiar` with a missing value.
+- Accepted: Generated commands are pinned to the package version; release must publish `@familiaros/cli`, `@familiaros/client`, `@familiaros/claude`, and `@familiaros/mcp` at the same version.
diff --git a/docs/phases/phase-18-reaction-sprite-animation-mapping.md b/docs/phases/phase-18-reaction-sprite-animation-mapping.md
index e1f82359..8140bd6b 100644
--- a/docs/phases/phase-18-reaction-sprite-animation-mapping.md
+++ b/docs/phases/phase-18-reaction-sprite-animation-mapping.md
@@ -2,17 +2,17 @@
 
 ## Goal
 
-Make OpenPets reactions actually drive the pet spritesheet animation state, not just temporary reaction bubble text.
+Make FamiliarOS reactions actually drive the familiar spritesheet animation state, not just temporary reaction bubble text.
 
-OpenPets currently uses the universal Codex/OpenPets spritesheet layout for `idle`, `run-right`, and `run-left` only. The missing piece is mapping **all** universal spritesheet rows to reachable reaction/emotion states so no available Codex animation row is unused.
+FamiliarOS currently uses the universal Codex/FamiliarOS spritesheet layout for `idle`, `run-right`, and `run-left` only. The missing piece is mapping **all** universal spritesheet rows to reachable reaction/emotion states so no available Codex animation row is unused.
 
-This phase should make hooks like `thinking`, `editing`, `testing`, `waiting`, `success`, `error`, and `notification/attention` visibly animate the pet using the correct spritesheet rows for all built-in, installed catalog, and imported Codex pets that use the shared spritesheet format.
+This phase should make hooks like `thinking`, `editing`, `testing`, `waiting`, `success`, `error`, and `notification/attention` visibly animate the familiar using the correct spritesheet rows for all built-in, installed catalog, and imported Codex familiars that use the shared spritesheet format.
 
 ## Non-goals
 
 - No new sprite art generation.
 - No remote runtime art fetch.
-- No broad pet format redesign.
+- No broad familiar format redesign.
 - No new public MCP tools.
 - No broad agent hook redesign. A narrow hook/reaction adjustment is allowed if needed to make every universal spritesheet row reachable.
 - No physics/drag architecture rewrite beyond preserving existing drag left/right behavior.
@@ -20,7 +20,7 @@ This phase should make hooks like `thinking`, `editing`, `testing`, `waiting`, `
 
 ## User-visible/manual outcome
 
-When Claude or MCP sends a reaction, the pet visibly changes animation row:
+When Claude or MCP sends a reaction, the familiar visibly changes animation row:
 
 - prompt/thinking shows the thinking/review animation,
 - edit/write activity shows an active work animation,
@@ -39,7 +39,7 @@ Speech bubbles still work, but they are no longer the only visible feedback.
   - 1536×1872 WebP,
   - 8 columns × 9 rows,
   - 192×208 frames,
-  - rows matching the Codex/OpenPets state layout below.
+  - rows matching the Codex/FamiliarOS state layout below.
 - The desktop renderer supports these universal rows:
 
   | Universal row | Codex state | Frames | Duration | Intended use |
@@ -72,7 +72,7 @@ Speech bubbles still work, but they are no longer the only visible feedback.
   - add `waving` so row 3 is directly usable,
   - keep `warning` out of this phase because it maps to `failed` and does not unlock a new row,
   - do not add `sleeping` in this phase because the universal sheet has no unique sleeping row and v1 maps it to `idle`.
-- Current and new OpenPets reactions map to universal spritesheet states:
+- Current and new FamiliarOS reactions map to universal spritesheet states:
 
   | Reaction | Spritesheet state |
   | --- | --- |
@@ -104,14 +104,14 @@ Speech bubbles still work, but they are no longer the only visible feedback.
 - Long-running states (`idle`, `waiting`, `running`, `review`, `running-left`, `running-right`) keep looping while active.
 - Hook speech still displays safe short text, but the paired hook reaction controls the animation row.
 - Built-in/prefilled speech text must use consistent sentence-style capitalization. The first letter should be uppercase, and the phrase should read as a short proper sentence/status, not a mix of lowercase/title-case styles.
-- All installed pets, imported Codex pets, and the built-in default pet use the same universal mapping.
-- If an installed pet is missing or invalid, existing broken/fallback behavior remains unchanged.
+- All installed familiars, imported Codex familiars, and the built-in default familiar use the same universal mapping.
+- If an installed familiar is missing or invalid, existing broken/fallback behavior remains unchanged.
 - `prefers-reduced-motion` still disables sprite animation loops where practical.
 - Tests/contract checks cover:
   - universal row constants,
-  - exhaustive `reactionToSpriteState satisfies Record<OpenPetsReaction, UniversalSpriteState>` mapping,
+  - exhaustive `reactionToSpriteState satisfies Record<FamiliarOSReaction, UniversalSpriteState>` mapping,
   - every universal row has at least one reachable trigger,
-  - `waving` is accepted by desktop IPC, the client protocol, and MCP `openpets_react`,
+  - `waving` is accepted by desktop IPC, the client protocol, and MCP `familiaros_react`,
   - Claude `Notification` maps to `waving`,
   - built-in hook speech pools use consistent sentence-style capitalization, with every phrase matching at least `^[A-Z]`,
   - derived universal spritesheet dimensions equal `frameWidth * columns = 1536` and `frameHeight * rows = 1872`,
@@ -122,17 +122,17 @@ Speech bubbles still work, but they are no longer the only visible feedback.
 
 ## Proposed files/directories
 
-- `apps/desktop/src/pet-window.ts`
+- `apps/desktop/src/familiar-window.ts`
   - Add universal spritesheet state constants for all nine rows.
   - Add reaction-to-sprite-state mapping.
   - Render CSS selectors for reaction animation states, not only motion states.
   - Preserve drag left/right motion publisher behavior.
-- `apps/desktop/pet-preload.cjs`
+- `apps/desktop/familiar-preload.cjs`
   - If needed, extend the existing narrow bridge to handle reaction state separately from drag motion state.
-- `apps/desktop/src/default-pet-controller.ts`
+- `apps/desktop/src/default-familiar-controller.ts`
   - Ensure transient reaction state survives refresh/reload and clears after `transientDisplayMs`.
-- `apps/desktop/src/agent-pet-controller.ts`
-  - Same for explicit/agent pet windows.
+- `apps/desktop/src/agent-familiar-controller.ts`
+  - Same for explicit/agent familiar windows.
 - `apps/desktop/src/check-packaging-contract.ts` or a new focused check file
   - Add mapping/contract assertions and wire the focused check into `apps/desktop/package.json` `test` if new.
 - `packages/client/src/protocol.ts` and `apps/desktop/src/local-ipc-protocol.ts`
@@ -151,21 +151,21 @@ Speech bubbles still work, but they are no longer the only visible feedback.
 ## Technical approach
 
 1. **Make the spritesheet contract explicit in code.**
-   - Replace the current partial `defaultPetSprite.states` with a universal constant matching the Codex/OpenPets v1 mapping.
+   - Replace the current partial `defaultPetSprite.states` with a universal constant matching the Codex/FamiliarOS v1 mapping.
    - Use clear names: `idle`, `running-right`, `running-left`, `waving`, `jumping`, `failed`, `waiting`, `running`, `review`.
    - Keep frame sizes/columns/rows unchanged.
-   - This phase assumes all installed catalog/Codex pets are known-good universal-format spritesheets; it does **not** add WebP dimension parsing/validation. Future arbitrary pet formats should add strict metadata/dimension validation in a separate phase.
+   - This phase assumes all installed catalog/Codex familiars are known-good universal-format spritesheets; it does **not** add WebP dimension parsing/validation. Future arbitrary familiar formats should add strict metadata/dimension validation in a separate phase.
 
 2. **Separate sprite state from bubble text.**
    - `PetTransientDisplay` already has `reaction?: string` and `message?: string`.
-   - Narrow `PetTransientDisplay.reaction` to `OpenPetsReaction` if practical; otherwise validate/fallback unknown strings to `idle` before mapping.
+   - Narrow `PetTransientDisplay.reaction` to `FamiliarOSReaction` if practical; otherwise validate/fallback unknown strings to `idle` before mapping.
    - Continue showing explicit `message` text when provided.
    - For reaction-only events, show a stable randomized short status line from a dedicated reaction message pool instead of the raw lowercase reaction id.
    - Additionally derive a sprite state from `reaction`.
    - If no reaction is active, sprite state is `idle` unless drag motion overrides it.
 
 3. **Make all rows reachable.**
-   - Add `waving` as an allowed reaction so row 3 is available through `openpets_react` and hook notifications.
+   - Add `waving` as an allowed reaction so row 3 is available through `familiaros_react` and hook notifications.
    - Remap Claude `Notification` from `waiting` to `waving`, document it in `docs/mapping.md`, and update Claude hook tests.
    - Do not add fake use of `sleeping`; it has no unique universal row.
    - Do not add `warning`; it does not unlock a new sprite row.
@@ -182,36 +182,36 @@ Speech bubbles still work, but they are no longer the only visible feedback.
      <html data-reaction-state="review" data-motion-state="idle">
      ```
 
-   - Prefer keeping `pet-preload.cjs` motion-only. Initialize reaction state in generated HTML with `data-reaction-state` or CSS variables.
+   - Prefer keeping `familiar-preload.cjs` motion-only. Initialize reaction state in generated HTML with `data-reaction-state` or CSS variables.
    - CSS chooses drag state when `data-motion-state` is `run-left`/`run-right`; otherwise it uses reaction state.
    - If preload must handle reaction state, it must whitelist valid universal sprite states and ignore anything else.
 
 6. **Preserve existing drag behavior.**
    - Keep main-process movement detection because `-webkit-app-region: drag` makes renderer pointer events unreliable.
-   - Do not regress the previous fix where explicit pets animate while dragged.
+   - Do not regress the previous fix where explicit familiars animate while dragged.
    - Drag should temporarily override reaction animation, then settle back to reaction state until the transient display clears.
 
 7. **Keep transient lifetime unchanged.**
    - Reaction/message display still clears after 4 seconds.
-   - When it clears, animation returns to idle unless the pet is being dragged.
+   - When it clears, animation returns to idle unless the familiar is being dragged.
 
-8. **Use universal mapping for every pet path.**
-   - Built-in fallback spritesheet and installed pet spritesheets use the same renderer code path or same generated CSS rules.
-   - Codex-imported pets are already installed as `spritesheet.webp`; no separate Codex code path should be required.
+8. **Use universal mapping for every familiar path.**
+   - Built-in fallback spritesheet and installed familiar spritesheets use the same renderer code path or same generated CSS rules.
+   - Codex-imported familiars are already installed as `spritesheet.webp`; no separate Codex code path should be required.
 
 9. **Update docs and tests.**
    - Update `docs/mapping.md` so it reflects the new truth.
    - Add a contract check that would fail if reactions remain bubble-only.
-   - Add concrete checks against the generated CSS/source so built-in and installed pet paths cannot drift.
+   - Add concrete checks against the generated CSS/source so built-in and installed familiar paths cannot drift.
 
 ## Risks and tradeoffs
 
-- The universal mapping assumes all current catalog/Codex pets share the Codex/OpenPets 8×9 layout. This is a product decision for now; arbitrary future pet formats need metadata and validation in a later phase.
+- The universal mapping assumes all current catalog/Codex familiars share the Codex/FamiliarOS 8×9 layout. This is a product decision for now; arbitrary future familiar formats need metadata and validation in a later phase.
 - Because this phase does not parse WebP dimensions, a malformed manually-installed spritesheet can still render incorrectly; existing missing/oversized-file protections remain the safety boundary.
 - `testing -> waiting` is imperfect but follows the existing v1 universal mapping. We can later add distinct test art only if the spritesheet contract changes.
 - Success/error animations are temporary and will clear after 4 seconds. This is consistent with current transient display behavior, but if users expect success/error to persist longer, that should be a separate product decision.
 - CSS selector precedence between drag state and reaction state must be simple and tested to avoid subtle bugs.
-- Reloading pet HTML to change transient display is simple but can restart sprite animation. That is acceptable for this phase unless visual flicker is severe.
+- Reloading familiar HTML to change transient display is simple but can restart sprite animation. That is acceptable for this phase unless visual flicker is severe.
 
 ## Security/privacy notes
 
@@ -219,17 +219,17 @@ Speech bubbles still work, but they are no longer the only visible feedback.
 - Message safety rules remain unchanged.
 - Renderer remains sandboxed/context-isolated with strict CSP.
 - No remote script or image fetch is added.
-- Installed pet file validation remains unchanged; this phase only changes how already-installed spritesheets are animated.
+- Installed familiar file validation remains unchanged; this phase only changes how already-installed spritesheets are animated.
 
 ## Test/check plan
 
 Run focused checks during implementation:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
-pnpm --filter @open-pets/claude test
-pnpm --filter @open-pets/mcp test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
+pnpm --filter @familiaros/claude test
+pnpm --filter @familiaros/mcp test
 ```
 
 If shared reaction constants move or are added to a shared package, also run affected package build/tests.
@@ -237,8 +237,8 @@ If shared reaction constants move or are added to a shared package, also run aff
 Before implementation review, run at least:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 ```
 
 ## Manual verification guide
@@ -246,8 +246,8 @@ pnpm --filter @open-pets/desktop test
 After implementation:
 
 1. Run `pnpm dev:desktop`.
-2. Show the default pet.
-3. Trigger each MCP reaction and confirm animation row changes visibly. Use available smoke commands if present, for example `pnpm --filter @open-pets/client smoke:react thinking`; otherwise trigger through Claude MCP tools:
+2. Show the default familiar.
+3. Trigger each MCP reaction and confirm animation row changes visibly. Use available smoke commands if present, for example `pnpm --filter @familiaros/client smoke:react thinking`; otherwise trigger through Claude MCP tools:
    - `thinking` -> review/thinking row,
    - `working` -> active running/work row,
    - `editing` -> active running/work row,
@@ -258,11 +258,11 @@ After implementation:
    - `success` -> jumping row,
    - `error` -> failed row,
    - `celebrating` -> jumping row.
-4. Trigger Claude `Notification`; confirm the pet waves on both default and project/agent pets, and confirm any generated text is properly capitalized.
-5. Trigger `openpets_say` with both a message and reaction; confirm bubble shows the message while sprite uses the reaction animation. Also trigger message-only speech and confirm the bubble appears while the sprite stays idle.
-6. Drag the pet left/right while a reaction is active; confirm drag overrides to `running-left`/`running-right`, then returns to the active reaction until it clears.
-7. Set an installed/Codex pet as default and repeat representative reactions (`thinking`, `success`, `error`, `waving`).
-8. Configure a project pet and confirm explicit/non-default pet reactions animate too.
+4. Trigger Claude `Notification`; confirm the familiar waves on both default and project/agent familiars, and confirm any generated text is properly capitalized.
+5. Trigger `familiaros_say` with both a message and reaction; confirm bubble shows the message while sprite uses the reaction animation. Also trigger message-only speech and confirm the bubble appears while the sprite stays idle.
+6. Drag the familiar left/right while a reaction is active; confirm drag overrides to `running-left`/`running-right`, then returns to the active reaction until it clears.
+7. Set an installed/Codex familiar as default and repeat representative reactions (`thinking`, `success`, `error`, `waving`).
+8. Configure a project familiar and confirm explicit/non-default familiar reactions animate too.
 9. Verify reactions clear back to idle after about 4 seconds.
 10. Review all built-in/hook-generated speech phrases and confirm they start with uppercase letters and use a consistent short sentence/status style.
 
@@ -296,7 +296,7 @@ Nice-to-have feedback:
 
 - Factor universal constants/CSS generation to avoid drift.
 - Add concrete smoke-command manual verification examples.
-- Consider future WebP dimension checks if non-universal pets become possible.
+- Consider future WebP dimension checks if non-universal familiars become possible.
 - Document `waving` as defined but currently unused unless deliberately added.
 
 ## Oracle feedback disposition
@@ -304,7 +304,7 @@ Nice-to-have feedback:
 Fixed:
 
 - Added explicit naming guidance: motion IPC remains `run-left`/`run-right`, mapped to universal rows `running-left`/`running-right`.
-- Added exhaustive typed mapping acceptance criterion using `Record<OpenPetsReaction, UniversalSpriteState>`.
+- Added exhaustive typed mapping acceptance criterion using `Record<FamiliarOSReaction, UniversalSpriteState>`.
 - Clarified validation scope: no WebP dimension parsing in this phase; known-good universal catalog/Codex format is assumed.
 - Required concrete desktop contract check wiring if a new check file is added.
 - Required generated CSS/source checks for both `.sprite` and `.installed-sprite`.
@@ -323,7 +323,7 @@ Accepted:
 - Implementation should factor constants/CSS generation where practical to avoid drift.
 - Manual verification now includes concrete `smoke:react` examples where available.
 - Future WebP dimension validation remains deferred.
-- `waving` is now explicitly used by `Notification` and by public `openpets_react`.
+- `waving` is now explicitly used by `Notification` and by public `familiaros_react`.
 
 ## Oracle implementation review
 
@@ -336,7 +336,7 @@ Blocking feedback:
 Non-blocking feedback:
 
 - Fix docs wording that still implied `waiting` covers notification.
-- Clarify `openpets_react` docs so it says reactions drive animation, not only bubbles.
+- Clarify `familiaros_react` docs so it says reactions drive animation, not only bubbles.
 - Add base `background-position: 0 var(--sprite-row-y)` so reduced-motion still shows the selected reaction row instead of always showing idle.
 
 Verdict: safe to commit after including docs and fixing the small docs/reduced-motion issues.
@@ -347,6 +347,6 @@ Fixed:
 
 - `docs/mapping.md` is part of this phase output and must be committed.
 - Updated `waiting` wording in `docs/mapping.md` so notification maps to `waving` only.
-- Updated `openpets_react` wording to say it drives animation and may show reaction text.
+- Updated `familiaros_react` wording to say it drives animation and may show reaction text.
 - Added base sprite `background-position` for built-in and installed sprite elements.
 - Reran desktop build/test after fixes.
diff --git a/docs/phases/phase-19-opencode-integration.md b/docs/phases/phase-19-opencode-integration.md
index 5d609771..491c70f2 100644
--- a/docs/phases/phase-19-opencode-integration.md
+++ b/docs/phases/phase-19-opencode-integration.md
@@ -2,14 +2,14 @@
 
 ## Goal
 
-Add full OpenPets support for OpenCode with parity to the current Claude Code integration, without over-splitting implementation work.
+Add full FamiliarOS support for OpenCode with parity to the current Claude Code integration, without over-splitting implementation work.
 
 Target parity means:
 
-- OpenPets MCP tools available in OpenCode.
-- OpenPets instructions installed into OpenCode instructions.
-- OpenCode activity drives pet reactions and short safe speech.
-- CLI project setup can route a selected pet to a project.
+- FamiliarOS MCP tools available in OpenCode.
+- FamiliarOS instructions installed into OpenCode instructions.
+- OpenCode activity drives familiar reactions and short safe speech.
+- CLI project setup can route a selected familiar to a project.
 - Desktop Integrations can detect/configure/remove/doctor OpenCode setup.
 
 ## Current Claude integration to mirror
@@ -17,14 +17,14 @@ Target parity means:
 Claude support has four layers:
 
 1. **MCP tools**
-   - Public tools stay exactly `openpets_status`, `openpets_say`, `openpets_react`.
+   - Public tools stay exactly `familiaros_status`, `familiaros_say`, `familiaros_react`.
    - MCP server: `packages/mcp/src/server.ts`.
-   - CLI wrapper: `packages/cli/src/index.ts` → `openpets mcp --pet <id>`.
+   - CLI wrapper: `packages/cli/src/index.ts` → `familiaros mcp --familiar <id>`.
    - Claude command/config helpers: `packages/claude/src/claude-code.ts`.
    - Desktop setup: `apps/desktop/src/agent-setup.ts`.
 
 2. **Instructions/memory**
-   - Claude writes `~/.claude/openpets.md` and imports it from `~/.claude/CLAUDE.md`.
+   - Claude writes `~/.claude/familiaros.md` and imports it from `~/.claude/CLAUDE.md`.
    - Implementation: `apps/desktop/src/claude-memory.ts`.
    - Safety pattern: managed markers, preserve user content, private file modes, no symlink writes, max file size.
 
@@ -42,8 +42,8 @@ Claude support has four layers:
      - `StopFailure` → `error` + throttled speech.
 
 4. **CLI project setup**
-   - `openpets configure --agent claude --pet <id> --cwd <project>` configures project-local Claude MCP and hooks.
-   - Explicit `--pet` works without desktop app; omitted `--pet` uses local IPC `pets.list`.
+   - `familiaros configure --agent claude --familiar <id> --cwd <project>` configures project-local Claude MCP and hooks.
+   - Explicit `--familiar` works without desktop app; omitted `--familiar` uses local IPC `familiars.list`.
 
 ## OpenCode source findings
 
@@ -53,7 +53,7 @@ OpenCode has enough native extension surface for parity, but OpenCode support sh
   - OpenCode config has `mcp` at `v1/opencode/packages/opencode/src/config/config.ts` lines 220-229.
   - Local MCP shape is in `v1/opencode/packages/opencode/src/config/mcp.ts` lines 5-19:
     - `{ type: "local", command: string[], environment?, enabled?, timeout? }`.
-  - `opencode mcp add` is interactive, so automated OpenPets setup should directly edit JSON/JSONC config with the same shape.
+  - `opencode mcp add` is interactive, so automated FamiliarOS setup should directly edit JSON/JSONC config with the same shape.
 
 - **Config locations**
   - Global config uses OpenCode global config dir, with `OPENCODE_CONFIG_DIR` override support.
@@ -69,15 +69,15 @@ OpenCode has enough native extension surface for parity, but OpenCode support sh
   - OpenCode plugin hook surface: `v1/opencode/packages/plugin/src/index.ts` lines 222-333.
   - Useful hooks include `event`, `chat.message`, `tool.execute.before`, `tool.execute.after`, `command.execute.before`.
   - Do **not** rely on `permission.ask`; permissions should be handled through plugin `event` for bus event `permission.asked`.
-  - OpenCode awaits plugin hooks directly, so plugin hooks must return immediately and run OpenPets calls fire-and-forget.
+  - OpenCode awaits plugin hooks directly, so plugin hooks must return immediately and run FamiliarOS calls fire-and-forget.
 
 ## Non-goals
 
 - Do not fork or modify `v1/opencode/`.
 - Do not add new public MCP tools.
-- Do not expose pet install/remove/default controls through MCP or OpenCode plugin tools.
+- Do not expose familiar install/remove/default controls through MCP or OpenCode plugin tools.
 - Do not add a network listener or external SSE watcher unless plugin-based events prove insufficient.
-- Do not send prompts, raw commands, code, logs, tool output, URLs, secrets, or file paths to pet speech.
+- Do not send prompts, raw commands, code, logs, tool output, URLs, secrets, or file paths to familiar speech.
 - Do not write project-local absolute local/bundled paths by default.
 
 ## Recommended subphase sequence
@@ -118,9 +118,9 @@ This should be **4 subphases**, not 6. That keeps risk separated without making
 ```json
 {
   "mcp": {
-    "openpets": {
+    "familiaros": {
       "type": "local",
-      "command": ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"],
+      "command": ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"],
       "enabled": true
     }
   }
@@ -132,8 +132,8 @@ This should be **4 subphases**, not 6. That keeps risk separated without making
 
 **Checks:**
 
-- `pnpm --filter @open-pets/opencode check`
-- `pnpm --filter @open-pets/claude check`
+- `pnpm --filter @familiaros/opencode check`
+- `pnpm --filter @familiaros/claude check`
 
 ### Phase 19B — OpenCode Plugin Runtime
 
@@ -148,10 +148,10 @@ This should be **4 subphases**, not 6. That keeps risk separated without making
   - file/local plugin has a stable `id`;
   - local/bundled dynamic import smoke test exists.
 - Plugin hooks must return immediately.
-- OpenPets calls run fire-and-forget with internal `.catch()` and debug-only logging.
+- FamiliarOS calls run fire-and-forget with internal `.catch()` and debug-only logging.
 - Use short client timeouts, but do not await them in OpenCode hooks.
 - Lease strategy:
-  - acquire a lease when configured with `pet`;
+  - acquire a lease when configured with `familiar`;
   - pass `leaseId` to `say`/`react`;
   - prefer cached lease with safe fallback, or per-event acquisition if simpler and non-blocking.
 - Event mapping:
@@ -167,46 +167,46 @@ This should be **4 subphases**, not 6. That keeps risk separated without making
 **Acceptance criteria:**
 
 - Plugin can be imported from built output.
-- Plugin hook functions return without awaiting OpenPets IPC.
+- Plugin hook functions return without awaiting FamiliarOS IPC.
 - Unit tests cover event classification and fire-and-forget failure swallowing.
 - Manual OpenCode config can load the plugin and trigger reactions.
 
 **Checks:**
 
-- `pnpm --filter @open-pets/opencode check`
+- `pnpm --filter @familiaros/opencode check`
 - Manual plugin load smoke test.
 
 ### Phase 19C — CLI Project Setup for OpenCode
 
-**Goal:** Extend `openpets configure` to support project-local OpenCode setup.
+**Goal:** Extend `familiaros configure` to support project-local OpenCode setup.
 
 **Scope:**
 
 - Add `--agent opencode` alongside existing `--agent claude`.
 - Keep Claude CLI behavior unchanged.
-- With explicit `--pet`, configuration can run without desktop app.
-- Without `--pet`, use local IPC pet picker as Claude does.
+- With explicit `--familiar`, configuration can run without desktop app.
+- Without `--familiar`, use local IPC familiar picker as Claude does.
 - Write project config entries for:
-  - `mcp.openpets`;
-  - OpenPets instructions file, e.g. `.opencode/openpets.md`;
-  - OpenPets plugin spec/options.
+  - `mcp.familiaros`;
+  - FamiliarOS instructions file, e.g. `.opencode/familiaros.md`;
+  - FamiliarOS plugin spec/options.
 - Print exact files changed and restart guidance.
-- Warn that `.opencode/opencode.jsonc` can be committed and may contain the selected pet id.
+- Warn that `.opencode/opencode.jsonc` can be committed and may contain the selected familiar id.
 - Do not require `opencode` binary on PATH to write project config; warn if not found.
 
 **Acceptance criteria:**
 
-- `openpets configure --agent opencode --pet fixer --local-dev --cwd <tmp>` writes expected project config offline.
+- `familiaros configure --agent opencode --familiar fixer --local-dev --cwd <tmp>` writes expected project config offline.
 - Re-running is idempotent.
-- `--force` replaces only OpenPets-managed entries.
+- `--force` replaces only FamiliarOS-managed entries.
 - Unknown agents still fail clearly.
 - Claude project setup tests still pass.
 
 **Checks:**
 
-- `pnpm --filter @open-pets/cli check`
-- `pnpm --filter @open-pets/opencode check`
-- `pnpm --filter @open-pets/claude check`
+- `pnpm --filter @familiaros/cli check`
+- `pnpm --filter @familiaros/opencode check`
+- `pnpm --filter @familiaros/claude check`
 
 ### Phase 19D — Desktop Integration, Packaging, Docs, Hardening
 
@@ -220,8 +220,8 @@ This should be **4 subphases**, not 6. That keeps risk separated without making
 - Global setup can:
   - detect OpenCode best-effort;
   - install/replace/remove global MCP entry;
-  - install/update global OpenPets instructions;
-  - install/update/remove global OpenPets plugin;
+  - install/update global FamiliarOS instructions;
+  - install/update/remove global FamiliarOS plugin;
   - show previews and copy manual snippets;
   - show clear status and backups.
 - Preserve Claude UI/actions.
@@ -243,7 +243,7 @@ This should be **4 subphases**, not 6. That keeps risk separated without making
 
 - Desktop UI clearly says OpenCode desktop setup is global.
 - No global config write occurs without explicit user action.
-- Remove only removes OpenPets-managed entries.
+- Remove only removes FamiliarOS-managed entries.
 - OpenCode absent on PATH does not prevent showing config status/previews.
 - Packaged app can locate bundled OpenCode plugin and CLI resources.
 - Docs explain exact files touched and CLI project setup vs desktop global setup.
@@ -251,15 +251,15 @@ This should be **4 subphases**, not 6. That keeps risk separated without making
 
 **Checks:**
 
-- `pnpm --filter @open-pets/desktop check`
-- `pnpm --filter @open-pets/opencode check`
+- `pnpm --filter @familiaros/desktop check`
+- `pnpm --filter @familiaros/opencode check`
 - `pnpm check`
 
 ## Security/privacy requirements for every subphase
 
-- Never include prompt text, command text, file paths, tool output, code, logs, URLs, or secrets in pet speech.
+- Never include prompt text, command text, file paths, tool output, code, logs, URLs, or secrets in familiar speech.
 - Classify tools using tool names and coarse categories only.
-- Validate pet ids with the same strict regex as Claude.
+- Validate familiar ids with the same strict regex as Claude.
 - Reject symlinked config/instruction/plugin write targets.
 - Keep writes inside the selected project or OpenCode config dir.
 - Back up before update/replace/remove once writes are implemented.
@@ -274,7 +274,7 @@ Oracle reviewed the first all-in-one Phase 19 plan and found the architecture vi
 
 - Desktop target scope was ambiguous: global vs project setup.
 - `permission.ask` assumption was wrong; use `event` hook for `permission.asked`.
-- Plugin hooks are awaited by OpenCode; OpenPets work must be fire-and-forget, not merely timeout-bounded.
+- Plugin hooks are awaited by OpenCode; FamiliarOS work must be fire-and-forget, not merely timeout-bounded.
 - Plugin package/path contract was underspecified.
 - Config precedence and write targets needed tightening.
 - Data-loss protections needed hard requirements.
@@ -286,7 +286,7 @@ Oracle reviewed the first all-in-one Phase 19 plan and found the architecture vi
 - **Fixed:** Split one large phase into 4 subphases, not 6.
 - **Fixed:** Desktop setup is global-only unless a later project picker is added.
 - **Fixed:** Permission mapping uses `event`/`permission.asked`, not `permission.ask`.
-- **Fixed:** Plugin hooks must return immediately and run OpenPets calls fire-and-forget.
+- **Fixed:** Plugin hooks must return immediately and run FamiliarOS calls fire-and-forget.
 - **Fixed:** Added plugin package/path contract and bundled import smoke requirement.
 - **Fixed:** Aligned existing config candidate order with OpenCode's own `mcp add` order.
 - **Fixed:** Added invalid JSONC, max size, symlink, backup, and atomic write requirements.
@@ -298,7 +298,7 @@ Oracle reviewed the first all-in-one Phase 19 plan and found the architecture vi
 Phase 19A–19D are implemented in the v2 workspace:
 
 - `packages/opencode` provides OpenCode config helpers, strict managed-entry classification, safe global/project writes, and the OpenCode plugin runtime.
-- `packages/cli` supports `openpets configure --agent opencode` for project-local setup.
+- `packages/cli` supports `familiaros configure --agent opencode` for project-local setup.
 - Desktop Integrations supports global OpenCode setup/removal/preview/copy, with packaged CLI resource checks and published plugin configuration.
 - README and mapping docs explain OpenCode project-local vs desktop-global setup and safe speech constraints.
 
diff --git a/docs/phases/phase-19a-opencode-foundation.md b/docs/phases/phase-19a-opencode-foundation.md
index 8ec5f447..aed67ddf 100644
--- a/docs/phases/phase-19a-opencode-foundation.md
+++ b/docs/phases/phase-19a-opencode-foundation.md
@@ -8,7 +8,7 @@ Add the non-UI foundation for OpenCode integration:
 - OpenCode MCP/instructions/plugin previews and status classification.
 - Shared speech safety utilities reusable by Claude hooks and the future OpenCode plugin.
 
-This phase should not install a working OpenCode plugin, change Desktop Integrations UI, or extend `openpets configure --agent opencode` yet. It prepares the safe primitives for those later phases.
+This phase should not install a working OpenCode plugin, change Desktop Integrations UI, or extend `familiaros configure --agent opencode` yet. It prepares the safe primitives for those later phases.
 
 ## Non-goals
 
@@ -16,14 +16,14 @@ This phase should not install a working OpenCode plugin, change Desktop Integrat
 - No Desktop Integrations OpenCode card.
 - No CLI `--agent opencode` user-facing command yet.
 - No writes to real user OpenCode config during tests.
-- No changes to public MCP tools; they remain exactly `openpets_status`, `openpets_say`, `openpets_react`.
+- No changes to public MCP tools; they remain exactly `familiaros_status`, `familiaros_say`, `familiaros_react`.
 - No fork or modification of `v1/opencode/`.
 
 ## User-visible/manual outcome
 
 No direct user-visible feature is expected yet.
 
-Developers should be able to run checks and see that OpenPets can safely build and classify OpenCode config previews in isolated temp fixtures.
+Developers should be able to run checks and see that FamiliarOS can safely build and classify OpenCode config previews in isolated temp fixtures.
 
 ## Acceptance criteria
 
@@ -32,9 +32,9 @@ Developers should be able to run checks and see that OpenPets can safely build a
   - best-effort OpenCode executable detection data shape;
   - global/project OpenCode config candidate paths;
   - JSON/JSONC parsing and update planning;
-  - OpenPets MCP config preview;
-  - OpenPets instruction config preview;
-  - OpenPets plugin config preview;
+  - FamiliarOS MCP config preview;
+  - FamiliarOS instruction config preview;
+  - FamiliarOS plugin config preview;
   - installed/missing/stale/error status classification.
 - OpenCode project config candidate order for existing files follows OpenCode's own MCP add behavior:
   1. `opencode.json`
@@ -43,7 +43,7 @@ Developers should be able to run checks and see that OpenPets can safely build a
   4. `.opencode/opencode.jsonc`
 - If no project config exists, helpers should plan creation of `.opencode/opencode.jsonc`.
 - Status helpers must scan all relevant project config files, not only the chosen write target, because OpenCode can merge top-level and `.opencode` configs.
-- Multiple or conflicting OpenPets entries must be classified explicitly instead of silently choosing one.
+- Multiple or conflicting FamiliarOS entries must be classified explicitly instead of silently choosing one.
 - Global config discovery is read/status-only in 19A and must define:
   - `OPENCODE_CONFIG_DIR` override support;
   - default config directory derived from platform/XDG conventions;
@@ -54,9 +54,9 @@ Developers should be able to run checks and see that OpenPets can safely build a
 ```json
 {
   "mcp": {
-    "openpets": {
+    "familiaros": {
       "type": "local",
-      "command": ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"],
+      "command": ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"],
       "enabled": true
     }
   }
@@ -64,13 +64,13 @@ Developers should be able to run checks and see that OpenPets can safely build a
 ```
 
 - Local-dev previews may use `node <workspace>/.../cli/dist/index.js`, but project-local absolute paths must not be the default.
-- The CLI package version must be an injected parameter to preview builders. `packages/opencode` must not import `@open-pets/cli`, so the later CLI dependency on `@open-pets/opencode` does not create a cycle.
-- No-pet MCP preview is valid and means the default OpenPets MCP target:
+- The CLI package version must be an injected parameter to preview builders. `packages/opencode` must not import `@familiaros/cli`, so the later CLI dependency on `@familiaros/opencode` does not create a cycle.
+- No-familiar MCP preview is valid and means the default FamiliarOS MCP target:
 
 ```json
 {
   "type": "local",
-  "command": ["npx", "-y", "@open-pets/cli@0.0.0", "mcp"],
+  "command": ["npx", "-y", "@familiaros/cli@0.0.0", "mcp"],
   "enabled": true
 }
 ```
@@ -87,16 +87,16 @@ Developers should be able to run checks and see that OpenPets can safely build a
 - Backup and temp paths must use unique names, avoid overwrite, use exclusive temp-file creation, and keep temp files in the same directory as the target.
 - File mode should be private where meaningful on the current platform.
 - Existing unrelated OpenCode config keys are preserved by update helpers.
-- Existing non-OpenPets MCP/plugin/instruction entries are preserved.
+- Existing non-FamiliarOS MCP/plugin/instruction entries are preserved.
 - Managed ownership rules must be explicit:
-  - current managed MCP entry = exact expected OpenPets command shape for the selected mode/pet;
-  - stale managed MCP entry = recognizable OpenPets package/path/command but outdated;
-  - custom/foreign `mcp.openpets` = present but not managed; classify separately and do not overwrite/remove by default;
-  - current managed instruction entry = expected OpenPets instruction path plus managed file block;
-  - stale managed instruction entry = recognizable OpenPets path/block but outdated;
-  - custom/foreign OpenPets-like instruction/plugin entries = classify separately and do not overwrite/remove by default.
-- Existing OpenPets-managed entries are idempotently recognized.
-- Stale OpenPets-managed entries can be classified as `needs_update` without overwriting in this phase's public surface.
+  - current managed MCP entry = exact expected FamiliarOS command shape for the selected mode/familiar;
+  - stale managed MCP entry = recognizable FamiliarOS package/path/command but outdated;
+  - custom/foreign `mcp.familiaros` = present but not managed; classify separately and do not overwrite/remove by default;
+  - current managed instruction entry = expected FamiliarOS instruction path plus managed file block;
+  - stale managed instruction entry = recognizable FamiliarOS path/block but outdated;
+  - custom/foreign FamiliarOS-like instruction/plugin entries = classify separately and do not overwrite/remove by default.
+- Existing FamiliarOS-managed entries are idempotently recognized.
+- Stale FamiliarOS-managed entries can be classified as `needs_update` without overwriting in this phase's public surface.
 - Shared speech utilities are extracted or introduced so Claude and OpenCode can share:
   - speech categories;
   - message picking;
@@ -110,7 +110,7 @@ Developers should be able to run checks and see that OpenPets can safely build a
   - URLs;
   - path-like content;
   - secret-looking assignments.
-- Tests must not mutate real Claude settings, real OpenCode config, or real OpenPets user data.
+- Tests must not mutate real Claude settings, real OpenCode config, or real FamiliarOS user data.
 
 ## Proposed files/directories
 
@@ -163,17 +163,17 @@ MCP preview should produce:
 ```ts
 {
   type: "local",
-  command: ["npx", "-y", "@open-pets/cli@<version>", "mcp", "--pet", petId],
+  command: ["npx", "-y", "@familiaros/cli@<version>", "mcp", "--familiar", petId],
   enabled: true,
 }
 ```
 
 Instructions preview should plan:
 
-- project: `.opencode/openpets.md` plus `instructions: [".opencode/openpets.md"]`;
+- project: `.opencode/familiaros.md` plus `instructions: [".opencode/familiaros.md"]`;
 - global: a safe OpenCode config dir path decided in later desktop phase.
 
-Plugin preview should be intentionally minimal in 19A because the runtime contract is finalized in Phase 19B. It may build the planned config slot and preserve existing entries, but installed/stale plugin classification should be limited to exact/recognizable OpenPets specs already known. Ambiguous plugin entries must be classified as custom/foreign and left untouched.
+Plugin preview should be intentionally minimal in 19A because the runtime contract is finalized in Phase 19B. It may build the planned config slot and preserve existing entries, but installed/stale plugin classification should be limited to exact/recognizable FamiliarOS specs already known. Ambiguous plugin entries must be classified as custom/foreign and left untouched.
 
 ### Safe write model
 
@@ -210,30 +210,30 @@ If throttling is moved in this phase, throttle storage must remain namespaced by
 
 - Do not read or write real user OpenCode/Claude files in tests.
 - Do not expose prompt text, command text, code, logs, file paths, URLs, secrets, or tool output through shared speech utilities.
-- Validate pet ids with the same strict rules as Claude.
+- Validate familiar ids with the same strict rules as Claude.
 - Treat config paths as untrusted; reject symlinks and oversized files.
 - Preserve unrelated user config.
 
 ## Test/check plan
 
-- `pnpm --filter @open-pets/opencode check`
-- `pnpm --filter @open-pets/claude check`
-- `pnpm --filter @open-pets/desktop check` if packaging/check contracts are touched.
+- `pnpm --filter @familiaros/opencode check`
+- `pnpm --filter @familiaros/claude check`
+- `pnpm --filter @familiaros/desktop check` if packaging/check contracts are touched.
 
 Specific tests/checks:
 
 - Project candidate selection with each possible existing config file.
 - No existing config plans `.opencode/opencode.jsonc`.
-- Status scanning sees duplicate/conflicting OpenPets entries across top-level and `.opencode` configs.
+- Status scanning sees duplicate/conflicting FamiliarOS entries across top-level and `.opencode` configs.
 - Global discovery covers `OPENCODE_CONFIG_DIR`, platform/XDG default path, `config.json`, `opencode.json`, and `opencode.jsonc`.
-- MCP preview with and without selected pet.
+- MCP preview with and without selected familiar.
 - Local-dev preview uses `node` command only when explicitly requested.
 - JSONC update preserves unrelated fields and comments where practical.
 - Invalid known field types return error and no write plan: `mcp: []`, `instructions: "x"`, `plugin: {}`.
-- Existing matching OpenPets entries classify as installed.
-- Existing stale OpenPets entries classify as needs update.
-- Custom/foreign `mcp.openpets` classifies separately and is not treated as managed.
-- Non-OpenPets entries are preserved.
+- Existing matching FamiliarOS entries classify as installed.
+- Existing stale FamiliarOS entries classify as needs update.
+- Custom/foreign `mcp.familiaros` classifies separately and is not treated as managed.
+- Non-FamiliarOS entries are preserved.
 - Invalid JSONC returns error and no write plan.
 - Oversized config returns error.
 - Symlinked config, symlinked top-level parent, symlinked `.opencode`, or symlinked/escaping project root returns error.
@@ -249,12 +249,12 @@ Specific tests/checks:
 
 After implementation, manually verify:
 
-1. Run `pnpm --filter @open-pets/opencode check`.
-2. Run `pnpm --filter @open-pets/claude check`.
-3. If desktop/package files changed, run `pnpm --filter @open-pets/desktop check`.
+1. Run `pnpm --filter @familiaros/opencode check`.
+2. Run `pnpm --filter @familiaros/claude check`.
+3. If desktop/package files changed, run `pnpm --filter @familiaros/desktop check`.
 4. Run any fixture/manual check with temp `HOME`, `XDG_CONFIG_HOME`, and `OPENCODE_CONFIG_DIR`.
 5. Inspect generated fixture outputs from tests, if any, and confirm OpenCode config shape matches the expected MCP/instructions/plugin previews.
-6. Confirm no real `~/.config/opencode`, `~/.claude`, or OpenPets user state changed.
+6. Confirm no real `~/.config/opencode`, `~/.claude`, or FamiliarOS user state changed.
 
 ## Oracle plan review
 
@@ -266,7 +266,7 @@ Blockers raised:
 - Write target order and full load/status scanning were underspecified.
 - Managed ownership rules were missing.
 - JSON/JSONC write contract needed invalid type, symlink, atomicity, backup, and mode details.
-- No-pet MCP preview behavior was undefined.
+- No-familiar MCP preview behavior was undefined.
 - Package dependency/version source could create cycles.
 - Shared speech throttling extraction was too broad.
 - Plugin preview/status was premature without a finalized plugin runtime contract.
@@ -277,7 +277,7 @@ Blockers raised:
 - **Fixed:** Required status helpers to scan all relevant project config files and classify multiple/conflicting entries.
 - **Fixed:** Added explicit managed/current/stale/custom ownership rules for MCP, instructions, and plugin-like entries.
 - **Fixed:** Added invalid known field type errors, project-root checks, parent symlink rejection, unique backups/temp files, exclusive same-directory temp writes, and private mode requirement where meaningful.
-- **Fixed:** Defined no-pet MCP preview as default OpenPets MCP target without `--pet`.
-- **Fixed:** Required package version injection so `packages/opencode` does not import `@open-pets/cli`.
+- **Fixed:** Defined no-familiar MCP preview as default FamiliarOS MCP target without `--familiar`.
+- **Fixed:** Required package version injection so `packages/opencode` does not import `@familiaros/cli`.
 - **Fixed:** Narrowed shared speech extraction to categories/messages/validation; throttling is optional only with parity tests, otherwise deferred.
 - **Fixed:** Limited plugin preview/status to minimal exact/recognizable specs and custom/foreign preservation until Phase 19B finalizes runtime contract.
diff --git a/docs/phases/phase-19b-opencode-plugin-runtime.md b/docs/phases/phase-19b-opencode-plugin-runtime.md
index 89cd5210..bee6d327 100644
--- a/docs/phases/phase-19b-opencode-plugin-runtime.md
+++ b/docs/phases/phase-19b-opencode-plugin-runtime.md
@@ -2,9 +2,9 @@
 
 ## Goal
 
-Add the OpenCode runtime plugin that turns OpenCode activity into OpenPets reactions and short safe speech.
+Add the OpenCode runtime plugin that turns OpenCode activity into FamiliarOS reactions and short safe speech.
 
-This phase builds on Phase 19A's foundation package and shared speech validation. It should make the plugin importable/testable and ready for manual OpenCode config, but it should not add Desktop UI or `openpets configure --agent opencode` yet.
+This phase builds on Phase 19A's foundation package and shared speech validation. It should make the plugin importable/testable and ready for manual OpenCode config, but it should not add Desktop UI or `familiaros configure --agent opencode` yet.
 
 ## Non-goals
 
@@ -14,18 +14,18 @@ This phase builds on Phase 19A's foundation package and shared speech validation
 - No OpenCode source changes under `v1/opencode/`.
 - No new public MCP tools.
 - No external SSE watcher or new TCP/HTTP listener.
-- No pet install/remove/default controls.
+- No familiar install/remove/default controls.
 
 ## User-visible/manual outcome
 
-Developers can manually add the plugin to an OpenCode config and see OpenPets react to OpenCode activity.
+Developers can manually add the plugin to an OpenCode config and see FamiliarOS react to OpenCode activity.
 
 Expected manual plugin spec shape:
 
 ```jsonc
 {
   "plugin": [
-    ["@open-pets/opencode", { "pet": "fixer" }]
+    ["@familiaros/opencode", { "familiar": "fixer" }]
   ]
 }
 ```
@@ -34,39 +34,39 @@ For local development, a file URL or absolute built plugin path can be used afte
 
 ## Acceptance criteria
 
-- `@open-pets/opencode` exposes an OpenCode-compatible server plugin entrypoint.
+- `@familiaros/opencode` exposes an OpenCode-compatible server plugin entrypoint.
 - Package export contract supports OpenCode's loader expectations:
   - npm package can resolve a server plugin entrypoint through an explicit package export such as `./server` without replacing the helper `.` export;
   - default export is an object with `server()`;
   - file/local plugin entry includes a stable `id`;
   - built output can be dynamically imported in tests;
-  - package-level resolution of `@open-pets/opencode/server` is covered by tests.
+  - package-level resolution of `@familiaros/opencode/server` is covered by tests.
 - Plugin options accept:
-  - optional `pet` id using the same strict pet id validation as Claude/OpenCode foundation;
-  - optional debug flag or rely on `OPENPETS_DEBUG=1`.
-- Plugin hooks must return immediately. OpenPets IPC work must run fire-and-forget and never be awaited by OpenCode plugin hooks.
+  - optional `familiar` id using the same strict familiar id validation as Claude/OpenCode foundation;
+  - optional debug flag or rely on `FAMILIAROS_DEBUG=1`.
+- Plugin hooks must return immediately. FamiliarOS IPC work must run fire-and-forget and never be awaited by OpenCode plugin hooks.
 - The `event` hook must be a synchronous non-throwing wrapper. OpenCode calls `event` with `void hook.event(...)` and does not await/catch it, so `event` must catch synchronous errors and schedule async work internally.
-- OpenPets calls must be best-effort:
+- FamiliarOS calls must be best-effort:
   - catch all errors internally;
   - debug-only sanitized logging;
   - short client timeouts;
   - never throw back into OpenCode.
-- If `pet` is configured, plugin reactions/speech should acquire or reuse an OpenPets lease and pass `leaseId` to `react`/`say`.
+- If `familiar` is configured, plugin reactions/speech should acquire or reuse an FamiliarOS lease and pass `leaseId` to `react`/`say`.
 - Lease handling must not block OpenCode hooks. It can be a cached in-flight/background lease or per-event fire-and-forget acquisition, but hook functions themselves must remain synchronous or already-resolved async functions.
 - Event mapping must cover:
   - `chat.message` → `thinking` + throttled speech.
   - `tool.execute.before` edit/write/patch tool names → `editing`.
   - `tool.execute.before` shell/bash tool names with test-like command/category when safely inferable → `testing`.
   - `tool.execute.before` shell/bash tool names otherwise → `running`.
-  - other non-OpenPets tools → `working`.
+  - other non-FamiliarOS tools → `working`.
   - plugin `event` with `permission.asked` → `waiting` + approval-needed speech.
   - plugin `event` with `session.status` idle, if stable and useful → `success` sparingly.
   - plugin `event` with `session.error` → `error`.
-- The plugin must ignore OpenPets MCP tool calls to avoid self-reaction loops, including likely OpenCode MCP tool names such as:
-  - `openpets_openpets_status`
-  - `openpets_openpets_say`
-  - `openpets_openpets_react`
-- Speech must use shared `@open-pets/agent-events` validation and message pools.
+- The plugin must ignore FamiliarOS MCP tool calls to avoid self-reaction loops, including likely OpenCode MCP tool names such as:
+  - `familiaros_familiaros_status`
+  - `familiaros_familiaros_say`
+  - `familiaros_familiaros_react`
+- Speech must use shared `@familiaros/agent-events` validation and message pools.
 - Speech must not include prompt text, command text, tool args, tool output, code, logs, file paths, URLs, or secrets.
 - Throttling for OpenCode speech must be namespaced separately from Claude, e.g. `opencode-hook-throttle.json` or equivalent.
 - Tests cover event classification, speech safety, self-tool suppression, fire-and-forget behavior, import shape, and failure swallowing.
@@ -102,7 +102,7 @@ Implementation should export something compatible with:
 
 ```ts
 export default {
-  id: "open-pets-opencode",
+  id: "familiaros-opencode",
   server: async (_input, options) => ({
     "chat.message": () => { /* schedule, return immediately */ },
     "tool.execute.before": () => { /* schedule, return immediately */ },
@@ -120,7 +120,7 @@ OpenCode awaits plugin hooks in several paths:
 - `Plugin.trigger` awaits hook promises: `v1/opencode/packages/opencode/src/plugin/index.ts` lines 258-269.
 - Tool execution calls `tool.execute.before` before running tools: `v1/opencode/packages/opencode/src/session/prompt.ts` lines 428-433.
 
-Therefore every plugin hook must schedule OpenPets work and then return immediately. Do not `await client.react`, `await client.say`, or `await client.acquireLease` directly inside a hook.
+Therefore every plugin hook must schedule FamiliarOS work and then return immediately. Do not `await client.react`, `await client.say`, or `await client.acquireLease` directly inside a hook.
 
 Use a small scheduler/helper such as:
 
@@ -134,11 +134,11 @@ Hook functions may be `async` for OpenCode compatibility, but they must not awai
 
 Exception: the `event` hook should not be `async`, because OpenCode does not await/catch it.
 
-### OpenPets client behavior
+### FamiliarOS client behavior
 
-Use `createOpenPetsClient({ connectTimeoutMs: 500, responseTimeoutMs: 500 })` or a similarly short timeout.
+Use `createFamiliarOSClient({ connectTimeoutMs: 500, responseTimeoutMs: 500 })` or a similarly short timeout.
 
-When `pet` is configured:
+When `familiar` is configured:
 
 - Acquire a lease in the background.
 - Cache the lease id while valid if simple.
@@ -151,9 +151,9 @@ Keep classification pure and testable.
 
 Proposed pure functions:
 
-- `classifyOpenCodeToolReaction(toolName, args): OpenPetsReaction | undefined`
+- `classifyOpenCodeToolReaction(toolName, args): FamiliarOSReaction | undefined`
 - `classifyOpenCodeBusEvent(event): { reaction?, speechCategory?, forceSpeech? } | undefined`
-- `shouldIgnoreOpenPetsTool(toolName): boolean`
+- `shouldIgnoreFamiliarOSTool(toolName): boolean`
 
 Tool classification should rely on tool names and safe coarse categories. It may inspect a shell command only to decide whether it looks test-like, and must never send the command text to speech.
 
@@ -161,7 +161,7 @@ Expected tool name patterns:
 
 - edit/write/patch: names containing `edit`, `write`, `patch`, `apply_patch`.
 - shell/bash: names containing `bash`, `shell`, `terminal`, or OpenCode's shell tool id if known.
-- OpenPets MCP tools: suppress names ending in or equal to `openpets_status`, `openpets_say`, `openpets_react`, including server-prefixed forms.
+- FamiliarOS MCP tools: suppress names ending in or equal to `familiaros_status`, `familiaros_say`, `familiaros_react`, including server-prefixed forms.
 
 Bus event classification:
 
@@ -171,7 +171,7 @@ Bus event classification:
 
 ### Speech/throttling
 
-Use shared messages and validator from `@open-pets/agent-events`.
+Use shared messages and validator from `@familiaros/agent-events`.
 
 OpenCode speech categories should match Claude categories for now:
 
@@ -185,40 +185,40 @@ Throttle storage must be separate from Claude. If file-backed throttling is adde
 ## Risks and tradeoffs
 
 - OpenCode plugin APIs may evolve; keep plugin-specific runtime isolated in `packages/opencode`.
-- Fire-and-forget scheduling avoids blocking OpenCode but means pet reactions may be dropped if Node exits immediately.
+- Fire-and-forget scheduling avoids blocking OpenCode but means familiar reactions may be dropped if Node exits immediately.
 - Lease caching adds state; if too complex, prefer simple background per-event lease acquisition for correctness.
 - Mapping session idle to success may be noisy. It should be throttled or omitted if unstable during implementation.
-- Adding runtime client dependency to `@open-pets/opencode` is expected in this phase; avoid depending on CLI or desktop.
+- Adding runtime client dependency to `@familiaros/opencode` is expected in this phase; avoid depending on CLI or desktop.
 
 ## Security/privacy notes
 
-- Never send prompt text, command text, tool args, tool output, code, logs, file paths, URLs, or secrets to pet speech.
+- Never send prompt text, command text, tool args, tool output, code, logs, file paths, URLs, or secrets to familiar speech.
 - Debug logging must sanitize paths and secrets.
-- Plugin must ignore OpenPets MCP tools to avoid loops.
-- Plugin must catch all OpenPets client errors.
+- Plugin must ignore FamiliarOS MCP tools to avoid loops.
+- Plugin must catch all FamiliarOS client errors.
 - No new local server, TCP listener, or HTTP endpoint is added.
-- `pet` option must be strictly validated before use.
+- `familiar` option must be strictly validated before use.
 
 ## Test/check plan
 
-- `pnpm --filter @open-pets/opencode check`
-- `pnpm --filter @open-pets/agent-events check`
-- `pnpm --filter @open-pets/claude check`
+- `pnpm --filter @familiaros/opencode check`
+- `pnpm --filter @familiaros/agent-events check`
+- `pnpm --filter @familiaros/claude check`
 - `pnpm check` after implementation review fixes.
 
 Specific tests:
 
 - Dynamic import of built plugin entry returns default object with `id` and `server()`.
-- Dynamic import of package export `@open-pets/opencode/server` returns default object with `id` and `server()`.
+- Dynamic import of package export `@familiaros/opencode/server` returns default object with `id` and `server()`.
 - `server()` returns hooks for `chat.message`, `tool.execute.before`, and `event`.
 - Hook calls schedule work and return before a deliberately unresolved fake client promise completes.
 - `event` hook is synchronous, non-throwing, and does not produce unhandled rejections when classification/scheduling fails.
-- OpenPets client errors are swallowed.
-- Configured pet id is validated; invalid pet option fails plugin setup safely.
+- FamiliarOS client errors are swallowed.
+- Configured familiar id is validated; invalid familiar option fails plugin setup safely.
 - `chat.message` maps to `thinking` without using prompt text.
 - edit/write/patch tools map to `editing`.
 - shell/bash test-like tools map to `testing`; non-test shell maps to `running`.
-- OpenPets MCP tools are ignored.
+- FamiliarOS MCP tools are ignored.
 - `permission.asked` maps to `waiting` + permission speech.
 - `session.error` maps to `error`.
 - Speech validator rejects unsafe generated messages.
@@ -228,18 +228,18 @@ Specific tests:
 
 After implementation and review:
 
-1. Run `pnpm --filter @open-pets/opencode check`.
+1. Run `pnpm --filter @familiaros/opencode check`.
 2. Run `pnpm check`.
-3. Start OpenPets desktop locally.
+3. Start FamiliarOS desktop locally.
 4. Build packages.
 5. Manually add the local built OpenCode plugin to a test OpenCode project config.
 6. Start OpenCode in that test project.
-7. Submit a prompt and confirm the selected/default pet reacts with `thinking`.
+7. Submit a prompt and confirm the selected/default familiar reacts with `thinking`.
 8. Run an edit/write action and confirm `editing`.
 9. Run a test-like shell action and confirm `testing`.
 10. Trigger a permission request if practical and confirm `waiting` / approval speech.
-11. Confirm OpenPets MCP tool calls do not trigger recursive reactions.
-12. Confirm no prompt text, command text, file path, or tool output appears in pet speech.
+11. Confirm FamiliarOS MCP tool calls do not trigger recursive reactions.
+12. Confirm no prompt text, command text, file path, or tool output appears in familiar speech.
 
 ## Oracle plan review
 
@@ -250,5 +250,5 @@ Oracle reviewed the initial Phase 19B spec and found two plan blockers:
 
 ## Oracle feedback disposition
 
-- **Fixed:** Added explicit `@open-pets/opencode/server` export requirement and package-level import test.
+- **Fixed:** Added explicit `@familiaros/opencode/server` export requirement and package-level import test.
 - **Fixed:** Required `event` to be synchronous, non-throwing, and internally catch/schedule async work.
diff --git a/docs/phases/phase-19c-opencode-cli-project-setup.md b/docs/phases/phase-19c-opencode-cli-project-setup.md
index aa63db48..a7bfebdf 100644
--- a/docs/phases/phase-19c-opencode-cli-project-setup.md
+++ b/docs/phases/phase-19c-opencode-cli-project-setup.md
@@ -2,13 +2,13 @@
 
 ## Goal
 
-Extend the OpenPets CLI so users can configure a project for OpenCode with one command:
+Extend the FamiliarOS CLI so users can configure a project for OpenCode with one command:
 
 ```bash
-npx @open-pets/cli configure --agent opencode --pet fixer
+npx @familiaros/cli configure --agent opencode --familiar fixer
 ```
 
-This writes project-local OpenCode config for OpenPets MCP, OpenPets instructions, and the OpenPets OpenCode plugin.
+This writes project-local OpenCode config for FamiliarOS MCP, FamiliarOS instructions, and the FamiliarOS OpenCode plugin.
 
 ## Non-goals
 
@@ -25,24 +25,24 @@ This writes project-local OpenCode config for OpenPets MCP, OpenPets instruction
 From a project directory, users can run:
 
 ```bash
-npx @open-pets/cli configure --agent opencode --pet fixer
+npx @familiaros/cli configure --agent opencode --familiar fixer
 ```
 
 Expected result:
 
-- OpenCode project config contains `mcp.openpets`.
-- OpenCode project config includes OpenPets instruction file `.opencode/openpets.md`.
-- OpenCode project config includes OpenPets plugin spec/options targeting `fixer`.
-- Starting OpenCode from that project gives OpenPets MCP tools and plugin-driven reactions for `fixer`.
+- OpenCode project config contains `mcp.familiaros`.
+- OpenCode project config includes FamiliarOS instruction file `.opencode/familiaros.md`.
+- OpenCode project config includes FamiliarOS plugin spec/options targeting `fixer`.
+- Starting OpenCode from that project gives FamiliarOS MCP tools and plugin-driven reactions for `fixer`.
 
-If `--pet` is omitted, the CLI uses the same installed-pet picker as Claude setup and therefore requires OpenPets desktop to be running.
+If `--familiar` is omitted, the CLI uses the same installed-familiar picker as Claude setup and therefore requires FamiliarOS desktop to be running.
 
 ## Acceptance criteria
 
 - `parseConfigureArgs` accepts `--agent opencode` and still accepts/keeps `--agent claude` behavior unchanged.
 - Unsupported agents still fail clearly.
-- `openpets configure --agent opencode --pet <id> --cwd <project>` runs without requiring OpenPets desktop.
-- `openpets configure --agent opencode` without `--pet` uses local IPC pet listing/picker like Claude.
+- `familiaros configure --agent opencode --familiar <id> --cwd <project>` runs without requiring FamiliarOS desktop.
+- `familiaros configure --agent opencode` without `--familiar` uses local IPC familiar listing/picker like Claude.
 - OpenCode setup does not require `opencode` binary on `PATH`; if detection is added, it is warning-only.
 - Project path validation rejects symlinked project roots.
 - OpenCode config writes use Phase 19A helpers:
@@ -53,47 +53,47 @@ If `--pet` is omitted, the CLI uses the same installed-pet picker as Claude setu
   - symlink and escape rejection.
 - If no project OpenCode config exists, create `.opencode/opencode.jsonc`.
 - Existing unrelated OpenCode config keys are preserved.
-- Existing non-OpenPets MCP/plugin/instruction entries are preserved.
-- Existing matching OpenPets entries are idempotent.
-- Existing stale managed OpenPets entries are updated.
-- Custom/foreign `mcp.openpets` or OpenPets-like plugin/instruction entries must not be overwritten. In this phase, fail clearly and tell the user to edit/remove the custom entry manually.
-- `--force` may replace stale managed OpenPets entries, but must not overwrite custom/foreign entries.
+- Existing non-FamiliarOS MCP/plugin/instruction entries are preserved.
+- Existing matching FamiliarOS entries are idempotent.
+- Existing stale managed FamiliarOS entries are updated.
+- Custom/foreign `mcp.familiaros` or FamiliarOS-like plugin/instruction entries must not be overwritten. In this phase, fail clearly and tell the user to edit/remove the custom entry manually.
+- `--force` may replace stale managed FamiliarOS entries, but must not overwrite custom/foreign entries.
 - Written project config uses published mode by default:
 
 ```jsonc
 {
   "mcp": {
-    "openpets": {
+    "familiaros": {
       "type": "local",
-      "command": ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"],
+      "command": ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"],
       "enabled": true
     }
   },
-  "instructions": [".opencode/openpets.md"],
-  "plugin": [["@open-pets/opencode@0.0.0", { "pet": "fixer" }]]
+  "instructions": [".opencode/familiaros.md"],
+  "plugin": [["@familiaros/opencode@0.0.0", { "familiar": "fixer" }]]
 }
 ```
 
-- With `--local-dev`, generated MCP config may use `node <current cli dist/index.js> mcp --pet fixer`, but the plugin spec should remain package-based unless a safe local plugin file path policy is implemented in a later phase.
-- The package-based plugin spec must be version-pinned to the same package version used for generated MCP commands, e.g. `@open-pets/opencode@<version>`.
-- The managed instruction file `.opencode/openpets.md` is written with OpenPets managed markers.
+- With `--local-dev`, generated MCP config may use `node <current cli dist/index.js> mcp --familiar fixer`, but the plugin spec should remain package-based unless a safe local plugin file path policy is implemented in a later phase.
+- The package-based plugin spec must be version-pinned to the same package version used for generated MCP commands, e.g. `@familiaros/opencode@<version>`.
+- The managed instruction file `.opencode/familiaros.md` is written with FamiliarOS managed markers.
 - Instruction file writes must be safe:
-  - reject symlinked `.opencode/openpets.md`;
+  - reject symlinked `.opencode/familiaros.md`;
   - reject oversized instruction files;
   - preserve user content outside managed markers;
-  - upsert the managed OpenPets block if the expected path exists without a managed block;
+  - upsert the managed FamiliarOS block if the expected path exists without a managed block;
   - backup before destructive update;
   - temp-file + rename atomic write;
   - no instruction write if config planning fails.
 - CLI output prints:
   - configured agent (`OpenCode`);
   - target project path;
-  - selected pet id/name;
+  - selected familiar id/name;
   - config file path changed;
   - instruction file path changed;
-  - a warning that `.opencode/opencode.jsonc` and `.opencode/openpets.md` can be committed and contain the selected pet id;
+  - a warning that `.opencode/opencode.jsonc` and `.opencode/familiaros.md` can be committed and contain the selected familiar id;
   - restart guidance for OpenCode.
-- Tests cover offline explicit-pet setup, idempotency, preserving unrelated config, custom/foreign conflict refusal, symlink rejection, and Claude regression.
+- Tests cover offline explicit-familiar setup, idempotency, preserving unrelated config, custom/foreign conflict refusal, symlink rejection, and Claude regression.
 
 ## Proposed files/directories
 
@@ -147,14 +147,14 @@ The helper should:
 1. Validate project root.
 2. Select config write target.
 3. Read and classify **all existing project config candidates** because OpenCode can merge top-level and `.opencode` configs.
-4. Fail on custom/foreign/conflicting OpenPets entries anywhere in those candidates.
+4. Fail on custom/foreign/conflicting FamiliarOS entries anywhere in those candidates.
 5. Read the selected write target or `{}`.
-6. Classify selected-target OpenPets entries for idempotent updates.
+6. Classify selected-target FamiliarOS entries for idempotent updates.
 7. Add/update:
-   - `mcp.openpets`;
-   - `instructions` containing `.opencode/openpets.md` once;
-   - `plugin` containing version-pinned `@open-pets/opencode@<version>` once with `{ pet }`.
-8. Plan `.opencode/openpets.md` managed block upsert.
+   - `mcp.familiaros`;
+   - `instructions` containing `.opencode/familiaros.md` once;
+   - `plugin` containing version-pinned `@familiaros/opencode@<version>` once with `{ familiar }`.
+8. Plan `.opencode/familiaros.md` managed block upsert.
 9. Plan safe config writes via Phase 19A helpers.
 10. Execute writes only after all config and instruction write plans have succeeded.
 
@@ -164,12 +164,12 @@ The setup must be two-phase: validate/classify/plan all writes first, then execu
 
 Use the same guidance as Claude memory, adapted for OpenCode:
 
-- OpenPets MCP tools may be available.
-- Use `openpets_say` for meaningful short status/personality messages.
+- FamiliarOS MCP tools may be available.
+- Use `familiaros_say` for meaningful short status/personality messages.
 - Keep messages brief, user-facing, and non-sensitive.
 - Do not include code, logs, secrets, URLs, or file paths.
-- Use `openpets_react` for visual feedback.
-- Use `openpets_status` only when checking availability or target pet.
+- Use `familiaros_react` for visual feedback.
+- Use `familiaros_status` only when checking availability or target familiar.
 - Do not spam every internal step.
 
 ### Conflict policy
@@ -183,7 +183,7 @@ For Phase 19C:
 - `not_installed`: install entries.
 - `custom` / `conflict`: fail clearly and do not write config.
 
-This avoids overwriting user-owned `openpets` entries.
+This avoids overwriting user-owned `familiaros` entries.
 
 If the expected instruction path is present but lacks the managed block, treat it as an instruction `needs_update`: upsert the managed block while preserving existing file content outside managed markers.
 
@@ -191,14 +191,14 @@ If the expected instruction path is present but lacks the managed block, treat i
 
 Reuse existing `resolveConfiguredPet` behavior:
 
-- explicit `--pet` validates syntax only and does not require desktop;
-- omitted `--pet` queries installed pets through local IPC.
+- explicit `--familiar` validates syntax only and does not require desktop;
+- omitted `--familiar` queries installed familiars through local IPC.
 
 ## Risks and tradeoffs
 
-- Project `.opencode/opencode.jsonc` and `.opencode/openpets.md` can be committed. CLI must warn clearly.
+- Project `.opencode/opencode.jsonc` and `.opencode/familiaros.md` can be committed. CLI must warn clearly.
 - Direct JSONC editing risks data loss. Use existing parse guards, backups, temp writes, and no-write-on-error policy.
-- Package-based plugin spec assumes `@open-pets/opencode` is published alongside CLI. This is correct for published mode; local plugin path setup is deferred.
+- Package-based plugin spec assumes `@familiaros/opencode` is published alongside CLI. This is correct for published mode; local plugin path setup is deferred.
 - `--local-dev` only affects MCP command in this phase. Plugin local-dev path is deferred to avoid unsafe path/config churn.
 
 ## Security/privacy notes
@@ -206,33 +206,33 @@ Reuse existing `resolveConfiguredPet` behavior:
 - Do not write outside the project root.
 - Reject symlinked project roots and unsafe config paths.
 - Preserve unrelated OpenCode config.
-- Do not overwrite custom/foreign OpenPets-like entries.
+- Do not overwrite custom/foreign FamiliarOS-like entries.
 - Do not perform partial writes; if any plan fails, no config or instruction file should be written.
 - Do not expose prompts, code, logs, URLs, paths, or secrets in instruction text beyond generic warnings.
 - Tests must use temp directories only.
 
 ## Test/check plan
 
-- `pnpm --filter @open-pets/opencode check`
-- `pnpm --filter @open-pets/cli check`
-- `pnpm --filter @open-pets/claude check`
+- `pnpm --filter @familiaros/opencode check`
+- `pnpm --filter @familiaros/cli check`
+- `pnpm --filter @familiaros/claude check`
 - `pnpm check` after implementation review fixes.
 
 Specific tests:
 
-- `parseConfigureArgs(["--agent", "opencode", "--pet", "fixer"])` works.
+- `parseConfigureArgs(["--agent", "opencode", "--familiar", "fixer"])` works.
 - Unsupported agent still throws.
-- Offline explicit-pet OpenCode setup writes config without calling local IPC.
-- Missing `--pet` still calls pet picker/listing.
-- New project creates `.opencode/opencode.jsonc` and `.opencode/openpets.md`.
+- Offline explicit-familiar OpenCode setup writes config without calling local IPC.
+- Missing `--familiar` still calls familiar picker/listing.
+- New project creates `.opencode/opencode.jsonc` and `.opencode/familiaros.md`.
 - Existing `opencode.json` is preferred over `.opencode/opencode.jsonc` as write target.
 - Existing unrelated config keys/MCP/plugin/instructions are preserved.
 - Conflicts across multiple project config candidate files are detected before writing.
 - Re-running setup is idempotent.
-- Stale managed OpenPets entries are updated.
-- Custom `mcp.openpets` refuses without writing.
-- Custom OpenPets-like plugin/instruction refuses without writing.
-- Existing `.opencode/openpets.md` without managed block gets managed block added while preserving user text.
+- Stale managed FamiliarOS entries are updated.
+- Custom `mcp.familiaros` refuses without writing.
+- Custom FamiliarOS-like plugin/instruction refuses without writing.
+- Existing `.opencode/familiaros.md` without managed block gets managed block added while preserving user text.
 - Instruction symlink/oversized file is rejected without config writes.
 - Symlink project/config paths are rejected.
 - Claude CLI tests still pass.
@@ -241,18 +241,18 @@ Specific tests:
 
 After implementation and review:
 
-1. Run `pnpm --filter @open-pets/cli check`.
+1. Run `pnpm --filter @familiaros/cli check`.
 2. Run `pnpm check`.
 3. In a temporary project, run:
 
 ```bash
-node /path/to/packages/cli/dist/index.js configure --agent opencode --pet fixer --cwd /tmp/openpets-opencode-test --local-dev
+node /path/to/packages/cli/dist/index.js configure --agent opencode --familiar fixer --cwd /tmp/familiaros-opencode-test --local-dev
 ```
 
-4. Confirm `.opencode/opencode.jsonc` contains `mcp.openpets`, `.opencode/openpets.md` instruction path, and `@open-pets/opencode` plugin spec.
-5. Confirm `.opencode/openpets.md` contains OpenPets managed markers.
+4. Confirm `.opencode/opencode.jsonc` contains `mcp.familiaros`, `.opencode/familiaros.md` instruction path, and `@familiaros/opencode` plugin spec.
+5. Confirm `.opencode/familiaros.md` contains FamiliarOS managed markers.
 6. Re-run the command and confirm config remains idempotent.
-7. Add a custom `mcp.openpets` entry and confirm setup refuses without overwriting.
+7. Add a custom `mcp.familiaros` entry and confirm setup refuses without overwriting.
 8. Confirm real user OpenCode config was not touched.
 
 ## Oracle plan review
@@ -270,5 +270,5 @@ Oracle reviewed the initial Phase 19C spec and found blockers:
 - **Fixed:** Required scanning/classifying all existing project config candidates before selecting a write target.
 - **Fixed:** Added safe instruction file write requirements: symlink/size rejection, preserve user content, backup, temp+rename, no write if config planning fails.
 - **Fixed:** Required two-phase plan-all-then-execute sequencing to avoid partial writes.
-- **Fixed:** Required version-pinned `@open-pets/opencode@<version>` plugin spec.
+- **Fixed:** Required version-pinned `@familiaros/opencode@<version>` plugin spec.
 - **Fixed:** Clarified expected instruction path without managed block is `needs_update` and should upsert the managed block while preserving existing content.
diff --git a/docs/phases/phase-19d-opencode-desktop-hardening.md b/docs/phases/phase-19d-opencode-desktop-hardening.md
index b37b13b7..597bd04a 100644
--- a/docs/phases/phase-19d-opencode-desktop-hardening.md
+++ b/docs/phases/phase-19d-opencode-desktop-hardening.md
@@ -17,7 +17,7 @@ This is the final OpenCode integration phase after:
 - No OpenCode source changes under `v1/opencode/`.
 - No new public MCP tools.
 - No new network listener or external SSE watcher.
-- No pet install/remove/default controls via OpenCode.
+- No familiar install/remove/default controls via OpenCode.
 
 ## User-visible/manual outcome
 
@@ -26,15 +26,15 @@ The Integrations window shows an OpenCode card next to Claude Code.
 Users can open OpenCode details and:
 
 - See best-effort OpenCode detection/status.
-- Select pet routing.
-- Install/update/remove global OpenPets OpenCode setup.
+- Select familiar routing.
+- Install/update/remove global FamiliarOS OpenCode setup.
 - Inspect/copy global MCP/instructions/plugin config preview.
 - See exact global files that would be touched.
 
 Desktop copy must clearly state that OpenCode desktop setup is **global**. Users who want per-project setup should use:
 
 ```bash
-openpets configure --agent opencode --pet <id>
+familiaros configure --agent opencode --familiar <id>
 ```
 
 ## Acceptance criteria
@@ -53,7 +53,7 @@ openpets configure --agent opencode --pet <id>
   - scan all global candidates before writing;
   - refuse custom/foreign entries anywhere;
   - preserve the effective owner file for global `plugin`/`instructions` arrays because higher-precedence arrays can shadow lower arrays;
-  - if managed OpenPets entries live in a stale higher-precedence overlay while user arrays live lower, migrate managed entries to the user array owner and clean the stale managed overlay;
+  - if managed FamiliarOS entries live in a stale higher-precedence overlay while user arrays live lower, migrate managed entries to the user array owner and clean the stale managed overlay;
   - refuse if user `plugin` and `instructions` arrays live in different global config files, or if a higher-precedence empty array shadows lower user entries;
   - otherwise choose the single managed owner file if one exists;
   - fail if managed entries span multiple global files;
@@ -62,31 +62,31 @@ openpets configure --agent opencode --pet <id>
 - No global OpenCode config write happens without explicit user action.
 - OpenCode absent on `PATH` does not block preview/status; it only affects the detection message.
 - Desktop global setup writes/updates:
-  - global config `mcp.openpets`;
-  - global OpenPets instructions file;
-  - global `plugin` spec for version-pinned `@open-pets/opencode@<version>`.
+  - global config `mcp.familiaros`;
+  - global FamiliarOS instructions file;
+  - global `plugin` spec for version-pinned `@familiaros/opencode@<version>`.
 - Global setup uses bundled command mode when packaged and local mode in dev where appropriate.
-- Published plugin specs use the `@open-pets/opencode` package version, or the shared release version if the workspace moves to one synchronized release version. Do not derive the plugin package version from an unrelated Electron app-only version.
+- Published plugin specs use the `@familiaros/opencode` package version, or the shared release version if the workspace moves to one synchronized release version. Do not derive the plugin package version from an unrelated Electron app-only version.
 - Dev/local absolute-path command mode is developer-only and must only be used behind the existing local-dev toggle. Real/default global setup uses published packages in dev and bundled CLI command mode in packaged desktop.
-- Bundled MCP command is explicit: `node <app.asar.unpacked>/node_modules/@open-pets/cli/dist/index.js mcp --pet <id>`.
-- Desktop packaged dependencies must include `@open-pets/cli` for bundled global MCP setup.
+- Bundled MCP command is explicit: `node <app.asar.unpacked>/node_modules/@familiaros/cli/dist/index.js mcp --familiar <id>`.
+- Desktop packaged dependencies must include `@familiaros/cli` for bundled global MCP setup.
 - Because OpenCode will spawn `node`, bundled setup must warn/block clearly if `node` is unavailable on PATH, matching the Claude packaged command policy.
-- Plugin config remains published/version-pinned `@open-pets/opencode@<version>` in this phase. The packaged desktop may contain/import `@open-pets/opencode` for previews/smoke checks, but global OpenCode itself will resolve the published plugin package unless a future bundled plugin path policy is added.
+- Plugin config remains published/version-pinned `@familiaros/opencode@<version>` in this phase. The packaged desktop may contain/import `@familiaros/opencode` for previews/smoke checks, but global OpenCode itself will resolve the published plugin package unless a future bundled plugin path policy is added.
 - UI/docs must explain that OpenCode may need npm/network access to resolve the published OpenCode plugin package unless it is already cached/installed.
 - Bundled command paths must point outside true `app.asar` into `app.asar.unpacked` resources.
-- Packaged resources include `@open-pets/opencode`, `@open-pets/agent-events`, `@open-pets/client`, CLI/MCP dependencies, and plugin server export.
+- Packaged resources include `@familiaros/opencode`, `@familiaros/agent-events`, `@familiaros/client`, CLI/MCP dependencies, and plugin server export.
 - Packaged smoke checks verify:
-  - `@open-pets/opencode/dist/plugin.js` exists;
-  - `@open-pets/opencode/package.json` exists;
-  - `@open-pets/agent-events/dist/index.js` exists;
+  - `@familiaros/opencode/dist/plugin.js` exists;
+  - `@familiaros/opencode/package.json` exists;
+  - `@familiaros/agent-events/dist/index.js` exists;
   - dynamic import of the packaged OpenCode plugin server works.
-- Remove action removes only OpenPets-managed global entries/blocks and preserves unrelated OpenCode config.
-- Removal writes config first, then cleans the now-unused instruction block/file. If instruction cleanup fails after config removal, stale unused OpenPets text is safer than leaving config pointing at missing instructions.
+- Remove action removes only FamiliarOS-managed global entries/blocks and preserves unrelated OpenCode config.
+- Removal writes config first, then cleans the now-unused instruction block/file. If instruction cleanup fails after config removal, stale unused FamiliarOS text is safer than leaving config pointing at missing instructions.
 - Managed-entry signatures are:
-  - MCP: `mcp.openpets` with `type: "local"`, `enabled: true`, and command matching the OpenPets CLI published/local/bundled command shapes for `mcp` plus optional `--pet <id>`;
-  - instructions: exactly `<global OpenCode config dir>/openpets.md` for desktop global setup and a file containing the OpenPets managed markers;
-  - plugin: `@open-pets/opencode` or `@open-pets/opencode@<version>`, optionally as `[spec, { pet }]`.
-  - Any OpenPets-like entry that does not match these signatures is custom/foreign and must be refused rather than overwritten or removed.
+  - MCP: `mcp.familiaros` with `type: "local"`, `enabled: true`, and command matching the FamiliarOS CLI published/local/bundled command shapes for `mcp` plus optional `--familiar <id>`;
+  - instructions: exactly `<global OpenCode config dir>/familiaros.md` for desktop global setup and a file containing the FamiliarOS managed markers;
+  - plugin: `@familiaros/opencode` or `@familiaros/opencode@<version>`, optionally as `[spec, { familiar }]`.
+  - Any FamiliarOS-like entry that does not match these signatures is custom/foreign and must be refused rather than overwritten or removed.
 - Config, instruction, temp, and backup files use private `0600` modes where supported; created config/instruction directories use private `0700` modes where supported.
 - Docs explain:
   - CLI project setup vs desktop global setup;
@@ -97,7 +97,7 @@ openpets configure --agent opencode --pet <id>
 
 ## Release checklist
 
-- Confirm the version-pinned `@open-pets/opencode@<version>` written by desktop global setup has been published to npm before shipping a packaged desktop release that advertises OpenCode setup.
+- Confirm the version-pinned `@familiaros/opencode@<version>` written by desktop global setup has been published to npm before shipping a packaged desktop release that advertises OpenCode setup.
 
 ## Proposed files/directories
 
@@ -130,7 +130,7 @@ Use OpenCode global config discovery from Phase 19A:
 - platform/XDG default config dir;
 - candidate files `config.json`, `opencode.json`, `opencode.jsonc`.
 
-If existing global `plugin` or `instructions` arrays are present, write OpenPets into the effective owner file for those arrays so OpenPets does not create a higher-precedence array that shadows user entries. If those user arrays are split across files, or if a higher-precedence empty array already shadows lower user entries, refuse with a manual consolidation message. If no array owner exists, update an existing managed owner, otherwise write the highest-precedence existing global config file (`opencode.jsonc`, then `opencode.json`, then `config.json`). If no global config exists, create global `opencode.jsonc` in the OpenCode config dir.
+If existing global `plugin` or `instructions` arrays are present, write FamiliarOS into the effective owner file for those arrays so FamiliarOS does not create a higher-precedence array that shadows user entries. If those user arrays are split across files, or if a higher-precedence empty array already shadows lower user entries, refuse with a manual consolidation message. If no array owner exists, update an existing managed owner, otherwise write the highest-precedence existing global config file (`opencode.jsonc`, then `opencode.json`, then `config.json`). If no global config exists, create global `opencode.jsonc` in the OpenCode config dir.
 
 ### Global setup data model
 
@@ -154,7 +154,7 @@ Use a two-phase plan-all-then-execute model:
 
 1. Validate global config dir/path safety.
 2. Read/classify global candidates.
-3. Refuse custom/foreign OpenPets-like entries.
+3. Refuse custom/foreign FamiliarOS-like entries.
 4. Plan config update.
 5. Plan instruction file upsert.
 6. Execute instruction write before config write.
@@ -165,10 +165,10 @@ Instruction upsert must preserve content outside managed markers.
 
 Removal should:
 
-- remove `mcp.openpets` only if managed;
-- remove OpenPets instruction path from `instructions` only if managed;
-- remove OpenPets plugin spec only if managed;
-- remove only OpenPets managed block from instruction file;
+- remove `mcp.familiaros` only if managed;
+- remove FamiliarOS instruction path from `instructions` only if managed;
+- remove FamiliarOS plugin spec only if managed;
+- remove only FamiliarOS managed block from instruction file;
 - preserve unrelated config and user text.
 
 If entries are custom/foreign, show a warning and do not remove.
@@ -181,7 +181,7 @@ Removal must also use two-phase destructive write safety:
 4. Fail if managed entries span multiple global files.
 5. Plan all config/instruction writes before executing.
 6. Backup + atomic-write config and instruction changes.
-7. Preserve user text outside OpenPets managed instruction markers.
+7. Preserve user text outside FamiliarOS managed instruction markers.
 
 ### UI
 
@@ -190,7 +190,7 @@ Add enabled OpenCode card in the integrations grid.
 OpenCode detail can be simpler than Claude's initial UI but must include:
 
 - status card;
-- pet routing select;
+- familiar routing select;
 - global scope warning;
 - install/update button;
 - remove button;
@@ -203,9 +203,9 @@ OpenCode detail can be simpler than Claude's initial UI but must include:
 
 Desktop `package.json` should include workspace dependencies needed at runtime:
 
-- `@open-pets/cli`;
-- `@open-pets/opencode`;
-- `@open-pets/agent-events` if not pulled transitively in packaged output.
+- `@familiaros/cli`;
+- `@familiaros/opencode`;
+- `@familiaros/agent-events` if not pulled transitively in packaged output.
 
 Packaging checks should assert these are built and present.
 
@@ -213,9 +213,9 @@ Packaging checks should assert these are built and present.
 
 Update docs with OpenCode support:
 
-- `openpets configure --agent opencode --pet fixer` for project setup.
+- `familiaros configure --agent opencode --familiar fixer` for project setup.
 - Desktop OpenCode setup is global.
-- OpenPets speech safety and MCP tool usage remain unchanged.
+- FamiliarOS speech safety and MCP tool usage remain unchanged.
 
 ## Risks and tradeoffs
 
@@ -229,15 +229,15 @@ Update docs with OpenCode support:
 
 - Never write global config without explicit user action.
 - Preserve unrelated global OpenCode config.
-- Do not overwrite custom/foreign OpenPets-like entries.
+- Do not overwrite custom/foreign FamiliarOS-like entries.
 - Do not create network listeners.
-- Keep speech guidance: no code, logs, secrets, URLs, or file paths in pet speech.
+- Keep speech guidance: no code, logs, secrets, URLs, or file paths in familiar speech.
 - Packaged paths must not point into true `app.asar` for executable/plugin resources.
 
 ## Test/check plan
 
-- `pnpm --filter @open-pets/opencode check`
-- `pnpm --filter @open-pets/desktop check`
+- `pnpm --filter @familiaros/opencode check`
+- `pnpm --filter @familiaros/desktop check`
 - `pnpm check`
 
 Specific checks:
@@ -254,12 +254,12 @@ Specific checks:
 - Remove preserves unrelated config and user instruction text.
 - Managed entries spanning multiple global candidate files fail safely.
 - Invalid JSON/JSONC or oversized global candidates block setup/removal writes.
-- Stale managed MCP/plugin/pet/version entries update cleanly.
+- Stale managed MCP/plugin/familiar/version entries update cleanly.
 - Packaged generated MCP command contains `app.asar.unpacked`, never true `app.asar`.
 - Packaged Node-on-PATH block/warning path exists in desktop install handling and remains a manual packaged-app verification item.
 - Global removal creates backups and uses temp/atomic writes.
 - Copy preview action copies the OpenCode config preview without requiring writes.
-- Packaging contract checks built `@open-pets/opencode` and `@open-pets/agent-events` resources.
+- Packaging contract checks built `@familiaros/opencode` and `@familiaros/agent-events` resources.
 - Packaged smoke imports OpenCode server plugin export.
 - Docs mention CLI project setup vs desktop global setup.
 
@@ -275,8 +275,8 @@ After implementation and review:
 6. Open OpenCode detail.
 7. Confirm it says desktop setup is global.
 8. Install OpenCode global integration in a temp `OPENCODE_CONFIG_DIR` environment if practical.
-9. Confirm global config has OpenPets MCP/instructions/plugin entries.
-10. Confirm remove preserves unrelated config and removes only managed OpenPets entries.
+9. Confirm global config has FamiliarOS MCP/instructions/plugin entries.
+10. Confirm remove preserves unrelated config and removes only managed FamiliarOS entries.
 11. Package dir build if practical and confirm packaged smoke checks pass.
 
 ## Oracle plan review
@@ -293,7 +293,7 @@ Oracle reviewed the initial Phase 19D spec and found blockers:
 
 - **Fixed:** Added explicit global helper contract for safe all-candidate scanning, owner selection, custom refusal, and `opencode.jsonc` creation.
 - **Fixed:** Added two-phase removal safety contract with backups/atomic writes and user text preservation.
-- **Fixed:** Defined bundled MCP command via packaged `@open-pets/cli` and Node-on-PATH requirement.
+- **Fixed:** Defined bundled MCP command via packaged `@familiaros/cli` and Node-on-PATH requirement.
 - **Fixed:** Clarified plugin config remains published/version-pinned while packaged plugin resources are for desktop imports/smoke checks in this phase.
 - **Fixed:** Added explicit global setup/removal fixture coverage requirements.
 
@@ -302,4 +302,4 @@ Oracle reviewed the initial Phase 19D spec and found blockers:
 - Desktop OpenCode global setup, removal, preview, and copy actions are implemented in the Integrations window.
 - Automated checks now cover OpenCode global install/remove status transitions, JSONC preview planning, bundled `app.asar.unpacked` command shape, strict managed-entry classification, packaged resource presence, and plugin smoke import.
 - `pnpm check` passed after implementation review and strict managed-entry hardening.
-- Remaining release-time manual item: confirm the version-pinned `@open-pets/opencode@<version>` is published before shipping a desktop build that advertises OpenCode global setup.
+- Remaining release-time manual item: confirm the version-pinned `@familiaros/opencode@<version>` is published before shipping a desktop build that advertises OpenCode global setup.
diff --git a/docs/phases/phase-20-scalable-pet-catalog.md b/docs/phases/phase-20-scalable-pet-catalog.md
index 659dbaf3..8c9beb86 100644
--- a/docs/phases/phase-20-scalable-pet-catalog.md
+++ b/docs/phases/phase-20-scalable-pet-catalog.md
@@ -1,55 +1,55 @@
-# Phase 20: Scalable Pet Catalog and Lightweight Picker Images
+# Phase 20: Scalable Familiar Catalog and Lightweight Picker Images
 
 ## Goal
 
-Scale the public pet catalog and desktop Pet Manager beyond 1,000 pets without loading full spritesheets for every visible card.
+Scale the public familiar catalog and desktop Familiar Manager beyond 1,000 familiars without loading full spritesheets for every visible card.
 
 The clean solution is to move lightweight preview generation into the `web/` catalog pipeline and have desktop consume paginated catalog metadata with small thumbnail assets.
 
 ## Non-goals
 
-- Do not change Codex/local pet discovery, import, preview inlining, or `~/.codex/pets` behavior in this phase.
-- Do not change installed pet runtime rendering; installed pets still use `spritesheet.webp` after install.
+- Do not change Codex/local familiar discovery, import, preview inlining, or `~/.codex/familiars` behavior in this phase.
+- Do not change installed familiar runtime rendering; installed familiars still use `spritesheet.webp` after install.
 - Do not remove or break `catalog.v2.json`; keep it available for older desktop clients.
 - Do not make the Electron renderer construct untrusted image URLs independently.
 - Do not broaden desktop CSP beyond the exact image origins needed.
 
 ## Problem
 
-The current desktop Pet Manager reads `catalog.v2.json`, then uses each pet's `preview` URL as a card preview. Today `web/scripts/*` writes `preview` as the full spritesheet:
+The current desktop Familiar Manager reads `catalog.v2.json`, then uses each familiar's `preview` URL as a card preview. Today `web/scripts/*` writes `preview` as the full spritesheet:
 
 ```js
-preview: `${PUBLIC_BASE_URL}${pet.spritesheetPath}`
+preview: `${PUBLIC_BASE_URL}${familiar.spritesheetPath}`
 ```
 
 That means the picker can request hundreds or thousands of full files like:
 
 ```text
-https://openpets.dev/pets/<slug>/spritesheet.webp
+https://familiaros.dev/familiars/<slug>/spritesheet.webp
 ```
 
-With a 1,000+ pet catalog, this creates excessive network, decode, memory, and layout work. Desktop-side lazy loading helps, but it does not solve the root issue: gallery cards need tiny thumbnails, not full runtime spritesheets.
+With a 1,000+ familiar catalog, this creates excessive network, decode, memory, and layout work. Desktop-side lazy loading helps, but it does not solve the root issue: gallery cards need tiny thumbnails, not full runtime spritesheets.
 
 ## Desired outcome
 
-- Public catalog supports 1,000+ pets without a huge single JSON payload.
-- Pet Manager initially loads only a small page of metadata and small thumbnails.
-- Pet Manager search works across the full public catalog, not only already-rendered pages.
-- Full spritesheets are fetched only when needed for install/runtime or, optionally, selected-pet detail preview.
-- Pet Manager keeps existing filters, including `Codex`, and adds the same high-level public catalog filters already used on the web: `Western` and `Asian`.
+- Public catalog supports 1,000+ familiars without a huge single JSON payload.
+- Familiar Manager initially loads only a small page of metadata and small thumbnails.
+- Familiar Manager search works across the full public catalog, not only already-rendered pages.
+- Full spritesheets are fetched only when needed for install/runtime or, optionally, selected-familiar detail preview.
+- Familiar Manager keeps existing filters, including `Codex`, and adds the same high-level public catalog filters already used on the web: `Western` and `Asian`.
 - Existing desktop clients can continue using `catalog.v2.json`.
-- `catalog.v2.json` is statically limited to 300 pets while `catalog.v3` contains all eligible public pets.
-- Codex/local pet behavior remains unchanged.
+- `catalog.v2.json` is statically limited to 300 familiars while `catalog.v3` contains all eligible public familiars.
+- Codex/local familiar behavior remains unchanged.
 
 ## Proposed asset model
 
-For every public catalog pet under `web/public/pets/<slug>/`, generate and publish:
+For every public catalog familiar under `web/public/familiars/<slug>/`, generate and publish:
 
 ```text
 spritesheet.webp  # existing full runtime/install asset
 thumb.webp        # new tiny static thumbnail for gallery cards
 preview.webp      # optional small animated/detail preview, if cheap to generate
-<petId>.zip       # existing install package, served from zip.openpets.dev
+<petId>.zip       # existing install package, served from zip.familiaros.dev
 ```
 
 Recommended budgets:
@@ -58,13 +58,13 @@ Recommended budgets:
 - `preview.webp`: optional short idle animation or selected-detail image, target < 50-100 KB.
 - `spritesheet.webp`: unchanged; used for installs/runtime, not bulk gallery cards.
 
-For the first implementation, generate `thumb.webp` and defer `preview.webp`. Desktop uses `thumbnail` in cards and fetches `spritesheet` only for selected-pet detail animation, install/runtime paths, or existing installed-pet rendering.
+For the first implementation, generate `thumb.webp` and defer `preview.webp`. Desktop uses `thumbnail` in cards and fetches `spritesheet` only for selected-familiar detail animation, install/runtime paths, or existing installed-familiar rendering.
 
 ## Proposed catalog model
 
-Keep `public/pets/catalog.v2.json` available for compatibility, but statically cap it to 300 pets using the same stable catalog ordering as the web gallery/manifest. `catalog.v3` is the uncapped full-catalog contract.
+Keep `public/familiars/catalog.v2.json` available for compatibility, but statically cap it to 300 familiars using the same stable catalog ordering as the web gallery/manifest. `catalog.v3` is the uncapped full-catalog contract.
 
-Add `public/pets/catalog.v3.json` as an index:
+Add `public/familiars/catalog.v3.json` as an index:
 
 ```json
 {
@@ -72,7 +72,7 @@ Add `public/pets/catalog.v3.json` as an index:
   "generatedAt": "2026-05-12T00:00:00.000Z",
   "total": 2500,
   "pageSize": 100,
-  "search": "https://openpets.dev/pets/catalog.v3/search.json",
+  "search": "https://familiaros.dev/familiars/catalog.v3/search.json",
   "filters": {
     "categories": [
       { "id": "western", "label": "Western", "count": 1250 },
@@ -80,13 +80,13 @@ Add `public/pets/catalog.v3.json` as an index:
     ]
   },
   "pages": [
-    "https://openpets.dev/pets/catalog.v3/page-000.json",
-    "https://openpets.dev/pets/catalog.v3/page-001.json"
+    "https://familiaros.dev/familiars/catalog.v3/page-000.json",
+    "https://familiaros.dev/familiars/catalog.v3/page-001.json"
   ]
 }
 ```
 
-Add a lightweight searchable metadata index under `public/pets/catalog.v3/search.json` so desktop can search across all pets without loading every catalog page or thumbnail:
+Add a lightweight searchable metadata index under `public/familiars/catalog.v3/search.json` so desktop can search across all familiars without loading every catalog page or thumbnail:
 
 ```json
 {
@@ -95,20 +95,20 @@ Add a lightweight searchable metadata index under `public/pets/catalog.v3/search
   "total": 2500,
   "pageSize": 250,
   "pages": [
-    "https://openpets.dev/pets/catalog.v3/search-page-000.json",
-    "https://openpets.dev/pets/catalog.v3/search-page-001.json"
+    "https://familiaros.dev/familiars/catalog.v3/search-page-000.json",
+    "https://familiaros.dev/familiars/catalog.v3/search-page-001.json"
   ]
 }
 ```
 
-Add bounded search metadata pages under `public/pets/catalog.v3/search-page-XXX.json`:
+Add bounded search metadata pages under `public/familiars/catalog.v3/search-page-XXX.json`:
 
 ```json
 {
   "version": 3,
   "page": 0,
   "pageSize": 250,
-  "pets": [
+  "familiars": [
     {
       "id": "snoopy",
       "displayName": "Snoopy",
@@ -120,24 +120,24 @@ Add bounded search metadata pages under `public/pets/catalog.v3/search-page-XXX.
 }
 ```
 
-The search metadata intentionally omits image and zip URLs. `searchText` should be normalized and capped during generation so each search metadata page remains within the response budget. Desktop uses search metadata only to find matching IDs/categories and then asks the main process to load the relevant validated catalog page(s) before rendering results or installing a pet.
+The search metadata intentionally omits image and zip URLs. `searchText` should be normalized and capped during generation so each search metadata page remains within the response budget. Desktop uses search metadata only to find matching IDs/categories and then asks the main process to load the relevant validated catalog page(s) before rendering results or installing a familiar.
 
-Add paginated page files under `public/pets/catalog.v3/`:
+Add paginated page files under `public/familiars/catalog.v3/`:
 
 ```json
 {
   "version": 3,
   "page": 0,
   "pageSize": 100,
-  "pets": [
+  "familiars": [
     {
       "id": "snoopy",
       "displayName": "Snoopy",
       "description": "A tiny black-and-white beagle with a red collar for calm coding sessions.",
-      "thumbnail": "https://openpets.dev/pets/snoopy-23e05847/thumb.webp",
-      "preview": "https://openpets.dev/pets/snoopy-23e05847/preview.webp",
-      "spritesheet": "https://openpets.dev/pets/snoopy-23e05847/spritesheet.webp",
-      "zip": "https://zip.openpets.dev/pets/snoopy-23e05847/snoopy.zip",
+      "thumbnail": "https://familiaros.dev/familiars/snoopy-23e05847/thumb.webp",
+      "preview": "https://familiaros.dev/familiars/snoopy-23e05847/preview.webp",
+      "spritesheet": "https://familiaros.dev/familiars/snoopy-23e05847/spritesheet.webp",
+      "zip": "https://zip.familiaros.dev/familiars/snoopy-23e05847/snoopy.zip",
       "category": "western",
       "subcategory": "cartoons"
     }
@@ -148,78 +148,78 @@ Add paginated page files under `public/pets/catalog.v3/`:
 Fields:
 
 - `id`: required; this is the install-safe `installId`, not the upstream/manifest UUID-like `id`.
-- `thumbnail`: required for v3 catalog pets.
+- `thumbnail`: required for v3 catalog familiars.
 - `preview`: optional; desktop must tolerate missing/failed preview.
 - `spritesheet`: optional for gallery use, but useful for detail/runtime preview if explicitly selected.
 - `zip`: required for installation.
-- `category`: required for v3 public catalog pets and currently limited to `western` or `asian`.
+- `category`: required for v3 public catalog familiars and currently limited to `western` or `asian`.
 - `subcategory`: optional; preserve existing web metadata where present.
 
 V3 index invariants:
 
 - Maximum index response size: 256 KB.
 - Maximum page response size: 256 KB.
-- Default page size: 100 pets.
-- Maximum page size: 200 pets.
+- Default page size: 100 familiars.
+- Maximum page size: 200 familiars.
 - Maximum page count: 100 pages for this phase.
-- `total` must equal the sum of pets across all pages during generation.
-- Pet IDs must be unique across all pages.
-- Page URLs must match `https://openpets.dev/pets/catalog.v3/page-<3 digit>.json`.
-- Search URL must match `https://openpets.dev/pets/catalog.v3/search.json`.
-- Search page URLs must match `https://openpets.dev/pets/catalog.v3/search-page-<3 digit>.json`.
+- `total` must equal the sum of familiars across all pages during generation.
+- Familiar IDs must be unique across all pages.
+- Page URLs must match `https://familiaros.dev/familiars/catalog.v3/page-<3 digit>.json`.
+- Search URL must match `https://familiaros.dev/familiars/catalog.v3/search.json`.
+- Search page URLs must match `https://familiaros.dev/familiars/catalog.v3/search-page-<3 digit>.json`.
 - Search index and search page responses must each stay within the 256 KB response budget.
 - Deploy ordering must publish page files before publishing the index that references them.
 
 ## Public catalog filters
 
-The web app already groups public pets into two top-level filters: `Western` and `Asian`. V3 should carry this as canonical metadata so desktop does not infer categories from names, slugs, descriptions, or paths.
+The web app already groups public familiars into two top-level filters: `Western` and `Asian`. V3 should carry this as canonical metadata so desktop does not infer categories from names, slugs, descriptions, or paths.
 
 Filter contract:
 
-- `category` is required for every v3 public catalog pet.
+- `category` is required for every v3 public catalog familiar.
 - Allowed initial values are exactly:
   - `western`
   - `asian`
 - Desktop labels these as `Western` and `Asian`.
 - Desktop keeps existing filters and adds category filters. Button order/layout should be compact and right-aligned: `All`, `Western`, `Asian`, `Codex`, `Installed`.
-- `Codex` filter behavior must stay unchanged from the current Pet Manager.
-- If a v3 pet has a missing/unknown category, validation should reject the page or mark the pet unavailable rather than guessing.
+- `Codex` filter behavior must stay unchanged from the current Familiar Manager.
+- If a v3 familiar has a missing/unknown category, validation should reject the page or mark the familiar unavailable rather than guessing.
 - v2 fallback does not provide reliable category filtering; when using v2 fallback, desktop should hide `Western`/`Asian` filters or show them disabled.
-- Codex/local-only pets are not part of this category filter contract in this phase. If shown in the same grid, they continue to appear under the existing `Codex` filter and under `All`/`Installed` when applicable, but not under `Western`/`Asian` unless they correspond to a catalog pet with v3 category metadata.
+- Codex/local-only familiars are not part of this category filter contract in this phase. If shown in the same grid, they continue to appear under the existing `Codex` filter and under `All`/`Installed` when applicable, but not under `Western`/`Asian` unless they correspond to a catalog familiar with v3 category metadata.
 
 Category source rules:
 
-- `web/scripts/import-reviewed-pets.js` already validates reviewed-pet `category`; v3 must preserve it.
-- `web/scripts/sync-pets.js` must preserve category from an existing manifest entry when present.
-- `web/scripts/sync-local-pets.js` must preserve category from the existing generated/manifest entry when present.
-- Any pet still missing `western`/`asian` after preservation is excluded from v3 and logged, while v2 remains unchanged for compatibility.
+- `web/scripts/import-reviewed-familiars.js` already validates reviewed-familiar `category`; v3 must preserve it.
+- `web/scripts/sync-familiars.js` must preserve category from an existing manifest entry when present.
+- `web/scripts/sync-local-familiars.js` must preserve category from the existing generated/manifest entry when present.
+- Any familiar still missing `western`/`asian` after preservation is excluded from v3 and logged, while v2 remains unchanged for compatibility.
 - Generation must not infer category from names, slugs, descriptions, upstream source, or folder paths.
 
 ## Web implementation plan
 
 Update all public catalog writers that currently emit `catalog.v2.json`:
 
-- `web/scripts/sync-pets.js`
-- `web/scripts/import-reviewed-pets.js`
-- `web/scripts/sync-local-pets.js`
+- `web/scripts/sync-familiars.js`
+- `web/scripts/import-reviewed-familiars.js`
+- `web/scripts/sync-local-familiars.js`
 
 Tasks:
 
 1. Add shared helpers for catalog asset paths and v3 output shape.
-2. Generate `thumb.webp` for each public catalog pet if missing or stale.
+2. Generate `thumb.webp` for each public catalog familiar if missing or stale.
 3. Defer `preview.webp` until after thumbnail/search/paging is stable.
-4. Continue writing `catalog.v2.json` as a backward-compatible subset capped to 300 pets.
-5. Write `catalog.v3.json` plus `catalog.v3/page-XXX.json` files for all eligible public pets.
+4. Continue writing `catalog.v2.json` as a backward-compatible subset capped to 300 familiars.
+5. Write `catalog.v3.json` plus `catalog.v3/page-XXX.json` files for all eligible public familiars.
 6. Write `catalog.v3/search.json` for full-catalog desktop search.
-7. Keep zip URLs on `zip.openpets.dev` unchanged.
-8. Include the existing web category metadata in every v3 pet as `category: "western" | "asian"`.
+7. Keep zip URLs on `zip.familiaros.dev` unchanged.
+8. Include the existing web category metadata in every v3 familiar as `category: "western" | "asian"`.
 9. Add validation that every v3 page item has safe `id`, `thumbnail`, `zip`, and known `category` fields.
 10. Add category counts to the v3 index so desktop can show correct filters before every page is loaded.
 
 Thumbnail generation options:
 
 - Preferred: use `sharp` in the web workspace to crop/extract the universal spritesheet idle first frame from the 8-column by 9-row spritesheet and resize to a small static WebP.
-- Fallback: if sprite-frame extraction is unreliable for a pet, create a small resized/cropped static thumbnail from the top-left/idle frame area and log the fallback.
+- Fallback: if sprite-frame extraction is unreliable for a familiar, create a small resized/cropped static thumbnail from the top-left/idle frame area and log the fallback.
 - Stale detection should be deterministic: regenerate during sync/import or compare stored content hashes. Do not rely only on filesystem mtimes.
 - Generation should fail or loudly warn if thumbnails exceed the agreed byte/dimension budget.
 
@@ -227,16 +227,16 @@ Thumbnail generation options:
 
 Add a new desktop catalog path while keeping v2 fallback:
 
-1. Fetch `https://openpets.dev/pets/catalog.v3.json` first.
+1. Fetch `https://familiaros.dev/familiars/catalog.v3.json` first.
 2. Validate the index response size and exact final URL.
-3. Fetch the first page only on initial Pet Manager open.
-4. Fetch the lightweight v3 search index when the user searches, or eagerly after initial open if cheap enough, so search can find pets across the full catalog.
+3. Fetch the first page only on initial Familiar Manager open.
+4. Fetch the lightweight v3 search index when the user searches, or eagerly after initial open if cheap enough, so search can find familiars across the full catalog.
 5. Load additional pages automatically as the user scrolls near the bottom of the grid. Keep an explicit "Load more" fallback for accessibility/failure recovery.
 6. Render card images from `thumbnail`, not `preview`/`spritesheet`.
 7. Preserve the existing `Codex` filter behavior and add compact right-aligned filters ordered: `All`, `Western`, `Asian`, `Codex`, `Installed`.
-8. Move the catalog count/status label to the bottom corner of Pet Manager. Keep it minimal, e.g. `123 pets`; remove `Live` wording and remove the Codex count from this label.
+8. Move the catalog count/status label to the bottom corner of Familiar Manager. Keep it minimal, e.g. `123 familiars`; remove `Live` wording and remove the Codex count from this label.
 9. Apply `Western`/`Asian` filters using validated v3 `category` metadata only.
-10. On selected-pet detail, fetch/use the validated `spritesheet` URL to show animation. Do not fetch spritesheets for thumbnail cards or mini card previews.
+10. On selected-familiar detail, fetch/use the validated `spritesheet` URL to show animation. Do not fetch spritesheets for thumbnail cards or mini card previews.
 11. If only a thumbnail is loaded and the selected-detail spritesheet has not loaded yet, show the thumbnail/placeholder until the spritesheet is available.
 12. Fall back to v2 when v3 is unavailable.
 13. Keep all remote image URLs main-process validated before exposing them to preload.
@@ -246,8 +246,8 @@ Main-process data contract:
 - Add a paged v3 catalog UI state instead of requiring preload to know remote page URLs.
 - Main process owns index/page/search fetch, validation, caching, selected-detail spritesheet URL exposure, and install lookup.
 - Renderer search requests must be answered from validated main-process search/page data; preload must not construct page, thumbnail, spritesheet, or zip URLs.
-- `installPet(id)` must be able to resolve validated v3 metadata for pets outside page 0 by using a main-process cache, the search index page mapping, or by fetching the needed validated page/index data.
-- Installed catalog pets that are not in the first loaded page must still retain usable installed-state rows; detail/category/thumbnail can be enriched as pages load.
+- `installPet(id)` must be able to resolve validated v3 metadata for familiars outside page 0 by using a main-process cache, the search index page mapping, or by fetching the needed validated page/index data.
+- Installed catalog familiars that are not in the first loaded page must still retain usable installed-state rows; detail/category/thumbnail can be enriched as pages load.
 
 Renderer behavior:
 
@@ -256,23 +256,23 @@ Renderer behavior:
 - Limit concurrent remote image loads.
 - Use async decoding and no referrer.
 - Keep graceful empty/failure surfaces for thumbnail load errors.
-- If only a thumbnail is available for a catalog pet, do not show fake animated mini state previews. Fetch the selected-detail spritesheet on selection for the main animation and hide/degrade mini state previews until a real spritesheet is available.
-- Do not change Codex/local pet rendering or import behavior in this phase.
+- If only a thumbnail is available for a catalog familiar, do not show fake animated mini state previews. Fetch the selected-detail spritesheet on selection for the main animation and hide/degrade mini state previews until a real spritesheet is available.
+- Do not change Codex/local familiar rendering or import behavior in this phase.
 
 ## Implementation specification
 
 This phase is implemented across both repositories in this workspace:
 
-- Root OpenPets desktop app: `apps/desktop/**`.
+- Root FamiliarOS desktop app: `apps/desktop/**`.
 - Nested web catalog project: `web/**`.
 
 ### Web catalog generation
 
 Add a shared ESM helper module, tentatively `web/scripts/catalog-v3-utils.js`, and use it from:
 
-- `web/scripts/sync-pets.js`
-- `web/scripts/import-reviewed-pets.js`
-- `web/scripts/sync-local-pets.js`
+- `web/scripts/sync-familiars.js`
+- `web/scripts/import-reviewed-familiars.js`
+- `web/scripts/sync-local-familiars.js`
 
 The helper owns constants and deterministic generation behavior:
 
@@ -288,37 +288,37 @@ The helper owns constants and deterministic generation behavior:
 
 The helper exposes functions equivalent to:
 
-- `writeCatalogArtifacts({ pets, publicPetsDir, v2CatalogFile, generatedAt })`
-- `generateThumbnailIfNeeded({ pet, publicPetsDir })`
-- `toV2Catalog(pets, generatedAt)`
-- `toV3Artifacts(pets, generatedAt)`
+- `writeCatalogArtifacts({ familiars, publicPetsDir, v2CatalogFile, generatedAt })`
+- `generateThumbnailIfNeeded({ familiar, publicPetsDir })`
+- `toV2Catalog(familiars, generatedAt)`
+- `toV3Artifacts(familiars, generatedAt)`
 - `validateV3Artifacts(artifacts)`
 
 Generation rules:
 
 1. Preserve current manifest/web ordering.
-2. Write `catalog.v2.json` from the first 300 pets only.
-3. Generate v3 from every pet with a preserved valid category, using `installId` as the public `id` in v2, v3 pages, search metadata, install lookup, and desktop state.
-4. Exclude pets without `category: "western" | "asian"` from v3, log them, and keep them eligible for v2 compatibility output.
+2. Write `catalog.v2.json` from the first 300 familiars only.
+3. Generate v3 from every familiar with a preserved valid category, using `installId` as the public `id` in v2, v3 pages, search metadata, install lookup, and desktop state.
+4. Exclude familiars without `category: "western" | "asian"` from v3, log them, and keep them eligible for v2 compatibility output.
 5. Do not infer category from name, slug, description, source URL, or folder path.
 6. Include `subcategory` in v3 only when present.
 7. Normalize and cap `searchText` for search metadata. Include `id`, display name, useful aliases/source text, and a bounded description excerpt, but omit all asset URLs.
 8. Delete stale old `catalog.v3/page-XXX.json` and `catalog.v3/search-page-XXX.json` files before writing the new page set.
 9. Write catalog page files and search page files before the root `catalog.v3.json` and `catalog.v3/search.json` indexes.
 
-For `sync-pets.js`:
+For `sync-familiars.js`:
 
 - Build a lookup from existing `manifest.json` by `installId`, `petId`, and `slug` before replacing manifest contents.
-- When mapping upstream pets, preserve `category` and `subcategory` from the existing manifest entry if present.
-- Keep reviewed/manual imported pets from the existing manifest and preserve their category fields.
+- When mapping upstream familiars, preserve `category` and `subcategory` from the existing manifest entry if present.
+- Keep reviewed/manual imported familiars from the existing manifest and preserve their category fields.
 
-For `sync-local-pets.js`:
+For `sync-local-familiars.js`:
 
 - Preserve `category` and `subcategory` when updating an existing manual entry.
-- New local pets are not inferred into v3 unless their local `pet.json` explicitly includes a valid category; otherwise they remain v2-compatible only.
+- New local familiars are not inferred into v3 unless their local `familiar.json` explicitly includes a valid category; otherwise they remain v2-compatible only.
 - Dry runs should report `catalog.v3.json`, `catalog.v3/search.json`, and page files that would be written.
 
-For `import-reviewed-pets.js`:
+For `import-reviewed-familiars.js`:
 
 - Continue requiring category and subcategory in reviewed imports.
 - Reuse the shared writer so regenerated catalogs include v2 cap, thumbnails, v3 pages, and search metadata.
@@ -326,32 +326,32 @@ For `import-reviewed-pets.js`:
 Thumbnail generation:
 
 - Add `sharp` to `web/package.json` dependencies or devDependencies used by scripts.
-- For each v3-eligible pet, read `public/pets/<slug>/spritesheet.webp`.
+- For each v3-eligible familiar, read `public/familiars/<slug>/spritesheet.webp`.
 - Extract the top-left idle frame from the 8x9 universal spritesheet (`left: 0`, `top: 0`, `width: 192`, `height: 208`).
 - Resize inside a 160x160 WebP canvas or fit to 160px max dimension without upscaling.
-- Write `public/pets/<slug>/thumb.webp`.
+- Write `public/familiars/<slug>/thumb.webp`.
 - Validate spritesheet dimensions before extraction.
 - Regenerate deterministically during sync/import, or store/check a content-hash sidecar/manifest field. Do not rely only on filesystem mtimes because git checkouts and deploy artifacts can have misleading timestamps.
 - Warn if the generated file exceeds 20 KB; fail if missing, zero bytes, or not `.webp`.
 
 V3 file shapes:
 
-- `public/pets/catalog.v3.json` contains only index metadata, category counts, page URLs, and search URL.
-- `public/pets/catalog.v3/page-XXX.json` contains render/install metadata: `id`, `displayName`, `description`, `thumbnail`, optional `preview`, `spritesheet`, `zip`, `category`, optional `subcategory`.
-- `public/pets/catalog.v3/search.json` contains only search index metadata and search page URLs.
-- `public/pets/catalog.v3/search-page-XXX.json` contains only searchable metadata: `id`, `displayName`, capped normalized `searchText`, `category`, and `catalogPage`.
+- `public/familiars/catalog.v3.json` contains only index metadata, category counts, page URLs, and search URL.
+- `public/familiars/catalog.v3/page-XXX.json` contains render/install metadata: `id`, `displayName`, `description`, `thumbnail`, optional `preview`, `spritesheet`, `zip`, `category`, optional `subcategory`.
+- `public/familiars/catalog.v3/search.json` contains only search index metadata and search page URLs.
+- `public/familiars/catalog.v3/search-page-XXX.json` contains only searchable metadata: `id`, `displayName`, capped normalized `searchText`, `category`, and `catalogPage`.
 
 Validation must check:
 
 - unique v3 IDs across all pages
-- `total` equals paged pet count and search pet count
+- `total` equals paged familiar count and search familiar count
 - category counts equal page contents
 - page file names use exactly three digits
 - search page file names use exactly three digits
 - page/index/search JSON byte size budgets
-- thumbnail file exists for every v3 pet
-- thumbnail/preview/spritesheet URLs are `https://openpets.dev/pets/.../*.webp`
-- zip URLs are `https://zip.openpets.dev/pets/.../*.zip`
+- thumbnail file exists for every v3 familiar
+- thumbnail/preview/spritesheet URLs are `https://familiaros.dev/familiars/.../*.webp`
+- zip URLs are `https://zip.familiaros.dev/familiars/.../*.zip`
 
 Update `web/nuxt.config.js` route rules or deployment headers for catalog JSON coherence. Either:
 
@@ -390,11 +390,11 @@ Extend `apps/desktop/src/catalog.ts` into a small catalog service:
 
 Expose main-process methods equivalent to:
 
-- `getCatalogUiState()` — returns initial state with source, mode (`v3` or `v2`), page 0 pets, counts, loaded page list, `hasMore`, category availability, and errors.
+- `getCatalogUiState()` — returns initial state with source, mode (`v3` or `v2`), page 0 familiars, counts, loaded page list, `hasMore`, category availability, and errors.
 - `loadCatalogPage(page)` — loads and returns the next validated v3 page by number.
-- `queryCatalog({ query, filter, cursor, limit })` — loads/uses validated search metadata, applies category/installed/codex-aware filtering as needed, loads required catalog pages, and returns `{ pets, totalMatches, nextCursor, loadedPages }`. Use this same bounded query path for `Western`/`Asian` filters even when `query` is empty, so category filters represent the full catalog rather than only already-loaded pages.
-- `getCatalogPetForInstall(id)` — returns validated install metadata for any v3 pet, loading search/page data if needed.
-- `getCatalogPetDetail(id)` — returns a validated spritesheet URL and full pet metadata for selected-detail animation when available. V3 should include `spritesheet` for every pet in this phase; if a validated pet lacks it or loading fails, detail degrades to the thumbnail/placeholder without card-level spritesheet fetches.
+- `queryCatalog({ query, filter, cursor, limit })` — loads/uses validated search metadata, applies category/installed/codex-aware filtering as needed, loads required catalog pages, and returns `{ familiars, totalMatches, nextCursor, loadedPages }`. Use this same bounded query path for `Western`/`Asian` filters even when `query` is empty, so category filters represent the full catalog rather than only already-loaded pages.
+- `getCatalogPetForInstall(id)` — returns validated install metadata for any v3 familiar, loading search/page data if needed.
+- `getCatalogPetDetail(id)` — returns a validated spritesheet URL and full familiar metadata for selected-detail animation when available. V3 should include `spritesheet` for every familiar in this phase; if a validated familiar lacks it or loading fails, detail degrades to the thumbnail/placeholder without card-level spritesheet fetches.
 
 Bound all main-process query and page APIs:
 
@@ -406,66 +406,66 @@ Bound all main-process query and page APIs:
 - Deduplicate in-flight page/search/detail requests.
 - Limit concurrent remote catalog fetches.
 
-Installation changes in `apps/desktop/src/pet-installation.ts`:
+Installation changes in `apps/desktop/src/familiar-installation.ts`:
 
-- Replace the current `getCatalogUiState().pets.find(...)` lookup with `getCatalogPetForInstall(petId)`.
-- Store installed state with the catalog version that supplied the pet (`2` or `3`) while preserving existing state compatibility.
-- Continue downloading ZIPs only from validated `zip.openpets.dev` URLs.
+- Replace the current `getCatalogUiState().familiars.find(...)` lookup with `getCatalogPetForInstall(petId)`.
+- Store installed state with the catalog version that supplied the familiar (`2` or `3`) while preserving existing state compatibility.
+- Continue downloading ZIPs only from validated `zip.familiaros.dev` URLs.
 
 State changes in `apps/desktop/src/app-state.ts`:
 
-- Extend installed-pet source normalization to accept `catalogVersion: 3` without dropping the source.
+- Extend installed-familiar source normalization to accept `catalogVersion: 3` without dropping the source.
 - Preserve existing v2 installed state unchanged.
 - Optionally store validated `thumbnail`, `spritesheet`, and `category` metadata for installed-row enrichment, but do not require those fields for runtime rendering.
 
 IPC changes in `apps/desktop/src/windows.ts`:
 
-- Keep `openpets:get-catalog` for initial state.
+- Keep `familiaros:get-catalog` for initial state.
 - Add handlers for:
-  - `openpets:load-catalog-page`
-  - `openpets:query-catalog`
-  - `openpets:get-catalog-pet-detail`
-- Gate each handler with `assertAllowedSender(event, ["pet-manager"])`.
+  - `familiaros:load-catalog-page`
+  - `familiaros:query-catalog`
+  - `familiaros:get-catalog-familiar-detail`
+- Gate each handler with `assertAllowedSender(event, ["familiar-manager"])`.
 - Validate every renderer-supplied IPC argument before calling catalog service methods.
-- Keep Pet Manager CSP at `img-src data: https://openpets.dev`; do not add `zip.openpets.dev` to image CSP.
+- Keep Familiar Manager CSP at `img-src data: https://familiaros.dev`; do not add `zip.familiaros.dev` to image CSP.
 
 ### Desktop renderer / preload behavior
 
-Update `apps/desktop/preload.cjs` Pet Manager logic:
+Update `apps/desktop/preload.cjs` Familiar Manager logic:
 
 - Treat catalog state as versioned (`mode: "v3" | "v2"`).
 - Render v3 cards from `thumbnail` with `previewIsSpriteSheet: false`.
 - Do not use `spritesheet` for cards.
-- For selected detail, call `openpets:get-catalog-pet-detail` and render the returned validated spritesheet as an animated sprite when it arrives.
+- For selected detail, call `familiaros:get-catalog-familiar-detail` and render the returned validated spritesheet as an animated sprite when it arrives.
 - While selected-detail spritesheet is loading, show the thumbnail or empty placeholder.
 - Hide/degrade mini state previews until a real spritesheet is available.
-- Keep Codex/local pets using their current preview paths and behavior.
+- Keep Codex/local familiars using their current preview paths and behavior.
 
 Paging and search:
 
 - Initial render shows built-in/installed rows plus v3 page 0 public catalog rows.
-- Add a scroll listener or `IntersectionObserver` sentinel near the bottom of `#catalog-pets` to load the next page automatically when not searching.
+- Add a scroll listener or `IntersectionObserver` sentinel near the bottom of `#catalog-familiars` to load the next page automatically when not searching.
 - Debounce search input.
-- For non-empty search, call `openpets:query-catalog` so results can include unloaded pages.
-- For `Western` and `Asian` filters, call `openpets:query-catalog` even when search is empty so category results are full-catalog and paged, not limited to already-loaded pages.
+- For non-empty search, call `familiaros:query-catalog` so results can include unloaded pages.
+- For `Western` and `Asian` filters, call `familiaros:query-catalog` even when search is empty so category results are full-catalog and paged, not limited to already-loaded pages.
 - For empty `All`, return to loaded-page browsing and continue scroll pagination.
-- Avoid rendering all 1,000+ pets at once; query results must be bounded and cursor/page-loaded from the main process.
-- Protect selected-detail spritesheet rendering with a request token or equivalent cancellation guard so stale responses cannot update the detail pane after the user selects another pet.
+- Avoid rendering all 1,000+ familiars at once; query results must be bounded and cursor/page-loaded from the main process.
+- Protect selected-detail spritesheet rendering with a request token or equivalent cancellation guard so stale responses cannot update the detail pane after the user selects another familiar.
 
 Filters and layout:
 
 - In `createPetManagerHtml`, order filter buttons as `All`, `Western`, `Asian`, `Codex`, `Installed`.
 - Show `Western` and `Asian` only when v3 metadata is available. Hide or disable them in v2 fallback.
-- Keep `Codex` filter semantics unchanged: Codex/local pets appear under `Codex`, not under `Western`/`Asian` unless they have validated v3 catalog metadata.
+- Keep `Codex` filter semantics unchanged: Codex/local familiars appear under `Codex`, not under `Western`/`Asian` unless they have validated v3 catalog metadata.
 - Move `#catalog-status` out of the filter row and into a compact bottom-corner position.
-- Status text should be minimal, e.g. `123 pets`, `300 pets`, or `Offline`; do not include `Live` and do not include Codex counts.
+- Status text should be minimal, e.g. `123 familiars`, `300 familiars`, or `Offline`; do not include `Live` and do not include Codex counts.
 - Align filter buttons to the right to avoid crowding the search/header row.
 
 Image loading:
 
 - Keep `Image.decoding = "async"` and `referrerPolicy = "no-referrer"`.
 - Continue setting CSS `backgroundImage` only after image `load`.
-- Add lazy thumbnail loading from day one using `IntersectionObserver` or an equivalent small renderer-side queue so a 100-pet page does not immediately start 100 thumbnail requests.
+- Add lazy thumbnail loading from day one using `IntersectionObserver` or an equivalent small renderer-side queue so a 100-familiar page does not immediately start 100 thumbnail requests.
 - Add a small concurrency guard for thumbnail image loads.
 
 ### Compatibility and rollout sequencing
@@ -475,10 +475,10 @@ Implement this work in reviewable phases. After each phase, run the relevant che
 1. **Web catalog artifacts**
    - Add shared web catalog helper(s).
    - Add `sharp` thumbnail generation.
-   - Cap `catalog.v2.json` to 300 pets.
+   - Cap `catalog.v2.json` to 300 familiars.
    - Generate `catalog.v3.json`, catalog pages, `search.json`, and search pages.
    - Add web-side validation for IDs, categories, counts, URL shapes, response budgets, stale page cleanup, and thumbnail existence.
-   - Checks: `cd web && bun lint && bun run build && bun run sync:pets` or a fixture-safe equivalent if live sync is not appropriate.
+   - Checks: `cd web && bun lint && bun run build && bun run sync:familiars` or a fixture-safe equivalent if live sync is not appropriate.
    - Oracle review gate: web artifact generation, v2 compatibility, v3 contract, thumbnail generation, cache coherence, and nested-web dependency handling.
 
 2. **Desktop catalog service and validation**
@@ -487,14 +487,14 @@ Implement this work in reviewable phases. After each phase, run the relevant che
    - Add v3 installed-source normalization while preserving existing v2 state.
    - Add IPC handlers with strict argument validation, request dedupe, and concurrency bounds.
    - Add packaging coverage for v2 fixture fallback if it remains enabled.
-   - Checks: `pnpm --filter @open-pets/desktop build` and focused catalog/check tests.
+   - Checks: `pnpm --filter @familiaros/desktop build` and focused catalog/check tests.
    - Oracle review gate: security boundaries, URL validation, app-state compatibility, fallback behavior, and install lookup outside page 0.
 
-3. **Pet Manager renderer update**
+3. **Familiar Manager renderer update**
    - Switch catalog cards to thumbnails.
    - Add lazy/concurrent thumbnail loading.
    - Add right-aligned filters: `All`, `Western`, `Asian`, `Codex`, `Installed`.
-   - Move compact pet count/status to the bottom corner.
+   - Move compact familiar count/status to the bottom corner.
    - Add scroll-triggered paging and bounded full-catalog query/search flows.
    - Preserve Codex/local rendering and filter semantics.
    - Checks: desktop build/tests plus renderer contract checks.
@@ -511,9 +511,9 @@ Implement this work in reviewable phases. After each phase, run the relevant che
 5. **End-to-end validation and rollout readiness**
    - Run web and desktop command sets.
    - Package desktop.
-   - Manually verify with a locally served or published 1,000+ pet v3 catalog.
+   - Manually verify with a locally served or published 1,000+ familiar v3 catalog.
    - Confirm v3 outage falls back to v2 and category filters hide/disable.
-   - Confirm runtime installed pets still use installed `spritesheet.webp` unchanged.
+   - Confirm runtime installed familiars still use installed `spritesheet.webp` unchanged.
    - Oracle review gate: final implementation review against all acceptance criteria before deployment/release.
 
 ### Test coverage to add
@@ -521,7 +521,7 @@ Implement this work in reviewable phases. After each phase, run the relevant che
 Web:
 
 - Unit/script-level validation for v2 cap at 300.
-- Validation that v3 includes all and only category-valid pets.
+- Validation that v3 includes all and only category-valid familiars.
 - Validation that search index page mappings match generated pages.
 - Validation that stale page files are removed.
 - Thumbnail generation smoke test on a known spritesheet fixture, if a small fixture can be added without bloating the repo.
@@ -530,9 +530,9 @@ Desktop:
 
 - `check-catalog-v3-validation.ts` for valid/invalid index, page, and search files.
 - v3 fallback behavior when index/page/search validation fails.
-- install lookup for a pet outside page 0.
+- install lookup for a familiar outside page 0.
 - URL validation rejects wrong hosts, redirects, credentials, custom ports, wrong extensions, and unindexed page URLs.
-- Pet Manager renderer contract checks for filter order, hidden v2 category filters, status label wording, and no card spritesheet usage.
+- Familiar Manager renderer contract checks for filter order, hidden v2 category filters, status label wording, and no card spritesheet usage.
 
 ### Implementation risks and mitigations
 
@@ -540,11 +540,11 @@ Desktop:
 - **Many missing categories**: v3 excludes and logs them; v2 remains capped and compatible.
 - **Thumbnail generation is slow**: regenerate deterministically during sync/import or via content-hash checks, and keep `sharp` work local to sync/import scripts.
 - **Selected detail causes repeated spritesheet downloads**: cache detail metadata in main process and let browser cache image requests.
-- **Installed pets outside loaded pages look sparse**: render installed state from local app state first, then enrich when the relevant v3 page loads.
+- **Installed familiars outside loaded pages look sparse**: render installed state from local app state first, then enrich when the relevant v3 page loads.
 
 ## Security and compatibility notes
 
-- Desktop CSP should continue to allow only `data:` and `https://openpets.dev` for Pet Manager images unless the implementation requires a narrower path/origin rule.
+- Desktop CSP should continue to allow only `data:` and `https://familiaros.dev` for Familiar Manager images unless the implementation requires a narrower path/origin rule.
 - The renderer must not independently derive `thumbnail`, `preview`, `spritesheet`, or `zip` URLs.
 - Main process should validate:
   - catalog index final URL,
@@ -553,9 +553,9 @@ Desktop:
   - zip origin/path/extension.
 - URL validation should also reject credentials, custom ports, query strings, hashes, encoded path traversal tricks, wrong extensions, wrong final URLs, unindexed page/search URLs, and unexpected origins.
 - `catalog.v2.json` remains the compatibility contract for currently shipped clients.
-- `catalog.v2.json` must remain capped to 300 pets as a compatible curated subset rather than silently breaking shipped clients.
+- `catalog.v2.json` must remain capped to 300 familiars as a compatible curated subset rather than silently breaking shipped clients.
 - `catalog.v3` can be rolled out on the web before desktop starts consuming it.
-- Desktop Codex/local pet behavior is a non-goal. `web/scripts/sync-local-pets.js` is only a publishing path for local pets into the public web catalog; do not change desktop `~/.codex/pets` discovery, import, preview inlining, or metadata validation.
+- Desktop Codex/local familiar behavior is a non-goal. `web/scripts/sync-local-familiars.js` is only a publishing path for local familiars into the public web catalog; do not change desktop `~/.codex/familiars` discovery, import, preview inlining, or metadata validation.
 - If v2 fixture fallback remains part of desktop behavior, include `catalog.v2.fixture.json` in packaged app files and add packaging-contract coverage for it.
 - `web/` is outside the root pnpm workspace. Web checks, Bun dependencies, and the `sharp` lockfile/install path must be handled explicitly rather than assuming root `pnpm test` covers them.
 
@@ -567,7 +567,7 @@ Desktop:
    - Verify URLs and asset sizes on production.
 2. Desktop fallback support:
    - Add v3 fetch/validation with v2 fallback.
-   - Keep existing Pet Manager behavior if v3 is missing.
+   - Keep existing Familiar Manager behavior if v3 is missing.
 3. Desktop performance update:
    - Switch cards to `thumbnail`.
    - Add scroll-triggered pagination, full-catalog search via v3 search metadata, selected-detail spritesheet loading, and bounded image loading.
@@ -577,24 +577,24 @@ Desktop:
 
 ## Acceptance criteria
 
-- `catalog.v2.json` output remains backward compatible and capped to 300 pets.
-- `catalog.v3.json` and page files are generated by all relevant web catalog sync/import flows for all eligible public pets.
+- `catalog.v2.json` output remains backward compatible and capped to 300 familiars.
+- `catalog.v3.json` and page files are generated by all relevant web catalog sync/import flows for all eligible public familiars.
 - `catalog.v3/search.json` is generated and enables full-catalog desktop search without loading all page files or thumbnails initially.
-- Every v3 pet has a small `thumbnail` URL under `https://openpets.dev/pets/` ending in `.webp`.
-- Desktop Pet Manager card grid uses `thumbnail` for catalog pets.
-- Desktop Pet Manager includes compact right-aligned filters ordered `All`, `Western`, `Asian`, existing `Codex`, and `Installed` when v3 metadata is available.
-- Desktop Pet Manager moves the pet count/status label to the bottom corner and keeps it minimal, without `Live` wording or Codex count.
+- Every v3 familiar has a small `thumbnail` URL under `https://familiaros.dev/familiars/` ending in `.webp`.
+- Desktop Familiar Manager card grid uses `thumbnail` for catalog familiars.
+- Desktop Familiar Manager includes compact right-aligned filters ordered `All`, `Western`, `Asian`, existing `Codex`, and `Installed` when v3 metadata is available.
+- Desktop Familiar Manager moves the familiar count/status label to the bottom corner and keeps it minimal, without `Live` wording or Codex count.
 - `Codex` filter behavior is unchanged.
 - `Western`/`Asian` filters are driven only by validated v3 `category` metadata.
 - If desktop falls back to v2, `Western`/`Asian` filters are hidden or disabled because v2 does not guarantee category metadata.
-- Opening Pet Manager with 1,000+ catalog pets does not request all full `spritesheet.webp` files.
-- Initial Pet Manager open requests only the v3 index, first page, and thumbnails for rendered/visible cards.
-- Full `spritesheet.webp` files are requested only for selected detail animation, install packages, or runtime installed pets.
+- Opening Familiar Manager with 1,000+ catalog familiars does not request all full `spritesheet.webp` files.
+- Initial Familiar Manager open requests only the v3 index, first page, and thumbnails for rendered/visible cards.
+- Full `spritesheet.webp` files are requested only for selected detail animation, install packages, or runtime installed familiars.
 - v3 outage or validation failure falls back to v2 without breaking install/default/remove operations.
 - `catalog.v2.json` remains within the compatibility limit expected by shipped desktop clients.
-- Codex/local pet behavior is unchanged.
+- Codex/local familiar behavior is unchanged.
 - Web generation validates unique v3 IDs, category counts, page URLs, response-size budgets, and thumbnail existence.
-- Search finds matching catalog pets outside already-loaded pages and loads the relevant validated page(s) before rendering results.
+- Search finds matching catalog familiars outside already-loaded pages and loads the relevant validated page(s) before rendering results.
 
 ## Test/check plan
 
@@ -604,14 +604,14 @@ Web:
 cd web
 bun lint
 bun run build
-bun run sync:pets
+bun run sync:familiars
 ```
 
 Desktop:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop test
 pnpm package:desktop:dir
 ```
 
@@ -619,16 +619,16 @@ Repository-level validation should run both command sets because `web/` is a nes
 
 Manual verification:
 
-1. Publish or locally serve a v3 catalog with at least 1,000 pets.
-2. Open desktop Pet Manager.
+1. Publish or locally serve a v3 catalog with at least 1,000 familiars.
+2. Open desktop Familiar Manager.
 3. Confirm only index/page JSON and card thumbnails are loaded initially.
 4. Scroll/load more and confirm requests grow by page/viewport, not by total catalog size.
 5. Switch between `All`, `Western`, `Asian`, `Codex`, and `Installed`; confirm Codex remains unchanged and category filters match web categories.
-6. Search for a pet that is not on the first loaded page and confirm it appears after the relevant page is loaded.
-7. Select a pet and confirm detail fetches/uses its spritesheet animation while cards continue to use thumbnails.
-8. Install a pet and confirm runtime installed pet behavior is unchanged.
+6. Search for a familiar that is not on the first loaded page and confirm it appears after the relevant page is loaded.
+7. Select a familiar and confirm detail fetches/uses its spritesheet animation while cards continue to use thumbnails.
+8. Install a familiar and confirm runtime installed familiar behavior is unchanged.
 9. Disable v3 and confirm v2 fallback works with category filters hidden/disabled.
-10. Confirm Codex/local pets behave exactly as before.
+10. Confirm Codex/local familiars behave exactly as before.
 
 ## Resolved decisions
 
diff --git a/docs/phases/phase-21-pi-integration.md b/docs/phases/phase-21-pi-integration.md
index d026bf0c..24e8b2a4 100644
--- a/docs/phases/phase-21-pi-integration.md
+++ b/docs/phases/phase-21-pi-integration.md
@@ -2,32 +2,32 @@
 
 ## Goal
 
-Add first-class OpenPets support for Pi through a dedicated Pi extension package, with desktop and docs visibility, while keeping the runtime local, safe, and non-blocking.
+Add first-class FamiliarOS support for Pi through a dedicated Pi extension package, with desktop and docs visibility, while keeping the runtime local, safe, and non-blocking.
 
 Target support means:
 
-- Pi agent activity drives OpenPets reactions automatically.
-- Pi users can install the OpenPets Pi extension with Pi's package system. The OpenPets desktop app remains a separate app installation.
-- Pi users can run a small `/openpets` command namespace for status and manual checks.
-- OpenPets desktop can show Pi in Integrations using `apps/desktop/assets/integrations/pi.svg`.
+- Pi agent activity drives FamiliarOS reactions automatically.
+- Pi users can install the FamiliarOS Pi extension with Pi's package system. The FamiliarOS desktop app remains a separate app installation.
+- Pi users can run a small `/familiaros` command namespace for status and manual checks.
+- FamiliarOS desktop can show Pi in Integrations using `apps/desktop/assets/integrations/pi.svg`.
 - Public docs explain Pi setup as extension-first, not MCP-first.
 - The integration never forwards prompts, assistant text, tool output, file contents, URLs, paths, or secrets by default.
 
-## Current OpenPets integration model to mirror
+## Current FamiliarOS integration model to mirror
 
-OpenPets currently has three integration layers:
+FamiliarOS currently has three integration layers:
 
 1. **Local IPC client**
    - Shared runtime bridge: `packages/client`.
    - Integrations use it to send reactions and speech to the desktop app.
-   - Desktop routes explicit pet targets through lease-managed agent pets.
+   - Desktop routes explicit familiar targets through lease-managed agent familiars.
 
 2. **Dedicated agent packages**
    - Claude Code: `packages/claude` for MCP setup, managed instructions, hooks, and hook event mapping.
    - OpenCode: `packages/opencode` for plugin runtime, config setup, previews, and project/global setup.
 
 3. **Generic fallback**
-   - `packages/mcp` exposes `openpets_status`, `openpets_react`, and `openpets_say` for stdio MCP clients.
+   - `packages/mcp` exposes `familiaros_status`, `familiaros_react`, and `familiaros_say` for stdio MCP clients.
    - `packages/cli` exposes scriptable direct commands.
 
 Pi should follow the dedicated-package model. Generic MCP can remain a fallback, but it is not the best primary integration surface for Pi.
@@ -50,7 +50,7 @@ Pi's coding-agent package provides a rich extension and package system.
 
 ```json
 {
-  "name": "@open-pets/pi",
+  "name": "@familiaros/pi",
   "keywords": ["pi-package"],
   "pi": {
     "extensions": ["./dist/extension.js"]
@@ -76,8 +76,8 @@ Pi's coding-agent package provides a rich extension and package system.
   - `input`
   - `user_bash`
 - Extensions can register slash commands with `pi.registerCommand()`.
-- Extensions can use `ctx.ui.notify()`, `ctx.ui.setStatus()`, widgets, and custom TUI pieces, but OpenPets should not require custom Pi UI for the first release.
-- Pi extensions run with full local system permissions, so OpenPets docs must treat package trust as a security boundary.
+- Extensions can use `ctx.ui.notify()`, `ctx.ui.setStatus()`, widgets, and custom TUI pieces, but FamiliarOS should not require custom Pi UI for the first release.
+- Pi extensions run with full local system permissions, so FamiliarOS docs must treat package trust as a security boundary.
 
 ## Recommended approach
 
@@ -90,22 +90,22 @@ packages/pi/
 Published package:
 
 ```text
-@open-pets/pi
+@familiaros/pi
 ```
 
 Primary install flow:
 
 ```bash
-pi install npm:@open-pets/pi
+pi install npm:@familiaros/pi
 ```
 
 Project-local install flow:
 
 ```bash
-pi install -l npm:@open-pets/pi
+pi install -l npm:@familiaros/pi
 ```
 
-The package should export one Pi extension that uses `@open-pets/client` to send local IPC updates. It should not depend on MCP for core behavior.
+The package should export one Pi extension that uses `@familiaros/client` to send local IPC updates. It should not depend on MCP for core behavior.
 
 ## Compatibility gate
 
@@ -127,11 +127,11 @@ Recommended `package.json` shape:
 
 ```json
 {
-  "name": "@open-pets/pi",
+  "name": "@familiaros/pi",
   "version": "0.0.0",
   "license": "MIT",
   "type": "module",
-  "keywords": ["pi-package", "openpets", "coding-agent"],
+  "keywords": ["pi-package", "familiaros", "coding-agent"],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -141,7 +141,7 @@ Recommended `package.json` shape:
   "files": ["dist"],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/pi"
   },
   "pi": {
@@ -152,7 +152,7 @@ Recommended `package.json` shape:
     "check": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@open-pets/client": "workspace:*"
+    "@familiaros/client": "workspace:*"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "<tested-range>",
@@ -172,31 +172,31 @@ Notes:
 - Confirm whether Pi requires `@earendil-works/pi-coding-agent`, `typebox`, or related Pi core packages as `peerDependencies` instead of bundled dependencies before publishing.
 - Keep runtime dependencies minimal.
 - Build output should be plain ESM JavaScript that Pi can load without TypeScript compilation.
-- The extension should tolerate missing OpenPets desktop IPC and keep Pi startup/session flow unaffected.
-- Add `@open-pets/pi` to `scripts/release-npm.mjs` publish order after its dependencies.
+- The extension should tolerate missing FamiliarOS desktop IPC and keep Pi startup/session flow unaffected.
+- Add `@familiaros/pi` to `scripts/release-npm.mjs` publish order after its dependencies.
 - `pnpm pack --dry-run` must show the tarball includes built `dist` JavaScript and declarations only, not phase docs or source-only runtime files.
 - Verify workspace dependency rewriting before publish.
-- Reuse `@open-pets/agent-events` for shared event messages/safety if it fits the exact validation requirements; otherwise document the reason and test Pi against the same rejection corpus as desktop/MCP.
+- Reuse `@familiaros/agent-events` for shared event messages/safety if it fits the exact validation requirements; otherwise document the reason and test Pi against the same rejection corpus as desktop/MCP.
 
 ## Runtime behavior
 
 The extension should:
 
-- Create a small OpenPets runtime wrapper around `@open-pets/client`.
+- Create a small FamiliarOS runtime wrapper around `@familiaros/client`.
 - Cache connection status only briefly; do not assume the desktop app stays available.
-- Use short timeouts for OpenPets calls.
+- Use short timeouts for FamiliarOS calls.
 - Run automatic event updates fire-and-forget.
-- Swallow OpenPets IPC failures by default, with optional debug logging.
+- Swallow FamiliarOS IPC failures by default, with optional debug logging.
 - Avoid long-lived timers unless needed for throttling cleanup.
 - Clean up on `session_shutdown`.
 
-MVP targets the default pet only. Explicit pet routing, selected-pet config, and lease reuse are deferred until the Pi extension behavior is verified in production. A later pet-routing phase must define configuration, lease acquire/reuse, stale-lease fallback, shutdown cleanup, and missing-pet tests before enabling `--pet`-style behavior.
+MVP targets the default familiar only. Explicit familiar routing, selected-familiar config, and lease reuse are deferred until the Pi extension behavior is verified in production. A later familiar-routing phase must define configuration, lease acquire/reuse, stale-lease fallback, shutdown cleanup, and missing-familiar tests before enabling `--familiar`-style behavior.
 
 ## Event mapping
 
 Default mapping should favor silent reactions over speech.
 
-| Pi event | Condition | OpenPets reaction | Speech |
+| Pi event | Condition | FamiliarOS reaction | Speech |
 | --- | --- | --- | --- |
 | `session_start` | Pi starts, resumes, or reloads. | `waving` | None by default. |
 | `agent_start` | Agent loop begins. | `thinking` | None. |
@@ -214,8 +214,8 @@ Classification rules:
 - Tool names may be inspected.
 - Tool arguments may be inspected only through bounded in-memory slices for coarse classification, such as test detection.
 - `tool_execution_end` must use `isError` only and must not inspect `result`.
-- Never place raw tool arguments, command text, output, stack traces, prompt text, or assistant text in pet speech.
-- Ignore OpenPets-related commands/tools to prevent self-trigger loops.
+- Never place raw tool arguments, command text, output, stack traces, prompt text, or assistant text in familiar speech.
+- Ignore FamiliarOS-related commands/tools to prevent self-trigger loops.
 - Do not subscribe to prompt/content-heavy events in MVP: `input`, `before_agent_start`, `message_update`, `message_end`, or `tool_result`.
 - Track current-agent error state so `agent_end` does not immediately overwrite a recent `error` reaction with `success`.
 - Do not register model-callable Pi tools in Phase 21. No `pi.registerTool()` usage is allowed in MVP.
@@ -226,26 +226,26 @@ Classification rules:
 Register one command namespace:
 
 ```text
-/openpets
+/familiaros
 ```
 
 Suggested subcommands:
 
 | Command | Behavior |
 | --- | --- |
-| `/openpets status` | Check whether the OpenPets desktop app is reachable and which pet is targeted. |
-| `/openpets test` | Send a short safe test message and `waving` or `success` reaction. |
-| `/openpets react <reaction>` | Set one allowed reaction. |
-| `/openpets say <message>` | Show one validated short speech bubble. |
-| `/openpets help` | Show available subcommands. |
+| `/familiaros status` | Check whether the FamiliarOS desktop app is reachable and which familiar is targeted. |
+| `/familiaros test` | Send a short safe test message and `waving` or `success` reaction. |
+| `/familiaros react <reaction>` | Set one allowed reaction. |
+| `/familiaros say <message>` | Show one validated short speech bubble. |
+| `/familiaros help` | Show available subcommands. |
 
-Allowed manual reactions should match the public OpenPets reaction set:
+Allowed manual reactions should match the public FamiliarOS reaction set:
 
 ```text
 idle, thinking, working, editing, running, testing, waiting, waving, success, error, celebrating
 ```
 
-Manual speech must use the same validation rules as other OpenPets surfaces:
+Manual speech must use the same validation rules as other FamiliarOS surfaces:
 
 - single line;
 - short, user-facing, non-sensitive;
@@ -253,7 +253,7 @@ Manual speech must use the same validation rules as other OpenPets surfaces:
 
 ## Safety and privacy requirements
 
-The Pi integration must preserve the OpenPets safety model.
+The Pi integration must preserve the FamiliarOS safety model.
 
 - No automatic prompt forwarding.
 - No automatic assistant-message forwarding.
@@ -261,8 +261,8 @@ The Pi integration must preserve the OpenPets safety model.
 - No automatic command-output forwarding.
 - No file contents, URLs, file paths, diffs, logs, stack traces, secrets, or tokens in speech.
 - Speech is rare and generated from fixed message pools or explicit user command input.
-- Manual `/openpets say` input is validated before sending.
-- OpenPets failures never block Pi model calls or tool execution.
+- Manual `/familiaros say` input is validated before sending.
+- FamiliarOS failures never block Pi model calls or tool execution.
 - Pi package docs warn that Pi extensions run with local system permissions.
 - Debug logging is off by default, sanitized, and never logs raw event payloads.
 
@@ -279,13 +279,13 @@ Implementation should:
 - Add Pi to the bundled integration icon map in `apps/desktop/src/windows.ts`.
 - Add `pi.svg` to the packaging contract in `apps/desktop/src/check-packaging-contract.ts`.
 - Add a Pi card to the Integrations grid.
-- Initially mark the card as planned/coming soon unless `@open-pets/pi` setup is implemented in the desktop app.
+- Initially mark the card as planned/coming soon unless `@familiaros/pi` setup is implemented in the desktop app.
 - If setup is implemented, expose a simple detail panel with:
   - Pi command detection, if practical;
-  - install instructions using `pi install npm:@open-pets/pi`;
-  - project-local install instructions using `pi install -l npm:@open-pets/pi`;
+  - install instructions using `pi install npm:@familiaros/pi`;
+  - project-local install instructions using `pi install -l npm:@familiaros/pi`;
   - status/check guidance;
-  - remove guidance using `pi remove npm:@open-pets/pi`.
+  - remove guidance using `pi remove npm:@familiaros/pi`.
 
 Do not add risky desktop-managed writes to Pi settings until the package contract is stable. The first desktop release can be documentation/install-command oriented.
 
@@ -302,29 +302,29 @@ web/content/en/integrations/pi.md
 The page should explain:
 
 - Pi uses an extension package, not MCP-first setup.
-- OpenPets desktop must be running for pet updates.
+- FamiliarOS desktop must be running for familiar updates.
 - Global install command.
 - Project-local install command.
-- `/openpets` commands.
+- `/familiaros` commands.
 - Event-to-reaction mapping.
 - Privacy model.
 - Package trust warning.
 - Current status if not yet released.
 - Tested Pi version and tested operating systems once verified.
 
-When `@open-pets/pi` is actually published and supported, update the frontmatter from planned/inactive to active/supported and link it from active integration surfaces.
+When `@familiaros/pi` is actually published and supported, update the frontmatter from planned/inactive to active/supported and link it from active integration surfaces.
 
 ## Non-goals
 
 - Do not modify Pi upstream.
 - Do not require MCP for Pi's automatic reactions.
-- Do not add new public OpenPets MCP tools.
-- Do not expose pet install/remove/default controls to the Pi model in MVP.
-- Do not expose model-callable OpenPets tools through Pi in MVP.
+- Do not add new public FamiliarOS MCP tools.
+- Do not expose familiar install/remove/default controls to the Pi model in MVP.
+- Do not expose model-callable FamiliarOS tools through Pi in MVP.
 - Do not call `pi.registerTool()` in Phase 21.
-- Do not send raw prompts, assistant text, tool inputs, tool output, file paths, command output, logs, diffs, URLs, or secrets to pet speech.
+- Do not send raw prompts, assistant text, tool inputs, tool output, file paths, command output, logs, diffs, URLs, or secrets to familiar speech.
 - Do not build custom Pi TUI widgets in MVP.
-- Do not make OpenPets availability affect Pi startup, model requests, or tool execution.
+- Do not make FamiliarOS availability affect Pi startup, model requests, or tool execution.
 
 ## Proposed subphase sequence
 
@@ -334,24 +334,24 @@ When `@open-pets/pi` is actually published and supported, update the frontmatter
 
 **Scope:**
 
-- Add workspace package `@open-pets/pi`.
+- Add workspace package `@familiaros/pi`.
 - Verify current Pi extension loading and event API against a real Pi version or local cloned Pi package before relying on it.
 - Record tested Pi version or commit in this plan/docs.
 - Export a Pi extension entry compatible with Pi's package loader.
-- Add a small OpenPets client wrapper with timeout and failure swallowing.
-- Use explicit short timeouts for OpenPets calls, initially 500ms for automatic reactions.
+- Add a small FamiliarOS client wrapper with timeout and failure swallowing.
+- Use explicit short timeouts for FamiliarOS calls, initially 500ms for automatic reactions.
 - Add event classification helpers.
 - Add exact speech safety and throttling helpers, reusing shared validators or matching the desktop/MCP rejection corpus.
-- Register `/openpets` command with `status`, `test`, `react`, `say`, and `help` subcommands.
+- Register `/familiaros` command with `status`, `test`, `react`, `say`, and `help` subcommands.
 - Add unit tests for command parsing, reaction validation, speech rejection, event classification, non-blocking automatic handlers, unhandled rejection prevention, sanitized debug logging, and no automatic privacy leakage into `client.say`.
 - Do not register Pi tools.
 
 **Acceptance criteria:**
 
 - Built extension can be imported from `dist/extension.js`.
-- Extension factory returns quickly and does not require OpenPets desktop to be running.
+- Extension factory returns quickly and does not require FamiliarOS desktop to be running.
 - Automatic event handlers do not await IPC in a way that blocks Pi.
-- `/openpets say` rejects unsafe text.
+- `/familiaros say` rejects unsafe text.
 - Automatic handlers never call `client.say` with raw event payload data.
 - `agent_end` success is suppressed after recent tool errors.
 - `pnpm pack --dry-run` includes the expected package files only.
@@ -359,10 +359,10 @@ When `@open-pets/pi` is actually published and supported, update the frontmatter
 
 **Checks:**
 
-- `pnpm --filter @open-pets/pi check`
-- `pnpm --filter @open-pets/client check`
-- `pnpm --filter @open-pets/agent-events check`
-- `pnpm --filter @open-pets/pi pack --dry-run`
+- `pnpm --filter @familiaros/pi check`
+- `pnpm --filter @familiaros/client check`
+- `pnpm --filter @familiaros/agent-events check`
+- `pnpm --filter @familiaros/pi pack --dry-run`
 
 ### Phase 21B — Pi Event Runtime and Manual Smoke Test
 
@@ -376,7 +376,7 @@ When `@open-pets/pi` is actually published and supported, update the frontmatter
 - Confirm project-local package install works.
 - Confirm global and project-local removal behavior.
 - Confirm that handlers are safe in interactive, print, and non-interactive modes.
-- Confirm that unavailable OpenPets desktop app does not produce noisy failures.
+- Confirm that unavailable FamiliarOS desktop app does not produce noisy failures.
 - Confirm reload/new/resume/fork cleanup behavior.
 - Confirm parallel tool execution does not produce stale state or unhandled rejections.
 - Add a manual smoke-test checklist.
@@ -384,19 +384,19 @@ When `@open-pets/pi` is actually published and supported, update the frontmatter
 
 **Acceptance criteria:**
 
-- Pi can load the local OpenPets extension.
+- Pi can load the local FamiliarOS extension.
 - Pi can load the packed package locally.
-- `/openpets status` reports reachable/unreachable clearly.
-- Tool start/end events produce expected reactions when OpenPets is running.
-- No prompts, outputs, or commands appear in pet speech during normal automation.
-- Pi continues normally when OpenPets is closed.
-- Malformed/missing discovery files fail clearly or are ignored by Pi without OpenPets-specific noise.
+- `/familiaros status` reports reachable/unreachable clearly.
+- Tool start/end events produce expected reactions when FamiliarOS is running.
+- No prompts, outputs, or commands appear in familiar speech during normal automation.
+- Pi continues normally when FamiliarOS is closed.
+- Malformed/missing discovery files fail clearly or are ignored by Pi without FamiliarOS-specific noise.
 
 **Checks:**
 
-- `pnpm --filter @open-pets/pi check`
-- Manual Pi smoke test with OpenPets running.
-- Manual Pi smoke test with OpenPets closed.
+- `pnpm --filter @familiaros/pi check`
+- Manual Pi smoke test with FamiliarOS running.
+- Manual Pi smoke test with FamiliarOS closed.
 
 ### Phase 21C — Desktop Integration Card and Asset Wiring
 
@@ -420,7 +420,7 @@ When `@open-pets/pi` is actually published and supported, update the frontmatter
 
 **Checks:**
 
-- `pnpm --filter @open-pets/desktop check`
+- `pnpm --filter @familiaros/desktop check`
 - Desktop manual visual check of Integrations grid.
 
 ### Phase 21D — Public Docs, Release, and Support Status
@@ -435,7 +435,7 @@ When `@open-pets/pi` is actually published and supported, update the frontmatter
 - Document tested Pi version or commit date.
 - Add troubleshooting:
   - Pi package not loading;
-  - OpenPets desktop unavailable;
+  - FamiliarOS desktop unavailable;
   - commands work but automatic reactions do not;
   - removing global/project-local package install.
 
@@ -448,8 +448,8 @@ When `@open-pets/pi` is actually published and supported, update the frontmatter
 
 **Checks:**
 
-- `pnpm --filter @open-pets/pi check`
-- `pnpm --filter @open-pets/desktop check`
+- `pnpm --filter @familiaros/pi check`
+- `pnpm --filter @familiaros/desktop check`
 - Web docs build/check command for the web workspace.
 - From `web/`: `bun lint`
 - From `web/`: `bun run build`
diff --git a/docs/phases/phase-22-reaction-animation-settings.md b/docs/phases/phase-22-reaction-animation-settings.md
index 2acc3d88..88775cec 100644
--- a/docs/phases/phase-22-reaction-animation-settings.md
+++ b/docs/phases/phase-22-reaction-animation-settings.md
@@ -2,11 +2,11 @@
 
 ## Goal
 
-Give users a clear settings screen for choosing which pet animation plays for each OpenPets reaction.
+Give users a clear settings screen for choosing which familiar animation plays for each FamiliarOS reaction.
 
 Today the mapping is effectively product-defined in code: a reaction such as `thinking`, `working`, or `success` maps to one universal spritesheet animation state. That default should remain, but users should be able to override the mapping without editing files or guessing what each animation looks like.
 
-The core user experience is a simple settings table with a live default-pet preview so users can understand: **when this reaction happens, my pet will play this animation**.
+The core user experience is a simple settings table with a live default-familiar preview so users can understand: **when this reaction happens, my familiar will play this animation**.
 
 ## Non-goals
 
@@ -23,23 +23,23 @@ Add a settings section, likely named **Reaction animations**, where the user see
 
 | Reaction | Plays animation | Inline preview |
 | --- | --- | --- |
-| Idle | Idle | Animated default pet thumbnail |
-| Thinking | Review | Animated default pet thumbnail |
-| Working | Running | Animated default pet thumbnail |
-| Editing | Running | Animated default pet thumbnail |
-| Running | Running | Animated default pet thumbnail |
-| Testing | Waiting | Animated default pet thumbnail |
-| Waiting | Waiting | Animated default pet thumbnail |
-| Waving | Waving | Animated default pet thumbnail |
-| Success | Jumping | Animated default pet thumbnail |
-| Error | Failed | Animated default pet thumbnail |
-| Celebrating | Jumping | Animated default pet thumbnail |
+| Idle | Idle | Animated default familiar thumbnail |
+| Thinking | Review | Animated default familiar thumbnail |
+| Working | Running | Animated default familiar thumbnail |
+| Editing | Running | Animated default familiar thumbnail |
+| Running | Running | Animated default familiar thumbnail |
+| Testing | Waiting | Animated default familiar thumbnail |
+| Waiting | Waiting | Animated default familiar thumbnail |
+| Waving | Waving | Animated default familiar thumbnail |
+| Success | Jumping | Animated default familiar thumbnail |
+| Error | Failed | Animated default familiar thumbnail |
+| Celebrating | Jumping | Animated default familiar thumbnail |
 
 Each row should make the relationship readable in plain language:
 
-- **Reaction**: the event OpenPets receives from an agent or MCP tool.
-- **Plays animation**: the spritesheet state the pet will use.
-- **Inline preview**: shows the selected animation in that row using the configured default pet's assets, without affecting the live desktop pet.
+- **Reaction**: the event FamiliarOS receives from an agent or MCP tool.
+- **Plays animation**: the spritesheet state the familiar will use.
+- **Inline preview**: shows the selected animation in that row using the configured default familiar's assets, without affecting the live desktop familiar.
 
 ## Mapping choices
 
@@ -93,7 +93,7 @@ The default mapping should match the existing product behavior:
 | `error` | `failed` | Failed |
 | `celebrating` | `jumping` | Jumping |
 
-The baseline “no active reaction” state always remains canonical `idle`. A user override for the explicit `idle` reaction only affects an actual `idle` reaction event; it must not make the pet continuously play a non-idle animation when nothing is happening.
+The baseline “no active reaction” state always remains canonical `idle`. A user override for the explicit `idle` reaction only affects an actual `idle` reaction event; it must not make the familiar continuously play a non-idle animation when nothing is happening.
 
 ## Settings UI design
 
@@ -101,7 +101,7 @@ The baseline “no active reaction” state always remains canonical `idle`. A u
 
 - Place this under Settings rather than first-run onboarding.
 - Use a compact card titled **Reaction animations**.
-- Include one short helper sentence: “Choose which animation your pet plays for each agent reaction.”
+- Include one short helper sentence: “Choose which animation your familiar plays for each agent reaction.”
 - Keep the table scannable; avoid technical spritesheet language in the main UI.
 - Use sentence-style labels (`Thinking`, `Review`) instead of raw protocol ids unless an advanced/debug view is added later.
 
@@ -126,10 +126,10 @@ Example rows:
 
 ### Inline preview behavior
 
-- Show a small inline preview in every reaction row using the current default pet.
-- If no custom default pet is installed, use the built-in default pet.
+- Show a small inline preview in every reaction row using the current default familiar.
+- If no custom default familiar is installed, use the built-in default familiar.
 - Changing a row's dropdown should update that row's inline preview immediately.
-- Previews should not send an IPC reaction, acquire a lease, or affect live desktop pet state.
+- Previews should not send an IPC reaction, acquire a lease, or affect live desktop familiar state.
 - Previews should be local to the settings window so users can experiment safely.
 
 ### Reset behavior
@@ -146,7 +146,7 @@ Store only user overrides, not a full copy of the defaults.
 Suggested shape inside persisted desktop preferences:
 
 ```ts
-type ReactionAnimationOverrides = Partial<Record<OpenPetsReaction, UserSelectableAnimationState>>;
+type ReactionAnimationOverrides = Partial<Record<FamiliarOSReaction, UserSelectableAnimationState>>;
 
 type Preferences = {
   reactionAnimationOverrides?: ReactionAnimationOverrides;
@@ -174,13 +174,13 @@ Read/write rules:
 ## Technical approach
 
 1. **Centralize mapping metadata.**
-   - Move the current private reaction mapping and universal sprite metadata out of `pet-window.ts` into a shared desktop module, for example `apps/desktop/src/reaction-animation-mapping.ts`.
+   - Move the current private reaction mapping and universal sprite metadata out of `familiar-window.ts` into a shared desktop module, for example `apps/desktop/src/reaction-animation-mapping.ts`.
    - That module should export:
      - public reaction metadata: id, UI label, short description, default animation id,
      - selectable animation metadata: id, UI label, description,
      - the runtime resolver that applies validated overrides,
      - validation helpers for settings IPC and persisted preferences.
-   - Runtime pet rendering and Settings UI should consume this shared metadata so the table, preview, and live pet behavior cannot drift.
+   - Runtime familiar rendering and Settings UI should consume this shared metadata so the table, preview, and live familiar behavior cannot drift.
 
 2. **Add persisted settings overrides.**
    - Extend desktop app state with reaction animation overrides.
@@ -190,8 +190,8 @@ Read/write rules:
 
 3. **Update runtime reaction mapping.**
    - Runtime animation resolution becomes `reaction -> configured animation -> default animation -> idle fallback`.
-   - Drag still overrides reaction animation while the pet is being dragged.
-   - The configured mapping applies globally to default pets and explicit/agent pets because both render through the shared pet window path.
+   - Drag still overrides reaction animation while the familiar is being dragged.
+   - The configured mapping applies globally to default familiars and explicit/agent familiars because both render through the shared familiar window path.
    - One-shot versus looping behavior follows the selected animation state. For example, if `thinking` maps to `jumping`, it uses jumping's finite-loop behavior; if `success` maps to `running`, it loops for the transient lifetime.
 
 4. **Build the settings table.**
@@ -201,11 +201,11 @@ Read/write rules:
    - Use exact transition properties; avoid `transition: all`.
 
 5. **Add preview renderer.**
-   - Reuse the existing pet rendering/CSS constants if possible so preview and desktop pet do not drift.
-   - Preview should run in the settings window, not in the live transparent pet window.
-   - The settings preview must obtain a safe spritesheet URL from the main process for the current default pet.
+   - Reuse the existing familiar rendering/CSS constants if possible so preview and desktop familiar do not drift.
+   - Preview should run in the settings window, not in the live transparent familiar window.
+   - The settings preview must obtain a safe spritesheet URL from the main process for the current default familiar.
    - Built-in preview assets may use a data URL or another narrow trusted route.
-   - Installed default pets should use a scoped internal protocol or equivalent safe main-process route, not arbitrary renderer file access.
+   - Installed default familiars should use a scoped internal protocol or equivalent safe main-process route, not arbitrary renderer file access.
    - Update the Settings CSP for the chosen image source. Do not loosen CSP beyond what the preview needs.
 
 6. **Add reset/default affordances.**
@@ -215,18 +215,18 @@ Read/write rules:
 ## Acceptance criteria
 
 - Settings includes a **Reaction animations** table.
-- Every public OpenPets reaction appears exactly once.
+- Every public FamiliarOS reaction appears exactly once.
 - Each reaction can be mapped to one allowed non-drag animation target.
-- Each row's current/default pet inline preview shows the selected animation clearly.
-- Inline previews do not trigger live pet reactions, leases, speech bubbles, or status badges.
+- Each row's current/default familiar inline preview shows the selected animation clearly.
+- Inline previews do not trigger live familiar reactions, leases, speech bubbles, or status badges.
 - Reset to defaults restores the built-in mapping.
 - Invalid saved mappings fall back safely to defaults.
 - Settings IPC rejects unknown reactions, unknown animation states, and drag-only states.
-- Configured mapping applies to default pets and explicit/agent pets.
+- Configured mapping applies to default familiars and explicit/agent familiars.
 - An explicit `idle` reaction override does not change the baseline no-reaction idle state.
 - One-shot/loop duration follows the selected animation state.
 - Drag animations remain unaffected and still override active reaction animation while dragging.
-- Reduced-motion behavior is respected in preview and live pet rendering.
+- Reduced-motion behavior is respected in preview and live familiar rendering.
 - `docs/mapping.md` is updated after implementation to mention user overrides and the new reaction-animation mapping source of truth.
 - Tests or contract checks cover:
   - every public reaction has table metadata,
@@ -237,17 +237,17 @@ Read/write rules:
 
 ## Implementation todo plan
 
-1. Extract reaction/animation metadata from `pet-window.ts` into `apps/desktop/src/reaction-animation-mapping.ts`.
+1. Extract reaction/animation metadata from `familiar-window.ts` into `apps/desktop/src/reaction-animation-mapping.ts`.
 2. Add validation helpers for selectable animation ids, public reaction ids, persisted overrides, and Settings IPC payloads.
 3. Extend persisted desktop preferences with `reactionAnimationOverrides`, storing only values that differ from defaults.
-4. Wire runtime pet rendering to resolve reaction animation through the validated user overrides for both default and explicit/agent pets.
+4. Wire runtime familiar rendering to resolve reaction animation through the validated user overrides for both default and explicit/agent familiars.
 5. Add or extend Settings IPC so the renderer can read metadata, read current overrides, update one mapping, and reset mappings safely.
-6. Add a safe main-process preview asset route for the current default pet and update the Settings CSP narrowly for that route.
+6. Add a safe main-process preview asset route for the current default familiar and update the Settings CSP narrowly for that route.
 7. Build the Settings **Reaction animations** table with dropdowns, default/changed indicators, reset-to-defaults, and at least 40px row controls.
-8. Add per-row default-pet inline previews in Settings that reuse shared sprite constants and never touch live pet windows, leases, bubbles, or status badges.
+8. Add per-row default-familiar inline previews in Settings that reuse shared sprite constants and never touch live familiar windows, leases, bubbles, or status badges.
 9. Add contract/tests for metadata exhaustiveness, default validity, override normalization, Settings IPC rejection, runtime fallback, and drag-only exclusion.
 10. Update `docs/mapping.md` to document that defaults can be overridden in Settings.
-11. Manually verify built-in default pet preview, installed default pet preview, reduced motion, default pet reactions, explicit/agent pet reactions, reset behavior, and invalid saved config fallback.
+11. Manually verify built-in default familiar preview, installed default familiar preview, reduced motion, default familiar reactions, explicit/agent familiar reactions, reset behavior, and invalid saved config fallback.
 
 ## Manual verification guide
 
@@ -256,37 +256,37 @@ After implementation:
 1. Open Settings and find **Reaction animations**.
 2. Confirm every public reaction appears once and labels are understandable without protocol knowledge.
 3. Change `thinking` to `jumping`; confirm that row's inline preview jumps and the row shows **Changed**.
-4. Trigger a live `thinking` reaction on the default pet; confirm it uses jumping's finite-loop behavior.
-5. Configure or trigger an explicit/agent pet; confirm the same mapping applies globally.
+4. Trigger a live `thinking` reaction on the default familiar; confirm it uses jumping's finite-loop behavior.
+5. Configure or trigger an explicit/agent familiar; confirm the same mapping applies globally.
 6. Change `success` to `running`; confirm it loops for the transient lifetime.
 7. Change `idle` to `waving`; trigger an explicit `idle` reaction and confirm only that transient event uses the override, then confirm the no-active-reaction baseline returns to canonical idle.
 8. Confirm dragging still uses left/right running animations and returns to the active reaction animation afterward.
 9. Reset to defaults; confirm overrides are removed and behavior matches the default mapping table.
-10. Repeat inline preview checks with an installed default pet and with the built-in fallback pet.
+10. Repeat inline preview checks with an installed default familiar and with the built-in fallback familiar.
 11. Enable reduced motion and confirm preview/live behavior respects it.
 12. Inject or simulate invalid saved mappings; confirm they are dropped and defaults are used.
 
 ## Risks and tradeoffs
 
 - Too much control can make the UI feel technical. Keep labels plain and use preview to explain meaning visually.
-- Preview and live pet rendering can drift if they duplicate CSS/state constants. Prefer shared metadata/constants.
+- Preview and live familiar rendering can drift if they duplicate CSS/state constants. Prefer shared metadata/constants.
 - Preview asset loading can accidentally broaden renderer file access. Keep asset access mediated by the main process and CSP-scoped.
-- If users map many reactions to the same animation, pet feedback becomes less informative. This is acceptable because it is an explicit user preference.
-- Per-pet mappings may be desirable later, but global mapping is easier to explain and safer for the first version.
+- If users map many reactions to the same animation, familiar feedback becomes less informative. This is acceptable because it is an explicit user preference.
+- Per-familiar mappings may be desirable later, but global mapping is easier to explain and safer for the first version.
 
 ## Future extensions
 
-- Per-pet reaction animation mappings.
+- Per-familiar reaction animation mappings.
 - Import/export reaction profiles.
 - Presets such as **Expressive**, **Subtle**, and **Quiet**.
 - Bubble/status display preferences per reaction.
-- Pet package metadata that suggests preferred default mappings for custom pets.
+- Familiar package metadata that suggests preferred default mappings for custom familiars.
 
 ## Oracle plan review
 
 Reviewed by Oracle before implementation.
 
-Verdict: conditionally approved. Product scope is right: global reaction-to-animation overrides, default-pet preview, no bubble/status-badge settings.
+Verdict: conditionally approved. Product scope is right: global reaction-to-animation overrides, default-familiar preview, no bubble/status-badge settings.
 
 First review feedback disposition:
 
@@ -295,7 +295,7 @@ First review feedback disposition:
 - Added persistence location, normalization, reset, and write semantics.
 - Required Settings IPC validation for unknown reactions, unknown animation ids, and drag-only states.
 - Added safe preview asset loading and CSP requirements.
-- Clarified global runtime scope across default and explicit/agent pets.
+- Clarified global runtime scope across default and explicit/agent familiars.
 - Clarified explicit `idle` reaction semantics versus baseline no-reaction idle.
 - Specified one-shot/loop behavior follows the selected animation state.
 - Chose auto-save to match current Settings behavior.
@@ -306,6 +306,6 @@ Second review verdict: approved for implementation, no blockers.
 Second review feedback disposition:
 
 - Added `idle` and `running` to the first user-visible example table so it includes every public reaction.
-- Clarified that preview is isolated inside Settings and does not affect the live desktop pet.
+- Clarified that preview is isolated inside Settings and does not affect the live desktop familiar.
 - Required `docs/mapping.md` to reference the new mapping source of truth after implementation.
 - Added manual verification for explicit `idle` override semantics.
diff --git a/docs/plugins.md b/docs/plugins.md
index 988db65e..738b4f03 100644
--- a/docs/plugins.md
+++ b/docs/plugins.md
@@ -1,4 +1,4 @@
-# OpenPets Plugin Platform (SDK v3 / SuperPlugins)
+# FamiliarOS Plugin Platform (SDK v3 / SuperPlugins)
 
 This is the reference for the current plugin platform. The forward-looking
 spec that drove this implementation is `docs/superplugins.md`; this document
@@ -14,10 +14,10 @@ plugin package (manifest + entry + assets + panels)
   -> plugin-sdk-preload.cjs   builds the plugin-facing ctx (handles, subscriptions)
   -> plugin-sdk-bridge.ts     validation, permissions, quotas (the security boundary)
   -> plugin-host-capabilities.ts  Electron side effects (one instance, injected at startup)
-       bubbles  -> plugin-bubble-arbiter.ts -> default-pet-controller / plugin-pet-registry -> pet-window.ts
-       audio/tts -> pet window renderer (WebAudio recipes, data-URL playback, speechSynthesis)
-       events   -> plugin-events-source.ts (pet windows, powerMonitor, screen, pollers)
-       pets     -> plugin-pet-registry.ts + pet-motion-engine.ts (spawn, moveTo, followCursor, physics, onTick)
+       bubbles  -> plugin-bubble-arbiter.ts -> default-familiar-controller / plugin-familiar-registry -> familiar-window.ts
+       audio/tts -> familiar window renderer (WebAudio recipes, data-URL playback, speechSynthesis)
+       events   -> plugin-events-source.ts (familiar windows, powerMonitor, screen, pollers)
+       familiars     -> plugin-familiar-registry.ts + familiar-motion-engine.ts (spawn, moveTo, followCursor, physics, onTick)
        panels   -> plugin-panels.ts (+ panel-preload.cjs)
        ai       -> plugin-ai-gateway.ts (Anthropic / OpenAI / Ollama)
        secrets  -> plugin-secrets.ts (safeStorage-encrypted, per plugin)
@@ -28,14 +28,14 @@ plugin package (manifest + entry + assets + panels)
 ```
 
 The single governing rule: **plugins describe; the host renders.** Bubbles are
-descriptors validated in the bridge and rendered by `pet-window.ts`. Plugin
-HTML runs only inside the sandboxed *panel* window (`ui:panel`), never in a pet
+descriptors validated in the bridge and rendered by `familiar-window.ts`. Plugin
+HTML runs only inside the sandboxed *panel* window (`ui:panel`), never in a familiar
 window.
 
 ## Manifest
 
-`openpets.plugin.json`, validated by `apps/desktop/src/plugin-manifest.ts`.
-A JSON Schema ships with the CLI (`packages/cli/schemas/openpets.plugin.schema.json`);
+`familiaros.plugin.json`, validated by `apps/desktop/src/plugin-manifest.ts`.
+A JSON Schema ships with the CLI (`packages/cli/schemas/familiaros.plugin.schema.json`);
 manifests may carry `$schema` for editor validation.
 
 - `manifestVersion: 1` — declarative timer plugins (legacy).
@@ -59,18 +59,18 @@ renderer preload routes.
 
 ## Permissions (v3)
 
-Existing: `pet:speak`, `pet:reaction`, `pet:move`, `schedule`, `storage`,
+Existing: `familiar:speak`, `familiar:reaction`, `familiar:move`, `schedule`, `storage`,
 `status`, `commands`, `network` (+ declarative-only `timer`).
 
-New in v3: `pet:interact` (bubble buttons/inputs), `pet:pin` (pinned slot),
-`pet:animate` (custom sprites/scale), `pet:speak:dynamic` (AI-generated speech),
-`pet:drop` (drag-and-drop onto the pet), `pets:read`, `pets:manage` (spawn/close),
+New in v3: `familiar:interact` (bubble buttons/inputs), `familiar:pin` (pinned slot),
+`familiar:animate` (custom sprites/scale), `familiar:speak:dynamic` (AI-generated speech),
+`familiar:drop` (drag-and-drop onto the familiar), `familiars:read`, `familiars:manage` (spawn/close),
 `audio`, `events`, `ui:toast`, `ui:panel`, `notify`, `bus`, `ai`, `secrets`,
 `voice:speak`, `voice:listen`, `auth`, `files`, `system:openExternal`,
 `system:metrics`, `clipboard`, `network:write`.
 
 Flagged **sensitive** (louder consent, gated by global settings, default off):
-`voice:listen`, `clipboard`, `pet:speak:dynamic`
+`voice:listen`, `clipboard`, `familiar:speak:dynamic`
 (`sensitivePluginPermissions` in `plugin-manifest.ts`).
 
 Trust model: declared permissions + user approval at install + catalog review.
@@ -78,8 +78,8 @@ No signing tier (deliberate — see `docs/superplugins.md` §15).
 
 ## The SDK surface
 
-Types: `packages/sdk/src/index.ts` (`@open-pets/plugin-sdk`, v3). The
-namespaces on `ctx`: `pets`, `pet` (alias of `pets.default`), `ui` (bubbles,
+Types: `packages/sdk/src/index.ts` (`@familiaros/plugin-sdk`, v3). The
+namespaces on `ctx`: `familiars`, `familiar` (alias of `familiars.default`), `ui` (bubbles,
 alert, toast, panel, dynamic menu), `audio`, `events`, `assets`, `bus`, `schedule`
 (`once`/`every`/`daily`/`cron`/`at`/`list`), `storage` (now with `keys` +
 `subscribe`, ~5 MB quota), `config`, `net` (`fetch` with non-GET +
@@ -88,21 +88,21 @@ alert, toast, panel, dynamic menu), `audio`, `events`, `assets`, `bus`, `schedul
 
 Hard lines kept regardless of permissions:
 
-- The render rule above (no raw markup into pet windows).
+- The render rule above (no raw markup into familiar windows).
 - The privacy line (§3.1): no keystrokes, no screen contents, no other apps'
 
 - `ctx.ui.alert(...)` is the must-not-miss delivery helper: it renders a sticky,
-high-priority pet bubble and can optionally request `sound`, `notify`, actions,
+high-priority familiar bubble and can optionally request `sound`, `notify`, actions,
 `dismissOn`, an `indicator`, and rich bubble content (`text`, limited
 `markdown`, `icon`, `svg`, `image`, `tone`). `indicator` renders the top header
-row used by pet status messages, but is alert-owned instead of a pet reaction: it
+row used by familiar status messages, but is alert-owned instead of a familiar reaction: it
 accepts a named host icon or a manifest-declared asset via `ctx.assets.icon(...)`
 / `ctx.assets.svg(...)` / `ctx.assets.image(...)`, plus safe `color`,
 `background`/`backgroundColor`, and `borderColor` values. Raw SVG strings are
 not accepted at runtime; bundle SVGs in `assets` so the host can validate and
 sanitize them at install. Bubble body media (`icon`, `svg`, `image`) is
 icon-only and cannot be combined with `text`/`markdown`; use `indicator` for
-icon + message alerts. Alerts require `pet:speak`; `pet:interact` is only
+icon + message alerts. Alerts require `familiar:speak`; `familiar:interact` is only
 needed for actions/input, `audio` only when `sound` is set, and `notify` only
 when `notify` is set. The returned handle behaves like a bubble handle and adds
 `acknowledge()`.
@@ -118,8 +118,8 @@ when `notify` is set. The returned handle behaves like a bubble handle and adds
 
 Quotas live in `pluginSdkQuotas` (`plugin-sdk-bridge.ts`).
 
-Reactions require `pet:reaction`: `ctx.pet.react(reaction)` preserves the built-in
-reaction/status bubble, while `ctx.pet.react(reaction, { showMessage: false })`
+Reactions require `familiar:reaction`: `ctx.familiar.react(reaction)` preserves the built-in
+reaction/status bubble, while `ctx.familiar.react(reaction, { showMessage: false })`
 plays the animation without generating that default text.
 
 ## Plugin i18n
@@ -145,33 +145,33 @@ Two ways to use those keys:
   current locale string. Example: `ctx.t("reminder.due", { message })`.
 
 Keep placeholders intact across locales and leave brand names untranslated. The
-reference implementations include `openpets.reminders` ("Quick Reminders") and
-`openpets.launch-buddy` ("Launch Buddy"), with the reminder flow mirrored by the
+reference implementations include `familiaros.reminders` ("Quick Reminders") and
+`familiaros.launch-buddy` ("Launch Buddy"), with the reminder flow mirrored by the
 CLI `reminder` template.
 
 ## Bubbles & the arbiter
 
-`ctx.ui.bubble(spec)` / `pet.speak(spec)` accept a string or a descriptor
+`ctx.ui.bubble(spec)` / `familiar.speak(spec)` accept a string or a descriptor
 (text, limited markdown, icon/svg/image refs, tone, accent token, duration,
 sticky, pin, dismissOn, priority, actions, input, hud) and return a live handle
 (`update`, `dismiss`, `pin`, `unpin`, `onAction`, `onSubmit`, `onDismiss`).
 
 A **pinned mini HUD bubble** can be rendered using the `hud` descriptor (requires `pin: true`). The `hud` property takes an `items` array (1–4 items), where each item has `icon` (named host icon or asset ref), `value` (0–100), optional `label`, and optional `tone` ("amber", "blue", "green", "pink", "slate", "red"). When `hud` is present, it must not be combined with text, markdown, body media, or indicator. Pinned bubbles with `hud` render as a compact, polished 2x2 grid with CSS progress bars, avoiding emoji alignment issues.
 
-`plugin-bubble-arbiter.ts` (one per pet surface) arbitrates: priority queue,
+`plugin-bubble-arbiter.ts` (one per familiar surface) arbitrates: priority queue,
 do-not-interrupt for sticky/urgent, coalescing of identical back-to-back
 messages, and a single **pinned slot** above the transient slot with
 priority-aware replace semantics. Non-dynamic transient text goes through the
 static content filter and stays single-line; pinned text may use a few safe lines
-for compact status HUDs. `dynamic: true` content needs `pet:speak:dynamic` plus
+for compact status HUDs. `dynamic: true` content needs `familiar:speak:dynamic` plus
 the global toggle and gets the relaxed screen (2,000 chars, secret redaction).
 
-## Multi-pet & liveness
+## Multi-familiar & liveness
 
-`ctx.pets.spawn({ petId })` opens an ephemeral window for an installed pet
+`ctx.familiars.spawn({ petId })` opens an ephemeral window for an installed familiar
 (max 4 per plugin), addressable via handles. `onTick` is the host-driven brain
 loop (~10 fps, paused while hidden/dragging); `getState` gives self-perception;
-`moveTo`/`followCursor`/`physics` run in `pet-motion-engine.ts`. Spawned pets
+`moveTo`/`followCursor`/`physics` run in `familiar-motion-engine.ts`. Spawned familiars
 are torn down with their plugin.
 
 ## Host integrations
@@ -184,7 +184,7 @@ are torn down with their plugin.
   system browser; tokens persist in the plugin's secrets and are returned to
   the plugin. `refresh`/`signOut` manage the stored session.
 - **Files** — OS dialogs only (`pick`/`save`); reads are size-capped, one-shot
-  handles. Dropped files (`pet:drop`) are readable through the same accessor.
+  handles. Dropped files (`familiar:drop`) are readable through the same accessor.
 - **System** — `info()` (platform/locale/timezone/theme/version/online) is
   always available; `metrics()` (aggregate CPU/mem only) needs
   `system:metrics`; `openExternal` is HTTPS-only.
@@ -200,22 +200,22 @@ are torn down with their plugin.
 
 ```bash
 # scaffold (templates: blank | reminder | ambient | ai-chat | tamagotchi | calendar)
-npx @open-pets/cli plugin new "My Plugin" --template tamagotchi
+npx @familiaros/cli plugin new "My Plugin" --template tamagotchi
 
 # author-time validation: manifest, config schema, permissions, declared files
-npx @open-pets/cli plugin validate ./my-plugin
+npx @familiaros/cli plugin validate ./my-plugin
 
 # deterministic tests without the app (fake clock, event injection, mocks)
-npm test            # runs test.js against @open-pets/plugin-sdk/testing
+npm test            # runs test.js against @familiaros/plugin-sdk/testing
 
 # live with hot reload — saving a file re-snapshots and reloads just that
 # plugin, preserving enabled state, storage, and approved permissions
-OPENPETS_DEV_PLUGIN_PATHS=$(pwd)/my-plugin pnpm dev:desktop
+FAMILIAROS_DEV_PLUGIN_PATHS=$(pwd)/my-plugin pnpm dev:desktop
 # or for a folder of plugins (this is what pnpm dev:desktop:plugins uses)
-OPENPETS_DEV_PLUGIN_ROOTS=$(pwd)/plugins/official pnpm dev:desktop
+FAMILIAROS_DEV_PLUGIN_ROOTS=$(pwd)/plugins/official pnpm dev:desktop
 ```
 
-The test kit is `@open-pets/plugin-sdk/testing` (`createTestHarness`): fake
+The test kit is `@familiaros/plugin-sdk/testing` (`createTestHarness`): fake
 clock (`clock.advance("90m")` drives `once`/`every`/`daily`/`cron`/`at`),
 curated event injection (`emit`), bubble interaction
 (`fireBubbleAction`/`fireBubbleSubmit`), command runs, permission simulation
@@ -224,7 +224,7 @@ curated event injection (`emit`), bubble interaction
 `expectScheduled`, `expectBubble` (matches descriptors, not pixels),
 `expectStored`, `expectNetCall`, `expectNotified`, `expectNoErrors`.
 
-Runtime introspection: `openpets:plugins-inspector` IPC
+Runtime introspection: `familiaros:plugins-inspector` IPC
 (`runtime.getInspectorState(id)`) returns schedules + next runs, registered
 commands/menu items, active bubbles/panels, subscription counts, quota
 counters, and the last error.
@@ -234,7 +234,7 @@ counters, and the last error.
 Unchanged flow: `pnpm plugins:check` validates and packages `plugins/official`
 into ZIPs + catalog (dry-run); `plugins:publish` uploads. v3 ZIPs may contain
 the manifest, the entry, and every declared asset/panel file — nothing else.
-Catalog min/max-OpenPets-version metadata gates what loads where; v2 plugins
+Catalog min/max-FamiliarOS-version metadata gates what loads where; v2 plugins
 keep loading through the same runtime (the v3 context is a superset).
 
 ## Drift guards & CI
@@ -242,7 +242,7 @@ keep loading through the same runtime (the v3 context is a superset).
 - `apps/desktop/src/check-plugin-sdk-conformance.ts` — compile-time guard that
   the bridge surface and permission union match the published SDK types.
 - `packages/sdk/src/check-plugin-sdk.ts` — runtime contract test of the mock
-  context (used by `pnpm --filter @open-pets/plugin-sdk test`).
+  context (used by `pnpm --filter @familiaros/plugin-sdk test`).
 - `apps/desktop/tests/plugin-bridge-fuzz.test.ts` — property/fuzz tests over
   the bridge validators (cron, markdown, dynamic-text redaction, SVG/panel
   sanitizers, private-IP guard, form values, arbiter invariants).
@@ -262,4 +262,4 @@ keep loading through the same runtime (the v3 context is a superset).
 - *Renderer-visible URL schemes*: per `AGENTS.md`, any new scheme needs CSP
   updates in `apps/desktop/vite.config.ts` and
   `apps/desktop/src/renderer/index.html`. The v3 features deliberately reuse
-  `file:` (already allowed in pet windows) and add no new schemes.
+  `file:` (already allowed in familiar windows) and add no new schemes.
diff --git a/docs/pull-requests/OPENPETS_3_1_0_FIXES_PULL_REQUESTS.md b/docs/pull-requests/OPENPETS_3_1_0_FIXES_PULL_REQUESTS.md
index e8eaf886..66728710 100644
--- a/docs/pull-requests/OPENPETS_3_1_0_FIXES_PULL_REQUESTS.md
+++ b/docs/pull-requests/OPENPETS_3_1_0_FIXES_PULL_REQUESTS.md
@@ -1,23 +1,23 @@
-# OpenPets v3.1.0 — Categorized fix PRs (post-OP1–6)
+# FamiliarOS v3.1.0 — Categorized fix PRs (post-OP1–6)
 
 The combined commit `41920b0` on `v3.1.0-integrated` contains the seven follow-up fixes requested after the OP 1–6 integration. The commits below split `41920b0` into three focused, reviewable PRs, each based on `03ae162` (the previous integration point).
 
-Two additional follow-up commits (`727cce0`) address the remaining signed-build prompt-window failures and the missing pet-scale handle.
+Two additional follow-up commits (`727cce0`) address the remaining signed-build prompt-window failures and the missing familiar-scale handle.
 
 Target branch for each PR: a base that already includes `03ae162` (e.g. `v3.1.0-integrated` before `41920b0`, or `main` once the OP 1–6 companion-fix commit lands).
 
 ---
 
-## 1. Pet window stability
-- **Branch:** `fix/pet-window-stability`
+## 1. Familiar window stability
+- **Branch:** `fix/familiar-window-stability`
 - **Commit:** `11ed7b3`
-- **Files:** `apps/desktop/pet-preload.cjs`, `apps/desktop/src/pet-window.ts`
+- **Files:** `apps/desktop/familiar-preload.cjs`, `apps/desktop/src/familiar-window.ts`
 - **What changed:**
-  - Removed the post-drag resize that made the pet jump on mouse-up.
-  - Rewrote `resizePetWindowForDisplay` / `resizePetWindowForScale` to anchor around the pet’s current foot/center position instead of the 220×320 default size.
+  - Removed the post-drag resize that made the familiar jump on mouse-up.
+  - Rewrote `resizePetWindowForDisplay` / `resizePetWindowForScale` to anchor around the familiar’s current foot/center position instead of the 220×320 default size.
   - Switched the scale-handle drag to use `screenY` and removed the 120 ms preview throttle so dragging is smooth.
-- **GitHub compare (vs `03ae162`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/03ae162...fix/pet-window-stability
-- **Forgejo compare (vs `03ae162`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/03ae162...fix/pet-window-stability
+- **GitHub compare (vs `03ae162`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/03ae162...fix/familiar-window-stability
+- **Forgejo compare (vs `03ae162`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/03ae162...fix/familiar-window-stability
 
 ---
 
@@ -26,12 +26,12 @@ Target branch for each PR: a base that already includes `03ae162` (e.g. `v3.1.0-
 - **Commit:** `53b8435`
 - **Files:** `apps/desktop/src/app-state-core.ts`, `apps/desktop/src/renderer/src/main.tsx`, `apps/desktop/tests/onboarding-state.test.ts`
 - **What changed:**
-  - Reintroduced the pet-scale preset dropdown with abbreviated labels: `XXXS, XXS, XS, S, M, L, XL, XXL, XXXL`.
+  - Reintroduced the familiar-scale preset dropdown with abbreviated labels: `XXXS, XXS, XS, S, M, L, XL, XXL, XXXL`.
   - Added `XXXS = 0.16` to the canonical options.
   - Placed the dropdown above the existing slider in Settings > General.
   - Updated the onboarding state test to expect the new option list.
-- **GitHub compare (vs `03ae162`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/03ae162...feat/scale-preset-dropdown
-- **Forgejo compare (vs `03ae162`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/03ae162...feat/scale-preset-dropdown
+- **GitHub compare (vs `03ae162`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/03ae162...feat/scale-preset-dropdown
+- **Forgejo compare (vs `03ae162`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/03ae162...feat/scale-preset-dropdown
 
 ---
 
@@ -46,8 +46,8 @@ Target branch for each PR: a base that already includes `03ae162` (e.g. `v3.1.0-
   - `New chat` opens the editor in message view after creating a conversation.
   - Added a guard against a missing prompt-window API object.
   - Added preload files to `asarUnpack` so sandboxed packaged builds load the preload correctly.
-- **GitHub compare (vs `03ae162`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/03ae162...fix/prompt-window-hardening
-- **Forgejo compare (vs `03ae162`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/03ae162...fix/prompt-window-hardening
+- **GitHub compare (vs `03ae162`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/03ae162...fix/prompt-window-hardening
+- **Forgejo compare (vs `03ae162`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/03ae162...fix/prompt-window-hardening
 
 ---
 
@@ -60,37 +60,37 @@ Target branch for each PR: a base that already includes `03ae162` (e.g. `v3.1.0-
   - Resolved the preload path relative to `import.meta.url` so the unpacked `prompt-window-preload.cjs` is found in `app.asar.unpacked`.
   - Added a guard against a missing `window.openPetsPromptWindow` API object.
   - Added renderer error logging through the preload bridge so future signed-build issues are easier to diagnose.
-- **GitHub compare (vs `41920b0`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/41920b0...fix/prompt-window-signed-build
-- **Forgejo compare (vs `41920b0`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/41920b0...fix/prompt-window-signed-build
+- **GitHub compare (vs `41920b0`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/41920b0...fix/prompt-window-signed-build
+- **Forgejo compare (vs `41920b0`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/41920b0...fix/prompt-window-signed-build
 - **Note:** The temp-file approach in this branch was later abandoned. The final signed-build fix reverts to the original `data:`-URL + sandboxed-preload loader; see **Post-PR fixes** below.
 
 ---
 
-## 5. Pet scale handle + keyboard nudges
+## 5. Familiar scale handle + keyboard nudges
 - **Branch:** `fix/scale-handle-and-keyboard`
 - **Commit:** `be21907`
-- **Files:** `apps/desktop/src/pet-window.ts`, `apps/desktop/pet-preload.cjs`
+- **Files:** `apps/desktop/src/familiar-window.ts`, `apps/desktop/familiar-preload.cjs`
 - **What changed:**
-  - Added a rendered `.scale-handle` element inside the pet shell (it was missing entirely) and gave it visible styling, pointer events, and focus styles so it is grabbable.
-  - Added keyboard arrow nudges (Left/Right and Up/Down) to adjust pet scale when the pet window is focused, with a 250 ms debounced commit.
-- **GitHub compare (vs `41920b0`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/41920b0...fix/scale-handle-and-keyboard
-- **Forgejo compare (vs `41920b0`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/41920b0...fix/scale-handle-and-keyboard
+  - Added a rendered `.scale-handle` element inside the familiar shell (it was missing entirely) and gave it visible styling, pointer events, and focus styles so it is grabbable.
+  - Added keyboard arrow nudges (Left/Right and Up/Down) to adjust familiar scale when the familiar window is focused, with a 250 ms debounced commit.
+- **GitHub compare (vs `41920b0`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/41920b0...fix/scale-handle-and-keyboard
+- **Forgejo compare (vs `41920b0`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/41920b0...fix/scale-handle-and-keyboard
 
 ---
 
-## 6. Virtual-pet context menu rename/reorder
-- **Branch:** `refactor/virtual-pet-context-menu`
+## 6. Virtual-familiar context menu rename/reorder
+- **Branch:** `refactor/virtual-familiar-context-menu`
 - **Commit:** `ab62d9c`
-- **Files:** `apps/desktop/src/pet-window.ts`, `plugins/official/openpets.virtual-pet/index.js`, `plugins/official/openpets.virtual-pet/locales/en.json`, `plugins/official/openpets.virtual-pet/test.js`
+- **Files:** `apps/desktop/src/familiar-window.ts`, `plugins/official/familiaros.virtual-familiar/index.js`, `plugins/official/familiaros.virtual-familiar/locales/en.json`, `plugins/official/familiaros.virtual-familiar/test.js`
 - **What changed:**
-  - Renamed the right-click submenu from **Virtual Pet** to **Pet Status**.
-  - Switched all virtual-pet context-menu labels to Title Casing: **Check On Pet**, **Pet**, **Play Game**, **Feed Snack**, **Let Rest**, **Pet Status**.
-  - Moved the care actions (**Pet / Play Game / Feed Snack / Let Rest**) to the top level.
-  - Placed the **Pet Status** submenu directly under **Check On Pet**.
+  - Renamed the right-click submenu from **Virtual Familiar** to **Familiar Status**.
+  - Switched all virtual-familiar context-menu labels to Title Casing: **Check On Familiar**, **Familiar**, **Play Game**, **Feed Snack**, **Let Rest**, **Familiar Status**.
+  - Moved the care actions (**Familiar / Play Game / Feed Snack / Let Rest**) to the top level.
+  - Placed the **Familiar Status** submenu directly under **Check On Familiar**.
   - Reordered stat rows to **Level, Bond, Mood, Play, Food, Energy**.
   - Updated the plugin golden test to match the new row grouping.
-- **GitHub compare (vs `7a4d287`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/7a4d287...refactor/virtual-pet-context-menu
-- **Forgejo compare (vs `7a4d287`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/7a4d287...refactor/virtual-pet-context-menu
+- **GitHub compare (vs `7a4d287`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/7a4d287...refactor/virtual-familiar-context-menu
+- **Forgejo compare (vs `7a4d287`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/7a4d287...refactor/virtual-familiar-context-menu
 
 ---
 
@@ -113,15 +113,15 @@ The following commits landed after the initial PR set above, driven by packaged-
   - The attachment separator strings were written as `'\n'` inside the TypeScript template literal that builds the HTML, which produced real newlines in the packaged `<script>` block and broke parsing.
   - Changed them to `'\\n'` so the generated HTML contains the JS escape sequence `\n`.
 - **Verification:**
-  - Launched the packaged `win-unpacked\openpets.exe` on `DESKTOP-KS3VGHU` via the reverse SSH tunnel.
+  - Launched the packaged `win-unpacked\familiaros.exe` on `DESKTOP-KS3VGHU` via the reverse SSH tunnel.
   - Drove the app through Chrome DevTools Protocol: opened the prompt window, confirmed `window.openPetsPromptWindow`, input, send, and attach elements exist, and verified typing enables the send button with no renderer exceptions.
 
-### 9. Pet-scale handle removal / Settings nudges
+### 9. Familiar-scale handle removal / Settings nudges
 - **Commit:** `26d446f`
-- **Files:** `apps/desktop/src/pet-window.ts`, `apps/desktop/src/renderer/src/main.tsx`, `apps/desktop/src/renderer/src/styles.css`
+- **Files:** `apps/desktop/src/familiar-window.ts`, `apps/desktop/src/renderer/src/main.tsx`, `apps/desktop/src/renderer/src/styles.css`
 - **What changed:**
-  - Removed the non-functional on-pet scale handle.
-  - Added `+` / `-` nudge buttons next to the pet-scale slider in Settings > General.
+  - Removed the non-functional on-familiar scale handle.
+  - Added `+` / `-` nudge buttons next to the familiar-scale slider in Settings > General.
 
 ---
 
@@ -133,12 +133,12 @@ The following commits landed after the initial PR set above, driven by packaged-
 - Merging the first three branches produces `41920b0` exactly.
 - Merging all six original branches plus the post-PR fixes produces the current `v3.1.0-integrated` tip.
 - Forgejo is updated with `v3.1.0-integrated`.
-- GitHub `verticaltension/openpetswithchatandmcp` updated with `v3.1.0-integrated`.
-- GitHub `origin` (`alvinunreal/openpets`) push still fails with 403 (no write access in this session).
+- GitHub `verticaltension/familiaroswithchatandmcp` updated with `v3.1.0-integrated`.
+- GitHub `origin` (`alvinunreal/familiaros`) push still fails with 403 (no write access in this session).
 - `FEATURE_REGISTRY.md` now maps every feature to its branch, commits, and files.
 - Signed Windows installer built on `DESKTOP-KS3VGHU` and copied to `C:\Users\Anthracite Ace\Downloads`:
-  - `OpenPets-3.1.0-win-x64-setup.exe` (158,520,543 bytes)
-  - `OpenPets-3.1.0-win-x64-portable.exe` (158,185,389 bytes)
+  - `FamiliarOS-3.1.0-win-x64-setup.exe` (158,520,543 bytes)
+  - `FamiliarOS-3.1.0-win-x64-portable.exe` (158,185,389 bytes)
   - SHA256: `6ea493c7af0b24179d3f6b206c3c3aed50a5ba9fd24c4fc33d822ba42fd09e0e`
 
 ## 10. Knowledge Store hardening
@@ -156,10 +156,10 @@ The following commits landed after the initial PR set above, driven by packaged-
   - `pnpm -r check` ✅
   - `pnpm test` ✅
 - Forgejo updated with `v3.1.0-integrated` (`4aff369`/`d8650a9`/`f514960`/`16bfab1`).
-- GitHub `verticaltension/openpetswithchatandmcp` updated with `v3.1.0-integrated`.
-- GitHub `origin` (`alvinunreal/openpets`) push still fails with 403 (no write access in this session).
+- GitHub `verticaltension/familiaroswithchatandmcp` updated with `v3.1.0-integrated`.
+- GitHub `origin` (`alvinunreal/familiaros`) push still fails with 403 (no write access in this session).
 - Built on `DESKTOP-KS3VGHU` and copied to `C:\Users\Anthracite Ace\Downloads`:
-  - `OpenPets-3.1.0-win-x64-setup.exe` (158,520,543 bytes)
-  - `OpenPets-3.1.0-win-x64-portable.exe` (158,185,389 bytes)
+  - `FamiliarOS-3.1.0-win-x64-setup.exe` (158,520,543 bytes)
+  - `FamiliarOS-3.1.0-win-x64-portable.exe` (158,185,389 bytes)
   - SHA256: `6ea493c7af0b24179d3f6b206c3c3aed50a5ba9fd24c4fc33d822ba42fd09e0e`
 
diff --git a/docs/pull-requests/OPENPETS_3_1_0_MOD_NICHE_PULL_REQUESTS.md b/docs/pull-requests/OPENPETS_3_1_0_MOD_NICHE_PULL_REQUESTS.md
index 8b770674..3cb22bd4 100644
--- a/docs/pull-requests/OPENPETS_3_1_0_MOD_NICHE_PULL_REQUESTS.md
+++ b/docs/pull-requests/OPENPETS_3_1_0_MOD_NICHE_PULL_REQUESTS.md
@@ -1,4 +1,4 @@
-# OpenPets v3.1.0 — Pull requests by mod niche
+# FamiliarOS v3.1.0 — Pull requests by mod niche
 
 This document organizes the v3.1.0 work into the product niches that users experience. Each niche section lists the relevant branch, commits, files, and verification steps so that PRs can be reviewed in focused chunks.
 
@@ -6,33 +6,33 @@ Target branch for all PRs: `v3.1.0-integrated` (or `main` once the OP 1–6 inte
 
 ---
 
-## 1. Companion / Pet niche
-**Branch:** `pr/companion-pet-polish`  
-**Scope:** On-pet behavior, bubble rendering, scale controls, and virtual-pet interactions.
+## 1. Companion / Familiar niche
+**Branch:** `pr/companion-familiar-polish`  
+**Scope:** On-familiar behavior, bubble rendering, scale controls, and virtual-familiar interactions.
 
 ### What changed
-- **Pet window stability** — removed the post-drag resize jump, anchored resize around the pet’s foot/center, and smoothed scale-handle dragging.
+- **Familiar window stability** — removed the post-drag resize jump, anchored resize around the familiar’s foot/center, and smoothed scale-handle dragging.
 - **Scale presets + nudges** — added a preset dropdown (`XXXS`–`XXXL`) and `+`/`-` nudge buttons next to the scale slider in Settings > General.
-- **Virtual-pet context menu** — renamed the submenu to **Pet Status**, moved care actions to the top level, and reordered stat rows.
-- **Speech-bubble clipping fix** — made bubble max-width/max-height relative to the scaled pet window so larger pets no longer clip long messages.
+- **Virtual-familiar context menu** — renamed the submenu to **Familiar Status**, moved care actions to the top level, and reordered stat rows.
+- **Speech-bubble clipping fix** — made bubble max-width/max-height relative to the scaled familiar window so larger familiars no longer clip long messages.
 
 > **Note:** Single-click petting is **not** part of this v3.1.0 follow-up. It was already implemented earlier in `pr/single-click-petting` (`46028c7`) and only refined by OP1 (`be580ba`) to add a drag threshold.
 
 ### Files
-- `apps/desktop/src/pet-window.ts`
-- `apps/desktop/pet-preload.cjs`
+- `apps/desktop/src/familiar-window.ts`
+- `apps/desktop/familiar-preload.cjs`
 - `apps/desktop/src/renderer/src/main.tsx`
-- `plugins/official/openpets.virtual-pet/index.js`
-- `plugins/official/openpets.virtual-pet/locales/en.json`
-- `plugins/official/openpets.virtual-pet/test.js`
+- `plugins/official/familiaros.virtual-familiar/index.js`
+- `plugins/official/familiaros.virtual-familiar/locales/en.json`
+- `plugins/official/familiaros.virtual-familiar/test.js`
 
 ### Commits
 - `11ed7b3`, `be21907`, `ab62d9c`, `26d446f`, `f514960` (bubble/layout portion)
 
 ### Verification
-- Drag the pet window and release — it should not jump.
-- Resize the pet to `XL` or larger and send a long message — the bubble should stay fully visible.
-- Right-click the pet — the context menu should show **Check On Pet**, then care actions, then **Pet Status**.
+- Drag the familiar window and release — it should not jump.
+- Resize the familiar to `XL` or larger and send a long message — the bubble should stay fully visible.
+- Right-click the familiar — the context menu should show **Check On Familiar**, then care actions, then **Familiar Status**.
 
 ---
 
@@ -75,7 +75,7 @@ Target branch for all PRs: `v3.1.0-integrated` (or `main` once the OP 1–6 inte
 - **Prompt-window integration** — attachments can be stored directly into the Knowledge Store from the chat composer.
 
 ### Files
-- `apps/desktop/src/openpets-memory.ts`
+- `apps/desktop/src/familiaros-memory.ts`
 - `apps/desktop/src/knowledge-store-core.ts`
 - `apps/desktop/src/knowledge-store.ts`
 - `apps/desktop/src/openapi-chat.ts`
@@ -99,12 +99,12 @@ Target branch for all PRs: `v3.1.0-integrated` (or `main` once the OP 1–6 inte
 
 ## 4. MCP edition / Agent integrations niche
 **Branch:** `pr/chat-memory-mcp-toolkit` (historical main PR)  
-**Scope:** OpenPets MCP server, MCP Tool Servers, OpenPets MCP Server panel, Curated MCP Toolkit, and agent integrations.
+**Scope:** FamiliarOS MCP server, MCP Tool Servers, FamiliarOS MCP Server panel, Curated MCP Toolkit, and agent integrations.
 
 ### What changed
-- **OpenPets MCP server** (`packages/mcp/`) exposes `openpets_status`, `openpets_react`, `openpets_say`, and memory tools through the `@open-pets/mcp` package.
+- **FamiliarOS MCP server** (`packages/mcp/`) exposes `familiaros_status`, `familiaros_react`, `familiaros_say`, and memory tools through the `@familiaros/mcp` package.
 - **MCP Tool Servers** — internal stdio MCP client (`mcp-chat-client.ts`) with tiered activation UI and a ReAct-style tool loop for the built-in floating chat.
-- **OpenPets MCP Server panel** — central Control Center > Integrations card for command mode, node path, pet routing, server test, and MCP JSON copy.
+- **FamiliarOS MCP Server panel** — central Control Center > Integrations card for command mode, node path, familiar routing, server test, and MCP JSON copy.
 - **Curated MCP Toolkit** — permission-aware reference panel in Control Center > Integrations with install orchestration for Claude/Codex baselines.
 - **Agent integrations** — Claude Code, OpenCode, Cursor, and Pi setup flows; managed instructions/rules/MCP config previews.
 
@@ -123,9 +123,9 @@ Target branch for all PRs: `v3.1.0-integrated` (or `main` once the OP 1–6 inte
 
 ### Verification
 - Open Integrations > MCP Tool Servers and activate Filesystem + Fetch/Web.
-- Open Integrations > OpenPets MCP Server, choose a command mode, and click Test Server.
+- Open Integrations > FamiliarOS MCP Server, choose a command mode, and click Test Server.
 - In floating chat, ask "list my home directory files" — the activated tools should run.
-- Right-click the pet → Virtual Pet ▸ Feed/Play/Pet/Nap; stats update and the context menu reflects the new values.
+- Right-click the familiar → Virtual Familiar ▸ Feed/Play/Familiar/Nap; stats update and the context menu reflects the new values.
 
 ---
 
@@ -138,9 +138,9 @@ Target branch for all PRs: `v3.1.0-integrated` (or `main` once the OP 1–6 inte
 - The underlying plugin runtime and catalog validation fixes from the OP 1–6 integration benefit all productivity plugins.
 
 ### Files
-- `plugins/official/openpets.focus-buddy`
-- `plugins/official/openpets.reminders`
-- `plugins/official/openpets.launch-buddy`
+- `plugins/official/familiaros.focus-buddy`
+- `plugins/official/familiaros.reminders`
+- `plugins/official/familiaros.launch-buddy`
 
 ### Verification
 - Enable each plugin from the tray and confirm it registers its tools/actions without runtime errors.
@@ -156,9 +156,9 @@ Target branch for all PRs: `v3.1.0-integrated` (or `main` once the OP 1–6 inte
 - Plugin runtime hardening and catalog validation apply here as well.
 
 ### Files
-- `plugins/official/openpets.water-reminder`
-- `plugins/official/openpets.mood-check-in`
-- `plugins/official/openpets.day-routine`
+- `plugins/official/familiaros.water-reminder`
+- `plugins/official/familiaros.mood-check-in`
+- `plugins/official/familiaros.day-routine`
 
 ### Verification
 - Enable each plugin and verify its tray menu entries and scheduled prompts work.
@@ -174,11 +174,11 @@ Target branch for all PRs: `v3.1.0-integrated` (or `main` once the OP 1–6 inte
 - Plugin runtime hardening and catalog validation apply here as well.
 
 ### Files
-- `plugins/official/openpets.magic-8-ball`
-- `plugins/official/openpets.fortune-cookie`
+- `plugins/official/familiaros.magic-8-ball`
+- `plugins/official/familiaros.fortune-cookie`
 
 ### Verification
-- Trigger each plugin and confirm it returns a response through the pet or chat.
+- Trigger each plugin and confirm it returns a response through the familiar or chat.
 
 ---
 
@@ -197,21 +197,21 @@ Target branch for all PRs: `v3.1.0-integrated` (or `main` once the OP 1–6 inte
 - `apps/desktop/src/check-packaging-contract.ts`
 - `apps/desktop/scripts/run-tests.mjs`
 - `FEATURE_REGISTRY.md`
-- `docs/pull-requests/OPENPETS_3_1_0_FIXES_PULL_REQUESTS.md`
-- `docs/pull-requests/OPENPETS_3_1_0_MOD_NICHE_PULL_REQUESTS.md`
+- `docs/pull-requests/FAMILIAROS_3_1_0_FIXES_PULL_REQUESTS.md`
+- `docs/pull-requests/FAMILIAROS_3_1_0_MOD_NICHE_PULL_REQUESTS.md`
 
 ### Verification
 - `pnpm package:dir` passes the packaging contract.
-- `pnpm package` produces a signed `OpenPets-3.1.0-win-x64-setup.exe`.
+- `pnpm package` produces a signed `FamiliarOS-3.1.0-win-x64-setup.exe`.
 - Built on `DESKTOP-KS3VGHU` and copied to `C:\Users\Anthracite Ace\Downloads`:
-  - `OpenPets-3.1.0-win-x64-setup.exe` (158,520,543 bytes)
-  - `OpenPets-3.1.0-win-x64-portable.exe` (158,185,389 bytes)
-  - `OpenPets-3.1.0-win-x64-setup.exe.blockmap`
+  - `FamiliarOS-3.1.0-win-x64-setup.exe` (158,520,543 bytes)
+  - `FamiliarOS-3.1.0-win-x64-portable.exe` (158,185,389 bytes)
+  - `FamiliarOS-3.1.0-win-x64-setup.exe.blockmap`
   - SHA256: `6ea493c7af0b24179d3f6b206c3c3aed50a5ba9fd24c4fc33d822ba42fd09e0e`
 
 ---
 
 ## Cross-niche notes
 - The Knowledge Store touches both the **Knowledge / Memory** niche and the **Chat / Prompt** niche because attachments can be stored from chat.
-- The Settings UI (`main.tsx`) touches **Companion / Pet** (scale controls) and **Knowledge / Memory** (Knowledge Store tab). Reviewers may want to view the file diff once rather than per-niche.
+- The Settings UI (`main.tsx`) touches **Companion / Familiar** (scale controls) and **Knowledge / Memory** (Knowledge Store tab). Reviewers may want to view the file diff once rather than per-niche.
 - Single-click petting belongs to the older `pr/single-click-petting` PR, not the v3.1.0 follow-up batch.
diff --git a/docs/pull-requests/OPENPETS_3_1_0_PR_CONSOLIDATION_OPTIONS.md b/docs/pull-requests/OPENPETS_3_1_0_PR_CONSOLIDATION_OPTIONS.md
index 02e74380..13714593 100644
--- a/docs/pull-requests/OPENPETS_3_1_0_PR_CONSOLIDATION_OPTIONS.md
+++ b/docs/pull-requests/OPENPETS_3_1_0_PR_CONSOLIDATION_OPTIONS.md
@@ -1,9 +1,9 @@
-# OpenPets v3.1.0 — PR consolidation options
+# FamiliarOS v3.1.0 — PR consolidation options
 
 This document tracks both the **current separated PR layout** and a recommended **consolidated layout** so the release can be cut either way without losing branch/commit traceability.
 
 Current integration branch: `v3.1.0-integrated` (HEAD updates as work lands).  
-All branches below are pushed to Forgejo and to `verticaltension/openpetswithchatandmcp`.
+All branches below are pushed to Forgejo and to `verticaltension/familiaroswithchatandmcp`.
 
 ---
 
@@ -13,24 +13,24 @@ This is the granular set already in the repo. Each branch is small and reviewabl
 
 | PR | Branch | Commit | Scope | Files |
 |----|--------|--------|-------|-------|
-| Pet window stability | `fix/pet-window-stability` | `11ed7b3` | Remove post-drag jump, anchor resize around pet foot/center | `pet-window.ts`, `pet-preload.cjs` |
+| Familiar window stability | `fix/familiar-window-stability` | `11ed7b3` | Remove post-drag jump, anchor resize around familiar foot/center | `familiar-window.ts`, `familiar-preload.cjs` |
 | Scale preset dropdown | `feat/scale-preset-dropdown` | `53b8435` | Add `XXXS`–`XXXL` preset dropdown | `app-state-core.ts`, `renderer/src/main.tsx`, `tests/onboarding-state.test.ts` |
 | Prompt window hardening | `fix/prompt-window-hardening` | `c226280` | Attachments, auto-growing textarea, Enter sends | `prompt-window.ts`, `electron-builder.yml` |
 | Prompt window signed-build repair | `fix/prompt-window-signed-build` | `bcb5577` | Temp-file loader experiment (later reverted) | `prompt-window.ts`, `prompt-window-preload.cjs` |
-| Scale handle + keyboard nudges | `fix/scale-handle-and-keyboard` | `be21907` | Render scale handle + arrow nudges (later removed) | `pet-window.ts`, `pet-preload.cjs` |
-| Virtual-pet context menu refactor | `refactor/virtual-pet-context-menu` | `ab62d9c` | Rename submenu, Title Case, reorder stats | `plugins/official/openpets.virtual-pet/*` |
-| Bubble clip fix | `pr/bubble-clip-fix` | `af845ec` | Prevent speech bubble clipping for long messages | `pet-window.ts` |
-| Memory hardening | `pr/memory-hardening` | `2de484d` | Robust capture/retrieval + recall fallback | `openapi-chat.ts`, `openpets-memory.ts` |
+| Scale handle + keyboard nudges | `fix/scale-handle-and-keyboard` | `be21907` | Render scale handle + arrow nudges (later removed) | `familiar-window.ts`, `familiar-preload.cjs` |
+| Virtual-familiar context menu refactor | `refactor/virtual-familiar-context-menu` | `ab62d9c` | Rename submenu, Title Case, reorder stats | `plugins/official/familiaros.virtual-familiar/*` |
+| Bubble clip fix | `pr/bubble-clip-fix` | `af845ec` | Prevent speech bubble clipping for long messages | `familiar-window.ts` |
+| Memory hardening | `pr/memory-hardening` | `2de484d` | Robust capture/retrieval + recall fallback | `openapi-chat.ts`, `familiaros-memory.ts` |
 | Packaging and docs | `pr/packaging-and-docs` | `743163d` | Windows packaging + release docs | `electron-builder.yml`, scripts, docs |
 | Scale slider draggable | `pr/scale-slider-draggable` | `2472950` | Draggable slider thumb CSS | `renderer/src/main.tsx` |
-| Single-click petting | `pr/single-click-petting` | `46028c7` | Single-click → `pet:clicked`, double-click → chat | `pet-preload.cjs`, `virtual-pet/index.js` |
-| Virtual-pet HUD → context menu | `pr/virtual-pet-context-menu` | `98b7875` | Move HUD out of pinned bubble | `virtual-pet/*` |
+| Single-click petting | `pr/single-click-petting` | `46028c7` | Single-click → `familiar:clicked`, double-click → chat | `familiar-preload.cjs`, `virtual-familiar/index.js` |
+| Virtual-familiar HUD → context menu | `pr/virtual-familiar-context-menu` | `98b7875` | Move HUD out of pinned bubble | `virtual-familiar/*` |
 | Knowledge Store hardening | `pr/knowledge-store-hardening` | `f514960` | Knowledge Store feature + tests | `knowledge-store-core.ts`, `knowledge-store.ts`, tests, UI |
-| OP1 drag threshold | `op1/pet-drag-threshold` | `be580ba` | 4 px drag threshold for pet clicks | `pet-preload.cjs` |
-| OP2 bubble top clip | `op2/bubble-top-clip` | `8648cad` | Flip bubble below pet at top edge | `pet-window.ts`, `pet-preload.cjs` |
+| OP1 drag threshold | `op1/familiar-drag-threshold` | `be580ba` | 4 px drag threshold for familiar clicks | `familiar-preload.cjs` |
+| OP2 bubble top clip | `op2/bubble-top-clip` | `8648cad` | Flip bubble below familiar at top edge | `familiar-window.ts`, `familiar-preload.cjs` |
 | OP3 slider draggable | `op3/settings-slider-draggable` | `51a7044` | Larger slider thumb hit area | `renderer/src/styles.css` |
 | OP4 memory prompt | `op4/model-agnostic-memory-prompt` | `150b057` | Model-agnostic memory persistence instruction | `openapi-chat.ts` |
-| OP5 virtual-pet menu grid | `op5/virtual-pet-menu-grid` | `35e4d74` | Care actions first, compact stat rows | `virtual-pet/*` |
+| OP5 virtual-familiar menu grid | `op5/virtual-familiar-menu-grid` | `35e4d74` | Care actions first, compact stat rows | `virtual-familiar/*` |
 | OP6 chat attachments | `op6/chat-file-attachments` | `ccb3224` | File attachments in floating chat | `prompt-window.ts` |
 
 ### Pros
@@ -40,7 +40,7 @@ This is the granular set already in the repo. Each branch is small and reviewabl
 
 ### Cons
 - 19 topic PRs is a lot of overhead.
-- Many PRs touch the same files (`pet-window.ts`, `prompt-window.ts`, `renderer/src/main.tsx`), so merge order matters.
+- Many PRs touch the same files (`familiar-window.ts`, `prompt-window.ts`, `renderer/src/main.tsx`), so merge order matters.
 - Hard to see the v3.1.0 "story" at a glance.
 
 ---
@@ -49,33 +49,33 @@ This is the granular set already in the repo. Each branch is small and reviewabl
 
 Group related work into five coherent PRs plus one standalone PR. This is the version I recommend for human review.
 
-### PR 1 — Pet window & scale polish
-**Suggested branch:** `feat/pet-window-and-scale-polish` (can be cut from `v3.1.0-integrated`)
+### PR 1 — Familiar window & scale polish
+**Suggested branch:** `feat/familiar-window-and-scale-polish` (can be cut from `v3.1.0-integrated`)
 
 Combine:
-- `fix/pet-window-stability`
+- `fix/familiar-window-stability`
 - `feat/scale-preset-dropdown`
 - `fix/scale-handle-and-keyboard` (even though the handle was later removed, the keyboard nudges remain)
 - `pr/bubble-clip-fix`
-- `op1/pet-drag-threshold`
+- `op1/familiar-drag-threshold`
 - `op2/bubble-top-clip`
 - `op3/settings-slider-draggable`
 
-Files touched: `pet-window.ts`, `pet-preload.cjs`, `renderer/src/main.tsx`, `renderer/src/styles.css`, `app-state-core.ts`, `tests/onboarding-state.test.ts`
+Files touched: `familiar-window.ts`, `familiar-preload.cjs`, `renderer/src/main.tsx`, `renderer/src/styles.css`, `app-state-core.ts`, `tests/onboarding-state.test.ts`
 
-Theme: everything the user sees when resizing/moving the pet and reading bubbles.
+Theme: everything the user sees when resizing/moving the familiar and reading bubbles.
 
-### PR 2 — Virtual-pet context menu
-**Suggested branch:** `feat/virtual-pet-context-menu`
+### PR 2 — Virtual-familiar context menu
+**Suggested branch:** `feat/virtual-familiar-context-menu`
 
 Combine:
-- `pr/virtual-pet-context-menu`
-- `refactor/virtual-pet-context-menu`
-- `op5/virtual-pet-menu-grid`
+- `pr/virtual-familiar-context-menu`
+- `refactor/virtual-familiar-context-menu`
+- `op5/virtual-familiar-menu-grid`
 
-Files touched: `plugins/official/openpets.virtual-pet/*`
+Files touched: `plugins/official/familiaros.virtual-familiar/*`
 
-Theme: move virtual-pet HUD to the right-click menu and finalize the layout.
+Theme: move virtual-familiar HUD to the right-click menu and finalize the layout.
 
 ### PR 3 — Prompt window hardening
 **Suggested branch:** `fix/prompt-window-hardening`
@@ -98,7 +98,7 @@ Combine:
 - `op4/model-agnostic-memory-prompt`
 - `pr/knowledge-store-hardening`
 
-Files touched: `openapi-chat.ts`, `openpets-memory.ts`, `knowledge-store-core.ts`, `knowledge-store.ts`, `tests/knowledge-store.test.ts`, `renderer/src/main.tsx`, `windows.ts`, `control-center-preload.cjs`, `prompt-window-preload.cjs`, `prompt-window.ts`
+Files touched: `openapi-chat.ts`, `familiaros-memory.ts`, `knowledge-store-core.ts`, `knowledge-store.ts`, `tests/knowledge-store.test.ts`, `renderer/src/main.tsx`, `windows.ts`, `control-center-preload.cjs`, `prompt-window-preload.cjs`, `prompt-window.ts`
 
 Theme: long-term memory and file-based knowledge for chat.
 
@@ -116,11 +116,11 @@ Theme: ship the signed installer and keep docs consistent.
 ### PR 6 — Single-click petting (standalone)
 **Suggested branch:** `feat/single-click-petting`
 
-Keep separate because it changes the core pet-interaction contract (single vs double click).
+Keep separate because it changes the core familiar-interaction contract (single vs double click).
 
-Files touched: `pet-preload.cjs`, `virtual-pet/index.js`
+Files touched: `familiar-preload.cjs`, `virtual-familiar/index.js`
 
-Theme: pet interaction model.
+Theme: familiar interaction model.
 
 ### Pros
 - Five + one PRs is manageable for a release.
diff --git a/docs/pull-requests/OP_1_6_PULL_REQUESTS.md b/docs/pull-requests/OP_1_6_PULL_REQUESTS.md
index 73cee8dc..4bb1f1ea 100644
--- a/docs/pull-requests/OP_1_6_PULL_REQUESTS.md
+++ b/docs/pull-requests/OP_1_6_PULL_REQUESTS.md
@@ -1,4 +1,4 @@
-# OpenPets v3.1.0 — User-reported OP 1–6 fix PRs
+# FamiliarOS v3.1.0 — User-reported OP 1–6 fix PRs
 
 These six per-niche branches split the combined `03ae162` commit so each user-reported tweak can be reviewed and merged independently. Each branch is based on `82abe08` (`chore(release): integrate v3.1.0 companion fixes`) and contains **only** the incremental change for that OP.
 
@@ -6,23 +6,23 @@ When opening PRs, use a base that already includes `82abe08`; the compare links
 
 ---
 
-## 1. OP1 — Pet drag threshold
-- **Branch:** `op1/pet-drag-threshold`
+## 1. OP1 — Familiar drag threshold
+- **Branch:** `op1/familiar-drag-threshold`
 - **Commit:** `be580ba`
-- **Files:** `apps/desktop/pet-preload.cjs`
-- **What changed:** A mouse-down on the pet now starts as a drag *candidate*; it only becomes an actual drag after the cursor moves more than 4 px. A pure click/release no longer moves the pet.
-- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/82abe08...op1/pet-drag-threshold
-- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/82abe08...op1/pet-drag-threshold
+- **Files:** `apps/desktop/familiar-preload.cjs`
+- **What changed:** A mouse-down on the familiar now starts as a drag *candidate*; it only becomes an actual drag after the cursor moves more than 4 px. A pure click/release no longer moves the familiar.
+- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/82abe08...op1/familiar-drag-threshold
+- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/82abe08...op1/familiar-drag-threshold
 
 ---
 
 ## 2. OP2 — Bubble top-of-screen clipping
 - **Branch:** `op2/bubble-top-clip`
 - **Commit:** `8648cad`
-- **Files:** `apps/desktop/pet-preload.cjs`, `apps/desktop/src/pet-window.ts`
-- **What changed:** The pet window now flips the speech bubble below the pet when the pet is near the top of the work area, and the window grows to fit the bubble instead of clipping it. CSS max-heights are driven by layout variables so the renderer respects the computed size.
-- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/82abe08...op2/bubble-top-clip
-- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/82abe08...op2/bubble-top-clip
+- **Files:** `apps/desktop/familiar-preload.cjs`, `apps/desktop/src/familiar-window.ts`
+- **What changed:** The familiar window now flips the speech bubble below the familiar when the familiar is near the top of the work area, and the window grows to fit the bubble instead of clipping it. CSS max-heights are driven by layout variables so the renderer respects the computed size.
+- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/82abe08...op2/bubble-top-clip
+- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/82abe08...op2/bubble-top-clip
 
 ---
 
@@ -30,9 +30,9 @@ When opening PRs, use a base that already includes `82abe08`; the compare links
 - **Branch:** `op3/settings-slider-draggable`
 - **Commit:** `51a7044`
 - **Files:** `apps/desktop/src/renderer/src/styles.css`
-- **What changed:** Added explicit `-webkit-slider-thumb` / `-moz-range-thumb` styles with a larger hit area and `cursor: pointer`, making the pet-size slider thumb easy to drag.
-- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/82abe08...op3/settings-slider-draggable
-- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/82abe08...op3/settings-slider-draggable
+- **What changed:** Added explicit `-webkit-slider-thumb` / `-moz-range-thumb` styles with a larger hit area and `cursor: pointer`, making the familiar-size slider thumb easy to drag.
+- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/82abe08...op3/settings-slider-draggable
+- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/82abe08...op3/settings-slider-draggable
 
 ---
 
@@ -41,18 +41,18 @@ When opening PRs, use a base that already includes `82abe08`; the compare links
 - **Commit:** `150b057`
 - **Files:** `apps/desktop/src/openapi-chat.ts`
 - **What changed:** Strengthened `baseOpenApiChatInstructions` to explicitly tell the model it has a persistent long-term memory and must not claim it cannot remember or store information. This instruction is added to the base system prompt and applies to **all** chat models, not only GPT-4o.
-- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/82abe08...op4/model-agnostic-memory-prompt
-- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/82abe08...op4/model-agnostic-memory-prompt
+- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/82abe08...op4/model-agnostic-memory-prompt
+- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/82abe08...op4/model-agnostic-memory-prompt
 
 ---
 
-## 5. OP5 — Virtual-pet context menu grid
-- **Branch:** `op5/virtual-pet-menu-grid`
+## 5. OP5 — Virtual-familiar context menu grid
+- **Branch:** `op5/virtual-familiar-menu-grid`
 - **Commit:** `35e4d74`
-- **Files:** `apps/desktop/src/pet-window.ts`, `plugins/official/openpets.virtual-pet/index.js`, `plugins/official/openpets.virtual-pet/test.js`
+- **Files:** `apps/desktop/src/familiar-window.ts`, `plugins/official/familiaros.virtual-familiar/index.js`, `plugins/official/familiaros.virtual-familiar/test.js`
 - **What changed:** Reordered the plugin context-submenu so care actions appear above status labels. Stats are now rendered as three compact 2×2-style rows (`Mood · Food`, `Energy · Play`, `Bond · Level`). Updated the plugin test to match the new item IDs.
-- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/82abe08...op5/virtual-pet-menu-grid
-- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/82abe08...op5/virtual-pet-menu-grid
+- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/82abe08...op5/virtual-familiar-menu-grid
+- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/82abe08...op5/virtual-familiar-menu-grid
 
 ---
 
@@ -61,8 +61,8 @@ When opening PRs, use a base that already includes `82abe08`; the compare links
 - **Commit:** `ccb3224`
 - **Files:** `apps/desktop/src/prompt-window.ts`
 - **What changed:** Added a paperclip button, hidden file input, attachment chips, and `FileReader`-based text extraction to the floating chat window. Attached files are appended to the prompt as `[Attached file: …]` blocks and cleared after sending.
-- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/openpetswithchatandmcp/compare/82abe08...op6/chat-file-attachments
-- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/openpetswithchatandmcp/compare/82abe08...op6/chat-file-attachments
+- **GitHub compare (vs `82abe08`):** https://github.com/verticaltension/familiaroswithchatandmcp/compare/82abe08...op6/chat-file-attachments
+- **Forgejo compare (vs `82abe08`):** https://git.scriptoriumai.io/scriptoriumadmin/familiaroswithchatandmcp/compare/82abe08...op6/chat-file-attachments
 
 ---
 
@@ -70,9 +70,9 @@ When opening PRs, use a base that already includes `82abe08`; the compare links
 - Each branch was reset to `82abe08` and the relevant subset of `03ae162` was applied with `git apply`.
 - `git diff --stat 82abe08..<branch>` for each branch matches the intended per-OP file set.
 - The union of the six per-OP diffs equals the full `82abe08..03ae162` diff.
-- Branches are force-pushed to both GitHub (`verticaltension/openpetswithchatandmcp`) and Forgejo (`scriptoriumadmin/openpetswithchatandmcp`).
+- Branches are force-pushed to both GitHub (`verticaltension/familiaroswithchatandmcp`) and Forgejo (`scriptoriumadmin/familiaroswithchatandmcp`).
 
 ## Combined integration branch
 - `v3.1.0-integrated` already contains all OP 1–6 fixes in a single commit (`03ae162`).
-- A follow-up set of seven fixes is documented in [OPENPETS_3_1_0_FIXES_PULL_REQUESTS.md](./OPENPETS_3_1_0_FIXES_PULL_REQUESTS.md); that work is integrated on `v3.1.0-integrated` as commit `41920b0`.
+- A follow-up set of seven fixes is documented in [FAMILIAROS_3_1_0_FIXES_PULL_REQUESTS.md](./FAMILIAROS_3_1_0_FIXES_PULL_REQUESTS.md); that work is integrated on `v3.1.0-integrated` as commit `41920b0`.
 - Signed Windows installers are in `C:\Users\Anthracite Ace\Downloads`.
diff --git a/docs/pull-requests/PROMPT_WINDOW_PACKAGED_BUILD_FIX_2026-06-15.md b/docs/pull-requests/PROMPT_WINDOW_PACKAGED_BUILD_FIX_2026-06-15.md
index 4e3c8121..2496d2ca 100644
--- a/docs/pull-requests/PROMPT_WINDOW_PACKAGED_BUILD_FIX_2026-06-15.md
+++ b/docs/pull-requests/PROMPT_WINDOW_PACKAGED_BUILD_FIX_2026-06-15.md
@@ -47,7 +47,7 @@ promptText = promptText ? promptText + '\\n\\n---\\n\\n' + attachmentBlock : att
 A packaged-app E2E smoke test was run on the Windows build host (`DESKTOP-KS3VGHU`) over the existing reverse SSH tunnel:
 
 1. Built the NSIS installer / `win-unpacked` app with a temporary `--test-open-prompt` command-line hook.
-2. Launched `openpets.exe --remote-debugging-port=9222 --test-open-prompt`.
+2. Launched `familiaros.exe --remote-debugging-port=9222 --test-open-prompt`.
 3. Connected to the Electron renderer over Chrome DevTools Protocol.
 4. Inspected the prompt window page and asserted:
    - `window.openPetsPromptWindow` bridge exists.
@@ -59,6 +59,6 @@ A packaged-app E2E smoke test was run on the Windows build host (`DESKTOP-KS3VGH
 ## Result
 
 - Prompt window test: **PASSED**.
-- Clean signed installer at the time of this fix: `C:\Users\Anthracite Ace\Downloads\OpenPets-3.1.0-win-x64-setup.exe`
+- Clean signed installer at the time of this fix: `C:\Users\Anthracite Ace\Downloads\FamiliarOS-3.1.0-win-x64-setup.exe`
 - SHA256 at the time of this fix: `0502460BE3F00DDBB984211F93E89E38770018F9183D7C253E2B97E797B25721`
 - Latest v3.1.0-integrated build hash: `6ea493c7af0b24179d3f6b206c3c3aed50a5ba9fd24c4fc33d822ba42fd09e0e`
diff --git a/docs/release.md b/docs/release.md
index 426c609d..5e64f277 100644
--- a/docs/release.md
+++ b/docs/release.md
@@ -1,10 +1,10 @@
-# OpenPets Desktop Release Guide
+# FamiliarOS Desktop Release Guide
 
-This guide is for an AI agent creating a new OpenPets desktop release from a local macOS machine. The release flow builds Electron artifacts locally, creates a published GitHub Release, and uploads the assets.
+This guide is for an AI agent creating a new FamiliarOS desktop release from a local macOS machine. The release flow builds Electron artifacts locally, creates a published GitHub Release, and uploads the assets.
 
 ## Repository and app
 
-- GitHub repo: `alvinunreal/openpets`
+- GitHub repo: `alvinunreal/familiaros`
 - Desktop app: `apps/desktop`
 - Release script: `apps/desktop/scripts/release-local.mjs`
 - Root command: `pnpm release:desktop`
@@ -19,17 +19,17 @@ This is not a small patch release. Treat it as a major plugin-platform release u
 Release goals:
 
 1. Ship desktop plugin platform v3: SDK bridge, manifest v3 support, capability/permission enforcement, quotas, storage/state, events, bus, routes, UI panels, audio, notifications, diagnostics, and conformance checks.
-2. Publish `@open-pets/plugin-sdk` so plugin authors can depend on the SDK v3 types and `./testing` harness.
+2. Publish `@familiaros/plugin-sdk` so plugin authors can depend on the SDK v3 types and `./testing` harness.
 3. Publish the official plugin catalog with the current first-party plugin lineup:
-   - Day Routine (`openpets.day-routine`)
-   - Focus Buddy (`openpets.focus-buddy`)
-   - Fortune Cookie (`openpets.fortune-cookie`)
-   - Launch Buddy (`openpets.launch-buddy`)
-   - Magic 8 Ball (`openpets.magic-8-ball`)
-   - Mood Check-in (`openpets.mood-check-in`)
-   - Reminders (`openpets.reminders`)
-   - Virtual Pet (`openpets.virtual-pet`)
-   - Water Reminder (`openpets.water-reminder`)
+   - Day Routine (`familiaros.day-routine`)
+   - Focus Buddy (`familiaros.focus-buddy`)
+   - Fortune Cookie (`familiaros.fortune-cookie`)
+   - Launch Buddy (`familiaros.launch-buddy`)
+   - Magic 8 Ball (`familiaros.magic-8-ball`)
+   - Mood Check-in (`familiaros.mood-check-in`)
+   - Reminders (`familiaros.reminders`)
+   - Virtual Familiar (`familiaros.virtual-familiar`)
+   - Water Reminder (`familiaros.water-reminder`)
 4. Ship app/plugin translations and locale validation.
 5. Remove or keep hidden the old plugin lineup from public discovery unless it has been migrated to manifest v3 and intentionally retained.
 6. Keep older catalog endpoints available only as compatibility boundaries for old app versions; do not optimize current runtime behavior for legacy catalog/plugin paths.
@@ -47,7 +47,7 @@ Recommended versioning for this release:
 
 Desktop release includes:
 
-- SDK v3 runtime bridge and `@open-pets/plugin-sdk` conformance alignment.
+- SDK v3 runtime bridge and `@familiaros/plugin-sdk` conformance alignment.
 - Manifest v3/catalog support for translated official plugins.
 - Expanded plugin host capabilities: permissions, storage/state, schedules, commands, events, bus, routes, UI panels, audio, notifications, quotas, diagnostics, and security validation.
 - Plugin SDK preload and panel preload packaging contracts.
@@ -58,22 +58,22 @@ Desktop release includes:
 Required validation before desktop release:
 
 ```bash
-pnpm --filter @open-pets/desktop check
-pnpm --filter @open-pets/desktop test
+pnpm --filter @familiaros/desktop check
+pnpm --filter @familiaros/desktop test
 pnpm plugins:locales
-pnpm --filter @open-pets/desktop package:dir
+pnpm --filter @familiaros/desktop package:dir
 ```
 
 Manual desktop QA:
 
-1. Run normal desktop dev startup or a packaged app (`pnpm dev:desktop` or the output from `pnpm --filter @open-pets/desktop package:dir`) so bundled seeding runs.
+1. Run normal desktop dev startup or a packaged app (`pnpm dev:desktop` or the output from `pnpm --filter @familiaros/desktop package:dir`) so bundled seeding runs.
 2. Open tray → Plugins.
-3. Confirm the current official manifest v3 plugins appear in dev mode: Day Routine, Focus Buddy, Fortune Cookie, Launch Buddy, Magic 8 Ball, Mood Check-in, Reminders, Virtual Pet, and Water Reminder.
+3. Confirm the current official manifest v3 plugins appear in dev mode: Day Routine, Focus Buddy, Fortune Cookie, Launch Buddy, Magic 8 Ball, Mood Check-in, Reminders, Virtual Familiar, and Water Reminder.
 4. Confirm old sample/legacy plugins do not appear unless they were intentionally migrated and listed in the release plan.
-5. Confirm plugin names, descriptions, config labels, command labels, and pet messages resolve through translations rather than raw `$t:` keys.
-6. Exercise the SDK v3 surfaces used by official plugins: schedule, storage/state, commands, status, audio, notifications, pet reactions/interactions, and any panel UI.
+5. Confirm plugin names, descriptions, config labels, command labels, and familiar messages resolve through translations rather than raw `$t:` keys.
+6. Exercise the SDK v3 surfaces used by official plugins: schedule, storage/state, commands, status, audio, notifications, familiar reactions/interactions, and any panel UI.
 7. Configure Reminders, Water Reminder, Focus Buddy, Launch Buddy, Day Routine, and other config-heavy plugins with form controls, not JSON.
-8. Run plugin commands from the Plugins UI and pet right-click menu when available.
+8. Run plugin commands from the Plugins UI and familiar right-click menu when available.
 9. Restart desktop and confirm enabled plugins reload without broken state or duplicate timers/listeners.
 10. Inspect logs for plugin SDK, translation, permission, quota, and manifest validation errors.
 
@@ -108,7 +108,7 @@ Publishing sequence:
    pnpm plugins:check
    pnpm plugins:package
    ```
-2. Confirm `pnpm plugins:package` regenerated `web/public/plugins/catalog.v2.json` from the current official manifest v3 plugin lineup. Do not release if the checked-in v2 catalog still lists the old ambient/break/pet-pal/wander/quick-reminders/github lineup.
+2. Confirm `pnpm plugins:package` regenerated `web/public/plugins/catalog.v2.json` from the current official manifest v3 plugin lineup. Do not release if the checked-in v2 catalog still lists the old ambient/break/familiar-pal/wander/quick-reminders/github lineup.
 3. Confirm `web/public/plugins/catalog.v1.json` has `plugins: []` and does not expose stale legacy plugins.
 4. Upload plugin ZIPs to R2 and regenerate catalogs:
    ```bash
@@ -119,16 +119,16 @@ Publishing sequence:
    pnpm plugins:deploy
    ```
 6. Verify live endpoints:
-   - `https://openpets.dev/plugins/catalog.v2.json`
-   - `https://openpets.dev/plugins/catalog.v1.json`
-   - each `https://zip.openpets.dev/plugins/<plugin-id>.zip`
+   - `https://familiaros.dev/plugins/catalog.v2.json`
+   - `https://familiaros.dev/plugins/catalog.v1.json`
+   - each `https://zip.familiaros.dev/plugins/<plugin-id>.zip`
 
 ### C. GitHub Release notes
 
 Suggested release title:
 
 ```txt
-OpenPets v<version> — Plugin SDK v3
+FamiliarOS v<version> — Plugin SDK v3
 ```
 
 Suggested release notes:
@@ -136,30 +136,30 @@ Suggested release notes:
 ```md
 ## New: Plugin SDK v3
 
-OpenPets now includes the SDK v3 plugin platform for richer local companion behaviors, translated plugin experiences, and a public plugin SDK package.
+FamiliarOS now includes the SDK v3 plugin platform for richer local companion behaviors, translated plugin experiences, and a public plugin SDK package.
 
 ### Included plugins
 
 - Day Routine — morning and evening companion check-ins.
-- Focus Buddy — focus/break sessions with pet feedback and controls.
+- Focus Buddy — focus/break sessions with familiar feedback and controls.
 - Fortune Cookie — daily and on-demand fortune messages.
-- Launch Buddy — configurable greetings when OpenPets starts.
-- Magic 8 Ball — playful answers from the pet menu.
+- Launch Buddy — configurable greetings when FamiliarOS starts.
+- Magic 8 Ball — playful answers from the familiar menu.
 - Mood Check-in — scheduled mood prompts.
 - Reminders — short local reminders with optional sound and OS notifications.
-- Virtual Pet — lightweight care and interaction loops.
+- Virtual Familiar — lightweight care and interaction loops.
 - Water Reminder — hydration nudges with configurable pace and sound.
 
 ### Plugin management
 
-- Plugins can use SDK v3 capabilities for pet actions, schedules, storage/state, commands, status, audio, notifications, events, and UI panels.
+- Plugins can use SDK v3 capabilities for familiar actions, schedules, storage/state, commands, status, audio, notifications, events, and UI panels.
 - Friendly translated plugin configuration UI; no JSON editing required.
 - Plugin permissions, capabilities, quotas, and manifest validation are explicit.
-- JavaScript plugins run through the desktop SDK bridge with conformance checks against `@open-pets/plugin-sdk`.
+- JavaScript plugins run through the desktop SDK bridge with conformance checks against `@familiaros/plugin-sdk`.
 
 ### Developer notes
 
-- `@open-pets/plugin-sdk` provides SDK v3 types and a `./testing` entry point for plugin authors.
+- `@familiaros/plugin-sdk` provides SDK v3 types and a `./testing` entry point for plugin authors.
 - Local plugin development is available through explicit developer mode and `pnpm dev:desktop:plugins`.
 - Legacy sample plugins were removed or hidden from current discovery.
 
@@ -174,7 +174,7 @@ Default decision for this SDK v3 release: **publish npm packages** after version
 
 NPM publishing is required if any of these are true:
 
-- `@open-pets/plugin-sdk` should be available to plugin authors.
+- `@familiaros/plugin-sdk` should be available to plugin authors.
 - CLI/MCP/client packages changed and users need the published package update.
 - Existing published packages are incompatible with the desktop release in a way that affects normal use.
 
@@ -187,7 +187,7 @@ Before running `pnpm release:npm`, align every publishable package in `scripts/r
 1. Requires macOS.
 2. Requires `pnpm` and `gh`.
 3. Requires GitHub CLI auth for `github.com`.
-4. Requires `origin` to point to `alvinunreal/openpets`.
+4. Requires `origin` to point to `alvinunreal/familiaros`.
 5. Requires a clean git working tree.
 6. Requires the current branch to have an upstream.
 7. Requires local `HEAD` to match the upstream branch.
@@ -218,10 +218,10 @@ Default build matrix for the local release script:
 Expected main artifacts look like:
 
 ```txt
-OpenPets-<version>-mac-x64.dmg
-OpenPets-<version>-mac-arm64.dmg
-OpenPets-<version>-win-x64-setup.exe
-OpenPets-<version>-linux-x86_64.AppImage
+FamiliarOS-<version>-mac-x64.dmg
+FamiliarOS-<version>-mac-arm64.dmg
+FamiliarOS-<version>-win-x64-setup.exe
+FamiliarOS-<version>-linux-x86_64.AppImage
 SHA256SUMS
 ```
 
@@ -264,7 +264,7 @@ Desktop-only releases may intentionally use a different version than the root wo
 
 For a full workspace/npm release, update all workspace package versions together so bundled packages and npm packages report the same release version.
 
-Use a new version for every release artifact you publish. npm package versions are immutable, so any change to a published package requires a new version across all public OpenPets npm packages.
+Use a new version for every release artifact you publish. npm package versions are immutable, so any change to a published package requires a new version across all public FamiliarOS npm packages.
 
 Files to update for a full workspace/npm release:
 
@@ -276,10 +276,10 @@ packages/claude/package.json
 packages/cli/package.json
 packages/client/package.json
 packages/cursor/package.json
-packages/install-pet/package.json
+packages/install-familiar/package.json
 packages/mcp/package.json
 packages/opencode/package.json
-packages/pet-format/package.json
+packages/familiar-format/package.json
 packages/pi/package.json
 packages/sdk/package.json
 ```
@@ -306,7 +306,7 @@ Run:
 
 ```bash
 pnpm build
-pnpm --filter @open-pets/desktop check
+pnpm --filter @familiaros/desktop check
 ```
 
 Fix any failures before continuing.
@@ -424,7 +424,7 @@ If the script creates the release but upload fails:
 2. Upload missing artifacts manually with:
 
 ```bash
-gh release upload v<version> --repo alvinunreal/openpets <artifact-path>
+gh release upload v<version> --repo alvinunreal/familiaros <artifact-path>
 ```
 
 3. Or delete the release/tag and rerun after fixing the issue.
@@ -434,7 +434,7 @@ gh release upload v<version> --repo alvinunreal/openpets <artifact-path>
 These do not create a GitHub Release:
 
 ```bash
-pnpm --filter @open-pets/desktop build
+pnpm --filter @familiaros/desktop build
 node apps/desktop/scripts/clean-package-output.cjs
 pnpm --dir apps/desktop exec electron-builder --mac dmg --x64 --publish never
 pnpm --dir apps/desktop exec electron-builder --mac dmg --arm64 --publish never
@@ -463,7 +463,7 @@ Electron Builder v26 uses the Windows Store target name `appx`. There is no sepa
 
 AppX tile assets are separate from `win.icon`/`app-icon.ico`. Keep branded tile assets in `apps/desktop/build/appx/`; if these files are missing, Electron Builder falls back to its bundled `SampleAppx.*.png` placeholders and Microsoft Store certification rejects the package as using default tile images.
 
-Required OpenPets AppX tile assets:
+Required FamiliarOS AppX tile assets:
 
 ```txt
 apps/desktop/build/appx/StoreLogo.png
@@ -481,18 +481,18 @@ apps/desktop/build/appx/BadgeLogo.png
 apps/desktop/build/appx/SplashScreen.png
 ```
 
-These assets are generated from `apps/desktop/assets/app-icon.png` plus OpenPets-branded tile art. Do not delete or rename them unless the AppX manifest/build config is updated at the same time.
+These assets are generated from `apps/desktop/assets/app-icon.png` plus FamiliarOS-branded tile art. Do not delete or rename them unless the AppX manifest/build config is updated at the same time.
 
 Build a Windows x64 AppX package:
 
 ```bash
-pnpm --filter @open-pets/desktop build
-pnpm --filter @open-pets/desktop exec electron-builder --win appx --x64 \
-  -c.appx.identityName=AlvinUnreal.OpenPetsDesktopCompanion \
+pnpm --filter @familiaros/desktop build
+pnpm --filter @familiaros/desktop exec electron-builder --win appx --x64 \
+  -c.appx.identityName=AlvinUnreal.FamiliarOSDesktopCompanion \
   -c.appx.publisher=CN=5749BA4D-6A45-4111-8CAA-6B151AEDC238 \
   -c.appx.publisherDisplayName=AlvinUnreal \
-  -c.appx.displayName="OpenPets: Desktop Companion" \
-  -c.appx.applicationId=OpenPetsDesktopCompanion
+  -c.appx.displayName="FamiliarOS: Desktop Companion" \
+  -c.appx.applicationId=FamiliarOSDesktopCompanion
 ```
 
 `publisherDisplayName` must match the exact publisher display name shown by Partner Center. For the current Store account this is:
@@ -506,11 +506,11 @@ If Partner Center reports `The PublisherDisplayName element ... doesn't match yo
 Partner Center validates AppX identity against the reserved Store product identity. For the current Store reservation, the expected values are:
 
 ```txt
-identityName: AlvinUnreal.OpenPetsDesktopCompanion
-package family name: AlvinUnreal.OpenPetsDesktopCompanion_aq5mzr83863gr
+identityName: AlvinUnreal.FamiliarOSDesktopCompanion
+package family name: AlvinUnreal.FamiliarOSDesktopCompanion_aq5mzr83863gr
 publisher: CN=5749BA4D-6A45-4111-8CAA-6B151AEDC238
-displayName: OpenPets: Desktop Companion
-applicationId: OpenPetsDesktopCompanion
+displayName: FamiliarOS: Desktop Companion
+applicationId: FamiliarOSDesktopCompanion
 ```
 
 If Partner Center reports `Invalid package identity name`, `Invalid package family name`, `Invalid package publisher name`, or an unreserved `Package/Properties/DisplayName`, rebuild using the exact values above. The package family name is derived from `identityName` and `publisher`, so do not set it manually.
@@ -518,7 +518,7 @@ If Partner Center reports `Invalid package identity name`, `Invalid package fami
 Expected artifact:
 
 ```txt
-apps/desktop/dist-electron/OpenPets-<version>-win-x64.appx
+apps/desktop/dist-electron/FamiliarOS-<version>-win-x64.appx
 ```
 
 On macOS, AppX packaging runs Windows `makeappx.exe` through Parallels. If the repo is on an external drive and the build fails with `prlctl process failed 2` or a `\\Mac\\Host\\Volumes\\...` path error, either enable Parallels shared folders for all Mac disks or copy the repo to a Parallels-accessible home-folder path and build there.
@@ -532,7 +532,7 @@ If Electron Builder creates the AppX staging folder but fails only at the final
 Known-good local workaround path from the May 2026 Store packaging session:
 
 ```txt
-/Users/alvin/Downloads/openpets-msix-build/apps/desktop/dist-electron/OpenPets-2.5.0-win-x64.appx
+/Users/alvin/Downloads/familiaros-msix-build/apps/desktop/dist-electron/FamiliarOS-2.5.0-win-x64.appx
 ```
 
 Known-good corrected `2.5.0` AppX after rebuilding with Store identity values:
@@ -541,12 +541,12 @@ Known-good corrected `2.5.0` AppX after rebuilding with Store identity values:
 SHA256 4cc451a94d4be146b18ac59eb011ef3e89ff46e4e0836c8de0f36e68ad9b4a25
 ```
 
-Verify the final AppX contains OpenPets tile assets, not Electron Builder sample defaults:
+Verify the final AppX contains FamiliarOS tile assets, not Electron Builder sample defaults:
 
 ```bash
 python3 - <<'PY'
 from zipfile import ZipFile
-appx = 'apps/desktop/dist-electron/OpenPets-<version>-win-x64.appx'
+appx = 'apps/desktop/dist-electron/FamiliarOS-<version>-win-x64.appx'
 with ZipFile(appx) as z:
     for name in [
         'assets/StoreLogo.png',
@@ -568,47 +568,47 @@ Upload the Store package to the public R2-backed download host:
 
 ```bash
 bunx wrangler r2 object put \
-  "openpets/releases/OpenPets-<version>-win-x64.appx" \
-  --file "apps/desktop/dist-electron/OpenPets-<version>-win-x64.appx" \
+  "familiaros/releases/FamiliarOS-<version>-win-x64.appx" \
+  --file "apps/desktop/dist-electron/FamiliarOS-<version>-win-x64.appx" \
   --remote
 ```
 
 Public URL shape:
 
 ```txt
-https://zip.openpets.dev/releases/OpenPets-<version>-win-x64.appx
+https://zip.familiaros.dev/releases/FamiliarOS-<version>-win-x64.appx
 ```
 
 Verify before submitting to Partner Center:
 
 ```bash
-curl -I "https://zip.openpets.dev/releases/OpenPets-<version>-win-x64.appx"
+curl -I "https://zip.familiaros.dev/releases/FamiliarOS-<version>-win-x64.appx"
 ```
 
 R2 upload is optional for Partner Center MSIX/AppX submissions because the Store package flow accepts direct file upload. Use R2 only as a backup/share URL or for internal handoff.
 
 ## NPM package release
 
-OpenPets publishes these public npm packages, in dependency order:
+FamiliarOS publishes these public npm packages, in dependency order:
 
 ```txt
-@open-pets/plugin-sdk
-@open-pets/client
-@open-pets/agent-events
-@open-pets/mcp
-@open-pets/claude
-@open-pets/opencode
-@open-pets/cursor
-@open-pets/pi
-@open-pets/cli
-install-pet
+@familiaros/plugin-sdk
+@familiaros/client
+@familiaros/agent-events
+@familiaros/mcp
+@familiaros/claude
+@familiaros/opencode
+@familiaros/cursor
+@familiaros/pi
+@familiaros/cli
+install-familiar
 ```
 
-Do not publish the private workspace root, `@open-pets/desktop`, or `@open-pets/pet-format`.
+Do not publish the private workspace root, `@familiaros/desktop`, or `@familiaros/familiar-format`.
 
-Publish all public packages together at the same version whenever any public package changes. The CLI depends on the other `@open-pets/*` packages by exact published version, so partial/mixed-version npm releases can break `npx -y @open-pets/cli ...`.
+Publish all public packages together at the same version whenever any public package changes. The CLI depends on the other `@familiaros/*` packages by exact published version, so partial/mixed-version npm releases can break `npx -y @familiaros/cli ...`.
 
-The npm release helper enforces one shared version across every package in its publish order, including `@open-pets/plugin-sdk`. If this release publishes SDK v3, bump the existing public packages to the same version before running the helper.
+The npm release helper enforces one shared version across every package in its publish order, including `@familiaros/plugin-sdk`. If this release publishes SDK v3, bump the existing public packages to the same version before running the helper.
 
 Dry-run npm publishing first:
 
@@ -633,17 +633,17 @@ Publishing with the npm helper requires `npm whoami` to succeed, a clean working
 After publishing, verify the npm dependency set resolves:
 
 ```bash
-npm view @open-pets/plugin-sdk@<version> version
-npm view @open-pets/client@<version> version
-npm view @open-pets/agent-events@<version> version
-npm view @open-pets/mcp@<version> version
-npm view @open-pets/claude@<version> version
-npm view @open-pets/opencode@<version> version
-npm view @open-pets/cursor@<version> version
-npm view @open-pets/pi@<version> version
-npm view @open-pets/cli@<version> version
-npm view install-pet@<version> version
-npx -y @open-pets/cli@<version> --help
+npm view @familiaros/plugin-sdk@<version> version
+npm view @familiaros/client@<version> version
+npm view @familiaros/agent-events@<version> version
+npm view @familiaros/mcp@<version> version
+npm view @familiaros/claude@<version> version
+npm view @familiaros/opencode@<version> version
+npm view @familiaros/cursor@<version> version
+npm view @familiaros/pi@<version> version
+npm view @familiaros/cli@<version> version
+npm view install-familiar@<version> version
+npx -y @familiaros/cli@<version> --help
 ```
 
 ## Important notes for future agents
diff --git a/docs/testing.md b/docs/testing.md
index d88fb9ed..ca29bbcf 100644
--- a/docs/testing.md
+++ b/docs/testing.md
@@ -1,6 +1,6 @@
-# OpenPets testing
+# FamiliarOS testing
 
-OpenPets uses lightweight Node contract checks instead of a full test framework, plus a first-class plugin test kit for the plugin layer (see below).
+FamiliarOS uses lightweight Node contract checks instead of a full test framework, plus a first-class plugin test kit for the plugin layer (see below).
 
 ## Commands
 
@@ -28,7 +28,7 @@ Packages with runtime contract coverage should expose `test` scripts:
 Packages without meaningful runtime checks yet may omit `test` until they gain behavior beyond type/build validation:
 
 - `packages/cli`
-- `packages/pet-format`
+- `packages/familiar-format`
 
 ## Isolation rules
 
@@ -38,7 +38,7 @@ Tests must not require:
 - a real Claude installation
 - network access
 - writes to real `~/.claude/settings.json`
-- writes to real OpenPets user data
+- writes to real FamiliarOS user data
 
 Use temp directories/files for settings and fixtures. Clean them up after the test. Do not depend on the process current working directory except for explicit repo-relative fixture paths.
 
@@ -59,7 +59,7 @@ Electron tray/window behavior remains manually verified until a later UI automat
 
 ## Plugin test kit (SDK v3)
 
-The plugin layer goes beyond "lightweight checks": `@open-pets/plugin-sdk/testing`
+The plugin layer goes beyond "lightweight checks": `@familiaros/plugin-sdk/testing`
 ships a supported harness (`createTestHarness`) so any plugin's `start` handler
 runs deterministically with no Electron, no network, no real timers, and no
 real user data — the same isolation rules as above. It provides a fake clock
@@ -68,8 +68,8 @@ event injection, bubble/command interaction, permission simulation, mocks for
 `net`/`ai`/`secrets`/`files`/`auth`/`voice`/`system`, and descriptor-level
 assertions (`expectSpoke`, `expectBubble`, `expectStored`, …).
 
-- Scaffolded plugins (`openpets plugin new --template …`) ship a passing
-  `test.js` against the kit; `openpets plugin validate` checks manifests and
+- Scaffolded plugins (`familiaros plugin new --template …`) ship a passing
+  `test.js` against the kit; `familiaros plugin validate` checks manifests and
   declared files at author time.
 - `packages/sdk/src/check-plugin-sdk.ts` is the kit's own contract test, and
   `apps/desktop/src/check-plugin-sdk-conformance.ts` is the compile-time drift
diff --git a/docs/workflow.md b/docs/workflow.md
index f374b7fb..684a3b87 100644
--- a/docs/workflow.md
+++ b/docs/workflow.md
@@ -1,6 +1,6 @@
-# OpenPets 2.0 workflow
+# FamiliarOS 2.0 workflow
 
-This document defines the day-to-day working workflow for OpenPets 2.0.
+This document defines the day-to-day working workflow for FamiliarOS 2.0.
 
 The goal is to build in clear phases with excellent DX, strong review, and manual confirmation after every meaningful checkpoint.
 
@@ -41,8 +41,8 @@ Naming pattern:
 ```text
 docs/phases/phase-00-workspace-foundation.md
 docs/phases/phase-01-tray-desktop-shell.md
-docs/phases/phase-02-default-pet-window.md
-docs/phases/phase-03-local-state-pet-manager-basics.md
+docs/phases/phase-02-default-familiar-window.md
+docs/phases/phase-03-local-state-familiar-manager-basics.md
 ```
 
 Use two-digit phase numbers so files sort naturally.
@@ -173,8 +173,8 @@ Example:
 Please verify Phase 01:
 
 1. Run `pnpm dev:desktop`.
-2. Confirm the OpenPets tray icon appears.
-3. Open Manage Pets, Configure Agents, and Settings from the tray.
+2. Confirm the FamiliarOS tray icon appears.
+3. Open Manage Familiars, Configure Agents, and Settings from the tray.
 4. Confirm each placeholder window opens.
 5. Quit from the tray and confirm the app exits cleanly.
 
@@ -189,9 +189,9 @@ Start with these phase specs:
 
 1. `phase-00-workspace-foundation.md`
 2. `phase-01-tray-desktop-shell.md`
-3. `phase-02-default-pet-window.md`
-4. `phase-03-local-state-pet-manager-basics.md`
-5. `phase-04-v2-pet-catalog-installation.md`
+3. `phase-02-default-familiar-window.md`
+4. `phase-03-local-state-familiar-manager-basics.md`
+5. `phase-04-v2-familiar-catalog-installation.md`
 6. `phase-05-local-ipc-client.md`
 7. `phase-06-mcp-integration.md`
 8. `phase-07-claude-detection-configuration.md`
diff --git a/docs/wsl-ipc.md b/docs/wsl-ipc.md
index 802d16c5..321a0596 100644
--- a/docs/wsl-ipc.md
+++ b/docs/wsl-ipc.md
@@ -1,6 +1,6 @@
 # WSL and cross-OS IPC
 
-OpenPets normally uses OS-native local IPC:
+FamiliarOS normally uses OS-native local IPC:
 
 - Windows desktop app: Windows named pipe
 - macOS/Linux desktop app: Unix socket
@@ -15,15 +15,15 @@ WSL2 with **mirrored networking mode** allows WSL processes to reach Windows ser
 
 **Windows (PowerShell):**
 ```powershell
-$env:OPENPETS_IPC_BIND = "tcp://127.0.0.1:37645"
-$env:OPENPETS_IPC_ENDPOINT = "tcp://127.0.0.1:37645"
-OpenPets.exe
+$env:FAMILIAROS_IPC_BIND = "tcp://127.0.0.1:37645"
+$env:FAMILIAROS_IPC_ENDPOINT = "tcp://127.0.0.1:37645"
+FamiliarOS.exe
 ```
 
 **WSL (Bash):**
 ```bash
-export OPENPETS_DISCOVERY_FILE="/mnt/c/Users/<WindowsUser>/AppData/Roaming/OpenPets/runtime/ipc.json"
-npx -y @open-pets/mcp
+export FAMILIAROS_DISCOVERY_FILE="/mnt/c/Users/<WindowsUser>/AppData/Roaming/FamiliarOS/runtime/ipc.json"
+npx -y @familiaros/mcp
 ```
 
 ### NAT mode
@@ -43,10 +43,10 @@ echo "Windows host IP: $WIN_HOST"
 ```powershell
 # Bind to all interfaces for incoming connections from WSL.
 # This can expose the port on private/LAN interfaces if Windows Firewall allows it.
-$env:OPENPETS_IPC_BIND = "tcp://0.0.0.0:37645"
+$env:FAMILIAROS_IPC_BIND = "tcp://0.0.0.0:37645"
 # Advertise the Windows host IP to WSL clients
-$env:OPENPETS_IPC_ENDPOINT = "tcp://172.25.32.1:37645"  # Replace with your actual WIN_HOST
-OpenPets.exe
+$env:FAMILIAROS_IPC_ENDPOINT = "tcp://172.25.32.1:37645"  # Replace with your actual WIN_HOST
+FamiliarOS.exe
 ```
 
 If you know the specific Windows virtual adapter address that WSL can reach, you can bind that address instead of `0.0.0.0` to reduce exposure.
@@ -54,8 +54,8 @@ If you know the specific Windows virtual adapter address that WSL can reach, you
 **Step 3: Configure WSL client**
 
 ```bash
-export OPENPETS_DISCOVERY_FILE="/mnt/c/Users/<WindowsUser>/AppData/Roaming/OpenPets/runtime/ipc.json"
-npx -y @open-pets/mcp
+export FAMILIAROS_DISCOVERY_FILE="/mnt/c/Users/<WindowsUser>/AppData/Roaming/FamiliarOS/runtime/ipc.json"
+npx -y @familiaros/mcp
 ```
 
 If you use OpenCode, prefer putting the discovery-file override directly in the OpenCode MCP entry. OpenCode uses the `environment` key for per-MCP environment variables:
@@ -63,12 +63,12 @@ If you use OpenCode, prefer putting the discovery-file override directly in the
 ```jsonc
 {
   "mcp": {
-    "openpets": {
+    "familiaros": {
       "type": "local",
-      "command": ["npx", "-y", "@open-pets/cli@latest", "mcp"],
+      "command": ["npx", "-y", "@familiaros/cli@latest", "mcp"],
       "enabled": true,
       "environment": {
-        "OPENPETS_DISCOVERY_FILE": "/mnt/c/Users/<WindowsUser>/AppData/Roaming/OpenPets/runtime/ipc.json"
+        "FAMILIAROS_DISCOVERY_FILE": "/mnt/c/Users/<WindowsUser>/AppData/Roaming/FamiliarOS/runtime/ipc.json"
       }
     }
   }
@@ -81,16 +81,16 @@ This avoids relying on OpenCode inheriting the shell environment that launched i
 
 | Variable | Purpose | Example |
 |----------|---------|---------|
-| `OPENPETS_IPC_BIND` | TCP endpoint to bind the server to; setting this opts into TCP IPC | `tcp://0.0.0.0:37645` |
-| `OPENPETS_IPC_ENDPOINT` | TCP endpoint advertised in discovery file; this does not start TCP listening by itself | `tcp://172.25.32.1:37645` |
-| `OPENPETS_DISCOVERY_FILE` | Path to the discovery JSON file (client-side) | `/mnt/c/Users/.../ipc.json` |
+| `FAMILIAROS_IPC_BIND` | TCP endpoint to bind the server to; setting this opts into TCP IPC | `tcp://0.0.0.0:37645` |
+| `FAMILIAROS_IPC_ENDPOINT` | TCP endpoint advertised in discovery file; this does not start TCP listening by itself | `tcp://172.25.32.1:37645` |
+| `FAMILIAROS_DISCOVERY_FILE` | Path to the discovery JSON file (client-side) | `/mnt/c/Users/.../ipc.json` |
 
 ### Variable combinations
 
 - **Neither set**: Uses platform default (named pipe on Windows, Unix socket on macOS/Linux)
-- **Only `OPENPETS_IPC_ENDPOINT`**: Invalid. `OPENPETS_IPC_ENDPOINT` only advertises; set `OPENPETS_IPC_BIND` to opt into TCP IPC.
-- **Only `OPENPETS_IPC_BIND`**: Binds to the specified endpoint and advertises the same (cannot use `0.0.0.0` alone)
-- **Both set**: Binds to `OPENPETS_IPC_BIND`, advertises `OPENPETS_IPC_ENDPOINT` (required for NAT mode with `0.0.0.0`)
+- **Only `FAMILIAROS_IPC_ENDPOINT`**: Invalid. `FAMILIAROS_IPC_ENDPOINT` only advertises; set `FAMILIAROS_IPC_BIND` to opt into TCP IPC.
+- **Only `FAMILIAROS_IPC_BIND`**: Binds to the specified endpoint and advertises the same (cannot use `0.0.0.0` alone)
+- **Both set**: Binds to `FAMILIAROS_IPC_BIND`, advertises `FAMILIAROS_IPC_ENDPOINT` (required for NAT mode with `0.0.0.0`)
 
 ## Security considerations
 
@@ -100,7 +100,7 @@ This avoids relying on OpenCode inheriting the shell environment that launched i
 
 2. **Always use the discovery token**: Even with TCP, clients must present the per-run token from the discovery file. The token is randomly generated on each app start.
 
-3. **Firewall considerations**: Binding to `0.0.0.0` listens on all Windows interfaces, including private/LAN interfaces. Ensure Windows Firewall blocks external access to the OpenPets port except from the WSL virtual network.
+3. **Firewall considerations**: Binding to `0.0.0.0` listens on all Windows interfaces, including private/LAN interfaces. Ensure Windows Firewall blocks external access to the FamiliarOS port except from the WSL virtual network.
 
 4. **Network isolation**: In NAT mode, the advertised Windows host IP is intended for WSL. Binding to `0.0.0.0` can still expose the listener more broadly if firewall rules permit it.
 
@@ -128,20 +128,20 @@ This avoids relying on OpenCode inheriting the shell environment that launched i
 
 ## Quick health check
 
-After starting the desktop app with the appropriate environment variables and exporting `OPENPETS_DISCOVERY_FILE` in WSL, run:
+After starting the desktop app with the appropriate environment variables and exporting `FAMILIAROS_DISCOVERY_FILE` in WSL, run:
 
 ```bash
-npx -y @open-pets/mcp
+npx -y @familiaros/mcp
 ```
 
-Then use your MCP client's `openpets_status` tool to confirm the desktop app is reachable.
+Then use your MCP client's `familiaros_status` tool to confirm the desktop app is reachable.
 
 For NAT mode, check raw TCP reachability from WSL before testing MCP:
 
 ```bash
-cat "$OPENPETS_DISCOVERY_FILE"
-nc -vz $(jq -r '.endpoint | sub("^tcp://"; "") | split(":")[0]' "$OPENPETS_DISCOVERY_FILE") \
-  $(jq -r '.endpoint | split(":")[-1]' "$OPENPETS_DISCOVERY_FILE")
+cat "$FAMILIAROS_DISCOVERY_FILE"
+nc -vz $(jq -r '.endpoint | sub("^tcp://"; "") | split(":")[0]' "$FAMILIAROS_DISCOVERY_FILE") \
+  $(jq -r '.endpoint | split(":")[-1]' "$FAMILIAROS_DISCOVERY_FILE")
 ```
 
-If `cat` works but `openpets_status` still says IPC is unavailable, confirm the OpenCode MCP entry has `environment.OPENPETS_DISCOVERY_FILE` set and restart OpenCode.
+If `cat` works but `familiaros_status` still says IPC is unavailable, confirm the OpenCode MCP entry has `environment.FAMILIAROS_DISCOVERY_FILE` set and restart OpenCode.
diff --git a/package.json b/package.json
index 03b8b775..8b5a82c4 100644
--- a/package.json
+++ b/package.json
@@ -1,12 +1,12 @@
 {
-  "name": "openpets-v2-workspace",
+  "name": "familiaros-v2-workspace",
   "version": "3.1.0",
   "private": true,
-  "description": "OpenPets 2.0 workspace",
+  "description": "FamiliarOS 2.0 workspace",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git"
+    "url": "git+https://github.com/alvinunreal/familiaros.git"
   },
   "type": "module",
   "packageManager": "pnpm@11.0.8",
@@ -14,11 +14,11 @@
     "node": ">=20"
   },
   "scripts": {
-    "dev:desktop": "pnpm --filter @open-pets/desktop dev",
-    "dev:desktop:control-center": "pnpm --filter @open-pets/desktop dev:control-center",
-    "dev:desktop:plugins": "pnpm --filter @open-pets/desktop dev:plugins",
-    "package:desktop:dir": "pnpm build && pnpm --filter @open-pets/desktop package:dir",
-    "package:desktop": "pnpm build && pnpm --filter @open-pets/desktop package",
+    "dev:desktop": "pnpm --filter @familiaros/desktop dev",
+    "dev:desktop:control-center": "pnpm --filter @familiaros/desktop dev:control-center",
+    "dev:desktop:plugins": "pnpm --filter @familiaros/desktop dev:plugins",
+    "package:desktop:dir": "pnpm build && pnpm --filter @familiaros/desktop package:dir",
+    "package:desktop": "pnpm build && pnpm --filter @familiaros/desktop package",
     "release:desktop": "node apps/desktop/scripts/release-local.mjs",
     "release:npm": "node scripts/release-npm.mjs",
     "plugins:locales": "node scripts/check-plugin-locales.mjs",
diff --git a/packages/agent-events/codemap.md b/packages/agent-events/codemap.md
index 4a5e2a66..4873e5cd 100644
--- a/packages/agent-events/codemap.md
+++ b/packages/agent-events/codemap.md
@@ -32,8 +32,8 @@ Agent Event → pickHookSpeech(category, randomFn) → validateHookSpeech(messag
 ## Integration Points
 
 **Consumers**:
-- `@open-pets/claude` - Hook message generation
-- `@open-pets/opencode` - Plugin speech events
+- `@familiaros/claude` - Hook message generation
+- `@familiaros/opencode` - Plugin speech events
 
 **Exports**:
 - `hookSpeechPools` - Readonly record of message arrays
diff --git a/packages/agent-events/package.json b/packages/agent-events/package.json
index 14b6c23b..43730b69 100644
--- a/packages/agent-events/package.json
+++ b/packages/agent-events/package.json
@@ -1,10 +1,10 @@
 {
-  "name": "@open-pets/agent-events",
+  "name": "@familiaros/agent-events",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/agent-events"
   },
   "type": "module",
diff --git a/packages/claude/codemap.md b/packages/claude/codemap.md
index b0a0419b..ba8aa37d 100644
--- a/packages/claude/codemap.md
+++ b/packages/claude/codemap.md
@@ -1,6 +1,6 @@
 # packages/claude/
 
-Claude Code integration for OpenPets.
+Claude Code integration for FamiliarOS.
 
 ## Responsibility
 
@@ -10,37 +10,37 @@ Provides Claude Code editor integration via MCP configuration and lifecycle hook
 
 **CLI Entry** (`cli.ts`):
 - Commands: `hook`, `doctor-hooks`, `install-hooks`, `uninstall-hooks`
-- `--settings` path override, `--pet` targeting, `--project-local` flag
+- `--settings` path override, `--familiar` targeting, `--project-local` flag
 - Delegates to `hooks.ts` and `hook-settings.ts`
 
 **Hook Execution** (`hooks.ts`):
 - `runClaudeHookFromStdin()` - Main entry for Claude hook protocol
 - Event mapping: `UserPromptSubmit` → thinking, `PermissionRequest` → waiting, `Stop` → success, `StopFailure` → error, `PreToolUse` → tool-specific
 - Tool classification: Edit/Write/MultiEdit → "editing", Bash with test commands → "testing"
-- Project-local detection: Checks `.claude/settings.local.json` for `--openpets-managed --project-local`
+- Project-local detection: Checks `.claude/settings.local.json` for `--familiaros-managed --project-local`
 - Throttling: 20s speech, 3s permission, 10s reaction cooldowns via JSON state file
-- Lease acquisition for targeted pets
+- Lease acquisition for targeted familiars
 - Error handling: Debug logging, graceful degradation
 
 **Hook Settings Management** (`hook-settings.ts`):
 - Settings path: `~/.claude/settings.json`
 - Hook events: `UserPromptSubmit`, `PreToolUse`, `PermissionRequest`, `Notification`, `Stop`, `StopFailure`
 - Command entry: `{ type: "command", command, timeout: 3, async: true, asyncRewake: false }`
-- Marker: `--openpets-managed` in command for identification
+- Marker: `--familiaros-managed` in command for identification
 - Install modes: `published` (npx), `local` (node path), `bundled` (asar unpacked)
 - Safety: Backup before write, atomic rename, permission checks
 - Status: `not_installed`, `installed`, `needs_update`, `error`
 
 **MCP Configuration** (`claude-code.ts`):
-- MCP server name: `openpets`
-- Command modes: `published` (npx -y @open-pets/mcp), `local`/`bundled` (node path)
+- MCP server name: `familiaros`
+- Command modes: `published` (npx -y @familiaros/mcp), `local`/`bundled` (node path)
 - Claude CLI integration: `claude mcp add`, `claude mcp get`, `claude mcp remove`
 - Output parsing: Handles both JSON and text formats from `claude mcp get`
 - Path safety: Validates local/bundled paths are within expected directories
 - Asar handling: `mapAsarPathToUnpacked()` for Electron apps
 
 **Speech Messages** (`hook-messages.ts`):
-- Re-exports from `@open-pets/agent-events`
+- Re-exports from `@familiaros/agent-events`
 
 ## Flow
 
@@ -53,11 +53,11 @@ parseHookPayload() → mapClaudeHookEvent()
     ↓
 Decision: { reaction?, speechCategory? }
     ↓
-hasProjectLocalOpenPetsHook() → Skip if project-local exists
+hasProjectLocalFamiliarOSHook() → Skip if project-local exists
     ↓
 shouldSendSpeech() / shouldSendReaction() → Throttle check
     ↓
-acquireHookLease() → Get leaseId for targeted pet
+acquireHookLease() → Get leaseId for targeted familiar
     ↓
 client.say(message, { reaction, leaseId }) or client.react(reaction, { leaseId })
 ```
@@ -65,18 +65,18 @@ client.say(message, { reaction, leaseId }) or client.react(reaction, { leaseId }
 ## Integration Points
 
 **Dependencies**:
-- `@open-pets/client` - IPC communication
-- `@open-pets/agent-events` - Speech pools
+- `@familiaros/client` - IPC communication
+- `@familiaros/agent-events` - Speech pools
 
 **External Commands**:
 - `claude` - Claude Code CLI for MCP and settings management
 
 **Consumers**:
-- `@open-pets/cli` - `configure` command for Claude projects
+- `@familiaros/cli` - `configure` command for Claude projects
 
 **Exports**:
 - `claudePackageName` constant
 - `runClaudeHookFromStdin()`, `handleClaudeHookPayload()`
 - `installClaudeHooks()`, `uninstallClaudeHooks()`, `doctorClaudeHooks()`
 - `buildClaudeMcpPreview()`, `parseClaudeMcpGetOutput()`, `classifyClaudeMcpStatus()`
-- `validateOpenPetsPetArg()`, `openPetsHookMarker`, `claudeHookEvents`
+- `validateFamiliarOSPetArg()`, `openPetsHookMarker`, `claudeHookEvents`
diff --git a/packages/claude/package.json b/packages/claude/package.json
index 65b4d8ad..20c1b6fa 100644
--- a/packages/claude/package.json
+++ b/packages/claude/package.json
@@ -1,17 +1,17 @@
 {
-  "name": "@open-pets/claude",
+  "name": "@familiaros/claude",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/claude"
   },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "open-pets-claude": "dist/cli.js"
+    "familiaros-claude": "dist/cli.js"
   },
   "files": [
     "dist"
@@ -36,7 +36,7 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@open-pets/agent-events": "workspace:*",
-    "@open-pets/client": "workspace:*"
+    "@familiaros/agent-events": "workspace:*",
+    "@familiaros/client": "workspace:*"
   }
 }
diff --git a/packages/claude/src/check-claude-code.ts b/packages/claude/src/check-claude-code.ts
index d194cc3a..f3b3d8de 100644
--- a/packages/claude/src/check-claude-code.ts
+++ b/packages/claude/src/check-claude-code.ts
@@ -1,60 +1,60 @@
 import assert from "node:assert/strict";
 
-import { buildClaudeMcpGetCommand, buildClaudeMcpPreview, classifyClaudeMcpStatus, formatCommandForDisplay, getBundledMcpEntryPath, getLocalMcpEntryPath, mapAsarPathToUnpacked, parseClaudeMcpGetOutput, parseClaudeMcpListOutput, validateOpenPetsPetArg } from "./claude-code.js";
+import { buildClaudeMcpGetCommand, buildClaudeMcpPreview, classifyClaudeMcpStatus, formatCommandForDisplay, getBundledMcpEntryPath, getLocalMcpEntryPath, mapAsarPathToUnpacked, parseClaudeMcpGetOutput, parseClaudeMcpListOutput, validateFamiliarOSPetArg } from "./claude-code.js";
 
 const defaultPreview = buildClaudeMcpPreview();
-assert.deepEqual(defaultPreview.add.args, ["mcp", "add", "--scope", "user", "openpets", "--", "npx", "-y", "@open-pets/mcp"]);
-assert.deepEqual(defaultPreview.remove.args, ["mcp", "remove", "--scope", "user", "openpets"]);
-assert.deepEqual(defaultPreview.mcpJson.mcpServers.openpets.args, ["-y", "@open-pets/mcp"]);
-assert.equal(formatCommandForDisplay(defaultPreview.add), "claude mcp add --scope user openpets -- npx -y @open-pets/mcp");
+assert.deepEqual(defaultPreview.add.args, ["mcp", "add", "--scope", "user", "familiaros", "--", "npx", "-y", "@familiaros/mcp"]);
+assert.deepEqual(defaultPreview.remove.args, ["mcp", "remove", "--scope", "user", "familiaros"]);
+assert.deepEqual(defaultPreview.mcpJson.mcpServers.familiaros.args, ["-y", "@familiaros/mcp"]);
+assert.equal(formatCommandForDisplay(defaultPreview.add), "claude mcp add --scope user familiaros -- npx -y @familiaros/mcp");
 
 const petPreview = buildClaudeMcpPreview("snoopy");
-assert.deepEqual(petPreview.add.args, ["mcp", "add", "--scope", "user", "openpets", "--", "npx", "-y", "@open-pets/mcp", "--pet", "snoopy"]);
-assert.deepEqual(petPreview.mcpJson.mcpServers.openpets.args, ["-y", "@open-pets/mcp", "--pet", "snoopy"]);
-assert.deepEqual(buildClaudeMcpGetCommand().args, ["mcp", "get", "openpets"]);
+assert.deepEqual(petPreview.add.args, ["mcp", "add", "--scope", "user", "familiaros", "--", "npx", "-y", "@familiaros/mcp", "--familiar", "snoopy"]);
+assert.deepEqual(petPreview.mcpJson.mcpServers.familiaros.args, ["-y", "@familiaros/mcp", "--familiar", "snoopy"]);
+assert.deepEqual(buildClaudeMcpGetCommand().args, ["mcp", "get", "familiaros"]);
 
 const localPreview = buildClaudeMcpPreview("snoopy", "local");
-assert.deepEqual(localPreview.add.args, ["mcp", "add", "--scope", "user", "openpets", "--", "node", getLocalMcpEntryPath(), "--pet", "snoopy"]);
-assert.equal(localPreview.mcpJson.mcpServers.openpets.command, "node");
-assert.deepEqual(localPreview.mcpJson.mcpServers.openpets.args, [getLocalMcpEntryPath(), "--pet", "snoopy"]);
+assert.deepEqual(localPreview.add.args, ["mcp", "add", "--scope", "user", "familiaros", "--", "node", getLocalMcpEntryPath(), "--familiar", "snoopy"]);
+assert.equal(localPreview.mcpJson.mcpServers.familiaros.command, "node");
+assert.deepEqual(localPreview.mcpJson.mcpServers.familiaros.args, [getLocalMcpEntryPath(), "--familiar", "snoopy"]);
 
-assert.throws(() => validateOpenPetsPetArg("Bad Pet"));
-assert.throws(() => validateOpenPetsPetArg("bad/pet"));
-assert.equal(validateOpenPetsPetArg("snoopy"), "snoopy");
+assert.throws(() => validateFamiliarOSPetArg("Bad Familiar"));
+assert.throws(() => validateFamiliarOSPetArg("bad/familiar"));
+assert.equal(validateFamiliarOSPetArg("snoopy"), "snoopy");
 
-assert.equal(parseClaudeMcpListOutput("openpets: npx -y @open-pets/mcp").present, true);
+assert.equal(parseClaudeMcpListOutput("familiaros: npx -y @familiaros/mcp").present, true);
 assert.equal(parseClaudeMcpListOutput("No MCP servers configured").present, false);
 
-const jsonGet = parseClaudeMcpGetOutput(JSON.stringify({ command: "npx", args: ["-y", "@open-pets/mcp", "--pet", "snoopy"] }), "snoopy");
+const jsonGet = parseClaudeMcpGetOutput(JSON.stringify({ command: "npx", args: ["-y", "@familiaros/mcp", "--familiar", "snoopy"] }), "snoopy");
 assert.equal(jsonGet.present, true);
 assert.equal(jsonGet.verified, true);
 assert.equal(jsonGet.matchesExpected, true);
 
-const localGet = parseClaudeMcpGetOutput(JSON.stringify({ command: "node", args: [getLocalMcpEntryPath(), "--pet", "snoopy"] }), "snoopy", "local");
+const localGet = parseClaudeMcpGetOutput(JSON.stringify({ command: "node", args: [getLocalMcpEntryPath(), "--familiar", "snoopy"] }), "snoopy", "local");
 assert.equal(localGet.matchesExpected, true);
 
 const bundledPreview = buildClaudeMcpPreview("snoopy", "bundled");
-assert.deepEqual(bundledPreview.add.args, ["mcp", "add", "--scope", "user", "openpets", "--", "node", getBundledMcpEntryPath(), "--pet", "snoopy"]);
-assert.equal(bundledPreview.mcpJson.mcpServers.openpets.command, "node");
-assert.deepEqual(bundledPreview.mcpJson.mcpServers.openpets.args, [getBundledMcpEntryPath(), "--pet", "snoopy"]);
-const bundledGet = parseClaudeMcpGetOutput(JSON.stringify({ command: "node", args: [getBundledMcpEntryPath(), "--pet", "snoopy"] }), "snoopy", "bundled");
+assert.deepEqual(bundledPreview.add.args, ["mcp", "add", "--scope", "user", "familiaros", "--", "node", getBundledMcpEntryPath(), "--familiar", "snoopy"]);
+assert.equal(bundledPreview.mcpJson.mcpServers.familiaros.command, "node");
+assert.deepEqual(bundledPreview.mcpJson.mcpServers.familiaros.args, [getBundledMcpEntryPath(), "--familiar", "snoopy"]);
+const bundledGet = parseClaudeMcpGetOutput(JSON.stringify({ command: "node", args: [getBundledMcpEntryPath(), "--familiar", "snoopy"] }), "snoopy", "bundled");
 assert.equal(bundledGet.matchesExpected, true);
 const customNode = "/Users/test/Library/Application Support/Herd/config/nvm/versions/node/v22.22.2/bin/node";
 const customNodePreview = buildClaudeMcpPreview("snoopy", "bundled", customNode);
-assert.equal(customNodePreview.mcpJson.mcpServers.openpets.command, customNode);
-assert.equal(parseClaudeMcpGetOutput(JSON.stringify({ command: customNode, args: [getBundledMcpEntryPath(), "--pet", "snoopy"] }), "snoopy", "bundled", customNode).matchesExpected, true);
+assert.equal(customNodePreview.mcpJson.mcpServers.familiaros.command, customNode);
+assert.equal(parseClaudeMcpGetOutput(JSON.stringify({ command: customNode, args: [getBundledMcpEntryPath(), "--familiar", "snoopy"] }), "snoopy", "bundled", customNode).matchesExpected, true);
 
-const spacedPath = "/Applications/OpenPets Test.app/Contents/Resources/app/node_modules/@open-pets/mcp/dist/index.js";
-assert.equal(formatCommandForDisplay({ command: "node", args: [spacedPath, "--pet", "snoopy"] }), 'node "/Applications/OpenPets Test.app/Contents/Resources/app/node_modules/@open-pets/mcp/dist/index.js" --pet snoopy');
-const spacedTextGet = parseClaudeMcpGetOutput(`openpets\nCommand: node\nArgs: "${getBundledMcpEntryPath()}" --pet snoopy`, "snoopy", "bundled");
+const spacedPath = "/Applications/FamiliarOS Test.app/Contents/Resources/app/node_modules/@familiaros/mcp/dist/index.js";
+assert.equal(formatCommandForDisplay({ command: "node", args: [spacedPath, "--familiar", "snoopy"] }), 'node "/Applications/FamiliarOS Test.app/Contents/Resources/app/node_modules/@familiaros/mcp/dist/index.js" --familiar snoopy');
+const spacedTextGet = parseClaudeMcpGetOutput(`familiaros\nCommand: node\nArgs: "${getBundledMcpEntryPath()}" --familiar snoopy`, "snoopy", "bundled");
 assert.equal(spacedTextGet.matchesExpected, true);
-assert.equal(formatCommandForDisplay({ command: "node", args: ["C:\\Program Files\\OpenPets\\resources\\app\\node_modules\\@open-pets\\mcp\\dist\\index.js"] }), 'node "C:\\\\Program Files\\\\OpenPets\\\\resources\\\\app\\\\node_modules\\\\@open-pets\\\\mcp\\\\dist\\\\index.js"');
-assert.equal(mapAsarPathToUnpacked("/Applications/OpenPets.app/Contents/Resources/app.asar/node_modules/@open-pets/mcp/dist/index.js"), "/Applications/OpenPets.app/Contents/Resources/app.asar.unpacked/node_modules/@open-pets/mcp/dist/index.js");
-assert.equal(mapAsarPathToUnpacked("C:\\Program Files\\OpenPets\\resources\\app.asar\\node_modules\\@open-pets\\mcp\\dist\\index.js"), "C:\\Program Files\\OpenPets\\resources\\app.asar.unpacked\\node_modules\\@open-pets\\mcp\\dist\\index.js");
-assert.equal(mapAsarPathToUnpacked("/Applications/app.asarish/OpenPets.app/Contents/Resources/app.asar/node_modules/@open-pets/mcp/dist/index.js"), "/Applications/app.asarish/OpenPets.app/Contents/Resources/app.asar.unpacked/node_modules/@open-pets/mcp/dist/index.js");
-assert.equal(mapAsarPathToUnpacked("/tmp/app.asar.unpacked/node_modules/@open-pets/mcp/dist/index.js"), "/tmp/app.asar.unpacked/node_modules/@open-pets/mcp/dist/index.js");
+assert.equal(formatCommandForDisplay({ command: "node", args: ["C:\\Program Files\\FamiliarOS\\resources\\app\\node_modules\\@familiaros\\mcp\\dist\\index.js"] }), 'node "C:\\\\Program Files\\\\FamiliarOS\\\\resources\\\\app\\\\node_modules\\\\@familiaros\\\\mcp\\\\dist\\\\index.js"');
+assert.equal(mapAsarPathToUnpacked("/Applications/FamiliarOS.app/Contents/Resources/app.asar/node_modules/@familiaros/mcp/dist/index.js"), "/Applications/FamiliarOS.app/Contents/Resources/app.asar.unpacked/node_modules/@familiaros/mcp/dist/index.js");
+assert.equal(mapAsarPathToUnpacked("C:\\Program Files\\FamiliarOS\\resources\\app.asar\\node_modules\\@familiaros\\mcp\\dist\\index.js"), "C:\\Program Files\\FamiliarOS\\resources\\app.asar.unpacked\\node_modules\\@familiaros\\mcp\\dist\\index.js");
+assert.equal(mapAsarPathToUnpacked("/Applications/app.asarish/FamiliarOS.app/Contents/Resources/app.asar/node_modules/@familiaros/mcp/dist/index.js"), "/Applications/app.asarish/FamiliarOS.app/Contents/Resources/app.asar.unpacked/node_modules/@familiaros/mcp/dist/index.js");
+assert.equal(mapAsarPathToUnpacked("/tmp/app.asar.unpacked/node_modules/@familiaros/mcp/dist/index.js"), "/tmp/app.asar.unpacked/node_modules/@familiaros/mcp/dist/index.js");
 
-const textGet = parseClaudeMcpGetOutput("openpets\nCommand: npx\nArgs: -y @open-pets/mcp --pet snoopy", "snoopy");
+const textGet = parseClaudeMcpGetOutput("familiaros\nCommand: npx\nArgs: -y @familiaros/mcp --familiar snoopy", "snoopy");
 assert.equal(textGet.present, true);
 assert.equal(textGet.verified, true);
 assert.equal(textGet.matchesExpected, true);
@@ -64,7 +64,7 @@ assert.equal(different.present, true);
 assert.equal(different.verified, true);
 assert.equal(different.matchesExpected, false);
 
-const unverifiable = classifyClaudeMcpStatus("openpets", "Name: openpets\nTransport: stdio", "snoopy");
+const unverifiable = classifyClaudeMcpStatus("familiaros", "Name: familiaros\nTransport: stdio", "snoopy");
 assert.equal(unverifiable.present, true);
 assert.equal(unverifiable.verified, false);
 assert.equal(unverifiable.matchesExpected, false);
diff --git a/packages/claude/src/check-claude-hooks.ts b/packages/claude/src/check-claude-hooks.ts
index 840cb929..17b949e7 100644
--- a/packages/claude/src/check-claude-hooks.ts
+++ b/packages/claude/src/check-claude-hooks.ts
@@ -4,9 +4,9 @@ import { mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync, writeFileSyn
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 
-import { addOpenPetsHooks, claudeHookEvents, createOpenPetsHookCommand, createOpenPetsHookSettingsPreview, doctorClaudeHooks, getBundledClaudeCliPath, getLocalClaudeCliPath, installClaudeHooks, openPetsHookMarker, removeOpenPetsHooks, uninstallClaudeHooks } from "./hook-settings.js";
+import { addFamiliarOSHooks, claudeHookEvents, createFamiliarOSHookCommand, createFamiliarOSHookSettingsPreview, doctorClaudeHooks, getBundledClaudeCliPath, getLocalClaudeCliPath, installClaudeHooks, openPetsHookMarker, removeFamiliarOSHooks, uninstallClaudeHooks } from "./hook-settings.js";
 import { hookSpeechPools } from "./hook-messages.js";
-import { handleClaudeHookPayload, hasProjectLocalOpenPetsHook, mapClaudeHookEvent, validateHookSpeech } from "./hooks.js";
+import { handleClaudeHookPayload, hasProjectLocalFamiliarOSHook, mapClaudeHookEvent, validateHookSpeech } from "./hooks.js";
 
 assert.equal(mapClaudeHookEvent({ hook_event_name: "UserPromptSubmit" })?.reaction, "thinking");
 assert.equal(mapClaudeHookEvent({ hook_event_name: "UserPromptSubmit" })?.speechCategory, undefined);
@@ -36,7 +36,7 @@ const calls: Array<{ readonly kind: string; readonly value: string; readonly lea
 const client = {
   hello: async () => ({}),
   status: async () => ({ ok: true, appRunning: true }),
-  listPets: async () => ({ ok: true as const, pets: [], defaultPetId: "builtin" }),
+  listPets: async () => ({ ok: true as const, familiars: [], defaultPetId: "builtin" }),
   installPet: async () => { throw new Error("unused"); },
   acquireLease: async (options?: { readonly requestedPetId?: string }) => {
     calls.push({ kind: "lease", value: "acquire", requestedPetId: options?.requestedPetId });
@@ -47,7 +47,7 @@ const client = {
   react: async (reaction: string, options?: { readonly leaseId?: string }) => { calls.push({ kind: "react", value: reaction, leaseId: options?.leaseId }); },
   say: async (message: string, options?: { readonly leaseId?: string }) => { calls.push({ kind: "say", value: message, leaseId: options?.leaseId }); },
 };
-const dir = mkdtempSync(join(tmpdir(), "openpets-hooks-"));
+const dir = mkdtempSync(join(tmpdir(), "familiaros-hooks-"));
 try {
 await handleClaudeHookPayload(JSON.stringify({ hook_event_name: "UserPromptSubmit", prompt: "never shown" }), { client, configuredPetId: "fixer", throttlePath: join(dir, "throttle.json"), now: () => 100_000, random: () => 0 });
 assert.deepEqual(calls[0], { kind: "lease", value: "acquire", requestedPetId: "fixer" });
@@ -63,8 +63,8 @@ await handleClaudeHookPayload("not json", { client, throttlePath: join(dir, "thr
 
 const projectDir = join(dir, "project-with-local-hook");
 mkdirSync(join(projectDir, ".claude"), { recursive: true });
-writeFileSync(join(projectDir, ".claude", "settings.local.json"), JSON.stringify({ hooks: { UserPromptSubmit: [{ hooks: [{ type: "command", command: "openpets hook --openpets-managed --project-local --pet fixer" }] }] } }), "utf8");
-assert.equal(hasProjectLocalOpenPetsHook(projectDir), true);
+writeFileSync(join(projectDir, ".claude", "settings.local.json"), JSON.stringify({ hooks: { UserPromptSubmit: [{ hooks: [{ type: "command", command: "familiaros hook --familiaros-managed --project-local --familiar fixer" }] }] } }), "utf8");
+assert.equal(hasProjectLocalFamiliarOSHook(projectDir), true);
 const beforeSkippedGlobal = calls.length;
 const previousProjectDir = process.env.CLAUDE_PROJECT_DIR;
 process.env.CLAUDE_PROJECT_DIR = projectDir;
@@ -79,7 +79,7 @@ try {
   else process.env.CLAUDE_PROJECT_DIR = previousProjectDir;
 }
 
-const preview = createOpenPetsHookSettingsPreview();
+const preview = createFamiliarOSHookSettingsPreview();
 const hooks = (preview.hooks ?? {}) as Record<string, unknown>;
 for (const event of claudeHookEvents) {
   const entries = hooks[event] as Array<{ hooks: Array<{ command: string; timeout: number; async: boolean; asyncRewake: boolean }> }>;
@@ -89,37 +89,37 @@ for (const event of claudeHookEvents) {
   assert.equal(hook.async, true);
   assert.equal(hook.asyncRewake, false);
 }
-const localPreview = createOpenPetsHookSettingsPreview("local");
+const localPreview = createFamiliarOSHookSettingsPreview("local");
 const localHook = (((localPreview.hooks as Record<string, unknown>).Stop as Array<{ hooks: Array<{ command: string }> }>)[0]?.hooks[0]);
 assert.ok(localHook?.command.includes(getLocalClaudeCliPath()));
 assert.ok(localHook?.command.includes(openPetsHookMarker));
-const bundledPreview = createOpenPetsHookSettingsPreview("bundled");
+const bundledPreview = createFamiliarOSHookSettingsPreview("bundled");
 const bundledHook = (((bundledPreview.hooks as Record<string, unknown>).Stop as Array<{ hooks: Array<{ command: string }> }>)[0]?.hooks[0]);
 assert.ok(bundledHook?.command.includes(getBundledClaudeCliPath()));
 assert.ok(bundledHook?.command.includes(openPetsHookMarker));
-const customNodeHookCommand = createOpenPetsHookCommand("bundled", "fixer", "/Users/test/Library/Application Support/Herd/config/nvm/versions/node/v22.22.2/bin/node");
+const customNodeHookCommand = createFamiliarOSHookCommand("bundled", "fixer", "/Users/test/Library/Application Support/Herd/config/nvm/versions/node/v22.22.2/bin/node");
 assert.ok(customNodeHookCommand.startsWith('"/Users/test/Library/Application Support/Herd/config/nvm/versions/node/v22.22.2/bin/node"'));
-assert.ok(customNodeHookCommand.includes("--pet fixer"));
-assert.ok(createOpenPetsHookCommand("published", "fixer").endsWith("--openpets-managed --pet fixer"));
-const petPreview = createOpenPetsHookSettingsPreview("published", "fixer");
+assert.ok(customNodeHookCommand.includes("--familiar fixer"));
+assert.ok(createFamiliarOSHookCommand("published", "fixer").endsWith("--familiaros-managed --familiar fixer"));
+const petPreview = createFamiliarOSHookSettingsPreview("published", "fixer");
 const petHook = (((petPreview.hooks as Record<string, unknown>).UserPromptSubmit as Array<{ hooks: Array<{ command: string }> }>)[0]?.hooks[0]);
-assert.ok(petHook?.command.includes("--pet fixer"));
+assert.ok(petHook?.command.includes("--familiar fixer"));
 
 const settings = { theme: "dark", hooks: { PreToolUse: [{ matcher: "Bash", hooks: [{ type: "command", command: "echo safe" }] }] } };
-const installed = addOpenPetsHooks(settings);
+const installed = addFamiliarOSHooks(settings);
 assert.equal(doctorStatus(installed), "installed");
-const installedForFixer = addOpenPetsHooks(settings, "published", "fixer");
+const installedForFixer = addFamiliarOSHooks(settings, "published", "fixer");
 assert.equal(doctorStatus(installedForFixer, "fixer"), "installed");
 assert.equal(doctorStatus(installedForFixer), "needs_update");
 assert.ok(doctorClaudeHooks(doctorStatusPath(installedForFixer), "published", "fixer").message.includes("Hook events target fixer."));
-const reinstalled = addOpenPetsHooks(removeOpenPetsHooks(installed));
+const reinstalled = addFamiliarOSHooks(removeFamiliarOSHooks(installed));
 assert.deepEqual(reinstalled, installed);
-const uninstalled = removeOpenPetsHooks(installed);
+const uninstalled = removeFamiliarOSHooks(installed);
 assert.deepEqual(uninstalled, settings);
-assert.throws(() => addOpenPetsHooks({ hooks: { UserPromptSubmit: { bad: true } } }));
+assert.throws(() => addFamiliarOSHooks({ hooks: { UserPromptSubmit: { bad: true } } }));
 
-const stale = addOpenPetsHooks({});
-((stale.hooks as Record<string, unknown>).Stop as unknown[]).push({ hooks: [{ type: "command", command: "npx -y @open-pets/claude hook --openpets-managed --old" }] });
+const stale = addFamiliarOSHooks({});
+((stale.hooks as Record<string, unknown>).Stop as unknown[]).push({ hooks: [{ type: "command", command: "npx -y @familiaros/claude hook --familiaros-managed --old" }] });
 const stalePath = join(dir, "stale-settings.json");
 writeFileSync(stalePath, JSON.stringify(stale), "utf8");
 assert.equal(doctorClaudeHooks(stalePath).status, "needs_update");
@@ -141,25 +141,25 @@ const symlinkPath = join(dir, "settings-link.json");
 symlinkSync(settingsPath, symlinkPath);
 assert.equal(doctorClaudeHooks(symlinkPath).status, "error");
 
-process.env.OPENPETS_DISABLE_CLAUDE_ASYNC_HOOKS = "1";
+process.env.FAMILIAROS_DISABLE_CLAUDE_ASYNC_HOOKS = "1";
 assert.throws(() => installClaudeHooks(join(dir, "async-disabled.json")));
-delete process.env.OPENPETS_DISABLE_CLAUDE_ASYNC_HOOKS;
+delete process.env.FAMILIAROS_DISABLE_CLAUDE_ASYNC_HOOKS;
 
-const isolatedEnv = { ...process.env, OPENPETS_DISCOVERY_FILE: join(dir, "missing-ipc.json") };
-const normalHook = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--openpets-managed"], { input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }), encoding: "utf8", env: isolatedEnv });
+const isolatedEnv = { ...process.env, FAMILIAROS_DISCOVERY_FILE: join(dir, "missing-ipc.json") };
+const normalHook = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--familiaros-managed"], { input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }), encoding: "utf8", env: isolatedEnv });
 assert.equal(normalHook.status, 0);
 assert.equal(normalHook.stdout, "");
 
-const petHookRun = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--openpets-managed", "--pet", "fixer"], { input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }), encoding: "utf8", env: isolatedEnv });
+const petHookRun = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--familiaros-managed", "--familiar", "fixer"], { input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }), encoding: "utf8", env: isolatedEnv });
 assert.equal(petHookRun.status, 0);
 assert.equal(petHookRun.stdout, "");
 
-const invalidPetHook = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--openpets-managed", "--pet", "bad/pet"], { input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }), encoding: "utf8", env: isolatedEnv });
+const invalidPetHook = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--familiaros-managed", "--familiar", "bad/familiar"], { input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }), encoding: "utf8", env: isolatedEnv });
 assert.equal(invalidPetHook.status, 1);
-const missingPetHook = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--openpets-managed", "--pet"], { input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }), encoding: "utf8", env: isolatedEnv });
+const missingPetHook = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--familiaros-managed", "--familiar"], { input: JSON.stringify({ hook_event_name: "Notification", message: "safe" }), encoding: "utf8", env: isolatedEnv });
 assert.equal(missingPetHook.status, 1);
 
-const malformedHook = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--openpets-managed"], { input: "not json", encoding: "utf8", env: isolatedEnv });
+const malformedHook = spawnSync(process.execPath, [new URL("./cli.js", import.meta.url).pathname, "hook", "--familiaros-managed"], { input: "not json", encoding: "utf8", env: isolatedEnv });
 assert.equal(malformedHook.status, 0);
 assert.equal(malformedHook.stdout, "");
 
diff --git a/packages/claude/src/claude-code.ts b/packages/claude/src/claude-code.ts
index 1fb7f19e..73f31677 100644
--- a/packages/claude/src/claude-code.ts
+++ b/packages/claude/src/claude-code.ts
@@ -2,9 +2,9 @@ import { dirname, isAbsolute, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
 import { lstatSync, realpathSync, statSync } from "node:fs";
 
-export const claudeMcpServerName = "openpets";
-export const openPetsMcpPackageName = "@open-pets/mcp";
-export type OpenPetsCommandMode = "published" | "local" | "bundled";
+export const claudeMcpServerName = "familiaros";
+export const openPetsMcpPackageName = "@familiaros/mcp";
+export type FamiliarOSCommandMode = "published" | "local" | "bundled";
 
 export type ClaudeMcpScope = "user";
 
@@ -14,12 +14,12 @@ export interface ClaudeCommandSpec {
 }
 
 export interface ClaudeMcpPreview {
-  readonly commandMode: OpenPetsCommandMode;
+  readonly commandMode: FamiliarOSCommandMode;
   readonly add: ClaudeCommandSpec;
   readonly remove: ClaudeCommandSpec;
   readonly mcpJson: {
     readonly mcpServers: {
-      readonly openpets: {
+      readonly familiaros: {
         readonly type: "stdio";
         readonly command: string;
         readonly args: readonly string[];
@@ -38,8 +38,8 @@ export interface ParsedClaudeMcpEntry {
   readonly matchesExpected: boolean;
 }
 
-export function buildClaudeMcpPreview(selectedPetId?: string, commandMode: OpenPetsCommandMode = "published", nodeCommand = "node"): ClaudeMcpPreview {
-  const server = buildOpenPetsMcpServerCommand(selectedPetId, commandMode, nodeCommand);
+export function buildClaudeMcpPreview(selectedPetId?: string, commandMode: FamiliarOSCommandMode = "published", nodeCommand = "node"): ClaudeMcpPreview {
+  const server = buildFamiliarOSMcpServerCommand(selectedPetId, commandMode, nodeCommand);
   const addArgs = ["mcp", "add", "--scope", "user", claudeMcpServerName, "--", server.command, ...server.args] as const;
   const removeArgs = ["mcp", "remove", "--scope", "user", claudeMcpServerName] as const;
   const add: ClaudeCommandSpec = { command: "claude", args: addArgs };
@@ -50,7 +50,7 @@ export function buildClaudeMcpPreview(selectedPetId?: string, commandMode: OpenP
     remove: { command: "claude", args: removeArgs },
     mcpJson: {
       mcpServers: {
-        openpets: {
+        familiaros: {
           type: "stdio",
           command: server.command,
           args: server.args,
@@ -61,21 +61,21 @@ export function buildClaudeMcpPreview(selectedPetId?: string, commandMode: OpenP
   };
 }
 
-export function buildOpenPetsMcpArgs(selectedPetId?: string): readonly string[] {
+export function buildFamiliarOSMcpArgs(selectedPetId?: string): readonly string[] {
   if (selectedPetId === undefined) return ["-y", openPetsMcpPackageName];
-  validateOpenPetsPetArg(selectedPetId);
-  return ["-y", openPetsMcpPackageName, "--pet", selectedPetId];
+  validateFamiliarOSPetArg(selectedPetId);
+  return ["-y", openPetsMcpPackageName, "--familiar", selectedPetId];
 }
 
-export function buildOpenPetsMcpServerCommand(selectedPetId?: string, commandMode: OpenPetsCommandMode = "published", nodeCommand = "node"): { readonly command: string; readonly args: readonly string[] } {
+export function buildFamiliarOSMcpServerCommand(selectedPetId?: string, commandMode: FamiliarOSCommandMode = "published", nodeCommand = "node"): { readonly command: string; readonly args: readonly string[] } {
   if (commandMode === "local" || commandMode === "bundled") {
     const entryPath = commandMode === "bundled" ? getBundledMcpEntryPath() : getLocalMcpEntryPath();
     commandMode === "bundled" ? assertBundledMcpEntryPath() : assertLocalMcpEntryPath();
     if (selectedPetId === undefined) return { command: nodeCommand, args: [entryPath] };
-    validateOpenPetsPetArg(selectedPetId);
-    return { command: nodeCommand, args: [entryPath, "--pet", selectedPetId] };
+    validateFamiliarOSPetArg(selectedPetId);
+    return { command: nodeCommand, args: [entryPath, "--familiar", selectedPetId] };
   }
-  return { command: "npx", args: buildOpenPetsMcpArgs(selectedPetId) };
+  return { command: "npx", args: buildFamiliarOSMcpArgs(selectedPetId) };
 }
 
 export function assertLocalMcpEntryPath(): void {
@@ -107,16 +107,16 @@ export function buildClaudeMcpGetCommand(): ClaudeCommandSpec {
   return { command: "claude", args: ["mcp", "get", claudeMcpServerName] };
 }
 
-export function validateOpenPetsPetArg(value: string): string {
+export function validateFamiliarOSPetArg(value: string): string {
   const trimmed = value.trim();
-  if (trimmed !== value || trimmed.length < 1) throw new Error("Invalid OpenPets pet id.");
-  if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(trimmed)) throw new Error("Invalid OpenPets pet id.");
+  if (trimmed !== value || trimmed.length < 1) throw new Error("Invalid FamiliarOS familiar id.");
+  if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(trimmed)) throw new Error("Invalid FamiliarOS familiar id.");
   return trimmed;
 }
 
 export function parseClaudeMcpListOutput(output: string): ParsedClaudeMcpEntry {
   const normalized = output.toLowerCase();
-  const present = /(^|\s|[•*-])openpets(\s|$|:|-)/m.test(normalized) || normalized.includes("openpets:");
+  const present = /(^|\s|[•*-])familiaros(\s|$|:|-)/m.test(normalized) || normalized.includes("familiaros:");
   return {
     present,
     source: present ? "list" : "none",
@@ -125,12 +125,12 @@ export function parseClaudeMcpListOutput(output: string): ParsedClaudeMcpEntry {
   };
 }
 
-export function parseClaudeMcpGetOutput(output: string, expectedPetId?: string, commandMode: OpenPetsCommandMode = "published", nodeCommand = "node"): ParsedClaudeMcpEntry {
+export function parseClaudeMcpGetOutput(output: string, expectedPetId?: string, commandMode: FamiliarOSCommandMode = "published", nodeCommand = "node"): ParsedClaudeMcpEntry {
   const text = output.trim();
   if (!text) return { present: false, source: "none", verified: false, matchesExpected: false };
 
   const parsed = tryParseJson(text);
-  const expected = buildOpenPetsMcpServerCommand(expectedPetId, commandMode, nodeCommand);
+  const expected = buildFamiliarOSMcpServerCommand(expectedPetId, commandMode, nodeCommand);
   const jsonEntry = parsed ? extractJsonEntry(parsed) : null;
   if (jsonEntry) {
     const matchesExpected = jsonEntry.command === expected.command && arraysEqual(jsonEntry.args, expected.args);
@@ -144,14 +144,14 @@ export function parseClaudeMcpGetOutput(output: string, expectedPetId?: string,
     return { present: true, command, args, source: "get", verified: true, matchesExpected };
   }
 
-  if (/openpets/i.test(text) || /@open-pets\/mcp/i.test(text)) {
+  if (/familiaros/i.test(text) || /@familiaros\/mcp/i.test(text)) {
     return { present: true, source: "get", verified: false, matchesExpected: false };
   }
 
   return { present: false, source: "none", verified: false, matchesExpected: false };
 }
 
-export function classifyClaudeMcpStatus(listOutput: string, getOutput: string | undefined, expectedPetId?: string, commandMode: OpenPetsCommandMode = "published", nodeCommand = "node"): ParsedClaudeMcpEntry {
+export function classifyClaudeMcpStatus(listOutput: string, getOutput: string | undefined, expectedPetId?: string, commandMode: FamiliarOSCommandMode = "published", nodeCommand = "node"): ParsedClaudeMcpEntry {
   if (getOutput) {
     const parsedGet = parseClaudeMcpGetOutput(getOutput, expectedPetId, commandMode, nodeCommand);
     if (parsedGet.present) return parsedGet;
@@ -179,8 +179,8 @@ function tryParseJson(value: string): unknown {
 
 function extractJsonEntry(value: unknown): { readonly command: string; readonly args: readonly string[] } | null {
   const record = isRecord(value) ? value : null;
-  const maybeEntry = record && isRecord(record.mcpServers) && isRecord(record.mcpServers.openpets)
-    ? record.mcpServers.openpets
+  const maybeEntry = record && isRecord(record.mcpServers) && isRecord(record.mcpServers.familiaros)
+    ? record.mcpServers.familiaros
     : record;
 
   if (!isRecord(maybeEntry) || typeof maybeEntry.command !== "string" || !Array.isArray(maybeEntry.args)) return null;
@@ -243,7 +243,7 @@ function isRecord(value: unknown): value is Record<string, unknown> {
 
 function assertSafeLocalDistFile(path: string, label: string): void {
   const expectedPrefix = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
-  if (!path.startsWith(expectedPrefix)) throw new Error(`Local ${label} path is outside the OpenPets workspace.`);
+  if (!path.startsWith(expectedPrefix)) throw new Error(`Local ${label} path is outside the FamiliarOS workspace.`);
   const stat = statSync(path);
   if (!stat.isFile()) throw new Error(`Local ${label} path is not a regular file.`);
 }
@@ -257,7 +257,7 @@ function assertSafeBundledDistFile(path: string, label: string): void {
   const expectedRoot = realpathSync(mapAsarPathToUnpacked(join(dirname(fileURLToPath(import.meta.url)), "..", "..")));
   const realPath = realpathSync(path);
   const rel = relative(expectedRoot, realPath);
-  if (rel.startsWith("..") || isAbsolute(rel)) throw new Error(`Bundled ${label} path is outside the packaged OpenPets resources.`);
+  if (rel.startsWith("..") || isAbsolute(rel)) throw new Error(`Bundled ${label} path is outside the packaged FamiliarOS resources.`);
 }
 
 function isTrueAsarPath(path: string): boolean {
diff --git a/packages/claude/src/cli.ts b/packages/claude/src/cli.ts
index 8fe031e0..26301420 100644
--- a/packages/claude/src/cli.ts
+++ b/packages/claude/src/cli.ts
@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { runClaudeHookFromStdin } from "./hooks.js";
 import { doctorClaudeHooks, installClaudeHooks, uninstallClaudeHooks } from "./hook-settings.js";
-import { validateOpenPetsPetArg } from "./claude-code.js";
+import { validateFamiliarOSPetArg } from "./claude-code.js";
 
 async function main(): Promise<void> {
   const [command, ...args] = process.argv.slice(2);
   if (command === "hook") {
-    const code = await runClaudeHookFromStdin(process.stdin, { configuredPetId: readPetArg(args), projectLocal: hasProjectLocalArg(args), debug: process.env.OPENPETS_DEBUG === "1" });
+    const code = await runClaudeHookFromStdin(process.stdin, { configuredPetId: readPetArg(args), projectLocal: hasProjectLocalArg(args), debug: process.env.FAMILIAROS_DEBUG === "1" });
     process.exitCode = code;
     return;
   }
@@ -22,7 +22,7 @@ async function main(): Promise<void> {
     process.stderr.write(`${JSON.stringify(uninstallClaudeHooks(readPathArg(args)), null, 2)}\n`);
     return;
   }
-  process.stderr.write("Usage: open-pets-claude <hook|doctor-hooks|install-hooks|uninstall-hooks> [--settings <path>] [--pet <id>]\n");
+  process.stderr.write("Usage: familiaros-claude <hook|doctor-hooks|install-hooks|uninstall-hooks> [--settings <path>] [--familiar <id>]\n");
   process.exitCode = 1;
 }
 
@@ -33,12 +33,12 @@ function readPathArg(args: readonly string[]): string | undefined {
 }
 
 function readPetArg(args: readonly string[]): string | undefined {
-  const equals = args.find((arg) => arg.startsWith("--pet="));
-  if (equals) return validateOpenPetsPetArg(equals.slice("--pet=".length));
-  const index = args.indexOf("--pet");
+  const equals = args.find((arg) => arg.startsWith("--familiar="));
+  if (equals) return validateFamiliarOSPetArg(equals.slice("--familiar=".length));
+  const index = args.indexOf("--familiar");
   const value = index >= 0 ? args[index + 1] : undefined;
-  if (index >= 0 && (!value || value.startsWith("--"))) throw new Error("Missing value for --pet.");
-  return value && value.length > 0 ? validateOpenPetsPetArg(value) : undefined;
+  if (index >= 0 && (!value || value.startsWith("--"))) throw new Error("Missing value for --familiar.");
+  return value && value.length > 0 ? validateFamiliarOSPetArg(value) : undefined;
 }
 
 function hasProjectLocalArg(args: readonly string[]): boolean {
@@ -46,6 +46,6 @@ function hasProjectLocalArg(args: readonly string[]): boolean {
 }
 
 main().catch((error: unknown) => {
-  process.stderr.write(`OpenPets Claude CLI failed: ${error instanceof Error ? error.message : String(error)}\n`);
+  process.stderr.write(`FamiliarOS Claude CLI failed: ${error instanceof Error ? error.message : String(error)}\n`);
   process.exitCode = 1;
 });
diff --git a/packages/claude/src/codemap.md b/packages/claude/src/codemap.md
index ab85154c..df1edb2f 100644
--- a/packages/claude/src/codemap.md
+++ b/packages/claude/src/codemap.md
@@ -5,8 +5,8 @@
 - **index.ts**: Barrel export (6 lines). Re-exports all public modules.
 - **cli.ts**: CLI entry (51 lines). Command routing for `hook`, `doctor-hooks`, `install-hooks`, `uninstall-hooks`.
 - **hooks.ts**: Hook execution engine (229 lines). `runClaudeHookFromStdin()`, `handleClaudeHookPayload()`, `mapClaudeHookEvent()`, `classifyToolReaction()`, throttling, project-local detection.
-- **hook-settings.ts**: Settings management (248 lines). `installClaudeHooks()`, `uninstallClaudeHooks()`, `doctorClaudeHooks()`, `addOpenPetsHooks()`, `removeOpenPetsHooks()`, path safety, backup logic.
-- **hook-messages.ts**: Speech re-exports (1 line). Re-exports from `@open-pets/agent-events`.
-- **claude-code.ts**: MCP configuration (265 lines). `buildClaudeMcpPreview()`, `buildOpenPetsMcpServerCommand()`, `parseClaudeMcpGetOutput()`, `classifyClaudeMcpStatus()`, path validation, asar handling.
+- **hook-settings.ts**: Settings management (248 lines). `installClaudeHooks()`, `uninstallClaudeHooks()`, `doctorClaudeHooks()`, `addFamiliarOSHooks()`, `removeFamiliarOSHooks()`, path safety, backup logic.
+- **hook-messages.ts**: Speech re-exports (1 line). Re-exports from `@familiaros/agent-events`.
+- **claude-code.ts**: MCP configuration (265 lines). `buildClaudeMcpPreview()`, `buildFamiliarOSMcpServerCommand()`, `parseClaudeMcpGetOutput()`, `classifyClaudeMcpStatus()`, path validation, asar handling.
 - **check-claude-code.ts**: MCP contract validation (excluded from detailed documentation).
 - **check-claude-hooks.ts**: Hooks contract validation (excluded from detailed documentation).
diff --git a/packages/claude/src/hook-messages.ts b/packages/claude/src/hook-messages.ts
index 8765968a..1d0f6488 100644
--- a/packages/claude/src/hook-messages.ts
+++ b/packages/claude/src/hook-messages.ts
@@ -1 +1 @@
-export { hookSpeechPools, pickHookSpeech, type HookSpeechCategory } from "@open-pets/agent-events";
+export { hookSpeechPools, pickHookSpeech, type HookSpeechCategory } from "@familiaros/agent-events";
diff --git a/packages/claude/src/hook-settings.ts b/packages/claude/src/hook-settings.ts
index a3f4f31e..a8ccafa9 100644
--- a/packages/claude/src/hook-settings.ts
+++ b/packages/claude/src/hook-settings.ts
@@ -3,9 +3,9 @@ import { dirname, isAbsolute, join, relative } from "node:path";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
 
-import { mapAsarPathToUnpacked, validateOpenPetsPetArg, type OpenPetsCommandMode } from "./claude-code.js";
+import { mapAsarPathToUnpacked, validateFamiliarOSPetArg, type FamiliarOSCommandMode } from "./claude-code.js";
 
-export const openPetsHookMarker = "--openpets-managed";
+export const openPetsHookMarker = "--familiaros-managed";
 export const claudeHookEvents = ["UserPromptSubmit", "PreToolUse", "PermissionRequest", "Notification", "Stop", "StopFailure"] as const;
 
 export type ClaudeHookInstallStatus = "not_installed" | "installed" | "needs_update" | "error";
@@ -29,14 +29,14 @@ export function getClaudeUserSettingsPath(): string {
   return join(homedir(), ".claude", "settings.json");
 }
 
-export function createOpenPetsHookCommand(commandMode: OpenPetsCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): string {
-  const petArgs = selectedPetId === undefined ? "" : ` --pet ${shellQuote(validateOpenPetsPetArg(selectedPetId))}`;
+export function createFamiliarOSHookCommand(commandMode: FamiliarOSCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): string {
+  const petArgs = selectedPetId === undefined ? "" : ` --familiar ${shellQuote(validateFamiliarOSPetArg(selectedPetId))}`;
   if (commandMode === "local" || commandMode === "bundled") {
     const cliPath = commandMode === "bundled" ? getBundledClaudeCliPath() : getLocalClaudeCliPath();
     commandMode === "bundled" ? assertBundledClaudeCliPath() : assertLocalClaudeCliPath();
     return `${shellQuote(nodeCommand)} ${shellQuote(cliPath)} hook ${openPetsHookMarker}${petArgs}`;
   }
-  return `npx -y @open-pets/claude hook ${openPetsHookMarker}${petArgs}`;
+  return `npx -y @familiaros/claude hook ${openPetsHookMarker}${petArgs}`;
 }
 
 export function getLocalClaudeCliPath(): string {
@@ -50,7 +50,7 @@ export function getBundledClaudeCliPath(): string {
 export function assertLocalClaudeCliPath(): void {
   const path = getLocalClaudeCliPath();
   const expectedPrefix = dirname(fileURLToPath(import.meta.url));
-  if (!path.startsWith(expectedPrefix)) throw new Error("Local Claude hook path is outside the OpenPets package.");
+  if (!path.startsWith(expectedPrefix)) throw new Error("Local Claude hook path is outside the FamiliarOS package.");
   const stat = statSync(path);
   if (!stat.isFile()) throw new Error("Local Claude hook CLI path is not a regular file.");
 }
@@ -65,14 +65,14 @@ export function assertBundledClaudeCliPath(): void {
   const expectedRoot = realpathSync(mapAsarPathToUnpacked(join(dirname(fileURLToPath(import.meta.url)), "..", "..")));
   const realPath = realpathSync(path);
   const rel = relative(expectedRoot, realPath);
-  if (rel.startsWith("..") || isAbsolute(rel)) throw new Error("Bundled Claude hook CLI path is outside the packaged OpenPets resources.");
+  if (rel.startsWith("..") || isAbsolute(rel)) throw new Error("Bundled Claude hook CLI path is outside the packaged FamiliarOS resources.");
 }
 
 function isTrueAsarPath(path: string): boolean {
   return /app\.asar(?:$|[\\/])/.test(path) && !/app\.asar\.unpacked(?:$|[\\/])/.test(path);
 }
 
-export function createOpenPetsHookSettingsPreview(commandMode: OpenPetsCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): Record<string, unknown> {
+export function createFamiliarOSHookSettingsPreview(commandMode: FamiliarOSCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): Record<string, unknown> {
   const hooks: Record<string, unknown> = {};
   for (const event of claudeHookEvents) {
     hooks[event] = [{ hooks: [createHookCommandEntry(commandMode, selectedPetId, nodeCommand)] }];
@@ -80,8 +80,8 @@ export function createOpenPetsHookSettingsPreview(commandMode: OpenPetsCommandMo
   return { hooks };
 }
 
-export function doctorClaudeHooks(settingsPath = getClaudeUserSettingsPath(), commandMode: OpenPetsCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): ClaudeHookDoctorResult {
-  const preview = createOpenPetsHookSettingsPreview(commandMode, selectedPetId, nodeCommand);
+export function doctorClaudeHooks(settingsPath = getClaudeUserSettingsPath(), commandMode: FamiliarOSCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): ClaudeHookDoctorResult {
+  const preview = createFamiliarOSHookSettingsPreview(commandMode, selectedPetId, nodeCommand);
   const asyncSupported = isClaudeHookAsyncSupported();
   try {
     const settings = readClaudeSettings(settingsPath);
@@ -91,7 +91,7 @@ export function doctorClaudeHooks(settingsPath = getClaudeUserSettingsPath(), co
       settingsPath,
       exists: existsSync(settingsPath),
       valid: true,
-      message: `${asyncSupported ? status === "installed" ? "OpenPets Claude hooks are installed. Async hook install is enabled by OpenPets." : status === "needs_update" ? "OpenPets Claude hooks need update. Async hook install is enabled by OpenPets." : "OpenPets Claude hooks are not installed. Async hook install is enabled by OpenPets." : "Async hook install is disabled by OpenPets."} ${selectedPetId ? `Hook events target ${selectedPetId}.` : "Hook events target the default pet."}`,
+      message: `${asyncSupported ? status === "installed" ? "FamiliarOS Claude hooks are installed. Async hook install is enabled by FamiliarOS." : status === "needs_update" ? "FamiliarOS Claude hooks need update. Async hook install is enabled by FamiliarOS." : "FamiliarOS Claude hooks are not installed. Async hook install is enabled by FamiliarOS." : "Async hook install is disabled by FamiliarOS."} ${selectedPetId ? `Hook events target ${selectedPetId}.` : "Hook events target the default familiar."}`,
       preview,
       asyncSupported,
     };
@@ -100,47 +100,47 @@ export function doctorClaudeHooks(settingsPath = getClaudeUserSettingsPath(), co
   }
 }
 
-export function installClaudeHooks(settingsPath = getClaudeUserSettingsPath(), commandMode: OpenPetsCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): ClaudeHookWriteResult {
-  if (!isClaudeHookAsyncSupported()) throw new Error("Claude async hook support is not enabled for this OpenPets build.");
+export function installClaudeHooks(settingsPath = getClaudeUserSettingsPath(), commandMode: FamiliarOSCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): ClaudeHookWriteResult {
+  if (!isClaudeHookAsyncSupported()) throw new Error("Claude async hook support is not enabled for this FamiliarOS build.");
   const settings = readClaudeSettings(settingsPath);
   const status = getHookInstallStatus(settings, commandMode, selectedPetId, nodeCommand);
   if (status === "installed") return { ...doctorClaudeHooks(settingsPath, commandMode, selectedPetId, nodeCommand), changed: false };
   const backupPath = backupSettings(settingsPath);
-  const next = addOpenPetsHooks(removeOpenPetsHooks(settings), commandMode, selectedPetId, nodeCommand);
+  const next = addFamiliarOSHooks(removeFamiliarOSHooks(settings), commandMode, selectedPetId, nodeCommand);
   writeClaudeSettings(settingsPath, next);
   return { ...doctorClaudeHooks(settingsPath, commandMode, selectedPetId, nodeCommand), backupPath, changed: true };
 }
 
-export function uninstallClaudeHooks(settingsPath = getClaudeUserSettingsPath(), commandMode: OpenPetsCommandMode = "published"): ClaudeHookWriteResult {
+export function uninstallClaudeHooks(settingsPath = getClaudeUserSettingsPath(), commandMode: FamiliarOSCommandMode = "published"): ClaudeHookWriteResult {
   const settings = readClaudeSettings(settingsPath);
   const status = getHookInstallStatus(settings, commandMode);
   if (status === "not_installed") return { ...doctorClaudeHooks(settingsPath, commandMode), changed: false };
   const backupPath = backupSettings(settingsPath);
-  const next = removeOpenPetsHooks(settings);
+  const next = removeFamiliarOSHooks(settings);
   writeClaudeSettings(settingsPath, next);
   return { ...doctorClaudeHooks(settingsPath, commandMode), backupPath, changed: true };
 }
 
-export function addOpenPetsHooks(settings: Record<string, unknown>, commandMode: OpenPetsCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): Record<string, unknown> {
+export function addFamiliarOSHooks(settings: Record<string, unknown>, commandMode: FamiliarOSCommandMode = "published", selectedPetId?: string, nodeCommand = "node"): Record<string, unknown> {
   const next = structuredClone(settings) as Record<string, unknown>;
   assertSelectedHookEventsAreArrays(next);
   const hooks = isRecord(next.hooks) ? { ...next.hooks } : {};
   for (const event of claudeHookEvents) {
-    const existing = Array.isArray(hooks[event]) ? hooks[event].filter((entry) => !containsOpenPetsHook(entry)) : [];
+    const existing = Array.isArray(hooks[event]) ? hooks[event].filter((entry) => !containsFamiliarOSHook(entry)) : [];
     hooks[event] = [...existing, { hooks: [createHookCommandEntry(commandMode, selectedPetId, nodeCommand)] }];
   }
   next.hooks = hooks;
   return next;
 }
 
-export function removeOpenPetsHooks(settings: Record<string, unknown>): Record<string, unknown> {
+export function removeFamiliarOSHooks(settings: Record<string, unknown>): Record<string, unknown> {
   const next = structuredClone(settings) as Record<string, unknown>;
   if (!isRecord(next.hooks)) return next;
   assertSelectedHookEventsAreArrays(next);
   const hooks: Record<string, unknown> = { ...next.hooks };
   for (const [event, entries] of Object.entries(hooks)) {
     if (!Array.isArray(entries)) continue;
-    const cleaned = entries.map(removeOpenPetsHooksFromMatcher).filter((entry) => entry !== null);
+    const cleaned = entries.map(removeFamiliarOSHooksFromMatcher).filter((entry) => entry !== null);
     if (cleaned.length > 0) hooks[event] = cleaned;
     else delete hooks[event];
   }
@@ -149,7 +149,7 @@ export function removeOpenPetsHooks(settings: Record<string, unknown>): Record<s
   return next;
 }
 
-function getHookInstallStatus(settings: Record<string, unknown>, commandMode: OpenPetsCommandMode, selectedPetId?: string, nodeCommand = "node"): ClaudeHookInstallStatus {
+function getHookInstallStatus(settings: Record<string, unknown>, commandMode: FamiliarOSCommandMode, selectedPetId?: string, nodeCommand = "node"): ClaudeHookInstallStatus {
   if (settings.hooks !== undefined && !isRecord(settings.hooks)) throw new Error("Claude settings hooks field is not an object.");
   const hooks = isRecord(settings.hooks) ? settings.hooks : {};
   let foundAny = false;
@@ -157,8 +157,8 @@ function getHookInstallStatus(settings: Record<string, unknown>, commandMode: Op
   for (const event of claudeHookEvents) {
     const entries = hooks[event];
     if (!Array.isArray(entries)) return foundAny ? "needs_update" : "not_installed";
-    const currentCount = entries.filter((entry) => containsCurrentOpenPetsHook(entry, commandMode, selectedPetId, nodeCommand)).length;
-    const managedCount = entries.filter((entry) => containsOpenPetsHook(entry)).length;
+    const currentCount = entries.filter((entry) => containsCurrentFamiliarOSHook(entry, commandMode, selectedPetId, nodeCommand)).length;
+    const managedCount = entries.filter((entry) => containsFamiliarOSHook(entry)).length;
     const hasCurrent = currentCount === 1;
     if (managedCount > 0) foundAny = true;
     if (managedCount !== currentCount || currentCount > 1) staleManaged = true;
@@ -168,25 +168,25 @@ function getHookInstallStatus(settings: Record<string, unknown>, commandMode: Op
   return staleManaged ? "needs_update" : "installed";
 }
 
-function createHookCommandEntry(commandMode: OpenPetsCommandMode, selectedPetId?: string, nodeCommand = "node"): Record<string, unknown> {
-  return { type: "command", command: createOpenPetsHookCommand(commandMode, selectedPetId, nodeCommand), timeout: 3, async: true, asyncRewake: false };
+function createHookCommandEntry(commandMode: FamiliarOSCommandMode, selectedPetId?: string, nodeCommand = "node"): Record<string, unknown> {
+  return { type: "command", command: createFamiliarOSHookCommand(commandMode, selectedPetId, nodeCommand), timeout: 3, async: true, asyncRewake: false };
 }
 
-function containsCurrentOpenPetsHook(value: unknown, commandMode: OpenPetsCommandMode, selectedPetId?: string, nodeCommand = "node"): boolean {
+function containsCurrentFamiliarOSHook(value: unknown, commandMode: FamiliarOSCommandMode, selectedPetId?: string, nodeCommand = "node"): boolean {
   if (!isRecord(value) || !Array.isArray(value.hooks)) return false;
-  const command = createOpenPetsHookCommand(commandMode, selectedPetId, nodeCommand);
+  const command = createFamiliarOSHookCommand(commandMode, selectedPetId, nodeCommand);
   return value.hooks.some((hook) => isRecord(hook) && hook.type === "command" && hook.command === command && hook.timeout === 3 && hook.async === true && hook.asyncRewake === false);
 }
 
-function containsOpenPetsHook(value: unknown): boolean {
+function containsFamiliarOSHook(value: unknown): boolean {
   if (isRecord(value) && typeof value.command === "string" && value.command.includes(openPetsHookMarker)) return true;
-  if (isRecord(value) && Array.isArray(value.hooks)) return value.hooks.some(containsOpenPetsHook);
+  if (isRecord(value) && Array.isArray(value.hooks)) return value.hooks.some(containsFamiliarOSHook);
   return false;
 }
 
-function removeOpenPetsHooksFromMatcher(value: unknown): unknown | null {
-  if (!isRecord(value) || !Array.isArray(value.hooks)) return containsOpenPetsHook(value) ? null : value;
-  const hooks = value.hooks.filter((hook) => !containsOpenPetsHook(hook));
+function removeFamiliarOSHooksFromMatcher(value: unknown): unknown | null {
+  if (!isRecord(value) || !Array.isArray(value.hooks)) return containsFamiliarOSHook(value) ? null : value;
+  const hooks = value.hooks.filter((hook) => !containsFamiliarOSHook(hook));
   if (hooks.length === 0) return null;
   return { ...value, hooks };
 }
@@ -211,7 +211,7 @@ function assertSelectedHookEventsAreArrays(settings: Record<string, unknown>): v
 }
 
 function isClaudeHookAsyncSupported(): boolean {
-  return process.env.OPENPETS_DISABLE_CLAUDE_ASYNC_HOOKS !== "1";
+  return process.env.FAMILIAROS_DISABLE_CLAUDE_ASYNC_HOOKS !== "1";
 }
 
 function shellQuote(value: string): string {
@@ -231,7 +231,7 @@ function writeClaudeSettings(path: string, settings: Record<string, unknown>): v
 function backupSettings(path: string): string | undefined {
   if (!existsSync(path)) return undefined;
   assertSafeSettingsPath(path);
-  const backupPath = `${path}.openpets-backup-${new Date().toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z")}.json`;
+  const backupPath = `${path}.familiaros-backup-${new Date().toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z")}.json`;
   writeFileSync(backupPath, readFileSync(path), { mode: 0o600 });
   try { chmodSync(backupPath, 0o600); } catch { /* best effort */ }
   return backupPath;
diff --git a/packages/claude/src/hooks.ts b/packages/claude/src/hooks.ts
index 5ae960e5..749febfe 100644
--- a/packages/claude/src/hooks.ts
+++ b/packages/claude/src/hooks.ts
@@ -2,8 +2,8 @@ import { lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync,
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { homedir, tmpdir, userInfo } from "node:os";
 
-import { createOpenPetsClient, type OpenPetsClient, type OpenPetsReaction, OpenPetsClientError } from "@open-pets/client";
-import { validateHookSpeech as validateSharedHookSpeech } from "@open-pets/agent-events";
+import { createFamiliarOSClient, type FamiliarOSClient, type FamiliarOSReaction, FamiliarOSClientError } from "@familiaros/client";
+import { validateHookSpeech as validateSharedHookSpeech } from "@familiaros/agent-events";
 
 import { pickHookSpeech, type HookSpeechCategory } from "./hook-messages.js";
 
@@ -11,12 +11,12 @@ export type ClaudeHookEventName = "UserPromptSubmit" | "PreToolUse" | "Permissio
 
 export interface ClaudeHookDecision {
   readonly eventName?: string;
-  readonly reaction?: OpenPetsReaction;
+  readonly reaction?: FamiliarOSReaction;
   readonly speechCategory?: HookSpeechCategory;
 }
 
 export interface ClaudeHookOptions {
-  readonly client?: OpenPetsClient;
+  readonly client?: FamiliarOSClient;
   readonly configuredPetId?: string;
   readonly projectLocal?: boolean;
   readonly now?: () => number;
@@ -37,8 +37,8 @@ export async function runClaudeHookFromStdin(stdin: NodeJS.ReadStream = process.
     await handleClaudeHookPayload(raw, options);
     return 0;
   } catch (error) {
-    if (options.debug || process.env.OPENPETS_DEBUG === "1") {
-      process.stderr.write(`OpenPets Claude hook ignored error: ${sanitizeDebugError(error)}\n`);
+    if (options.debug || process.env.FAMILIAROS_DEBUG === "1") {
+      process.stderr.write(`FamiliarOS Claude hook ignored error: ${sanitizeDebugError(error)}\n`);
     }
     return 0;
   }
@@ -53,13 +53,13 @@ export async function handleClaudeHookPayload(raw: string, options: ClaudeHookOp
   }
   const decision = mapClaudeHookEvent(parsed);
   if (!decision?.reaction) return decision;
-  if (!options.projectLocal && hasProjectLocalOpenPetsHook()) return decision;
+  if (!options.projectLocal && hasProjectLocalFamiliarOSHook()) return decision;
 
   const shouldSpeak = decision.speechCategory ? shouldSendSpeech(decision.speechCategory, options) : false;
   const shouldReact = shouldSendReaction(decision.reaction, options);
   if (!shouldSpeak && !shouldReact) return decision;
 
-  const client = options.client ?? createOpenPetsClient({ connectTimeoutMs: 500, responseTimeoutMs: 500 });
+  const client = options.client ?? createFamiliarOSClient({ connectTimeoutMs: 500, responseTimeoutMs: 500 });
   const lease = options.configuredPetId ? await acquireHookLease(client, options.configuredPetId, options.debug) : undefined;
   try {
     if (decision.speechCategory && shouldSpeak) {
@@ -69,14 +69,14 @@ export async function handleClaudeHookPayload(raw: string, options: ClaudeHookOp
       await client.react(decision.reaction, { leaseId: lease?.leaseId });
     }
   } catch (error) {
-    if (!(error instanceof OpenPetsClientError) && options.debug) {
-      process.stderr.write(`OpenPets Claude hook client error: ${sanitizeDebugError(error)}\n`);
+    if (!(error instanceof FamiliarOSClientError) && options.debug) {
+      process.stderr.write(`FamiliarOS Claude hook client error: ${sanitizeDebugError(error)}\n`);
     }
   }
   return decision;
 }
 
-export function hasProjectLocalOpenPetsHook(projectDir = process.env.CLAUDE_PROJECT_DIR): boolean {
+export function hasProjectLocalFamiliarOSHook(projectDir = process.env.CLAUDE_PROJECT_DIR): boolean {
   if (!projectDir || /[\0\r\n]/.test(projectDir)) return false;
   try {
     const projectReal = realpathSync(projectDir);
@@ -89,24 +89,24 @@ export function hasProjectLocalOpenPetsHook(projectDir = process.env.CLAUDE_PROJ
     const settingsStat = statSync(settingsPath);
     if (!settingsStat.isFile() || settingsStat.size <= 0 || settingsStat.size > maxProjectLocalSettingsBytes) return false;
     const settings = JSON.parse(readFileSync(settingsPath, "utf8")) as unknown;
-    return containsProjectLocalOpenPetsHook(settings);
+    return containsProjectLocalFamiliarOSHook(settings);
   } catch {
     return false;
   }
 }
 
-function containsProjectLocalOpenPetsHook(value: unknown): boolean {
-  if (typeof value === "string") return value.includes("--openpets-managed") && value.includes("--project-local");
-  if (Array.isArray(value)) return value.some(containsProjectLocalOpenPetsHook);
-  if (isRecord(value)) return Object.values(value).some(containsProjectLocalOpenPetsHook);
+function containsProjectLocalFamiliarOSHook(value: unknown): boolean {
+  if (typeof value === "string") return value.includes("--familiaros-managed") && value.includes("--project-local");
+  if (Array.isArray(value)) return value.some(containsProjectLocalFamiliarOSHook);
+  if (isRecord(value)) return Object.values(value).some(containsProjectLocalFamiliarOSHook);
   return false;
 }
 
-async function acquireHookLease(client: OpenPetsClient, requestedPetId: string, debug = false): Promise<{ readonly leaseId: string } | undefined> {
+async function acquireHookLease(client: FamiliarOSClient, requestedPetId: string, debug = false): Promise<{ readonly leaseId: string } | undefined> {
   try {
     return await client.acquireLease({ requestedPetId });
   } catch (error) {
-    if (debug) process.stderr.write(`OpenPets Claude hook lease unavailable: ${sanitizeDebugError(error)}\n`);
+    if (debug) process.stderr.write(`FamiliarOS Claude hook lease unavailable: ${sanitizeDebugError(error)}\n`);
     return undefined;
   }
 }
@@ -135,15 +135,15 @@ export function validateHookSpeech(message: string): string {
 export function getDefaultThrottlePath(): string {
   if (process.platform === "win32") {
     const base = process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local");
-    return join(base, "OpenPets", "claude-hook-throttle.json");
+    return join(base, "FamiliarOS", "claude-hook-throttle.json");
   }
   const stateHome = process.env.XDG_STATE_HOME || join(homedir(), ".local", "state");
-  if (stateHome) return join(stateHome, "openpets", "claude-hook-throttle.json");
+  if (stateHome) return join(stateHome, "familiaros", "claude-hook-throttle.json");
   const uid = safeUid();
-  return join(tmpdir(), `openpets-${uid}`, "claude-hook-throttle.json");
+  return join(tmpdir(), `familiaros-${uid}`, "claude-hook-throttle.json");
 }
 
-function classifyToolReaction(payload: Record<string, unknown>): OpenPetsReaction | undefined {
+function classifyToolReaction(payload: Record<string, unknown>): FamiliarOSReaction | undefined {
   const toolName = typeof payload.tool_name === "string" ? payload.tool_name : "";
   if (toolName === "Edit" || toolName === "Write" || toolName === "MultiEdit") return "editing";
   if (toolName === "Bash") {
@@ -163,7 +163,7 @@ function shouldSendSpeech(category: HookSpeechCategory, options: ClaudeHookOptio
   return shouldSendThrottleKey(category, cooldown, now, options.throttlePath ?? getDefaultThrottlePath());
 }
 
-function shouldSendReaction(reaction: OpenPetsReaction, options: ClaudeHookOptions): boolean {
+function shouldSendReaction(reaction: FamiliarOSReaction, options: ClaudeHookOptions): boolean {
   const now = options.now?.() ?? Date.now();
   return shouldSendThrottleKey(`reaction:${reaction}`, reactionCooldownMs, now, options.throttlePath ?? getDefaultThrottlePath());
 }
diff --git a/packages/claude/src/index.ts b/packages/claude/src/index.ts
index 64cd3d33..9d99bf92 100644
--- a/packages/claude/src/index.ts
+++ b/packages/claude/src/index.ts
@@ -1,4 +1,4 @@
-export const claudePackageName = "@open-pets/claude";
+export const claudePackageName = "@familiaros/claude";
 
 export * from "./claude-code.js";
 export * from "./hooks.js";
diff --git a/packages/cli/codemap.md b/packages/cli/codemap.md
index 42d4cccc..231d2908 100644
--- a/packages/cli/codemap.md
+++ b/packages/cli/codemap.md
@@ -1,33 +1,33 @@
 # packages/cli/
 
-Main CLI tool for OpenPets agent configuration and pet management.
+Main CLI tool for FamiliarOS agent configuration and familiar management.
 
 ## Responsibility
 
-Primary user-facing CLI for the OpenPets ecosystem. Provides commands for: installing pets from gallery, configuring projects for Claude/OpenCode/Cursor agents, running MCP server wrapper, executing Claude hooks, and direct pet interaction (status, react, say).
+Primary user-facing CLI for the FamiliarOS ecosystem. Provides commands for: installing familiars from gallery, configuring projects for Claude/OpenCode/Cursor agents, running MCP server wrapper, executing Claude hooks, and direct familiar interaction (status, react, say).
 
 ## Design/Patterns
 
 **Command Router**: `main()` dispatches to subcommands based on `process.argv[2]`:
-- `install <pet-id>` - Install pet via running app
+- `install <familiar-id>` - Install familiar via running app
 - `configure` - Interactive project setup for Claude, OpenCode, or Cursor
-- `status` - Check OpenPets desktop app connectivity and print JSON status
-- `pets` - List installed pets with flags (default, broken)
+- `status` - Check FamiliarOS desktop app connectivity and print JSON status
+- `familiars` - List installed familiars with flags (default, broken)
 - `react <reaction>` - Send reaction to desktop app
-- `say <message> [--reaction <reaction>]` - Display message on pet
-- `mcp` - Spawn MCP server (delegates to `@open-pets/mcp`)
+- `say <message> [--reaction <reaction>]` - Display message on familiar
+- `mcp` - Spawn MCP server (delegates to `@familiaros/mcp`)
 - `hook` - Execute Claude hook from stdin
 
 **Configuration Flow** (`configureProject`):
 1. Resolve project directory (symlink/escape checks)
 2. Route to agent-specific handler (claude/opencode/cursor)
-3. For Claude: Assert availability, list pets, build MCP config, write hooks
-4. For OpenCode: Prepare and write OpenCode config via `@open-pets/opencode`
-5. For Cursor: Configure MCP in `.cursor/mcp.json`, optional rules in `.cursor/rules/openpets.mdc`
+3. For Claude: Assert availability, list familiars, build MCP config, write hooks
+4. For OpenCode: Prepare and write OpenCode config via `@familiaros/opencode`
+5. For Cursor: Configure MCP in `.cursor/mcp.json`, optional rules in `.cursor/rules/familiaros.mdc`
 
 **Cursor Configuration**:
 - `--with-rules` - Install MCP + project rules
-- `--rules-only` - Install only `.cursor/rules/openpets.mdc`
+- `--rules-only` - Install only `.cursor/rules/familiaros.mdc`
 - `--remove-rules` - Remove managed rules file
 - Status classification: `not_installed`, `installed`, `needs_update`, `conflict`, `error`
 - Atomic writes with backup creation
@@ -38,15 +38,15 @@ Primary user-facing CLI for the OpenPets ecosystem. Provides commands for: insta
 - Settings file atomic writes (temp + rename pattern)
 - Shell argument quoting for command injection prevention
 
-**Pet Resolution** (`resolveConfiguredPet`):
-- Validates explicit `--pet` argument
-- Otherwise: fetches installed pets, interactive TTY prompt
-- Validates selected pet is not broken
+**Familiar Resolution** (`resolveConfiguredPet`):
+- Validates explicit `--familiar` argument
+- Otherwise: fetches installed familiars, interactive TTY prompt
+- Validates selected familiar is not broken
 
 ## Flow
 
 ```
-openpets configure --agent claude --pet <id> --cwd <dir>
+familiaros configure --agent claude --familiar <id> --cwd <dir>
     ↓
 resolveProjectDir() → assertSafeProjectHookPath()
     ↓
@@ -60,29 +60,29 @@ runClaudeMcpAddJson() → spawnSync "claude mcp add-json ..."
     ↓
 writePreparedHooks() → Atomic write to .claude/settings.local.json
 
-openpets configure --agent cursor --with-rules
+familiaros configure --agent cursor --with-rules
     ↓
 readCursorMcpConfig() → classifyCursorMcpStatus()
     ↓
-readCursorOpenPetsRules() → classifyCursorRulesStatus()
+readCursorFamiliarOSRules() → classifyCursorRulesStatus()
     ↓
 planCursorMcpInstall/Replace() → executeCursorMcpWrite()
     ↓
 planCursorRulesInstall/Replace() → executeCursorRulesWrite()
 
-openpets status
+familiaros status
     ↓
-createOpenPetsClient().status() → Print JSON result
+createFamiliarOSClient().status() → Print JSON result
 ```
 
 ## Integration Points
 
 **Dependencies**:
-- `@open-pets/client` - Pet listing, installation, status, react, say
-- `@open-pets/claude` - Hook management, MCP config
-- `@open-pets/mcp` - MCP server spawning
-- `@open-pets/opencode` - OpenCode project setup
-- `@open-pets/cursor` - Cursor project setup (MCP + rules)
+- `@familiaros/client` - Familiar listing, installation, status, react, say
+- `@familiaros/claude` - Hook management, MCP config
+- `@familiaros/mcp` - MCP server spawning
+- `@familiaros/opencode` - OpenCode project setup
+- `@familiaros/cursor` - Cursor project setup (MCP + rules)
 
 **External Commands**:
 - `claude` - Claude Code CLI for MCP configuration
diff --git a/packages/cli/package.json b/packages/cli/package.json
index d4830bd2..8513249a 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,17 +1,17 @@
 {
-  "name": "@open-pets/cli",
+  "name": "@familiaros/cli",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/cli"
   },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "openpets": "dist/index.js"
+    "familiaros": "dist/index.js"
   },
   "files": [
     "dist",
@@ -37,10 +37,10 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@open-pets/client": "workspace:*",
-    "@open-pets/claude": "workspace:*",
-    "@open-pets/cursor": "workspace:*",
-    "@open-pets/mcp": "workspace:*",
-    "@open-pets/opencode": "workspace:*"
+    "@familiaros/client": "workspace:*",
+    "@familiaros/claude": "workspace:*",
+    "@familiaros/cursor": "workspace:*",
+    "@familiaros/mcp": "workspace:*",
+    "@familiaros/opencode": "workspace:*"
   }
 }
diff --git a/packages/cli/schemas/openpets.plugin.schema.json b/packages/cli/schemas/openpets.plugin.schema.json
index af160682..d2df7f85 100644
--- a/packages/cli/schemas/openpets.plugin.schema.json
+++ b/packages/cli/schemas/openpets.plugin.schema.json
@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openpets.dev/schemas/openpets.plugin.schema.json",
-  "title": "OpenPets plugin manifest",
-  "description": "Manifest for OpenPets desktop pet plugins (openpets.plugin.json). manifestVersion 1 is declarative, 2 is the JavaScript SDK v2 surface, 3 is SDK v3 (SuperPlugins).",
+  "$id": "https://familiaros.dev/schemas/familiaros.plugin.schema.json",
+  "title": "FamiliarOS plugin manifest",
+  "description": "Manifest for FamiliarOS desktop familiar plugins (familiaros.plugin.json). manifestVersion 1 is declarative, 2 is the JavaScript SDK v2 surface, 3 is SDK v3 (SuperPlugins).",
   "type": "object",
   "required": ["manifestVersion", "id", "name", "version", "runtime", "permissions"],
   "properties": {
@@ -21,8 +21,8 @@
       "uniqueItems": true,
       "items": {
         "enum": [
-          "pet:speak", "pet:reaction", "pet:move", "timer", "schedule", "storage", "status", "commands", "network",
-          "pet:interact", "pet:pin", "pet:animate", "pet:speak:dynamic", "pet:drop", "pets:read", "pets:manage",
+          "familiar:speak", "familiar:reaction", "familiar:move", "timer", "schedule", "storage", "status", "commands", "network",
+          "familiar:interact", "familiar:pin", "familiar:animate", "familiar:speak:dynamic", "familiar:drop", "familiars:read", "familiars:manage",
           "audio", "events", "ui:toast", "ui:panel", "notify", "bus", "ai", "secrets", "voice:speak", "voice:listen",
           "auth", "files", "system:openExternal", "system:metrics", "clipboard", "network:write"
         ]
@@ -74,13 +74,13 @@
                   "type": "object",
                   "additionalProperties": false,
                   "required": ["type", "message"],
-                  "properties": { "type": { "const": "pet.speak" }, "message": { "oneOf": [{ "type": "string" }, { "$ref": "#/definitions/configRef" }] } }
+                  "properties": { "type": { "const": "familiar.speak" }, "message": { "oneOf": [{ "type": "string" }, { "$ref": "#/definitions/configRef" }] } }
                 },
                 {
                   "type": "object",
                   "additionalProperties": false,
                   "required": ["type", "reaction"],
-                  "properties": { "type": { "const": "pet.react" }, "reaction": { "oneOf": [{ "type": "string" }, { "$ref": "#/definitions/configRef" }] } }
+                  "properties": { "type": { "const": "familiar.react" }, "reaction": { "oneOf": [{ "type": "string" }, { "$ref": "#/definitions/configRef" }] } }
                 }
               ]
             }
diff --git a/packages/cli/src/check-cli-contract.ts b/packages/cli/src/check-cli-contract.ts
index f9be3b94..b2192df6 100644
--- a/packages/cli/src/check-cli-contract.ts
+++ b/packages/cli/src/check-cli-contract.ts
@@ -11,27 +11,27 @@ import { validatePluginFolder } from "./plugin-validate.js";
 
 const packageVersion = (JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")) as { readonly version: string }).version;
 
-const parsed = parseConfigureArgs(["--agent", "claude", "--pet", "fixer", "--cwd", "/tmp/project", "--yes"]);
+const parsed = parseConfigureArgs(["--agent", "claude", "--familiar", "fixer", "--cwd", "/tmp/project", "--yes"]);
 assert.equal(parsed.agent, "claude");
 assert.equal(parsed.petId, "fixer");
 assert.equal(parsed.cwd, "/tmp/project");
 assert.equal(parsed.yes, true);
-assert.equal(parseConfigureArgs(["--pet", "fixer", "--force"]).force, true);
-assert.equal(parseConfigureArgs(["--pet", "fixer", "--replace"]).force, true);
-assert.equal(parseConfigureArgs(["--pet", "fixer", "--local-dev"]).localDev, true);
-assert.equal(parseConfigureArgs(["--pet=fixer"]).petId, "fixer");
-assert.equal(parseConfigureArgs(["--agent", "opencode", "--pet", "fixer"]).agent, "opencode");
-assert.equal(parseConfigureArgs(["--agent", "cursor", "--pet", "fixer"]).agent, "cursor");
-assert.equal(parseConfigureArgs(["--agent", "cursor", "--pet", "fixer"]).cwd, process.cwd());
+assert.equal(parseConfigureArgs(["--familiar", "fixer", "--force"]).force, true);
+assert.equal(parseConfigureArgs(["--familiar", "fixer", "--replace"]).force, true);
+assert.equal(parseConfigureArgs(["--familiar", "fixer", "--local-dev"]).localDev, true);
+assert.equal(parseConfigureArgs(["--familiar=fixer"]).petId, "fixer");
+assert.equal(parseConfigureArgs(["--agent", "opencode", "--familiar", "fixer"]).agent, "opencode");
+assert.equal(parseConfigureArgs(["--agent", "cursor", "--familiar", "fixer"]).agent, "cursor");
+assert.equal(parseConfigureArgs(["--agent", "cursor", "--familiar", "fixer"]).cwd, process.cwd());
 assert.equal(parseConfigureArgs(["--agent", "cursor", "--rules-only"]).cursorRulesMode, "only");
 assert.equal(parseConfigureArgs(["--agent", "cursor", "--remove-rules"]).cursorRulesMode, "remove");
 assert.equal(parseConfigureArgs(["--agent", "cursor", "--with-rules"]).cursorRulesMode, "with");
 assert.throws(() => parseConfigureArgs(["--agent", "cursor", "--with-rules", "--rules-only"]));
 assert.throws(() => parseConfigureArgs(["--agent", "claude", "--rules-only"]));
-assert.throws(() => parseConfigureArgs(["--pet", "bad/pet"]));
+assert.throws(() => parseConfigureArgs(["--familiar", "bad/familiar"]));
 assert.deepEqual(parseInstallArgs(["review-owl"]), { petId: "review-owl" });
 assert.throws(() => parseInstallArgs([]));
-assert.throws(() => parseInstallArgs(["bad/pet"]));
+assert.throws(() => parseInstallArgs(["bad/familiar"]));
 assert.deepEqual(parseReactArgs(["success"]), { reaction: "success" });
 assert.throws(() => parseReactArgs([]));
 assert.throws(() => parseReactArgs(["bad"]));
@@ -53,11 +53,11 @@ assert.throws(() => parsePluginNewArgs(["x", "--unknown"]));
 assert.throws(() => parsePluginNewArgs(["x", "--template", "nope"]));
 assert.throws(() => parsePluginNewArgs(["!!!"]));
 
-const pluginScaffoldDir = mkdtempSync(join(tmpdir(), "openpets-plugin-"));
+const pluginScaffoldDir = mkdtempSync(join(tmpdir(), "familiaros-plugin-"));
 try {
   const target = join(pluginScaffoldDir, "demo");
   const result = scaffoldPlugin({ name: "Demo Plugin", id: "local.demo", dir: target, template: "blank" });
-  assert.equal(result.manifestPath, join(target, "openpets.plugin.json"));
+  assert.equal(result.manifestPath, join(target, "familiaros.plugin.json"));
   const manifest = JSON.parse(readFileSync(result.manifestPath, "utf8")) as { readonly manifestVersion: number; readonly id: string; readonly entry: string; readonly sdkVersion: string; readonly permissions: readonly string[] };
   assert.equal(manifest.manifestVersion, 3);
   assert.equal(manifest.id, "local.demo");
@@ -65,8 +65,8 @@ try {
   assert.ok(manifest.sdkVersion.startsWith("3."));
   assert.ok(manifest.permissions.includes("commands"));
   const entry = readFileSync(result.entryPath, "utf8");
-  assert.match(entry, /OpenPetsPlugin\.register/);
-  assert.match(entry, /reference types="@open-pets\/plugin-sdk"/);
+  assert.match(entry, /FamiliarOSPlugin\.register/);
+  assert.match(entry, /reference types="@familiaros\/plugin-sdk"/);
   assert.ok(existsSync(join(target, "README.md")));
   assert.ok(existsSync(join(target, "test.js")));
   assert.equal(validatePluginFolder(target).ok, true, JSON.stringify(validatePluginFolder(target).issues));
@@ -86,11 +86,11 @@ try {
   rmSync(pluginScaffoldDir, { recursive: true, force: true });
 }
 
-const pinned = createVersionPinnedCliCommand("1.2.3", ["mcp", "--pet", "fixer"]);
-assert.deepEqual(pinned, { command: "npx", args: ["-y", `${cliPackageName}@1.2.3`, "mcp", "--pet", "fixer"] });
-const localDev = createLocalDevCliCommand(["mcp", "--pet", "fixer"]);
+const pinned = createVersionPinnedCliCommand("1.2.3", ["mcp", "--familiar", "fixer"]);
+assert.deepEqual(pinned, { command: "npx", args: ["-y", `${cliPackageName}@1.2.3`, "mcp", "--familiar", "fixer"] });
+const localDev = createLocalDevCliCommand(["mcp", "--familiar", "fixer"]);
 assert.equal(localDev.command, process.execPath);
-assert.deepEqual(localDev.args.slice(-3), ["mcp", "--pet", "fixer"]);
+assert.deepEqual(localDev.args.slice(-3), ["mcp", "--familiar", "fixer"]);
 
 let listPetsCalled = false;
 const offlineExplicitPet = await resolveConfiguredPet({
@@ -103,32 +103,32 @@ assert.deepEqual(offlineExplicitPet, { id: "fixer", displayName: "fixer" });
 assert.equal(listPetsCalled, false);
 
 const mcpArgs = createClaudeMcpAddJsonArgs({ type: "stdio", command: pinned.command, args: pinned.args, env: {} });
-assert.deepEqual(mcpArgs.slice(0, 3), ["mcp", "add-json", "openpets"]);
+assert.deepEqual(mcpArgs.slice(0, 3), ["mcp", "add-json", "familiaros"]);
 assert.equal(mcpArgs.at(-2), "--scope");
 assert.equal(mcpArgs.at(-1), "local");
 const mcpJson = JSON.parse(mcpArgs[3] ?? "{}") as { readonly command?: string; readonly args?: readonly string[] };
 assert.equal(mcpJson.command, "npx");
-assert.deepEqual(mcpJson.args, ["-y", `${cliPackageName}@1.2.3`, "mcp", "--pet", "fixer"]);
+assert.deepEqual(mcpJson.args, ["-y", `${cliPackageName}@1.2.3`, "mcp", "--familiar", "fixer"]);
 
-const dir = mkdtempSync(join(tmpdir(), "openpets-cli-"));
+const dir = mkdtempSync(join(tmpdir(), "familiaros-cli-"));
 try {
   const project = join(dir, "project");
   const settingsDir = join(project, ".claude");
   mkdirSync(project);
   writeFileSync(join(dir, "placeholder"), "x", "utf8");
   assert.throws(() => assertSafeProjectHookPath(join(dir, "missing")));
-  installProjectLocalHooks(project, "npx -y @open-pets/cli@1.2.3 hook --openpets-managed --project-local --pet fixer");
+  installProjectLocalHooks(project, "npx -y @familiaros/cli@1.2.3 hook --familiaros-managed --project-local --familiar fixer");
   const settingsPath = join(settingsDir, "settings.local.json");
   const settings = JSON.parse(readFileSync(settingsPath, "utf8")) as { readonly hooks?: Record<string, Array<{ readonly hooks: Array<{ readonly command: string }> }>> };
-  assert.ok(settings.hooks?.UserPromptSubmit?.[0]?.hooks[0]?.command.includes("--project-local --pet fixer"));
+  assert.ok(settings.hooks?.UserPromptSubmit?.[0]?.hooks[0]?.command.includes("--project-local --familiar fixer"));
 
-  writeFileSync(settingsPath, JSON.stringify({ hooks: { Stop: [{ hooks: [{ type: "command", command: "echo keep" }] }, { hooks: [{ type: "command", command: "npx -y @open-pets/cli@old hook --openpets-managed" }] }] } }), "utf8");
-  installProjectLocalHooks(project, "npx -y @open-pets/cli@1.2.3 hook --openpets-managed --project-local --pet fixer");
+  writeFileSync(settingsPath, JSON.stringify({ hooks: { Stop: [{ hooks: [{ type: "command", command: "echo keep" }] }, { hooks: [{ type: "command", command: "npx -y @familiaros/cli@old hook --familiaros-managed" }] }] } }), "utf8");
+  installProjectLocalHooks(project, "npx -y @familiaros/cli@1.2.3 hook --familiaros-managed --project-local --familiar fixer");
   const updated = JSON.parse(readFileSync(settingsPath, "utf8")) as { readonly hooks?: Record<string, Array<{ readonly hooks: Array<{ readonly command: string; readonly timeout?: number }> }>> };
   const stopCommands = updated.hooks?.Stop?.flatMap((entry) => entry.hooks.map((hook) => hook.command)) ?? [];
   assert.ok(stopCommands.includes("echo keep"));
   assert.equal(stopCommands.some((command) => command.includes("@old")), false);
-  assert.ok(stopCommands.some((command) => command.includes("--project-local --pet fixer")));
+  assert.ok(stopCommands.some((command) => command.includes("--project-local --familiar fixer")));
   assert.equal(updated.hooks?.UserPromptSubmit?.[0]?.hooks[0]?.timeout, 10);
 
   const badSettingsProject = join(dir, "bad-settings-project");
@@ -139,7 +139,7 @@ try {
   const malformedHooksProject = join(dir, "malformed-hooks-project");
   mkdirSync(join(malformedHooksProject, ".claude"), { recursive: true });
   writeFileSync(join(malformedHooksProject, ".claude", "settings.local.json"), JSON.stringify({ hooks: { Stop: { bad: true } } }), "utf8");
-  assert.throws(() => installProjectLocalHooks(malformedHooksProject, "npx -y @open-pets/cli@1.2.3 hook --openpets-managed --project-local --pet fixer"));
+  assert.throws(() => installProjectLocalHooks(malformedHooksProject, "npx -y @familiaros/cli@1.2.3 hook --familiaros-managed --project-local --familiar fixer"));
 
   const symlinkProject = join(dir, "symlink-project");
   const outside = join(dir, "outside-claude");
@@ -157,22 +157,22 @@ try {
   const oldPath = process.env.PATH;
   process.env.PATH = `${binDir}:${oldPath ?? ""}`;
   try {
-    runClaudeMcpAddJson(project, { type: "stdio", command: "npx", args: ["-y", "@open-pets/cli@1.2.3", "mcp", "--pet", "fixer"], env: {} }, true);
+    runClaudeMcpAddJson(project, { type: "stdio", command: "npx", args: ["-y", "@familiaros/cli@1.2.3", "mcp", "--familiar", "fixer"], env: {} }, true);
   } finally {
     process.env.PATH = oldPath;
   }
   const claudeLog = JSON.parse(readFileSync(logPath, "utf8")) as Array<{ readonly cwd: string; readonly argv: readonly string[] }>;
   assert.equal(claudeLog.at(-1)?.cwd, realpathSync(project));
-  assert.deepEqual(claudeLog.at(-2)?.argv, ["mcp", "remove", "openpets", "--scope", "local"]);
-  assert.deepEqual(claudeLog.at(-1)?.argv.slice(0, 3), ["mcp", "add-json", "openpets"]);
+  assert.deepEqual(claudeLog.at(-2)?.argv, ["mcp", "remove", "familiaros", "--scope", "local"]);
+  assert.deepEqual(claudeLog.at(-1)?.argv.slice(0, 3), ["mcp", "add-json", "familiaros"]);
   const loggedMcpJson = JSON.parse(claudeLog.at(-1)?.argv[3] ?? "{}") as { readonly command?: string; readonly args?: readonly string[]; readonly env?: Record<string, unknown> };
   assert.equal(loggedMcpJson.command, "npx");
-  assert.deepEqual(loggedMcpJson.args, ["-y", "@open-pets/cli@1.2.3", "mcp", "--pet", "fixer"]);
+  assert.deepEqual(loggedMcpJson.args, ["-y", "@familiaros/cli@1.2.3", "mcp", "--familiar", "fixer"]);
   assert.deepEqual(loggedMcpJson.env, {});
   assert.equal(claudeLog.at(-1)?.argv.at(-2), "--scope");
   assert.equal(claudeLog.at(-1)?.argv.at(-1), "local");
 
-  const cliBinLink = join(binDir, "openpets");
+  const cliBinLink = join(binDir, "familiaros");
   symlinkSync(new URL("./index.js", import.meta.url).pathname, cliBinLink);
   const symlinkedHelp = spawnSync(process.execPath, [cliBinLink, "--help"], { encoding: "utf8" });
   assert.equal(symlinkedHelp.status, 0);
@@ -182,15 +182,15 @@ try {
   mkdirSync(opencodeProject);
   await configureProject({ agent: "opencode", petId: "fixer", cwd: opencodeProject, yes: true, force: false, localDev: false });
   const opencodeConfigPath = join(opencodeProject, ".opencode", "opencode.jsonc");
-  const opencodeInstructionPath = join(opencodeProject, ".opencode", "openpets.md");
+  const opencodeInstructionPath = join(opencodeProject, ".opencode", "familiaros.md");
   const opencodeConfig = JSON.parse(readFileSync(opencodeConfigPath, "utf8")) as { readonly mcp?: Record<string, { readonly command?: readonly string[] }>; readonly instructions?: readonly string[]; readonly plugin?: readonly unknown[] };
-  assert.deepEqual(opencodeConfig.mcp?.openpets?.command, ["npx", "-y", `@open-pets/cli@${packageVersion}`, "mcp", "--pet", "fixer"]);
-  assert.deepEqual(opencodeConfig.instructions, [".opencode/openpets.md"]);
-  assert.deepEqual(opencodeConfig.plugin, [[`@open-pets/opencode@${packageVersion}`, { pet: "fixer" }]]);
-  assert.match(readFileSync(opencodeInstructionPath, "utf8"), /OPENPETS:START/);
+  assert.deepEqual(opencodeConfig.mcp?.familiaros?.command, ["npx", "-y", `@familiaros/cli@${packageVersion}`, "mcp", "--familiar", "fixer"]);
+  assert.deepEqual(opencodeConfig.instructions, [".opencode/familiaros.md"]);
+  assert.deepEqual(opencodeConfig.plugin, [[`@familiaros/opencode@${packageVersion}`, { familiar: "fixer" }]]);
+  assert.match(readFileSync(opencodeInstructionPath, "utf8"), /FAMILIAROS:START/);
   await configureProject({ agent: "opencode", petId: "fixer", cwd: opencodeProject, yes: true, force: false, localDev: false });
   const opencodeConfigAgain = readFileSync(opencodeConfigPath, "utf8");
-  assert.equal((opencodeConfigAgain.match(/@open-pets\/opencode/g) ?? []).length, 1);
+  assert.equal((opencodeConfigAgain.match(/@familiaros\/opencode/g) ?? []).length, 1);
 
   const existingTopLevel = join(dir, "opencode-existing-top");
   mkdirSync(existingTopLevel);
@@ -199,41 +199,41 @@ try {
   const existingConfig = JSON.parse(readFileSync(join(existingTopLevel, "opencode.json"), "utf8")) as { readonly theme?: string; readonly mcp?: Record<string, { readonly command?: readonly string[] }>; readonly plugin?: readonly unknown[]; readonly instructions?: readonly string[] };
   assert.equal(existingConfig.theme, "x");
   assert.deepEqual(existingConfig.mcp?.other?.command, ["other"]);
-  assert.equal(existingConfig.mcp?.openpets?.command?.[0], "node");
+  assert.equal(existingConfig.mcp?.familiaros?.command?.[0], "node");
   assert.ok(existingConfig.instructions?.includes("README.md"));
-  assert.ok(existingConfig.instructions?.includes(".opencode/openpets.md"));
+  assert.ok(existingConfig.instructions?.includes(".opencode/familiaros.md"));
   assert.ok(existingConfig.plugin?.includes("other-plugin"));
 
   const lowerOwnerProject = join(dir, "opencode-lower-owner");
   mkdirSync(join(lowerOwnerProject, ".opencode"), { recursive: true });
   writeFileSync(join(lowerOwnerProject, "opencode.json"), JSON.stringify({ theme: "top" }, null, 2), "utf8");
-  writeFileSync(join(lowerOwnerProject, ".opencode", "opencode.jsonc"), JSON.stringify({ mcp: { openpets: { type: "local", command: ["npx", "-y", "@open-pets/cli@0.0.1", "mcp", "--pet", "helper"], enabled: true } } }, null, 2), "utf8");
+  writeFileSync(join(lowerOwnerProject, ".opencode", "opencode.jsonc"), JSON.stringify({ mcp: { familiaros: { type: "local", command: ["npx", "-y", "@familiaros/cli@0.0.1", "mcp", "--familiar", "helper"], enabled: true } } }, null, 2), "utf8");
   await configureProject({ agent: "opencode", petId: "fixer", cwd: lowerOwnerProject, yes: true, force: false, localDev: false });
   const lowerTop = readFileSync(join(lowerOwnerProject, "opencode.json"), "utf8");
   const lowerOwned = JSON.parse(readFileSync(join(lowerOwnerProject, ".opencode", "opencode.jsonc"), "utf8")) as { readonly mcp?: Record<string, { readonly command?: readonly string[] }> };
-  assert.equal(lowerTop.includes("@open-pets/cli"), false);
-  assert.deepEqual(lowerOwned.mcp?.openpets?.command, ["npx", "-y", `@open-pets/cli@${packageVersion}`, "mcp", "--pet", "fixer"]);
+  assert.equal(lowerTop.includes("@familiaros/cli"), false);
+  assert.deepEqual(lowerOwned.mcp?.familiaros?.command, ["npx", "-y", `@familiaros/cli@${packageVersion}`, "mcp", "--familiar", "fixer"]);
 
   const customProject = join(dir, "opencode-custom");
   mkdirSync(customProject);
-  writeFileSync(join(customProject, "opencode.json"), JSON.stringify({ mcp: { openpets: { type: "local", command: ["my-openpets-wrapper"] } } }), "utf8");
+  writeFileSync(join(customProject, "opencode.json"), JSON.stringify({ mcp: { familiaros: { type: "local", command: ["my-familiaros-wrapper"] } } }), "utf8");
   await assert.rejects(() => configureProject({ agent: "opencode", petId: "fixer", cwd: customProject, yes: true, force: false, localDev: false }));
-  assert.equal(readFileSync(join(customProject, "opencode.json"), "utf8").includes("@open-pets/cli"), false);
+  assert.equal(readFileSync(join(customProject, "opencode.json"), "utf8").includes("@familiaros/cli"), false);
 
   const instructionProject = join(dir, "opencode-instruction");
   mkdirSync(join(instructionProject, ".opencode"), { recursive: true });
-  writeFileSync(join(instructionProject, ".opencode", "openpets.md"), "User text\n", "utf8");
+  writeFileSync(join(instructionProject, ".opencode", "familiaros.md"), "User text\n", "utf8");
   await configureProject({ agent: "opencode", petId: "fixer", cwd: instructionProject, yes: true, force: false, localDev: false });
-  const instructionText = readFileSync(join(instructionProject, ".opencode", "openpets.md"), "utf8");
+  const instructionText = readFileSync(join(instructionProject, ".opencode", "familiaros.md"), "utf8");
   assert.match(instructionText, /User text/);
-  assert.match(instructionText, /OPENPETS:START/);
+  assert.match(instructionText, /FAMILIAROS:START/);
 
   const symlinkOpenCodeProject = join(dir, "opencode-symlink");
   const outsideOpenCode = join(dir, "outside-opencode");
   mkdirSync(symlinkOpenCodeProject);
   mkdirSync(outsideOpenCode);
   writeFileSync(join(outsideOpenCode, "opencode.jsonc"), "{}\n", "utf8");
-  writeFileSync(join(outsideOpenCode, "openpets.md"), "outside\n", "utf8");
+  writeFileSync(join(outsideOpenCode, "familiaros.md"), "outside\n", "utf8");
   symlinkSync(outsideOpenCode, join(symlinkOpenCodeProject, ".opencode"));
   await assert.rejects(() => configureProject({ agent: "opencode", petId: "fixer", cwd: symlinkOpenCodeProject, yes: true, force: false, localDev: false }));
 
@@ -242,9 +242,9 @@ try {
   await configureProject({ agent: "cursor", petId: "fixer", cwd: cursorProject, yes: true, force: false, localDev: false });
   const cursorConfigPath = join(cursorProject, ".cursor", "mcp.json");
   const cursorConfig = JSON.parse(readFileSync(cursorConfigPath, "utf8")) as { readonly mcpServers?: Record<string, { readonly command?: string; readonly args?: readonly string[] }> };
-  assert.equal(cursorConfig.mcpServers?.openpets?.command, "npx");
-  assert.deepEqual(cursorConfig.mcpServers?.openpets?.args, ["-y", `@open-pets/mcp@${packageVersion}`, "--pet", "fixer"]);
-  assert.equal(readFileSync(cursorConfigPath, "utf8").includes("@open-pets/cli"), false);
+  assert.equal(cursorConfig.mcpServers?.familiaros?.command, "npx");
+  assert.deepEqual(cursorConfig.mcpServers?.familiaros?.args, ["-y", `@familiaros/mcp@${packageVersion}`, "--familiar", "fixer"]);
+  assert.equal(readFileSync(cursorConfigPath, "utf8").includes("@familiaros/cli"), false);
 
   const cursorExistingProject = join(dir, "cursor-existing");
   mkdirSync(join(cursorExistingProject, ".cursor"), { recursive: true });
@@ -262,24 +262,24 @@ try {
   assert.deepEqual(cursorExistingConfig.mcpServers?.other?.args, ["--token=hidden"]);
   assert.deepEqual(cursorExistingConfig.mcpServers?.other?.env, { SECRET: "hidden" });
   assert.equal(cursorExistingConfig.topLevel, "keep");
-  assert.deepEqual(cursorExistingConfig.mcpServers?.openpets?.args, ["-y", `@open-pets/mcp@${packageVersion}`, "--pet", "helper"]);
+  assert.deepEqual(cursorExistingConfig.mcpServers?.familiaros?.args, ["-y", `@familiaros/mcp@${packageVersion}`, "--familiar", "helper"]);
 
   const cursorConflictProject = join(dir, "cursor-conflict");
   mkdirSync(join(cursorConflictProject, ".cursor"), { recursive: true });
-  writeFileSync(join(cursorConflictProject, ".cursor", "mcp.json"), JSON.stringify({ mcpServers: { openpets: { type: "stdio", command: "custom", args: [] }, other: { type: "stdio", command: "other", args: [] } } }, null, 2), "utf8");
+  writeFileSync(join(cursorConflictProject, ".cursor", "mcp.json"), JSON.stringify({ mcpServers: { familiaros: { type: "stdio", command: "custom", args: [] }, other: { type: "stdio", command: "other", args: [] } } }, null, 2), "utf8");
   await assert.rejects(() => configureProject({ agent: "cursor", petId: "fixer", cwd: cursorConflictProject, yes: true, force: false, localDev: false }));
   await configureProject({ agent: "cursor", petId: "fixer", cwd: cursorConflictProject, yes: true, force: true, localDev: false });
   const cursorReplaced = JSON.parse(readFileSync(join(cursorConflictProject, ".cursor", "mcp.json"), "utf8")) as { readonly mcpServers?: Record<string, { readonly command?: string; readonly args?: readonly string[] }> };
   assert.equal(cursorReplaced.mcpServers?.other?.command, "other");
-  assert.deepEqual(cursorReplaced.mcpServers?.openpets?.args, ["-y", `@open-pets/mcp@${packageVersion}`, "--pet", "fixer"]);
+  assert.deepEqual(cursorReplaced.mcpServers?.familiaros?.args, ["-y", `@familiaros/mcp@${packageVersion}`, "--familiar", "fixer"]);
 
   const cursorRulesOnlyProject = join(dir, "cursor-rules-only");
   mkdirSync(cursorRulesOnlyProject);
   await configureProject({ agent: "cursor", cwd: cursorRulesOnlyProject, yes: true, force: false, localDev: false, cursorRulesMode: "only" });
-  const cursorRulesPath = join(cursorRulesOnlyProject, ".cursor", "rules", "openpets.mdc");
+  const cursorRulesPath = join(cursorRulesOnlyProject, ".cursor", "rules", "familiaros.mdc");
   const cursorRulesContent = readFileSync(cursorRulesPath, "utf8");
-  assert.match(cursorRulesContent, /OPENPETS:CURSOR_RULES:START/);
-  assert.match(cursorRulesContent, /openpets_say/);
+  assert.match(cursorRulesContent, /FAMILIAROS:CURSOR_RULES:START/);
+  assert.match(cursorRulesContent, /familiaros_say/);
   assert.doesNotMatch(cursorRulesContent, /alwaysApply:\s*true/);
   assert.equal(existsSync(join(cursorRulesOnlyProject, ".cursor", "mcp.json")), false);
 
@@ -289,10 +289,10 @@ try {
 
   const cursorWithRulesConflictProject = join(dir, "cursor-with-rules-conflict");
   mkdirSync(join(cursorWithRulesConflictProject, ".cursor", "rules"), { recursive: true });
-  writeFileSync(join(cursorWithRulesConflictProject, ".cursor", "rules", "openpets.mdc"), "User rule SECRET=hidden\n", "utf8");
+  writeFileSync(join(cursorWithRulesConflictProject, ".cursor", "rules", "familiaros.mdc"), "User rule SECRET=hidden\n", "utf8");
   await assert.rejects(() => configureProject({ agent: "cursor", petId: "fixer", cwd: cursorWithRulesConflictProject, yes: true, force: false, localDev: false, cursorRulesMode: "with" }));
   assert.equal(existsSync(join(cursorWithRulesConflictProject, ".cursor", "mcp.json")), false);
-  assert.equal(readFileSync(join(cursorWithRulesConflictProject, ".cursor", "rules", "openpets.mdc"), "utf8"), "User rule SECRET=hidden\n");
+  assert.equal(readFileSync(join(cursorWithRulesConflictProject, ".cursor", "rules", "familiaros.mdc"), "utf8"), "User rule SECRET=hidden\n");
 
   let cursorWithRulesOutput = "";
   process.stdout.write = ((chunk: string | Uint8Array): boolean => { cursorWithRulesOutput += String(chunk); return true; }) as typeof process.stdout.write;
@@ -304,21 +304,21 @@ try {
   assert.match(cursorWithRulesOutput, /Rules backup:/);
   assert.equal(cursorWithRulesOutput.includes("hidden"), false);
   const cursorWithRulesConfig = JSON.parse(readFileSync(join(cursorWithRulesConflictProject, ".cursor", "mcp.json"), "utf8")) as { readonly mcpServers?: Record<string, { readonly args?: readonly string[] }> };
-  assert.deepEqual(cursorWithRulesConfig.mcpServers?.openpets?.args, ["-y", `@open-pets/mcp@${packageVersion}`, "--pet", "fixer"]);
-  assert.match(readFileSync(join(cursorWithRulesConflictProject, ".cursor", "rules", "openpets.mdc"), "utf8"), /OPENPETS:CURSOR_RULES:START/);
-  const cursorRulesBackups = readdirSync(join(cursorWithRulesConflictProject, ".cursor", "rules")).filter((name) => name.includes("openpets-backup"));
+  assert.deepEqual(cursorWithRulesConfig.mcpServers?.familiaros?.args, ["-y", `@familiaros/mcp@${packageVersion}`, "--familiar", "fixer"]);
+  assert.match(readFileSync(join(cursorWithRulesConflictProject, ".cursor", "rules", "familiaros.mdc"), "utf8"), /FAMILIAROS:CURSOR_RULES:START/);
+  const cursorRulesBackups = readdirSync(join(cursorWithRulesConflictProject, ".cursor", "rules")).filter((name) => name.includes("familiaros-backup"));
   assert.equal(cursorRulesBackups.length, 1);
   assert.equal(readFileSync(join(cursorWithRulesConflictProject, ".cursor", "rules", cursorRulesBackups[0]!), "utf8"), "User rule SECRET=hidden\n");
 } finally {
   rmSync(dir, { recursive: true, force: true });
 }
 
-const invalidHook = spawnSync(process.execPath, [new URL("./index.js", import.meta.url).pathname, "hook", "--openpets-managed", "--pet", "bad/pet"], { input: JSON.stringify({ hook_event_name: "Notification" }), encoding: "utf8" });
+const invalidHook = spawnSync(process.execPath, [new URL("./index.js", import.meta.url).pathname, "hook", "--familiaros-managed", "--familiar", "bad/familiar"], { input: JSON.stringify({ hook_event_name: "Notification" }), encoding: "utf8" });
 assert.equal(invalidHook.status, 1);
-const missingPetHook = spawnSync(process.execPath, [new URL("./index.js", import.meta.url).pathname, "hook", "--openpets-managed", "--pet"], { input: JSON.stringify({ hook_event_name: "Notification" }), encoding: "utf8" });
+const missingPetHook = spawnSync(process.execPath, [new URL("./index.js", import.meta.url).pathname, "hook", "--familiaros-managed", "--familiar"], { input: JSON.stringify({ hook_event_name: "Notification" }), encoding: "utf8" });
 assert.equal(missingPetHook.status, 1);
 
-for (const args of [["--help"], ["-h"], ["status", "--help"], ["pets", "--help"], ["react", "--help"], ["say", "--help"], ["install", "--help"], ["configure", "--help"], ["configure", "-h"], ["plugin", "--help"], ["plugin", "new", "--help"], ["mcp", "--help"], ["hook", "--help"]]) {
+for (const args of [["--help"], ["-h"], ["status", "--help"], ["familiars", "--help"], ["react", "--help"], ["say", "--help"], ["install", "--help"], ["configure", "--help"], ["configure", "-h"], ["plugin", "--help"], ["plugin", "new", "--help"], ["mcp", "--help"], ["hook", "--help"]]) {
   const help = spawnSync(process.execPath, [new URL("./index.js", import.meta.url).pathname, ...args], { encoding: "utf8" });
   assert.equal(help.status, 0);
   assert.match(help.stdout, /Usage:/);
diff --git a/packages/cli/src/codemap.md b/packages/cli/src/codemap.md
index 4a8a39c8..9464e6c4 100644
--- a/packages/cli/src/codemap.md
+++ b/packages/cli/src/codemap.md
@@ -1,6 +1,6 @@
 # packages/cli/src/
 
-TypeScript source files for the OpenPets CLI.
+TypeScript source files for the FamiliarOS CLI.
 
 ## Files
 
@@ -9,13 +9,13 @@ TypeScript source files for the OpenPets CLI.
 Main CLI entry point (625 lines). Command routing, argument parsing, project configuration, and all CLI operations.
 
 **Commands:**
-- `install <pet-id>` - Install pet via running desktop app
+- `install <familiar-id>` - Install familiar via running desktop app
 - `configure` - Interactive project setup for Claude, OpenCode, or Cursor
-- `status` - Check OpenPets desktop app connectivity
-- `pets` - List installed pets
+- `status` - Check FamiliarOS desktop app connectivity
+- `familiars` - List installed familiars
 - `react <reaction>` - Send reaction to desktop app
-- `say <message> [--reaction <reaction>]` - Display message on pet
-- `mcp [--pet <id>]` - Spawn MCP server wrapper
+- `say <message> [--reaction <reaction>]` - Display message on familiar
+- `mcp [--familiar <id>]` - Spawn MCP server wrapper
 - `hook` - Execute Claude hook from stdin
 
 **Configuration Flow:**
@@ -45,7 +45,7 @@ Contract validation and integration tests (281 lines). Runtime assertions for CL
 **Test Coverage:**
 - Argument parsing validation for all commands
 - Command builder output verification
-- Pet resolution (explicit vs interactive)
+- Familiar resolution (explicit vs interactive)
 - Project hook installation and updates
 - Claude MCP integration (mocked)
 - OpenCode project configuration scenarios
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 8ee75784..7fa0bd76 100644
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -7,15 +7,15 @@ import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { fileURLToPath } from "node:url";
 
-import { allowedReactions, createOpenPetsClient, OpenPetsClientError, type OpenPetsPetListItem, type OpenPetsReaction } from "@open-pets/client";
-import { claudeHookEvents, openPetsHookMarker, removeOpenPetsHooks, runClaudeHookFromStdin, validateOpenPetsPetArg } from "@open-pets/claude";
-import { buildCursorRulesPreview, buildOpenPetsOnlyPreview, classifyCursorMcpStatus, classifyCursorRulesStatus, executeCursorMcpWrite, executeCursorRulesWrite, getCursorProjectMcpPath, getCursorProjectRulesPath, planCursorMcpInstall, planCursorMcpReplace, planCursorRulesInstall, planCursorRulesRemove, planCursorRulesReplace, readCursorMcpConfig, readCursorOpenPetsRules } from "@open-pets/cursor";
-import { prepareOpenCodeProjectSetup, writePreparedOpenCodeProjectSetup } from "@open-pets/opencode";
+import { allowedReactions, createFamiliarOSClient, FamiliarOSClientError, type FamiliarOSPetListItem, type FamiliarOSReaction } from "@familiaros/client";
+import { claudeHookEvents, openPetsHookMarker, removeFamiliarOSHooks, runClaudeHookFromStdin, validateFamiliarOSPetArg } from "@familiaros/claude";
+import { buildCursorRulesPreview, buildFamiliarOSOnlyPreview, classifyCursorMcpStatus, classifyCursorRulesStatus, executeCursorMcpWrite, executeCursorRulesWrite, getCursorProjectMcpPath, getCursorProjectRulesPath, planCursorMcpInstall, planCursorMcpReplace, planCursorRulesInstall, planCursorRulesRemove, planCursorRulesReplace, readCursorMcpConfig, readCursorFamiliarOSRules } from "@familiaros/cursor";
+import { prepareOpenCodeProjectSetup, writePreparedOpenCodeProjectSetup } from "@familiaros/opencode";
 
 import { pluginTemplateNames, pluginTemplates, type PluginTemplateName } from "./plugin-templates.js";
 import { validatePluginFolder } from "./plugin-validate.js";
 
-export const cliPackageName = "@open-pets/cli";
+export const cliPackageName = "@familiaros/cli";
 
 interface ConfigureOptions {
   readonly agent: "claude" | "opencode" | "cursor";
@@ -32,12 +32,12 @@ interface InstallOptions {
 }
 
 interface ReactOptions {
-  readonly reaction: OpenPetsReaction;
+  readonly reaction: FamiliarOSReaction;
 }
 
 interface SayOptions {
   readonly message: string;
-  readonly reaction?: OpenPetsReaction;
+  readonly reaction?: FamiliarOSReaction;
 }
 
 interface CommandSpec {
@@ -95,7 +95,7 @@ async function main(): Promise<void> {
     await showStatus(args);
     return;
   }
-  if (command === "pets") {
+  if (command === "familiars") {
     if (hasHelp(args)) {
       printPetsUsage();
       return;
@@ -132,7 +132,7 @@ async function main(): Promise<void> {
       printHookUsage();
       return;
     }
-    const code = await runClaudeHookFromStdin(process.stdin, { configuredPetId: readPetArg(args), projectLocal: hasProjectLocalArg(args), debug: process.env.OPENPETS_DEBUG === "1" });
+    const code = await runClaudeHookFromStdin(process.stdin, { configuredPetId: readPetArg(args), projectLocal: hasProjectLocalArg(args), debug: process.env.FAMILIAROS_DEBUG === "1" });
     process.exitCode = code;
     return;
   }
@@ -172,35 +172,35 @@ async function main(): Promise<void> {
 }
 
 async function installPetFromCatalog(options: InstallOptions): Promise<void> {
-  const client = createOpenPetsClient({ responseTimeoutMs: 60_000 });
+  const client = createFamiliarOSClient({ responseTimeoutMs: 60_000 });
   const result = await client.installPet(options.petId);
-  process.stdout.write(`Installed OpenPets pet: ${sanitizeTerminalText(result.displayName)} (${result.petId})\n`);
+  process.stdout.write(`Installed FamiliarOS familiar: ${sanitizeTerminalText(result.displayName)} (${result.petId})\n`);
 }
 
 async function showStatus(args: readonly string[]): Promise<void> {
   if (args.length !== 0) throw new CliError(`Unknown status option: ${args[0]}`);
-  const result = await createOpenPetsClient().status();
+  const result = await createFamiliarOSClient().status();
   process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
   if (!result.ok || !result.appRunning) process.exitCode = 1;
 }
 
 async function showPets(args: readonly string[]): Promise<void> {
-  if (args.length !== 0) throw new CliError(`Unknown pets option: ${args[0]}`);
-  const result = await createOpenPetsClient().listPets();
-  for (const pet of result.pets) {
-    const flags = [pet.id === result.defaultPetId ? "default" : undefined, pet.broken ? "broken" : undefined].filter(Boolean).join(", ");
-    process.stdout.write(`${sanitizeTerminalText(pet.displayName)} (${pet.id})${flags ? ` [${flags}]` : ""}\n`);
+  if (args.length !== 0) throw new CliError(`Unknown familiars option: ${args[0]}`);
+  const result = await createFamiliarOSClient().listPets();
+  for (const familiar of result.familiars) {
+    const flags = [familiar.id === result.defaultPetId ? "default" : undefined, familiar.broken ? "broken" : undefined].filter(Boolean).join(", ");
+    process.stdout.write(`${sanitizeTerminalText(familiar.displayName)} (${familiar.id})${flags ? ` [${flags}]` : ""}\n`);
   }
 }
 
 async function sendReaction(options: ReactOptions): Promise<void> {
-  await createOpenPetsClient().react(options.reaction);
-  process.stdout.write(`OpenPets reaction sent: ${options.reaction}\n`);
+  await createFamiliarOSClient().react(options.reaction);
+  process.stdout.write(`FamiliarOS reaction sent: ${options.reaction}\n`);
 }
 
 async function sendMessage(options: SayOptions): Promise<void> {
-  await createOpenPetsClient().say(options.message, options.reaction ? { reaction: options.reaction } : undefined);
-  process.stdout.write("OpenPets message sent.\n");
+  await createFamiliarOSClient().say(options.message, options.reaction ? { reaction: options.reaction } : undefined);
+  process.stdout.write("FamiliarOS message sent.\n");
 }
 
 export async function configureProject(options: ConfigureOptions): Promise<void> {
@@ -215,17 +215,17 @@ export async function configureProject(options: ConfigureOptions): Promise<void>
   }
   assertClaudeAvailable();
   assertSafeProjectHookPath(projectDir);
-  const client = createOpenPetsClient();
+  const client = createFamiliarOSClient();
   const selectedPet = await resolveConfiguredPet(client, options.petId);
   const petId = selectedPet.id;
   const packageVersion = getPackageVersion();
-  const mcpCommand = options.localDev ? createLocalDevCliCommand(["mcp", "--pet", petId]) : createVersionPinnedCliCommand(packageVersion, ["mcp", "--pet", petId]);
-  const hookCommand = formatShellCommand(options.localDev ? createLocalDevCliCommand(["hook", openPetsHookMarker, "--project-local", "--pet", petId]) : createVersionPinnedCliCommand(packageVersion, ["hook", openPetsHookMarker, "--project-local", "--pet", petId]));
+  const mcpCommand = options.localDev ? createLocalDevCliCommand(["mcp", "--familiar", petId]) : createVersionPinnedCliCommand(packageVersion, ["mcp", "--familiar", petId]);
+  const hookCommand = formatShellCommand(options.localDev ? createLocalDevCliCommand(["hook", openPetsHookMarker, "--project-local", "--familiar", petId]) : createVersionPinnedCliCommand(packageVersion, ["hook", openPetsHookMarker, "--project-local", "--familiar", petId]));
   const mcpConfig = { type: "stdio", command: mcpCommand.command, args: mcpCommand.args, env: {} };
   const preparedHooks = prepareProjectLocalHooks(projectDir, hookCommand);
   runClaudeMcpAddJson(projectDir, mcpConfig, options.force);
   writePreparedHooks(preparedHooks);
-  process.stdout.write(`OpenPets configured for Claude in ${projectDir}.\nPet: ${sanitizeTerminalText(selectedPet.displayName)} (${selectedPet.id})\n`);
+  process.stdout.write(`FamiliarOS configured for Claude in ${projectDir}.\nPet: ${sanitizeTerminalText(selectedPet.displayName)} (${selectedPet.id})\n`);
 }
 
 async function configureCursorProject(options: ConfigureOptions, projectDir: string): Promise<void> {
@@ -242,36 +242,36 @@ async function configureCursorProject(options: ConfigureOptions, projectDir: str
     return;
   }
 
-  const client = createOpenPetsClient();
+  const client = createFamiliarOSClient();
   const selectedPet = await resolveConfiguredPet(client, options.petId);
   const packageVersion = getPackageVersion();
-  const previewOptions = { mcpVersion: packageVersion, petId: selectedPet.id, commandMode: options.localDev ? "local" as const : "published" as const, mcpEntryPath: options.localDev ? require.resolve("@open-pets/mcp") : undefined };
+  const previewOptions = { mcpVersion: packageVersion, petId: selectedPet.id, commandMode: options.localDev ? "local" as const : "published" as const, mcpEntryPath: options.localDev ? require.resolve("@familiaros/mcp") : undefined };
   const readResult = readCursorMcpConfig(configPath);
   const status = classifyCursorMcpStatus(readResult, configPath, previewOptions);
-  process.stdout.write(`Cursor config: ${configPath}\nStatus: ${status.status} - ${status.message}\nOpenPets MCP preview:\n${JSON.stringify(buildOpenPetsOnlyPreview(previewOptions), null, 2)}\n`);
+  process.stdout.write(`Cursor config: ${configPath}\nStatus: ${status.status} - ${status.message}\nFamiliarOS MCP preview:\n${JSON.stringify(buildFamiliarOSOnlyPreview(previewOptions), null, 2)}\n`);
 
   const rulesRequested = options.cursorRulesMode === "with";
-  const rulesReadResult = rulesRequested ? readCursorOpenPetsRules(projectDir) : undefined;
+  const rulesReadResult = rulesRequested ? readCursorFamiliarOSRules(projectDir) : undefined;
   const rulesStatus = rulesReadResult ? classifyCursorRulesStatus(rulesReadResult, rulesPath) : undefined;
   if (rulesStatus) {
-    process.stdout.write(`Cursor rules: ${rulesPath}\nRules status: ${rulesStatus.status} - ${rulesStatus.message}\nOpenPets rules preview:\n${buildCursorRulesPreview()}\n`);
+    process.stdout.write(`Cursor rules: ${rulesPath}\nRules status: ${rulesStatus.status} - ${rulesStatus.message}\nFamiliarOS rules preview:\n${buildCursorRulesPreview()}\n`);
   }
 
   if (status.status === "installed" && (!rulesRequested || rulesStatus?.status === "installed")) {
-    process.stdout.write(`OpenPets is already configured for Cursor in ${projectDir}.\nRestart or reload Cursor or start a new chat in this project to load OpenPets.\n`);
+    process.stdout.write(`FamiliarOS is already configured for Cursor in ${projectDir}.\nRestart or reload Cursor or start a new chat in this project to load FamiliarOS.\n`);
     return;
   }
   if (status.status === "invalid" || status.status === "error") {
     throw new CliError(`${status.message} Fix ${configPath}, then rerun setup.`);
   }
   if (status.status === "conflict" && !options.force) {
-    throw new CliError(`Cursor already has a non-OpenPets openpets MCP entry. Rerun with --force to replace only mcpServers.openpets.`);
+    throw new CliError(`Cursor already has a non-FamiliarOS familiaros MCP entry. Rerun with --force to replace only mcpServers.familiaros.`);
   }
   if (rulesStatus && (rulesStatus.status === "invalid" || rulesStatus.status === "error")) {
     throw new CliError(`${rulesStatus.message} Fix ${rulesPath}, then rerun setup.`);
   }
   if (rulesStatus?.status === "conflict" && !options.force) {
-    throw new CliError("Cursor already has .cursor/rules/openpets.mdc with user content. Rerun with --force to replace only that file.");
+    throw new CliError("Cursor already has .cursor/rules/familiaros.mdc with user content. Rerun with --force to replace only that file.");
   }
 
   const plan = status.status === "installed" ? undefined : status.status === "conflict" ? planCursorMcpReplace(configPath, previewOptions) : planCursorMcpInstall(configPath, previewOptions, options.force);
@@ -283,60 +283,60 @@ async function configureCursorProject(options: ConfigureOptions, projectDir: str
   if (rulesPlan) executeCursorRulesWrite(rulesPlan);
 
   const backups = [plan?.backupPath ? `MCP backup: ${plan.backupPath}` : undefined, rulesPlan?.backupPath ? `Rules backup: ${rulesPlan.backupPath}` : undefined].filter(Boolean).join("\n");
-  process.stdout.write(`OpenPets configured for Cursor in ${projectDir}.\nPet: ${sanitizeTerminalText(selectedPet.displayName)} (${selectedPet.id})\n${backups ? `${backups}\n` : ""}Restart or reload Cursor or start a new chat in this project to load OpenPets.\nTo remove MCP, delete mcpServers.openpets from ${configPath}. To remove rules, run with --remove-rules.\n`);
+  process.stdout.write(`FamiliarOS configured for Cursor in ${projectDir}.\nPet: ${sanitizeTerminalText(selectedPet.displayName)} (${selectedPet.id})\n${backups ? `${backups}\n` : ""}Restart or reload Cursor or start a new chat in this project to load FamiliarOS.\nTo remove MCP, delete mcpServers.familiaros from ${configPath}. To remove rules, run with --remove-rules.\n`);
 }
 
 function configureCursorRulesOnly(projectDir: string, rulesPath: string, force: boolean): void {
-  const readResult = readCursorOpenPetsRules(projectDir);
+  const readResult = readCursorFamiliarOSRules(projectDir);
   const status = classifyCursorRulesStatus(readResult, rulesPath);
-  process.stdout.write(`Cursor rules: ${rulesPath}\nRules status: ${status.status} - ${status.message}\nOpenPets rules preview:\n${buildCursorRulesPreview()}\n`);
+  process.stdout.write(`Cursor rules: ${rulesPath}\nRules status: ${status.status} - ${status.message}\nFamiliarOS rules preview:\n${buildCursorRulesPreview()}\n`);
   if (status.status === "installed") {
-    process.stdout.write("OpenPets Cursor rules are already installed. Cursor may use changed rules in a new or refreshed chat.\n");
+    process.stdout.write("FamiliarOS Cursor rules are already installed. Cursor may use changed rules in a new or refreshed chat.\n");
     return;
   }
   if (status.status === "invalid" || status.status === "error") throw new CliError(`${status.message} Fix ${rulesPath}, then rerun setup.`);
-  if (status.status === "conflict" && !force) throw new CliError("Cursor already has .cursor/rules/openpets.mdc with user content. Rerun with --force to replace only that file.");
+  if (status.status === "conflict" && !force) throw new CliError("Cursor already has .cursor/rules/familiaros.mdc with user content. Rerun with --force to replace only that file.");
   const plan = status.status === "conflict" ? planCursorRulesReplace(projectDir) : planCursorRulesInstall(projectDir, force);
   if ("ok" in plan) throw new CliError(plan.message);
   executeCursorRulesWrite(plan);
-  process.stdout.write(`Installed OpenPets Cursor rules in ${projectDir}.\nRules file: ${rulesPath}\n${plan.backupPath ? `Backup: ${plan.backupPath}\n` : ""}Cursor may use changed rules in a new or refreshed chat.\n`);
+  process.stdout.write(`Installed FamiliarOS Cursor rules in ${projectDir}.\nRules file: ${rulesPath}\n${plan.backupPath ? `Backup: ${plan.backupPath}\n` : ""}Cursor may use changed rules in a new or refreshed chat.\n`);
 }
 
 function removeCursorRulesOnly(projectDir: string, rulesPath: string): void {
-  const readResult = readCursorOpenPetsRules(projectDir);
+  const readResult = readCursorFamiliarOSRules(projectDir);
   const status = classifyCursorRulesStatus(readResult, rulesPath);
   process.stdout.write(`Cursor rules: ${rulesPath}\nRules status: ${status.status} - ${status.message}\n`);
   if (status.status === "missing") {
-    process.stdout.write("OpenPets Cursor rules are already absent.\n");
+    process.stdout.write("FamiliarOS Cursor rules are already absent.\n");
     return;
   }
   if (status.status === "invalid" || status.status === "error") throw new CliError(`${status.message} Fix ${rulesPath}, then rerun setup.`);
-  if (status.status === "conflict") throw new CliError("Cannot remove .cursor/rules/openpets.mdc because it is not managed by OpenPets.");
+  if (status.status === "conflict") throw new CliError("Cannot remove .cursor/rules/familiaros.mdc because it is not managed by FamiliarOS.");
   const plan = planCursorRulesRemove(projectDir);
   if ("ok" in plan) throw new CliError(plan.message);
   executeCursorRulesWrite(plan);
-  process.stdout.write(`Removed OpenPets Cursor rules from ${projectDir}.\n${plan.backupPath ? `Backup: ${plan.backupPath}\n` : ""}Cursor may use changed rules in a new or refreshed chat.\n`);
+  process.stdout.write(`Removed FamiliarOS Cursor rules from ${projectDir}.\n${plan.backupPath ? `Backup: ${plan.backupPath}\n` : ""}Cursor may use changed rules in a new or refreshed chat.\n`);
 }
 
 async function configureOpenCodeProject(options: ConfigureOptions, projectDir: string): Promise<void> {
-  const client = createOpenPetsClient();
+  const client = createFamiliarOSClient();
   const selectedPet = await resolveConfiguredPet(client, options.petId);
   const packageVersion = getPackageVersion();
   const prepared = prepareOpenCodeProjectSetup({ projectDir, petId: selectedPet.id, cliVersion: packageVersion, commandMode: options.localDev ? "local" : "published", cliEntryPath: options.localDev ? fileURLToPath(import.meta.url) : undefined });
   writePreparedOpenCodeProjectSetup(prepared);
-  process.stdout.write(`OpenPets configured for OpenCode in ${projectDir}.\nPet: ${sanitizeTerminalText(selectedPet.displayName)} (${selectedPet.id})\nConfig: ${prepared.configPath}\nInstructions: ${prepared.instructionPath}\nWarning: .opencode config/instructions can be committed and include the selected pet id.\nRestart OpenCode in this project to load OpenPets.\n`);
+  process.stdout.write(`FamiliarOS configured for OpenCode in ${projectDir}.\nPet: ${sanitizeTerminalText(selectedPet.displayName)} (${selectedPet.id})\nConfig: ${prepared.configPath}\nInstructions: ${prepared.instructionPath}\nWarning: .opencode config/instructions can be committed and include the selected familiar id.\nRestart OpenCode in this project to load FamiliarOS.\n`);
 }
 
-export async function resolveConfiguredPet(client: Pick<ReturnType<typeof createOpenPetsClient>, "listPets">, petId?: string): Promise<ConfiguredPet> {
+export async function resolveConfiguredPet(client: Pick<ReturnType<typeof createFamiliarOSClient>, "listPets">, petId?: string): Promise<ConfiguredPet> {
   if (petId) {
-    const id = validateOpenPetsPetArg(petId);
+    const id = validateFamiliarOSPetArg(petId);
     return { id, displayName: id };
   }
 
   const petList = await getInstalledPets(client);
-  const id = validateOpenPetsPetArg(await pickPet(petList.pets));
-  const selectedPet = petList.pets.find((pet) => pet.id === id);
-  if (!selectedPet || selectedPet.broken) throw new CliError(`Pet is not installed or usable: ${id}`);
+  const id = validateFamiliarOSPetArg(await pickPet(petList.familiars));
+  const selectedPet = petList.familiars.find((familiar) => familiar.id === id);
+  if (!selectedPet || selectedPet.broken) throw new CliError(`Familiar is not installed or usable: ${id}`);
   return { id: selectedPet.id, displayName: selectedPet.displayName };
 }
 
@@ -358,8 +358,8 @@ export function parseConfigureArgs(args: readonly string[]): ConfigureOptions {
     else if (arg === "--remove-rules") cursorRulesMode = setCursorRulesMode(cursorRulesMode, "remove");
     else if (arg === "--agent") { agent = readRequiredArg(args, index, "--agent"); index += 1; }
     else if (arg.startsWith("--agent=")) agent = arg.slice("--agent=".length);
-    else if (arg === "--pet") { petId = validateOpenPetsPetArg(readRequiredArg(args, index, "--pet")); index += 1; }
-    else if (arg.startsWith("--pet=")) petId = validateOpenPetsPetArg(arg.slice("--pet=".length));
+    else if (arg === "--familiar") { petId = validateFamiliarOSPetArg(readRequiredArg(args, index, "--familiar")); index += 1; }
+    else if (arg.startsWith("--familiar=")) petId = validateFamiliarOSPetArg(arg.slice("--familiar=".length));
     else if (arg === "--cwd") { cwd = readRequiredArg(args, index, "--cwd"); index += 1; }
     else if (arg.startsWith("--cwd=")) cwd = arg.slice("--cwd=".length);
     else throw new CliError(`Unknown configure option: ${arg}`);
@@ -375,8 +375,8 @@ function setCursorRulesMode(current: ConfigureOptions["cursorRulesMode"], next:
 }
 
 export function parseInstallArgs(args: readonly string[]): InstallOptions {
-  if (args.length !== 1) throw new CliError("Usage: openpets install <pet-id>");
-  return { petId: validateOpenPetsPetArg(args[0] ?? "") };
+  if (args.length !== 1) throw new CliError("Usage: familiaros install <familiar-id>");
+  return { petId: validateFamiliarOSPetArg(args[0] ?? "") };
 }
 
 export function parsePluginNewArgs(args: readonly string[]): PluginNewOptions {
@@ -400,7 +400,7 @@ export function parsePluginNewArgs(args: readonly string[]): PluginNewOptions {
     else throw new CliError(`Unexpected argument: ${arg}`);
   }
   const cleanName = (name ?? "").trim();
-  if (!cleanName) throw new CliError("Usage: openpets plugin new <name> [--template <template>] [--id <id>] [--dir <path>] [--author <name>]");
+  if (!cleanName) throw new CliError("Usage: familiaros plugin new <name> [--template <template>] [--id <id>] [--dir <path>] [--author <name>]");
   if (cleanName.length > 60 || /[\x00-\x1F\x7F]/.test(cleanName)) throw new CliError("Plugin name must be 1-60 printable characters.");
   const slug = slugifyPluginName(cleanName);
   if (!slug) throw new CliError("Plugin name must contain at least one letter or number.");
@@ -421,7 +421,7 @@ function isValidPluginId(id: string): boolean {
 
 export function scaffoldPlugin(options: PluginNewOptions): { readonly dir: string; readonly manifestPath: string; readonly entryPath: string } {
   const targetDir = resolve(options.dir);
-  const manifestPath = join(targetDir, "openpets.plugin.json");
+  const manifestPath = join(targetDir, "familiaros.plugin.json");
   const entryPath = join(targetDir, "index.js");
   if (existsSync(manifestPath) || existsSync(entryPath)) throw new CliError(`A plugin already exists at ${targetDir}. Choose another --dir.`);
   mkdirSync(targetDir, { recursive: true });
@@ -430,7 +430,7 @@ export function scaffoldPlugin(options: PluginNewOptions): { readonly dir: strin
 
   const template = pluginTemplates[options.template];
   const manifest = {
-    $schema: "https://openpets.dev/schemas/openpets.plugin.schema.json",
+    $schema: "https://familiaros.dev/schemas/familiaros.plugin.schema.json",
     manifestVersion: 3,
     id: options.id,
     name: options.name,
@@ -456,21 +456,21 @@ export function scaffoldPlugin(options: PluginNewOptions): { readonly dir: strin
   }
   const packageJsonPath = join(targetDir, "package.json");
   if (!existsSync(packageJsonPath)) {
-    writeFileSync(packageJsonPath, `${JSON.stringify({ name: slugifyPluginName(options.name) || "openpets-plugin", private: true, type: "module", scripts: { test: "node test.js" }, devDependencies: { "@open-pets/plugin-sdk": "^3.0.0" } }, null, 2)}\n`, { encoding: "utf8" });
+    writeFileSync(packageJsonPath, `${JSON.stringify({ name: slugifyPluginName(options.name) || "familiaros-plugin", private: true, type: "module", scripts: { test: "node test.js" }, devDependencies: { "@familiaros/plugin-sdk": "^3.0.0" } }, null, 2)}\n`, { encoding: "utf8" });
   }
   const readmePath = join(targetDir, "README.md");
   if (!existsSync(readmePath)) writeFileSync(readmePath, pluginReadmeTemplate(options, targetDir), { encoding: "utf8" });
 
   process.stdout.write(
-    `Created OpenPets plugin "${sanitizeTerminalText(options.name)}" (${options.id}) from the ${options.template} template\n  ${targetDir}\n\n` +
+    `Created FamiliarOS plugin "${sanitizeTerminalText(options.name)}" (${options.id}) from the ${options.template} template\n  ${targetDir}\n\n` +
       "Next steps:\n" +
-      "  1. npm install              # pulls @open-pets/plugin-sdk for types + the test kit\n" +
+      "  1. npm install              # pulls @familiaros/plugin-sdk for types + the test kit\n" +
       "  2. npm test                 # deterministic harness, no app needed\n" +
-      "  3. From the OpenPets repo root, run it live with hot reload:\n" +
-      `     OPENPETS_DEV_PLUGIN_PATHS=${targetDir} pnpm dev:desktop\n` +
-      "  4. Open Tray → Plugins, enable it, then right-click your pet.\n\n" +
-      `Validate anytime: openpets plugin validate ${targetDir}\n` +
-      "Docs: https://openpets.dev/sdk\n",
+      "  3. From the FamiliarOS repo root, run it live with hot reload:\n" +
+      `     FAMILIAROS_DEV_PLUGIN_PATHS=${targetDir} pnpm dev:desktop\n` +
+      "  4. Open Tray → Plugins, enable it, then right-click your familiar.\n\n" +
+      `Validate anytime: familiaros plugin validate ${targetDir}\n` +
+      "Docs: https://familiaros.dev/sdk\n",
   );
   return { dir: targetDir, manifestPath, entryPath };
 }
@@ -478,35 +478,35 @@ export function scaffoldPlugin(options: PluginNewOptions): { readonly dir: strin
 function pluginReadmeTemplate(options: PluginNewOptions, targetDir: string): string {
   return `# ${options.name}
 
-An OpenPets plugin (\`${options.id}\`).
+An FamiliarOS plugin (\`${options.id}\`).
 
 ## Develop
 
 \`\`\`bash
 # optional: editor autocomplete + type-checking
-npm i -D @open-pets/plugin-sdk
+npm i -D @familiaros/plugin-sdk
 
-# from the OpenPets repo root, load this folder and launch the app
-OPENPETS_DEV_PLUGIN_PATHS=${targetDir} pnpm dev:desktop
+# from the FamiliarOS repo root, load this folder and launch the app
+FAMILIAROS_DEV_PLUGIN_PATHS=${targetDir} pnpm dev:desktop
 \`\`\`
 
-Then open **Tray → Plugins**, enable the plugin, and right-click your pet to
+Then open **Tray → Plugins**, enable the plugin, and right-click your familiar to
 run its commands.
 
 ## Learn more
 
-- SDK guide: https://openpets.dev/sdk
-- Reference: https://openpets.dev/docs/plugin-sdk
+- SDK guide: https://familiaros.dev/sdk
+- Reference: https://familiaros.dev/docs/plugin-sdk
 `;
 }
 
 export function parseReactArgs(args: readonly string[]): ReactOptions {
-  if (args.length !== 1) throw new CliError("Usage: openpets react <reaction>");
+  if (args.length !== 1) throw new CliError("Usage: familiaros react <reaction>");
   return { reaction: parseReaction(args[0] ?? "") };
 }
 
 export function parseSayArgs(args: readonly string[]): SayOptions {
-  let reaction: OpenPetsReaction | undefined;
+  let reaction: FamiliarOSReaction | undefined;
   const messageParts: string[] = [];
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
@@ -522,15 +522,15 @@ export function parseSayArgs(args: readonly string[]): SayOptions {
     }
   }
   const message = messageParts.join(" ").trim();
-  if (!message) throw new CliError("Usage: openpets say <message> [--reaction <reaction>]");
+  if (!message) throw new CliError("Usage: familiaros say <message> [--reaction <reaction>]");
   return { message, reaction };
 }
 
-function parseReaction(value: string): OpenPetsReaction {
-  if (!allowedReactions.includes(value as OpenPetsReaction)) {
-    throw new CliError(`Invalid OpenPets reaction: ${value}. Allowed reactions: ${allowedReactions.join(", ")}.`);
+function parseReaction(value: string): FamiliarOSReaction {
+  if (!allowedReactions.includes(value as FamiliarOSReaction)) {
+    throw new CliError(`Invalid FamiliarOS reaction: ${value}. Allowed reactions: ${allowedReactions.join(", ")}.`);
   }
-  return value as OpenPetsReaction;
+  return value as FamiliarOSReaction;
 }
 
 export function createVersionPinnedCliCommand(version: string, args: readonly string[]): CommandSpec {
@@ -542,7 +542,7 @@ export function createLocalDevCliCommand(args: readonly string[]): CommandSpec {
 }
 
 export function createClaudeMcpAddJsonArgs(config: unknown): readonly string[] {
-  return ["mcp", "add-json", "openpets", JSON.stringify(config), "--scope", "local"];
+  return ["mcp", "add-json", "familiaros", JSON.stringify(config), "--scope", "local"];
 }
 
 export function installProjectLocalHooks(projectDir: string, hookCommand: string): void {
@@ -553,7 +553,7 @@ export function prepareProjectLocalHooks(projectDir: string, hookCommand: string
   assertSafeProjectHookPath(projectDir);
   const settingsPath = getProjectLocalSettingsPath(realpathSync(projectDir));
   const current = readJsonObject(settingsPath);
-  const cleaned = removeOpenPetsHooks(current);
+  const cleaned = removeFamiliarOSHooks(current);
   const hooks = isRecord(cleaned.hooks) ? { ...cleaned.hooks } : {};
   for (const event of claudeHookEvents) {
     if (hooks[event] !== undefined && !Array.isArray(hooks[event])) throw new CliError(`Claude local settings hooks.${event} must be an array.`);
@@ -579,7 +579,7 @@ export function runClaudeMcpAddJson(projectDir: string, config: unknown, force =
 }
 
 function runClaudeMcpRemove(projectDir: string): void {
-  const result = spawnSync("claude", ["mcp", "remove", "openpets", "--scope", "local"], { cwd: projectDir, encoding: "utf8", shell: false, stdio: ["ignore", "pipe", "pipe"], timeout: 10_000 });
+  const result = spawnSync("claude", ["mcp", "remove", "familiaros", "--scope", "local"], { cwd: projectDir, encoding: "utf8", shell: false, stdio: ["ignore", "pipe", "pipe"], timeout: 10_000 });
   if (result.error) throw new CliError(`Claude Code is unavailable on PATH: ${result.error.message}`);
   const output = `${result.stderr || ""}\n${result.stdout || ""}`;
   if (result.status !== 0 && !/not found|does not exist|no server|unknown/i.test(output)) {
@@ -588,7 +588,7 @@ function runClaudeMcpRemove(projectDir: string): void {
 }
 
 async function runMcp(args: readonly string[]): Promise<void> {
-  const entry = require.resolve("@open-pets/mcp");
+  const entry = require.resolve("@familiaros/mcp");
   await new Promise<void>((resolvePromise, rejectPromise) => {
     const child = spawn(process.execPath, [entry, ...args], { stdio: "inherit" });
     const forwardSigint = (): void => { child.kill("SIGINT"); };
@@ -606,26 +606,26 @@ async function runMcp(args: readonly string[]): Promise<void> {
   });
 }
 
-async function getInstalledPets(client: Pick<ReturnType<typeof createOpenPetsClient>, "listPets">) {
+async function getInstalledPets(client: Pick<ReturnType<typeof createFamiliarOSClient>, "listPets">) {
   try {
     return await client.listPets();
   } catch (error) {
-    if (error instanceof OpenPetsClientError && error.code === "unknown_method") throw new CliError("OpenPets desktop app is too old for project setup. Update/restart OpenPets and try again.");
-    throw new CliError("OpenPets desktop app is not running. Open OpenPets, then run this command again.");
+    if (error instanceof FamiliarOSClientError && error.code === "unknown_method") throw new CliError("FamiliarOS desktop app is too old for project setup. Update/restart FamiliarOS and try again.");
+    throw new CliError("FamiliarOS desktop app is not running. Open FamiliarOS, then run this command again.");
   }
 }
 
-async function pickPet(pets: readonly OpenPetsPetListItem[]): Promise<string> {
-  const usable = pets.filter((pet) => !pet.broken);
-  if (usable.length === 0) throw new CliError("No usable installed pets found. Open OpenPets and install a pet first.");
-  if (!process.stdin.isTTY) throw new CliError("Missing --pet <id>. Non-interactive shells must pass --pet.");
-  process.stdout.write("Pick pet for this project:\n");
-  usable.forEach((pet, index) => process.stdout.write(`  ${index + 1}. ${sanitizeTerminalText(pet.displayName)} (${pet.id})\n`));
+async function pickPet(familiars: readonly FamiliarOSPetListItem[]): Promise<string> {
+  const usable = familiars.filter((familiar) => !familiar.broken);
+  if (usable.length === 0) throw new CliError("No usable installed familiars found. Open FamiliarOS and install a familiar first.");
+  if (!process.stdin.isTTY) throw new CliError("Missing --familiar <id>. Non-interactive shells must pass --familiar.");
+  process.stdout.write("Pick familiar for this project:\n");
+  usable.forEach((familiar, index) => process.stdout.write(`  ${index + 1}. ${sanitizeTerminalText(familiar.displayName)} (${familiar.id})\n`));
   const rl = createInterface({ input, output });
   try {
-    const answer = await rl.question("Pet number: ");
+    const answer = await rl.question("Familiar number: ");
     const index = Number(answer.trim()) - 1;
-    if (!Number.isInteger(index) || !usable[index]) throw new CliError("Invalid pet selection.");
+    if (!Number.isInteger(index) || !usable[index]) throw new CliError("Invalid familiar selection.");
     return usable[index].id;
   } finally {
     rl.close();
@@ -692,12 +692,12 @@ function writeJsonFile(path: string, value: Record<string, unknown>): void {
 }
 
 function readPetArg(args: readonly string[]): string | undefined {
-  const equals = args.find((arg) => arg.startsWith("--pet="));
-  if (equals) return validateOpenPetsPetArg(equals.slice("--pet=".length));
-  const index = args.indexOf("--pet");
+  const equals = args.find((arg) => arg.startsWith("--familiar="));
+  if (equals) return validateFamiliarOSPetArg(equals.slice("--familiar=".length));
+  const index = args.indexOf("--familiar");
   const value = index >= 0 ? args[index + 1] : undefined;
-  if (index >= 0 && (!value || value.startsWith("--"))) throw new CliError("Missing value for --pet.");
-  return value && value.length > 0 ? validateOpenPetsPetArg(value) : undefined;
+  if (index >= 0 && (!value || value.startsWith("--"))) throw new CliError("Missing value for --familiar.");
+  return value && value.length > 0 ? validateFamiliarOSPetArg(value) : undefined;
 }
 
 function hasProjectLocalArg(args: readonly string[]): boolean {
@@ -722,21 +722,21 @@ function shellQuote(value: string): string {
 
 function getPackageVersion(): string {
   const parsed = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")) as unknown;
-  if (!isRecord(parsed) || typeof parsed.version !== "string") throw new CliError("Cannot read OpenPets CLI package version.");
+  if (!isRecord(parsed) || typeof parsed.version !== "string") throw new CliError("Cannot read FamiliarOS CLI package version.");
   return parsed.version;
 }
 
 function printUsage(): void {
-  process.stdout.write("Usage:\n  openpets status\n  openpets pets\n  openpets react <reaction>\n  openpets say <message> [--reaction <reaction>]\n  openpets install <pet-id>\n  openpets configure [--agent claude|opencode|cursor] [--pet <id>] [--cwd <path>] [--yes] [--force] [--with-rules|--rules-only|--remove-rules]\n  openpets plugin new <name> [--id <id>] [--dir <path>] [--author <name>]\n  openpets mcp [--pet <id>]\n  openpets hook --openpets-managed [--pet <id>]\n\nRun `openpets <command> --help` for command options.\n");
+  process.stdout.write("Usage:\n  familiaros status\n  familiaros familiars\n  familiaros react <reaction>\n  familiaros say <message> [--reaction <reaction>]\n  familiaros install <familiar-id>\n  familiaros configure [--agent claude|opencode|cursor] [--familiar <id>] [--cwd <path>] [--yes] [--force] [--with-rules|--rules-only|--remove-rules]\n  familiaros plugin new <name> [--id <id>] [--dir <path>] [--author <name>]\n  familiaros mcp [--familiar <id>]\n  familiaros hook --familiaros-managed [--familiar <id>]\n\nRun `familiaros <command> --help` for command options.\n");
 }
 
 function printPluginUsage(): void {
   process.stdout.write(
     "Usage:\n" +
-      "  openpets plugin new <name> [--template <template>] [--id <id>] [--dir <path>] [--author <name>]\n" +
-      "  openpets plugin validate [dir]\n\n" +
+      "  familiaros plugin new <name> [--template <template>] [--id <id>] [--dir <path>] [--author <name>]\n" +
+      "  familiaros plugin validate [dir]\n\n" +
       "plugin new scaffolds a typed SDK v3 plugin with a manifest, a working entry, and a passing\n" +
-      "test built on @open-pets/plugin-sdk/testing. plugin validate checks the manifest, config\n" +
+      "test built on @familiaros/plugin-sdk/testing. plugin validate checks the manifest, config\n" +
       "schema, declared assets/panels, permissions, and network hosts at author time.\n\n" +
       "Options:\n" +
       `  --template <t>   Template: ${pluginTemplateNames.join(", ")}. Defaults to blank.\n` +
@@ -744,40 +744,40 @@ function printPluginUsage(): void {
       "  --dir <path>     Target directory. Defaults to ./<name-slug>.\n" +
       "  --author <name>  Author name (informational).\n" +
       "  -h, --help       Show this help.\n\n" +
-      "Learn more: https://openpets.dev/sdk\n",
+      "Learn more: https://familiaros.dev/sdk\n",
   );
 }
 
 function printInstallUsage(): void {
-  process.stdout.write("Usage:\n  openpets install <pet-id>\n\nDownloads a gallery pet through the running OpenPets desktop app and installs it locally.\n");
+  process.stdout.write("Usage:\n  familiaros install <familiar-id>\n\nDownloads a gallery familiar through the running FamiliarOS desktop app and installs it locally.\n");
 }
 
 function printStatusUsage(): void {
-  process.stdout.write("Usage:\n  openpets status\n\nChecks whether the OpenPets desktop app is reachable and prints the status response as JSON.\n");
+  process.stdout.write("Usage:\n  familiaros status\n\nChecks whether the FamiliarOS desktop app is reachable and prints the status response as JSON.\n");
 }
 
 function printPetsUsage(): void {
-  process.stdout.write("Usage:\n  openpets pets\n\nLists pets installed in the running OpenPets desktop app.\n");
+  process.stdout.write("Usage:\n  familiaros familiars\n\nLists familiars installed in the running FamiliarOS desktop app.\n");
 }
 
 function printReactUsage(): void {
-  process.stdout.write(`Usage:\n  openpets react <reaction>\n\nSends a reaction to the running OpenPets desktop app.\nAllowed reactions: ${allowedReactions.join(", ")}.\n`);
+  process.stdout.write(`Usage:\n  familiaros react <reaction>\n\nSends a reaction to the running FamiliarOS desktop app.\nAllowed reactions: ${allowedReactions.join(", ")}.\n`);
 }
 
 function printSayUsage(): void {
-  process.stdout.write(`Usage:\n  openpets say <message> [--reaction <reaction>]\n\nShows a short message in the running OpenPets desktop app. Optionally sends a reaction with the message.\nAllowed reactions: ${allowedReactions.join(", ")}.\n`);
+  process.stdout.write(`Usage:\n  familiaros say <message> [--reaction <reaction>]\n\nShows a short message in the running FamiliarOS desktop app. Optionally sends a reaction with the message.\nAllowed reactions: ${allowedReactions.join(", ")}.\n`);
 }
 
 function printConfigureUsage(): void {
-  process.stdout.write("Usage:\n  openpets configure [--agent claude|opencode|cursor] [--pet <id>] [--cwd <path>] [--yes] [--force] [--with-rules|--rules-only|--remove-rules]\n\nOptions:\n  --pet <id>           Pet id to use for this project. If omitted, prompts with installed pets. Cursor --rules-only/--remove-rules do not need a pet.\n  --agent <agent>      Agent to configure: claude, opencode, or cursor. Defaults to claude.\n  --cwd <path>         Project directory to configure. Defaults to current directory. Cursor uses <cwd>/.cursor/mcp.json and <cwd>/.cursor/rules/openpets.mdc; global Cursor setup is not enabled here.\n  --with-rules         For Cursor, install MCP config and project rules after preflighting both writes.\n  --rules-only         For Cursor, install/update only .cursor/rules/openpets.mdc.\n  --remove-rules       For Cursor, remove only managed .cursor/rules/openpets.mdc.\n  --yes, -y            Accepted for scripts; no confirmation prompt is shown.\n  --force              Replace supported managed entries where applicable. Required for conflicting Cursor rules.\n  --replace            Alias for --force.\n  --local-dev          Use local development command paths where supported.\n  -h, --help           Show this help.\n");
+  process.stdout.write("Usage:\n  familiaros configure [--agent claude|opencode|cursor] [--familiar <id>] [--cwd <path>] [--yes] [--force] [--with-rules|--rules-only|--remove-rules]\n\nOptions:\n  --familiar <id>           Familiar id to use for this project. If omitted, prompts with installed familiars. Cursor --rules-only/--remove-rules do not need a familiar.\n  --agent <agent>      Agent to configure: claude, opencode, or cursor. Defaults to claude.\n  --cwd <path>         Project directory to configure. Defaults to current directory. Cursor uses <cwd>/.cursor/mcp.json and <cwd>/.cursor/rules/familiaros.mdc; global Cursor setup is not enabled here.\n  --with-rules         For Cursor, install MCP config and project rules after preflighting both writes.\n  --rules-only         For Cursor, install/update only .cursor/rules/familiaros.mdc.\n  --remove-rules       For Cursor, remove only managed .cursor/rules/familiaros.mdc.\n  --yes, -y            Accepted for scripts; no confirmation prompt is shown.\n  --force              Replace supported managed entries where applicable. Required for conflicting Cursor rules.\n  --replace            Alias for --force.\n  --local-dev          Use local development command paths where supported.\n  -h, --help           Show this help.\n");
 }
 
 function printMcpUsage(): void {
-  process.stdout.write("Usage:\n  openpets mcp [--pet <id>]\n\nStarts the OpenPets MCP server wrapper. This command is written into Claude MCP config by `openpets configure`.\n");
+  process.stdout.write("Usage:\n  familiaros mcp [--familiar <id>]\n\nStarts the FamiliarOS MCP server wrapper. This command is written into Claude MCP config by `familiaros configure`.\n");
 }
 
 function printHookUsage(): void {
-  process.stdout.write("Usage:\n  openpets hook --openpets-managed [--pet <id>]\n\nRuns one Claude hook event from stdin. This command is written into Claude project hooks by `openpets configure`.\n");
+  process.stdout.write("Usage:\n  familiaros hook --familiaros-managed [--familiar <id>]\n\nRuns one Claude hook event from stdin. This command is written into Claude project hooks by `familiaros configure`.\n");
 }
 
 function hasHelp(args: readonly string[]): boolean {
diff --git a/packages/cli/src/plugin-templates.ts b/packages/cli/src/plugin-templates.ts
index 2edc93e1..e4e06aa4 100644
--- a/packages/cli/src/plugin-templates.ts
+++ b/packages/cli/src/plugin-templates.ts
@@ -1,7 +1,7 @@
 /**
- * SDK v3 plugin templates for `openpets plugin new --template <name>` (§18.4).
+ * SDK v3 plugin templates for `familiaros plugin new --template <name>` (§18.4).
  * Each template ships a typed entry, a valid manifestVersion-3 manifest, a
- * passing test built on `@open-pets/plugin-sdk/testing`, and a README.
+ * passing test built on `@familiaros/plugin-sdk/testing`, and a README.
  */
 
 export type PluginTemplateName = "blank" | "reminder" | "ambient" | "ai-chat" | "tamagotchi" | "calendar";
@@ -25,27 +25,27 @@ export type PluginTemplate = {
 };
 
 const sharedTestHeader = `import assert from "node:assert/strict";
-import { createTestHarness } from "@open-pets/plugin-sdk/testing";
+import { createTestHarness } from "@familiaros/plugin-sdk/testing";
 import { register } from "./index.js";
 `;
 
 export const pluginTemplates: Record<PluginTemplateName, PluginTemplate> = {
   blank: {
     description: "A minimal starting point with one command.",
-    permissions: ["pet:speak", "pet:reaction", "commands", "status"],
+    permissions: ["familiar:speak", "familiar:reaction", "commands", "status"],
     configSchema: {},
-    entry: ({ name }) => `/// <reference types="@open-pets/plugin-sdk" />
+    entry: ({ name }) => `/// <reference types="@familiaros/plugin-sdk" />
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await ctx.status.set({ text: ${JSON.stringify(`${name} is ready`)}, tone: "info" });
 
       await ctx.commands.register(
         { id: "say-hello", title: "Say hello", description: "Get a friendly greeting." },
         async () => {
-          await ctx.pet.speak(${JSON.stringify(`Hello from ${name}!`)});
-          await ctx.pet.react("waving");
+          await ctx.familiar.speak(${JSON.stringify(`Hello from ${name}!`)});
+          await ctx.familiar.react("waving");
         },
       );
     },
@@ -55,7 +55,7 @@ export function register(OpenPetsPlugin) {
 }
 `,
     test: () => `${sharedTestHeader}
-const h = createTestHarness(register, { permissions: ["pet:speak", "pet:reaction", "commands", "status"] });
+const h = createTestHarness(register, { permissions: ["familiar:speak", "familiar:reaction", "commands", "status"] });
 await h.start();
 await h.runCommand("say-hello");
 h.expectSpoke(/hello/i);
@@ -67,15 +67,15 @@ console.log("blank template tests passed.");
   reminder: {
     description:
       "Quick local reminders delivered with ctx.ui.alert: sound, a sticky bubble you can snooze, and optional notification. Fully localized via $t: + ctx.t().",
-    permissions: ["pet:speak", "pet:interact", "audio", "schedule", "storage", "commands", "status", "notify"],
+    permissions: ["familiar:speak", "familiar:interact", "audio", "schedule", "storage", "commands", "status", "notify"],
     configSchema: {
       soundEnabled: { type: "boolean", label: "$t:config.soundEnabled.label", description: "$t:config.soundEnabled.description", default: true },
       osNotification: { type: "boolean", label: "$t:config.osNotification.label", description: "$t:config.osNotification.description", default: true },
       customSound: { type: "sound", label: "$t:config.customSound.label", description: "$t:config.customSound.description" },
     },
-    entry: () => `/// <reference types="@open-pets/plugin-sdk" />
+    entry: () => `/// <reference types="@familiaros/plugin-sdk" />
 //
-// Quick reminders that mirror the shipped openpets.reminders reference plugin.
+// Quick reminders that mirror the shipped familiaros.reminders reference plugin.
 // Keeps a "Set reminder…" form plus 15/30/60-minute presets, but delivers with
 // the acknowledge pattern: ctx.ui.alert(...) with Done / Snooze 5m actions,
 // optional custom sound, and optional OS notification. Host-rendered
@@ -150,7 +150,7 @@ export async function addReminder(ctx, message, delayMs) {
   reminders.push(reminder);
   await saveReminders(ctx, reminders);
   await scheduleReminder(ctx, reminder);
-  await ctx.pet.speak(ctx.t("speech.set", { minutes: Math.max(1, Math.round(delayMs / 60_000)) }));
+  await ctx.familiar.speak(ctx.t("speech.set", { minutes: Math.max(1, Math.round(delayMs / 60_000)) }));
   return reminder;
 }
 
@@ -179,7 +179,7 @@ async function deliver(ctx, message, { missed = false } = {}) {
     });
   } catch {
     try {
-      await ctx.pet.speak(text);
+      await ctx.familiar.speak(text);
     } catch {
       // last resort already attempted.
     }
@@ -220,7 +220,7 @@ async function showReminderList(ctx) {
   const now = Date.now();
   const pending = reminders.filter((r) => r.dueAt > now);
   if (!pending.length) {
-    await ctx.pet.speak(ctx.t("speech.none"));
+    await ctx.familiar.speak(ctx.t("speech.none"));
     await ctx.ui.menu.setItems([]);
     return;
   }
@@ -236,15 +236,15 @@ async function showReminderList(ctx) {
         await ctx.schedule.cancel(reminder.id);
         const remaining = (await getReminders(ctx)).filter((r) => r.id !== reminder.id);
         await saveReminders(ctx, remaining);
-        await ctx.pet.speak(ctx.t("speech.cancelled", { message: reminder.message }));
+        await ctx.familiar.speak(ctx.t("speech.cancelled", { message: reminder.message }));
         await showReminderList(ctx);
       },
     })),
   );
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await reconcile(ctx);
 
@@ -289,7 +289,7 @@ export function register(OpenPetsPlugin) {
           await ctx.schedule.cancelAll();
           await saveReminders(ctx, []);
           await ctx.ui.menu.setItems([]);
-          await ctx.pet.speak(ctx.t("speech.cleared"));
+          await ctx.familiar.speak(ctx.t("speech.cleared"));
         },
       );
     },
@@ -298,12 +298,12 @@ export function register(OpenPetsPlugin) {
 }
 `,
     test: () => `import assert from "node:assert/strict";
-import { createTestHarness } from "@open-pets/plugin-sdk/testing";
+import { createTestHarness } from "@familiaros/plugin-sdk/testing";
 import { register, cleanMessage, durationMs, MAX_REMINDERS } from "./index.js";
 
 const PERMISSIONS = [
-  "pet:speak",
-  "pet:interact",
+  "familiar:speak",
+  "familiar:interact",
   "audio",
   "schedule",
   "storage",
@@ -435,32 +435,32 @@ console.log("reminder template tests passed.");
 
   ambient: {
     description: "Gentle ambient presence driven by the senses bus.",
-    permissions: ["pet:speak", "pet:reaction", "schedule", "events", "status"],
+    permissions: ["familiar:speak", "familiar:reaction", "schedule", "events", "status"],
     configSchema: {
       checkInMinutes: { type: "number", label: "Check-in minutes", default: 45, min: 10, max: 480 },
     },
-    entry: () => `/// <reference types="@open-pets/plugin-sdk" />
+    entry: () => `/// <reference types="@familiaros/plugin-sdk" />
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       const config = await ctx.config.get();
       const intervalMinutes = Math.max(10, Number(config.checkInMinutes ?? 45));
 
       await ctx.schedule.every("ambient-check-in", intervalMinutes * 60_000, async () => {
-        await ctx.pet.speak("Still here with you.");
+        await ctx.familiar.speak("Still here with you.");
       });
 
       ctx.events.on("idle:exit", () => {
-        void ctx.pet.react("waving");
+        void ctx.familiar.react("waving");
       });
 
-      ctx.events.on("pet:clicked", () => {
-        void ctx.pet.react("celebrating");
+      ctx.events.on("familiar:clicked", () => {
+        void ctx.familiar.react("celebrating");
       });
 
       ctx.events.on("day:partChanged", (event) => {
-        if (event.part === "evening") void ctx.pet.speak("Evening already. Pace yourself.");
+        if (event.part === "evening") void ctx.familiar.speak("Evening already. Pace yourself.");
       });
     },
   });
@@ -468,14 +468,14 @@ export function register(OpenPetsPlugin) {
 `,
     test: () => `${sharedTestHeader}
 const h = createTestHarness(register, {
-  permissions: ["pet:speak", "pet:reaction", "schedule", "events", "status"],
+  permissions: ["familiar:speak", "familiar:reaction", "schedule", "events", "status"],
   config: { checkInMinutes: 45 },
 });
 await h.start();
 h.expectScheduled("ambient-check-in");
 await h.clock.advance("45m");
 h.expectSpoke(/still here/i);
-await h.emit("pet:clicked", { petId: "default" });
+await h.emit("familiar:clicked", { petId: "default" });
 h.expectReacted("celebrating");
 await h.emit("day:partChanged", { part: "evening" });
 h.expectSpoke(/evening/i);
@@ -485,30 +485,30 @@ console.log("ambient template tests passed.");
   },
 
   "ai-chat": {
-    description: "A chat pet on the host AI gateway with model-generated speech.",
-    permissions: ["pet:speak", "pet:speak:dynamic", "pet:interact", "pet:reaction", "commands", "status", "ai"],
+    description: "A chat familiar on the host AI gateway with model-generated speech.",
+    permissions: ["familiar:speak", "familiar:speak:dynamic", "familiar:interact", "familiar:reaction", "commands", "status", "ai"],
     configSchema: {
-      personality: { type: "textarea", label: "Personality", default: "You are a tiny upbeat desktop pet. Reply in one short sentence.", maxLength: 500 },
+      personality: { type: "textarea", label: "Personality", default: "You are a tiny upbeat desktop familiar. Reply in one short sentence.", maxLength: 500 },
     },
-    entry: () => `/// <reference types="@open-pets/plugin-sdk" />
+    entry: () => `/// <reference types="@familiaros/plugin-sdk" />
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await ctx.commands.register(
         {
-          id: "ask-pet",
-          title: "Ask the pet…",
+          id: "ask-familiar",
+          title: "Ask the familiar…",
           form: { fields: [{ id: "question", type: "text", label: "Question", maxLength: 300, required: true }], submitLabel: "Ask" },
         },
         async (values) => {
           if (!(await ctx.ai.available())) {
-            await ctx.pet.speak("No AI provider is set up yet.");
+            await ctx.familiar.speak("No AI provider is set up yet.");
             return;
           }
           const config = await ctx.config.get();
-          await ctx.pet.react("thinking");
-          const bubble = await ctx.pet.speak({ text: "…", dynamic: true, sticky: true });
+          await ctx.familiar.react("thinking");
+          const bubble = await ctx.familiar.speak({ text: "…", dynamic: true, sticky: true });
           let answer = "";
           await ctx.ai.stream(
             { system: String(config.personality ?? ""), messages: [{ role: "user", content: String(values?.question ?? "") }], maxTokens: 200 },
@@ -518,7 +518,7 @@ export function register(OpenPetsPlugin) {
             },
           );
           await bubble.update({ markdown: answer, dynamic: true, sticky: false, durationMs: 12_000 });
-          await ctx.pet.react("success");
+          await ctx.familiar.react("success");
         },
       );
     },
@@ -527,11 +527,11 @@ export function register(OpenPetsPlugin) {
 `,
     test: () => `${sharedTestHeader}
 const h = createTestHarness(register, {
-  permissions: ["pet:speak", "pet:speak:dynamic", "pet:interact", "pet:reaction", "commands", "status", "ai"],
+  permissions: ["familiar:speak", "familiar:speak:dynamic", "familiar:interact", "familiar:reaction", "commands", "status", "ai"],
 });
 h.ai.mock(() => "I feel sleepy but happy.");
 await h.start();
-await h.runCommand("ask-pet", { question: "How do you feel?" });
+await h.runCommand("ask-familiar", { question: "How do you feel?" });
 assert.equal(h.calls.aiCalls.length, 1);
 h.expectReacted("success");
 const live = h.calls.bubbles.find((bubble) => bubble.spec.dynamic);
@@ -542,17 +542,17 @@ console.log("ai-chat template tests passed.");
   },
 
   tamagotchi: {
-    description: "A virtual pet with needs, moods, feeding, and a live stats pin.",
-    permissions: ["pet:speak", "pet:interact", "pet:pin", "pet:reaction", "commands", "status", "schedule", "storage", "events", "audio", "notify"],
+    description: "A virtual familiar with needs, moods, feeding, and a live stats pin.",
+    permissions: ["familiar:speak", "familiar:interact", "familiar:pin", "familiar:reaction", "commands", "status", "schedule", "storage", "events", "audio", "notify"],
     configSchema: {
       decayMinutes: { type: "number", label: "Need decay minutes", default: 30, min: 10, max: 240 },
     },
-    entry: ({ name }) => `/// <reference types="@open-pets/plugin-sdk" />
+    entry: ({ name }) => `/// <reference types="@familiaros/plugin-sdk" />
 
 const clamp = (value) => Math.max(0, Math.min(100, Math.round(value)));
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       const config = await ctx.config.get();
       const decayMinutes = Math.max(10, Number(config.decayMinutes ?? 30));
@@ -585,16 +585,16 @@ export function register(OpenPetsPlugin) {
           ? \`Mood: happy · 🍖 \${stats.hunger} ⚡ \${stats.energy} ♥ \${stats.affection}\`
           : \`I'm \${mood}! · 🍖 \${stats.hunger} ⚡ \${stats.energy} ♥ \${stats.affection}\`;
         if (pinned) { await pinned.update({ text }); return; }
-        pinned = await ctx.pet.speak({ text, pin: true, icon: "heart", priority: mood === "happy" ? "low" : "high" });
+        pinned = await ctx.familiar.speak({ text, pin: true, icon: "heart", priority: mood === "happy" ? "low" : "high" });
         pinned.onDismiss(() => { pinned = null; });
       };
 
       const applyMood = async (stats) => {
         const mood = moodOf(stats);
-        if (mood === "hungry") await ctx.pet.react("waiting");
-        else if (mood === "sleepy") await ctx.pet.react("idle");
-        else if (mood === "lonely") await ctx.pet.react("error");
-        else await ctx.pet.react("success");
+        if (mood === "hungry") await ctx.familiar.react("waiting");
+        else if (mood === "sleepy") await ctx.familiar.react("idle");
+        else if (mood === "lonely") await ctx.familiar.react("error");
+        else await ctx.familiar.react("success");
         await refreshPin(stats);
       };
 
@@ -609,15 +609,15 @@ export function register(OpenPetsPlugin) {
         await ctx.storage.set("stats", current);
         await applyMood(current);
         if (moodOf(current) !== "happy") {
-          await ctx.notify.notify({ title: ${JSON.stringify(name)}, body: "Your pet needs attention." });
+          await ctx.notify.notify({ title: ${JSON.stringify(name)}, body: "Your familiar needs attention." });
         }
       });
 
-      ctx.events.on("pet:clicked", async () => {
+      ctx.events.on("familiar:clicked", async () => {
         const current = await loadStats();
         current.affection = clamp(current.affection + 8);
         await ctx.storage.set("stats", current);
-        await ctx.pet.speak({ text: "♥", icon: "heart", durationMs: 1500, priority: "low" });
+        await ctx.familiar.speak({ text: "♥", icon: "heart", durationMs: 1500, priority: "low" });
         await applyMood(current);
       });
 
@@ -626,7 +626,7 @@ export function register(OpenPetsPlugin) {
         current.hunger = clamp(current.hunger + 30);
         await ctx.storage.set("stats", current);
         await ctx.audio.play("nom").catch(() => undefined);
-        await ctx.pet.speak({ text: "Nom nom!", icon: "food", durationMs: 2500 });
+        await ctx.familiar.speak({ text: "Nom nom!", icon: "food", durationMs: 2500 });
         await applyMood(current);
       });
 
@@ -635,7 +635,7 @@ export function register(OpenPetsPlugin) {
         current.affection = clamp(current.affection + 15);
         current.energy = clamp(current.energy - 10);
         await ctx.storage.set("stats", current);
-        await ctx.pet.react("celebrating");
+        await ctx.familiar.react("celebrating");
         await applyMood(current);
       });
 
@@ -643,7 +643,7 @@ export function register(OpenPetsPlugin) {
         const current = await loadStats();
         current.energy = clamp(current.energy + 40);
         await ctx.storage.set("stats", current);
-        await ctx.pet.speak("Zzz…");
+        await ctx.familiar.speak("Zzz…");
         await applyMood(current);
       });
     },
@@ -651,7 +651,7 @@ export function register(OpenPetsPlugin) {
 }
 `,
     test: () => `${sharedTestHeader}
-const PERMISSIONS = ["pet:speak", "pet:interact", "pet:pin", "pet:reaction", "commands", "status", "schedule", "storage", "events", "audio", "notify"];
+const PERMISSIONS = ["familiar:speak", "familiar:interact", "familiar:pin", "familiar:reaction", "commands", "status", "schedule", "storage", "events", "audio", "notify"];
 const h = createTestHarness(register, { permissions: PERMISSIONS, config: { decayMinutes: 30 } });
 await h.start();
 h.expectScheduled("decay");
@@ -662,10 +662,10 @@ await h.runCommand("feed");
 h.expectSpoke(/nom/i);
 h.expectStored("stats", (stats) => stats.hunger >= 80);
 
-await h.emit("pet:clicked", { petId: "default" });
+await h.emit("familiar:clicked", { petId: "default" });
 h.expectStored("stats", (stats) => stats.affection > 60);
 
-// Needs decay over time and the pet complains when neglected.
+// Needs decay over time and the familiar complains when neglected.
 await h.clock.advance("4h");
 h.expectStored("stats", (stats) => stats.hunger < 100);
 h.expectNoErrors();
@@ -675,11 +675,11 @@ console.log("tamagotchi template tests passed.");
 
   calendar: {
     description: "Calendar companion: .ics import, countdown pin, event reminders.",
-    permissions: ["pet:speak", "pet:interact", "pet:pin", "pet:reaction", "commands", "status", "schedule", "storage", "files", "notify"],
+    permissions: ["familiar:speak", "familiar:interact", "familiar:pin", "familiar:reaction", "commands", "status", "schedule", "storage", "files", "notify"],
     configSchema: {
       reminderMinutes: { type: "number", label: "Remind before (minutes)", default: 10, min: 1, max: 120 },
     },
-    entry: () => `/// <reference types="@open-pets/plugin-sdk" />
+    entry: () => `/// <reference types="@familiaros/plugin-sdk" />
 
 const parseIcs = (text) => {
   const events = [];
@@ -694,8 +694,8 @@ const parseIcs = (text) => {
   return events.sort((a, b) => a.startsAt - b.startsAt);
 };
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       const config = await ctx.config.get();
       const reminderMinutes = Math.max(1, Number(config.reminderMinutes ?? 10));
@@ -710,7 +710,7 @@ export function register(OpenPetsPlugin) {
         const label = \`Next: \${next.summary}\`;
         if (pinned) await pinned.update({ text: label });
         else {
-          pinned = await ctx.pet.speak({ text: label, pin: true, icon: "timer" });
+          pinned = await ctx.familiar.speak({ text: label, pin: true, icon: "timer" });
           pinned.onDismiss(() => { pinned = null; });
         }
         const remindAt = new Date(next.startsAt - reminderMinutes * 60_000).toISOString();
@@ -719,8 +719,8 @@ export function register(OpenPetsPlugin) {
           const remaining = ((await ctx.storage.get("events")) ?? []).filter((event) => !(event.summary === next.summary && event.startsAt === next.startsAt));
           await ctx.storage.set("events", remaining);
           await ctx.notify.notify({ title: "Upcoming event", body: next.summary });
-          await ctx.pet.speak({ text: \`\${next.summary} in \${reminderMinutes} min\`, icon: "bell", sticky: true, actions: [{ id: "ok", label: "OK", style: "primary" }] });
-          await ctx.pet.react("waiting");
+          await ctx.familiar.speak({ text: \`\${next.summary} in \${reminderMinutes} min\`, icon: "bell", sticky: true, actions: [{ id: "ok", label: "OK", style: "primary" }] });
+          await ctx.familiar.react("waiting");
           await armReminders();
         });
       };
@@ -731,14 +731,14 @@ export function register(OpenPetsPlugin) {
         const text = await files[0].readText();
         const events = parseIcs(text).filter((event) => event.startsAt > Date.now()).slice(0, 50);
         await ctx.storage.set("events", events);
-        await ctx.pet.speak(\`Imported \${events.length} upcoming events.\`);
+        await ctx.familiar.speak(\`Imported \${events.length} upcoming events.\`);
         await armReminders();
       });
 
       await ctx.commands.register({ id: "whats-next", title: "What's next?" }, async () => {
         const events = (await ctx.storage.get("events")) ?? [];
         const next = events.find((event) => event.startsAt > Date.now());
-        await ctx.pet.speak(next ? \`Next up: \${next.summary}\` : "Nothing on the calendar.");
+        await ctx.familiar.speak(next ? \`Next up: \${next.summary}\` : "Nothing on the calendar.");
       });
 
       await armReminders();
@@ -747,7 +747,7 @@ export function register(OpenPetsPlugin) {
 }
 `,
     test: () => `${sharedTestHeader}
-const PERMISSIONS = ["pet:speak", "pet:interact", "pet:pin", "pet:reaction", "commands", "status", "schedule", "storage", "files", "notify"];
+const PERMISSIONS = ["familiar:speak", "familiar:interact", "familiar:pin", "familiar:reaction", "commands", "status", "schedule", "storage", "files", "notify"];
 const h = createTestHarness(register, { permissions: PERMISSIONS, config: { reminderMinutes: 10 } });
 const startsAt = new Date(h.clock.now() + 60 * 60_000);
 const stamp = startsAt.toISOString().replace(/[-:]/g, "").replace(/\\.\\d{3}/, "");
diff --git a/packages/cli/src/plugin-validate.ts b/packages/cli/src/plugin-validate.ts
index bd6fd473..d224d3ac 100644
--- a/packages/cli/src/plugin-validate.ts
+++ b/packages/cli/src/plugin-validate.ts
@@ -2,7 +2,7 @@ import { existsSync, lstatSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 
 /**
- * Author-time manifest validation (§18.5): `openpets plugin validate <dir>`
+ * Author-time manifest validation (§18.5): `familiaros plugin validate <dir>`
  * checks the manifest shape, permissions, config schema, network hosts,
  * declared assets/panels, and that every referenced file exists with a sane
  * size — before the plugin ever reaches the app.
@@ -14,10 +14,10 @@ import { join, resolve } from "node:path";
 export type PluginValidationIssue = { readonly path: string; readonly message: string };
 export type PluginValidationResult = { readonly ok: boolean; readonly issues: readonly PluginValidationIssue[] };
 
-const v2Permissions = ["pet:speak", "pet:reaction", "pet:move", "schedule", "storage", "status", "commands", "network"];
+const v2Permissions = ["familiar:speak", "familiar:reaction", "familiar:move", "schedule", "storage", "status", "commands", "network"];
 const v3Permissions = [
   ...v2Permissions,
-  "pet:interact", "pet:pin", "pet:animate", "pet:speak:dynamic", "pet:drop", "pets:read", "pets:manage",
+  "familiar:interact", "familiar:pin", "familiar:animate", "familiar:speak:dynamic", "familiar:drop", "familiars:read", "familiars:manage",
   "audio", "events", "ui:toast", "ui:panel", "notify", "bus", "ai", "secrets", "voice:speak", "voice:listen",
   "auth", "files", "system:openExternal", "system:metrics", "clipboard", "network:write",
 ];
@@ -40,8 +40,8 @@ export function validatePluginFolder(sourceDir: string): PluginValidationResult
   const issues: PluginValidationIssue[] = [];
   const fail = (path: string, message: string) => issues.push({ path, message });
   const dir = resolve(sourceDir);
-  const manifestPath = join(dir, "openpets.plugin.json");
-  if (!existsSync(manifestPath)) return { ok: false, issues: [{ path: "openpets.plugin.json", message: "Manifest file not found." }] };
+  const manifestPath = join(dir, "familiaros.plugin.json");
+  if (!existsSync(manifestPath)) return { ok: false, issues: [{ path: "familiaros.plugin.json", message: "Manifest file not found." }] };
 
   let manifest: Record<string, unknown>;
   try {
@@ -49,7 +49,7 @@ export function validatePluginFolder(sourceDir: string): PluginValidationResult
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new Error("not an object");
     manifest = parsed as Record<string, unknown>;
   } catch (error) {
-    return { ok: false, issues: [{ path: "openpets.plugin.json", message: `Manifest is not valid JSON: ${error instanceof Error ? error.message : String(error)}` }] };
+    return { ok: false, issues: [{ path: "familiaros.plugin.json", message: `Manifest is not valid JSON: ${error instanceof Error ? error.message : String(error)}` }] };
   }
 
   const manifestVersion = manifest.manifestVersion;
diff --git a/packages/client/codemap.md b/packages/client/codemap.md
index 395c9db9..bc9b0370 100644
--- a/packages/client/codemap.md
+++ b/packages/client/codemap.md
@@ -1,10 +1,10 @@
 # packages/client/
 
-Core IPC client library for OpenPets desktop app communication.
+Core IPC client library for FamiliarOS desktop app communication.
 
 ## Responsibility
 
-Provides the foundational client library for all OpenPets integrations. Handles discovery file reading, TCP socket connections (including WSL cross-platform), request/response protocol, and high-level pet operations (status, list, install, lease, react, say).
+Provides the foundational client library for all FamiliarOS integrations. Handles discovery file reading, TCP socket connections (including WSL cross-platform), request/response protocol, and high-level familiar operations (status, list, install, lease, react, say).
 
 ## Design/Patterns
 
@@ -12,7 +12,7 @@ Provides the foundational client library for all OpenPets integrations. Handles
 - Defines IPC protocol version (v1), message limits (16KB), timeouts (2s connect, 3s response)
 - Request/response types with discriminated union (`ok: true/false`)
 - Reaction validation against allowed enum values
-- Custom `OpenPetsClientError` with error codes
+- Custom `FamiliarOSClientError` with error codes
 
 **Discovery Layer** (`discovery.ts`):
 - Cross-platform discovery file path resolution (macOS, Windows, Linux/XDG)
@@ -31,9 +31,9 @@ Provides the foundational client library for all OpenPets integrations. Handles
 - Enables WSL clients to connect to Windows desktop app
 
 **Client Layer** (`index.ts`):
-- Factory pattern: `createOpenPetsClient(options)` returns `OpenPetsClient` interface
+- Factory pattern: `createFamiliarOSClient(options)` returns `FamiliarOSClient` interface
 - Methods: `hello()`, `status()`, `listPets()`, `installPet()`, `acquireLease()`, `heartbeatLease()`, `releaseLease()`, `react()`, `say()`
-- Lease-aware operations for multi-pet targeting
+- Lease-aware operations for multi-familiar targeting
 - Result parsers with validation
 
 **Socket Management**:
@@ -72,23 +72,23 @@ net.createConnection({ host, port }) → Windows desktop app
 ## Integration Points
 
 **Consumers** (all depend on this package):
-- `@open-pets/cli` - CLI commands
-- `@open-pets/mcp` - MCP tool implementations
-- `@open-pets/claude` - Hook execution
-- `@open-pets/opencode` - Plugin runtime
-- `@open-pets/install-pet` - Direct installation fallback
+- `@familiaros/cli` - CLI commands
+- `@familiaros/mcp` - MCP tool implementations
+- `@familiaros/claude` - Hook execution
+- `@familiaros/opencode` - Plugin runtime
+- `@familiaros/install-familiar` - Direct installation fallback
 
-**Desktop App**: Communicates with OpenPets desktop app via:
+**Desktop App**: Communicates with FamiliarOS desktop app via:
 - Unix domain socket (macOS/Linux)
 - Windows named pipe (Windows)
 - TCP socket (WSL cross-platform)
 
 **Exports**:
-- `createOpenPetsClient()` - Main factory
+- `createFamiliarOSClient()` - Main factory
 - `sendRequest()` - Low-level request function
 - `readDiscoveryFile()`, `getDiscoveryFilePath()` - Discovery utilities
 - `parseIpcEndpoint()`, `validateEndpoint()` - Endpoint handling
-- `OpenPetsClientError`, error codes, types
+- `FamiliarOSClientError`, error codes, types
 
 **Contracts**:
 - `contracts/client-protocol.contract.ts` - Runtime protocol validation tests
diff --git a/packages/client/contracts/client-protocol.contract.ts b/packages/client/contracts/client-protocol.contract.ts
index 25cb93ec..01f9c8d7 100644
--- a/packages/client/contracts/client-protocol.contract.ts
+++ b/packages/client/contracts/client-protocol.contract.ts
@@ -2,12 +2,12 @@ import assert from "node:assert/strict";
 
 import { parseIpcEndpoint, validateDiscovery } from "../src/discovery.js";
 import { parsePetInstallResult, parsePetListResult } from "../src/index.js";
-import { OpenPetsClientError, parseIpcResponse, validateReaction } from "../src/protocol.js";
+import { FamiliarOSClientError, parseIpcResponse, validateReaction } from "../src/protocol.js";
 
 const baseDiscovery = {
   protocolVersion: 1,
-  protocol: "openpets-ipc",
-  endpoint: process.platform === "win32" ? "\\\\.\\pipe\\openpets-abc-123" : "/tmp/openpets-501/openpets-123.sock",
+  protocol: "familiaros-ipc",
+  endpoint: process.platform === "win32" ? "\\\\.\\pipe\\familiaros-abc-123" : "/tmp/familiaros-501/familiaros-123.sock",
   token: "x".repeat(32),
   appVersion: "0.0.0",
   pid: 123,
@@ -62,8 +62,8 @@ const err = parseIpcResponse({ id: "1", ok: false, error: { code: "invalid_token
 if (err.ok || err.error.code !== "invalid_token") throw new Error("Failed to parse error response.");
 
 assertRejects(() => parseIpcResponse({ ok: true }));
-assert.deepEqual(parsePetListResult({ ok: true, defaultPetId: "builtin", pets: [{ id: "fixer", displayName: "Fixer", builtIn: false, broken: false }] }), { ok: true, defaultPetId: "builtin", pets: [{ id: "fixer", displayName: "Fixer", builtIn: false, broken: false }] });
-assertRejects(() => parsePetListResult({ ok: true, pets: [{ id: "fixer" }], defaultPetId: "builtin" }));
+assert.deepEqual(parsePetListResult({ ok: true, defaultPetId: "builtin", familiars: [{ id: "fixer", displayName: "Fixer", builtIn: false, broken: false }] }), { ok: true, defaultPetId: "builtin", familiars: [{ id: "fixer", displayName: "Fixer", builtIn: false, broken: false }] });
+assertRejects(() => parsePetListResult({ ok: true, familiars: [{ id: "fixer" }], defaultPetId: "builtin" }));
 assert.deepEqual(parsePetInstallResult({ ok: true, petId: "fixer", displayName: "Fixer", installed: true }), { ok: true, petId: "fixer", displayName: "Fixer", installed: true });
 assertRejects(() => parsePetInstallResult({ ok: true, petId: "fixer" }));
 
@@ -73,7 +73,7 @@ function assertRejects(callback: () => unknown): void {
   try {
     callback();
   } catch (error) {
-    if (error instanceof OpenPetsClientError || error instanceof Error) return;
+    if (error instanceof FamiliarOSClientError || error instanceof Error) return;
   }
   throw new Error("Expected validation to reject.");
 }
diff --git a/packages/client/contracts/codemap.md b/packages/client/contracts/codemap.md
index 34affe20..3f2774b9 100644
--- a/packages/client/contracts/codemap.md
+++ b/packages/client/contracts/codemap.md
@@ -30,7 +30,7 @@ Runtime protocol validation (79 lines). Imports from `../src/` and asserts:
 - **Cross-platform discovery**: Windows desktop → WSL client via private IPs
 - **Public IP rejection**: Ensures public IPs are rejected for security
 - **Response parsing**: ok/error discriminated union parsing
-- **Pet list/install result parsing**: Validates pet data structures
+- **Familiar list/install result parsing**: Validates familiar data structures
 
 **Security Coverage**:
 - IPv4 only (no hostnames)
diff --git a/packages/client/package.json b/packages/client/package.json
index 8ed5d32d..80fc04b0 100644
--- a/packages/client/package.json
+++ b/packages/client/package.json
@@ -1,10 +1,10 @@
 {
-  "name": "@open-pets/client",
+  "name": "@familiaros/client",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/client"
   },
   "type": "module",
diff --git a/packages/client/src/codemap.md b/packages/client/src/codemap.md
index 37565988..5de08845 100644
--- a/packages/client/src/codemap.md
+++ b/packages/client/src/codemap.md
@@ -1,28 +1,28 @@
 # packages/client/src/
 
-Core IPC client implementation for OpenPets desktop app communication.
+Core IPC client implementation for FamiliarOS desktop app communication.
 
 ## Files
 
 ### index.ts
 
-Main client implementation (193 lines). `createOpenPetsClient()` factory, all client methods, result parsers, and `sendRequest()` for low-level IPC.
+Main client implementation (193 lines). `createFamiliarOSClient()` factory, all client methods, result parsers, and `sendRequest()` for low-level IPC.
 
 **Client Methods:**
 - `hello()` - Protocol handshake
 - `status(options?)` - App connectivity check with graceful error handling
-- `listPets()` - Fetch installed pets with metadata
-- `installPet(petId)` - Install pet with 60s timeout
-- `acquireLease(options?)` - Get lease for targeted pet operations
+- `listPets()` - Fetch installed familiars with metadata
+- `installPet(petId)` - Install familiar with 60s timeout
+- `acquireLease(options?)` - Get lease for targeted familiar operations
 - `heartbeatLease(leaseId)` - Keep lease alive
 - `releaseLease(leaseId)` - Release acquired lease
 - `react(reaction, options?)` - Send reaction (lease-aware)
 - `say(message, options?)` - Display message (lease-aware, optional reaction)
 
 **Result Parsers:**
-- `parsePetListResult()` - Validates pet list response
+- `parsePetListResult()` - Validates familiar list response
 - `parsePetInstallResult()` - Validates install response
-- `validatePetId()` - Pet ID format validation (regex: `^[a-z0-9][a-z0-9_-]{0,63}$`)
+- `validatePetId()` - Familiar ID format validation (regex: `^[a-z0-9][a-z0-9_-]{0,63}$`)
 
 **Socket Management:**
 - Node.js `net.createConnection()` for TCP/Unix sockets/Windows named pipes
@@ -32,7 +32,7 @@ Main client implementation (193 lines). `createOpenPetsClient()` factory, all cl
 
 ### protocol.ts
 
-IPC protocol constants, request/response types, `parseIpcResponse()`, `validateReaction()`, `OpenPetsClientError` class.
+IPC protocol constants, request/response types, `parseIpcResponse()`, `validateReaction()`, `FamiliarOSClientError` class.
 
 **Protocol Constants:**
 - Version: v1
@@ -56,13 +56,13 @@ IPC protocol constants, request/response types, `parseIpcResponse()`, `validateR
 Discovery file handling (226 lines). `getDiscoveryFilePath()`, `readDiscoveryFile()`, `validateDiscovery()`, `validateEndpoint()`, platform-specific path logic, XDG security checks.
 
 **Platform Paths:**
-- macOS: `~/Library/Application Support/OpenPets/runtime/ipc.json`
-- Windows: `%APPDATA%/OpenPets/runtime/ipc.json`
-- Linux: `$XDG_RUNTIME_DIR/openpets/ipc.json` (preferred) or `~/.config/OpenPets/runtime/ipc.json`
+- macOS: `~/Library/Application Support/FamiliarOS/runtime/ipc.json`
+- Windows: `%APPDATA%/FamiliarOS/runtime/ipc.json`
+- Linux: `$XDG_RUNTIME_DIR/familiaros/ipc.json` (preferred) or `~/.config/FamiliarOS/runtime/ipc.json`
 
 **Endpoint Types:**
-- Unix sockets: `/tmp/openpets-*/openpets-*.sock` or `$XDG_RUNTIME_DIR/openpets/*.sock`
-- Windows named pipes: `\\.\pipe\openpets-*`
+- Unix sockets: `/tmp/familiaros-*/familiaros-*.sock` or `$XDG_RUNTIME_DIR/familiaros/*.sock`
+- Windows named pipes: `\\.\pipe\familiaros-*`
 - TCP: `tcp://<host>:<port>` (IPv4 only, private/local addresses)
 
 **TCP/WSL Support:**
@@ -93,4 +93,4 @@ Contract validation (moved from src/check-client-protocol.ts). Runtime assertion
 - Cross-platform discovery (Windows desktop → WSL)
 - Public IP rejection
 - Response parsing (ok/error cases)
-- Pet list/install result parsing
+- Familiar list/install result parsing
diff --git a/packages/client/src/discovery.ts b/packages/client/src/discovery.ts
index 36e725a2..f076edf7 100644
--- a/packages/client/src/discovery.ts
+++ b/packages/client/src/discovery.ts
@@ -2,11 +2,11 @@ import { existsSync, lstatSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join } from "node:path";
 
-import { isRecord, maxIpcMessageBytes, openPetsIpcProtocol, openPetsIpcVersion, OpenPetsClientError } from "./protocol.js";
+import { isRecord, maxIpcMessageBytes, openPetsIpcProtocol, openPetsIpcVersion, FamiliarOSClientError } from "./protocol.js";
 
-export interface OpenPetsDiscoveryFile {
+export interface FamiliarOSDiscoveryFile {
   readonly protocolVersion: 1;
-  readonly protocol: "openpets-ipc";
+  readonly protocol: "familiaros-ipc";
   readonly endpoint: string;
   readonly token: string;
   readonly appVersion: string;
@@ -19,63 +19,63 @@ export type ParsedIpcEndpoint =
   | { readonly kind: "path"; readonly path: string };
 
 export function getDiscoveryFilePath(): string {
-  if (process.env.OPENPETS_DISCOVERY_FILE) {
-    return process.env.OPENPETS_DISCOVERY_FILE;
+  if (process.env.FAMILIAROS_DISCOVERY_FILE) {
+    return process.env.FAMILIAROS_DISCOVERY_FILE;
   }
 
   if (process.platform === "darwin") {
-    return join(homedir(), "Library", "Application Support", "OpenPets", "runtime", "ipc.json");
+    return join(homedir(), "Library", "Application Support", "FamiliarOS", "runtime", "ipc.json");
   }
 
   if (process.platform === "win32") {
-    return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "OpenPets", "runtime", "ipc.json");
+    return join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "FamiliarOS", "runtime", "ipc.json");
   }
 
   const xdg = getSecureXdgRuntimeDir();
   if (xdg) {
-    return join(xdg, "openpets", "ipc.json");
+    return join(xdg, "familiaros", "ipc.json");
   }
 
-  return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "OpenPets", "runtime", "ipc.json");
+  return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "FamiliarOS", "runtime", "ipc.json");
 }
 
-export function readDiscoveryFile(path = getDiscoveryFilePath()): OpenPetsDiscoveryFile {
+export function readDiscoveryFile(path = getDiscoveryFilePath()): FamiliarOSDiscoveryFile {
   let raw: string;
   try {
     const stat = statSync(path);
-    if (!stat.isFile()) throw new OpenPetsClientError("invalid_discovery", "OpenPets discovery path is not a file.");
-    if (stat.size > maxIpcMessageBytes) throw new OpenPetsClientError("invalid_discovery", "OpenPets discovery file is too large.");
+    if (!stat.isFile()) throw new FamiliarOSClientError("invalid_discovery", "FamiliarOS discovery path is not a file.");
+    if (stat.size > maxIpcMessageBytes) throw new FamiliarOSClientError("invalid_discovery", "FamiliarOS discovery file is too large.");
     raw = readFileSync(path, "utf8");
   } catch (error) {
-    if (error instanceof OpenPetsClientError) throw error;
-    throw new OpenPetsClientError("unavailable", `OpenPets discovery file is unavailable: ${error instanceof Error ? error.message : "unknown error"}`);
+    if (error instanceof FamiliarOSClientError) throw error;
+    throw new FamiliarOSClientError("unavailable", `FamiliarOS discovery file is unavailable: ${error instanceof Error ? error.message : "unknown error"}`);
   }
 
   if (Buffer.byteLength(raw, "utf8") > maxIpcMessageBytes) {
-    throw new OpenPetsClientError("invalid_discovery", "OpenPets discovery file is too large.");
+    throw new FamiliarOSClientError("invalid_discovery", "FamiliarOS discovery file is too large.");
   }
 
   try {
     return validateDiscovery(JSON.parse(raw) as unknown);
   } catch (error) {
-    if (error instanceof OpenPetsClientError) throw error;
-    throw new OpenPetsClientError("invalid_discovery", "OpenPets discovery file is malformed JSON.");
+    if (error instanceof FamiliarOSClientError) throw error;
+    throw new FamiliarOSClientError("invalid_discovery", "FamiliarOS discovery file is malformed JSON.");
   }
 }
 
-export function validateDiscovery(value: unknown): OpenPetsDiscoveryFile {
-  if (!isRecord(value)) throw new OpenPetsClientError("invalid_discovery", "Discovery must be an object.");
-  if (value.protocol !== openPetsIpcProtocol) throw new OpenPetsClientError("invalid_discovery", "Discovery protocol is invalid.");
-  if (value.protocolVersion !== openPetsIpcVersion) throw new OpenPetsClientError("invalid_discovery", "Discovery protocol version is invalid.");
-  if (typeof value.endpoint !== "string") throw new OpenPetsClientError("invalid_discovery", "Discovery endpoint is invalid.");
-  if (typeof value.token !== "string" || value.token.length < 16 || value.token.length > 256) throw new OpenPetsClientError("invalid_discovery", "Discovery token is invalid.");
-  if (typeof value.appVersion !== "string") throw new OpenPetsClientError("invalid_discovery", "Discovery app version is invalid.");
-  if (typeof value.pid !== "number" || !Number.isInteger(value.pid) || value.pid <= 0) throw new OpenPetsClientError("invalid_discovery", "Discovery pid is invalid.");
-  if (value.platform !== "darwin" && value.platform !== "linux" && value.platform !== "win32") throw new OpenPetsClientError("invalid_discovery", "Discovery platform is invalid.");
+export function validateDiscovery(value: unknown): FamiliarOSDiscoveryFile {
+  if (!isRecord(value)) throw new FamiliarOSClientError("invalid_discovery", "Discovery must be an object.");
+  if (value.protocol !== openPetsIpcProtocol) throw new FamiliarOSClientError("invalid_discovery", "Discovery protocol is invalid.");
+  if (value.protocolVersion !== openPetsIpcVersion) throw new FamiliarOSClientError("invalid_discovery", "Discovery protocol version is invalid.");
+  if (typeof value.endpoint !== "string") throw new FamiliarOSClientError("invalid_discovery", "Discovery endpoint is invalid.");
+  if (typeof value.token !== "string" || value.token.length < 16 || value.token.length > 256) throw new FamiliarOSClientError("invalid_discovery", "Discovery token is invalid.");
+  if (typeof value.appVersion !== "string") throw new FamiliarOSClientError("invalid_discovery", "Discovery app version is invalid.");
+  if (typeof value.pid !== "number" || !Number.isInteger(value.pid) || value.pid <= 0) throw new FamiliarOSClientError("invalid_discovery", "Discovery pid is invalid.");
+  if (value.platform !== "darwin" && value.platform !== "linux" && value.platform !== "win32") throw new FamiliarOSClientError("invalid_discovery", "Discovery platform is invalid.");
 
   const endpoint = parseIpcEndpoint(value.endpoint);
   if (value.platform !== process.platform && !allowsCrossPlatformDiscovery(value.platform, endpoint)) {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery platform does not match this client.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery platform does not match this client.");
   }
 
   return {
@@ -94,34 +94,34 @@ export function validateEndpoint(endpoint: string): void {
 }
 
 export function parseIpcEndpoint(endpoint: string): ParsedIpcEndpoint {
-  if (endpoint.length < 1 || endpoint.length > 240) throw new OpenPetsClientError("invalid_discovery", "Discovery endpoint length is invalid.");
-  if (endpoint.includes("\0")) throw new OpenPetsClientError("invalid_discovery", "Discovery endpoint contains NUL.");
+  if (endpoint.length < 1 || endpoint.length > 240) throw new FamiliarOSClientError("invalid_discovery", "Discovery endpoint length is invalid.");
+  if (endpoint.includes("\0")) throw new FamiliarOSClientError("invalid_discovery", "Discovery endpoint contains NUL.");
 
   if (endpoint.startsWith("tcp://")) {
     return parseTcpEndpoint(endpoint);
   }
 
   if (process.platform === "win32") {
-    if (!endpoint.startsWith("\\\\.\\pipe\\openpets-") || endpoint.includes("/")) {
-      throw new OpenPetsClientError("invalid_discovery", "Discovery endpoint is not an OpenPets named pipe.");
+    if (!endpoint.startsWith("\\\\.\\pipe\\familiaros-") || endpoint.includes("/")) {
+      throw new FamiliarOSClientError("invalid_discovery", "Discovery endpoint is not an FamiliarOS named pipe.");
     }
     return { kind: "path", path: endpoint };
   }
 
   if (!endpoint.startsWith("/") || endpoint.includes("://") || endpoint.includes("..")) {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery endpoint is not an absolute Unix socket path.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery endpoint is not an absolute Unix socket path.");
   }
 
-  if (!basename(endpoint).startsWith("openpets-") || !basename(endpoint).endsWith(".sock")) {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery endpoint filename is not an OpenPets socket.");
+  if (!basename(endpoint).startsWith("familiaros-") || !basename(endpoint).endsWith(".sock")) {
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery endpoint filename is not an FamiliarOS socket.");
   }
 
   const parent = dirname(endpoint);
   const parentName = basename(parent);
-  const isTmpRuntime = parent.startsWith("/tmp/") && parentName.startsWith("openpets-");
-  const isXdgRuntime = parentName === "openpets";
+  const isTmpRuntime = parent.startsWith("/tmp/") && parentName.startsWith("familiaros-");
+  const isXdgRuntime = parentName === "familiaros";
   if (!isTmpRuntime && !isXdgRuntime) {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery endpoint is outside an expected OpenPets runtime directory.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery endpoint is outside an expected FamiliarOS runtime directory.");
   }
 
   return { kind: "path", path: endpoint };
@@ -132,38 +132,38 @@ function parseTcpEndpoint(endpoint: string): ParsedIpcEndpoint {
   try {
     url = new URL(endpoint);
   } catch {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery TCP endpoint is invalid.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery TCP endpoint is invalid.");
   }
 
   if (url.protocol !== "tcp:" || url.username || url.password || (url.pathname !== "" && url.pathname !== "/") || url.search || url.hash) {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery TCP endpoint must be tcp://<host>:<port> with no credentials, path, query, or fragment.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery TCP endpoint must be tcp://<host>:<port> with no credentials, path, query, or fragment.");
   }
 
   const host = url.hostname;
 
   // Reject 0.0.0.0 - not a valid target address
   if (host === "0.0.0.0") {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery TCP endpoint cannot use 0.0.0.0 as target host.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery TCP endpoint cannot use 0.0.0.0 as target host.");
   }
 
   // Validate IPv4 format
   if (!isValidIpv4(host)) {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery TCP endpoint host must be a valid IPv4 address.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery TCP endpoint host must be a valid IPv4 address.");
   }
 
   // Reject hostnames (contain letters)
   if (/[a-zA-Z]/.test(host)) {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery TCP endpoint host must be an IPv4 address, not a hostname.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery TCP endpoint host must be an IPv4 address, not a hostname.");
   }
 
   // Validate that it's a private/local address (loopback, private, or link-local)
   if (!isPrivateOrLocalIpv4(host)) {
-    throw new OpenPetsClientError("invalid_discovery", `Discovery TCP endpoint host ${host} is not a private/local IPv4 address. Only loopback (127.0.0.1), private (10.x.x.x, 172.16-31.x.x, 192.168.x.x), or link-local (169.254.x.x) addresses are allowed.`);
+    throw new FamiliarOSClientError("invalid_discovery", `Discovery TCP endpoint host ${host} is not a private/local IPv4 address. Only loopback (127.0.0.1), private (10.x.x.x, 172.16-31.x.x, 192.168.x.x), or link-local (169.254.x.x) addresses are allowed.`);
   }
 
   const port = Number(url.port);
   if (!Number.isInteger(port) || port < 1 || port > 65_535 || String(port) !== url.port) {
-    throw new OpenPetsClientError("invalid_discovery", "Discovery TCP endpoint port is invalid.");
+    throw new FamiliarOSClientError("invalid_discovery", "Discovery TCP endpoint port is invalid.");
   }
 
   return { kind: "tcp", host, port };
diff --git a/packages/client/src/index.ts b/packages/client/src/index.ts
index c197b7af..6149e799 100644
--- a/packages/client/src/index.ts
+++ b/packages/client/src/index.ts
@@ -1,26 +1,26 @@
 import net from "node:net";
 import { randomUUID } from "node:crypto";
 
-import { parseIpcEndpoint, readDiscoveryFile, type OpenPetsDiscoveryFile } from "./discovery.js";
-import { connectTimeoutMs, maxIpcMessageBytes, openPetsIpcVersion, parseIpcResponse, responseTimeoutMs, validateReaction, OpenPetsClientError, type OpenPetsIpcMethod, type OpenPetsIpcRequest, type OpenPetsMemoryKind, type OpenPetsReaction } from "./protocol.js";
+import { parseIpcEndpoint, readDiscoveryFile, type FamiliarOSDiscoveryFile } from "./discovery.js";
+import { connectTimeoutMs, maxIpcMessageBytes, openPetsIpcVersion, parseIpcResponse, responseTimeoutMs, validateReaction, FamiliarOSClientError, type FamiliarOSIpcMethod, type FamiliarOSIpcRequest, type FamiliarOSMemoryKind, type FamiliarOSReaction } from "./protocol.js";
 
-export { getDiscoveryFilePath, parseIpcEndpoint, readDiscoveryFile, validateDiscovery, validateEndpoint, type OpenPetsDiscoveryFile, type ParsedIpcEndpoint } from "./discovery.js";
-export { allowedReactions, OpenPetsClientError, type OpenPetsMemoryKind, type OpenPetsReaction } from "./protocol.js";
+export { getDiscoveryFilePath, parseIpcEndpoint, readDiscoveryFile, validateDiscovery, validateEndpoint, type FamiliarOSDiscoveryFile, type ParsedIpcEndpoint } from "./discovery.js";
+export { allowedReactions, FamiliarOSClientError, type FamiliarOSMemoryKind, type FamiliarOSReaction } from "./protocol.js";
 
-export interface OpenPetsClientOptions {
+export interface FamiliarOSClientOptions {
   readonly discoveryPath?: string;
   readonly connectTimeoutMs?: number;
   readonly responseTimeoutMs?: number;
 }
 
-export interface OpenPetsStatusResult {
+export interface FamiliarOSStatusResult {
   readonly ok: boolean;
   readonly appRunning: boolean;
   readonly unavailableReason?: string;
   readonly [key: string]: unknown;
 }
 
-export interface OpenPetsLeaseResult {
+export interface FamiliarOSLeaseResult {
   readonly leaseId: string;
   readonly requestedPetId?: string;
   readonly targetKind: "default" | "explicit";
@@ -32,46 +32,46 @@ export interface OpenPetsLeaseResult {
   readonly leaseActive: boolean;
 }
 
-export interface OpenPetsPetListResult {
+export interface FamiliarOSPetListResult {
   readonly ok: true;
-  readonly pets: readonly OpenPetsPetListItem[];
+  readonly familiars: readonly FamiliarOSPetListItem[];
   readonly defaultPetId: string;
 }
 
-export interface OpenPetsPetInstallResult {
+export interface FamiliarOSPetInstallResult {
   readonly ok: true;
   readonly petId: string;
   readonly displayName: string;
   readonly installed: true;
 }
 
-export interface OpenPetsPetListItem {
+export interface FamiliarOSPetListItem {
   readonly id: string;
   readonly displayName: string;
   readonly builtIn: boolean;
   readonly broken: boolean;
 }
 
-export interface OpenPetsClient {
+export interface FamiliarOSClient {
   hello(): Promise<unknown>;
-  status(options?: { readonly leaseId?: string }): Promise<OpenPetsStatusResult>;
-  listPets(): Promise<OpenPetsPetListResult>;
-  installPet(petId: string): Promise<OpenPetsPetInstallResult>;
-  acquireLease(options?: { readonly requestedPetId?: string }): Promise<OpenPetsLeaseResult>;
+  status(options?: { readonly leaseId?: string }): Promise<FamiliarOSStatusResult>;
+  listPets(): Promise<FamiliarOSPetListResult>;
+  installPet(petId: string): Promise<FamiliarOSPetInstallResult>;
+  acquireLease(options?: { readonly requestedPetId?: string }): Promise<FamiliarOSLeaseResult>;
   heartbeatLease(leaseId: string): Promise<{ readonly leaseId: string; readonly expiresAt: number }>;
   releaseLease(leaseId: string): Promise<{ readonly released: boolean }>;
-  react(reaction: OpenPetsReaction, options?: { readonly leaseId?: string }): Promise<unknown>;
-  say(message: string, options?: { readonly reaction?: OpenPetsReaction; readonly leaseId?: string }): Promise<unknown>;
-  listMemories?(options?: { readonly limit?: number }): Promise<OpenPetsMemoryListResult>;
-  searchMemories?(query: string, options?: { readonly limit?: number }): Promise<OpenPetsMemorySearchResult>;
-  storeMemory?(input: { readonly text: string; readonly kind?: OpenPetsMemoryKind; readonly tags?: readonly string[]; readonly importance?: number }): Promise<OpenPetsMemoryStoreResult>;
-  deleteMemory?(id: string): Promise<OpenPetsMemoryDeleteResult>;
+  react(reaction: FamiliarOSReaction, options?: { readonly leaseId?: string }): Promise<unknown>;
+  say(message: string, options?: { readonly reaction?: FamiliarOSReaction; readonly leaseId?: string }): Promise<unknown>;
+  listMemories?(options?: { readonly limit?: number }): Promise<FamiliarOSMemoryListResult>;
+  searchMemories?(query: string, options?: { readonly limit?: number }): Promise<FamiliarOSMemorySearchResult>;
+  storeMemory?(input: { readonly text: string; readonly kind?: FamiliarOSMemoryKind; readonly tags?: readonly string[]; readonly importance?: number }): Promise<FamiliarOSMemoryStoreResult>;
+  deleteMemory?(id: string): Promise<FamiliarOSMemoryDeleteResult>;
 }
 
-export interface OpenPetsMemoryEntry {
+export interface FamiliarOSMemoryEntry {
   readonly id: string;
   readonly text: string;
-  readonly kind: OpenPetsMemoryKind;
+  readonly kind: FamiliarOSMemoryKind;
   readonly tags: readonly string[];
   readonly importance: number;
   readonly createdAt: number;
@@ -81,54 +81,54 @@ export interface OpenPetsMemoryEntry {
   readonly source: "chat" | "mcp";
 }
 
-export interface OpenPetsMemorySearchHit {
-  readonly entry: OpenPetsMemoryEntry;
+export interface FamiliarOSMemorySearchHit {
+  readonly entry: FamiliarOSMemoryEntry;
   readonly score: number;
 }
 
-export interface OpenPetsMemoryListResult {
+export interface FamiliarOSMemoryListResult {
   readonly ok: true;
-  readonly memories: readonly OpenPetsMemoryEntry[];
+  readonly memories: readonly FamiliarOSMemoryEntry[];
 }
 
-export interface OpenPetsMemorySearchResult {
+export interface FamiliarOSMemorySearchResult {
   readonly ok: true;
   readonly query: string;
-  readonly memories: readonly OpenPetsMemorySearchHit[];
+  readonly memories: readonly FamiliarOSMemorySearchHit[];
 }
 
-export interface OpenPetsMemoryStoreResult {
+export interface FamiliarOSMemoryStoreResult {
   readonly ok: true;
-  readonly memory: OpenPetsMemoryEntry;
+  readonly memory: FamiliarOSMemoryEntry;
 }
 
-export interface OpenPetsMemoryDeleteResult {
+export interface FamiliarOSMemoryDeleteResult {
   readonly ok: true;
   readonly id: string;
   readonly deleted: boolean;
 }
 
-export function createOpenPetsClient(options: OpenPetsClientOptions = {}): OpenPetsClient {
+export function createFamiliarOSClient(options: FamiliarOSClientOptions = {}): FamiliarOSClient {
   return {
     hello: () => sendDiscoveredRequest("hello", {}, options),
     status: async (statusOptions) => {
       try {
-        return await sendDiscoveredRequest<OpenPetsStatusResult>("status", { leaseId: statusOptions?.leaseId }, options);
+        return await sendDiscoveredRequest<FamiliarOSStatusResult>("status", { leaseId: statusOptions?.leaseId }, options);
       } catch (error) {
         return {
           ok: false,
           appRunning: false,
-          unavailableReason: error instanceof Error ? error.message : "OpenPets is unavailable.",
+          unavailableReason: error instanceof Error ? error.message : "FamiliarOS is unavailable.",
         };
       }
     },
-    listPets: async () => parsePetListResult(await sendDiscoveredRequest("pets.list", {}, options)),
-    installPet: async (petId) => parsePetInstallResult(await sendDiscoveredRequest("pets.install", { petId: validatePetId(petId) }, { ...options, responseTimeoutMs: options.responseTimeoutMs ?? 60_000 })),
+    listPets: async () => parsePetListResult(await sendDiscoveredRequest("familiars.list", {}, options)),
+    installPet: async (petId) => parsePetInstallResult(await sendDiscoveredRequest("familiars.install", { petId: validatePetId(petId) }, { ...options, responseTimeoutMs: options.responseTimeoutMs ?? 60_000 })),
     acquireLease: (leaseOptions) => sendDiscoveredRequest("lease.acquire", { requestedPetId: leaseOptions?.requestedPetId }, options),
     heartbeatLease: (leaseId) => sendDiscoveredRequest("lease.heartbeat", { leaseId }, options),
     releaseLease: (leaseId) => sendDiscoveredRequest("lease.release", { leaseId }, options),
-    react: (reaction, reactOptions) => sendDiscoveredRequest("pet.react", { reaction: validateReaction(reaction), leaseId: reactOptions?.leaseId }, options),
-    say: (message, sayOptions) => sendDiscoveredRequest("pet.say", { message, reaction: sayOptions?.reaction, leaseId: sayOptions?.leaseId }, options),
+    react: (reaction, reactOptions) => sendDiscoveredRequest("familiar.react", { reaction: validateReaction(reaction), leaseId: reactOptions?.leaseId }, options),
+    say: (message, sayOptions) => sendDiscoveredRequest("familiar.say", { message, reaction: sayOptions?.reaction, leaseId: sayOptions?.leaseId }, options),
     listMemories: async (memoryOptions) => parseMemoryListResult(await sendDiscoveredRequest("memory.list", { limit: memoryOptions?.limit }, options)),
     searchMemories: async (query, memoryOptions) => parseMemorySearchResult(await sendDiscoveredRequest("memory.search", { query, limit: memoryOptions?.limit }, options)),
     storeMemory: async (input) => parseMemoryStoreResult(await sendDiscoveredRequest("memory.store", input, options)),
@@ -136,9 +136,9 @@ export function createOpenPetsClient(options: OpenPetsClientOptions = {}): OpenP
   };
 }
 
-export function parseMemoryListResult(value: unknown): OpenPetsMemoryListResult {
+export function parseMemoryListResult(value: unknown): FamiliarOSMemoryListResult {
   if (!isRecord(value) || value.ok !== true || !Array.isArray(value.memories)) {
-    throw new OpenPetsClientError("invalid_response", "OpenPets memory list response is invalid.");
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS memory list response is invalid.");
   }
   return {
     ok: true,
@@ -146,9 +146,9 @@ export function parseMemoryListResult(value: unknown): OpenPetsMemoryListResult
   };
 }
 
-export function parseMemorySearchResult(value: unknown): OpenPetsMemorySearchResult {
+export function parseMemorySearchResult(value: unknown): FamiliarOSMemorySearchResult {
   if (!isRecord(value) || value.ok !== true || typeof value.query !== "string" || !Array.isArray(value.memories)) {
-    throw new OpenPetsClientError("invalid_response", "OpenPets memory search response is invalid.");
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS memory search response is invalid.");
   }
   return {
     ok: true,
@@ -157,9 +157,9 @@ export function parseMemorySearchResult(value: unknown): OpenPetsMemorySearchRes
   };
 }
 
-export function parseMemoryStoreResult(value: unknown): OpenPetsMemoryStoreResult {
+export function parseMemoryStoreResult(value: unknown): FamiliarOSMemoryStoreResult {
   if (!isRecord(value) || value.ok !== true) {
-    throw new OpenPetsClientError("invalid_response", "OpenPets memory store response is invalid.");
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS memory store response is invalid.");
   }
   return {
     ok: true,
@@ -167,9 +167,9 @@ export function parseMemoryStoreResult(value: unknown): OpenPetsMemoryStoreResul
   };
 }
 
-export function parseMemoryDeleteResult(value: unknown): OpenPetsMemoryDeleteResult {
+export function parseMemoryDeleteResult(value: unknown): FamiliarOSMemoryDeleteResult {
   if (!isRecord(value) || value.ok !== true || typeof value.id !== "string" || typeof value.deleted !== "boolean") {
-    throw new OpenPetsClientError("invalid_response", "OpenPets memory delete response is invalid.");
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS memory delete response is invalid.");
   }
   return {
     ok: true,
@@ -178,41 +178,41 @@ export function parseMemoryDeleteResult(value: unknown): OpenPetsMemoryDeleteRes
   };
 }
 
-export function parsePetInstallResult(value: unknown): OpenPetsPetInstallResult {
+export function parsePetInstallResult(value: unknown): FamiliarOSPetInstallResult {
   if (!isRecord(value) || value.ok !== true || typeof value.petId !== "string" || typeof value.displayName !== "string" || value.installed !== true) {
-    throw new OpenPetsClientError("invalid_response", "OpenPets pet install response is invalid.");
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS familiar install response is invalid.");
   }
   return { ok: true, petId: value.petId, displayName: value.displayName, installed: true };
 }
 
 function validatePetId(value: string): string {
   if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(value) || value === "builtin") {
-    throw new OpenPetsClientError("invalid_pet_id", "Invalid OpenPets pet id.");
+    throw new FamiliarOSClientError("invalid_pet_id", "Invalid FamiliarOS familiar id.");
   }
   return value;
 }
 
-export function parsePetListResult(value: unknown): OpenPetsPetListResult {
-  if (!isRecord(value) || value.ok !== true || !Array.isArray(value.pets) || typeof value.defaultPetId !== "string") {
-    throw new OpenPetsClientError("invalid_response", "OpenPets pet list response is invalid.");
+export function parsePetListResult(value: unknown): FamiliarOSPetListResult {
+  if (!isRecord(value) || value.ok !== true || !Array.isArray(value.familiars) || typeof value.defaultPetId !== "string") {
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS familiar list response is invalid.");
   }
   return {
     ok: true,
     defaultPetId: value.defaultPetId,
-    pets: value.pets.map(parsePetListItem),
+    familiars: value.familiars.map(parsePetListItem),
   };
 }
 
-function parsePetListItem(value: unknown): OpenPetsPetListItem {
+function parsePetListItem(value: unknown): FamiliarOSPetListItem {
   if (!isRecord(value) || typeof value.id !== "string" || typeof value.displayName !== "string" || typeof value.builtIn !== "boolean" || typeof value.broken !== "boolean") {
-    throw new OpenPetsClientError("invalid_response", "OpenPets pet list item is invalid.");
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS familiar list item is invalid.");
   }
   return { id: value.id, displayName: value.displayName, builtIn: value.builtIn, broken: value.broken };
 }
 
-function parseMemorySearchHit(value: unknown): OpenPetsMemorySearchHit {
+function parseMemorySearchHit(value: unknown): FamiliarOSMemorySearchHit {
   if (!isRecord(value) || typeof value.score !== "number") {
-    throw new OpenPetsClientError("invalid_response", "OpenPets memory search hit is invalid.");
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS memory search hit is invalid.");
   }
   return {
     entry: parseMemoryEntry(value.entry),
@@ -220,7 +220,7 @@ function parseMemorySearchHit(value: unknown): OpenPetsMemorySearchHit {
   };
 }
 
-function parseMemoryEntry(value: unknown): OpenPetsMemoryEntry {
+function parseMemoryEntry(value: unknown): FamiliarOSMemoryEntry {
   if (!isRecord(value)
     || typeof value.id !== "string"
     || typeof value.text !== "string"
@@ -232,7 +232,7 @@ function parseMemoryEntry(value: unknown): OpenPetsMemoryEntry {
     || typeof value.lastAccessedAt !== "number"
     || typeof value.accessCount !== "number"
     || (value.source !== "chat" && value.source !== "mcp")) {
-    throw new OpenPetsClientError("invalid_response", "OpenPets memory entry is invalid.");
+    throw new FamiliarOSClientError("invalid_response", "FamiliarOS memory entry is invalid.");
   }
 
   const tags = value.tags
@@ -255,13 +255,13 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null;
 }
 
-async function sendDiscoveredRequest<T>(method: OpenPetsIpcMethod, params: unknown, options: OpenPetsClientOptions): Promise<T> {
+async function sendDiscoveredRequest<T>(method: FamiliarOSIpcMethod, params: unknown, options: FamiliarOSClientOptions): Promise<T> {
   const discovery = readDiscoveryFile(options.discoveryPath);
   return sendRequest<T>(discovery, method, params, options);
 }
 
-export function sendRequest<T>(discovery: OpenPetsDiscoveryFile, method: OpenPetsIpcMethod, params: unknown, options: OpenPetsClientOptions = {}): Promise<T> {
-  const request: OpenPetsIpcRequest = {
+export function sendRequest<T>(discovery: FamiliarOSDiscoveryFile, method: FamiliarOSIpcMethod, params: unknown, options: FamiliarOSClientOptions = {}): Promise<T> {
+  const request: FamiliarOSIpcRequest = {
     id: randomUUID(),
     version: openPetsIpcVersion,
     token: discovery.token,
@@ -271,7 +271,7 @@ export function sendRequest<T>(discovery: OpenPetsDiscoveryFile, method: OpenPet
 
   const requestLine = `${JSON.stringify(request)}\n`;
   if (Buffer.byteLength(requestLine, "utf8") > maxIpcMessageBytes) {
-    return Promise.reject(new OpenPetsClientError("request_too_large", "OpenPets IPC request is too large."));
+    return Promise.reject(new FamiliarOSClientError("request_too_large", "FamiliarOS IPC request is too large."));
   }
 
   return new Promise<T>((resolve, reject) => {
@@ -280,8 +280,8 @@ export function sendRequest<T>(discovery: OpenPetsDiscoveryFile, method: OpenPet
     let buffer = "";
     let settled = false;
 
-    const connectTimer = setTimeout(() => finish(new OpenPetsClientError("connect_timeout", "Timed out connecting to OpenPets.")), options.connectTimeoutMs ?? connectTimeoutMs);
-    const responseTimer = setTimeout(() => finish(new OpenPetsClientError("response_timeout", "Timed out waiting for OpenPets response.")), options.responseTimeoutMs ?? responseTimeoutMs);
+    const connectTimer = setTimeout(() => finish(new FamiliarOSClientError("connect_timeout", "Timed out connecting to FamiliarOS.")), options.connectTimeoutMs ?? connectTimeoutMs);
+    const responseTimer = setTimeout(() => finish(new FamiliarOSClientError("response_timeout", "Timed out waiting for FamiliarOS response.")), options.responseTimeoutMs ?? responseTimeoutMs);
 
     const finish = (error?: unknown, result?: T): void => {
       if (settled) return;
@@ -301,7 +301,7 @@ export function sendRequest<T>(discovery: OpenPetsDiscoveryFile, method: OpenPet
     socket.on("data", (chunk) => {
       buffer += chunk;
       if (Buffer.byteLength(buffer, "utf8") > maxIpcMessageBytes) {
-        finish(new OpenPetsClientError("response_too_large", "OpenPets IPC response is too large."));
+        finish(new FamiliarOSClientError("response_too_large", "FamiliarOS IPC response is too large."));
         return;
       }
 
@@ -311,14 +311,14 @@ export function sendRequest<T>(discovery: OpenPetsDiscoveryFile, method: OpenPet
       try {
         const parsed = parseIpcResponse<T>(JSON.parse(buffer.slice(0, newline)) as unknown);
         if (parsed.ok) finish(undefined, parsed.result);
-        else finish(new OpenPetsClientError(parsed.error.code, parsed.error.message));
+        else finish(new FamiliarOSClientError(parsed.error.code, parsed.error.message));
       } catch (error) {
         finish(error);
       }
     });
-    socket.once("error", (error) => finish(new OpenPetsClientError("unavailable", error.message)));
+    socket.once("error", (error) => finish(new FamiliarOSClientError("unavailable", error.message)));
     socket.once("end", () => {
-      if (!settled) finish(new OpenPetsClientError("connection_closed", "OpenPets closed the IPC connection before responding."));
+      if (!settled) finish(new FamiliarOSClientError("connection_closed", "FamiliarOS closed the IPC connection before responding."));
     });
   });
 }
diff --git a/packages/client/src/protocol.ts b/packages/client/src/protocol.ts
index f4bdd3a9..2e258e4a 100644
--- a/packages/client/src/protocol.ts
+++ b/packages/client/src/protocol.ts
@@ -1,4 +1,4 @@
-export const openPetsIpcProtocol = "openpets-ipc";
+export const openPetsIpcProtocol = "familiaros-ipc";
 export const openPetsIpcVersion = 1;
 export const maxIpcMessageBytes = 16 * 1024;
 export const connectTimeoutMs = 2_000;
@@ -18,25 +18,25 @@ export const allowedReactions = [
   "celebrating",
 ] as const;
 
-export type OpenPetsReaction = typeof allowedReactions[number];
-export type OpenPetsMemoryKind = "identity" | "preference" | "fact" | "note";
-export type OpenPetsIpcMethod = "hello" | "status" | "pets.list" | "pets.install" | "lease.acquire" | "lease.heartbeat" | "lease.release" | "pet.react" | "pet.say" | "memory.list" | "memory.search" | "memory.store" | "memory.delete";
+export type FamiliarOSReaction = typeof allowedReactions[number];
+export type FamiliarOSMemoryKind = "identity" | "preference" | "fact" | "note";
+export type FamiliarOSIpcMethod = "hello" | "status" | "familiars.list" | "familiars.install" | "lease.acquire" | "lease.heartbeat" | "lease.release" | "familiar.react" | "familiar.say" | "memory.list" | "memory.search" | "memory.store" | "memory.delete";
 
-export interface OpenPetsIpcRequest {
+export interface FamiliarOSIpcRequest {
   readonly id: string;
   readonly version: 1;
   readonly token: string;
-  readonly method: OpenPetsIpcMethod;
+  readonly method: FamiliarOSIpcMethod;
   readonly params?: unknown;
 }
 
-export interface OpenPetsIpcOkResponse<T = unknown> {
+export interface FamiliarOSIpcOkResponse<T = unknown> {
   readonly id: string | null;
   readonly ok: true;
   readonly result: T;
 }
 
-export interface OpenPetsIpcErrorResponse {
+export interface FamiliarOSIpcErrorResponse {
   readonly id: string | null;
   readonly ok: false;
   readonly error: {
@@ -45,11 +45,11 @@ export interface OpenPetsIpcErrorResponse {
   };
 }
 
-export type OpenPetsIpcResponse<T = unknown> = OpenPetsIpcOkResponse<T> | OpenPetsIpcErrorResponse;
+export type FamiliarOSIpcResponse<T = unknown> = FamiliarOSIpcOkResponse<T> | FamiliarOSIpcErrorResponse;
 
-export function parseIpcResponse<T = unknown>(value: unknown): OpenPetsIpcResponse<T> {
-  if (!isRecord(value)) throw new OpenPetsClientError("invalid_response", "IPC response must be an object.");
-  if (typeof value.id !== "string" && value.id !== null) throw new OpenPetsClientError("invalid_response", "IPC response id is invalid.");
+export function parseIpcResponse<T = unknown>(value: unknown): FamiliarOSIpcResponse<T> {
+  if (!isRecord(value)) throw new FamiliarOSClientError("invalid_response", "IPC response must be an object.");
+  if (typeof value.id !== "string" && value.id !== null) throw new FamiliarOSClientError("invalid_response", "IPC response id is invalid.");
 
   if (value.ok === true) {
     return { id: value.id, ok: true, result: value.result as T };
@@ -59,17 +59,17 @@ export function parseIpcResponse<T = unknown>(value: unknown): OpenPetsIpcRespon
     return { id: value.id, ok: false, error: { code: value.error.code, message: value.error.message } };
   }
 
-  throw new OpenPetsClientError("invalid_response", "IPC response shape is invalid.");
+  throw new FamiliarOSClientError("invalid_response", "IPC response shape is invalid.");
 }
 
-export function validateReaction(value: string): OpenPetsReaction {
-  if (!allowedReactions.includes(value as OpenPetsReaction)) {
-    throw new OpenPetsClientError("invalid_reaction", "Invalid OpenPets reaction.");
+export function validateReaction(value: string): FamiliarOSReaction {
+  if (!allowedReactions.includes(value as FamiliarOSReaction)) {
+    throw new FamiliarOSClientError("invalid_reaction", "Invalid FamiliarOS reaction.");
   }
-  return value as OpenPetsReaction;
+  return value as FamiliarOSReaction;
 }
 
-export class OpenPetsClientError extends Error {
+export class FamiliarOSClientError extends Error {
   constructor(readonly code: string, message: string) {
     super(message);
   }
diff --git a/packages/client/src/smoke.ts b/packages/client/src/smoke.ts
index 4dcd4acb..a41e32f2 100644
--- a/packages/client/src/smoke.ts
+++ b/packages/client/src/smoke.ts
@@ -1,7 +1,7 @@
-import { createOpenPetsClient } from "./index.js";
-import { validateReaction, type OpenPetsReaction } from "./protocol.js";
+import { createFamiliarOSClient } from "./index.js";
+import { validateReaction, type FamiliarOSReaction } from "./protocol.js";
 
-const client = createOpenPetsClient();
+const client = createFamiliarOSClient();
 const [command = "status", first, second] = process.argv.slice(2);
 
 try {
@@ -12,7 +12,7 @@ try {
       : command === "react"
         ? await client.react(validateReaction(first ?? "idle"))
         : command === "say"
-          ? await client.say(first ?? "Working on it", second ? { reaction: validateReaction(second) as OpenPetsReaction } : undefined)
+          ? await client.say(first ?? "Working on it", second ? { reaction: validateReaction(second) as FamiliarOSReaction } : undefined)
           : command === "invalid-token"
             ? await runInvalidTokenCheck()
             : await client.status();
diff --git a/packages/codemap.md b/packages/codemap.md
index e6657e1b..0191a409 100644
--- a/packages/codemap.md
+++ b/packages/codemap.md
@@ -1,20 +1,20 @@
 # packages/
 
-Monorepo workspace containing all OpenPets npm packages. Each package is independently publishable with its own versioning.
+Monorepo workspace containing all FamiliarOS npm packages. Each package is independently publishable with its own versioning.
 
 ## Responsibility
 
-Provides modular, reusable components for the OpenPets ecosystem:
-- **pet-format**: Package marker interface for type identification
+Provides modular, reusable components for the FamiliarOS ecosystem:
+- **familiar-format**: Package marker interface for type identification
 - **agent-events**: Speech pools and validation for agent feedback messages
-- **client**: Core IPC client for communicating with OpenPets desktop app
-- **cli**: Main CLI tool for configuring agents and managing pets
+- **client**: Core IPC client for communicating with FamiliarOS desktop app
+- **cli**: Main CLI tool for configuring agents and managing familiars
 - **mcp**: MCP server implementation for agent integration
 - **opencode**: OpenCode editor integration (plugin, config management)
 - **claude**: Claude Code integration (hooks, MCP config)
 - **cursor**: Cursor editor integration (MCP config, project rules)
 - **pi**: Pi coding-agent extension integration (event hooks, slash commands)
-- **install-pet**: Standalone pet installer from gallery catalog
+- **install-familiar**: Standalone familiar installer from gallery catalog
 
 ## Design/Patterns
 
@@ -35,27 +35,27 @@ Provides modular, reusable components for the OpenPets ecosystem:
 
 ```
 CLI Entry (packages/cli/src/index.ts)
-    ├── Configures Claude → @open-pets/claude
-    ├── Configures OpenCode → @open-pets/opencode
-    ├── Configures Cursor → @open-pets/cursor
-    ├── Spawns MCP server → @open-pets/mcp
-    └── Uses IPC client → @open-pets/client
+    ├── Configures Claude → @familiaros/claude
+    ├── Configures OpenCode → @familiaros/opencode
+    ├── Configures Cursor → @familiaros/cursor
+    ├── Spawns MCP server → @familiaros/mcp
+    └── Uses IPC client → @familiaros/client
 
 MCP Server (packages/mcp/src/index.ts)
     ├── Registers tools (status, react, say)
-    └── Communicates via @open-pets/client
+    └── Communicates via @familiaros/client
 
 OpenCode Plugin (packages/opencode/src/plugin.ts)
-    └── Hooks into editor events → @open-pets/client
+    └── Hooks into editor events → @familiaros/client
 
 Claude Hooks (packages/claude/src/hooks.ts)
-    └── Processes hook events → @open-pets/client
+    └── Processes hook events → @familiaros/client
 
 Cursor Setup (packages/cursor/src/cursor-project-setup.ts)
-    └── Writes MCP config + rules → @open-pets/client
+    └── Writes MCP config + rules → @familiaros/client
 
 Pi Extension (packages/pi/src/extension.ts)
-    └── Registers Pi extension hooks/commands → @open-pets/client
+    └── Registers Pi extension hooks/commands → @familiaros/client
 ```
 
 ## Integration Points
@@ -67,13 +67,13 @@ Pi Extension (packages/pi/src/extension.ts)
 - `opencode` depends on: `client`, `agent-events`
 - `cursor` depends on: `client`
 - `pi` depends on: `client`, `agent-events` and declares optional `@earendil-works/pi-coding-agent` peer support
-- `install-pet` depends on: `client`
+- `install-familiar` depends on: `client`
 
 **External Integrations**:
 - `@modelcontextprotocol/sdk` - MCP protocol implementation
 - `jsonc-parser` - JSON with comments parsing for OpenCode configs
-- `yauzl` - ZIP extraction for pet downloads
+- `yauzl` - ZIP extraction for familiar downloads
 - `zod` - Schema validation in MCP tools
 
 **Desktop App Communication**:
-All packages ultimately communicate with the OpenPets desktop app via the IPC protocol defined in `client/src/protocol.ts`, supporting Unix sockets, Windows named pipes, and TCP (for WSL cross-platform).
+All packages ultimately communicate with the FamiliarOS desktop app via the IPC protocol defined in `client/src/protocol.ts`, supporting Unix sockets, Windows named pipes, and TCP (for WSL cross-platform).
diff --git a/packages/cursor/codemap.md b/packages/cursor/codemap.md
index 518b7c57..37a24745 100644
--- a/packages/cursor/codemap.md
+++ b/packages/cursor/codemap.md
@@ -1,15 +1,15 @@
-# Package: @open-pets/cursor
+# Package: @familiaros/cursor
 
 ## Responsibility
 
-Pure Node.js package for Cursor editor integration file management. Manages OpenPets MCP entries in Cursor's `mcp.json` configuration files and optional project-local Cursor rules guidance. Provides safe, atomic file operations with validation, backup, and redaction capabilities.
+Pure Node.js package for Cursor editor integration file management. Manages FamiliarOS MCP entries in Cursor's `mcp.json` configuration files and optional project-local Cursor rules guidance. Provides safe, atomic file operations with validation, backup, and redaction capabilities.
 
 ## Design/Patterns
 
 ### Config Path Resolution
 - **Global config**: `<homeDir>/.cursor/mcp.json` - user-wide MCP settings
 - **Project config**: `<projectDir>/.cursor/mcp.json` - project-specific MCP settings
-- **Rules path**: `<projectDir>/.cursor/rules/openpets.mdc` - project-local Cursor rules
+- **Rules path**: `<projectDir>/.cursor/rules/familiaros.mdc` - project-local Cursor rules
 - All APIs accept explicit `configPath` for custom locations
 
 ### Safety-First File Operations
@@ -23,10 +23,10 @@ Pure Node.js package for Cursor editor integration file management. Manages Open
 - Private file permissions (0o600) where supported
 
 ### Status Classification (MCP & Rules)
-- `missing`: No config file or no OpenPets entry exists
-- `installed`: Matching OpenPets entry present and up-to-date
-- `needs-update`: Old version, different pet, or content drift
-- `conflict`: Non-OpenPets entry blocking installation
+- `missing`: No config file or no FamiliarOS entry exists
+- `installed`: Matching FamiliarOS entry present and up-to-date
+- `needs-update`: Old version, different familiar, or content drift
+- `conflict`: Non-FamiliarOS entry blocking installation
 - `invalid`: Parse error, oversized, unsafe path, malformed schema
 - `error`: Unexpected I/O failure
 
@@ -35,14 +35,14 @@ Pure Node.js package for Cursor editor integration file management. Manages Open
 {
   "type": "stdio",
   "command": "npx",
-  "args": ["-y", "@open-pets/mcp@VERSION", "--pet", "PET_ID"]
+  "args": ["-y", "@familiaros/mcp@VERSION", "--familiar", "PET_ID"]
 }
 ```
 
 ### Managed Entry Detection
-- Published mode: `npx -y @open-pets/mcp@SEMVER [--pet PET]`
-- Local mode: `node <absolute-path> [--pet PET]`
-- Validates semantic versioning and pet ID format
+- Published mode: `npx -y @familiaros/mcp@SEMVER [--familiar PET]`
+- Local mode: `node <absolute-path> [--familiar PET]`
+- Validates semantic versioning and familiar ID format
 - Rejects unpinned versions (e.g., `@latest`)
 
 ### Sensitive Data Redaction
@@ -53,7 +53,7 @@ Recursive, case-insensitive redaction of:
 
 ### Cursor Rules Management
 - Exact whole-file ownership requires recognized frontmatter
-- Requires exactly one ordered `OPENPETS:CURSOR_RULES:START/END` marker pair
+- Requires exactly one ordered `FAMILIAROS:CURSOR_RULES:START/END` marker pair
 - Rejects duplicate, reversed, or missing markers
 - Rejects user content before/after managed block
 - Desktop uses preview/copy only; CLI writes project-local rules
@@ -75,20 +75,20 @@ Recursive, case-insensitive redaction of:
 
 ### MCP Removal Flow
 1. Read and classify existing config
-2. Verify entry is managed by OpenPets (not conflict)
+2. Verify entry is managed by FamiliarOS (not conflict)
 3. Plan remove via `planCursorMcpRemove(path)`
-4. Execute removes only `mcpServers.openpets`, preserves other servers
+4. Execute removes only `mcpServers.familiaros`, preserves other servers
 5. Empty `mcpServers` kept as `{}` after removal
 
 ### Rules Installation Flow
-1. **Read** existing rules via `readCursorOpenPetsRules(projectDir)`
+1. **Read** existing rules via `readCursorFamiliarOSRules(projectDir)`
 2. **Classify** status via `classifyCursorRulesStatus(result, path, expected?)`
 3. **Plan** via `planCursorRulesInstall(projectDir, allowReplace?)`
 4. **Execute** via `executeCursorRulesWrite(plan)`
 5. Managed content includes frontmatter + START/END markers
 
 ### Preview/Redaction Flow
-1. Build preview via `buildOpenPetsOnlyPreview(options)`
+1. Build preview via `buildFamiliarOSOnlyPreview(options)`
 2. Redact sensitive config via `redactCursorConfig(config)`
 3. Safe for logging and UI display
 
@@ -106,11 +106,11 @@ Recursive, case-insensitive redaction of:
 
 **From cursor-mcp.ts:**
 - `buildCursorMcpEntry(options)`: Build MCP entry object
-- `formatCursorMcpConfig(options)`: Build full config with openpets entry
+- `formatCursorMcpConfig(options)`: Build full config with familiaros entry
 - `getCursorGlobalMcpPath(homeDir)`: Get global config path
 - `getCursorProjectMcpPath(projectDir)`: Get project config path
-- `validateOpenPetsPetId(id)`: Validate and return pet ID
-- `isValidPetId(id)`: Check if pet ID is valid
+- `validateFamiliarOSPetId(id)`: Validate and return familiar ID
+- `isValidPetId(id)`: Check if familiar ID is valid
 
 **From cursor-status.ts:**
 - `classifyCursorMcpStatus(result, path, expected)`: Classify config status
@@ -119,24 +119,24 @@ Recursive, case-insensitive redaction of:
 - `planCursorMcpReplace(path, options)`: Plan replace operation
 - `planCursorMcpRemove(path)`: Plan remove operation
 - `executeCursorMcpWrite(plan)`: Execute planned write atomically
-- `isManagedOpenPetsMcpEntry(value)`: Check if entry is OpenPets-managed
+- `isManagedFamiliarOSMcpEntry(value)`: Check if entry is FamiliarOS-managed
 - `maxCursorConfigBytes`: 256 KiB limit constant
 
 **From cursor-previews.ts:**
-- `buildOpenPetsOnlyPreview(options)`: Build OpenPets-only preview
+- `buildFamiliarOSOnlyPreview(options)`: Build FamiliarOS-only preview
 - `redactCursorConfig(config)`: Redact sensitive fields from config
 
 **From cursor-rules.ts:**
 - `getCursorProjectRulesPath(projectDir)`: Get project rules path
-- `buildCursorOpenPetsRule()`: Build managed Cursor rules content
+- `buildCursorFamiliarOSRule()`: Build managed Cursor rules content
 - `buildCursorRulesPreview()`: Build copyable rules preview
-- `readCursorOpenPetsRules(projectDir)`: Safely read managed rules file
+- `readCursorFamiliarOSRules(projectDir)`: Safely read managed rules file
 - `classifyCursorRulesStatus(result, path, expected?)`: Classify rules status
 - `planCursorRulesInstall(projectDir, allowReplace?)`: Plan project rules install/update
 - `planCursorRulesReplace(projectDir)`: Plan explicit replacement
 - `planCursorRulesRemove(projectDir)`: Plan managed rules removal
 - `executeCursorRulesWrite(plan)`: Execute rules write/remove atomically
-- `isManagedCursorOpenPetsRule(content)`: Check managed marker/frontmatter shape
+- `isManagedCursorFamiliarOSRule(content)`: Check managed marker/frontmatter shape
 - `maxCursorRulesBytes`: 64 KiB limit constant
 
 ### Package Scripts
@@ -152,7 +152,7 @@ Recursive, case-insensitive redaction of:
 
 ### Test Coverage
 `check-cursor.ts` validates:
-- Pet ID validation (valid/invalid patterns, length limits)
+- Familiar ID validation (valid/invalid patterns, length limits)
 - MCP entry building (published/local modes, version validation)
 - Config formatting and path helpers
 - All status classifications (missing, empty, installed, needs-update, conflict, invalid)
diff --git a/packages/cursor/package.json b/packages/cursor/package.json
index 7b904304..444b0d0d 100644
--- a/packages/cursor/package.json
+++ b/packages/cursor/package.json
@@ -1,10 +1,10 @@
 {
-  "name": "@open-pets/cursor",
+  "name": "@familiaros/cursor",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/cursor"
   },
   "type": "module",
diff --git a/packages/cursor/src/check-cursor.ts b/packages/cursor/src/check-cursor.ts
index d5b33fce..aa327dbe 100644
--- a/packages/cursor/src/check-cursor.ts
+++ b/packages/cursor/src/check-cursor.ts
@@ -4,19 +4,19 @@ import { join } from "node:path";
 import { tmpdir } from "node:os";
 
 import {
-  buildCursorOpenPetsRule,
+  buildCursorFamiliarOSRule,
   buildCursorRulesPreview,
   classifyCursorRulesStatus,
   cursorRulesEndMarker,
   cursorRulesStartMarker,
   executeCursorRulesWrite,
   getCursorProjectRulesPath,
-  isManagedCursorOpenPetsRule,
+  isManagedCursorFamiliarOSRule,
   maxCursorRulesBytes,
   planCursorRulesInstall,
   planCursorRulesRemove,
   planCursorRulesReplace,
-  readCursorOpenPetsRules,
+  readCursorFamiliarOSRules,
 } from "./cursor-rules.js";
 import {
   buildCursorMcpEntry,
@@ -24,7 +24,7 @@ import {
   getCursorGlobalMcpPath,
   getCursorProjectMcpPath,
   isValidPetId,
-  validateOpenPetsPetId,
+  validateFamiliarOSPetId,
 } from "./cursor-mcp.js";
 import {
   classifyCursorMcpStatus,
@@ -35,12 +35,12 @@ import {
   planCursorMcpReplace,
   readCursorMcpConfig,
 } from "./cursor-status.js";
-import { buildOpenPetsOnlyPreview, redactCursorConfig } from "./cursor-previews.js";
+import { buildFamiliarOSOnlyPreview, redactCursorConfig } from "./cursor-previews.js";
 
-const root = realpathSync(mkdtempSync(join(tmpdir(), "openpets-cursor-")));
+const root = realpathSync(mkdtempSync(join(tmpdir(), "familiaros-cursor-")));
 
 try {
-  // Test pet ID validation
+  // Test familiar ID validation
   assert.equal(isValidPetId("fixer"), true);
   assert.equal(isValidPetId("my_pet-123"), true);
   assert.equal(isValidPetId("a"), true);
@@ -50,23 +50,23 @@ try {
   assert.equal(isValidPetId("_invalid"), false);
   assert.equal(isValidPetId("invalid/slash"), false);
   assert.equal(isValidPetId("a".repeat(65)), false);
-  assert.equal(validateOpenPetsPetId("fixer"), "fixer");
-  assert.throws(() => validateOpenPetsPetId("bad/pet"));
-  assert.throws(() => validateOpenPetsPetId(""));
+  assert.equal(validateFamiliarOSPetId("fixer"), "fixer");
+  assert.throws(() => validateFamiliarOSPetId("bad/familiar"));
+  assert.throws(() => validateFamiliarOSPetId(""));
 
   // Test MCP entry building
   const publishedEntry = buildCursorMcpEntry({ mcpVersion: "2.0.6", petId: "fixer" });
   assert.deepEqual(publishedEntry, {
     type: "stdio",
     command: "npx",
-    args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"],
+    args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"],
   });
 
   const publishedNoPet = buildCursorMcpEntry({ mcpVersion: "2.0.6" });
   assert.deepEqual(publishedNoPet, {
     type: "stdio",
     command: "npx",
-    args: ["-y", "@open-pets/mcp@2.0.6"],
+    args: ["-y", "@familiaros/mcp@2.0.6"],
   });
   assert.throws(() => buildCursorMcpEntry({ mcpVersion: "latest" }));
 
@@ -79,7 +79,7 @@ try {
   assert.deepEqual(localEntry, {
     type: "stdio",
     command: "node",
-    args: [join(root, "mcp.js"), "--pet", "helper"],
+    args: [join(root, "mcp.js"), "--familiar", "helper"],
   });
 
   assert.throws(() => buildCursorMcpEntry({ mcpVersion: "2.0.6", commandMode: "local", mcpEntryPath: "relative.js" }));
@@ -88,10 +88,10 @@ try {
   const formatted = formatCursorMcpConfig({ mcpVersion: "2.0.6", petId: "fixer" });
   assert.deepEqual(formatted, {
     mcpServers: {
-      openpets: {
+      familiaros: {
         type: "stdio",
         command: "npx",
-        args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"],
+        args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"],
       },
     },
   });
@@ -177,8 +177,8 @@ try {
   assert.equal(oldVersionStatus.canReplace, true);
   assert.equal(oldVersionStatus.canRemove, true);
 
-  // Test needs-update status for different pet
-  const diffPetDir = join(root, "diff-pet");
+  // Test needs-update status for different familiar
+  const diffPetDir = join(root, "diff-familiar");
   mkdirSync(diffPetDir);
   const diffPetPath = join(diffPetDir, "mcp.json");
   const diffPetConfig = formatCursorMcpConfig({ mcpVersion: "2.0.6", petId: "helper" });
@@ -188,13 +188,13 @@ try {
   const diffPetStatus = classifyCursorMcpStatus(diffPetResult, diffPetPath, { mcpVersion: "2.0.6", petId: "fixer" });
   assert.equal(diffPetStatus.status, "needs-update");
 
-  // Test conflict status for non-OpenPets openpets entry
+  // Test conflict status for non-FamiliarOS familiaros entry
   const conflictDir = join(root, "conflict");
   mkdirSync(conflictDir);
   const conflictPath = join(conflictDir, "mcp.json");
   const conflictConfig = {
     mcpServers: {
-      openpets: { type: "stdio", command: "custom", args: ["mcp"] },
+      familiaros: { type: "stdio", command: "custom", args: ["mcp"] },
     },
   };
   writeFileSync(conflictPath, JSON.stringify(conflictConfig, null, 2), "utf8");
@@ -209,7 +209,7 @@ try {
   const unpinnedDir = join(root, "unpinned");
   mkdirSync(unpinnedDir);
   const unpinnedPath = join(unpinnedDir, "mcp.json");
-  writeFileSync(unpinnedPath, JSON.stringify({ mcpServers: { openpets: { type: "stdio", command: "npx", args: ["-y", "@open-pets/mcp@latest"] } } }), "utf8");
+  writeFileSync(unpinnedPath, JSON.stringify({ mcpServers: { familiaros: { type: "stdio", command: "npx", args: ["-y", "@familiaros/mcp@latest"] } } }), "utf8");
   const unpinnedStatus = classifyCursorMcpStatus(readCursorMcpConfig(unpinnedPath), unpinnedPath, { mcpVersion: "2.0.6" });
   assert.equal(unpinnedStatus.status, "conflict");
 
@@ -310,11 +310,11 @@ try {
     assert.equal(badServersResult.reason, "invalid-schema");
   }
 
-  // Test malformed mcpServers.openpets (not an object)
+  // Test malformed mcpServers.familiaros (not an object)
   const malformedEntryDir = join(root, "malformed-entry");
   mkdirSync(malformedEntryDir);
   const malformedEntryPath = join(malformedEntryDir, "mcp.json");
-  writeFileSync(malformedEntryPath, JSON.stringify({ mcpServers: { openpets: "string" } }), "utf8");
+  writeFileSync(malformedEntryPath, JSON.stringify({ mcpServers: { familiaros: "string" } }), "utf8");
 
   const malformedEntryResult = readCursorMcpConfig(malformedEntryPath);
   assert.equal(malformedEntryResult.ok, true);
@@ -350,20 +350,20 @@ try {
     executeCursorMcpWrite(atomicPlan);
     assert.equal(existsSync(atomicPath), true);
     const writtenContent = JSON.parse(readFileSync(atomicPath, "utf8"));
-    assert.deepEqual(writtenContent.mcpServers.openpets, {
+    assert.deepEqual(writtenContent.mcpServers.familiaros, {
       type: "stdio",
       command: "npx",
-      args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"],
+      args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"],
     });
   }
 
-  // Test uninstall removes only OpenPets entry
+  // Test uninstall removes only FamiliarOS entry
   const uninstallDir = join(root, "uninstall");
   mkdirSync(uninstallDir);
   const uninstallPath = join(uninstallDir, "mcp.json");
   const uninstallConfig = {
     mcpServers: {
-      openpets: { type: "stdio", command: "npx", args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"] },
+      familiaros: { type: "stdio", command: "npx", args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"] },
       other: { type: "stdio", command: "test", args: [] },
     },
     otherField: "keep",
@@ -375,7 +375,7 @@ try {
   if ("targetPath" in removePlan) {
     executeCursorMcpWrite(removePlan);
     const removedContent = JSON.parse(readFileSync(uninstallPath, "utf8"));
-    assert.equal(removedContent.mcpServers.openpets, undefined);
+    assert.equal(removedContent.mcpServers.familiaros, undefined);
     assert.deepEqual(removedContent.mcpServers.other, { type: "stdio", command: "test", args: [] });
     assert.equal(removedContent.otherField, "keep");
   }
@@ -396,7 +396,7 @@ try {
   const noWriteConflictDir = join(root, "no-write-conflict");
   mkdirSync(noWriteConflictDir);
   const noWriteConflictPath = join(noWriteConflictDir, "mcp.json");
-  writeFileSync(noWriteConflictPath, JSON.stringify({ mcpServers: { openpets: { type: "stdio", command: "custom", args: [] } } }), "utf8");
+  writeFileSync(noWriteConflictPath, JSON.stringify({ mcpServers: { familiaros: { type: "stdio", command: "custom", args: [] } } }), "utf8");
 
   const noWriteConflictPlan = planCursorMcpInstall(noWriteConflictPath, { mcpVersion: "2.0.6", petId: "fixer" });
   assert.equal("ok" in noWriteConflictPlan, true);
@@ -409,13 +409,13 @@ try {
     assert.equal(noRemoveConflictPlan.ok, false);
   }
 
-  // Test explicit replace overwrites only openpets and preserves unrelated servers
+  // Test explicit replace overwrites only familiaros and preserves unrelated servers
   const replaceDir = join(root, "replace");
   mkdirSync(replaceDir);
   const replacePath = join(replaceDir, "mcp.json");
   const replaceConfig = {
     mcpServers: {
-      openpets: { type: "stdio", command: "custom", args: [] },
+      familiaros: { type: "stdio", command: "custom", args: [] },
       other: { type: "stdio", command: "test", args: [] },
     },
     topLevelField: "preserve",
@@ -427,10 +427,10 @@ try {
   if ("targetPath" in replacePlan) {
     executeCursorMcpWrite(replacePlan);
     const replacedContent = JSON.parse(readFileSync(replacePath, "utf8"));
-    assert.deepEqual(replacedContent.mcpServers.openpets, {
+    assert.deepEqual(replacedContent.mcpServers.familiaros, {
       type: "stdio",
       command: "npx",
-      args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"],
+      args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"],
     });
     assert.deepEqual(replacedContent.mcpServers.other, { type: "stdio", command: "test", args: [] });
     assert.equal(replacedContent.topLevelField, "preserve");
@@ -439,7 +439,7 @@ try {
   // Test preview redaction
   const redactedConfig = {
     mcpServers: {
-      openpets: { type: "stdio", command: "npx", args: ["-y", "@open-pets/mcp@2.0.6"] },
+      familiaros: { type: "stdio", command: "npx", args: ["-y", "@familiaros/mcp@2.0.6"] },
       other: {
         type: "stdio",
         command: "test",
@@ -451,7 +451,7 @@ try {
   };
 
   const redacted = redactCursorConfig(redactedConfig);
-  assert.deepEqual(redacted.mcpServers?.openpets, { type: "stdio", command: "npx", args: ["-y", "@open-pets/mcp@2.0.6"] });
+  assert.deepEqual(redacted.mcpServers?.familiaros, { type: "stdio", command: "npx", args: ["-y", "@familiaros/mcp@2.0.6"] });
   const otherServer = redacted.mcpServers?.other as Record<string, unknown>;
   assert.deepEqual(otherServer.args, ["--token=[REDACTED]", "--api-key=[REDACTED]"]);
   assert.equal(otherServer.env, "[REDACTED]");
@@ -498,12 +498,12 @@ try {
   assert.ok(urlArgs[0].includes("[REDACTED]"));
   assert.ok(!urlArgs[0].includes("secret"));
 
-  // Test OpenPets-only preview
-  const preview = buildOpenPetsOnlyPreview({ mcpVersion: "2.0.6", petId: "fixer" });
-  assert.deepEqual(preview.openpets, {
+  // Test FamiliarOS-only preview
+  const preview = buildFamiliarOSOnlyPreview({ mcpVersion: "2.0.6", petId: "fixer" });
+  assert.deepEqual(preview.familiaros, {
     type: "stdio",
     command: "npx",
-    args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"],
+    args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"],
   });
 
   // Test existing unrelated MCP servers preserved during install
@@ -525,10 +525,10 @@ try {
     const preservedContent = JSON.parse(readFileSync(preservePath, "utf8"));
     assert.deepEqual(preservedContent.mcpServers.other, { type: "stdio", command: "test", args: [] });
     assert.equal(preservedContent.topLevel, "keep");
-    assert.deepEqual(preservedContent.mcpServers.openpets, {
+    assert.deepEqual(preservedContent.mcpServers.familiaros, {
       type: "stdio",
       command: "npx",
-      args: ["-y", "@open-pets/mcp@2.0.6", "--pet", "fixer"],
+      args: ["-y", "@familiaros/mcp@2.0.6", "--familiar", "fixer"],
     });
   }
 
@@ -584,7 +584,7 @@ try {
   const emptyAfterRemoveDir = join(root, "empty-after-remove");
   mkdirSync(emptyAfterRemoveDir);
   const emptyAfterRemovePath = join(emptyAfterRemoveDir, "mcp.json");
-  writeFileSync(emptyAfterRemovePath, JSON.stringify({ mcpServers: { openpets: { type: "stdio", command: "npx", args: ["-y", "@open-pets/mcp@2.0.6"] } } }), "utf8");
+  writeFileSync(emptyAfterRemovePath, JSON.stringify({ mcpServers: { familiaros: { type: "stdio", command: "npx", args: ["-y", "@familiaros/mcp@2.0.6"] } } }), "utf8");
 
   const emptyRemovePlan = planCursorMcpRemove(emptyAfterRemovePath);
   assert.equal("targetPath" in emptyRemovePlan, true);
@@ -598,15 +598,15 @@ try {
   const rulesProject = join(root, "rules-project");
   mkdirSync(rulesProject);
   const rulesPath = getCursorProjectRulesPath(rulesProject);
-  assert.equal(rulesPath, join(rulesProject, ".cursor", "rules", "openpets.mdc"));
-  const expectedRule = buildCursorOpenPetsRule();
+  assert.equal(rulesPath, join(rulesProject, ".cursor", "rules", "familiaros.mdc"));
+  const expectedRule = buildCursorFamiliarOSRule();
   assert.equal(buildCursorRulesPreview(), expectedRule);
-  assert.match(expectedRule, /description: Use OpenPets MCP tools/);
+  assert.match(expectedRule, /description: Use FamiliarOS MCP tools/);
   assert.doesNotMatch(expectedRule, /alwaysApply:\s*true/);
-  assert.match(expectedRule, /openpets_say/);
+  assert.match(expectedRule, /familiaros_say/);
   assert.match(expectedRule, /Do not send prompts, tool input\/output/);
 
-  const missingRulesResult = readCursorOpenPetsRules(rulesProject);
+  const missingRulesResult = readCursorFamiliarOSRules(rulesProject);
   assert.equal(missingRulesResult.ok, true);
   if (missingRulesResult.ok) {
     assert.equal(missingRulesResult.exists, false);
@@ -624,15 +624,15 @@ try {
     assert.equal(readFileSync(rulesPath, "utf8"), expectedRule);
   }
 
-  const installedRulesStatus = classifyCursorRulesStatus(readCursorOpenPetsRules(rulesProject), rulesPath);
+  const installedRulesStatus = classifyCursorRulesStatus(readCursorFamiliarOSRules(rulesProject), rulesPath);
   assert.equal(installedRulesStatus.status, "installed");
   assert.equal(installedRulesStatus.canInstall, false);
   assert.equal(installedRulesStatus.canRemove, true);
-  assert.equal(isManagedCursorOpenPetsRule(expectedRule), true);
+  assert.equal(isManagedCursorFamiliarOSRule(expectedRule), true);
 
   const changedManagedRule = expectedRule.replace("major milestones", "meaningful milestones");
   writeFileSync(rulesPath, changedManagedRule, "utf8");
-  const needsUpdateRulesStatus = classifyCursorRulesStatus(readCursorOpenPetsRules(rulesProject), rulesPath);
+  const needsUpdateRulesStatus = classifyCursorRulesStatus(readCursorFamiliarOSRules(rulesProject), rulesPath);
   assert.equal(needsUpdateRulesStatus.status, "needs-update");
   const updateRulesPlan = planCursorRulesInstall(rulesProject);
   assert.equal("targetPath" in updateRulesPlan, true);
@@ -655,7 +655,7 @@ try {
   // Test rules conflicts and marker/frontmatter edge cases
   mkdirSync(join(rulesProject, ".cursor", "rules"), { recursive: true });
   writeFileSync(rulesPath, "User-authored Cursor rule\n", "utf8");
-  const unmanagedStatus = classifyCursorRulesStatus(readCursorOpenPetsRules(rulesProject), rulesPath);
+  const unmanagedStatus = classifyCursorRulesStatus(readCursorFamiliarOSRules(rulesProject), rulesPath);
   assert.equal(unmanagedStatus.status, "conflict");
   assert.equal(unmanagedStatus.canInstall, false);
   assert.equal(unmanagedStatus.canReplace, true);
@@ -680,14 +680,14 @@ try {
   }
 
   const duplicateMarkers = expectedRule.replace(cursorRulesEndMarker, `${cursorRulesEndMarker}\n${cursorRulesEndMarker}`);
-  const reversedMarkers = `---\ndescription: Use OpenPets MCP tools for lightweight coding-status feedback.\n---\n\n${cursorRulesEndMarker}\nbody\n${cursorRulesStartMarker}\n`;
+  const reversedMarkers = `---\ndescription: Use FamiliarOS MCP tools for lightweight coding-status feedback.\n---\n\n${cursorRulesEndMarker}\nbody\n${cursorRulesStartMarker}\n`;
   const missingMarker = expectedRule.replace(cursorRulesStartMarker, "");
   const userBefore = `User note\n${expectedRule}`;
   const userAfter = `${expectedRule}\nUser note\n`;
   const unknownFrontmatter = expectedRule.replace("---\ndescription", "---\nalwaysApply: true\ndescription");
   for (const content of [duplicateMarkers, reversedMarkers, missingMarker, userBefore, userAfter, unknownFrontmatter]) {
     writeFileSync(rulesPath, content, "utf8");
-    const status = classifyCursorRulesStatus(readCursorOpenPetsRules(rulesProject), rulesPath);
+    const status = classifyCursorRulesStatus(readCursorFamiliarOSRules(rulesProject), rulesPath);
     assert.equal(status.status, "conflict");
   }
 
@@ -695,7 +695,7 @@ try {
   const rulesFileParentProject = join(root, "rules-file-parent");
   mkdirSync(rulesFileParentProject);
   writeFileSync(join(rulesFileParentProject, ".cursor"), "not a dir", "utf8");
-  const rulesFileParentResult = readCursorOpenPetsRules(rulesFileParentProject);
+  const rulesFileParentResult = readCursorFamiliarOSRules(rulesFileParentProject);
   assert.equal(rulesFileParentResult.ok, false);
   if (!rulesFileParentResult.ok) assert.equal(rulesFileParentResult.reason, "unsafe-path");
 
@@ -704,7 +704,7 @@ try {
   mkdirSync(rulesSymlinkProject);
   mkdirSync(rulesSymlinkOutside);
   symlinkSync(rulesSymlinkOutside, join(rulesSymlinkProject, ".cursor"));
-  const rulesSymlinkResult = readCursorOpenPetsRules(rulesSymlinkProject);
+  const rulesSymlinkResult = readCursorFamiliarOSRules(rulesSymlinkProject);
   assert.equal(rulesSymlinkResult.ok, false);
   if (!rulesSymlinkResult.ok) assert.equal(rulesSymlinkResult.reason, "symlink");
 
@@ -713,7 +713,7 @@ try {
   const rulesFileSymlinkTarget = join(root, "rules-file-target.mdc");
   writeFileSync(rulesFileSymlinkTarget, expectedRule, "utf8");
   symlinkSync(rulesFileSymlinkTarget, getCursorProjectRulesPath(rulesFileSymlinkProject));
-  const rulesFileSymlinkResult = readCursorOpenPetsRules(rulesFileSymlinkProject);
+  const rulesFileSymlinkResult = readCursorFamiliarOSRules(rulesFileSymlinkProject);
   assert.equal(rulesFileSymlinkResult.ok, false);
   if (!rulesFileSymlinkResult.ok) assert.equal(rulesFileSymlinkResult.reason, "symlink");
   const rulesFileSymlinkPlan = planCursorRulesInstall(rulesFileSymlinkProject);
@@ -723,14 +723,14 @@ try {
   const danglingRulesSymlinkProject = join(root, "rules-dangling-symlink");
   mkdirSync(join(danglingRulesSymlinkProject, ".cursor", "rules"), { recursive: true });
   symlinkSync(join(root, "missing-rules-target.mdc"), getCursorProjectRulesPath(danglingRulesSymlinkProject));
-  const danglingRulesResult = readCursorOpenPetsRules(danglingRulesSymlinkProject);
+  const danglingRulesResult = readCursorFamiliarOSRules(danglingRulesSymlinkProject);
   assert.equal(danglingRulesResult.ok, false);
   if (!danglingRulesResult.ok) assert.equal(danglingRulesResult.reason, "symlink");
 
   const nonRegularRulesProject = join(root, "rules-non-regular");
   mkdirSync(join(nonRegularRulesProject, ".cursor", "rules"), { recursive: true });
   mkdirSync(getCursorProjectRulesPath(nonRegularRulesProject));
-  const nonRegularRules = readCursorOpenPetsRules(nonRegularRulesProject);
+  const nonRegularRules = readCursorFamiliarOSRules(nonRegularRulesProject);
   assert.equal(nonRegularRules.ok, false);
   if (!nonRegularRules.ok) assert.equal(nonRegularRules.reason, "not-regular");
   const nonRegularRulesInstallPlan = planCursorRulesInstall(nonRegularRulesProject);
@@ -741,7 +741,7 @@ try {
   const oversizedRulesProject = join(root, "rules-oversized");
   mkdirSync(join(oversizedRulesProject, ".cursor", "rules"), { recursive: true });
   writeFileSync(getCursorProjectRulesPath(oversizedRulesProject), "x".repeat(maxCursorRulesBytes + 1), "utf8");
-  const oversizedRules = readCursorOpenPetsRules(oversizedRulesProject);
+  const oversizedRules = readCursorFamiliarOSRules(oversizedRulesProject);
   assert.equal(oversizedRules.ok, false);
   if (!oversizedRules.ok) assert.equal(oversizedRules.reason, "size");
   const oversizedBefore = readFileSync(getCursorProjectRulesPath(oversizedRulesProject), "utf8");
diff --git a/packages/cursor/src/codemap.md b/packages/cursor/src/codemap.md
index f42f8bab..df97f82d 100644
--- a/packages/cursor/src/codemap.md
+++ b/packages/cursor/src/codemap.md
@@ -58,13 +58,13 @@ readCursorMcpConfig(path)
 classifyCursorMcpStatus(result, path, expected)
   → if !result.ok: map reason to status (invalid/error)
   → if !exists: return missing
-  → extract mcpServers.openpets
+  → extract mcpServers.familiaros
   → if undefined: return missing
   → if not isRecord: return conflict (malformed)
   → build expected entry
   → if isSameMcpEntry: return installed
-  → if isManagedOpenPetsMcpEntry: return needs-update
-  → return conflict (non-OpenPets entry)
+  → if isManagedFamiliarOSMcpEntry: return needs-update
+  → return conflict (non-FamiliarOS entry)
 ```
 
 ### Write Plan Flow (cursor-status.ts)
@@ -121,7 +121,7 @@ redactStringValue(str)
 
 ### Rules Read Flow (cursor-rules.ts)
 ```
-readCursorOpenPetsRules(projectDir)
+readCursorFamiliarOSRules(projectDir)
   → getCursorProjectRulesPath(projectDir)
   → assertSafeRulesPath(projectDir, rulesPath)
   → assertSafeExistingRulesFile(rulesPath, allowMissing=true)
diff --git a/packages/cursor/src/cursor-mcp.ts b/packages/cursor/src/cursor-mcp.ts
index cc9725e8..180d17c5 100644
--- a/packages/cursor/src/cursor-mcp.ts
+++ b/packages/cursor/src/cursor-mcp.ts
@@ -1,7 +1,7 @@
 import { isAbsolute, join } from "node:path";
 
-export const cursorMcpServerName = "openpets";
-export const openPetsMcpPackageName = "@open-pets/mcp";
+export const cursorMcpServerName = "familiaros";
+export const openPetsMcpPackageName = "@familiaros/mcp";
 export type CursorCommandMode = "published" | "local" | "bundled";
 
 export interface CursorMcpEntry {
@@ -12,7 +12,7 @@ export interface CursorMcpEntry {
 
 export interface CursorMcpConfig {
   readonly mcpServers?: {
-    readonly openpets?: CursorMcpEntry | unknown;
+    readonly familiaros?: CursorMcpEntry | unknown;
     readonly [key: string]: unknown;
   };
   readonly [key: string]: unknown;
@@ -25,10 +25,10 @@ export interface CursorMcpPreviewOptions {
   readonly mcpEntryPath?: string;
 }
 
-export function validateOpenPetsPetId(value: string): string {
+export function validateFamiliarOSPetId(value: string): string {
   const trimmed = value.trim();
-  if (trimmed !== value || trimmed.length < 1) throw new Error("Invalid OpenPets pet id.");
-  if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(trimmed)) throw new Error("Invalid OpenPets pet id.");
+  if (trimmed !== value || trimmed.length < 1) throw new Error("Invalid FamiliarOS familiar id.");
+  if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(trimmed)) throw new Error("Invalid FamiliarOS familiar id.");
   return trimmed;
 }
 
@@ -37,7 +37,7 @@ export function isValidPetId(value: string): boolean {
 }
 
 export function buildCursorMcpEntry(options: CursorMcpPreviewOptions): CursorMcpEntry {
-  const petArgs = options.petId === undefined ? [] : ["--pet", validateOpenPetsPetId(options.petId)];
+  const petArgs = options.petId === undefined ? [] : ["--familiar", validateFamiliarOSPetId(options.petId)];
   const mode = options.commandMode ?? "published";
   if (mode === "local" || mode === "bundled") {
     if (!options.mcpEntryPath || !isAbsolute(options.mcpEntryPath)) {
@@ -45,13 +45,13 @@ export function buildCursorMcpEntry(options: CursorMcpPreviewOptions): CursorMcp
     }
     return { type: "stdio", command: "node", args: [options.mcpEntryPath, ...petArgs] };
   }
-  validateOpenPetsPackageVersion(options.mcpVersion);
+  validateFamiliarOSPackageVersion(options.mcpVersion);
   return { type: "stdio", command: "npx", args: ["-y", `${openPetsMcpPackageName}@${options.mcpVersion}`, ...petArgs] };
 }
 
-export function validateOpenPetsPackageVersion(value: string): string {
+export function validateFamiliarOSPackageVersion(value: string): string {
   if (!/^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?$/.test(value)) {
-    throw new Error("Invalid OpenPets package version.");
+    throw new Error("Invalid FamiliarOS package version.");
   }
   return value;
 }
diff --git a/packages/cursor/src/cursor-previews.ts b/packages/cursor/src/cursor-previews.ts
index c93f0bf5..ae66a811 100644
--- a/packages/cursor/src/cursor-previews.ts
+++ b/packages/cursor/src/cursor-previews.ts
@@ -2,13 +2,13 @@ import type { CursorMcpEntry, CursorMcpPreviewOptions } from "./cursor-mcp.js";
 import { buildCursorMcpEntry } from "./cursor-mcp.js";
 
 export interface RedactedPreview {
-  readonly openpets?: CursorMcpEntry;
+  readonly familiaros?: CursorMcpEntry;
   readonly redactedFields?: readonly string[];
 }
 
 export interface FullRedactedConfig {
   readonly mcpServers?: {
-    readonly openpets?: CursorMcpEntry | Record<string, unknown>;
+    readonly familiaros?: CursorMcpEntry | Record<string, unknown>;
     readonly [key: string]: unknown;
   };
   readonly [key: string]: unknown;
@@ -33,8 +33,8 @@ const sensitivePatterns = [
   /auth=/i,
 ];
 
-export function buildOpenPetsOnlyPreview(options: CursorMcpPreviewOptions): RedactedPreview {
-  return { openpets: buildCursorMcpEntry(options) };
+export function buildFamiliarOSOnlyPreview(options: CursorMcpPreviewOptions): RedactedPreview {
+  return { familiaros: buildCursorMcpEntry(options) };
 }
 
 export function redactCursorConfig(config: Record<string, unknown>): FullRedactedConfig {
diff --git a/packages/cursor/src/cursor-rules.ts b/packages/cursor/src/cursor-rules.ts
index dff5909d..d8f84555 100644
--- a/packages/cursor/src/cursor-rules.ts
+++ b/packages/cursor/src/cursor-rules.ts
@@ -36,38 +36,38 @@ export interface CursorRulesPlannedWrite {
 }
 
 export const maxCursorRulesBytes = 64 * 1024;
-export const cursorRulesStartMarker = "<!-- OPENPETS:CURSOR_RULES:START -->";
-export const cursorRulesEndMarker = "<!-- OPENPETS:CURSOR_RULES:END -->";
+export const cursorRulesStartMarker = "<!-- FAMILIAROS:CURSOR_RULES:START -->";
+export const cursorRulesEndMarker = "<!-- FAMILIAROS:CURSOR_RULES:END -->";
 
-const cursorRulesFrontmatter = "---\ndescription: Use OpenPets MCP tools for lightweight coding-status feedback.\n---";
+const cursorRulesFrontmatter = "---\ndescription: Use FamiliarOS MCP tools for lightweight coding-status feedback.\n---";
 
 export function getCursorProjectRulesPath(projectDir: string): string {
-  return join(projectDir, ".cursor", "rules", "openpets.mdc");
+  return join(projectDir, ".cursor", "rules", "familiaros.mdc");
 }
 
-export function buildCursorOpenPetsRule(): string {
+export function buildCursorFamiliarOSRule(): string {
   return `${cursorRulesFrontmatter}
 
 ${cursorRulesStartMarker}
-# OpenPets status feedback
+# FamiliarOS status feedback
 
-You may use the OpenPets MCP tools as a brief, safe status channel during meaningful coding work.
+You may use the FamiliarOS MCP tools as a brief, safe status channel during meaningful coding work.
 
-- Use \`openpets_say\` sparingly for major milestones, blocking states, completion, or when review is needed.
-- Prefer \`openpets_react\` over speech for lightweight progress such as thinking, working, testing, success, or error.
+- Use \`familiaros_say\` sparingly for major milestones, blocking states, completion, or when review is needed.
+- Prefer \`familiaros_react\` over speech for lightweight progress such as thinking, working, testing, success, or error.
 - Keep messages short, user-facing, and safe.
-- Do not send prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, file paths, or other sensitive content through OpenPets.
-- Do not spam every internal step; use OpenPets only for meaningful progress changes and continue normally if a status update is unnecessary.
-- If OpenPets is unavailable, continue the coding task without failing.
+- Do not send prompts, tool input/output, code, logs, stack traces, credentials, private file contents, URLs, file paths, or other sensitive content through FamiliarOS.
+- Do not spam every internal step; use FamiliarOS only for meaningful progress changes and continue normally if a status update is unnecessary.
+- If FamiliarOS is unavailable, continue the coding task without failing.
 ${cursorRulesEndMarker}
 `;
 }
 
 export function buildCursorRulesPreview(): string {
-  return buildCursorOpenPetsRule();
+  return buildCursorFamiliarOSRule();
 }
 
-export function readCursorOpenPetsRules(projectDir: string): CursorRulesReadResult | CursorRulesError {
+export function readCursorFamiliarOSRules(projectDir: string): CursorRulesReadResult | CursorRulesError {
   try {
     const rulesPath = getCursorProjectRulesPath(projectDir);
     const pathSafety = assertSafeRulesPath(projectDir, rulesPath);
@@ -80,7 +80,7 @@ export function readCursorOpenPetsRules(projectDir: string): CursorRulesReadResu
 
     const content = readFileSync(rulesPath, "utf8");
     if (Buffer.byteLength(content, "utf8") > maxCursorRulesBytes) {
-      return { ok: false, message: "Cursor OpenPets rule file exceeds 64 KiB limit.", reason: "size" };
+      return { ok: false, message: "Cursor FamiliarOS rule file exceeds 64 KiB limit.", reason: "size" };
     }
 
     return { ok: true, content, exists: true };
@@ -92,7 +92,7 @@ export function readCursorOpenPetsRules(projectDir: string): CursorRulesReadResu
 export function classifyCursorRulesStatus(
   readResult: CursorRulesReadResult | CursorRulesError,
   rulesPath: string,
-  expectedContent = buildCursorOpenPetsRule()
+  expectedContent = buildCursorFamiliarOSRule()
 ): CursorRulesStatusResult {
   if (!readResult.ok) {
     return {
@@ -109,7 +109,7 @@ export function classifyCursorRulesStatus(
   if (!readResult.exists) {
     return {
       status: "missing",
-      message: "Cursor OpenPets project rule is not installed.",
+      message: "Cursor FamiliarOS project rule is not installed.",
       rulesPath,
       canInstall: true,
       canReplace: false,
@@ -127,14 +127,14 @@ export function classifyCursorRulesStatus(
       canInstall: false,
       canReplace: true,
       canRemove: false,
-      redactedDetails: "Existing .cursor/rules/openpets.mdc is not an exact OpenPets-managed rules file.",
+      redactedDetails: "Existing .cursor/rules/familiaros.mdc is not an exact FamiliarOS-managed rules file.",
     };
   }
 
   if (normalizeNewlines(readResult.content) === normalizeNewlines(expectedContent)) {
     return {
       status: "installed",
-      message: "Cursor OpenPets project rule is installed and up to date.",
+      message: "Cursor FamiliarOS project rule is installed and up to date.",
       rulesPath,
       canInstall: false,
       canReplace: false,
@@ -145,7 +145,7 @@ export function classifyCursorRulesStatus(
 
   return {
     status: "needs-update",
-    message: "Cursor OpenPets project rule needs update.",
+    message: "Cursor FamiliarOS project rule needs update.",
     rulesPath,
     canInstall: true,
     canReplace: true,
@@ -154,13 +154,13 @@ export function classifyCursorRulesStatus(
   };
 }
 
-export function isManagedCursorOpenPetsRule(content: string): boolean {
+export function isManagedCursorFamiliarOSRule(content: string): boolean {
   return classifyManagedRuleShape(content) === "managed";
 }
 
 export function planCursorRulesInstall(projectDir: string, allowReplace = false): CursorRulesPlannedWrite | CursorRulesError {
   const rulesPath = getCursorProjectRulesPath(projectDir);
-  const existing = readCursorOpenPetsRules(projectDir);
+  const existing = readCursorFamiliarOSRules(projectDir);
   if (!existing.ok) return existing;
   const status = classifyCursorRulesStatus(existing, rulesPath);
 
@@ -168,18 +168,18 @@ export function planCursorRulesInstall(projectDir: string, allowReplace = false)
     return { ok: false, message: status.message, reason: "io" };
   }
   if (status.status === "conflict" && !allowReplace) {
-    return { ok: false, message: "Cannot install: .cursor/rules/openpets.mdc has user content. Use --force to replace only that file.", reason: "unsafe-path" };
+    return { ok: false, message: "Cannot install: .cursor/rules/familiaros.mdc has user content. Use --force to replace only that file.", reason: "unsafe-path" };
   }
   if (status.status === "installed") {
-    return { ok: false, message: "Cursor OpenPets project rule is already installed.", reason: "io" };
+    return { ok: false, message: "Cursor FamiliarOS project rule is already installed.", reason: "io" };
   }
 
-  return buildRulesWritePlan(projectDir, buildCursorOpenPetsRule());
+  return buildRulesWritePlan(projectDir, buildCursorFamiliarOSRule());
 }
 
 export function planCursorRulesReplace(projectDir: string): CursorRulesPlannedWrite | CursorRulesError {
   const rulesPath = getCursorProjectRulesPath(projectDir);
-  const existing = readCursorOpenPetsRules(projectDir);
+  const existing = readCursorFamiliarOSRules(projectDir);
   if (!existing.ok) return existing;
   const status = classifyCursorRulesStatus(existing, rulesPath);
 
@@ -187,23 +187,23 @@ export function planCursorRulesReplace(projectDir: string): CursorRulesPlannedWr
     return { ok: false, message: status.message, reason: "io" };
   }
   if (status.status === "missing") {
-    return { ok: false, message: "Cannot replace: Cursor OpenPets project rule is not installed. Use install instead.", reason: "io" };
+    return { ok: false, message: "Cannot replace: Cursor FamiliarOS project rule is not installed. Use install instead.", reason: "io" };
   }
   if (status.status === "installed") {
-    return { ok: false, message: "Cannot replace: Cursor OpenPets project rule is already installed.", reason: "io" };
+    return { ok: false, message: "Cannot replace: Cursor FamiliarOS project rule is already installed.", reason: "io" };
   }
 
-  return buildRulesWritePlan(projectDir, buildCursorOpenPetsRule());
+  return buildRulesWritePlan(projectDir, buildCursorFamiliarOSRule());
 }
 
 export function planCursorRulesRemove(projectDir: string): CursorRulesPlannedWrite | CursorRulesError {
   const rulesPath = getCursorProjectRulesPath(projectDir);
-  const existing = readCursorOpenPetsRules(projectDir);
+  const existing = readCursorFamiliarOSRules(projectDir);
   if (!existing.ok) return existing;
   const status = classifyCursorRulesStatus(existing, rulesPath);
 
-  if (status.status === "missing") return { ok: false, message: "Cursor OpenPets project rule is not installed.", reason: "io" };
-  if (status.status === "conflict") return { ok: false, message: "Cannot remove: .cursor/rules/openpets.mdc is not managed by OpenPets.", reason: "unsafe-path" };
+  if (status.status === "missing") return { ok: false, message: "Cursor FamiliarOS project rule is not installed.", reason: "io" };
+  if (status.status === "conflict") return { ok: false, message: "Cannot remove: .cursor/rules/familiaros.mdc is not managed by FamiliarOS.", reason: "unsafe-path" };
   if (status.status === "invalid" || status.status === "error") return { ok: false, message: status.message, reason: "io" };
 
   return buildRulesWritePlan(projectDir, undefined, true);
@@ -255,8 +255,8 @@ function buildRulesWritePlan(projectDir: string, content?: string, remove = fals
 
   const parent = resolve(rulesPath, "..");
   const stamp = `${process.pid}-${Date.now()}-${randomUUID()}`;
-  const backupPath = existsSync(rulesPath) ? uniquePath(`${rulesPath}.openpets-backup-${stamp}.mdc`) : undefined;
-  const tempPath = uniquePath(join(parent, `.openpets-rules-${stamp}.tmp`));
+  const backupPath = existsSync(rulesPath) ? uniquePath(`${rulesPath}.familiaros-backup-${stamp}.mdc`) : undefined;
+  const tempPath = uniquePath(join(parent, `.familiaros-rules-${stamp}.tmp`));
 
   return { targetPath: rulesPath, backupPath, tempPath, content, remove };
 }
@@ -264,28 +264,28 @@ function buildRulesWritePlan(projectDir: string, content?: string, remove = fals
 function classifyManagedRuleShape(content: string): "managed" | string {
   const normalized = normalizeNewlines(content);
   if (countOccurrences(normalized, cursorRulesStartMarker) !== 1 || countOccurrences(normalized, cursorRulesEndMarker) !== 1) {
-    return "Cursor OpenPets rule file has missing or duplicate managed markers.";
+    return "Cursor FamiliarOS rule file has missing or duplicate managed markers.";
   }
 
   const start = normalized.indexOf(cursorRulesStartMarker);
   const end = normalized.indexOf(cursorRulesEndMarker);
-  if (start < 0 || end < 0 || start > end) return "Cursor OpenPets rule file has malformed managed markers.";
+  if (start < 0 || end < 0 || start > end) return "Cursor FamiliarOS rule file has malformed managed markers.";
 
   const before = normalized.slice(0, start).trim();
   const after = normalized.slice(end + cursorRulesEndMarker.length).trim();
-  if (before !== cursorRulesFrontmatter) return "Cursor OpenPets rule file has unknown frontmatter or user content before the managed block.";
-  if (after !== "") return "Cursor OpenPets rule file has user content after the managed block.";
+  if (before !== cursorRulesFrontmatter) return "Cursor FamiliarOS rule file has unknown frontmatter or user content before the managed block.";
+  if (after !== "") return "Cursor FamiliarOS rule file has user content after the managed block.";
 
   return "managed";
 }
 
 function cursorRulesErrorMessage(reason: CursorRulesError["reason"]): string {
   const messages: Record<CursorRulesError["reason"], string> = {
-    size: "Cursor OpenPets rule file is too large.",
-    symlink: "Cursor OpenPets rule path is a symlink.",
-    "not-regular": "Cursor OpenPets rule path is not a regular file.",
-    "unsafe-path": "Cursor OpenPets rule path is unsafe.",
-    io: "Failed to read Cursor OpenPets rule file.",
+    size: "Cursor FamiliarOS rule file is too large.",
+    symlink: "Cursor FamiliarOS rule path is a symlink.",
+    "not-regular": "Cursor FamiliarOS rule path is not a regular file.",
+    "unsafe-path": "Cursor FamiliarOS rule path is unsafe.",
+    io: "Failed to read Cursor FamiliarOS rule file.",
   };
   return messages[reason];
 }
@@ -295,7 +295,7 @@ function assertSafeRulesPath(projectDir: string, rulesPath: string): CursorRules
   const expected = resolve(getCursorProjectRulesPath(projectRoot));
   const resolvedRulesPath = resolve(rulesPath);
   if (resolvedRulesPath !== expected) {
-    return { ok: false, message: "Cursor rules path must be <project>/.cursor/rules/openpets.mdc.", reason: "unsafe-path" };
+    return { ok: false, message: "Cursor rules path must be <project>/.cursor/rules/familiaros.mdc.", reason: "unsafe-path" };
   }
   return assertSafeParentDirectory(resolve(rulesPath, ".."));
 }
diff --git a/packages/cursor/src/cursor-status.ts b/packages/cursor/src/cursor-status.ts
index 88aebd02..ef993287 100644
--- a/packages/cursor/src/cursor-status.ts
+++ b/packages/cursor/src/cursor-status.ts
@@ -83,7 +83,7 @@ export function classifyCursorMcpStatus(
   if (mcpServers === undefined || mcpServers[cursorMcpServerName] === undefined) {
     return {
       status: "missing",
-      message: "OpenPets MCP entry is not configured.",
+      message: "FamiliarOS MCP entry is not configured.",
       configPath,
       canInstall: true,
       canReplace: false,
@@ -92,26 +92,26 @@ export function classifyCursorMcpStatus(
     };
   }
 
-  const openpetsEntry = mcpServers[cursorMcpServerName];
+  const familiarosEntry = mcpServers[cursorMcpServerName];
 
-  if (!isRecord(openpetsEntry)) {
+  if (!isRecord(familiarosEntry)) {
     return {
       status: "conflict",
-      message: "Cursor MCP config has malformed openpets entry.",
+      message: "Cursor MCP config has malformed familiaros entry.",
       configPath,
       canInstall: false,
       canReplace: true,
       canRemove: false,
-      redactedDetails: "mcpServers.openpets is not an object",
+      redactedDetails: "mcpServers.familiaros is not an object",
     };
   }
 
   const expectedEntry = buildCursorMcpEntry(expected);
 
-  if (isSameMcpEntry(openpetsEntry, expectedEntry)) {
+  if (isSameMcpEntry(familiarosEntry, expectedEntry)) {
     return {
       status: "installed",
-      message: "OpenPets MCP is installed and up to date.",
+      message: "FamiliarOS MCP is installed and up to date.",
       configPath,
       canInstall: false,
       canReplace: false,
@@ -120,10 +120,10 @@ export function classifyCursorMcpStatus(
     };
   }
 
-  if (isManagedOpenPetsMcpEntry(openpetsEntry)) {
+  if (isManagedFamiliarOSMcpEntry(familiarosEntry)) {
     return {
       status: "needs-update",
-      message: "OpenPets MCP needs update (version or pet differs).",
+      message: "FamiliarOS MCP needs update (version or familiar differs).",
       configPath,
       canInstall: true,
       canReplace: true,
@@ -134,16 +134,16 @@ export function classifyCursorMcpStatus(
 
   return {
     status: "conflict",
-    message: "Cursor MCP config has a non-OpenPets openpets entry.",
+    message: "Cursor MCP config has a non-FamiliarOS familiaros entry.",
     configPath,
     canInstall: false,
     canReplace: true,
     canRemove: false,
-    redactedDetails: "Existing openpets entry is not managed by OpenPets",
+    redactedDetails: "Existing familiaros entry is not managed by FamiliarOS",
   };
 }
 
-export function isManagedOpenPetsMcpEntry(value: unknown): boolean {
+export function isManagedFamiliarOSMcpEntry(value: unknown): boolean {
   if (!isRecord(value)) return false;
   if (value.type !== "stdio") return false;
   if (typeof value.command !== "string") return false;
@@ -153,42 +153,42 @@ export function isManagedOpenPetsMcpEntry(value: unknown): boolean {
   const args = value.args as readonly string[];
 
   if (value.command === "npx") {
-    return isPublishedOpenPetsMcpArgs(args);
+    return isPublishedFamiliarOSMcpArgs(args);
   }
 
   if (value.command === "node") {
-    return isNodeOpenPetsMcpArgs(args);
+    return isNodeFamiliarOSMcpArgs(args);
   }
 
   return false;
 }
 
-function isPublishedOpenPetsMcpArgs(args: readonly string[]): boolean {
+function isPublishedFamiliarOSMcpArgs(args: readonly string[]): boolean {
   if (args.length < 2) return false;
   if (args[0] !== "-y") return false;
   const packageArg = args[1];
   if (typeof packageArg !== "string") return false;
-  const match = packageArg.match(/^@open-pets\/mcp@(\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?)$/);
+  const match = packageArg.match(/^@familiaros\/mcp@(\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?)$/);
   if (!match) return false;
   const version = match[1];
   if (!version) return false;
   return hasValidPetArgs(args.slice(2));
 }
 
-function isNodeOpenPetsMcpArgs(args: readonly string[]): boolean {
+function isNodeFamiliarOSMcpArgs(args: readonly string[]): boolean {
   if (args.length < 1) return false;
   const scriptPath = args[0];
   if (typeof scriptPath !== "string") return false;
-  const isOpenPetsPath = /(?:^|[\\/])node_modules[\\/]@open-pets[\\/]mcp[\\/]dist[\\/]index\.js$/u.test(scriptPath) ||
+  const isFamiliarOSPath = /(?:^|[\\/])node_modules[\\/]@familiaros[\\/]mcp[\\/]dist[\\/]index\.js$/u.test(scriptPath) ||
     /(?:^|[\\/])packages[\\/]mcp[\\/]dist[\\/]index\.js$/u.test(scriptPath);
-  if (!isOpenPetsPath) return false;
+  if (!isFamiliarOSPath) return false;
   return hasValidPetArgs(args.slice(1));
 }
 
 function hasValidPetArgs(args: readonly string[]): boolean {
   if (args.length === 0) return true;
   if (args.length !== 2) return false;
-  if (args[0] !== "--pet") return false;
+  if (args[0] !== "--familiar") return false;
   return isValidPetId(args[1] ?? "");
 }
 
@@ -256,7 +256,7 @@ export function planCursorMcpInstall(
   }
 
   if (status.status === "conflict" && !allowReplace) {
-    return { ok: false, message: "Cannot install: config has conflicting openpets entry. Use replace instead.", reason: "invalid-schema" };
+    return { ok: false, message: "Cannot install: config has conflicting familiaros entry. Use replace instead.", reason: "invalid-schema" };
   }
 
   if (status.status === "installed") {
@@ -290,10 +290,10 @@ export function planCursorMcpReplace(
   }
 
   if (status.status === "missing") {
-    return { ok: false, message: "Cannot replace: no existing openpets entry. Use install instead.", reason: "invalid-schema" };
+    return { ok: false, message: "Cannot replace: no existing familiaros entry. Use install instead.", reason: "invalid-schema" };
   }
   if (status.status === "installed") {
-    return { ok: false, message: "Cannot replace: OpenPets MCP entry is already installed.", reason: "invalid-schema" };
+    return { ok: false, message: "Cannot replace: FamiliarOS MCP entry is already installed.", reason: "invalid-schema" };
   }
 
   const newEntry = buildCursorMcpEntry(options);
@@ -315,10 +315,10 @@ export function planCursorMcpRemove(configPath: string): CursorPlannedWrite | Cu
 
   const mcpServers = isRecord(existing.config.mcpServers) ? existing.config.mcpServers : undefined;
   if (mcpServers === undefined || mcpServers[cursorMcpServerName] === undefined) {
-    return { ok: false, message: "OpenPets MCP entry is not installed.", reason: "invalid-schema" };
+    return { ok: false, message: "FamiliarOS MCP entry is not installed.", reason: "invalid-schema" };
   }
-  if (!isManagedOpenPetsMcpEntry(mcpServers[cursorMcpServerName])) {
-    return { ok: false, message: "Cannot remove: existing openpets entry is not managed by OpenPets.", reason: "invalid-schema" };
+  if (!isManagedFamiliarOSMcpEntry(mcpServers[cursorMcpServerName])) {
+    return { ok: false, message: "Cannot remove: existing familiaros entry is not managed by FamiliarOS.", reason: "invalid-schema" };
   }
 
   const newConfig: Record<string, unknown> = { ...existing.config };
@@ -341,8 +341,8 @@ function buildWritePlan(configPath: string, content: string): CursorPlannedWrite
   if (!existing.ok) return existing;
 
   const stamp = `${process.pid}-${Date.now()}-${randomUUID()}`;
-  const backupPath = existsSync(configPath) ? uniquePath(`${configPath}.openpets-backup-${stamp}.json`) : undefined;
-  const tempPath = uniquePath(join(parent, `.openpets-${stamp}.tmp`));
+  const backupPath = existsSync(configPath) ? uniquePath(`${configPath}.familiaros-backup-${stamp}.json`) : undefined;
+  const tempPath = uniquePath(join(parent, `.familiaros-${stamp}.tmp`));
 
   return { targetPath: configPath, backupPath, tempPath, content };
 }
diff --git a/packages/pet-format/codemap.md b/packages/familiar-format/codemap.md
similarity index 60%
rename from packages/pet-format/codemap.md
rename to packages/familiar-format/codemap.md
index f7171835..396eebf8 100644
--- a/packages/pet-format/codemap.md
+++ b/packages/familiar-format/codemap.md
@@ -1,10 +1,10 @@
-# packages/pet-format/
+# packages/familiar-format/
 
-Minimal package providing a type marker for OpenPets package identification.
+Minimal package providing a type marker for FamiliarOS package identification.
 
 ## Responsibility
 
-Exports a simple interface and constant to identify the pet-format package in the OpenPets ecosystem. Used for type-level package identification and workspace boundary marking.
+Exports a simple interface and constant to identify the familiar-format package in the FamiliarOS ecosystem. Used for type-level package identification and workspace boundary marking.
 
 ## Design
 
@@ -22,4 +22,4 @@ No data flow - this is a static marker package.
 
 **Exports**:
 - `PetFormatPackageMarker` interface with readonly `packageName`
-- `petFormatPackageName` constant (`"@open-pets/pet-format"`)
+- `petFormatPackageName` constant (`"@familiaros/familiar-format"`)
diff --git a/packages/pet-format/package.json b/packages/familiar-format/package.json
similarity index 75%
rename from packages/pet-format/package.json
rename to packages/familiar-format/package.json
index 15c17c7a..d5dda2b5 100644
--- a/packages/pet-format/package.json
+++ b/packages/familiar-format/package.json
@@ -1,12 +1,12 @@
 {
-  "name": "@open-pets/pet-format",
+  "name": "@familiaros/familiar-format",
   "version": "3.0.0",
   "private": true,
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
-    "directory": "packages/pet-format"
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
+    "directory": "packages/familiar-format"
   },
   "type": "module",
   "main": "dist/index.js",
diff --git a/packages/pet-format/src/codemap.md b/packages/familiar-format/src/codemap.md
similarity index 83%
rename from packages/pet-format/src/codemap.md
rename to packages/familiar-format/src/codemap.md
index 689a4cdf..b28f424d 100644
--- a/packages/pet-format/src/codemap.md
+++ b/packages/familiar-format/src/codemap.md
@@ -1,4 +1,4 @@
-# packages/pet-format/src/
+# packages/familiar-format/src/
 
 ## Files
 
diff --git a/packages/familiar-format/src/index.ts b/packages/familiar-format/src/index.ts
new file mode 100644
index 00000000..27ff9aec
--- /dev/null
+++ b/packages/familiar-format/src/index.ts
@@ -0,0 +1,5 @@
+export interface PetFormatPackageMarker {
+  readonly packageName: "@familiaros/familiar-format";
+}
+
+export const petFormatPackageName = "@familiaros/familiar-format";
diff --git a/packages/pet-format/tsconfig.json b/packages/familiar-format/tsconfig.json
similarity index 100%
rename from packages/pet-format/tsconfig.json
rename to packages/familiar-format/tsconfig.json
diff --git a/packages/install-pet/codemap.md b/packages/install-familiar/codemap.md
similarity index 50%
rename from packages/install-pet/codemap.md
rename to packages/install-familiar/codemap.md
index 447bcd9b..7ba395e1 100644
--- a/packages/install-pet/codemap.md
+++ b/packages/install-familiar/codemap.md
@@ -1,37 +1,37 @@
-# packages/install-pet/
+# packages/install-familiar/
 
-Standalone pet installer from OpenPets gallery catalog.
+Standalone familiar installer from FamiliarOS gallery catalog.
 
 ## Responsibility
 
-Provides a standalone CLI tool for installing pets from the OpenPets gallery catalog. Can operate through the running desktop app (preferred) or directly download and extract pet ZIP files.
+Provides a standalone CLI tool for installing familiars from the FamiliarOS gallery catalog. Can operate through the running desktop app (preferred) or directly download and extract familiar ZIP files.
 
 ## Design
 
 **Dual Install Modes**:
-1. **Via Running App**: Uses `@open-pets/client` to request installation through the desktop app
+1. **Via Running App**: Uses `@familiaros/client` to request installation through the desktop app
 2. **Direct Install**: Downloads from catalog, validates, extracts to user data directory
 
 **Catalog Integration**:
-- URL: `https://openpets.dev/pets/catalog.v2.json`
+- URL: `https://familiaros.dev/familiars/catalog.v2.json`
 - Validation: Schema version, unique IDs, URL host/path allowlisting
-- Pet structure: `{ id, displayName, description, preview, zip }`
+- Familiar structure: `{ id, displayName, description, preview, zip }`
 
 **ZIP Handling**:
 - Library: `yauzl` for streaming ZIP extraction
 - Security: Path traversal prevention, symlink rejection, size limits
 - Limits: 50MB download, 200MB extracted, 500 files, 100MB per file
-- Required files: `pet.json`, `spritesheet.webp`
+- Required files: `familiar.json`, `spritesheet.webp`
 - Extraction: Atomic (temp dir → rename), permission 0o600/0o700
 
 **State Management**:
-- User data path: Platform-specific (macOS: `~/Library/Application Support/OpenPets`, Windows: `%APPDATA%/OpenPets`, Linux: `~/.config/OpenPets`)
-- State file: `openpets-state.json`
-- Lock file: `.install-pet.lock` (prevents concurrent installs, 10min stale timeout)
-- Pet directory: `pets/<petId>/`
+- User data path: Platform-specific (macOS: `~/Library/Application Support/FamiliarOS`, Windows: `%APPDATA%/FamiliarOS`, Linux: `~/.config/FamiliarOS`)
+- State file: `familiaros-state.json`
+- Lock file: `.install-familiar.lock` (prevents concurrent installs, 10min stale timeout)
+- Familiar directory: `familiars/<petId>/`
 
 **Validation**:
-- Pet ID: `^[a-z0-9][a-z0-9_-]{0,63}$`, excludes "builtin"
+- Familiar ID: `^[a-z0-9][a-z0-9_-]{0,63}$`, excludes "builtin"
 - Catalog URLs: HTTPS only, specific host allowlist
 - ZIP entries: No encryption, supported compression (stored/deflate), valid Unix modes
 
@@ -40,13 +40,13 @@ Provides a standalone CLI tool for installing pets from the OpenPets gallery cat
 ```
 installPet({ petId, preferRunningApp })
     ↓
-tryInstallThroughRunningApp() → createOpenPetsClient().installPet()
+tryInstallThroughRunningApp() → createFamiliarOSClient().installPet()
     ↓ (fallback on unavailable/timeout)
 installPetDirectly()
     ↓
 acquireDirectInstallLock() → mkdir lock, write owner.json
     ↓
-fetchCatalog() → GET https://openpets.dev/pets/catalog.v2.json
+fetchCatalog() → GET https://familiaros.dev/familiars/catalog.v2.json
     ↓
 getCatalogPet(petId) → Validate exists in catalog
     ↓
@@ -54,11 +54,11 @@ downloadPetZip(zipUrl) → Stream to buffer, validate magic bytes
     ↓
 extractPetZip(buffer, tempDir) → yauzl streaming extract
     ↓
-validateExtractedPet() → Check pet.json, spritesheet.webp exist
+validateExtractedPet() → Check familiar.json, spritesheet.webp exist
     ↓
 rename(tempDir, finalDir) → Atomic move
     ↓
-writeInstalledPetState() → Update openpets-state.json
+writeInstalledPetState() → Update familiaros-state.json
     ↓
 releaseLock() → rm lock directory
 ```
@@ -66,19 +66,19 @@ releaseLock() → rm lock directory
 ## Integration Points
 
 **Dependencies**:
-- `@open-pets/client` - Fallback IPC to running app
+- `@familiaros/client` - Fallback IPC to running app
 - `yauzl` - ZIP file handling
 
 **External Services**:
-- `openpets.dev` - Catalog JSON and pet metadata
-- `zip.openpets.dev` - ZIP file downloads
+- `familiaros.dev` - Catalog JSON and familiar metadata
+- `zip.familiaros.dev` - ZIP file downloads
 
 **CLI Usage**:
-- Binary: `install-pet <pet-id>`
-- Also invocable via `npx -y install-pet <pet-id>`
+- Binary: `install-familiar <familiar-id>`
+- Also invocable via `npx -y install-familiar <familiar-id>`
 
 **Exports**:
 - `installPet()` - Main install function
 - `parseArgs()` - CLI argument parsing
-- `getOpenPetsUserDataPath()` - Platform-specific path resolution
+- `getFamiliarOSUserDataPath()` - Platform-specific path resolution
 - `validatePetId()` - ID format validation
diff --git a/packages/install-pet/package.json b/packages/install-familiar/package.json
similarity index 69%
rename from packages/install-pet/package.json
rename to packages/install-familiar/package.json
index c19ef6b8..cd7bbd91 100644
--- a/packages/install-pet/package.json
+++ b/packages/install-familiar/package.json
@@ -1,17 +1,17 @@
 {
-  "name": "install-pet",
+  "name": "@familiaros/install-familiar",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
-    "directory": "packages/install-pet"
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
+    "directory": "packages/install-familiar"
   },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "install-pet": "dist/index.js"
+    "install-familiar": "dist/index.js"
   },
   "files": [
     "dist"
@@ -26,13 +26,13 @@
     }
   },
   "scripts": {
-    "test": "node dist/check-install-pet.js",
+    "test": "node dist/check-install-familiar.js",
     "check": "pnpm typecheck && pnpm build && pnpm test",
     "typecheck": "tsc --noEmit",
     "build": "tsc"
   },
   "dependencies": {
-    "@open-pets/client": "workspace:*",
+    "@familiaros/client": "workspace:*",
     "yauzl": "3.3.0"
   },
   "devDependencies": {
diff --git a/packages/install-familiar/src/check-install-pet.ts b/packages/install-familiar/src/check-install-pet.ts
new file mode 100644
index 00000000..2fbd3cc8
--- /dev/null
+++ b/packages/install-familiar/src/check-install-pet.ts
@@ -0,0 +1,36 @@
+import assert from "node:assert/strict";
+import { join } from "node:path";
+
+import { getFamiliarOSUserDataPath, parseArgs, validateCatalog, validatePetId } from "./index.js";
+
+assert.deepEqual(parseArgs(["review-owl"]), { petId: "review-owl", help: false });
+assert.equal(parseArgs(["--help"]).help, true);
+assert.equal(validatePetId("review-owl"), "review-owl");
+assert.throws(() => validatePetId("../bad"));
+assert.throws(() => validatePetId("builtin"));
+
+assert.equal(getFamiliarOSUserDataPath("darwin", {}), join(process.env.HOME || "", "Library", "Application Support", "FamiliarOS"));
+assert.equal(getFamiliarOSUserDataPath("linux", { XDG_CONFIG_HOME: "/tmp/config" }), join("/tmp/config", "FamiliarOS"));
+assert.equal(getFamiliarOSUserDataPath("win32", { APPDATA: "C:\\Users\\me\\AppData\\Roaming" }), join("C:\\Users\\me\\AppData\\Roaming", "FamiliarOS"));
+assert.equal(getFamiliarOSUserDataPath("linux", { FAMILIAROS_USER_DATA: "/tmp/familiaros-test" }), "/tmp/familiaros-test");
+
+assert.deepEqual(validateCatalog({
+  version: 2,
+  generatedAt: new Date().toISOString(),
+  familiars: [{
+    id: "review-owl",
+    displayName: "Review Owl",
+    description: "A reviewer familiar.",
+    preview: "https://familiaros.dev/familiars/review-owl/preview.webp",
+    zip: "https://zip.familiaros.dev/familiars/review-owl.zip",
+  }],
+}), [{
+  id: "review-owl",
+  displayName: "Review Owl",
+  description: "A reviewer familiar.",
+  preview: "https://familiaros.dev/familiars/review-owl/preview.webp",
+  zip: "https://zip.familiaros.dev/familiars/review-owl.zip",
+}]);
+assert.throws(() => validateCatalog({ version: 2, familiars: [{ id: "bad/familiar" }] }));
+
+console.log("install-familiar validation passed.");
diff --git a/packages/install-pet/src/codemap.md b/packages/install-familiar/src/codemap.md
similarity index 64%
rename from packages/install-pet/src/codemap.md
rename to packages/install-familiar/src/codemap.md
index 6803b6ab..b3cbdbf3 100644
--- a/packages/install-pet/src/codemap.md
+++ b/packages/install-familiar/src/codemap.md
@@ -1,6 +1,6 @@
-# packages/install-pet/src/
+# packages/install-familiar/src/
 
 ## Files
 
 - **index.ts**: Main implementation (571 lines). `installPet()`, `tryInstallThroughRunningApp()`, `installPetDirectly()`, catalog fetching, ZIP download/extraction, state management, locking, validation functions.
-- **check-install-pet.ts**: Contract validation (excluded from detailed documentation).
+- **check-install-familiar.ts**: Contract validation (excluded from detailed documentation).
diff --git a/packages/install-pet/src/index.ts b/packages/install-familiar/src/index.ts
similarity index 81%
rename from packages/install-pet/src/index.ts
rename to packages/install-familiar/src/index.ts
index af91401b..47dc7373 100644
--- a/packages/install-pet/src/index.ts
+++ b/packages/install-familiar/src/index.ts
@@ -7,26 +7,26 @@ import { pipeline } from "node:stream/promises";
 import { Transform } from "node:stream";
 import { fileURLToPath } from "node:url";
 
-import { createOpenPetsClient, OpenPetsClientError } from "@open-pets/client";
+import { createFamiliarOSClient, FamiliarOSClientError } from "@familiaros/client";
 import yauzl from "yauzl";
 import type { Entry, ZipFile } from "yauzl";
 
-const catalogUrl = "https://openpets.dev/pets/catalog.v2.json";
-const zipHost = "zip.openpets.dev";
+const catalogUrl = "https://familiaros.dev/familiars/catalog.v2.json";
+const zipHost = "zip.familiaros.dev";
 const maxCatalogBytes = 1_000_000;
 const maxZipDownloadBytes = 50 * 1024 * 1024;
 const maxExtractedTotalBytes = 200 * 1024 * 1024;
 const maxFiles = 500;
 const maxIndividualFileBytes = 100 * 1024 * 1024;
 const fetchTimeoutMs = 30_000;
-const directInstallLockName = ".install-pet.lock";
+const directInstallLockName = ".install-familiar.lock";
 const directInstallLockStaleMs = 10 * 60 * 1000;
 const appUnavailableErrorCodes = new Set(["unavailable", "connect_timeout", "connection_closed"]);
 const appTooOldErrorCodes = new Set(["unknown_method", "invalid_version"]);
 
 const builtInPet = {
   id: "builtin",
-  displayName: "Built-in Pet",
+  displayName: "Built-in Familiar",
   builtIn: true,
   protected: true,
   installed: true,
@@ -68,7 +68,7 @@ interface InstalledPetState {
   readonly brokenReason?: string;
 }
 
-interface OpenPetsState {
+interface FamiliarOSState {
   readonly version: 1;
   readonly preferences: {
     readonly defaultPetId: string;
@@ -79,7 +79,7 @@ interface OpenPetsState {
     readonly claudeCommandPath?: string;
     readonly opencodeCommandPath?: string;
   };
-  readonly pets: {
+  readonly familiars: {
     readonly installed: readonly InstalledPetState[];
   };
   readonly defaultPet: Record<string, unknown>;
@@ -103,20 +103,20 @@ export async function installPet(options: InstallPetOptions): Promise<InstallPet
 
 export function parseArgs(args: readonly string[]): { readonly petId: string; readonly help: boolean } {
   if (args.length === 0 || args.includes("--help") || args.includes("-h")) return { petId: "", help: true };
-  if (args.length !== 1) throw new Error("Usage: install-pet <pet-id>");
+  if (args.length !== 1) throw new Error("Usage: install-familiar <familiar-id>");
   return { petId: validatePetId(args[0] ?? ""), help: false };
 }
 
-export function getOpenPetsUserDataPath(platform = process.platform, env: NodeJS.ProcessEnv = process.env): string {
-  if (env.OPENPETS_USER_DATA) return env.OPENPETS_USER_DATA;
-  if (platform === "darwin") return join(homedir(), "Library", "Application Support", "OpenPets");
-  if (platform === "win32") return join(env.APPDATA || join(homedir(), "AppData", "Roaming"), "OpenPets");
-  return join(env.XDG_CONFIG_HOME || join(homedir(), ".config"), "OpenPets");
+export function getFamiliarOSUserDataPath(platform = process.platform, env: NodeJS.ProcessEnv = process.env): string {
+  if (env.FAMILIAROS_USER_DATA) return env.FAMILIAROS_USER_DATA;
+  if (platform === "darwin") return join(homedir(), "Library", "Application Support", "FamiliarOS");
+  if (platform === "win32") return join(env.APPDATA || join(homedir(), "AppData", "Roaming"), "FamiliarOS");
+  return join(env.XDG_CONFIG_HOME || join(homedir(), ".config"), "FamiliarOS");
 }
 
 export function validatePetId(value: string): string {
   if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(value) || value === builtInPet.id) {
-    throw new Error(`Invalid OpenPets pet id: ${value}`);
+    throw new Error(`Invalid FamiliarOS familiar id: ${value}`);
   }
   return value;
 }
@@ -129,36 +129,36 @@ async function main(): Promise<void> {
   }
 
   const result = await installPet({ petId: parsed.petId });
-  process.stdout.write(`Installed OpenPets pet: ${result.displayName} (${result.petId})\n`);
+  process.stdout.write(`Installed FamiliarOS familiar: ${result.displayName} (${result.petId})\n`);
   if (result.via === "direct") {
-    process.stdout.write("Open or restart OpenPets to use the installed pet.\n");
+    process.stdout.write("Open or restart FamiliarOS to use the installed familiar.\n");
   }
 }
 
 async function tryInstallThroughRunningApp(petId: string): Promise<InstallPetResult | null> {
   try {
-    const result = await createOpenPetsClient({ responseTimeoutMs: 60_000 }).installPet(petId);
+    const result = await createFamiliarOSClient({ responseTimeoutMs: 60_000 }).installPet(petId);
     return { petId: result.petId, displayName: result.displayName, via: "app" };
   } catch (error) {
-    if (error instanceof OpenPetsClientError && appUnavailableErrorCodes.has(error.code)) return null;
-    if (error instanceof OpenPetsClientError && appTooOldErrorCodes.has(error.code)) {
-      throw new Error("Your running OpenPets app is too old for CLI pet installs. Quit OpenPets and retry, or update OpenPets.");
+    if (error instanceof FamiliarOSClientError && appUnavailableErrorCodes.has(error.code)) return null;
+    if (error instanceof FamiliarOSClientError && appTooOldErrorCodes.has(error.code)) {
+      throw new Error("Your running FamiliarOS app is too old for CLI familiar installs. Quit FamiliarOS and retry, or update FamiliarOS.");
     }
     throw error;
   }
 }
 
 async function installPetDirectly(petId: string): Promise<InstallPetResult> {
-  const userData = getOpenPetsUserDataPath();
+  const userData = getFamiliarOSUserDataPath();
   await mkdir(userData, { recursive: true, mode: 0o700 });
   const releaseLock = await acquireDirectInstallLock(userData);
   try {
     const catalogPet = await getCatalogPet(petId);
     const initialState = await readCurrentState(userData);
-    if (initialState.pets.installed.some((pet) => pet.id === catalogPet.id)) throw new Error(`Pet is already installed: ${catalogPet.id}`);
+    if (initialState.familiars.installed.some((familiar) => familiar.id === catalogPet.id)) throw new Error(`Familiar is already installed: ${catalogPet.id}`);
 
     const zip = await downloadPetZip(catalogPet.zip);
-    const petsRoot = join(userData, "pets");
+    const petsRoot = join(userData, "familiars");
     await mkdir(petsRoot, { recursive: true, mode: 0o700 });
 
     const finalDir = getInstalledPetDir(petsRoot, petId);
@@ -187,7 +187,7 @@ async function acquireDirectInstallLock(userData: string): Promise<() => Promise
   for (let attempt = 0; attempt < 2; attempt += 1) {
     try {
       await mkdir(lockPath, { mode: 0o700 });
-      await writeFile(join(lockPath, "owner.json"), `${JSON.stringify({ pid: process.pid, createdAt: Date.now(), command: "install-pet" })}\n`, "utf8");
+      await writeFile(join(lockPath, "owner.json"), `${JSON.stringify({ pid: process.pid, createdAt: Date.now(), command: "install-familiar" })}\n`, "utf8");
       return async () => {
         await rm(lockPath, { recursive: true, force: true }).catch(() => undefined);
       };
@@ -198,10 +198,10 @@ async function acquireDirectInstallLock(userData: string): Promise<() => Promise
         await rm(lockPath, { recursive: true, force: true });
         continue;
       }
-      throw new Error("Another OpenPets pet install or startup is already in progress.");
+      throw new Error("Another FamiliarOS familiar install or startup is already in progress.");
     }
   }
-  throw new Error("Could not acquire OpenPets install lock.");
+  throw new Error("Could not acquire FamiliarOS install lock.");
 }
 
 async function isStaleInstallLock(lockPath: string): Promise<boolean> {
@@ -231,9 +231,9 @@ function isProcessAlive(pid: number): boolean {
 
 async function getCatalogPet(petId: string): Promise<CatalogPet> {
   const catalog = await fetchCatalog();
-  const pet = catalog.find((candidate) => candidate.id === petId);
-  if (!pet) throw new Error(`Pet is not available in the OpenPets catalog: ${petId}`);
-  return pet;
+  const familiar = catalog.find((candidate) => candidate.id === petId);
+  if (!familiar) throw new Error(`Familiar is not available in the FamiliarOS catalog: ${petId}`);
+  return familiar;
 }
 
 async function fetchCatalog(): Promise<readonly CatalogPet[]> {
@@ -250,15 +250,15 @@ async function fetchCatalog(): Promise<readonly CatalogPet[]> {
 }
 
 export function validateCatalog(value: unknown): readonly CatalogPet[] {
-  if (!isRecord(value) || value.version !== 2 || !Array.isArray(value.pets)) throw new Error("OpenPets catalog is invalid.");
+  if (!isRecord(value) || value.version !== 2 || !Array.isArray(value.familiars)) throw new Error("FamiliarOS catalog is invalid.");
   const ids = new Set<string>();
-  return value.pets.map((pet) => validateCatalogPet(pet, ids));
+  return value.familiars.map((familiar) => validateCatalogPet(familiar, ids));
 }
 
 function validateCatalogPet(value: unknown, ids: Set<string>): CatalogPet {
-  if (!isRecord(value)) throw new Error("Catalog pet is invalid.");
+  if (!isRecord(value)) throw new Error("Catalog familiar is invalid.");
   const id = validatePetId(readString(value.id, "id", 64));
-  if (ids.has(id)) throw new Error(`Duplicate catalog pet id: ${id}`);
+  if (ids.has(id)) throw new Error(`Duplicate catalog familiar id: ${id}`);
   ids.add(id);
   return {
     id,
@@ -273,8 +273,8 @@ function validateCatalogUrl(value: unknown, field: "preview" | "zip"): string {
   const raw = readString(value, field, 2048);
   const url = new URL(raw);
   if (url.protocol !== "https:" || url.username || url.password || url.port) throw new Error(`${field} URL is invalid.`);
-  if (field === "preview" && (url.hostname !== "openpets.dev" || !url.pathname.startsWith("/pets/"))) throw new Error("Preview URL host/path is not allowed.");
-  if (field === "zip" && (url.hostname !== zipHost || !url.pathname.startsWith("/pets/"))) throw new Error("Zip URL host/path is not allowed.");
+  if (field === "preview" && (url.hostname !== "familiaros.dev" || !url.pathname.startsWith("/familiars/"))) throw new Error("Preview URL host/path is not allowed.");
+  if (field === "zip" && (url.hostname !== zipHost || !url.pathname.startsWith("/familiars/"))) throw new Error("Zip URL host/path is not allowed.");
   return url.toString();
 }
 
@@ -359,7 +359,7 @@ async function extractPetZip(zip: Buffer, tempDir: string): Promise<void> {
   } finally {
     zipFile.close();
   }
-  if (!seen.has("pet.json") || !seen.has("spritesheet.webp")) throw new Error("Zip must contain pet.json and spritesheet.webp.");
+  if (!seen.has("familiar.json") || !seen.has("spritesheet.webp")) throw new Error("Zip must contain familiar.json and spritesheet.webp.");
 }
 
 function openZipFromBuffer(buffer: Buffer): Promise<ZipFile> {
@@ -413,7 +413,7 @@ function writeEntry(entry: Entry, zipFile: ZipFile, outputPath: string, expected
 }
 
 async function validateExtractedPet(tempDir: string): Promise<void> {
-  const petJsonPath = join(tempDir, "pet.json");
+  const petJsonPath = join(tempDir, "familiar.json");
   const spritesheetPath = join(tempDir, "spritesheet.webp");
   assertOutputPathInside(tempDir, petJsonPath);
   assertOutputPathInside(tempDir, spritesheetPath);
@@ -424,20 +424,20 @@ async function validateExtractedPet(tempDir: string): Promise<void> {
   if (spritesheet.size > maxIndividualFileBytes) throw new Error("spritesheet.webp is too large.");
 }
 
-async function readCurrentState(userData: string): Promise<OpenPetsState> {
-  const statePath = join(userData, "openpets-state.json");
+async function readCurrentState(userData: string): Promise<FamiliarOSState> {
+  const statePath = join(userData, "familiaros-state.json");
   return normalizeState(existsSync(statePath) ? JSON.parse(await readFile(statePath, "utf8")) as unknown : undefined, userData);
 }
 
 async function writeInstalledPetState(userData: string, catalogPet: CatalogPet): Promise<void> {
-  const statePath = join(userData, "openpets-state.json");
+  const statePath = join(userData, "familiaros-state.json");
   const current = await readCurrentState(userData);
-  if (current.pets.installed.some((pet) => pet.id === catalogPet.id)) throw new Error(`Pet is already installed: ${catalogPet.id}`);
-  const next: OpenPetsState = {
+  if (current.familiars.installed.some((familiar) => familiar.id === catalogPet.id)) throw new Error(`Familiar is already installed: ${catalogPet.id}`);
+  const next: FamiliarOSState = {
     ...current,
-    pets: {
+    familiars: {
       installed: [
-        ...current.pets.installed,
+        ...current.familiars.installed,
         {
           id: catalogPet.id,
           displayName: catalogPet.displayName,
@@ -456,14 +456,14 @@ async function writeInstalledPetState(userData: string, catalogPet: CatalogPet):
   await rename(tempPath, statePath);
 }
 
-function normalizeState(value: unknown, userData: string): OpenPetsState {
+function normalizeState(value: unknown, userData: string): FamiliarOSState {
   const record = isRecord(value) ? value : {};
   const preferences = isRecord(record.preferences) ? record.preferences : {};
-  const petsRecord = isRecord(record.pets) ? record.pets : {};
+  const petsRecord = isRecord(record.familiars) ? record.familiars : {};
   const installed = Array.isArray(petsRecord.installed)
-    ? petsRecord.installed.map((pet) => normalizeInstalledPet(pet, userData)).filter((pet): pet is InstalledPetState => Boolean(pet && pet.id !== builtInPet.id))
+    ? petsRecord.installed.map((familiar) => normalizeInstalledPet(familiar, userData)).filter((familiar): familiar is InstalledPetState => Boolean(familiar && familiar.id !== builtInPet.id))
     : [];
-  const defaultPetId = typeof preferences.defaultPetId === "string" && [builtInPet, ...installed].some((pet) => pet.id === preferences.defaultPetId) ? preferences.defaultPetId : builtInPet.id;
+  const defaultPetId = typeof preferences.defaultPetId === "string" && [builtInPet, ...installed].some((familiar) => familiar.id === preferences.defaultPetId) ? preferences.defaultPetId : builtInPet.id;
   return {
     version: 1,
     preferences: {
@@ -475,7 +475,7 @@ function normalizeState(value: unknown, userData: string): OpenPetsState {
       claudeCommandPath: typeof preferences.claudeCommandPath === "string" ? preferences.claudeCommandPath : undefined,
       opencodeCommandPath: typeof preferences.opencodeCommandPath === "string" ? preferences.opencodeCommandPath : undefined,
     },
-    pets: { installed: [builtInPet, ...installed] },
+    familiars: { installed: [builtInPet, ...installed] },
     defaultPet: isRecord(record.defaultPet) ? record.defaultPet : {},
   };
 }
@@ -487,8 +487,8 @@ function normalizeInstalledPet(value: unknown, userData: string): InstalledPetSt
   } catch {
     return null;
   }
-  const petDir = getInstalledPetDir(join(userData, "pets"), value.id);
-  const missingFiles = !existsSync(join(petDir, "pet.json")) || !existsSync(join(petDir, "spritesheet.webp"));
+  const petDir = getInstalledPetDir(join(userData, "familiars"), value.id);
+  const missingFiles = !existsSync(join(petDir, "familiar.json")) || !existsSync(join(petDir, "spritesheet.webp"));
   return {
     id: value.id,
     displayName: value.displayName,
@@ -500,7 +500,7 @@ function normalizeInstalledPet(value: unknown, userData: string): InstalledPetSt
       ? { kind: "catalog", catalogVersion: 2, zip: value.source.zip, preview: value.source.preview }
       : undefined,
     broken: missingFiles ? true : typeof value.broken === "boolean" ? value.broken : undefined,
-    brokenReason: missingFiles ? "Installed pet files are missing." : typeof value.brokenReason === "string" ? value.brokenReason : undefined,
+    brokenReason: missingFiles ? "Installed familiar files are missing." : typeof value.brokenReason === "string" ? value.brokenReason : undefined,
   };
 }
 
@@ -530,7 +530,7 @@ function getInstalledPetDir(petsRoot: string, petId: string): string {
 function assertInsideRoot(root: string, target: string): void {
   const resolvedRoot = resolve(root);
   const resolvedTarget = resolve(target);
-  if (resolvedTarget !== resolvedRoot && !resolvedTarget.startsWith(`${resolvedRoot}${sep}`)) throw new Error("Resolved path escapes OpenPets directory.");
+  if (resolvedTarget !== resolvedRoot && !resolvedTarget.startsWith(`${resolvedRoot}${sep}`)) throw new Error("Resolved path escapes FamiliarOS directory.");
 }
 
 function assertOutputPathInside(root: string, target: string): void {
@@ -542,7 +542,7 @@ function hasSupportedZipMagic(buffer: Buffer): boolean {
 }
 
 function readString(value: unknown, field: string, maxLength: number): string {
-  if (typeof value !== "string" || value.length < 1 || value.length > maxLength) throw new Error(`Catalog pet ${field} is invalid.`);
+  if (typeof value !== "string" || value.length < 1 || value.length > maxLength) throw new Error(`Catalog familiar ${field} is invalid.`);
   return value;
 }
 
@@ -551,7 +551,7 @@ function isRecord(value: unknown): value is Record<string, unknown> {
 }
 
 function printUsage(): void {
-  process.stdout.write("Usage:\n  install-pet <pet-id>\n\nInstalls a pet from the OpenPets gallery into your local OpenPets app data.\nExample:\n  npx -y install-pet review-owl\n");
+  process.stdout.write("Usage:\n  install-familiar <familiar-id>\n\nInstalls a familiar from the FamiliarOS gallery into your local FamiliarOS app data.\nExample:\n  npx -y install-familiar review-owl\n");
 }
 
 if (isMainModule()) {
diff --git a/packages/install-pet/tsconfig.json b/packages/install-familiar/tsconfig.json
similarity index 100%
rename from packages/install-pet/tsconfig.json
rename to packages/install-familiar/tsconfig.json
diff --git a/packages/install-pet/src/check-install-pet.ts b/packages/install-pet/src/check-install-pet.ts
deleted file mode 100644
index 4b40e133..00000000
--- a/packages/install-pet/src/check-install-pet.ts
+++ /dev/null
@@ -1,36 +0,0 @@
-import assert from "node:assert/strict";
-import { join } from "node:path";
-
-import { getOpenPetsUserDataPath, parseArgs, validateCatalog, validatePetId } from "./index.js";
-
-assert.deepEqual(parseArgs(["review-owl"]), { petId: "review-owl", help: false });
-assert.equal(parseArgs(["--help"]).help, true);
-assert.equal(validatePetId("review-owl"), "review-owl");
-assert.throws(() => validatePetId("../bad"));
-assert.throws(() => validatePetId("builtin"));
-
-assert.equal(getOpenPetsUserDataPath("darwin", {}), join(process.env.HOME || "", "Library", "Application Support", "OpenPets"));
-assert.equal(getOpenPetsUserDataPath("linux", { XDG_CONFIG_HOME: "/tmp/config" }), join("/tmp/config", "OpenPets"));
-assert.equal(getOpenPetsUserDataPath("win32", { APPDATA: "C:\\Users\\me\\AppData\\Roaming" }), join("C:\\Users\\me\\AppData\\Roaming", "OpenPets"));
-assert.equal(getOpenPetsUserDataPath("linux", { OPENPETS_USER_DATA: "/tmp/openpets-test" }), "/tmp/openpets-test");
-
-assert.deepEqual(validateCatalog({
-  version: 2,
-  generatedAt: new Date().toISOString(),
-  pets: [{
-    id: "review-owl",
-    displayName: "Review Owl",
-    description: "A reviewer pet.",
-    preview: "https://openpets.dev/pets/review-owl/preview.webp",
-    zip: "https://zip.openpets.dev/pets/review-owl.zip",
-  }],
-}), [{
-  id: "review-owl",
-  displayName: "Review Owl",
-  description: "A reviewer pet.",
-  preview: "https://openpets.dev/pets/review-owl/preview.webp",
-  zip: "https://zip.openpets.dev/pets/review-owl.zip",
-}]);
-assert.throws(() => validateCatalog({ version: 2, pets: [{ id: "bad/pet" }] }));
-
-console.log("install-pet validation passed.");
diff --git a/packages/mcp/codemap.md b/packages/mcp/codemap.md
index fad1c612..e6d8eff3 100644
--- a/packages/mcp/codemap.md
+++ b/packages/mcp/codemap.md
@@ -1,16 +1,16 @@
 # packages/mcp/
 
-MCP (Model Context Protocol) server for OpenPets integration.
+MCP (Model Context Protocol) server for FamiliarOS integration.
 
 ## Responsibility
 
-Implements an MCP server exposing OpenPets functionality to AI agents via the Model Context Protocol. Provides tools for checking status, setting reactions, and displaying messages on the desktop pet.
+Implements an MCP server exposing FamiliarOS functionality to AI agents via the Model Context Protocol. Provides tools for checking status, setting reactions, and displaying messages on the desktop familiar.
 
 ## Design
 
 **MCP Server Setup** (`server.ts`):
 - `McpServer` from `@modelcontextprotocol/sdk`
-- Three registered tools: `openpets_status`, `openpets_react`, `openpets_say`
+- Three registered tools: `familiaros_status`, `familiaros_react`, `familiaros_say`
 - Tool annotations for read-only/idempotent hints
 - Instructions for AI agents (safety guidelines)
 
@@ -27,9 +27,9 @@ Implements an MCP server exposing OpenPets functionality to AI agents via the Mo
 - Stdio transport via `StdioServerTransport`
 
 **Argument Parsing** (`args.ts`):
-- `--pet <id>` for targeted pet selection
+- `--familiar <id>` for targeted familiar selection
 - `--help`, `--version` flags
-- Pet ID validation (regex: `^[a-z0-9][a-z0-9_-]{0,63}$`)
+- Familiar ID validation (regex: `^[a-z0-9][a-z0-9_-]{0,63}$`)
 
 **Build Integration** (`ensure-executable.ts`):
 - Post-build chmod 0o755 for Unix binaries
@@ -45,7 +45,7 @@ createToolContext() → { client, configuredPetId }
     ↓
 acquireStartupLease() → lease.lease set on success
     ↓
-createOpenPetsMcpServer() → Register 3 tools
+createFamiliarOSMcpServer() → Register 3 tools
     ↓
 server.connect(StdioServerTransport)
     ↓
@@ -57,12 +57,12 @@ server.connect(StdioServerTransport)
 ## Integration Points
 
 **Dependencies**:
-- `@open-pets/client` - IPC communication
+- `@familiaros/client` - IPC communication
 - `@modelcontextprotocol/sdk` - MCP protocol implementation
 - `zod` - Schema validation
 
-**CLI Integration**: Spawned by `@open-pets/cli` via `runMcp()` which forwards stdio and signals.
+**CLI Integration**: Spawned by `@familiaros/cli` via `runMcp()` which forwards stdio and signals.
 
 **Exports**:
-- Binary: `open-pets-mcp` (stdio MCP server)
+- Binary: `familiaros-mcp` (stdio MCP server)
 - No programmatic exports (MCP server is standalone)
diff --git a/packages/mcp/package.json b/packages/mcp/package.json
index cac4d2e9..ce221847 100644
--- a/packages/mcp/package.json
+++ b/packages/mcp/package.json
@@ -1,17 +1,17 @@
 {
-  "name": "@open-pets/mcp",
+  "name": "@familiaros/mcp",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/mcp"
   },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "open-pets-mcp": "./dist/index.js"
+    "familiaros-mcp": "./dist/index.js"
   },
   "files": [
     "dist"
@@ -27,7 +27,7 @@
   },
   "scripts": {
     "test": "node dist/check-mcp-contract.js",
-    "check": "pnpm --filter @open-pets/client build && pnpm typecheck && pnpm build && pnpm test",
+    "check": "pnpm --filter @familiaros/client build && pnpm typecheck && pnpm build && pnpm test",
     "typecheck": "tsc --noEmit",
     "build": "tsc && node dist/ensure-executable.js"
   },
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@open-pets/client": "workspace:*",
+    "@familiaros/client": "workspace:*",
     "zod": "^4.4.3"
   }
 }
diff --git a/packages/mcp/src/args.ts b/packages/mcp/src/args.ts
index 814db3eb..26049059 100644
--- a/packages/mcp/src/args.ts
+++ b/packages/mcp/src/args.ts
@@ -19,15 +19,15 @@ export function parseMcpArgs(argv: readonly string[]): McpCliOptions {
       version = true;
       continue;
     }
-    if (arg === "--pet") {
+    if (arg === "--familiar") {
       const next = argv[index + 1];
-      if (!next) throw new Error("--pet requires a pet id.");
+      if (!next) throw new Error("--familiar requires a familiar id.");
       petId = validateRawPetArg(next);
       index += 1;
       continue;
     }
-    if (arg.startsWith("--pet=")) {
-      petId = validateRawPetArg(arg.slice("--pet=".length));
+    if (arg.startsWith("--familiar=")) {
+      petId = validateRawPetArg(arg.slice("--familiar=".length));
       continue;
     }
     throw new Error(`Unknown argument: ${arg}`);
@@ -38,20 +38,20 @@ export function parseMcpArgs(argv: readonly string[]): McpCliOptions {
 
 export function validatePetId(value: string): string {
   if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(value) || value === "builtin") {
-    throw new Error(`Invalid pet id: ${value}`);
+    throw new Error(`Invalid familiar id: ${value}`);
   }
   return value;
 }
 
 export function validateRawPetArg(value: string): string {
   const trimmed = value.trim();
-  if (trimmed.length < 1) throw new Error("--pet requires a non-empty pet id.");
+  if (trimmed.length < 1) throw new Error("--familiar requires a non-empty familiar id.");
   if (Buffer.byteLength(trimmed, "utf8") > 128 || /[\x00-\x1F\x7F/\\]/.test(trimmed)) {
-    throw new Error("--pet value is outside OpenPets CLI bounds.");
+    throw new Error("--familiar value is outside FamiliarOS CLI bounds.");
   }
   return trimmed;
 }
 
 export function createHelpText(): string {
-  return `OpenPets MCP server\n\nUsage:\n  open-pets-mcp [--pet <petId>]\n\nOptions:\n  --pet <petId>  Request an installed OpenPets pet for this MCP process; missing pets fall back to default.\n  --help         Show this help.\n  --version      Show package version.\n`;
+  return `FamiliarOS MCP server\n\nUsage:\n  familiaros-mcp [--familiar <petId>]\n\nOptions:\n  --familiar <petId>  Request an installed FamiliarOS familiar for this MCP process; missing familiars fall back to default.\n  --help         Show this help.\n  --version      Show package version.\n`;
 }
diff --git a/packages/mcp/src/check-mcp-contract.ts b/packages/mcp/src/check-mcp-contract.ts
index ab1a56ba..1c9b39b1 100644
--- a/packages/mcp/src/check-mcp-contract.ts
+++ b/packages/mcp/src/check-mcp-contract.ts
@@ -7,24 +7,24 @@ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
 import { CallToolResultSchema } from "@modelcontextprotocol/sdk/types.js";
 
 import { parseMcpArgs } from "./args.js";
-import { createOpenPetsMcpServer } from "./server.js";
-import { createMcpStatus, sanitizeUnavailableReason, type OpenPetsMcpStatus } from "./tools.js";
+import { createFamiliarOSMcpServer } from "./server.js";
+import { createMcpStatus, sanitizeUnavailableReason, type FamiliarOSMcpStatus } from "./tools.js";
 
-parseMcpArgs(["--pet", "snoopy"]);
-parseMcpArgs(["--pet=snoopy"]);
-parseMcpArgs(["--pet", "Bad Pet"]);
+parseMcpArgs(["--familiar", "snoopy"]);
+parseMcpArgs(["--familiar=snoopy"]);
+parseMcpArgs(["--familiar", "Bad Familiar"]);
 parseMcpArgs(["--help"]);
-assertRejects(() => parseMcpArgs(["--pet", "bad/pet"]));
+assertRejects(() => parseMcpArgs(["--familiar", "bad/familiar"]));
 assertRejects(() => parseMcpArgs(["--agent", "claude"]));
 
-const unavailableStatus = createMcpStatus({ ok: false, appRunning: false, unavailableReason: "/Users/alvin/.config/OpenPets/runtime/ipc.json ENOENT" }, "snoopy");
+const unavailableStatus = createMcpStatus({ ok: false, appRunning: false, unavailableReason: "/Users/alvin/.config/FamiliarOS/runtime/ipc.json ENOENT" }, "snoopy");
 if (unavailableStatus.routingImplemented !== true || unavailableStatus.configuredPetId !== "snoopy") {
-  throw new Error("MCP status did not preserve configured pet during degraded status.");
+  throw new Error("MCP status did not preserve configured familiar during degraded status.");
 }
 if (unavailableStatus.unavailableReason?.includes("/Users/")) {
   throw new Error("Unavailable reason leaked a local path.");
 }
-if (sanitizeUnavailableReason("/tmp/openpets-501/openpets-1.sock ENOENT")?.includes("/tmp")) {
+if (sanitizeUnavailableReason("/tmp/familiaros-501/familiaros-1.sock ENOENT")?.includes("/tmp")) {
   throw new Error("Sanitizer leaked socket path.");
 }
 
@@ -41,7 +41,7 @@ async function checkMcpServerContract(): Promise<void> {
   const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
   const fakeClient = {
     status: async () => ({ ok: true, appRunning: true, defaultPet: { id: "snoopy", displayName: "Snoopy" } }),
-    listPets: async () => ({ ok: true as const, pets: [], defaultPetId: "builtin" }),
+    listPets: async () => ({ ok: true as const, familiars: [], defaultPetId: "builtin" }),
     installPet: async () => { throw new Error("unused"); },
     acquireLease: async () => ({ leaseId: "lease-1", requestedPetId: "snoopy", targetKind: "explicit" as const, actualTargetPetId: "snoopy", actualTargetPetName: "Snoopy", usingDefaultPet: false, expiresAt: Date.now() + 15_000, leaseActive: true }),
     heartbeatLease: async (leaseId: string) => ({ leaseId, expiresAt: Date.now() + 15_000 }),
@@ -57,46 +57,46 @@ async function checkMcpServerContract(): Promise<void> {
     deleteMemory: async (id: string) => ({ ok: true as const, id, deleted: true }),
     hello: async () => ({ ok: true }),
   };
-  const server = createOpenPetsMcpServer({ configuredPetId: "snoopy", client: fakeClient, lease: { lease: await fakeClient.acquireLease() }, leaseReady: Promise.resolve() });
-  const client = new Client({ name: "openpets-contract", version: "0.0.0" });
+  const server = createFamiliarOSMcpServer({ configuredPetId: "snoopy", client: fakeClient, lease: { lease: await fakeClient.acquireLease() }, leaseReady: Promise.resolve() });
+  const client = new Client({ name: "familiaros-contract", version: "0.0.0" });
 
   await Promise.all([server.connect(serverTransport), client.connect(clientTransport)]);
   try {
     const tools = await client.listTools();
     const names = tools.tools.map((tool) => tool.name).sort();
-    if (names.join(",") !== "openpets_memory_forget,openpets_memory_list,openpets_memory_search,openpets_memory_store,openpets_react,openpets_say,openpets_status") {
+    if (names.join(",") !== "familiaros_memory_forget,familiaros_memory_list,familiaros_memory_search,familiaros_memory_store,familiaros_react,familiaros_say,familiaros_status") {
       throw new Error(`Unexpected MCP tool list: ${names.join(",")}`);
     }
 
-    const status = await client.callTool({ name: "openpets_status", arguments: {} }, CallToolResultSchema);
-    const structured = status.structuredContent as unknown as OpenPetsMcpStatus;
+    const status = await client.callTool({ name: "familiaros_status", arguments: {} }, CallToolResultSchema);
+    const structured = status.structuredContent as unknown as FamiliarOSMcpStatus;
     if (!structured.ok || structured.configuredPetId !== "snoopy" || structured.routingImplemented !== true || structured.actualTargetPetId !== "snoopy") {
       throw new Error("Status tool returned unexpected structured content.");
     }
 
-    const react = await client.callTool({ name: "openpets_react", arguments: { reaction: "waving" } }, CallToolResultSchema);
+    const react = await client.callTool({ name: "familiaros_react", arguments: { reaction: "waving" } }, CallToolResultSchema);
     if (react.isError) throw new Error("Valid reaction unexpectedly failed.");
     const reactStructured = react.structuredContent as { readonly result?: { readonly leaseId?: string } } | undefined;
     if (reactStructured?.result?.leaseId !== "lease-1") throw new Error("Reaction did not pass lease id to client.");
 
-    const invalidReact = await client.callTool({ name: "openpets_react", arguments: { reaction: "bad" } }, CallToolResultSchema);
+    const invalidReact = await client.callTool({ name: "familiaros_react", arguments: { reaction: "bad" } }, CallToolResultSchema);
     if (!invalidReact.isError) throw new Error("Invalid reaction was not rejected.");
 
-    const invalidSay = await client.callTool({ name: "openpets_say", arguments: { message: "const secret = 1" } }, CallToolResultSchema);
+    const invalidSay = await client.callTool({ name: "familiaros_say", arguments: { message: "const secret = 1" } }, CallToolResultSchema);
     if (!invalidSay.isError) throw new Error("Unsafe say message was not rejected.");
 
-    const memoryList = await client.callTool({ name: "openpets_memory_list", arguments: {} }, CallToolResultSchema);
+    const memoryList = await client.callTool({ name: "familiaros_memory_list", arguments: {} }, CallToolResultSchema);
     if (memoryList.isError) throw new Error("Memory list unexpectedly failed.");
     const memoryListText = Array.isArray(memoryList.content) && memoryList.content[0] && "text" in memoryList.content[0] ? String(memoryList.content[0].text) : "";
     if (!memoryListText.includes("User likes tea.")) throw new Error("Memory list did not include stored memory text.");
 
-    const memorySearch = await client.callTool({ name: "openpets_memory_search", arguments: { query: "tea" } }, CallToolResultSchema);
+    const memorySearch = await client.callTool({ name: "familiaros_memory_search", arguments: { query: "tea" } }, CallToolResultSchema);
     if (memorySearch.isError) throw new Error("Memory search unexpectedly failed.");
 
-    const memoryStore = await client.callTool({ name: "openpets_memory_store", arguments: { text: "User prefers compact windows.", kind: "preference" } }, CallToolResultSchema);
+    const memoryStore = await client.callTool({ name: "familiaros_memory_store", arguments: { text: "User prefers compact windows.", kind: "preference" } }, CallToolResultSchema);
     if (memoryStore.isError) throw new Error("Memory store unexpectedly failed.");
 
-    const memoryForget = await client.callTool({ name: "openpets_memory_forget", arguments: { id: "mem-2" } }, CallToolResultSchema);
+    const memoryForget = await client.callTool({ name: "familiaros_memory_forget", arguments: { id: "mem-2" } }, CallToolResultSchema);
     if (memoryForget.isError) throw new Error("Memory forget unexpectedly failed.");
 
     const stale = createMcpStatus({ ok: false, appRunning: true, leaseId: "missing", leaseActive: false, staleReason: "unknown_lease" }, "snoopy", undefined, "missing", "missing");
@@ -112,27 +112,27 @@ async function checkMcpServerContract(): Promise<void> {
 async function checkStdioServerContract(): Promise<void> {
   const transport = new StdioClientTransport({
     command: process.execPath,
-    args: [join("dist", "index.js"), "--pet", "snoopy"],
-    env: { ...process.env, OPENPETS_DISCOVERY_FILE: join(process.cwd(), ".missing-openpets-discovery.json") },
+    args: [join("dist", "index.js"), "--familiar", "snoopy"],
+    env: { ...process.env, FAMILIAROS_DISCOVERY_FILE: join(process.cwd(), ".missing-familiaros-discovery.json") },
     stderr: "pipe",
   });
-  const client = new Client({ name: "openpets-stdio-contract", version: "0.0.0" });
+  const client = new Client({ name: "familiaros-stdio-contract", version: "0.0.0" });
   await client.connect(transport);
   try {
     const tools = await client.listTools();
     const names = tools.tools.map((tool) => tool.name).sort();
-    if (names.join(",") !== "openpets_memory_forget,openpets_memory_list,openpets_memory_search,openpets_memory_store,openpets_react,openpets_say,openpets_status") {
+    if (names.join(",") !== "familiaros_memory_forget,familiaros_memory_list,familiaros_memory_search,familiaros_memory_store,familiaros_react,familiaros_say,familiaros_status") {
       throw new Error(`Unexpected stdio MCP tool list: ${names.join(",")}`);
     }
 
-    const status = await client.callTool({ name: "openpets_status", arguments: {} }, CallToolResultSchema);
+    const status = await client.callTool({ name: "familiaros_status", arguments: {} }, CallToolResultSchema);
     const content = Array.isArray(status.content) ? status.content : [];
     const first = content[0] as { readonly type?: unknown; readonly text?: unknown } | undefined;
     const text = first?.type === "text" && typeof first.text === "string" ? first.text : "";
-    if (!text.includes("Configured --pet snoopy") || !text.includes("actual target is unavailable")) {
-      throw new Error("Unavailable stdio status did not explain configured pet and unavailable target.");
+    if (!text.includes("Configured --familiar snoopy") || !text.includes("actual target is unavailable")) {
+      throw new Error("Unavailable stdio status did not explain configured familiar and unavailable target.");
     }
-    const structured = status.structuredContent as unknown as OpenPetsMcpStatus;
+    const structured = status.structuredContent as unknown as FamiliarOSMcpStatus;
     if (structured.appRunning !== false || structured.configuredPetId !== "snoopy" || structured.routingImplemented !== true) {
       throw new Error("Unavailable stdio status returned unexpected structured content.");
     }
diff --git a/packages/mcp/src/codemap.md b/packages/mcp/src/codemap.md
index b45bbf84..3bc1f7b8 100644
--- a/packages/mcp/src/codemap.md
+++ b/packages/mcp/src/codemap.md
@@ -3,7 +3,7 @@
 ## Files
 
 - **index.ts**: Main entry (99 lines). Argument parsing, lease acquisition, heartbeat management, signal handling, graceful shutdown.
-- **server.ts**: MCP server factory (32 lines). `createOpenPetsMcpServer()` registers `openpets_status`, `openpets_react`, `openpets_say` tools with metadata.
+- **server.ts**: MCP server factory (32 lines). `createFamiliarOSMcpServer()` registers `familiaros_status`, `familiaros_react`, `familiaros_say` tools with metadata.
 - **tools.ts**: Tool implementations (181 lines). Zod schemas, `handleStatus()`, `handleReact()`, `handleSay()`, `createToolContext()`, `createMcpStatus()`, throttling integration, error sanitization.
 - **args.ts**: CLI argument parsing (57 lines). `parseMcpArgs()`, `validatePetId()`, `createHelpText()`.
 - **ensure-executable.ts**: Post-build chmod for Unix (9 lines).
diff --git a/packages/mcp/src/index.ts b/packages/mcp/src/index.ts
index 227cec46..b3ffc613 100644
--- a/packages/mcp/src/index.ts
+++ b/packages/mcp/src/index.ts
@@ -6,7 +6,7 @@ import { fileURLToPath } from "node:url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 import { createHelpText, parseMcpArgs } from "./args.js";
-import { createOpenPetsMcpServer } from "./server.js";
+import { createFamiliarOSMcpServer } from "./server.js";
 import { createToolContext, type LeaseContext } from "./tools.js";
 
 async function main(): Promise<void> {
@@ -25,7 +25,7 @@ async function main(): Promise<void> {
   const lease: LeaseContext = {};
   const context = createToolContext(options.petId);
   const leaseReady = acquireStartupLease(context.client, lease, options.petId);
-  const server = createOpenPetsMcpServer({ ...context, lease, leaseReady });
+  const server = createFamiliarOSMcpServer({ ...context, lease, leaseReady });
   let heartbeatTimer: NodeJS.Timeout | null = null;
   let retryTimer: NodeJS.Timeout | null = null;
   let retryDelayMs = 5_000;
@@ -101,15 +101,15 @@ async function acquireStartupLease(client: ReturnType<typeof createToolContext>[
 }
 
 function sanitizeMcpRuntimeError(error: unknown): string {
-  const message = error instanceof Error ? error.message : "OpenPets lease operation failed.";
+  const message = error instanceof Error ? error.message : "FamiliarOS lease operation failed.";
   if (/\/|\\|\.sock|pipe|token|ipc\.json|ENOENT|ECONNREFUSED|EACCES/i.test(message)) {
-    return "OpenPets desktop app or local IPC is unavailable.";
+    return "FamiliarOS desktop app or local IPC is unavailable.";
   }
   return message.slice(0, 160);
 }
 
 main().catch((error: unknown) => {
-  process.stderr.write(`OpenPets MCP server failed: ${error instanceof Error ? error.message : String(error)}\n`);
+  process.stderr.write(`FamiliarOS MCP server failed: ${error instanceof Error ? error.message : String(error)}\n`);
   process.exit(1);
 });
 
diff --git a/packages/mcp/src/server.ts b/packages/mcp/src/server.ts
index 1638536c..3538ea80 100644
--- a/packages/mcp/src/server.ts
+++ b/packages/mcp/src/server.ts
@@ -2,56 +2,56 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 import { handleMemoryForget, handleMemoryList, handleMemorySearch, handleMemoryStore, handleReact, handleSay, handleStatus, memoryForgetSchema, memoryListSchema, memorySearchSchema, memoryStoreSchema, reactSchema, saySchema, type ToolContext } from "./tools.js";
 
-export function createOpenPetsMcpServer(context: ToolContext): McpServer {
-  const server = new McpServer({ name: "open-pets", version: "0.0.0" }, {
-    instructions: "Interact with the user's OpenPets desktop companion. Use openpets_status first. Use openpets_say only for short status/personality messages, never code, logs, secrets, URLs, or file paths. Use the openpets_memory_* tools for durable user preferences or facts instead of overloading the speech bubble.",
+export function createFamiliarOSMcpServer(context: ToolContext): McpServer {
+  const server = new McpServer({ name: "familiaros", version: "0.0.0" }, {
+    instructions: "Interact with the user's FamiliarOS desktop companion. Use familiaros_status first. Use familiaros_say only for short status/personality messages, never code, logs, secrets, URLs, or file paths. Use the familiaros_memory_* tools for durable user preferences or facts instead of overloading the speech bubble.",
   });
 
-  server.registerTool("openpets_status", {
-    title: "OpenPets Status",
-    description: "Check whether OpenPets is reachable and which pet MCP events currently target.",
+  server.registerTool("familiaros_status", {
+    title: "FamiliarOS Status",
+    description: "Check whether FamiliarOS is reachable and which familiar MCP events currently target.",
     inputSchema: {},
     annotations: { readOnlyHint: true, idempotentHint: true },
   }, async () => handleStatus(context));
 
-  server.registerTool("openpets_react", {
-    title: "OpenPets React",
-    description: "Set a short coding-oriented reaction on the OpenPets desktop pet.",
+  server.registerTool("familiaros_react", {
+    title: "FamiliarOS React",
+    description: "Set a short coding-oriented reaction on the FamiliarOS desktop familiar.",
     inputSchema: reactSchema,
     annotations: { readOnlyHint: false, idempotentHint: false },
   }, async (input) => handleReact(input, context));
 
-  server.registerTool("openpets_say", {
-    title: "OpenPets Say",
-    description: "Show a short safe message on the OpenPets desktop pet. Do not send code, logs, secrets, URLs, or file paths.",
+  server.registerTool("familiaros_say", {
+    title: "FamiliarOS Say",
+    description: "Show a short safe message on the FamiliarOS desktop familiar. Do not send code, logs, secrets, URLs, or file paths.",
     inputSchema: saySchema,
     annotations: { readOnlyHint: false, idempotentHint: false },
   }, async (input) => handleSay(input, context));
 
-  server.registerTool("openpets_memory_list", {
-    title: "OpenPets Memory List",
-    description: "List recent long-term memories stored by OpenPets.",
+  server.registerTool("familiaros_memory_list", {
+    title: "FamiliarOS Memory List",
+    description: "List recent long-term memories stored by FamiliarOS.",
     inputSchema: memoryListSchema,
     annotations: { readOnlyHint: true, idempotentHint: true },
   }, async (input) => handleMemoryList(input, context));
 
-  server.registerTool("openpets_memory_search", {
-    title: "OpenPets Memory Search",
-    description: "Search OpenPets long-term memory for relevant facts or preferences.",
+  server.registerTool("familiaros_memory_search", {
+    title: "FamiliarOS Memory Search",
+    description: "Search FamiliarOS long-term memory for relevant facts or preferences.",
     inputSchema: memorySearchSchema,
     annotations: { readOnlyHint: true, idempotentHint: true },
   }, async (input) => handleMemorySearch(input, context));
 
-  server.registerTool("openpets_memory_store", {
-    title: "OpenPets Memory Store",
-    description: "Store a durable user fact, preference, or note in OpenPets memory.",
+  server.registerTool("familiaros_memory_store", {
+    title: "FamiliarOS Memory Store",
+    description: "Store a durable user fact, preference, or note in FamiliarOS memory.",
     inputSchema: memoryStoreSchema,
     annotations: { readOnlyHint: false, idempotentHint: false },
   }, async (input) => handleMemoryStore(input, context));
 
-  server.registerTool("openpets_memory_forget", {
-    title: "OpenPets Memory Forget",
-    description: "Delete a stored OpenPets memory by id.",
+  server.registerTool("familiaros_memory_forget", {
+    title: "FamiliarOS Memory Forget",
+    description: "Delete a stored FamiliarOS memory by id.",
     inputSchema: memoryForgetSchema,
     annotations: { readOnlyHint: false, idempotentHint: false },
   }, async (input) => handleMemoryForget(input, context));
diff --git a/packages/mcp/src/tools.ts b/packages/mcp/src/tools.ts
index 0a1f568c..5acbd0c2 100644
--- a/packages/mcp/src/tools.ts
+++ b/packages/mcp/src/tools.ts
@@ -1,5 +1,5 @@
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-import { allowedReactions, createOpenPetsClient, OpenPetsClientError, type OpenPetsClient, type OpenPetsLeaseResult, type OpenPetsMemoryDeleteResult, type OpenPetsMemoryEntry, type OpenPetsMemoryKind, type OpenPetsMemoryListResult, type OpenPetsMemorySearchResult, type OpenPetsMemoryStoreResult, type OpenPetsReaction, type OpenPetsStatusResult } from "@open-pets/client";
+import { allowedReactions, createFamiliarOSClient, FamiliarOSClientError, type FamiliarOSClient, type FamiliarOSLeaseResult, type FamiliarOSMemoryDeleteResult, type FamiliarOSMemoryEntry, type FamiliarOSMemoryKind, type FamiliarOSMemoryListResult, type FamiliarOSMemorySearchResult, type FamiliarOSMemoryStoreResult, type FamiliarOSReaction, type FamiliarOSStatusResult } from "@familiaros/client";
 import { z } from "zod";
 
 export const reactionSchema = z.enum(allowedReactions);
@@ -31,7 +31,7 @@ export const memoryForgetSchema = z.object({
   id: z.string().trim().min(1).max(80),
 });
 
-export interface OpenPetsMcpStatus {
+export interface FamiliarOSMcpStatus {
   readonly [key: string]: unknown;
   ok: boolean;
   appRunning: boolean;
@@ -45,44 +45,44 @@ export interface OpenPetsMcpStatus {
 }
 
 export interface LeaseContext {
-  lease?: OpenPetsLeaseResult;
+  lease?: FamiliarOSLeaseResult;
   staleLeaseId?: string;
   degradedReason?: string;
 }
 
 export interface ToolContext {
   readonly configuredPetId?: string;
-  readonly client?: OpenPetsClient;
+  readonly client?: FamiliarOSClient;
   readonly lease?: LeaseContext;
   readonly leaseReady?: Promise<void>;
 }
 
-export function createToolContext(configuredPetId?: string): ToolContext & { readonly client: OpenPetsClient } {
+export function createToolContext(configuredPetId?: string): ToolContext & { readonly client: FamiliarOSClient } {
   return {
     configuredPetId,
-    client: createOpenPetsClient(),
+    client: createFamiliarOSClient(),
   };
 }
 
 export async function handleStatus(context: ToolContext): Promise<CallToolResult> {
   await context.leaseReady;
-  const client = context.client ?? createOpenPetsClient();
+  const client = context.client ?? createFamiliarOSClient();
   const leaseId = context.lease?.lease?.leaseId ?? context.lease?.staleLeaseId;
   const status = await client.status({ leaseId });
   const structured = createMcpStatus(status, context.configuredPetId, context.lease?.lease, context.lease?.degradedReason, context.lease?.staleLeaseId);
   const configuredText = context.configuredPetId
-    ? `Configured --pet ${context.configuredPetId}; actual target is ${structured.actualTargetPetId ?? "unavailable"}.`
-    : "No --pet configured; actual target is the desktop default pet.";
+    ? `Configured --familiar ${context.configuredPetId}; actual target is ${structured.actualTargetPetId ?? "unavailable"}.`
+    : "No --familiar configured; actual target is the desktop default familiar.";
 
   if (!structured.appRunning) {
     return {
-      content: [{ type: "text", text: `OpenPets is unavailable. ${configuredText} ${structured.unavailableReason ?? "Open the OpenPets desktop app and try again."}` }],
+      content: [{ type: "text", text: `FamiliarOS is unavailable. ${configuredText} ${structured.unavailableReason ?? "Open the FamiliarOS desktop app and try again."}` }],
       structuredContent: structured,
     };
   }
 
   return {
-    content: [{ type: "text", text: `OpenPets is running. ${configuredText}` }],
+    content: [{ type: "text", text: `FamiliarOS is running. ${configuredText}` }],
     structuredContent: structured,
   };
 }
@@ -90,7 +90,7 @@ export async function handleStatus(context: ToolContext): Promise<CallToolResult
 async function ensureLease(context: ToolContext): Promise<boolean> {
   if (context.lease?.lease) return true;
   try {
-    const client = context.client ?? createOpenPetsClient();
+    const client = context.client ?? createFamiliarOSClient();
     const newLease = await client.acquireLease({ requestedPetId: context.configuredPetId });
     if (context.lease) {
       context.lease.lease = newLease;
@@ -107,17 +107,17 @@ export async function handleReact(input: unknown, context: ToolContext): Promise
   await context.leaseReady;
   const parsed = reactSchema.safeParse(input);
   if (!parsed.success) return toolError("Invalid reaction. Use one of: " + allowedReactions.join(", "));
-  if (!(await ensureLease(context))) return toolError(`OpenPets lease is unavailable. ${sanitizeUnavailableReason(context.lease?.degradedReason) ?? "Open OpenPets and try again."}`);
+  if (!(await ensureLease(context))) return toolError(`FamiliarOS lease is unavailable. ${sanitizeUnavailableReason(context.lease?.degradedReason) ?? "Open FamiliarOS and try again."}`);
 
   try {
-    const client = context.client ?? createOpenPetsClient();
+    const client = context.client ?? createFamiliarOSClient();
     const result = await client.react(parsed.data.reaction, { leaseId: context.lease!.lease!.leaseId });
     return {
-      content: [{ type: "text", text: `OpenPets reaction sent: ${parsed.data.reaction}` }],
+      content: [{ type: "text", text: `FamiliarOS reaction sent: ${parsed.data.reaction}` }],
       structuredContent: { ok: true, reaction: parsed.data.reaction, result },
     };
   } catch (error) {
-    return toolError(`OpenPets desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
+    return toolError(`FamiliarOS desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
   }
 }
 
@@ -125,17 +125,17 @@ export async function handleSay(input: unknown, context: ToolContext): Promise<C
   await context.leaseReady;
   const parsed = saySchema.safeParse(input);
   if (!parsed.success) return toolError("Invalid message. Keep it short, single-line, and avoid code, secrets, URLs, and file paths.");
-  if (!(await ensureLease(context))) return toolError(`OpenPets lease is unavailable. ${sanitizeUnavailableReason(context.lease?.degradedReason) ?? "Open OpenPets and try again."}`);
+  if (!(await ensureLease(context))) return toolError(`FamiliarOS lease is unavailable. ${sanitizeUnavailableReason(context.lease?.degradedReason) ?? "Open FamiliarOS and try again."}`);
 
   try {
-    const client = context.client ?? createOpenPetsClient();
+    const client = context.client ?? createFamiliarOSClient();
     const result = await client.say(parsed.data.message, { reaction: parsed.data.reaction, leaseId: context.lease!.lease!.leaseId });
     return {
-      content: [{ type: "text", text: "OpenPets message sent." }],
+      content: [{ type: "text", text: "FamiliarOS message sent." }],
       structuredContent: { ok: true, result },
     };
   } catch (error) {
-    return toolError(`OpenPets desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
+    return toolError(`FamiliarOS desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
   }
 }
 
@@ -144,13 +144,13 @@ export async function handleMemoryList(input: unknown, context: ToolContext): Pr
   if (!parsed.success) return toolError("Invalid memory list request.");
 
   try {
-    const client = context.client ?? createOpenPetsClient();
+    const client = context.client ?? createFamiliarOSClient();
     const listMemories = client.listMemories;
-    if (!listMemories) return toolError("This OpenPets client build does not support memory tools yet. Update the app/integration and try again.");
+    if (!listMemories) return toolError("This FamiliarOS client build does not support memory tools yet. Update the app/integration and try again.");
     const result = await listMemories({ limit: parsed.data.limit });
     return createMemoryListResult(result);
   } catch (error) {
-    return toolError(`OpenPets desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
+    return toolError(`FamiliarOS desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
   }
 }
 
@@ -159,13 +159,13 @@ export async function handleMemorySearch(input: unknown, context: ToolContext):
   if (!parsed.success) return toolError("Invalid memory search request.");
 
   try {
-    const client = context.client ?? createOpenPetsClient();
+    const client = context.client ?? createFamiliarOSClient();
     const searchMemories = client.searchMemories;
-    if (!searchMemories) return toolError("This OpenPets client build does not support memory tools yet. Update the app/integration and try again.");
+    if (!searchMemories) return toolError("This FamiliarOS client build does not support memory tools yet. Update the app/integration and try again.");
     const result = await searchMemories(parsed.data.query, { limit: parsed.data.limit });
     return createMemorySearchResult(result);
   } catch (error) {
-    return toolError(`OpenPets desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
+    return toolError(`FamiliarOS desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
   }
 }
 
@@ -174,13 +174,13 @@ export async function handleMemoryStore(input: unknown, context: ToolContext): P
   if (!parsed.success) return toolError("Invalid memory store request.");
 
   try {
-    const client = context.client ?? createOpenPetsClient();
+    const client = context.client ?? createFamiliarOSClient();
     const storeMemory = client.storeMemory;
-    if (!storeMemory) return toolError("This OpenPets client build does not support memory tools yet. Update the app/integration and try again.");
+    if (!storeMemory) return toolError("This FamiliarOS client build does not support memory tools yet. Update the app/integration and try again.");
     const result = await storeMemory(parsed.data);
     return createMemoryStoreResult(result);
   } catch (error) {
-    return toolError(`OpenPets desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
+    return toolError(`FamiliarOS desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
   }
 }
 
@@ -189,17 +189,17 @@ export async function handleMemoryForget(input: unknown, context: ToolContext):
   if (!parsed.success) return toolError("Invalid memory delete request.");
 
   try {
-    const client = context.client ?? createOpenPetsClient();
+    const client = context.client ?? createFamiliarOSClient();
     const deleteMemory = client.deleteMemory;
-    if (!deleteMemory) return toolError("This OpenPets client build does not support memory tools yet. Update the app/integration and try again.");
+    if (!deleteMemory) return toolError("This FamiliarOS client build does not support memory tools yet. Update the app/integration and try again.");
     const result = await deleteMemory(parsed.data.id);
     return createMemoryDeleteResult(result);
   } catch (error) {
-    return toolError(`OpenPets desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
+    return toolError(`FamiliarOS desktop app is not running or local IPC is unavailable. ${sanitizeError(error)}`);
   }
 }
 
-export function createMcpStatus(status: OpenPetsStatusResult, configuredPetId?: string, lease?: OpenPetsLeaseResult, degradedReason?: string, staleLeaseId?: string): OpenPetsMcpStatus {
+export function createMcpStatus(status: FamiliarOSStatusResult, configuredPetId?: string, lease?: FamiliarOSLeaseResult, degradedReason?: string, staleLeaseId?: string): FamiliarOSMcpStatus {
   if (status.leaseActive === false || staleLeaseId) {
     return {
       ok: false,
@@ -211,7 +211,7 @@ export function createMcpStatus(status: OpenPetsStatusResult, configuredPetId?:
       leaseId: typeof status.leaseId === "string" ? status.leaseId : staleLeaseId,
       leaseActive: false,
       staleReason: typeof status.staleReason === "string" ? status.staleReason : "unknown_lease",
-    } as OpenPetsMcpStatus;
+    } as FamiliarOSMcpStatus;
   }
   if (lease) {
     const statusTargetPetId = typeof status.actualTargetPetId === "string" ? status.actualTargetPetId : undefined;
@@ -254,29 +254,29 @@ export function toolError(message: string): CallToolResult {
 }
 
 export function sanitizeUnavailableReason(value: unknown): string | undefined {
-  if (typeof value !== "string" || value.length === 0) return "OpenPets desktop app is unavailable.";
+  if (typeof value !== "string" || value.length === 0) return "FamiliarOS desktop app is unavailable.";
   if (/\/|\\|\.sock|pipe|token|ipc\.json|ENOENT|ECONNREFUSED|EACCES/i.test(value)) {
-    return "OpenPets desktop app or local IPC is unavailable.";
+    return "FamiliarOS desktop app or local IPC is unavailable.";
   }
   return value.slice(0, 160);
 }
 
 function sanitizeError(error: unknown): string {
-  if (error instanceof OpenPetsClientError) return sanitizeUnavailableReason(error.message) ?? "OpenPets is unavailable.";
-  return "Open OpenPets and try again.";
+  if (error instanceof FamiliarOSClientError) return sanitizeUnavailableReason(error.message) ?? "FamiliarOS is unavailable.";
+  return "Open FamiliarOS and try again.";
 }
 
-function createMemoryListResult(result: OpenPetsMemoryListResult): CallToolResult {
+function createMemoryListResult(result: FamiliarOSMemoryListResult): CallToolResult {
   const text = result.memories.length > 0
-    ? `OpenPets remembers:\n${result.memories.map((memory) => formatMemoryLine(memory)).join("\n")}`
-    : "OpenPets has no stored memories yet.";
+    ? `FamiliarOS remembers:\n${result.memories.map((memory) => formatMemoryLine(memory)).join("\n")}`
+    : "FamiliarOS has no stored memories yet.";
   return {
     content: [{ type: "text", text }],
     structuredContent: { ...result },
   };
 }
 
-function createMemorySearchResult(result: OpenPetsMemorySearchResult): CallToolResult {
+function createMemorySearchResult(result: FamiliarOSMemorySearchResult): CallToolResult {
   const text = result.memories.length > 0
     ? `Memory matches for "${result.query}":\n${result.memories.map((hit) => `${formatMemoryLine(hit.entry)} (score ${hit.score})`).join("\n")}`
     : `No stored memories matched "${result.query}".`;
@@ -286,21 +286,21 @@ function createMemorySearchResult(result: OpenPetsMemorySearchResult): CallToolR
   };
 }
 
-function createMemoryStoreResult(result: OpenPetsMemoryStoreResult): CallToolResult {
+function createMemoryStoreResult(result: FamiliarOSMemoryStoreResult): CallToolResult {
   return {
     content: [{ type: "text", text: `Stored memory ${result.memory.id}: ${result.memory.text}` }],
     structuredContent: { ...result },
   };
 }
 
-function createMemoryDeleteResult(result: OpenPetsMemoryDeleteResult): CallToolResult {
+function createMemoryDeleteResult(result: FamiliarOSMemoryDeleteResult): CallToolResult {
   return {
     content: [{ type: "text", text: result.deleted ? `Deleted memory ${result.id}.` : `No memory was deleted for id ${result.id}.` }],
     structuredContent: { ...result },
   };
 }
 
-function formatMemoryLine(memory: OpenPetsMemoryEntry): string {
+function formatMemoryLine(memory: FamiliarOSMemoryEntry): string {
   const tagSuffix = memory.tags.length > 0 ? ` [${memory.tags.join(", ")}]` : "";
   return `- ${memory.id} (${memory.kind}, importance ${memory.importance}) ${memory.text}${tagSuffix}`;
 }
@@ -309,4 +309,4 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null;
 }
 
-export type { OpenPetsMemoryKind, OpenPetsReaction };
+export type { FamiliarOSMemoryKind, FamiliarOSReaction };
diff --git a/packages/opencode/codemap.md b/packages/opencode/codemap.md
index 6a4d1e20..b87b6f07 100644
--- a/packages/opencode/codemap.md
+++ b/packages/opencode/codemap.md
@@ -1,6 +1,6 @@
 # packages/opencode/
 
-OpenCode editor integration for OpenPets.
+OpenCode editor integration for FamiliarOS.
 
 ## Responsibility
 
@@ -10,8 +10,8 @@ Provides comprehensive OpenCode editor integration including: MCP server configu
 
 **Plugin Architecture** (`plugin.ts`):
 - Default export: `{ id, server }` object
-- Server factory: `createOpenPetsOpenCodeHooks(options)`
-- Plugin ID: `open-pets-opencode`
+- Server factory: `createFamiliarOSOpenCodeHooks(options)`
+- Plugin ID: `familiaros-opencode`
 
 **Plugin Runtime** (`opencode-plugin-runtime.ts`):
 - Event hooks: `event`, `chat.message`, `tool.execute.before`, `tool.execute.after`
@@ -30,9 +30,9 @@ Provides comprehensive OpenCode editor integration including: MCP server configu
 
 **Project Setup** (`opencode-project-setup.ts`):
 - Status classification: `not_installed`, `installed`, `needs_update`, `custom`, `conflict`, `error`
-- Managed block detection in instruction files (`<!-- OPENPETS:START/END -->`)
+- Managed block detection in instruction files (`<!-- FAMILIAROS:START/END -->`)
 - Config field updates: `mcp`, `instructions`, `plugin` arrays
-- Instruction file: `.opencode/openpets.md` with usage guidelines
+- Instruction file: `.opencode/familiaros.md` with usage guidelines
 
 **Global Setup** (`opencode-global-setup.ts`):
 - Similar to project setup but for `~/.config/opencode/`
@@ -42,8 +42,8 @@ Provides comprehensive OpenCode editor integration including: MCP server configu
 - Config precedence handling: chooses the effective config file across `config.json`, `opencode.json`, and `opencode.jsonc`, preserving existing user arrays when safe
 
 **Status Classification** (`opencode-status.ts`):
-- MCP entry detection: `isManagedOpenPetsMcpEntry()`
-- Plugin entry detection: `isManagedOpenPetsPluginEntry()`
+- MCP entry detection: `isManagedFamiliarOSMcpEntry()`
+- Plugin entry detection: `isManagedFamiliarOSPluginEntry()`
 - Command pattern matching (npx, node, local paths)
 - Version comparison for update detection
 
@@ -51,7 +51,7 @@ Provides comprehensive OpenCode editor integration including: MCP server configu
 - MCP entry builder: `buildOpenCodeMcpEntry()` (published/local/bundled modes)
 - Plugin spec builder: `buildOpenCodePluginPreview()`
 - Instruction path builder: `buildOpenCodeInstructionPath()`
-- Pet ID validation: `validateOpenPetsPetArg()`
+- Familiar ID validation: `validateFamiliarOSPetArg()`
 - MCP config formatter: `formatOpenCodeMcpConfig()`
 
 ## Flow
@@ -79,8 +79,8 @@ writePreparedOpenCodeProjectSetup() → Execute writes atomically
 ## Integration Points
 
 **Dependencies**:
-- `@open-pets/client` - IPC for plugin runtime
-- `@open-pets/agent-events` - Speech pools and validation
+- `@familiaros/client` - IPC for plugin runtime
+- `@familiaros/agent-events` - Speech pools and validation
 - `jsonc-parser` - JSONC config parsing and editing
 
 **Package Surface**:
@@ -89,7 +89,7 @@ writePreparedOpenCodeProjectSetup() → Execute writes atomically
 - Server export (`./server`): OpenCode plugin default export from `dist/plugin.js`
 
 **Consumers**:
-- `@open-pets/cli` - `configure` command for OpenCode projects
+- `@familiaros/cli` - `configure` command for OpenCode projects
 
 **Exports**:
 - `plugin.ts` - Default plugin export for OpenCode
diff --git a/packages/opencode/package.json b/packages/opencode/package.json
index e9c6e518..e98a0928 100644
--- a/packages/opencode/package.json
+++ b/packages/opencode/package.json
@@ -1,10 +1,10 @@
 {
-  "name": "@open-pets/opencode",
+  "name": "@familiaros/opencode",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/opencode"
   },
   "type": "module",
@@ -33,8 +33,8 @@
     "build": "tsc"
   },
   "dependencies": {
-    "@open-pets/agent-events": "workspace:*",
-    "@open-pets/client": "workspace:*",
+    "@familiaros/agent-events": "workspace:*",
+    "@familiaros/client": "workspace:*",
     "jsonc-parser": "^3.3.1"
   },
   "devDependencies": {
diff --git a/packages/opencode/src/check-opencode-foundation.ts b/packages/opencode/src/check-opencode-foundation.ts
index c5d69a18..2d2d4e1b 100644
--- a/packages/opencode/src/check-opencode-foundation.ts
+++ b/packages/opencode/src/check-opencode-foundation.ts
@@ -3,14 +3,14 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync,
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 
-import { hookSpeechPools, validateHookSpeech } from "@open-pets/agent-events";
+import { hookSpeechPools, validateHookSpeech } from "@familiaros/agent-events";
 
 import { createOpenCodeExecutableDetection, executePlannedWrite, getGlobalOpenCodeConfigDir, getGlobalOpenCodeConfigPaths, getProjectOpenCodeConfigPaths, parseOpenCodeConfig, planOpenCodeConfigWrite, selectProjectOpenCodeConfigPath, updateOpenCodeConfigText } from "./opencode-config.js";
 import { buildOpenCodeInstructionPath, buildOpenCodeMcpEntry, buildOpenCodePluginPreview, formatOpenCodeMcpConfig } from "./opencode-previews.js";
 import { doctorOpenCodeGlobalSetup, prepareOpenCodeGlobalRemove, prepareOpenCodeGlobalSetup, writePreparedOpenCodeGlobalRemove, writePreparedOpenCodeGlobalSetup } from "./opencode-global-setup.js";
 import { classifyOpenCodeInstructionsStatus, classifyOpenCodeMcpStatus, classifyOpenCodePluginStatus } from "./opencode-status.js";
 
-const root = mkdtempSync(join(tmpdir(), "openpets-opencode-"));
+const root = mkdtempSync(join(tmpdir(), "familiaros-opencode-"));
 try {
   const project = join(root, "project");
   mkdirSync(project);
@@ -30,16 +30,16 @@ try {
   assert.deepEqual(createOpenCodeExecutableDetection({ platform: "win32" }).command, "opencode.cmd");
   assert.deepEqual(createOpenCodeExecutableDetection({ platform: "darwin" }).command, "opencode");
 
-  assert.deepEqual(formatOpenCodeMcpConfig({ cliVersion: "0.0.0", petId: "fixer" }), { mcp: { openpets: { type: "local", command: ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"], enabled: true } } });
-  assert.deepEqual(buildOpenCodeMcpEntry({ cliVersion: "0.0.0" }), { type: "local", command: ["npx", "-y", "@open-pets/cli@0.0.0", "mcp"], enabled: true });
-  assert.deepEqual(buildOpenCodeMcpEntry({ cliVersion: "0.0.0", environment: { OPENPETS_DISCOVERY_FILE: "/mnt/c/Users/alvin/AppData/Roaming/OpenPets/runtime/ipc.json" } }), { type: "local", command: ["npx", "-y", "@open-pets/cli@0.0.0", "mcp"], enabled: true, environment: { OPENPETS_DISCOVERY_FILE: "/mnt/c/Users/alvin/AppData/Roaming/OpenPets/runtime/ipc.json" } });
-  assert.deepEqual(buildOpenCodeMcpEntry({ cliVersion: "0.0.0", commandMode: "local", cliEntryPath: join(root, "cli.js"), petId: "fixer" }), { type: "local", command: ["node", join(root, "cli.js"), "mcp", "--pet", "fixer"], enabled: true });
+  assert.deepEqual(formatOpenCodeMcpConfig({ cliVersion: "0.0.0", petId: "fixer" }), { mcp: { familiaros: { type: "local", command: ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"], enabled: true } } });
+  assert.deepEqual(buildOpenCodeMcpEntry({ cliVersion: "0.0.0" }), { type: "local", command: ["npx", "-y", "@familiaros/cli@0.0.0", "mcp"], enabled: true });
+  assert.deepEqual(buildOpenCodeMcpEntry({ cliVersion: "0.0.0", environment: { FAMILIAROS_DISCOVERY_FILE: "/mnt/c/Users/alvin/AppData/Roaming/FamiliarOS/runtime/ipc.json" } }), { type: "local", command: ["npx", "-y", "@familiaros/cli@0.0.0", "mcp"], enabled: true, environment: { FAMILIAROS_DISCOVERY_FILE: "/mnt/c/Users/alvin/AppData/Roaming/FamiliarOS/runtime/ipc.json" } });
+  assert.deepEqual(buildOpenCodeMcpEntry({ cliVersion: "0.0.0", commandMode: "local", cliEntryPath: join(root, "cli.js"), petId: "fixer" }), { type: "local", command: ["node", join(root, "cli.js"), "mcp", "--familiar", "fixer"], enabled: true });
   assert.throws(() => buildOpenCodeMcpEntry({ cliVersion: "0.0.0", commandMode: "local", cliEntryPath: "relative.js" }));
-  assert.throws(() => buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "bad/pet" }));
-  assert.equal(buildOpenCodeInstructionPath("project"), ".opencode/openpets.md");
-  assert.equal(buildOpenCodeInstructionPath("global", join(root, "global")), join(root, "global", "openpets.md"));
-  assert.deepEqual(buildOpenCodePluginPreview("fixer"), ["@open-pets/opencode", { pet: "fixer" }]);
-  assert.deepEqual(buildOpenCodePluginPreview("fixer", "0.0.0"), ["@open-pets/opencode@0.0.0", { pet: "fixer" }]);
+  assert.throws(() => buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "bad/familiar" }));
+  assert.equal(buildOpenCodeInstructionPath("project"), ".opencode/familiaros.md");
+  assert.equal(buildOpenCodeInstructionPath("global", join(root, "global")), join(root, "global", "familiaros.md"));
+  assert.deepEqual(buildOpenCodePluginPreview("fixer"), ["@familiaros/opencode", { familiar: "fixer" }]);
+  assert.deepEqual(buildOpenCodePluginPreview("fixer", "0.0.0"), ["@familiaros/opencode@0.0.0", { familiar: "fixer" }]);
 
   const jsonc = `{
     // keep this comment
@@ -48,10 +48,10 @@ try {
   }`;
   const parsed = parseOpenCodeConfig(jsonc);
   assert.equal(parsed.ok, true);
-  const updated = updateOpenCodeConfigText(jsonc, [{ path: ["mcp", "openpets"], value: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "fixer" }) }]);
+  const updated = updateOpenCodeConfigText(jsonc, [{ path: ["mcp", "familiaros"], value: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "fixer" }) }]);
   assert.equal(typeof updated, "string");
   assert.match(String(updated), /keep this comment/);
-  assert.match(String(updated), /"openpets"/);
+  assert.match(String(updated), /"familiaros"/);
   assert.match(String(updated), /"other"/);
   assert.equal(parseOpenCodeConfig("{").ok, false);
   assert.equal(parseOpenCodeConfig("[]").ok, false);
@@ -63,32 +63,32 @@ try {
 
   const expected = { cliVersion: "0.0.0", petId: "fixer" };
   assert.equal(classifyOpenCodeMcpStatus([], expected).status, "not_installed");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: buildOpenCodeMcpEntry(expected) } }], expected).status, "installed");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: { ...buildOpenCodeMcpEntry(expected), environment: { OPENPETS_DISCOVERY_FILE: "/mnt/c/Users/alvin/AppData/Roaming/OpenPets/runtime/ipc.json" } } } }], expected).status, "installed");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: { command: ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"], enabled: true, type: "local" } } }], expected).status, "installed");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "helper" }) } }], expected).status, "needs_update");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", commandMode: "local", cliEntryPath: join(root, "cli.js"), petId: "helper" }) } }], { cliVersion: "0.0.0", commandMode: "local", cliEntryPath: join(root, "cli.js"), petId: "fixer" }).status, "needs_update");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: { type: "local", command: ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"], enabled: false } } }], expected).status, "custom");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: { type: "remote", command: ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"], enabled: true } } }], expected).status, "custom");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: { type: "local", command: ["npx", "-y", "@open-pets/cli@file:../cli", "mcp", "--pet", "fixer"], enabled: true } } }], expected).status, "custom");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: { type: "local", command: ["npx", "-y", "@open-pets/cli@workspace:*", "mcp", "--pet", "fixer"], enabled: true } } }], expected).status, "custom");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: { type: "local", command: ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"], enabled: true, timeout: 10 } } }], expected).status, "custom");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: { type: "local", command: ["my-openpets-wrapper"] } } }], expected).status, "custom");
-  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { openpets: buildOpenCodeMcpEntry(expected) } }, { mcp: { openpets: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "helper" }) } }], expected).status, "conflict");
-  assert.equal(classifyOpenCodeInstructionsStatus([{ instructions: [".opencode/openpets.md"] }], "project", undefined, { ".opencode/openpets.md": "<!-- OPENPETS:START -->\nHi\n<!-- OPENPETS:END -->\n" }).status, "installed");
-  assert.equal(classifyOpenCodeInstructionsStatus([{ instructions: [".opencode/openpets.md"] }], "project").status, "needs_update");
-  assert.equal(classifyOpenCodeInstructionsStatus([{ instructions: [".opencode/openpets.md"] }, { instructions: ["old-openpets.md"] }], "project", undefined, { ".opencode/openpets.md": "<!-- OPENPETS:START -->\nHi\n<!-- OPENPETS:END -->\n" }).status, "conflict");
-  assert.equal(classifyOpenCodeInstructionsStatus([{ instructions: ["old-openpets.md"] }], "project").status, "custom");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@open-pets/opencode", { pet: "fixer" }]] }], "fixer").status, "installed");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@open-pets/opencode@0.0.0", { pet: "fixer" }]] }], "fixer", "0.0.0").status, "installed");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: ["@open-pets/opencode"] }], "fixer").status, "needs_update");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@open-pets/opencode@old", { pet: "helper" }], "./openpets-custom-plugin.js"] }], "fixer", "0.0.0").status, "conflict");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@open-pets/opencode@0.0.0"]] }], "fixer", "0.0.0").status, "custom");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@open-pets/opencode@0.0.0", {}]] }], "fixer", "0.0.0").status, "custom");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@open-pets/opencode@0.0.0", { pet: "fixer" }, "extra"]] }], "fixer", "0.0.0").status, "custom");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@open-pets/opencode@0.0.0", { pet: "fixer", extra: true }]] }], "fixer", "0.0.0").status, "custom");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: ["./openpets-custom-plugin.js"] }], "fixer").status, "custom");
-  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@open-pets/opencode", { pet: "fixer" }], "./openpets-custom-plugin.js"] }], "fixer").status, "conflict");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: buildOpenCodeMcpEntry(expected) } }], expected).status, "installed");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: { ...buildOpenCodeMcpEntry(expected), environment: { FAMILIAROS_DISCOVERY_FILE: "/mnt/c/Users/alvin/AppData/Roaming/FamiliarOS/runtime/ipc.json" } } } }], expected).status, "installed");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: { command: ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"], enabled: true, type: "local" } } }], expected).status, "installed");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "helper" }) } }], expected).status, "needs_update");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", commandMode: "local", cliEntryPath: join(root, "cli.js"), petId: "helper" }) } }], { cliVersion: "0.0.0", commandMode: "local", cliEntryPath: join(root, "cli.js"), petId: "fixer" }).status, "needs_update");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: { type: "local", command: ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"], enabled: false } } }], expected).status, "custom");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: { type: "remote", command: ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"], enabled: true } } }], expected).status, "custom");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: { type: "local", command: ["npx", "-y", "@familiaros/cli@file:../cli", "mcp", "--familiar", "fixer"], enabled: true } } }], expected).status, "custom");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: { type: "local", command: ["npx", "-y", "@familiaros/cli@workspace:*", "mcp", "--familiar", "fixer"], enabled: true } } }], expected).status, "custom");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: { type: "local", command: ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"], enabled: true, timeout: 10 } } }], expected).status, "custom");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: { type: "local", command: ["my-familiaros-wrapper"] } } }], expected).status, "custom");
+  assert.equal(classifyOpenCodeMcpStatus([{ mcp: { familiaros: buildOpenCodeMcpEntry(expected) } }, { mcp: { familiaros: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "helper" }) } }], expected).status, "conflict");
+  assert.equal(classifyOpenCodeInstructionsStatus([{ instructions: [".opencode/familiaros.md"] }], "project", undefined, { ".opencode/familiaros.md": "<!-- FAMILIAROS:START -->\nHi\n<!-- FAMILIAROS:END -->\n" }).status, "installed");
+  assert.equal(classifyOpenCodeInstructionsStatus([{ instructions: [".opencode/familiaros.md"] }], "project").status, "needs_update");
+  assert.equal(classifyOpenCodeInstructionsStatus([{ instructions: [".opencode/familiaros.md"] }, { instructions: ["old-familiaros.md"] }], "project", undefined, { ".opencode/familiaros.md": "<!-- FAMILIAROS:START -->\nHi\n<!-- FAMILIAROS:END -->\n" }).status, "conflict");
+  assert.equal(classifyOpenCodeInstructionsStatus([{ instructions: ["old-familiaros.md"] }], "project").status, "custom");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@familiaros/opencode", { familiar: "fixer" }]] }], "fixer").status, "installed");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@familiaros/opencode@0.0.0", { familiar: "fixer" }]] }], "fixer", "0.0.0").status, "installed");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: ["@familiaros/opencode"] }], "fixer").status, "needs_update");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@familiaros/opencode@old", { familiar: "helper" }], "./familiaros-custom-plugin.js"] }], "fixer", "0.0.0").status, "conflict");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@familiaros/opencode@0.0.0"]] }], "fixer", "0.0.0").status, "custom");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@familiaros/opencode@0.0.0", {}]] }], "fixer", "0.0.0").status, "custom");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@familiaros/opencode@0.0.0", { familiar: "fixer" }, "extra"]] }], "fixer", "0.0.0").status, "custom");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@familiaros/opencode@0.0.0", { familiar: "fixer", extra: true }]] }], "fixer", "0.0.0").status, "custom");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: ["./familiaros-custom-plugin.js"] }], "fixer").status, "custom");
+  assert.equal(classifyOpenCodePluginStatus([{ plugin: [["@familiaros/opencode", { familiar: "fixer" }], "./familiaros-custom-plugin.js"] }], "fixer").status, "conflict");
 
   const writeTarget = join(root, "write", "opencode.jsonc");
   const writePlan = planOpenCodeConfigWrite(root, writeTarget, "{\"mcp\":{}}\n");
@@ -102,8 +102,8 @@ try {
       assert.throws(() => executePlannedWrite(second));
     }
     assert.throws(() => executePlannedWrite({ ...writePlan, rootPath: join(root, "missing-root") }));
-    assert.throws(() => executePlannedWrite({ ...writePlan, tempPath: join(tmpdir(), "openpets-unsafe.tmp") }));
-    assert.throws(() => executePlannedWrite({ ...writePlan, backupPath: join(tmpdir(), "openpets-unsafe.backup") }));
+    assert.throws(() => executePlannedWrite({ ...writePlan, tempPath: join(tmpdir(), "familiaros-unsafe.tmp") }));
+    assert.throws(() => executePlannedWrite({ ...writePlan, backupPath: join(tmpdir(), "familiaros-unsafe.backup") }));
   }
   const outsidePlan = planOpenCodeConfigWrite(root, join(tmpdir(), "outside-opencode.jsonc"), "{}\n");
   assert.equal("ok" in outsidePlan ? outsidePlan.ok : true, false);
@@ -126,8 +126,8 @@ try {
   assert.equal(existsSync(join(globalDir, "opencode.jsonc")), true);
   assert.equal(doctorOpenCodeGlobalSetup(globalDir).status, "installed");
   const globalConfig = readFileSync(join(globalDir, "opencode.jsonc"), "utf8");
-  assert.match(globalConfig, /@open-pets\/opencode@0\.0\.0/);
-  assert.match(readFileSync(join(globalDir, "openpets.md"), "utf8"), /OPENPETS:START/);
+  assert.match(globalConfig, /@familiaros\/opencode@0\.0\.0/);
+  assert.match(readFileSync(join(globalDir, "familiaros.md"), "utf8"), /FAMILIAROS:START/);
   const globalRemove = prepareOpenCodeGlobalRemove(globalDir);
   writePreparedOpenCodeGlobalRemove(globalRemove);
   assert.equal(doctorOpenCodeGlobalSetup(globalDir).status, "not_installed");
@@ -135,10 +135,10 @@ try {
   const globalLower = join(root, "global-lower");
   mkdirSync(globalLower);
   writeFileSync(join(globalLower, "config.json"), JSON.stringify({ theme: "keep" }), "utf8");
-  writeFileSync(join(globalLower, "opencode.jsonc"), JSON.stringify({ plugin: [["@open-pets/opencode@old", { pet: "helper" }]] }), "utf8");
+  writeFileSync(join(globalLower, "opencode.jsonc"), JSON.stringify({ plugin: [["@familiaros/opencode@old", { familiar: "helper" }]] }), "utf8");
   writePreparedOpenCodeGlobalSetup(prepareOpenCodeGlobalSetup({ configDir: globalLower, petId: "fixer", cliVersion: "0.0.0" }));
-  assert.equal(readFileSync(join(globalLower, "config.json"), "utf8").includes("@open-pets/opencode"), false);
-  assert.match(readFileSync(join(globalLower, "opencode.jsonc"), "utf8"), /@open-pets\/opencode@0\.0\.0/);
+  assert.equal(readFileSync(join(globalLower, "config.json"), "utf8").includes("@familiaros/opencode"), false);
+  assert.match(readFileSync(join(globalLower, "opencode.jsonc"), "utf8"), /@familiaros\/opencode@0\.0\.0/);
 
   const globalExistingJson = join(root, "global-existing-json");
   mkdirSync(globalExistingJson);
@@ -157,7 +157,7 @@ try {
   writeFileSync(join(globalExistingMultiple, "opencode.json"), JSON.stringify({ plugin: ["user-plugin"] }, null, 2), "utf8");
   const existingMultiplePrepared = prepareOpenCodeGlobalSetup({ configDir: globalExistingMultiple, petId: "fixer", cliVersion: "0.0.0" });
   assert.equal(existingMultiplePrepared.configPath, join(globalExistingMultiple, "opencode.json"));
-  assert.equal(readFileSync(join(globalExistingMultiple, "config.json"), "utf8").includes("openpets"), false);
+  assert.equal(readFileSync(join(globalExistingMultiple, "config.json"), "utf8").includes("familiaros"), false);
 
   const globalLowerPluginOwner = join(root, "global-lower-plugin-owner");
   mkdirSync(globalLowerPluginOwner);
@@ -168,7 +168,7 @@ try {
   writePreparedOpenCodeGlobalSetup(lowerPluginPrepared);
   const lowerPluginConfig = JSON.parse(readFileSync(join(globalLowerPluginOwner, "config.json"), "utf8")) as { readonly plugin?: readonly unknown[] };
   assert.deepEqual(lowerPluginConfig.plugin?.[0], "user-plugin");
-  assert.equal(readFileSync(join(globalLowerPluginOwner, "opencode.json"), "utf8").includes("openpets"), false);
+  assert.equal(readFileSync(join(globalLowerPluginOwner, "opencode.json"), "utf8").includes("familiaros"), false);
 
   const globalSplitArrayOwners = join(root, "global-split-array-owners");
   mkdirSync(globalSplitArrayOwners);
@@ -197,7 +197,7 @@ try {
   const globalStaleOverlay = join(root, "global-stale-overlay");
   mkdirSync(globalStaleOverlay);
   writeFileSync(join(globalStaleOverlay, "opencode.json"), JSON.stringify({ plugin: ["user-plugin"], instructions: ["USER.md"] }, null, 2), "utf8");
-  writeFileSync(join(globalStaleOverlay, "opencode.jsonc"), JSON.stringify({ plugin: [["@open-pets/opencode@0.0.0", { pet: "helper" }]], instructions: [buildOpenCodeInstructionPath("global", globalStaleOverlay)] }, null, 2), "utf8");
+  writeFileSync(join(globalStaleOverlay, "opencode.jsonc"), JSON.stringify({ plugin: [["@familiaros/opencode@0.0.0", { familiar: "helper" }]], instructions: [buildOpenCodeInstructionPath("global", globalStaleOverlay)] }, null, 2), "utf8");
   const stalePrepared = prepareOpenCodeGlobalSetup({ configDir: globalStaleOverlay, petId: "fixer", cliVersion: "0.0.1" });
   assert.equal(stalePrepared.configPath, join(globalStaleOverlay, "opencode.json"));
   assert.equal(stalePrepared.cleanupConfigWrites.length, 1);
@@ -212,42 +212,42 @@ try {
   const globalStaleRemove = join(root, "global-stale-remove");
   mkdirSync(globalStaleRemove);
   writeFileSync(join(globalStaleRemove, "opencode.json"), JSON.stringify({ plugin: ["user-plugin"] }, null, 2), "utf8");
-  writeFileSync(join(globalStaleRemove, "opencode.jsonc"), JSON.stringify({ plugin: [["@open-pets/opencode@0.0.0", { pet: "fixer" }]] }, null, 2), "utf8");
+  writeFileSync(join(globalStaleRemove, "opencode.jsonc"), JSON.stringify({ plugin: [["@familiaros/opencode@0.0.0", { familiar: "fixer" }]] }, null, 2), "utf8");
   writePreparedOpenCodeGlobalRemove(prepareOpenCodeGlobalRemove(globalStaleRemove));
   assert.doesNotMatch(readFileSync(join(globalStaleRemove, "opencode.jsonc"), "utf8"), /plugin/);
   assert.match(readFileSync(join(globalStaleRemove, "opencode.json"), "utf8"), /user-plugin/);
 
   const globalPublishedToBundled = join(root, "global-published-to-bundled");
   mkdirSync(globalPublishedToBundled);
-  writeFileSync(join(globalPublishedToBundled, "opencode.jsonc"), JSON.stringify({ mcp: { openpets: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "helper" }) } }), "utf8");
-  const bundledCli = join(root, "app.asar.unpacked", "node_modules", "@open-pets", "cli", "dist", "index.js");
+  writeFileSync(join(globalPublishedToBundled, "opencode.jsonc"), JSON.stringify({ mcp: { familiaros: buildOpenCodeMcpEntry({ cliVersion: "0.0.0", petId: "helper" }) } }), "utf8");
+  const bundledCli = join(root, "app.asar.unpacked", "node_modules", "@familiaros", "cli", "dist", "index.js");
   const migrated = prepareOpenCodeGlobalSetup({ configDir: globalPublishedToBundled, petId: "fixer", cliVersion: "0.0.1", pluginVersion: "0.0.2", commandMode: "bundled", cliEntryPath: bundledCli });
   assert.equal(migrated.configPath, join(globalPublishedToBundled, "opencode.jsonc"));
   assert.match(migrated.configWrite.content, /app\.asar\.unpacked/);
   assert.doesNotMatch(migrated.configWrite.content, /app\.asar(?!\.unpacked)/);
-  assert.match(migrated.configWrite.content, /@open-pets\/opencode@0\.0\.2/);
+  assert.match(migrated.configWrite.content, /@familiaros\/opencode@0\.0\.2/);
 
   const globalNoInstructionMarkers = join(root, "global-no-instruction-markers");
   mkdirSync(globalNoInstructionMarkers);
   writeFileSync(join(globalNoInstructionMarkers, "opencode.jsonc"), JSON.stringify({ instructions: [buildOpenCodeInstructionPath("global", globalNoInstructionMarkers)] }), "utf8");
-  writeFileSync(join(globalNoInstructionMarkers, "openpets.md"), "user owned\n", "utf8");
+  writeFileSync(join(globalNoInstructionMarkers, "familiaros.md"), "user owned\n", "utf8");
   const noMarkerRemove = prepareOpenCodeGlobalRemove(globalNoInstructionMarkers);
   assert.equal(noMarkerRemove.instructionWrite, undefined);
 
   const globalCustomPluginOptions = join(root, "global-custom-plugin-options");
   mkdirSync(globalCustomPluginOptions);
-  writeFileSync(join(globalCustomPluginOptions, "opencode.jsonc"), JSON.stringify({ plugin: [["@open-pets/opencode@0.0.0", { pet: "fixer", extra: true }]] }), "utf8");
+  writeFileSync(join(globalCustomPluginOptions, "opencode.jsonc"), JSON.stringify({ plugin: [["@familiaros/opencode@0.0.0", { familiar: "fixer", extra: true }]] }), "utf8");
   assert.throws(() => prepareOpenCodeGlobalSetup({ configDir: globalCustomPluginOptions, petId: "fixer", cliVersion: "0.0.0" }));
 
   const globalCustom = join(root, "global-custom");
   mkdirSync(globalCustom);
-  writeFileSync(join(globalCustom, "opencode.jsonc"), JSON.stringify({ mcp: { openpets: { type: "local", command: ["custom", "mcp"] } } }), "utf8");
+  writeFileSync(join(globalCustom, "opencode.jsonc"), JSON.stringify({ mcp: { familiaros: { type: "local", command: ["custom", "mcp"] } } }), "utf8");
   assert.throws(() => prepareOpenCodeGlobalSetup({ configDir: globalCustom, petId: "fixer", cliVersion: "0.0.0" }));
   assert.throws(() => prepareOpenCodeGlobalRemove(globalCustom));
 
   const globalManagedMcpEnvironment = join(root, "global-managed-mcp-environment");
   mkdirSync(globalManagedMcpEnvironment);
-  writeFileSync(join(globalManagedMcpEnvironment, "opencode.jsonc"), JSON.stringify({ mcp: { openpets: { type: "local", command: ["npx", "-y", "@open-pets/cli@0.0.0", "mcp", "--pet", "fixer"], enabled: true, environment: { OPENPETS_DEBUG: "1" } } } }), "utf8");
+  writeFileSync(join(globalManagedMcpEnvironment, "opencode.jsonc"), JSON.stringify({ mcp: { familiaros: { type: "local", command: ["npx", "-y", "@familiaros/cli@0.0.0", "mcp", "--familiar", "fixer"], enabled: true, environment: { FAMILIAROS_DEBUG: "1" } } } }), "utf8");
   assert.doesNotThrow(() => prepareOpenCodeGlobalSetup({ configDir: globalManagedMcpEnvironment, petId: "fixer", cliVersion: "0.0.0" }));
 
   const globalSymlink = join(root, "global-symlink");
diff --git a/packages/opencode/src/check-opencode-plugin.ts b/packages/opencode/src/check-opencode-plugin.ts
index 16d426a8..260b2884 100644
--- a/packages/opencode/src/check-opencode-plugin.ts
+++ b/packages/opencode/src/check-opencode-plugin.ts
@@ -3,14 +3,14 @@ import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 
-import type { OpenPetsClient, OpenPetsReaction } from "@open-pets/client";
+import type { FamiliarOSClient, FamiliarOSReaction } from "@familiaros/client";
 
 import plugin, { openPetsOpenCodePluginId } from "./plugin.js";
-import { classifyOpenCodeBusEvent, classifyOpenCodeToolReaction, createOpenPetsOpenCodeHooks, getDefaultOpenCodeThrottlePath, shouldIgnoreOpenPetsTool } from "./opencode-plugin-runtime.js";
+import { classifyOpenCodeBusEvent, classifyOpenCodeToolReaction, createFamiliarOSOpenCodeHooks, getDefaultOpenCodeThrottlePath, shouldIgnoreFamiliarOSTool } from "./opencode-plugin-runtime.js";
 
 assert.equal(plugin.id, openPetsOpenCodePluginId);
 assert.equal(typeof plugin.server, "function");
-const packagePlugin = await import("@open-pets/opencode/server");
+const packagePlugin = await import("@familiaros/opencode/server");
 assert.equal(packagePlugin.default.id, openPetsOpenCodePluginId);
 assert.equal(typeof packagePlugin.default.server, "function");
 
@@ -19,28 +19,28 @@ assert.equal(classifyOpenCodeToolReaction("apply_patch", {}), "editing");
 assert.equal(classifyOpenCodeToolReaction("bash", { command: "pnpm test" }), "testing");
 assert.equal(classifyOpenCodeToolReaction("shell", { command: "ls" }), undefined);
 assert.equal(classifyOpenCodeToolReaction("read", {}), undefined);
-assert.equal(shouldIgnoreOpenPetsTool("openpets_openpets_status"), true);
-assert.equal(shouldIgnoreOpenPetsTool("openpets_openpets_say"), true);
-assert.equal(shouldIgnoreOpenPetsTool("openpets_openpets_react"), true);
-assert.equal(shouldIgnoreOpenPetsTool("openpets_status"), true);
+assert.equal(shouldIgnoreFamiliarOSTool("familiaros_familiaros_status"), true);
+assert.equal(shouldIgnoreFamiliarOSTool("familiaros_familiaros_say"), true);
+assert.equal(shouldIgnoreFamiliarOSTool("familiaros_familiaros_react"), true);
+assert.equal(shouldIgnoreFamiliarOSTool("familiaros_status"), true);
 assert.deepEqual(classifyOpenCodeBusEvent({ type: "permission.asked" }), { reaction: "waiting", speechCategory: "permission" });
-assert.equal(classifyOpenCodeBusEvent({ type: "permission.asked", properties: { permission: "openpets_openpets_say" } }), undefined);
-assert.equal(classifyOpenCodeBusEvent({ payload: { type: "permission.asked", properties: { patterns: ["openpets_openpets_react"] } } }), undefined);
+assert.equal(classifyOpenCodeBusEvent({ type: "permission.asked", properties: { permission: "familiaros_familiaros_say" } }), undefined);
+assert.equal(classifyOpenCodeBusEvent({ payload: { type: "permission.asked", properties: { patterns: ["familiaros_familiaros_react"] } } }), undefined);
 assert.deepEqual(classifyOpenCodeBusEvent({ type: "session.error" }), { reaction: "error", speechCategory: "error" });
 assert.deepEqual(classifyOpenCodeBusEvent({ type: "session.status", properties: { status: { type: "idle" } } }), { reaction: "success" });
 assert.ok(getDefaultOpenCodeThrottlePath().includes("opencode-hook-throttle.json"));
 
-assert.throws(() => createOpenPetsOpenCodeHooks({ pet: "bad/pet" }));
+assert.throws(() => createFamiliarOSOpenCodeHooks({ familiar: "bad/familiar" }));
 
-const dir = mkdtempSync(join(tmpdir(), "openpets-opencode-plugin-"));
+const dir = mkdtempSync(join(tmpdir(), "familiaros-opencode-plugin-"));
 try {
   const calls: Array<{ readonly kind: string; readonly value: string; readonly leaseId?: string; readonly requestedPetId?: string }> = [];
   let releaseBlockedReact: (() => void) | undefined;
   const blocked = new Promise<void>((resolve) => { releaseBlockedReact = resolve; });
-  const client: OpenPetsClient = {
+  const client: FamiliarOSClient = {
     hello: async () => ({}),
     status: async () => ({ ok: true, appRunning: true }),
-    listPets: async () => ({ ok: true, pets: [], defaultPetId: "builtin" }),
+    listPets: async () => ({ ok: true, familiars: [], defaultPetId: "builtin" }),
     installPet: async () => { throw new Error("unused"); },
     acquireLease: async (options?: { readonly requestedPetId?: string }) => {
       calls.push({ kind: "lease", value: "acquire", requestedPetId: options?.requestedPetId });
@@ -48,7 +48,7 @@ try {
     },
     heartbeatLease: async () => ({ leaseId: "lease-fixer", expiresAt: Date.now() + 15_000 }),
     releaseLease: async () => ({ released: true }),
-    react: async (reaction: OpenPetsReaction, options?: { readonly leaseId?: string }) => {
+    react: async (reaction: FamiliarOSReaction, options?: { readonly leaseId?: string }) => {
       calls.push({ kind: "react", value: reaction, leaseId: options?.leaseId });
       await blocked;
     },
@@ -58,7 +58,7 @@ try {
   };
 
   const scheduled: Array<() => Promise<void>> = [];
-  const hooks = createOpenPetsOpenCodeHooks({ pet: "fixer", clientFactory: () => client, schedule: (work) => { scheduled.push(work); }, throttlePath: join(dir, "opencode-hook-throttle.json"), now: () => 100_000, random: () => 0 });
+  const hooks = createFamiliarOSOpenCodeHooks({ familiar: "fixer", clientFactory: () => client, schedule: (work) => { scheduled.push(work); }, throttlePath: join(dir, "opencode-hook-throttle.json"), now: () => 100_000, random: () => 0 });
   hooks["chat.message"]({}, { message: { text: "do not use this prompt" } });
   assert.equal(scheduled.length, 1);
   const thinkingWork = scheduled.shift();
@@ -89,7 +89,7 @@ try {
   assert.equal(calls.length, beforeDuplicateTesting, "duplicate testing reaction should be throttled without lease/client work");
 
   const beforeIgnored = scheduled.length;
-  hooks["tool.execute.before"]({ tool: "openpets_openpets_say" }, { args: {} });
+  hooks["tool.execute.before"]({ tool: "familiaros_familiaros_say" }, { args: {} });
   assert.equal(scheduled.length, beforeIgnored);
 
   hooks.event({ event: { type: "permission.asked", properties: { prompt: "never speak this" } } });
@@ -103,18 +103,18 @@ try {
   assert.deepEqual(calls.at(-1), { kind: "react", value: "success", leaseId: "lease-fixer" });
 
   const errors: string[] = [];
-  const failingHooks = createOpenPetsOpenCodeHooks({ clientFactory: () => { throw new Error("api_key=secret /tmp/path"); }, schedule: (work) => { void work(); }, debug: true, debugLog: (message) => errors.push(message), throttlePath: join(dir, "fail-throttle.json"), now: () => 200_000 });
+  const failingHooks = createFamiliarOSOpenCodeHooks({ clientFactory: () => { throw new Error("api_key=secret /tmp/path"); }, schedule: (work) => { void work(); }, debug: true, debugLog: (message) => errors.push(message), throttlePath: join(dir, "fail-throttle.json"), now: () => 200_000 });
   assert.doesNotThrow(() => failingHooks.event({ event: { type: "session.error" } }));
   await new Promise((resolve) => setTimeout(resolve, 0));
   assert.match(errors.join("\n"), /<redacted>|<path>/);
 
-  const throwingSchedule = createOpenPetsOpenCodeHooks({ schedule: () => { throw new Error("schedule failed"); }, debug: true, debugLog: (message) => errors.push(message) });
+  const throwingSchedule = createFamiliarOSOpenCodeHooks({ schedule: () => { throw new Error("schedule failed"); }, debug: true, debugLog: (message) => errors.push(message) });
   assert.doesNotThrow(() => throwingSchedule.event({ event: { type: "session.error" } }));
 } finally {
   rmSync(dir, { recursive: true, force: true });
 }
 
-const loaded = await plugin.server({}, { pet: "fixer" });
+const loaded = await plugin.server({}, { familiar: "fixer" });
 assert.equal(typeof loaded.event, "function");
 assert.equal(typeof loaded["chat.message"], "function");
 assert.equal(typeof loaded["tool.execute.before"], "function");
diff --git a/packages/opencode/src/codemap.md b/packages/opencode/src/codemap.md
index 0173ccdb..7588c945 100644
--- a/packages/opencode/src/codemap.md
+++ b/packages/opencode/src/codemap.md
@@ -4,11 +4,11 @@
 
 - **index.ts**: Barrel export (6 lines). Re-exports all public modules.
 - **plugin.ts**: OpenCode plugin definition (10 lines). Default export with `id` and `server` factory.
-- **opencode-plugin-runtime.ts**: Plugin hook implementations (229 lines). `createOpenPetsOpenCodeHooks()`, event classification, tool reaction mapping, lease management, throttling.
+- **opencode-plugin-runtime.ts**: Plugin hook implementations (229 lines). `createFamiliarOSOpenCodeHooks()`, event classification, tool reaction mapping, lease management, throttling.
 - **opencode-config.ts**: Config file management (221 lines). Path resolution, JSONC parsing, safe file operations, atomic writes with backups.
 - **opencode-project-setup.ts**: Project-level setup (182 lines). `prepareOpenCodeProjectSetup()`, `writePreparedOpenCodeProjectSetup()`, instruction block management.
 - **opencode-global-setup.ts**: Global setup management (354 lines). `prepareOpenCodeGlobalSetup()`, `prepareOpenCodeGlobalRemove()`, cleanup writes, doctor command, config precedence handling, global state classification.
-- **opencode-status.ts**: Status classification (147 lines). `classifyOpenCodeMcpStatus()`, `classifyOpenCodeInstructionsStatus()`, `classifyOpenCodePluginStatus()`, managed MCP/plugin/instruction detection helpers, OpenPets-like entry detection.
-- **opencode-previews.ts**: Config entry builders (55 lines). `buildOpenCodeMcpEntry()`, `buildOpenCodePluginPreview()`, `buildOpenCodeInstructionPath()`, `formatOpenCodeMcpConfig()`, `validateOpenPetsPetArg()`.
+- **opencode-status.ts**: Status classification (147 lines). `classifyOpenCodeMcpStatus()`, `classifyOpenCodeInstructionsStatus()`, `classifyOpenCodePluginStatus()`, managed MCP/plugin/instruction detection helpers, FamiliarOS-like entry detection.
+- **opencode-previews.ts**: Config entry builders (55 lines). `buildOpenCodeMcpEntry()`, `buildOpenCodePluginPreview()`, `buildOpenCodeInstructionPath()`, `formatOpenCodeMcpConfig()`, `validateFamiliarOSPetArg()`.
 - **check-opencode-foundation.ts**: Contract validation (excluded from detailed documentation).
 - **check-opencode-plugin.ts**: Plugin contract validation (excluded from detailed documentation).
diff --git a/packages/opencode/src/opencode-config.ts b/packages/opencode/src/opencode-config.ts
index 2fc82e68..d5e11a30 100644
--- a/packages/opencode/src/opencode-config.ts
+++ b/packages/opencode/src/opencode-config.ts
@@ -119,8 +119,8 @@ export function planOpenCodeConfigWrite(rootPath: string, targetPath: string, co
   return {
     rootPath: root,
     targetPath,
-    backupPath: existsSync(targetPath) ? uniquePath(`${targetPath}.openpets-backup-${stamp}.json`) : undefined,
-    tempPath: uniquePath(join(parent, `.openpets-${stamp}.tmp`)),
+    backupPath: existsSync(targetPath) ? uniquePath(`${targetPath}.familiaros-backup-${stamp}.json`) : undefined,
+    tempPath: uniquePath(join(parent, `.familiaros-${stamp}.tmp`)),
     content,
   };
 }
diff --git a/packages/opencode/src/opencode-global-setup.ts b/packages/opencode/src/opencode-global-setup.ts
index 6cdeded0..d9c8e1ac 100644
--- a/packages/opencode/src/opencode-global-setup.ts
+++ b/packages/opencode/src/opencode-global-setup.ts
@@ -3,9 +3,9 @@ import { dirname, isAbsolute, join, relative } from "node:path";
 import { randomUUID } from "node:crypto";
 
 import { parseOpenCodeConfig, readOpenCodeConfigFile, updateOpenCodeConfigText, type OpenCodeConfigPaths, type PlannedWrite } from "./opencode-config.js";
-import { buildOpenCodeInstructionPath, buildOpenCodeMcpEntry, buildOpenCodePluginPreview, validateOpenPetsPetArg, type OpenCodeCommandMode } from "./opencode-previews.js";
-import { classifyOpenCodeInstructionsStatus, classifyOpenCodeMcpStatus, classifyOpenCodePluginStatus, isManagedOpenPetsMcpEntry, isManagedOpenPetsPluginEntry, isOpenPetsLikePluginEntry } from "./opencode-status.js";
-import { createOpenPetsInstructionBlock } from "./opencode-project-setup.js";
+import { buildOpenCodeInstructionPath, buildOpenCodeMcpEntry, buildOpenCodePluginPreview, validateFamiliarOSPetArg, type OpenCodeCommandMode } from "./opencode-previews.js";
+import { classifyOpenCodeInstructionsStatus, classifyOpenCodeMcpStatus, classifyOpenCodePluginStatus, isManagedFamiliarOSMcpEntry, isManagedFamiliarOSPluginEntry, isFamiliarOSLikePluginEntry } from "./opencode-status.js";
+import { createFamiliarOSInstructionBlock } from "./opencode-project-setup.js";
 
 export interface PrepareOpenCodeGlobalSetupOptions {
   readonly configDir: string;
@@ -39,8 +39,8 @@ export interface OpenCodeGlobalState {
 }
 
 const maxInstructionBytes = 1024 * 1024;
-const openPetsStart = "<!-- OPENPETS:START -->";
-const openPetsEnd = "<!-- OPENPETS:END -->";
+const openPetsStart = "<!-- FAMILIAROS:START -->";
+const openPetsEnd = "<!-- FAMILIAROS:END -->";
 
 export function getExplicitGlobalOpenCodeConfigPaths(configDir: string): OpenCodeConfigPaths {
   assertSafeDirectoryRoot(configDir, true);
@@ -48,7 +48,7 @@ export function getExplicitGlobalOpenCodeConfigPaths(configDir: string): OpenCod
 }
 
 export function prepareOpenCodeGlobalSetup(options: PrepareOpenCodeGlobalSetupOptions): PreparedOpenCodeGlobalSetup {
-  const petId = options.petId === undefined ? undefined : validateOpenPetsPetArg(options.petId);
+  const petId = options.petId === undefined ? undefined : validateFamiliarOSPetArg(options.petId);
   const paths = getExplicitGlobalOpenCodeConfigPaths(options.configDir);
   const existingConfigs = readExistingGlobalConfigs(options.configDir, paths.candidates);
   const configs = existingConfigs.map((entry) => entry.config);
@@ -59,7 +59,7 @@ export function prepareOpenCodeGlobalSetup(options: PrepareOpenCodeGlobalSetupOp
   const instructionStatus = classifyOpenCodeInstructionsStatus(configs, "global", options.configDir, { [instructionPath]: instructionContent });
   const pluginStatus = classifyOpenCodePluginStatus(configs, petId, options.pluginVersion ?? options.cliVersion);
   for (const status of [mcpStatus, instructionStatus, pluginStatus]) {
-    if (status.status === "custom" || status.status === "conflict" || status.status === "error") throw new Error(`${status.message} Edit or remove the custom OpenPets OpenCode entry, then rerun setup.`);
+    if (status.status === "custom" || status.status === "conflict" || status.status === "error") throw new Error(`${status.message} Edit or remove the custom FamiliarOS OpenCode entry, then rerun setup.`);
   }
   const selectedPath = selectWriteTarget(options.configDir, paths.candidates, existingConfigs, paths.defaultCreatePath);
   const selectedText = existsSync(selectedPath) ? readFileSync(selectedPath, "utf8") : "{}\n";
@@ -74,7 +74,7 @@ export function prepareOpenCodeGlobalSetup(options: PrepareOpenCodeGlobalSetupOp
   if (typeof nextText !== "string") throw new Error(nextText.message);
   const configWrite = planGlobalConfigWrite(options.configDir, selectedPath, nextText);
   const cleanupConfigWrites = planSetupCleanupWrites(options.configDir, selectedPath, existingConfigs);
-  const instructionWrite = planTextWrite(options.configDir, instructionPath, upsertOpenPetsBlock(instructionContent));
+  const instructionWrite = planTextWrite(options.configDir, instructionPath, upsertFamiliarOSBlock(instructionContent));
   return { configDir: options.configDir, petId, configPath: selectedPath, instructionPath, configWrite, cleanupConfigWrites, instructionWrite };
 }
 
@@ -89,9 +89,9 @@ export function prepareOpenCodeGlobalRemove(configDir: string): { readonly confi
   const existingConfigs = readExistingGlobalConfigs(configDir, paths.candidates);
   const state = classifyGlobalState(configDir, existingConfigs);
   if (state.status === "custom" || state.status === "conflict" || state.status === "error") throw new Error(state.message);
-  const owners = existingConfigs.filter((entry) => hasManagedOpenPetsEntry(configDir, entry.config));
+  const owners = existingConfigs.filter((entry) => hasManagedFamiliarOSEntry(configDir, entry.config));
   if (owners.length === 0) return { configWrites: [] };
-  if (owners.length > 1) throw new Error("OpenCode has OpenPets entries in multiple global config files. Remove duplicates manually.");
+  if (owners.length > 1) throw new Error("OpenCode has FamiliarOS entries in multiple global config files. Remove duplicates manually.");
   const owner = owners[0];
   if (!owner) return { configWrites: [] };
   const text = readFileSync(owner.path, "utf8");
@@ -105,7 +105,7 @@ export function prepareOpenCodeGlobalRemove(configDir: string): { readonly confi
   const configWrite = planGlobalConfigWrite(configDir, owner.path, nextText);
   const instructionPath = buildOpenCodeInstructionPath("global", configDir);
   const instructionContent = existsSync(instructionPath) ? readSafeInstructionFile(instructionPath) : "";
-  const instructionWrite = hasManagedInstructionBlock(instructionContent) ? planTextWrite(configDir, instructionPath, removeOpenPetsBlock(instructionContent)) : undefined;
+  const instructionWrite = hasManagedInstructionBlock(instructionContent) ? planTextWrite(configDir, instructionPath, removeFamiliarOSBlock(instructionContent)) : undefined;
   return { configWrites: [configWrite], instructionWrite };
 }
 
@@ -135,26 +135,26 @@ function readExistingGlobalConfigs(configDir: string, candidates: readonly strin
 
 function buildNextGlobalConfig(config: Record<string, unknown>, petId: string | undefined, options: PrepareOpenCodeGlobalSetupOptions): { readonly mcp: Record<string, unknown>; readonly instructions: readonly string[]; readonly plugin: readonly unknown[] } {
   const mcp = isRecord(config.mcp) ? { ...config.mcp } : {};
-  mcp.openpets = buildOpenCodeMcpEntry({ cliVersion: options.cliVersion, petId, commandMode: options.commandMode, cliEntryPath: options.cliEntryPath });
+  mcp.familiaros = buildOpenCodeMcpEntry({ cliVersion: options.cliVersion, petId, commandMode: options.commandMode, cliEntryPath: options.cliEntryPath });
   const instructionPath = buildOpenCodeInstructionPath("global", options.configDir);
   const instructions = [...new Set([...(Array.isArray(config.instructions) ? config.instructions.filter((entry): entry is string => typeof entry === "string") : []), instructionPath])];
-  const plugin = [...(Array.isArray(config.plugin) ? config.plugin.filter((entry) => !isManagedOpenPetsPluginEntry(entry)) : []), buildOpenCodePluginPreview(petId, options.pluginVersion ?? options.cliVersion)];
+  const plugin = [...(Array.isArray(config.plugin) ? config.plugin.filter((entry) => !isManagedFamiliarOSPluginEntry(entry)) : []), buildOpenCodePluginPreview(petId, options.pluginVersion ?? options.cliVersion)];
   return { mcp, instructions, plugin };
 }
 
 function removeManagedConfig(configDir: string, config: Record<string, unknown>): { readonly mcp?: Record<string, unknown>; readonly instructions?: readonly string[]; readonly plugin?: readonly unknown[] } {
   const mcp = isRecord(config.mcp) ? { ...config.mcp } : {};
-  if (isManagedOpenPetsMcpEntry(mcp.openpets)) delete mcp.openpets;
+  if (isManagedFamiliarOSMcpEntry(mcp.familiaros)) delete mcp.familiaros;
   const instructionPath = buildOpenCodeInstructionPath("global", configDir);
   const instructions = Array.isArray(config.instructions) ? config.instructions.filter((entry) => typeof entry === "string" && entry !== instructionPath) : [];
-  const plugin = Array.isArray(config.plugin) ? config.plugin.filter((entry) => !isManagedOpenPetsPluginEntry(entry)) : [];
+  const plugin = Array.isArray(config.plugin) ? config.plugin.filter((entry) => !isManagedFamiliarOSPluginEntry(entry)) : [];
   return { mcp: Object.keys(mcp).length > 0 ? mcp : undefined, instructions: instructions.length > 0 ? instructions : undefined, plugin: plugin.length > 0 ? plugin : undefined };
 }
 
 function selectWriteTarget(configDir: string, candidates: readonly string[], existing: readonly { readonly path: string; readonly config: Record<string, unknown> }[], fallback: string): string {
-  const owners = existing.filter((entry) => hasManagedOpenPetsEntry(configDir, entry.config)).map((entry) => entry.path);
+  const owners = existing.filter((entry) => hasManagedFamiliarOSEntry(configDir, entry.config)).map((entry) => entry.path);
   const uniqueOwners = [...new Set(owners)];
-  if (uniqueOwners.length > 1) throw new Error("OpenCode has OpenPets entries in multiple global config files. Remove duplicates manually.");
+  if (uniqueOwners.length > 1) throw new Error("OpenCode has FamiliarOS entries in multiple global config files. Remove duplicates manually.");
   const arrayOwner = selectArrayFieldOwner(configDir, candidates, existing);
   if (arrayOwner) return arrayOwner;
   if (uniqueOwners.length === 1) return uniqueOwners[0] ?? fallback;
@@ -165,7 +165,7 @@ function selectWriteTarget(configDir: string, candidates: readonly string[], exi
 
 function planSetupCleanupWrites(configDir: string, selectedPath: string, existing: readonly { readonly path: string; readonly config: Record<string, unknown> }[]): readonly PlannedWrite[] {
   return existing.flatMap((entry) => {
-    if (entry.path === selectedPath || !hasManagedOpenPetsEntry(configDir, entry.config)) return [];
+    if (entry.path === selectedPath || !hasManagedFamiliarOSEntry(configDir, entry.config)) return [];
     const source = readFileSync(entry.path, "utf8");
     const next = removeManagedConfig(configDir, entry.config);
     const nextText = updateOpenCodeConfigText(source, [
@@ -179,11 +179,11 @@ function planSetupCleanupWrites(configDir: string, selectedPath: string, existin
 }
 
 function selectArrayFieldOwner(configDir: string, candidates: readonly string[], existing: readonly { readonly path: string; readonly config: Record<string, unknown> }[]): string | undefined {
-  const pluginOwner = findEffectiveArrayOwner(candidates, existing, "plugin", (entry) => !isManagedOpenPetsPluginEntry(entry), isManagedOpenPetsPluginEntry);
+  const pluginOwner = findEffectiveArrayOwner(candidates, existing, "plugin", (entry) => !isManagedFamiliarOSPluginEntry(entry), isManagedFamiliarOSPluginEntry);
   const instructionPath = buildOpenCodeInstructionPath("global", configDir);
   const instructionOwner = findEffectiveArrayOwner(candidates, existing, "instructions", (entry) => typeof entry === "string" && entry !== instructionPath, (entry) => entry === instructionPath);
   const owners = [...new Set([pluginOwner, instructionOwner].filter((value): value is string => typeof value === "string"))];
-  if (owners.length > 1) throw new Error("OpenCode global plugin and instruction arrays live in different config files. Consolidate them before installing OpenPets.");
+  if (owners.length > 1) throw new Error("OpenCode global plugin and instruction arrays live in different config files. Consolidate them before installing FamiliarOS.");
   return owners[0];
 }
 
@@ -199,32 +199,32 @@ function findEffectiveArrayOwner(candidates: readonly string[], existing: readon
     if (entry.values.some(isUserEntry)) return entry.path;
     const lowerUserOwner = entries.slice(index + 1).find((item) => item.values.some(isUserEntry))?.path;
     if (entry.values.some(isManagedEntry)) return lowerUserOwner ?? entry.path;
-    if (lowerUserOwner) throw new Error(`OpenCode global ${field} array in a higher-precedence config shadows user ${field} entries in a lower-precedence config. Consolidate them before installing OpenPets.`);
+    if (lowerUserOwner) throw new Error(`OpenCode global ${field} array in a higher-precedence config shadows user ${field} entries in a lower-precedence config. Consolidate them before installing FamiliarOS.`);
     return entry.path;
   }
   return undefined;
 }
 
-function hasManagedOpenPetsEntry(configDir: string, config: Record<string, unknown>): boolean {
-  if (isRecord(config.mcp) && isManagedOpenPetsMcpEntry(config.mcp.openpets)) return true;
+function hasManagedFamiliarOSEntry(configDir: string, config: Record<string, unknown>): boolean {
+  if (isRecord(config.mcp) && isManagedFamiliarOSMcpEntry(config.mcp.familiaros)) return true;
   if (Array.isArray(config.instructions) && config.instructions.some((entry) => entry === buildOpenCodeInstructionPath("global", configDir))) return true;
-  if (Array.isArray(config.plugin) && config.plugin.some(isManagedOpenPetsPluginEntry)) return true;
+  if (Array.isArray(config.plugin) && config.plugin.some(isManagedFamiliarOSPluginEntry)) return true;
   return false;
 }
 
-function hasCustomOpenPetsEntry(configDir: string, config: Record<string, unknown>): boolean {
-  if (isRecord(config.mcp) && config.mcp.openpets !== undefined && !isManagedOpenPetsMcpEntry(config.mcp.openpets)) return true;
-  if (Array.isArray(config.instructions) && config.instructions.some((entry) => typeof entry === "string" && /openpets\.md$/i.test(entry) && entry !== buildOpenCodeInstructionPath("global", configDir))) return true;
-  if (Array.isArray(config.plugin) && config.plugin.some((entry) => isOpenPetsLikePluginEntry(entry) && !isManagedOpenPetsPluginEntry(entry))) return true;
+function hasCustomFamiliarOSEntry(configDir: string, config: Record<string, unknown>): boolean {
+  if (isRecord(config.mcp) && config.mcp.familiaros !== undefined && !isManagedFamiliarOSMcpEntry(config.mcp.familiaros)) return true;
+  if (Array.isArray(config.instructions) && config.instructions.some((entry) => typeof entry === "string" && /familiaros\.md$/i.test(entry) && entry !== buildOpenCodeInstructionPath("global", configDir))) return true;
+  if (Array.isArray(config.plugin) && config.plugin.some((entry) => isFamiliarOSLikePluginEntry(entry) && !isManagedFamiliarOSPluginEntry(entry))) return true;
   return false;
 }
 
 function classifyGlobalState(configDir: string, existing: readonly { readonly path: string; readonly config: Record<string, unknown> }[]): OpenCodeGlobalState {
-  if (existing.some((entry) => hasCustomOpenPetsEntry(configDir, entry.config))) return { status: "custom", message: "OpenCode has custom OpenPets-like global entries. Edit or remove them manually." };
-  const owners = existing.filter((entry) => hasManagedOpenPetsEntry(configDir, entry.config));
-  if (owners.length > 1) return { status: "conflict", message: "OpenCode has OpenPets entries in multiple global config files. Remove duplicates manually." };
-  if (owners.length === 1) return { status: "installed", message: "OpenCode global OpenPets setup is installed." };
-  return { status: "not_installed", message: "OpenCode global OpenPets setup is not installed." };
+  if (existing.some((entry) => hasCustomFamiliarOSEntry(configDir, entry.config))) return { status: "custom", message: "OpenCode has custom FamiliarOS-like global entries. Edit or remove them manually." };
+  const owners = existing.filter((entry) => hasManagedFamiliarOSEntry(configDir, entry.config));
+  if (owners.length > 1) return { status: "conflict", message: "OpenCode has FamiliarOS entries in multiple global config files. Remove duplicates manually." };
+  if (owners.length === 1) return { status: "installed", message: "OpenCode global FamiliarOS setup is installed." };
+  return { status: "not_installed", message: "OpenCode global FamiliarOS setup is not installed." };
 }
 
 function planTextWrite(root: string, targetPath: string, content: string): GlobalPlannedTextWrite {
@@ -235,7 +235,7 @@ function planTextWrite(root: string, targetPath: string, content: string): Globa
     if (stat.size > maxInstructionBytes) throw new Error("OpenCode instruction file is too large.");
   }
   const stamp = `${process.pid}-${Date.now()}-${randomUUID()}`;
-  return { targetPath, backupPath: existsSync(targetPath) ? `${targetPath}.openpets-backup-${stamp}.md` : undefined, tempPath: join(dirname(targetPath), `.openpets-${stamp}.tmp`), content };
+  return { targetPath, backupPath: existsSync(targetPath) ? `${targetPath}.familiaros-backup-${stamp}.md` : undefined, tempPath: join(dirname(targetPath), `.familiaros-${stamp}.tmp`), content };
 }
 
 function executeTextWrite(plan: GlobalPlannedTextWrite): void {
@@ -267,7 +267,7 @@ function planGlobalConfigWrite(rootPath: string, targetPath: string, content: st
   const parsed = parseOpenCodeConfig(content);
   if (!parsed.ok) throw new Error(parsed.message);
   const stamp = `${process.pid}-${Date.now()}-${randomUUID()}`;
-  return { rootPath, targetPath, backupPath: existsSync(targetPath) ? `${targetPath}.openpets-backup-${stamp}.json` : undefined, tempPath: join(dirname(targetPath), `.openpets-${stamp}.tmp`), content };
+  return { rootPath, targetPath, backupPath: existsSync(targetPath) ? `${targetPath}.familiaros-backup-${stamp}.json` : undefined, tempPath: join(dirname(targetPath), `.familiaros-${stamp}.tmp`), content };
 }
 
 function executeGlobalConfigWrite(plan: PlannedWrite): void {
@@ -299,13 +299,13 @@ function readSafeInstructionFile(path: string): string {
   return readFileSync(path, "utf8");
 }
 
-function upsertOpenPetsBlock(source: string): string {
+function upsertFamiliarOSBlock(source: string): string {
   const withoutBlock = source.replace(new RegExp(`${escapeRegExp(openPetsStart)}[\\s\\S]*?${escapeRegExp(openPetsEnd)}\\n?`, "g"), "").replace(/\n{3,}/g, "\n\n").replace(/\s*$/u, "");
-  const block = createOpenPetsInstructionBlock();
+  const block = createFamiliarOSInstructionBlock();
   return withoutBlock ? `${withoutBlock}\n\n${block}` : block;
 }
 
-function removeOpenPetsBlock(source: string): string {
+function removeFamiliarOSBlock(source: string): string {
   return source.replace(new RegExp(`${escapeRegExp(openPetsStart)}[\\s\\S]*?${escapeRegExp(openPetsEnd)}\\n?`, "g"), "").replace(/\n{3,}/g, "\n\n").replace(/\s*$/u, (match) => (match.includes("\n") ? "\n" : ""));
 }
 
diff --git a/packages/opencode/src/opencode-plugin-runtime.ts b/packages/opencode/src/opencode-plugin-runtime.ts
index 18a68656..53fa842a 100644
--- a/packages/opencode/src/opencode-plugin-runtime.ts
+++ b/packages/opencode/src/opencode-plugin-runtime.ts
@@ -2,18 +2,18 @@ import { homedir, tmpdir, userInfo } from "node:os";
 import { dirname, join } from "node:path";
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 
-import { createOpenPetsClient, type OpenPetsClient, type OpenPetsReaction } from "@open-pets/client";
-import { pickHookSpeech, type HookSpeechCategory, validateHookSpeech } from "@open-pets/agent-events";
+import { createFamiliarOSClient, type FamiliarOSClient, type FamiliarOSReaction } from "@familiaros/client";
+import { pickHookSpeech, type HookSpeechCategory, validateHookSpeech } from "@familiaros/agent-events";
 
-import { validateOpenPetsPetArg } from "./opencode-previews.js";
+import { validateFamiliarOSPetArg } from "./opencode-previews.js";
 
 export interface OpenCodePluginOptions {
-  readonly pet?: string;
+  readonly familiar?: string;
   readonly debug?: boolean;
 }
 
 export interface OpenCodePluginRuntimeOptions extends OpenCodePluginOptions {
-  readonly clientFactory?: () => OpenPetsClient;
+  readonly clientFactory?: () => FamiliarOSClient;
   readonly schedule?: (work: () => Promise<void>) => void;
   readonly now?: () => number;
   readonly random?: () => number;
@@ -22,7 +22,7 @@ export interface OpenCodePluginRuntimeOptions extends OpenCodePluginOptions {
 }
 
 export interface OpenCodePluginDecision {
-  readonly reaction?: OpenPetsReaction;
+  readonly reaction?: FamiliarOSReaction;
   readonly speechCategory?: HookSpeechCategory;
 }
 
@@ -37,13 +37,13 @@ const speechCooldownMs = 20_000;
 const permissionCooldownMs = 3_000;
 const reactionCooldownMs = 10_000;
 
-export function createOpenPetsOpenCodeHooks(options: OpenCodePluginRuntimeOptions = {}): OpenCodeHooks {
-  const pet = options.pet === undefined ? undefined : validateOpenPetsPetArg(options.pet);
-  const clientFactory = options.clientFactory ?? (() => createOpenPetsClient({ connectTimeoutMs: 500, responseTimeoutMs: 500 }));
+export function createFamiliarOSOpenCodeHooks(options: OpenCodePluginRuntimeOptions = {}): OpenCodeHooks {
+  const familiar = options.familiar === undefined ? undefined : validateFamiliarOSPetArg(options.familiar);
+  const clientFactory = options.clientFactory ?? (() => createFamiliarOSClient({ connectTimeoutMs: 500, responseTimeoutMs: 500 }));
   const schedule = options.schedule ?? defaultSchedule;
-  const debug = options.debug === true || process.env.OPENPETS_DEBUG === "1";
+  const debug = options.debug === true || process.env.FAMILIAROS_DEBUG === "1";
   const debugLog = options.debugLog ?? ((message) => { if (debug) process.stderr.write(`${message}\n`); });
-  let client: OpenPetsClient | undefined;
+  let client: FamiliarOSClient | undefined;
   let lease: { readonly leaseId: string; readonly expiresAt?: number } | undefined;
 
   const run = (decision: OpenCodePluginDecision | undefined): void => {
@@ -57,29 +57,29 @@ export function createOpenPetsOpenCodeHooks(options: OpenCodePluginRuntimeOption
           if (!shouldSpeak && !shouldReact) return;
 
           client ??= clientFactory();
-          const leaseId = pet ? await getLeaseId(client, pet) : undefined;
+          const leaseId = familiar ? await getLeaseId(client, familiar) : undefined;
           if (decision.speechCategory && shouldSpeak) {
             await client.say(validateHookSpeech(pickHookSpeech(decision.speechCategory, options.random)), { reaction, leaseId });
             return;
           }
           await client.react(reaction, { leaseId });
         } catch (error) {
-          debugLog(`OpenPets OpenCode plugin ignored error: ${sanitizeDebugError(error)}`);
+          debugLog(`FamiliarOS OpenCode plugin ignored error: ${sanitizeDebugError(error)}`);
         }
       });
     } catch (error) {
-      debugLog(`OpenPets OpenCode plugin scheduling ignored error: ${sanitizeDebugError(error)}`);
+      debugLog(`FamiliarOS OpenCode plugin scheduling ignored error: ${sanitizeDebugError(error)}`);
     }
   };
 
-  const getLeaseId = async (hit: OpenPetsClient, requestedPetId: string): Promise<string | undefined> => {
+  const getLeaseId = async (hit: FamiliarOSClient, requestedPetId: string): Promise<string | undefined> => {
     if (lease && (!lease.expiresAt || lease.expiresAt - Date.now() > 2_000)) return lease.leaseId;
     try {
       const next = await hit.acquireLease({ requestedPetId });
       lease = { leaseId: next.leaseId, expiresAt: next.expiresAt };
       return next.leaseId;
     } catch (error) {
-      debugLog(`OpenPets OpenCode lease unavailable: ${sanitizeDebugError(error)}`);
+      debugLog(`FamiliarOS OpenCode lease unavailable: ${sanitizeDebugError(error)}`);
       return undefined;
     }
   };
@@ -89,7 +89,7 @@ export function createOpenPetsOpenCodeHooks(options: OpenCodePluginRuntimeOption
       try {
         run(classifyOpenCodeBusEvent(input.event));
       } catch (error) {
-        debugLog(`OpenPets OpenCode event ignored error: ${sanitizeDebugError(error)}`);
+        debugLog(`FamiliarOS OpenCode event ignored error: ${sanitizeDebugError(error)}`);
       }
     },
     "chat.message"() {
@@ -97,7 +97,7 @@ export function createOpenPetsOpenCodeHooks(options: OpenCodePluginRuntimeOption
     },
     "tool.execute.before"(input, output) {
       const tool = typeof input.tool === "string" ? input.tool : "";
-      if (shouldIgnoreOpenPetsTool(tool)) return;
+      if (shouldIgnoreFamiliarOSTool(tool)) return;
       run({ reaction: classifyOpenCodeToolReaction(tool, output.args) });
     },
     "tool.execute.after"() {
@@ -106,7 +106,7 @@ export function createOpenPetsOpenCodeHooks(options: OpenCodePluginRuntimeOption
   };
 }
 
-export function classifyOpenCodeToolReaction(toolName: string, args?: unknown): OpenPetsReaction | undefined {
+export function classifyOpenCodeToolReaction(toolName: string, args?: unknown): FamiliarOSReaction | undefined {
   const normalized = toolName.toLowerCase();
   if (/edit|write|patch|apply_patch/.test(normalized)) return "editing";
   if (/bash|shell|terminal/.test(normalized)) return isTestLikeToolArgs(args) ? "testing" : undefined;
@@ -115,22 +115,22 @@ export function classifyOpenCodeToolReaction(toolName: string, args?: unknown):
 
 export function classifyOpenCodeBusEvent(event: unknown): OpenCodePluginDecision | undefined {
   const type = getEventType(event);
-  if (type === "permission.asked") return shouldIgnoreOpenPetsTool(getEventPermission(event) ?? "") ? undefined : { reaction: "waiting", speechCategory: "permission" };
+  if (type === "permission.asked") return shouldIgnoreFamiliarOSTool(getEventPermission(event) ?? "") ? undefined : { reaction: "waiting", speechCategory: "permission" };
   if (type === "session.error") return { reaction: "error", speechCategory: "error" };
   if (type === "session.status" && getEventStatusType(event) === "idle") return { reaction: "success" };
   return undefined;
 }
 
-export function shouldIgnoreOpenPetsTool(toolName: string): boolean {
+export function shouldIgnoreFamiliarOSTool(toolName: string): boolean {
   const normalized = toolName.toLowerCase().replace(/[^a-z0-9_:-]+/g, "_");
-  return /(?:^|[_:-])openpets_(?:openpets_)?(?:status|say|react)$/.test(normalized) || /^openpets_(?:status|say|react)$/.test(normalized);
+  return /(?:^|[_:-])familiaros_(?:familiaros_)?(?:status|say|react)$/.test(normalized) || /^familiaros_(?:status|say|react)$/.test(normalized);
 }
 
 export function getDefaultOpenCodeThrottlePath(): string {
-  if (process.platform === "win32") return join(process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local"), "OpenPets", "opencode-hook-throttle.json");
+  if (process.platform === "win32") return join(process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local"), "FamiliarOS", "opencode-hook-throttle.json");
   const stateHome = process.env.XDG_STATE_HOME || join(homedir(), ".local", "state");
-  if (stateHome) return join(stateHome, "openpets", "opencode-hook-throttle.json");
-  return join(tmpdir(), `openpets-${safeUid()}`, "opencode-hook-throttle.json");
+  if (stateHome) return join(stateHome, "familiaros", "opencode-hook-throttle.json");
+  return join(tmpdir(), `familiaros-${safeUid()}`, "opencode-hook-throttle.json");
 }
 
 function shouldSendSpeech(category: HookSpeechCategory, options: OpenCodePluginRuntimeOptions): boolean {
@@ -139,7 +139,7 @@ function shouldSendSpeech(category: HookSpeechCategory, options: OpenCodePluginR
   return shouldSendThrottleKey(category, cooldown, now, options.throttlePath ?? getDefaultOpenCodeThrottlePath());
 }
 
-function shouldSendReaction(reaction: OpenPetsReaction, options: OpenCodePluginRuntimeOptions): boolean {
+function shouldSendReaction(reaction: FamiliarOSReaction, options: OpenCodePluginRuntimeOptions): boolean {
   const now = options.now?.() ?? Date.now();
   return shouldSendThrottleKey(`reaction:${reaction}`, reactionCooldownMs, now, options.throttlePath ?? getDefaultOpenCodeThrottlePath());
 }
@@ -177,7 +177,7 @@ function getEventPermission(event: unknown): string | undefined {
   const properties = isRecord(event.properties) ? event.properties : isRecord(event.payload) && isRecord(event.payload.properties) ? event.payload.properties : undefined;
   if (typeof properties?.permission === "string") return properties.permission;
   if (Array.isArray(properties?.patterns)) {
-    const hit = properties.patterns.find((pattern) => typeof pattern === "string" && shouldIgnoreOpenPetsTool(pattern));
+    const hit = properties.patterns.find((pattern) => typeof pattern === "string" && shouldIgnoreFamiliarOSTool(pattern));
     if (typeof hit === "string") return hit;
   }
   return undefined;
diff --git a/packages/opencode/src/opencode-previews.ts b/packages/opencode/src/opencode-previews.ts
index 609b01f4..c10c48e7 100644
--- a/packages/opencode/src/opencode-previews.ts
+++ b/packages/opencode/src/opencode-previews.ts
@@ -1,7 +1,7 @@
 import { isAbsolute, join } from "node:path";
 
-export const openCodeMcpServerName = "openpets";
-export const openPetsCliPackageName = "@open-pets/cli";
+export const openCodeMcpServerName = "familiaros";
+export const openPetsCliPackageName = "@familiaros/cli";
 export type OpenCodeCommandMode = "published" | "local" | "bundled";
 
 export interface OpenCodeMcpEntry {
@@ -19,15 +19,15 @@ export interface OpenCodePreviewOptions {
   readonly environment?: Record<string, string>;
 }
 
-export function validateOpenPetsPetArg(value: string): string {
+export function validateFamiliarOSPetArg(value: string): string {
   const trimmed = value.trim();
-  if (trimmed !== value || trimmed.length < 1) throw new Error("Invalid OpenPets pet id.");
-  if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(trimmed)) throw new Error("Invalid OpenPets pet id.");
+  if (trimmed !== value || trimmed.length < 1) throw new Error("Invalid FamiliarOS familiar id.");
+  if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(trimmed)) throw new Error("Invalid FamiliarOS familiar id.");
   return trimmed;
 }
 
 export function buildOpenCodeMcpEntry(options: OpenCodePreviewOptions): OpenCodeMcpEntry {
-  const petArgs = options.petId === undefined ? [] : ["--pet", validateOpenPetsPetArg(options.petId)];
+  const petArgs = options.petId === undefined ? [] : ["--familiar", validateFamiliarOSPetArg(options.petId)];
   const mode = options.commandMode ?? "published";
   const environment = options.environment && Object.keys(options.environment).length > 0 ? { environment: options.environment } : {};
   if (mode === "local" || mode === "bundled") {
@@ -38,16 +38,16 @@ export function buildOpenCodeMcpEntry(options: OpenCodePreviewOptions): OpenCode
 }
 
 export function buildOpenCodeInstructionPath(scope: "project" | "global", configDir?: string): string {
-  if (scope === "project") return ".opencode/openpets.md";
+  if (scope === "project") return ".opencode/familiaros.md";
   if (!configDir) throw new Error("Global OpenCode instruction path requires config directory.");
-  return join(configDir, "openpets.md");
+  return join(configDir, "familiaros.md");
 }
 
-export type OpenCodePluginSpec = string | readonly [string, { readonly pet?: string }];
+export type OpenCodePluginSpec = string | readonly [string, { readonly familiar?: string }];
 
 export function buildOpenCodePluginPreview(petId?: string, packageVersion?: string): OpenCodePluginSpec {
-  const spec = packageVersion ? `@open-pets/opencode@${packageVersion}` : "@open-pets/opencode";
-  return petId === undefined ? spec : [spec, { pet: validateOpenPetsPetArg(petId) }];
+  const spec = packageVersion ? `@familiaros/opencode@${packageVersion}` : "@familiaros/opencode";
+  return petId === undefined ? spec : [spec, { familiar: validateFamiliarOSPetArg(petId) }];
 }
 
 export function formatOpenCodeMcpConfig(options: OpenCodePreviewOptions): Record<string, unknown> {
diff --git a/packages/opencode/src/opencode-project-setup.ts b/packages/opencode/src/opencode-project-setup.ts
index e822bf7b..cc4af405 100644
--- a/packages/opencode/src/opencode-project-setup.ts
+++ b/packages/opencode/src/opencode-project-setup.ts
@@ -3,8 +3,8 @@ import { dirname, isAbsolute, join, relative } from "node:path";
 import { randomUUID } from "node:crypto";
 
 import { executePlannedWrite, getProjectOpenCodeConfigPaths, parseOpenCodeConfig, planOpenCodeConfigWrite, readOpenCodeConfigFile, updateOpenCodeConfigText, type PlannedWrite } from "./opencode-config.js";
-import { buildOpenCodeInstructionPath, buildOpenCodeMcpEntry, buildOpenCodePluginPreview, validateOpenPetsPetArg, type OpenCodeCommandMode } from "./opencode-previews.js";
-import { classifyOpenCodeInstructionsStatus, classifyOpenCodeMcpStatus, classifyOpenCodePluginStatus, isManagedOpenPetsMcpEntry, isManagedOpenPetsPluginEntry } from "./opencode-status.js";
+import { buildOpenCodeInstructionPath, buildOpenCodeMcpEntry, buildOpenCodePluginPreview, validateFamiliarOSPetArg, type OpenCodeCommandMode } from "./opencode-previews.js";
+import { classifyOpenCodeInstructionsStatus, classifyOpenCodeMcpStatus, classifyOpenCodePluginStatus, isManagedFamiliarOSMcpEntry, isManagedFamiliarOSPluginEntry } from "./opencode-status.js";
 
 export interface PrepareOpenCodeProjectSetupOptions {
   readonly projectDir: string;
@@ -31,11 +31,11 @@ export interface PlannedTextWrite {
 }
 
 const maxInstructionBytes = 1024 * 1024;
-const openPetsStart = "<!-- OPENPETS:START -->";
-const openPetsEnd = "<!-- OPENPETS:END -->";
+const openPetsStart = "<!-- FAMILIAROS:START -->";
+const openPetsEnd = "<!-- FAMILIAROS:END -->";
 
 export function prepareOpenCodeProjectSetup(options: PrepareOpenCodeProjectSetupOptions): PreparedOpenCodeProjectSetup {
-  const petId = validateOpenPetsPetArg(options.petId);
+  const petId = validateFamiliarOSPetArg(options.petId);
   const paths = getProjectOpenCodeConfigPaths(options.projectDir);
   const existingConfigs = paths.candidates.flatMap((path) => {
     if (!existsSync(path)) return [];
@@ -53,7 +53,7 @@ export function prepareOpenCodeProjectSetup(options: PrepareOpenCodeProjectSetup
   const instructionStatus = classifyOpenCodeInstructionsStatus(configs, "project", undefined, { [instructionRelPath]: instructionContent });
   const pluginStatus = classifyOpenCodePluginStatus(configs, petId, options.cliVersion);
   for (const status of [mcpStatus, instructionStatus, pluginStatus]) {
-    if (status.status === "custom" || status.status === "conflict" || status.status === "error") throw new Error(`${status.message} Edit or remove the custom OpenPets OpenCode entry, then rerun setup.`);
+    if (status.status === "custom" || status.status === "conflict" || status.status === "error") throw new Error(`${status.message} Edit or remove the custom FamiliarOS OpenCode entry, then rerun setup.`);
   }
 
   const selectedPath = selectWriteTarget(paths.candidates, existingConfigs, paths.defaultCreatePath);
@@ -69,7 +69,7 @@ export function prepareOpenCodeProjectSetup(options: PrepareOpenCodeProjectSetup
   if (typeof nextText !== "string") throw new Error(nextText.message);
   const configWrite = planOpenCodeConfigWrite(options.projectDir, selectedPath, nextText);
   if ("ok" in configWrite) throw new Error(configWrite.message);
-  const instructionWrite = planInstructionWrite(options.projectDir, instructionPath, upsertOpenPetsInstructionBlock(instructionContent));
+  const instructionWrite = planInstructionWrite(options.projectDir, instructionPath, upsertFamiliarOSInstructionBlock(instructionContent));
   return { projectDir: options.projectDir, petId, configPath: selectedPath, instructionPath, configWrite, instructionWrite };
 }
 
@@ -78,24 +78,24 @@ export function writePreparedOpenCodeProjectSetup(prepared: PreparedOpenCodeProj
   executePlannedWrite(prepared.configWrite);
 }
 
-export function createOpenPetsInstructionBlock(): string {
-  return `${openPetsStart}\n## OpenPets\n\nOpenPets MCP tools may be available.\n\nUse OpenPets as a short visible status channel for meaningful coding progress:\n- Use \`openpets_say\` when starting, completing, blocking, or needing review on non-trivial work.\n- Keep messages brief, user-facing, and non-sensitive.\n- Do not include code, logs, secrets, URLs, or file paths.\n- Use \`openpets_react\` for small visual or emotional feedback.\n- Use \`openpets_status\` only when checking availability or the targeted pet.\n- Do not spam every internal step.\n${openPetsEnd}\n`;
+export function createFamiliarOSInstructionBlock(): string {
+  return `${openPetsStart}\n## FamiliarOS\n\nFamiliarOS MCP tools may be available.\n\nUse FamiliarOS as a short visible status channel for meaningful coding progress:\n- Use \`familiaros_say\` when starting, completing, blocking, or needing review on non-trivial work.\n- Keep messages brief, user-facing, and non-sensitive.\n- Do not include code, logs, secrets, URLs, or file paths.\n- Use \`familiaros_react\` for small visual or emotional feedback.\n- Use \`familiaros_status\` only when checking availability or the targeted familiar.\n- Do not spam every internal step.\n${openPetsEnd}\n`;
 }
 
 function buildNextConfig(config: Record<string, unknown>, petId: string, options: PrepareOpenCodeProjectSetupOptions): { readonly mcp: Record<string, unknown>; readonly instructions: readonly string[]; readonly plugin: readonly unknown[] } {
   const mcp = isRecord(config.mcp) ? { ...config.mcp } : {};
-  mcp.openpets = buildOpenCodeMcpEntry({ cliVersion: options.cliVersion, petId, commandMode: options.commandMode, cliEntryPath: options.cliEntryPath });
+  mcp.familiaros = buildOpenCodeMcpEntry({ cliVersion: options.cliVersion, petId, commandMode: options.commandMode, cliEntryPath: options.cliEntryPath });
   const instructionPath = buildOpenCodeInstructionPath("project");
   const instructions = [...new Set([...(Array.isArray(config.instructions) ? config.instructions.filter((entry): entry is string => typeof entry === "string") : []), instructionPath])];
   const pluginSpec = buildOpenCodePluginPreview(petId, options.cliVersion);
-  const plugin = [...(Array.isArray(config.plugin) ? config.plugin.filter((entry) => !isManagedOpenPetsPluginEntry(entry)) : []), pluginSpec];
+  const plugin = [...(Array.isArray(config.plugin) ? config.plugin.filter((entry) => !isManagedFamiliarOSPluginEntry(entry)) : []), pluginSpec];
   return { mcp, instructions, plugin };
 }
 
 function selectWriteTarget(candidates: readonly string[], existing: readonly { readonly path: string; readonly config: Record<string, unknown> }[], fallback: string): string {
-  const owners = existing.filter((entry) => hasManagedOpenPetsEntry(entry.config)).map((entry) => entry.path);
+  const owners = existing.filter((entry) => hasManagedFamiliarOSEntry(entry.config)).map((entry) => entry.path);
   const uniqueOwners = [...new Set(owners)];
-  if (uniqueOwners.length > 1) throw new Error("OpenCode has OpenPets entries in multiple config files. Remove duplicates, then rerun setup.");
+  if (uniqueOwners.length > 1) throw new Error("OpenCode has FamiliarOS entries in multiple config files. Remove duplicates, then rerun setup.");
   if (uniqueOwners.length === 1) return uniqueOwners[0] ?? fallback;
   return candidates.find((candidate) => existing.some((entry) => entry.path === candidate)) ?? fallback;
 }
@@ -113,7 +113,7 @@ function planInstructionWrite(projectDir: string, targetPath: string, content: s
     if (stat.isSymbolicLink() || !stat.isDirectory()) throw new Error("OpenCode instruction directory is unsafe.");
   }
   const stamp = `${process.pid}-${Date.now()}-${randomUUID()}`;
-  return { targetPath, backupPath: existsSync(targetPath) ? `${targetPath}.openpets-backup-${stamp}.md` : undefined, tempPath: join(parent, `.openpets-${stamp}.tmp`), content };
+  return { targetPath, backupPath: existsSync(targetPath) ? `${targetPath}.familiaros-backup-${stamp}.md` : undefined, tempPath: join(parent, `.familiaros-${stamp}.tmp`), content };
 }
 
 function executeTextWrite(plan: PlannedTextWrite): void {
@@ -160,16 +160,16 @@ function assertSafeProjectLocalPath(projectDir: string, targetPath: string, labe
   }
 }
 
-function upsertOpenPetsInstructionBlock(source: string): string {
+function upsertFamiliarOSInstructionBlock(source: string): string {
   const withoutBlock = source.replace(new RegExp(`${escapeRegExp(openPetsStart)}[\\s\\S]*?${escapeRegExp(openPetsEnd)}\\n?`, "g"), "").replace(/\n{3,}/g, "\n\n").replace(/\s*$/u, "");
-  const block = createOpenPetsInstructionBlock();
+  const block = createFamiliarOSInstructionBlock();
   return withoutBlock ? `${withoutBlock}\n\n${block}` : block;
 }
 
-function hasManagedOpenPetsEntry(config: Record<string, unknown>): boolean {
-  if (isRecord(config.mcp) && isManagedOpenPetsMcpEntry(config.mcp.openpets)) return true;
+function hasManagedFamiliarOSEntry(config: Record<string, unknown>): boolean {
+  if (isRecord(config.mcp) && isManagedFamiliarOSMcpEntry(config.mcp.familiaros)) return true;
   if (Array.isArray(config.instructions) && config.instructions.some((entry) => entry === buildOpenCodeInstructionPath("project"))) return true;
-  if (Array.isArray(config.plugin) && config.plugin.some(isManagedOpenPetsPluginEntry)) return true;
+  if (Array.isArray(config.plugin) && config.plugin.some(isManagedFamiliarOSPluginEntry)) return true;
   return false;
 }
 
diff --git a/packages/opencode/src/opencode-status.ts b/packages/opencode/src/opencode-status.ts
index f5f21aff..a5946d96 100644
--- a/packages/opencode/src/opencode-status.ts
+++ b/packages/opencode/src/opencode-status.ts
@@ -14,100 +14,100 @@ export function classifyOpenCodeMcpStatus(configs: readonly Record<string, unkno
     const entry = mcp?.[openCodeMcpServerName];
     return entry === undefined ? [] : [{ source: String(index), entry }];
   });
-  if (entries.length === 0) return { status: "not_installed", message: "OpenCode OpenPets MCP is not installed.", matches: [] };
+  if (entries.length === 0) return { status: "not_installed", message: "OpenCode FamiliarOS MCP is not installed.", matches: [] };
   const expectedEntry = buildOpenCodeMcpEntry(expected);
   const current = entries.filter(({ entry }) => isSameMcpEntry(entry, expectedEntry));
-  const managed = entries.filter(({ entry }) => isManagedOpenPetsMcpEntry(entry, expectedEntry.command));
-  if (current.length === 1 && entries.length === 1) return { status: "installed", message: "OpenCode OpenPets MCP is installed.", matches: [entries[0]?.source ?? "0"] };
-  if (current.length > 0 || managed.length > 0) return { status: entries.length > 1 ? "conflict" : "needs_update", message: "OpenCode OpenPets MCP needs update.", matches: entries.map((entry) => entry.source) };
-  return { status: "custom", message: "OpenCode has a custom openpets MCP entry.", matches: entries.map((entry) => entry.source) };
+  const managed = entries.filter(({ entry }) => isManagedFamiliarOSMcpEntry(entry, expectedEntry.command));
+  if (current.length === 1 && entries.length === 1) return { status: "installed", message: "OpenCode FamiliarOS MCP is installed.", matches: [entries[0]?.source ?? "0"] };
+  if (current.length > 0 || managed.length > 0) return { status: entries.length > 1 ? "conflict" : "needs_update", message: "OpenCode FamiliarOS MCP needs update.", matches: entries.map((entry) => entry.source) };
+  return { status: "custom", message: "OpenCode has a custom familiaros MCP entry.", matches: entries.map((entry) => entry.source) };
 }
 
 export function classifyOpenCodeInstructionsStatus(configs: readonly Record<string, unknown>[], scope: "project" | "global", configDir?: string, instructionFiles: Record<string, string> = {}): OpenCodeStatusResult {
   const expected = buildOpenCodeInstructionPath(scope, configDir);
-  const allEntries = configs.flatMap((config, index) => Array.isArray(config.instructions) ? config.instructions.filter((entry): entry is string => typeof entry === "string" && isOpenPetsLikeInstruction(entry)).map((entry) => ({ source: String(index), entry })) : []);
+  const allEntries = configs.flatMap((config, index) => Array.isArray(config.instructions) ? config.instructions.filter((entry): entry is string => typeof entry === "string" && isFamiliarOSLikeInstruction(entry)).map((entry) => ({ source: String(index), entry })) : []);
   const managedEntries = allEntries.filter(({ entry }) => entry === expected);
   const customEntries = allEntries.filter(({ entry }) => entry !== expected);
-  if (allEntries.length === 0) return { status: "not_installed", message: "OpenCode OpenPets instructions are not installed.", matches: [] };
-  if (managedEntries.length > 1 || (managedEntries.length > 0 && customEntries.length > 0)) return { status: "conflict", message: "OpenCode has conflicting OpenPets instruction entries.", matches: allEntries.map((entry) => entry.source) };
-  if (managedEntries.length === 1 && hasManagedInstructionBlock(instructionFiles[expected])) return { status: "installed", message: "OpenCode OpenPets instructions are installed.", matches: managedEntries.map((entry) => entry.source) };
-  if (managedEntries.length === 1) return { status: "needs_update", message: "OpenCode OpenPets instruction file needs managed block.", matches: managedEntries.map((entry) => entry.source) };
-  return { status: "custom", message: "OpenCode has custom OpenPets-like instruction entries.", matches: customEntries.map((entry) => entry.source) };
+  if (allEntries.length === 0) return { status: "not_installed", message: "OpenCode FamiliarOS instructions are not installed.", matches: [] };
+  if (managedEntries.length > 1 || (managedEntries.length > 0 && customEntries.length > 0)) return { status: "conflict", message: "OpenCode has conflicting FamiliarOS instruction entries.", matches: allEntries.map((entry) => entry.source) };
+  if (managedEntries.length === 1 && hasManagedInstructionBlock(instructionFiles[expected])) return { status: "installed", message: "OpenCode FamiliarOS instructions are installed.", matches: managedEntries.map((entry) => entry.source) };
+  if (managedEntries.length === 1) return { status: "needs_update", message: "OpenCode FamiliarOS instruction file needs managed block.", matches: managedEntries.map((entry) => entry.source) };
+  return { status: "custom", message: "OpenCode has custom FamiliarOS-like instruction entries.", matches: customEntries.map((entry) => entry.source) };
 }
 
 export function classifyOpenCodePluginStatus(configs: readonly Record<string, unknown>[], petId?: string, packageVersion?: string): OpenCodeStatusResult {
   const expected = buildOpenCodePluginPreview(petId, packageVersion);
   const pluginEntries = configs.flatMap((config, index) => Array.isArray(config.plugin) ? config.plugin.map((entry) => ({ source: String(index), entry })) : []);
   const current = pluginEntries.filter(({ entry }) => isExpectedPlugin(entry, expected));
-  const recognizable = pluginEntries.filter(({ entry }) => isManagedOpenPetsPluginEntry(entry));
-  const custom = pluginEntries.filter(({ entry }) => !isManagedOpenPetsPluginEntry(entry) && isOpenPetsLikePluginEntry(entry));
-  if (current.length === 1 && recognizable.length === 1 && custom.length === 0) return { status: "installed", message: "OpenCode OpenPets plugin is installed.", matches: current.map((entry) => entry.source) };
-  if (recognizable.length > 0 && custom.length > 0) return { status: "conflict", message: "OpenCode has conflicting OpenPets plugin entries.", matches: [...recognizable, ...custom].map((entry) => entry.source) };
-  if (recognizable.length > 0) return { status: recognizable.length > 1 ? "conflict" : "needs_update", message: "OpenCode OpenPets plugin needs update.", matches: recognizable.map((entry) => entry.source) };
-  if (custom.length > 0) return { status: "custom", message: "OpenCode has custom OpenPets-like plugin entries.", matches: custom.map((entry) => entry.source) };
-  return { status: "not_installed", message: "OpenCode OpenPets plugin is not installed.", matches: [] };
+  const recognizable = pluginEntries.filter(({ entry }) => isManagedFamiliarOSPluginEntry(entry));
+  const custom = pluginEntries.filter(({ entry }) => !isManagedFamiliarOSPluginEntry(entry) && isFamiliarOSLikePluginEntry(entry));
+  if (current.length === 1 && recognizable.length === 1 && custom.length === 0) return { status: "installed", message: "OpenCode FamiliarOS plugin is installed.", matches: current.map((entry) => entry.source) };
+  if (recognizable.length > 0 && custom.length > 0) return { status: "conflict", message: "OpenCode has conflicting FamiliarOS plugin entries.", matches: [...recognizable, ...custom].map((entry) => entry.source) };
+  if (recognizable.length > 0) return { status: recognizable.length > 1 ? "conflict" : "needs_update", message: "OpenCode FamiliarOS plugin needs update.", matches: recognizable.map((entry) => entry.source) };
+  if (custom.length > 0) return { status: "custom", message: "OpenCode has custom FamiliarOS-like plugin entries.", matches: custom.map((entry) => entry.source) };
+  return { status: "not_installed", message: "OpenCode FamiliarOS plugin is not installed.", matches: [] };
 }
 
-export function isManagedOpenPetsMcpEntry(value: unknown, expectedCommand?: readonly string[]): boolean {
+export function isManagedFamiliarOSMcpEntry(value: unknown, expectedCommand?: readonly string[]): boolean {
   if (!isRecord(value) || value.type !== "local" || value.enabled !== true || !Array.isArray(value.command)) return false;
   const keys = Object.keys(value).sort();
   if (!hasManagedMcpKeys(keys) || !hasValidMcpEnvironment(value.environment)) return false;
-  return isManagedOpenPetsMcpCommand(value.command, expectedCommand);
+  return isManagedFamiliarOSMcpCommand(value.command, expectedCommand);
 }
 
-function isManagedOpenPetsMcpCommand(command: readonly unknown[], expectedCommand?: readonly string[]): boolean {
+function isManagedFamiliarOSMcpCommand(command: readonly unknown[], expectedCommand?: readonly string[]): boolean {
   if (!command.every((part) => typeof part === "string")) return false;
   const parts = command as readonly string[];
   if (expectedCommand && isSameCommand(parts, expectedCommand)) return true;
-  if (expectedCommand && isExpectedNodeOpenPetsMcpCommand(parts, expectedCommand)) return true;
-  return isPublishedOpenPetsMcpCommand(parts) || isNodeOpenPetsMcpCommand(parts);
+  if (expectedCommand && isExpectedNodeFamiliarOSMcpCommand(parts, expectedCommand)) return true;
+  return isPublishedFamiliarOSMcpCommand(parts) || isNodeFamiliarOSMcpCommand(parts);
 }
 
-function isExpectedNodeOpenPetsMcpCommand(command: readonly string[], expected: readonly string[]): boolean {
+function isExpectedNodeFamiliarOSMcpCommand(command: readonly string[], expected: readonly string[]): boolean {
   return expected[0] === "node" && command.length >= 3 && command[0] === "node" && command[1] === expected[1] && command[2] === "mcp" && hasValidPetArgs(command.slice(3));
 }
 
-function isPublishedOpenPetsMcpCommand(command: readonly string[]): boolean {
-  return command.length >= 4 && command[0] === "npx" && command[1] === "-y" && /^@open-pets\/cli@\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?$/.test(command[2] ?? "") && command[3] === "mcp" && hasValidPetArgs(command.slice(4));
+function isPublishedFamiliarOSMcpCommand(command: readonly string[]): boolean {
+  return command.length >= 4 && command[0] === "npx" && command[1] === "-y" && /^@familiaros\/cli@\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?$/.test(command[2] ?? "") && command[3] === "mcp" && hasValidPetArgs(command.slice(4));
 }
 
-function isNodeOpenPetsMcpCommand(command: readonly string[]): boolean {
-  return command.length >= 3 && command[0] === "node" && isOpenPetsCliEntryPath(command[1] ?? "") && command[2] === "mcp" && hasValidPetArgs(command.slice(3));
+function isNodeFamiliarOSMcpCommand(command: readonly string[]): boolean {
+  return command.length >= 3 && command[0] === "node" && isFamiliarOSCliEntryPath(command[1] ?? "") && command[2] === "mcp" && hasValidPetArgs(command.slice(3));
 }
 
-function isOpenPetsCliEntryPath(path: string): boolean {
-  return /(?:^|[\\/])node_modules[\\/]@open-pets[\\/]cli[\\/]dist[\\/]index\.js$/u.test(path) || /(?:^|[\\/])packages[\\/]cli[\\/]dist[\\/]index\.js$/u.test(path);
+function isFamiliarOSCliEntryPath(path: string): boolean {
+  return /(?:^|[\\/])node_modules[\\/]@familiaros[\\/]cli[\\/]dist[\\/]index\.js$/u.test(path) || /(?:^|[\\/])packages[\\/]cli[\\/]dist[\\/]index\.js$/u.test(path);
 }
 
 function hasValidPetArgs(args: readonly string[]): boolean {
   if (args.length === 0) return true;
-  return args.length === 2 && args[0] === "--pet" && /^[a-z0-9][a-z0-9_-]{0,63}$/.test(args[1] ?? "");
+  return args.length === 2 && args[0] === "--familiar" && /^[a-z0-9][a-z0-9_-]{0,63}$/.test(args[1] ?? "");
 }
 
 function isSameCommand(command: readonly string[], expected: readonly string[]): boolean {
   return command.length === expected.length && command.every((part, index) => part === expected[index]);
 }
 
-function isExpectedPlugin(value: unknown, expected: string | readonly [string, { readonly pet?: string }]): boolean {
+function isExpectedPlugin(value: unknown, expected: string | readonly [string, { readonly familiar?: string }]): boolean {
   if (typeof expected === "string") return value === expected;
   return Array.isArray(value) && value.length === 2 && value[0] === expected[0] && isSamePluginOptions(value[1], expected[1]);
 }
 
-export function isManagedOpenPetsPluginEntry(value: unknown): boolean {
-  if (typeof value === "string") return /^@open-pets\/opencode(?:@[^/]+)?$/.test(value);
-  return Array.isArray(value) && value.length === 2 && typeof value[0] === "string" && /^@open-pets\/opencode(?:@[^/]+)?$/.test(value[0]) && isPetPluginOptions(value[1]);
+export function isManagedFamiliarOSPluginEntry(value: unknown): boolean {
+  if (typeof value === "string") return /^@familiaros\/opencode(?:@[^/]+)?$/.test(value);
+  return Array.isArray(value) && value.length === 2 && typeof value[0] === "string" && /^@familiaros\/opencode(?:@[^/]+)?$/.test(value[0]) && isPetPluginOptions(value[1]);
 }
 
-export function isOpenPetsLikePluginEntry(value: unknown): boolean {
-  if (typeof value === "string") return /openpets|open-pets/i.test(value);
-  if (Array.isArray(value)) return value.some(isOpenPetsLikePluginEntry);
+export function isFamiliarOSLikePluginEntry(value: unknown): boolean {
+  if (typeof value === "string") return /familiaros|familiaros/i.test(value);
+  if (Array.isArray(value)) return value.some(isFamiliarOSLikePluginEntry);
   return false;
 }
 
 function isPetPluginOptions(value: unknown): boolean {
   if (!isRecord(value)) return false;
   const keys = Object.keys(value);
-  return keys.length === 1 && keys[0] === "pet" && typeof value.pet === "string" && /^[a-z0-9][a-z0-9_-]{0,63}$/.test(value.pet);
+  return keys.length === 1 && keys[0] === "familiar" && typeof value.familiar === "string" && /^[a-z0-9][a-z0-9_-]{0,63}$/.test(value.familiar);
 }
 
 function isSameMcpEntry(value: unknown, expected: { readonly type: "local"; readonly command: readonly string[]; readonly enabled: true }): boolean {
@@ -128,18 +128,18 @@ function hasValidMcpEnvironment(value: unknown): boolean {
   return Object.entries(value).every(([key, envValue]) => /^[A-Z_][A-Z0-9_]*$/.test(key) && typeof envValue === "string");
 }
 
-function isSamePluginOptions(value: unknown, expected: { readonly pet?: string }): boolean {
+function isSamePluginOptions(value: unknown, expected: { readonly familiar?: string }): boolean {
   if (!isRecord(value)) return Object.keys(expected).length === 0;
   const keys = Object.keys(value);
-  return keys.length === Object.keys(expected).length && value.pet === expected.pet;
+  return keys.length === Object.keys(expected).length && value.familiar === expected.familiar;
 }
 
-function isOpenPetsLikeInstruction(value: string): boolean {
-  return /openpets\.md$/i.test(value) || /@open-pets\/opencode/i.test(value);
+function isFamiliarOSLikeInstruction(value: string): boolean {
+  return /familiaros\.md$/i.test(value) || /@familiaros\/opencode/i.test(value);
 }
 
 function hasManagedInstructionBlock(value: string | undefined): boolean {
-  return typeof value === "string" && /<!-- OPENPETS:START -->[\s\S]*?<!-- OPENPETS:END -->/.test(value);
+  return typeof value === "string" && /<!-- FAMILIAROS:START -->[\s\S]*?<!-- FAMILIAROS:END -->/.test(value);
 }
 
 function isRecord(value: unknown): value is Record<string, unknown> {
diff --git a/packages/opencode/src/plugin.ts b/packages/opencode/src/plugin.ts
index fcd13154..7d47dd08 100644
--- a/packages/opencode/src/plugin.ts
+++ b/packages/opencode/src/plugin.ts
@@ -1,10 +1,10 @@
-import { createOpenPetsOpenCodeHooks, type OpenCodePluginOptions } from "./opencode-plugin-runtime.js";
+import { createFamiliarOSOpenCodeHooks, type OpenCodePluginOptions } from "./opencode-plugin-runtime.js";
 
-export const openPetsOpenCodePluginId = "open-pets-opencode";
+export const openPetsOpenCodePluginId = "familiaros-opencode";
 
 const plugin = {
   id: openPetsOpenCodePluginId,
-  server: async (_input: unknown, options?: OpenCodePluginOptions) => createOpenPetsOpenCodeHooks(options ?? {}),
+  server: async (_input: unknown, options?: OpenCodePluginOptions) => createFamiliarOSOpenCodeHooks(options ?? {}),
 };
 
 export default plugin;
diff --git a/packages/pet-format/src/index.ts b/packages/pet-format/src/index.ts
deleted file mode 100644
index 36dda072..00000000
--- a/packages/pet-format/src/index.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-export interface PetFormatPackageMarker {
-  readonly packageName: "@open-pets/pet-format";
-}
-
-export const petFormatPackageName = "@open-pets/pet-format";
diff --git a/packages/pi/codemap.md b/packages/pi/codemap.md
index d5b69cf9..70fe5575 100644
--- a/packages/pi/codemap.md
+++ b/packages/pi/codemap.md
@@ -1,13 +1,13 @@
 # packages/pi/
 
-Publishable npm package for the OpenPets Pi coding-agent integration.
+Publishable npm package for the FamiliarOS Pi coding-agent integration.
 
 ## Responsibility
 
-- Exposes `@open-pets/pi` as a Pi package with a Pi extension resource.
-- Maps Pi session/tool activity to safe OpenPets reactions through `@open-pets/client`.
-- Registers a user slash command namespace, `/openpets`, for status, test, react, and say commands.
-- Keeps MVP behavior default-pet-only and non-blocking; no Pi model-callable tools are registered.
+- Exposes `@familiaros/pi` as a Pi package with a Pi extension resource.
+- Maps Pi session/tool activity to safe FamiliarOS reactions through `@familiaros/client`.
+- Registers a user slash command namespace, `/familiaros`, for status, test, react, and say commands.
+- Keeps MVP behavior default-familiar-only and non-blocking; no Pi model-callable tools are registered.
 
 ## Design/Patterns
 
@@ -15,7 +15,7 @@ Publishable npm package for the OpenPets Pi coding-agent integration.
 - **Dual exports**: Main package exports (`index.ts`) and dedicated extension entry (`extension.ts`) for Pi loader consumption.
 - **Peer dependency**: Declares optional peer dependency on `@earendil-works/pi-coding-agent` for type safety without hard coupling.
 - **Fire-and-forget scheduling**: All automatic event handlers use non-blocking scheduling with swallowed IPC failures to prevent Pi execution disruption.
-- **Privacy-first**: Prompt text, assistant text, tool output, command output, file paths, URLs, and secrets are never forwarded to OpenPets.
+- **Privacy-first**: Prompt text, assistant text, tool output, command output, file paths, URLs, and secrets are never forwarded to FamiliarOS.
 
 ## Flow
 
@@ -23,33 +23,33 @@ Publishable npm package for the OpenPets Pi coding-agent integration.
 Pi extension loader
   -> packages/pi/src/extension.ts
   -> packages/pi/src/runtime.ts
-  -> @open-pets/client
-  -> OpenPets desktop local IPC
+  -> @familiaros/client
+  -> FamiliarOS desktop local IPC
 ```
 
 **Automatic event flow**:
 1. Pi emits lifecycle events (`session_start`, `agent_start`, `turn_start`, etc.)
 2. `extension.ts` receives event via `api.on()` and wraps in `PiEventEnvelope`
 3. `runtime.ts` classifies event to determine appropriate reaction
-4. Reaction dispatched to OpenPets client via scheduled non-blocking call
+4. Reaction dispatched to FamiliarOS client via scheduled non-blocking call
 5. IPC failures logged (if debug enabled) but never thrown to Pi
 
 **Command flow**:
-1. User types `/openpets <command>` in Pi
+1. User types `/familiaros <command>` in Pi
 2. `registerCommand()` handler invoked with args string
-3. `parseOpenPetsCommand()` validates and structures command
-4. `executeCommand()` performs synchronous OpenPets client calls
+3. `parseFamiliarOSCommand()` validates and structures command
+4. `executeCommand()` performs synchronous FamiliarOS client calls
 5. UI notifications sent via `ctx.ui.notify()`
 
 ## Integration
 
-- **Upstream**: Consumes `@open-pets/agent-events` for speech validation and `@open-pets/client` for IPC.
+- **Upstream**: Consumes `@familiaros/agent-events` for speech validation and `@familiaros/client` for IPC.
 - **Downstream**: Pi coding agent loads extension via `pi.extensions` manifest entry.
-- **Desktop**: Communicates with OpenPets desktop app through local socket IPC (via `@open-pets/client`).
-- **Commands**: `/openpets status`, `/openpets test`, `/openpets react <reaction>`, `/openpets say <message>`.
+- **Desktop**: Communicates with FamiliarOS desktop app through local socket IPC (via `@familiaros/client`).
+- **Commands**: `/familiaros status`, `/familiaros test`, `/familiaros react <reaction>`, `/familiaros say <message>`.
 
 ## Safety notes
 
 - Automatic events use reactions and fixed message pools only.
 - Prompt text, assistant text, tool output, command output, file paths, URLs, and secrets are not forwarded.
-- OpenPets IPC failures are swallowed by automatic event handlers so Pi execution continues.
+- FamiliarOS IPC failures are swallowed by automatic event handlers so Pi execution continues.
diff --git a/packages/pi/package.json b/packages/pi/package.json
index d15c007d..d5acc1a4 100644
--- a/packages/pi/package.json
+++ b/packages/pi/package.json
@@ -1,16 +1,16 @@
 {
-  "name": "@open-pets/pi",
+  "name": "@familiaros/pi",
   "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/pi"
   },
   "type": "module",
   "keywords": [
     "pi-package",
-    "openpets",
+    "familiaros",
     "coding-agent"
   ],
   "main": "dist/index.js",
@@ -49,8 +49,8 @@
     "build": "tsc"
   },
   "dependencies": {
-    "@open-pets/agent-events": "workspace:*",
-    "@open-pets/client": "workspace:*"
+    "@familiaros/agent-events": "workspace:*",
+    "@familiaros/client": "workspace:*"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",
diff --git a/packages/pi/src/check-pi-compat.ts b/packages/pi/src/check-pi-compat.ts
index 64503b8e..1889a163 100644
--- a/packages/pi/src/check-pi-compat.ts
+++ b/packages/pi/src/check-pi-compat.ts
@@ -1,32 +1,32 @@
 import assert from "node:assert/strict";
 
 import extension from "./extension.js";
-import { createOpenPetsPiExtension, type OpenPetsPiExtensionApi } from "./runtime.js";
+import { createFamiliarOSPiExtension, type FamiliarOSPiExtensionApi } from "./runtime.js";
 
 const handlers = new Map<string, (event: unknown, ctx?: unknown) => unknown>();
 let commandHandler: ((args: string, ctx?: unknown) => unknown) | undefined;
 const notifications: string[] = [];
 const calls: string[] = [];
 
-const api: OpenPetsPiExtensionApi = {
+const api: FamiliarOSPiExtensionApi = {
   on(eventName, handler) {
     handlers.set(eventName, handler);
   },
   registerCommand(name, command) {
-    assert.equal(name, "openpets");
+    assert.equal(name, "familiaros");
     commandHandler = command.handler;
   },
 };
 
 const scheduled: Array<() => Promise<void>> = [];
-const runtime = createOpenPetsPiExtension(api, {
+const runtime = createFamiliarOSPiExtension(api, {
   now: () => Date.now(),
   random: () => 0,
   schedule: (work) => { scheduled.push(work); },
   clientFactory: () => ({
     hello: async () => ({}),
     status: async () => ({ ok: true, appRunning: true }),
-    listPets: async () => ({ ok: true, defaultPetId: "builtin", pets: [] }),
+    listPets: async () => ({ ok: true, defaultPetId: "builtin", familiars: [] }),
     installPet: async () => ({ ok: true, petId: "x", displayName: "X", installed: true }),
     acquireLease: async () => { throw new Error("leases disabled"); },
     heartbeatLease: async () => ({ leaseId: "x", expiresAt: 0 }),
@@ -46,7 +46,7 @@ for (const eventName of ["session_start", "session_shutdown", "agent_start", "ag
 handlers.get("session_start")?.({ reason: "startup", prompt: "PRIVATE_PROMPT" });
 handlers.get("tool_execution_start")?.({ toolName: "bash", args: { command: "pnpm test /Users/alvin/private token=abc" } });
 handlers.get("tool_execution_end")?.({ isError: true, result: "STACK /Users/alvin/private token=abc" });
-assert.equal(calls.length, 0, "Pi event callbacks must not block on OpenPets IPC");
+assert.equal(calls.length, 0, "Pi event callbacks must not block on FamiliarOS IPC");
 while (scheduled.length) await scheduled.shift()?.();
 
 assert.deepEqual(calls.slice(0, 3), ["react:waving", "react:testing", "say:Something failed:error"]);
@@ -55,7 +55,7 @@ assert.ok(!calls.join("\n").includes("token=abc"));
 
 await commandHandler?.("status", { ui: { notify: (message: string) => notifications.push(message) } });
 await commandHandler?.("test", { ui: { notify: (message: string) => notifications.push(message) } });
-assert.ok(notifications.includes("OpenPets is connected."));
+assert.ok(notifications.includes("FamiliarOS is connected."));
 assert.ok(calls.includes("say:Pi connected:waving"));
 
 console.log("Pi compatibility smoke checks passed.");
diff --git a/packages/pi/src/check-pi.ts b/packages/pi/src/check-pi.ts
index 826380d1..f4e89c5c 100644
--- a/packages/pi/src/check-pi.ts
+++ b/packages/pi/src/check-pi.ts
@@ -1,12 +1,12 @@
 import assert from "node:assert/strict";
 
-import { allowedReactions } from "@open-pets/client";
+import { allowedReactions } from "@familiaros/client";
 
 import extension from "./extension.js";
-import { classifyPiEvent, classifyPiToolExecutionStart, createOpenPetsPiExtension, createOpenPetsPiRuntime, getPiOpenPetsHelp, normalizePiEvent, parseOpenPetsCommand, shouldIgnoreOpenPetsTool, validateManualSpeech, type OpenPetsPiExtensionApi } from "./runtime.js";
+import { classifyPiEvent, classifyPiToolExecutionStart, createFamiliarOSPiExtension, createFamiliarOSPiRuntime, getPiFamiliarOSHelp, normalizePiEvent, parseFamiliarOSCommand, shouldIgnoreFamiliarOSTool, validateManualSpeech, type FamiliarOSPiExtensionApi } from "./runtime.js";
 
 assert.equal(typeof extension, "function");
-assert.equal(typeof getPiOpenPetsHelp(), "string");
+assert.equal(typeof getPiFamiliarOSHelp(), "string");
 assert.deepEqual(normalizePiEvent({ type: "agent_start" }), { type: "agent_start", payload: { type: "agent_start" } });
 assert.deepEqual(normalizePiEvent({ type: "agent_start", payload: { reason: "startup" } }), { type: "agent_start", payload: { reason: "startup" } });
 
@@ -26,17 +26,17 @@ assert.equal(classifyPiToolExecutionStart("apply_patch", {}), "editing");
 assert.equal(classifyPiToolExecutionStart("bash", { command: "pnpm test -- --secret token=abc" }), "testing");
 assert.equal(classifyPiToolExecutionStart("bash", { command: "ls" }), "running");
 assert.equal(classifyPiToolExecutionStart("read", {}), "working");
-assert.equal(classifyPiToolExecutionStart("openpets_status", {}), undefined);
-assert.equal(shouldIgnoreOpenPetsTool("openpets_openpets_say"), true);
+assert.equal(classifyPiToolExecutionStart("familiaros_status", {}), undefined);
+assert.equal(shouldIgnoreFamiliarOSTool("familiaros_familiaros_say"), true);
 
-assert.deepEqual(parseOpenPetsCommand(""), { kind: "help" });
-assert.deepEqual(parseOpenPetsCommand("status"), { kind: "status" });
-assert.deepEqual(parseOpenPetsCommand("test"), { kind: "test" });
-assert.deepEqual(parseOpenPetsCommand("react success"), { kind: "react", reaction: "success" });
-assert.deepEqual(parseOpenPetsCommand("say Ready"), { kind: "say", message: "Ready" });
-for (const reaction of allowedReactions) assert.deepEqual(parseOpenPetsCommand(`react ${reaction}`), { kind: "react", reaction });
-assert.throws(() => parseOpenPetsCommand("react nope"), /Invalid OpenPets reaction/);
-assert.throws(() => parseOpenPetsCommand("status extra"), /Usage/);
+assert.deepEqual(parseFamiliarOSCommand(""), { kind: "help" });
+assert.deepEqual(parseFamiliarOSCommand("status"), { kind: "status" });
+assert.deepEqual(parseFamiliarOSCommand("test"), { kind: "test" });
+assert.deepEqual(parseFamiliarOSCommand("react success"), { kind: "react", reaction: "success" });
+assert.deepEqual(parseFamiliarOSCommand("say Ready"), { kind: "say", message: "Ready" });
+for (const reaction of allowedReactions) assert.deepEqual(parseFamiliarOSCommand(`react ${reaction}`), { kind: "react", reaction });
+assert.throws(() => parseFamiliarOSCommand("react nope"), /Invalid FamiliarOS reaction/);
+assert.throws(() => parseFamiliarOSCommand("status extra"), /Usage/);
 
 assert.equal(validateManualSpeech("  Ready  "), "Ready");
 for (const unsafe of [
@@ -56,14 +56,14 @@ for (const unsafe of [
 {
   const calls: string[] = [];
   const scheduled: Array<() => Promise<void>> = [];
-  const runtime = createOpenPetsPiRuntime({
+  const runtime = createFamiliarOSPiRuntime({
     now: () => 1_000,
     random: () => 0,
     schedule: (work) => { scheduled.push(work); },
     clientFactory: () => ({
       hello: async () => ({}),
       status: async () => ({ ok: true, appRunning: true }),
-      listPets: async () => ({ ok: true, defaultPetId: "builtin", pets: [] }),
+      listPets: async () => ({ ok: true, defaultPetId: "builtin", familiars: [] }),
       installPet: async () => ({ ok: true, petId: "x", displayName: "X", installed: true }),
       acquireLease: async () => { throw new Error("no leases in pi mvp"); },
       heartbeatLease: async () => ({ leaseId: "x", expiresAt: 0 }),
@@ -94,17 +94,17 @@ for (const unsafe of [
   let commandHandler: ((args: string, ctx?: unknown) => unknown) | undefined;
   const handlers = new Map<string, (event: unknown, ctx?: unknown) => unknown>();
   const calls: string[] = [];
-  const api: OpenPetsPiExtensionApi = {
+  const api: FamiliarOSPiExtensionApi = {
     on: (eventName, handler) => { events.push(eventName); handlers.set(eventName, handler); },
     registerCommand: (_name, command) => { commandHandler = command.handler; },
   };
   const scheduled: Array<() => Promise<void>> = [];
-  const runtime = createOpenPetsPiExtension(api, {
+  const runtime = createFamiliarOSPiExtension(api, {
     schedule: (work) => { scheduled.push(work); },
     clientFactory: () => ({
       hello: async () => ({}),
       status: async () => ({ ok: true, appRunning: true }),
-      listPets: async () => ({ ok: true, defaultPetId: "builtin", pets: [] }),
+      listPets: async () => ({ ok: true, defaultPetId: "builtin", familiars: [] }),
       installPet: async () => ({ ok: true, petId: "x", displayName: "X", installed: true }),
       acquireLease: async () => { throw new Error("no leases in pi mvp"); },
       heartbeatLease: async () => ({ leaseId: "x", expiresAt: 0 }),
@@ -124,13 +124,13 @@ for (const unsafe of [
 
 {
   const debugLogs: string[] = [];
-  const runtime = createOpenPetsPiRuntime({
+  const runtime = createFamiliarOSPiRuntime({
     debug: true,
     debugLog: (message) => debugLogs.push(message),
     clientFactory: () => ({
       hello: async () => ({}),
       status: async () => ({ ok: false, appRunning: false, unavailableReason: "/Users/alvin/private.sock" }),
-      listPets: async () => ({ ok: true, defaultPetId: "builtin", pets: [] }),
+      listPets: async () => ({ ok: true, defaultPetId: "builtin", familiars: [] }),
       installPet: async () => ({ ok: true, petId: "x", displayName: "X", installed: true }),
       acquireLease: async () => { throw new Error("no leases in pi mvp"); },
       heartbeatLease: async () => ({ leaseId: "x", expiresAt: 0 }),
diff --git a/packages/pi/src/codemap.md b/packages/pi/src/codemap.md
index 226dda8b..5095d46c 100644
--- a/packages/pi/src/codemap.md
+++ b/packages/pi/src/codemap.md
@@ -1,22 +1,22 @@
 # packages/pi/src/
 
-Source for the OpenPets Pi integration package.
+Source for the FamiliarOS Pi integration package.
 
 ## Responsibility
 
-- `extension.ts`: Default Pi extension export. Wraps `createOpenPetsPiExtension()` for Pi loader consumption.
+- `extension.ts`: Default Pi extension export. Wraps `createFamiliarOSPiExtension()` for Pi loader consumption.
 - `index.ts`: Public package exports including extension factory, runtime helpers, types, and classification utilities.
-- `runtime.ts`: Core integration logic (~300 lines) handling Pi event classification, command parsing, OpenPets dispatch, and safety constraints.
+- `runtime.ts`: Core integration logic (~300 lines) handling Pi event classification, command parsing, FamiliarOS dispatch, and safety constraints.
 - `check-pi.ts`: Unit-style contract checks for event classification, command parsing, privacy rejection corpus, non-blocking scheduling, and extension registration.
 - `check-pi-compat.ts`: Pi-style compatibility smoke checks for event handlers whose payloads do not include a `type` field.
 
 ## Design/Patterns
 
 - **Event normalization**: `normalizePiEvent()` wraps raw Pi events into `PiEventEnvelope` with consistent `type`/`payload` structure.
-- **Event classification**: `classifyPiEvent()` maps Pi lifecycle events to OpenPets reactions via pure function with no side effects.
+- **Event classification**: `classifyPiEvent()` maps Pi lifecycle events to FamiliarOS reactions via pure function with no side effects.
 - **Tool classification**: `classifyPiToolExecutionStart()` inspects tool names (not arguments) to categorize as editing/running/testing/working.
-- **Command parsing**: `parseOpenPetsCommand()` uses simple string splitting with validation, rejecting multi-line, oversized, or secret-containing speech.
-- **Non-blocking runtime**: `createOpenPetsPiRuntime()` returns handle functions; actual work scheduled via injectable `schedule` callback.
+- **Command parsing**: `parseFamiliarOSCommand()` uses simple string splitting with validation, rejecting multi-line, oversized, or secret-containing speech.
+- **Non-blocking runtime**: `createFamiliarOSPiRuntime()` returns handle functions; actual work scheduled via injectable `schedule` callback.
 - **Error suppression**: Recent errors suppress success reactions within 5s window; error speech rate-limited to 1 per 20s.
 - **Debug sanitization**: Error codes and messages sanitized to prevent leaking paths, tokens, or secrets in debug logs.
 
@@ -25,10 +25,10 @@ Source for the OpenPets Pi integration package.
 **Extension initialization**:
 ```
 extension.ts default export
-  -> createOpenPetsPiExtension(pi, options)
-  -> createOpenPetsPiRuntime(options) → runtime
+  -> createFamiliarOSPiExtension(pi, options)
+  -> createFamiliarOSPiRuntime(options) → runtime
   -> Subscribe to 7 Pi events via api.on()
-  -> Register /openpets command via api.registerCommand()
+  -> Register /familiaros command via api.registerCommand()
   -> Return runtime (handleEvent, handleCommand)
 ```
 
@@ -38,25 +38,25 @@ Pi event emitted
   -> handler wraps in { type, payload }
   -> runtime.handleEvent(envelope)
   -> classifyPiEvent() → PiEventDecision
-  -> runAutomatic() schedules OpenPets dispatch
-  -> IPC success: pet reacts; IPC failure: swallowed + debugLog
+  -> runAutomatic() schedules FamiliarOS dispatch
+  -> IPC success: familiar reacts; IPC failure: swallowed + debugLog
 ```
 
 **Command handling**:
 ```
-/openpets <args>
+/familiaros <args>
   -> runtime.handleCommand(args, ctx)
-  -> parseOpenPetsCommand(args) → OpenPetsPiCommand
+  -> parseFamiliarOSCommand(args) → FamiliarOSPiCommand
   -> executeCommand(command, client, ctx)
-  -> Synchronous OpenPets client calls
+  -> Synchronous FamiliarOS client calls
   -> ctx.ui.notify() for user feedback
 ```
 
 ## Integration
 
-- **Pi API**: Expects `OpenPetsPiExtensionApi` with `on(event, handler)` and `registerCommand(name, spec)` methods.
-- **OpenPets client**: Uses `createOpenPetsClient()` from `@open-pets/client` with 500ms timeouts for automatic events.
-- **Agent events**: Imports `pickHookSpeech`, `validateHookSpeech` from `@open-pets/agent-events` for safe speech selection.
+- **Pi API**: Expects `FamiliarOSPiExtensionApi` with `on(event, handler)` and `registerCommand(name, spec)` methods.
+- **FamiliarOS client**: Uses `createFamiliarOSClient()` from `@familiaros/client` with 500ms timeouts for automatic events.
+- **Agent events**: Imports `pickHookSpeech`, `validateHookSpeech` from `@familiaros/agent-events` for safe speech selection.
 - **Test doubles**: Both check files inject mock clients/schedulers to verify behavior without desktop dependency.
 
 ## Important constraints
diff --git a/packages/pi/src/extension.ts b/packages/pi/src/extension.ts
index 64564e63..775cc947 100644
--- a/packages/pi/src/extension.ts
+++ b/packages/pi/src/extension.ts
@@ -1,5 +1,5 @@
-import { createOpenPetsPiExtension, type OpenPetsPiOptions } from "./runtime.js";
+import { createFamiliarOSPiExtension, type FamiliarOSPiOptions } from "./runtime.js";
 
-export default function openPetsPiExtension(pi: unknown, options: OpenPetsPiOptions = {}): void {
-  createOpenPetsPiExtension(pi, options);
+export default function openPetsPiExtension(pi: unknown, options: FamiliarOSPiOptions = {}): void {
+  createFamiliarOSPiExtension(pi, options);
 }
diff --git a/packages/pi/src/index.ts b/packages/pi/src/index.ts
index 4f6add20..c5e3bfce 100644
--- a/packages/pi/src/index.ts
+++ b/packages/pi/src/index.ts
@@ -1,19 +1,19 @@
 export { default } from "./extension.js";
 export {
-  allowedPiOpenPetsCommands,
+  allowedPiFamiliarOSCommands,
   classifyPiEvent,
   classifyPiToolExecutionStart,
-  createOpenPetsPiExtension,
-  createOpenPetsPiRuntime,
-  getPiOpenPetsHelp,
+  createFamiliarOSPiExtension,
+  createFamiliarOSPiRuntime,
+  getPiFamiliarOSHelp,
   normalizePiEvent,
-  parseOpenPetsCommand,
-  shouldIgnoreOpenPetsTool,
+  parseFamiliarOSCommand,
+  shouldIgnoreFamiliarOSTool,
   validateManualSpeech,
-  type OpenPetsPiCommand,
-  type OpenPetsPiExtensionApi,
-  type OpenPetsPiOptions,
-  type OpenPetsPiRuntime,
+  type FamiliarOSPiCommand,
+  type FamiliarOSPiExtensionApi,
+  type FamiliarOSPiOptions,
+  type FamiliarOSPiRuntime,
   type PiEventEnvelope,
   type PiEventDecision,
 } from "./runtime.js";
diff --git a/packages/pi/src/runtime.ts b/packages/pi/src/runtime.ts
index f32faab6..b626fbd3 100644
--- a/packages/pi/src/runtime.ts
+++ b/packages/pi/src/runtime.ts
@@ -1,8 +1,8 @@
-import { pickHookSpeech, validateHookSpeech } from "@open-pets/agent-events";
-import { allowedReactions, createOpenPetsClient, type OpenPetsClient, type OpenPetsReaction } from "@open-pets/client";
+import { pickHookSpeech, validateHookSpeech } from "@familiaros/agent-events";
+import { allowedReactions, createFamiliarOSClient, type FamiliarOSClient, type FamiliarOSReaction } from "@familiaros/client";
 
-export interface OpenPetsPiOptions {
-  readonly clientFactory?: () => OpenPetsClient;
+export interface FamiliarOSPiOptions {
+  readonly clientFactory?: () => FamiliarOSClient;
   readonly schedule?: (work: () => Promise<void>) => void;
   readonly debug?: boolean;
   readonly debugLog?: (message: string) => void;
@@ -10,24 +10,24 @@ export interface OpenPetsPiOptions {
   readonly now?: () => number;
 }
 
-export interface OpenPetsPiRuntime {
+export interface FamiliarOSPiRuntime {
   readonly handleEvent: (event: unknown) => void;
-  readonly handleCommand: (args: string, ctx?: OpenPetsPiCommandContext) => Promise<void>;
+  readonly handleCommand: (args: string, ctx?: FamiliarOSPiCommandContext) => Promise<void>;
 }
 
-export interface OpenPetsPiExtensionApi {
+export interface FamiliarOSPiExtensionApi {
   readonly on?: (eventName: string, handler: (event: unknown, ctx?: unknown) => unknown) => unknown;
   readonly registerCommand?: (name: string, command: { readonly description?: string; readonly handler: (args: string, ctx?: unknown) => unknown }) => unknown;
 }
 
-export interface OpenPetsPiCommandContext {
+export interface FamiliarOSPiCommandContext {
   readonly ui?: {
     readonly notify?: (message: string, type?: "info" | "warning" | "error") => void;
   };
 }
 
 export interface PiEventDecision {
-  readonly reaction?: OpenPetsReaction;
+  readonly reaction?: FamiliarOSReaction;
   readonly speech?: "error";
   readonly markError?: boolean;
   readonly clearError?: boolean;
@@ -38,21 +38,21 @@ export interface PiEventEnvelope {
   readonly payload?: unknown;
 }
 
-export type OpenPetsPiCommand =
+export type FamiliarOSPiCommand =
   | { readonly kind: "help" }
   | { readonly kind: "status" }
   | { readonly kind: "test" }
-  | { readonly kind: "react"; readonly reaction: OpenPetsReaction }
+  | { readonly kind: "react"; readonly reaction: FamiliarOSReaction }
   | { readonly kind: "say"; readonly message: string };
 
 const automaticTimeoutMs = 500;
 const errorSuccessSuppressionMs = 5_000;
 const boundedCommandSliceLength = 300;
 
-export const allowedPiOpenPetsCommands = ["help", "status", "test", "react", "say"] as const;
+export const allowedPiFamiliarOSCommands = ["help", "status", "test", "react", "say"] as const;
 
-export function createOpenPetsPiExtension(pi: unknown, options: OpenPetsPiOptions = {}): OpenPetsPiRuntime {
-  const runtime = createOpenPetsPiRuntime(options);
+export function createFamiliarOSPiExtension(pi: unknown, options: FamiliarOSPiOptions = {}): FamiliarOSPiRuntime {
+  const runtime = createFamiliarOSPiRuntime(options);
   const api = isPiApi(pi) ? pi : undefined;
   if (!api) return runtime;
 
@@ -64,26 +64,26 @@ export function createOpenPetsPiExtension(pi: unknown, options: OpenPetsPiOption
     subscribe(eventName);
   }
 
-  api.registerCommand?.("openpets", {
-    description: "Control OpenPets desktop pet reactions and check local connection status.",
+  api.registerCommand?.("familiaros", {
+    description: "Control FamiliarOS desktop familiar reactions and check local connection status.",
     handler: async (args, ctx) => runtime.handleCommand(args, isCommandContext(ctx) ? ctx : undefined),
   });
 
   return runtime;
 }
 
-export function createOpenPetsPiRuntime(options: OpenPetsPiOptions = {}): OpenPetsPiRuntime {
-  const clientFactory = options.clientFactory ?? (() => createOpenPetsClient({ connectTimeoutMs: automaticTimeoutMs, responseTimeoutMs: automaticTimeoutMs }));
+export function createFamiliarOSPiRuntime(options: FamiliarOSPiOptions = {}): FamiliarOSPiRuntime {
+  const clientFactory = options.clientFactory ?? (() => createFamiliarOSClient({ connectTimeoutMs: automaticTimeoutMs, responseTimeoutMs: automaticTimeoutMs }));
   const schedule = options.schedule ?? defaultSchedule;
-  const debug = options.debug === true || process.env.OPENPETS_PI_DEBUG === "1";
+  const debug = options.debug === true || process.env.FAMILIAROS_PI_DEBUG === "1";
   const debugLog = options.debugLog ?? ((message) => {
     if (debug) process.stderr.write(`${message}\n`);
   });
-  let client: OpenPetsClient | undefined;
+  let client: FamiliarOSClient | undefined;
   let recentErrorAt = Number.NEGATIVE_INFINITY;
   let lastErrorSpeechAt = Number.NEGATIVE_INFINITY;
 
-  const getClient = (): OpenPetsClient => {
+  const getClient = (): FamiliarOSClient => {
     client ??= clientFactory();
     return client;
   };
@@ -103,11 +103,11 @@ export function createOpenPetsPiRuntime(options: OpenPetsPiOptions = {}): OpenPe
           }
           await getClient().react(reaction);
         } catch (error) {
-          debugLog(`OpenPets Pi extension ignored error: ${sanitizeDebugError(error)}`);
+          debugLog(`FamiliarOS Pi extension ignored error: ${sanitizeDebugError(error)}`);
         }
       });
     } catch (error) {
-      debugLog(`OpenPets Pi extension scheduling ignored error: ${sanitizeDebugError(error)}`);
+      debugLog(`FamiliarOS Pi extension scheduling ignored error: ${sanitizeDebugError(error)}`);
     }
   };
 
@@ -123,12 +123,12 @@ export function createOpenPetsPiRuntime(options: OpenPetsPiOptions = {}): OpenPe
       try {
         runAutomatic(classifyPiEvent(event));
       } catch (error) {
-        debugLog(`OpenPets Pi event ignored error: ${sanitizeDebugError(error)}`);
+        debugLog(`FamiliarOS Pi event ignored error: ${sanitizeDebugError(error)}`);
       }
     },
     async handleCommand(args, ctx) {
       try {
-        const command = parseOpenPetsCommand(args);
+        const command = parseFamiliarOSCommand(args);
         await executeCommand(command, getClient(), ctx);
       } catch (error) {
         notify(ctx, sanitizeUserError(error), "error");
@@ -170,73 +170,73 @@ export function normalizePiEvent(event: unknown): PiEventEnvelope {
   return { type: "", payload: event };
 }
 
-export function classifyPiToolExecutionStart(toolName: unknown, args?: unknown): OpenPetsReaction | undefined {
+export function classifyPiToolExecutionStart(toolName: unknown, args?: unknown): FamiliarOSReaction | undefined {
   const normalized = typeof toolName === "string" ? toolName.toLowerCase() : "";
-  if (!normalized || shouldIgnoreOpenPetsTool(normalized)) return undefined;
+  if (!normalized || shouldIgnoreFamiliarOSTool(normalized)) return undefined;
   if (/edit|write|patch|apply/.test(normalized)) return "editing";
   if (/bash|shell|terminal|exec|command/.test(normalized)) return isTestLikeArgs(args) ? "testing" : "running";
   return "working";
 }
 
-export function shouldIgnoreOpenPetsTool(toolName: string): boolean {
+export function shouldIgnoreFamiliarOSTool(toolName: string): boolean {
   const normalized = toolName.toLowerCase().replace(/[^a-z0-9_:/.-]+/g, "_");
-  return /(?:^|[_:/.-])openpets(?:[_:/.-]|$)/.test(normalized) || /^openpets_(?:status|say|react)$/.test(normalized);
+  return /(?:^|[_:/.-])familiaros(?:[_:/.-]|$)/.test(normalized) || /^familiaros_(?:status|say|react)$/.test(normalized);
 }
 
-export function parseOpenPetsCommand(args: string): OpenPetsPiCommand {
+export function parseFamiliarOSCommand(args: string): FamiliarOSPiCommand {
   const trimmed = args.trim();
   if (!trimmed || trimmed === "help" || trimmed === "--help" || trimmed === "-h") return { kind: "help" };
   const [head = "", ...rest] = trimmed.split(/\s+/);
   const tail = trimmed.slice(head.length).trim();
   switch (head.toLowerCase()) {
     case "status":
-      if (rest.length > 0) throw new Error("Usage: /openpets status");
+      if (rest.length > 0) throw new Error("Usage: /familiaros status");
       return { kind: "status" };
     case "test":
-      if (rest.length > 0) throw new Error("Usage: /openpets test");
+      if (rest.length > 0) throw new Error("Usage: /familiaros test");
       return { kind: "test" };
     case "react": {
-      if (rest.length !== 1) throw new Error("Usage: /openpets react <reaction>");
+      if (rest.length !== 1) throw new Error("Usage: /familiaros react <reaction>");
       return { kind: "react", reaction: validateReaction(rest[0] ?? "") };
     }
     case "say":
       return { kind: "say", message: validateManualSpeech(tail) };
     default:
-      throw new Error(`Unknown /openpets command: ${head}`);
+      throw new Error(`Unknown /familiaros command: ${head}`);
   }
 }
 
 export function validateManualSpeech(message: string): string {
   const trimmed = message.trim();
-  if (/-----BEGIN [A-Z ]*PRIVATE KEY-----/i.test(trimmed)) throw new Error("OpenPets speech must not contain secrets.");
+  if (/-----BEGIN [A-Z ]*PRIVATE KEY-----/i.test(trimmed)) throw new Error("FamiliarOS speech must not contain secrets.");
   return validateHookSpeech(trimmed);
 }
 
-export function getPiOpenPetsHelp(): string {
-  return "OpenPets commands: /openpets status, /openpets test, /openpets react <reaction>, /openpets say <message>.";
+export function getPiFamiliarOSHelp(): string {
+  return "FamiliarOS commands: /familiaros status, /familiaros test, /familiaros react <reaction>, /familiaros say <message>.";
 }
 
-async function executeCommand(command: OpenPetsPiCommand, client: OpenPetsClient, ctx?: OpenPetsPiCommandContext): Promise<void> {
+async function executeCommand(command: FamiliarOSPiCommand, client: FamiliarOSClient, ctx?: FamiliarOSPiCommandContext): Promise<void> {
   switch (command.kind) {
     case "help":
-      notify(ctx, getPiOpenPetsHelp(), "info");
+      notify(ctx, getPiFamiliarOSHelp(), "info");
       return;
     case "status": {
       const status = await client.status();
-      notify(ctx, status.ok ? "OpenPets is connected." : `OpenPets unavailable: ${sanitizeStatusReason(status.unavailableReason)}`, status.ok ? "info" : "warning");
+      notify(ctx, status.ok ? "FamiliarOS is connected." : `FamiliarOS unavailable: ${sanitizeStatusReason(status.unavailableReason)}`, status.ok ? "info" : "warning");
       return;
     }
     case "test":
       await client.say("Pi connected", { reaction: "waving" });
-      notify(ctx, "OpenPets test sent.", "info");
+      notify(ctx, "FamiliarOS test sent.", "info");
       return;
     case "react":
       await client.react(command.reaction);
-      notify(ctx, `OpenPets reaction set: ${command.reaction}`, "info");
+      notify(ctx, `FamiliarOS reaction set: ${command.reaction}`, "info");
       return;
     case "say":
       await client.say(command.message);
-      notify(ctx, "OpenPets message sent.", "info");
+      notify(ctx, "FamiliarOS message sent.", "info");
       return;
   }
 }
@@ -246,12 +246,12 @@ function isTestLikeArgs(args: unknown): boolean {
   return /\b(test|vitest|jest|pytest|npm\s+test|pnpm\s+test|yarn\s+test|cargo\s+test|go\s+test)\b/i.test(command);
 }
 
-function validateReaction(value: string): OpenPetsReaction {
-  if (!allowedReactions.includes(value as OpenPetsReaction)) throw new Error("Invalid OpenPets reaction.");
-  return value as OpenPetsReaction;
+function validateReaction(value: string): FamiliarOSReaction {
+  if (!allowedReactions.includes(value as FamiliarOSReaction)) throw new Error("Invalid FamiliarOS reaction.");
+  return value as FamiliarOSReaction;
 }
 
-function notify(ctx: OpenPetsPiCommandContext | undefined, message: string, type: "info" | "warning" | "error"): void {
+function notify(ctx: FamiliarOSPiCommandContext | undefined, message: string, type: "info" | "warning" | "error"): void {
   ctx?.ui?.notify?.(message, type);
 }
 
@@ -274,11 +274,11 @@ function sanitizeKnownErrorCode(code: string): string {
   if (normalized.includes("response_timeout")) return "response_timeout";
   if (normalized.includes("connection_closed")) return "connection_closed";
   if (normalized.includes("unavailable")) return "unavailable";
-  return "OpenPetsClientError";
+  return "FamiliarOSClientError";
 }
 
 function sanitizeUserError(error: unknown): string {
-  return error instanceof Error ? error.message.replace(/[\r\n]+/g, " ").slice(0, 140) : "OpenPets command failed.";
+  return error instanceof Error ? error.message.replace(/[\r\n]+/g, " ").slice(0, 140) : "FamiliarOS command failed.";
 }
 
 function sanitizeStatusReason(reason: unknown): string {
@@ -287,11 +287,11 @@ function sanitizeStatusReason(reason: unknown): string {
   return "unavailable";
 }
 
-function isPiApi(value: unknown): value is OpenPetsPiExtensionApi {
+function isPiApi(value: unknown): value is FamiliarOSPiExtensionApi {
   return isRecord(value) && (typeof value.on === "function" || typeof value.registerCommand === "function");
 }
 
-function isCommandContext(value: unknown): value is OpenPetsPiCommandContext {
+function isCommandContext(value: unknown): value is FamiliarOSPiCommandContext {
   return isRecord(value) && (value.ui === undefined || isRecord(value.ui));
 }
 
diff --git a/packages/sdk/README.md b/packages/sdk/README.md
index 43e49a6c..de46eea1 100644
--- a/packages/sdk/README.md
+++ b/packages/sdk/README.md
@@ -1,16 +1,16 @@
-# @open-pets/plugin-sdk
+# @familiaros/plugin-sdk
 
-Type definitions for building [OpenPets](https://openpets.dev) desktop pet plugins.
+Type definitions for building [FamiliarOS](https://familiaros.dev) desktop familiar plugins.
 
-This package is **types only**. There is no runtime to import — the OpenPets
-desktop app injects the `OpenPetsPlugin` global into your plugin's sandbox and
+This package is **types only**. There is no runtime to import — the FamiliarOS
+desktop app injects the `FamiliarOSPlugin` global into your plugin's sandbox and
 passes your `start(ctx)` handler the SDK. Installing this package gives your
 editor autocomplete and type-checking; it never ships in your plugin.
 
 ## Install
 
 ```bash
-npm i -D @open-pets/plugin-sdk
+npm i -D @familiaros/plugin-sdk
 ```
 
 ## Use
@@ -19,12 +19,12 @@ A plugin is a single browser-style JavaScript file. Reference the types for
 IntelliSense:
 
 ```js
-/// <reference types="@open-pets/plugin-sdk" />
+/// <reference types="@familiaros/plugin-sdk" />
 
-OpenPetsPlugin.register({
+FamiliarOSPlugin.register({
   async start(ctx) {
-    await ctx.pet.speak("Hello!")
-    await ctx.pet.react("waving")
+    await ctx.familiar.speak("Hello!")
+    await ctx.familiar.react("waving")
   },
 })
 ```
@@ -32,11 +32,11 @@ OpenPetsPlugin.register({
 Or, in TypeScript, import the contract directly:
 
 ```ts
-import type { OpenPetsContext, OpenPetsPluginDefinition } from "@open-pets/plugin-sdk"
+import type { FamiliarOSContext, FamiliarOSPluginDefinition } from "@familiaros/plugin-sdk"
 ```
 
 ## Docs
 
-- SDK guide: https://openpets.dev/sdk
-- Full reference: https://openpets.dev/docs/plugin-sdk
-- Example plugins: https://github.com/alvinunreal/openpets/tree/main/plugins/official
+- SDK guide: https://familiaros.dev/sdk
+- Full reference: https://familiaros.dev/docs/plugin-sdk
+- Example plugins: https://github.com/alvinunreal/familiaros/tree/main/plugins/official
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 6d25b1e4..d679ceb3 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,11 +1,11 @@
 {
-  "name": "@open-pets/plugin-sdk",
+  "name": "@familiaros/plugin-sdk",
   "version": "3.0.0",
-  "description": "Type definitions and testing harness for building OpenPets desktop pet plugins (SDK v3). The OpenPets runtime injects the SDK implementation at load time; the ./testing entry point runs plugins without the app.",
+  "description": "Type definitions and testing harness for building FamiliarOS desktop familiar plugins (SDK v3). The FamiliarOS runtime injects the SDK implementation at load time; the ./testing entry point runs plugins without the app.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/alvinunreal/familiaros.git",
     "directory": "packages/sdk"
   },
   "type": "module",
@@ -18,11 +18,11 @@
     "access": "public"
   },
   "keywords": [
-    "openpets",
+    "familiaros",
     "plugin",
     "sdk",
     "types",
-    "desktop-pet"
+    "desktop-familiar"
   ],
   "exports": {
     ".": {
diff --git a/packages/sdk/src/check-plugin-sdk.ts b/packages/sdk/src/check-plugin-sdk.ts
index 76815b42..8eaddae7 100644
--- a/packages/sdk/src/check-plugin-sdk.ts
+++ b/packages/sdk/src/check-plugin-sdk.ts
@@ -1,18 +1,18 @@
 /**
- * Contract test for @open-pets/plugin-sdk (SDK v3).
+ * Contract test for @familiaros/plugin-sdk (SDK v3).
  *
  * This file does double duty: it only compiles if the exported types match the
  * real SDK surface, and at runtime it exercises a sample plugin against a mock
  * context. The full-featured testing harness built on this mock lives in
- * `@open-pets/plugin-sdk/testing` (`createTestHarness`).
+ * `@familiaros/plugin-sdk/testing` (`createTestHarness`).
  */
 import type {
-  OpenPetsBubble,
-  OpenPetsBubbleHandle,
-  OpenPetsContext,
-  OpenPetsPickedFile,
-  OpenPetsPluginDefinition,
-  OpenPetsStatus,
+  FamiliarOSBubble,
+  FamiliarOSBubbleHandle,
+  FamiliarOSContext,
+  FamiliarOSPickedFile,
+  FamiliarOSPluginDefinition,
+  FamiliarOSStatus,
 } from "./index.js";
 import { createMockContext } from "./testing.js";
 
@@ -35,25 +35,25 @@ const assert = {
 };
 
 // A representative v3 plugin, typed against the public contract.
-const plugin: OpenPetsPluginDefinition = {
-  async start(ctx: OpenPetsContext) {
+const plugin: FamiliarOSPluginDefinition = {
+  async start(ctx: FamiliarOSContext) {
     await ctx.status.set({ text: "Ready", tone: "info" });
-    await ctx.pet.speak("Hello!");
-    await ctx.pet.react("waving");
-    await ctx.pet.react("waving", { showMessage: false });
-    await ctx.pet.setStatusReaction("thinking");
+    await ctx.familiar.speak("Hello!");
+    await ctx.familiar.react("waving");
+    await ctx.familiar.react("waving", { showMessage: false });
+    await ctx.familiar.setStatusReaction("thinking");
     const alert = await ctx.ui.alert({ text: "Heads up", markdown: "**Check complete**", icon: "bell", tone: "info", sound: "alert" });
     alert.onAction(() => undefined);
     await alert.acknowledge();
-    const bubble: OpenPetsBubbleHandle = await ctx.ui.bubble({
+    const bubble: FamiliarOSBubbleHandle = await ctx.ui.bubble({
       text: "Break in 5:00",
       sticky: true,
       actions: [{ id: "snooze", label: "Snooze" }, { id: "done", label: "Done", style: "primary" }],
-    } satisfies OpenPetsBubble);
+    } satisfies FamiliarOSBubble);
     bubble.onAction(async (actionId) => {
       if (actionId === "done") await bubble.dismiss();
     });
-    const hudBubble: OpenPetsBubbleHandle = await ctx.ui.bubble({
+    const hudBubble: FamiliarOSBubbleHandle = await ctx.ui.bubble({
       pin: true,
       hud: {
         items: [
@@ -61,27 +61,27 @@ const plugin: OpenPetsPluginDefinition = {
           { icon: "zap", value: 60, tone: "blue", label: "Energy" },
         ],
       },
-    } satisfies OpenPetsBubble);
+    } satisfies FamiliarOSBubble);
     await ctx.schedule.every("tick", 60_000, async () => {
       await ctx.storage.set("lastTick", "now");
     });
     await ctx.schedule.cron("daily-summary", "0 9 * * 1-5", async () => {
       await ctx.storage.set("summaryRan", true);
     });
-    ctx.events.on("pet:clicked", () => {
-      void ctx.pet.react("celebrating");
+    ctx.events.on("familiar:clicked", () => {
+      void ctx.familiar.react("celebrating");
     });
     ctx.storage.subscribe("lastTick", () => undefined);
     await ctx.bus.publish("sample/mood", { mood: "happy" });
-    const picked: OpenPetsPickedFile = (await ctx.files.pick({ accept: ["audio/*"] }))[0]!;
+    const picked: FamiliarOSPickedFile = (await ctx.files.pick({ accept: ["audio/*"] }))[0]!;
     const sound = await ctx.audio.importUserSound(picked, { name: "Bell" });
     await ctx.audio.play(sound);
     await ctx.audio.forgetUserSound(sound);
     await ctx.commands.register({ id: "greet", title: "Greet" }, async () => {
-      await ctx.pet.speak("Hi again!");
+      await ctx.familiar.speak("Hi again!");
     });
     // i18n surface: ctx.locale (active host locale) + ctx.t (runtime translation).
-    await ctx.status.set({ text: `${ctx.locale}:${ctx.t("greeting", { name: "Pet" })}` });
+    await ctx.status.set({ text: `${ctx.locale}:${ctx.t("greeting", { name: "Familiar" })}` });
   },
 };
 
@@ -121,27 +121,27 @@ await calls.schedules.get("tick")?.handler();
 assert.equal(calls.storage.get("lastTick"), "now");
 
 // Curated events reach subscribers.
-await harness.emit("pet:clicked", { petId: "default" });
+await harness.emit("familiar:clicked", { petId: "default" });
 assert.deepEqual(calls.react, ["waving", "waving", "celebrating"]);
 
 await calls.commands.get("greet")?.handler();
 assert.deepEqual(calls.speak, ["Hello!", "Heads up", "Break in 5:00", "Hi again!"]);
 
-const status: OpenPetsStatus = calls.status[0]!;
+const status: FamiliarOSStatus = calls.status[0]!;
 assert.ok(typeof status === "object" && status.text === "Ready");
 
 // ctx.t / ctx.locale drift checks: the runtime bridge must expose both members.
 assert.equal(ctx.locale, "en", "ctx.locale defaults to en");
-assert.equal(ctx.t("missing.key", { name: "Pet" }), "missing.key", "ctx.t echoes unknown keys");
+assert.equal(ctx.t("missing.key", { name: "Familiar" }), "missing.key", "ctx.t echoes unknown keys");
 const i18nStatus = calls.status[1]!;
 assert.ok(typeof i18nStatus === "object" && i18nStatus.text === "en:greeting", "no-catalog ctx.t echoes key, ctx.locale is en");
 
 // A harness with catalogs resolves active locale -> en -> key, then interpolates.
 const i18n = createMockContext({ locales: { en: { greeting: "Hi {name}" }, ja: { greeting: "やあ {name}" } } });
-assert.equal(i18n.ctx.t("greeting", { name: "Pet" }), "Hi Pet", "default locale uses en catalog");
+assert.equal(i18n.ctx.t("greeting", { name: "Familiar" }), "Hi Familiar", "default locale uses en catalog");
 i18n.harness.system.set({ locale: "ja" });
 assert.equal(i18n.ctx.locale, "ja", "ctx.locale follows system.set({ locale })");
-assert.equal(i18n.ctx.t("greeting", { name: "Pet" }), "やあ Pet", "active locale catalog wins");
+assert.equal(i18n.ctx.t("greeting", { name: "Familiar" }), "やあ Familiar", "active locale catalog wins");
 assert.equal(i18n.ctx.t("absent"), "absent", "unknown key echoes even with catalogs");
 
 console.log("Plugin SDK contract tests passed.");
diff --git a/packages/sdk/src/codemap.md b/packages/sdk/src/codemap.md
index 3254117f..63c3ae4c 100644
--- a/packages/sdk/src/codemap.md
+++ b/packages/sdk/src/codemap.md
@@ -1,10 +1,10 @@
 # packages/sdk/src
 
-Public type surface for OpenPets plugin authors. Types only — no runtime.
+Public type surface for FamiliarOS plugin authors. Types only — no runtime.
 
-- `index.ts` — the published contract: the `OpenPetsContext` (`ctx`) interface,
-  command/status/http/schedule types, the `OpenPetsPluginDefinition` shape, and
-  the ambient `OpenPetsPlugin` global. Mirrors the runtime implemented by
+- `index.ts` — the published contract: the `FamiliarOSContext` (`ctx`) interface,
+  command/status/http/schedule types, the `FamiliarOSPluginDefinition` shape, and
+  the ambient `FamiliarOSPlugin` global. Mirrors the runtime implemented by
   `apps/desktop/src/plugin-sdk-bridge.ts`. Keep the two in sync when the SDK
   surface changes.
 - `check-plugin-sdk.ts` — contract test. Compiles a representative plugin
diff --git a/packages/sdk/src/index.ts b/packages/sdk/src/index.ts
index 1d681d2c..1aa1b74e 100644
--- a/packages/sdk/src/index.ts
+++ b/packages/sdk/src/index.ts
@@ -1,16 +1,16 @@
 /**
- * Type definitions for OpenPets plugins — SDK v3 ("SuperPlugins").
+ * Type definitions for FamiliarOS plugins — SDK v3 ("SuperPlugins").
  *
  * This package ships **types only**. There is no runtime to import — the
- * OpenPets desktop app injects the `OpenPetsPlugin` global into the plugin
- * sandbox and passes your `start(ctx)` handler an {@link OpenPetsContext}.
+ * FamiliarOS desktop app injects the `FamiliarOSPlugin` global into the plugin
+ * sandbox and passes your `start(ctx)` handler an {@link FamiliarOSContext}.
  *
  * In a plain JavaScript plugin, reference these types for editor IntelliSense:
  *
  * ```js
- * /// <reference types="@open-pets/plugin-sdk" />
+ * /// <reference types="@familiaros/plugin-sdk" />
  *
- * OpenPetsPlugin.register({
+ * FamiliarOSPlugin.register({
  *   async start(ctx) {
  *     const bubble = await ctx.ui.bubble({ text: "Hello!", sticky: true })
  *     bubble.onAction(() => bubble.dismiss())
@@ -18,33 +18,33 @@
  * })
  * ```
  *
- * SDK v3 reframes a pet as a programmable surface: the API is organized into
- * subsystems (`ui`, `pets`, `events`, `audio`, `ai`, …) instead of one flat
- * `ctx.pet` namespace. The v2 surface (`ctx.pet.speak`, `ctx.http.fetch`, …)
+ * SDK v3 reframes a familiar as a programmable surface: the API is organized into
+ * subsystems (`ui`, `familiars`, `events`, `audio`, `ai`, …) instead of one flat
+ * `ctx.familiar` namespace. The v2 surface (`ctx.familiar.speak`, `ctx.http.fetch`, …)
  * keeps working unchanged.
  *
  * @packageDocumentation
  */
 
 /** Capabilities a plugin can request in its manifest's `permissions` array. */
-export type OpenPetsPermission =
+export type FamiliarOSPermission =
   // v2 permissions (unchanged)
-  | "pet:speak"
-  | "pet:reaction"
-  | "pet:move"
+  | "familiar:speak"
+  | "familiar:reaction"
+  | "familiar:move"
   | "schedule"
   | "storage"
   | "status"
   | "commands"
   | "network"
   // v3 permissions
-  | "pet:interact"
-  | "pet:pin"
-  | "pet:animate"
-  | "pet:speak:dynamic"
-  | "pet:drop"
-  | "pets:read"
-  | "pets:manage"
+  | "familiar:interact"
+  | "familiar:pin"
+  | "familiar:animate"
+  | "familiar:speak:dynamic"
+  | "familiar:drop"
+  | "familiars:read"
+  | "familiars:manage"
   | "audio"
   | "events"
   | "ui:toast"
@@ -63,10 +63,10 @@ export type OpenPetsPermission =
   | "network:write";
 
 /**
- * Reaction name passed to {@link OpenPetsPetHandle.react}. Common values are
+ * Reaction name passed to {@link FamiliarOSPetHandle.react}. Common values are
  * listed for autocomplete; any string the host accepts is allowed.
  */
-export type OpenPetsReaction =
+export type FamiliarOSReaction =
   | "idle"
   | "thinking"
   | "working"
@@ -82,19 +82,19 @@ export type OpenPetsReaction =
   | (string & {});
 
 /** Tone shown alongside a plugin's status line or bubble. */
-export type OpenPetsStatusTone = "info" | "success" | "warning" | "error";
+export type FamiliarOSStatusTone = "info" | "success" | "warning" | "error";
 
-/** A status line, either a bare string or text plus a {@link OpenPetsStatusTone}. */
-export type OpenPetsStatus = string | { text: string; tone?: OpenPetsStatusTone };
+/** A status line, either a bare string or text plus a {@link FamiliarOSStatusTone}. */
+export type FamiliarOSStatus = string | { text: string; tone?: FamiliarOSStatusTone };
 
 /** A point in screen coordinates. */
-export interface OpenPetsPoint {
+export interface FamiliarOSPoint {
   x: number;
   y: number;
 }
 
 /** A rectangle in screen coordinates. */
-export interface OpenPetsRect {
+export interface FamiliarOSRect {
   x: number;
   y: number;
   width: number;
@@ -107,58 +107,58 @@ export interface OpenPetsRect {
 
 /**
  * An opaque reference to an asset bundled with the plugin and declared in the
- * manifest's `assets` block. Obtained from {@link OpenPetsAssetsApi}; never
+ * manifest's `assets` block. Obtained from {@link FamiliarOSAssetsApi}; never
  * constructed by hand. Plugins pass references, never raw bytes or markup.
  */
-export interface OpenPetsAssetRef {
+export interface FamiliarOSAssetRef {
   readonly kind: "icon" | "image" | "svg" | "sprite" | "sound";
   readonly name: string;
 }
 
 /** A named host icon (curated set) or a bundled icon asset reference. */
-export type OpenPetsIconRef = string | OpenPetsAssetRef;
+export type FamiliarOSIconRef = string | FamiliarOSAssetRef;
 
 /** A JSON-safe reference to a user-imported sound. */
-export interface OpenPetsUserSoundRef {
+export interface FamiliarOSUserSoundRef {
   readonly kind: "user-sound";
   readonly id: string;
   readonly name?: string;
 }
 
 /** A named host sound, bundled sound asset, or user-imported sound reference. */
-export type OpenPetsSoundRef = string | OpenPetsAssetRef | OpenPetsUserSoundRef;
+export type FamiliarOSSoundRef = string | FamiliarOSAssetRef | FamiliarOSUserSoundRef;
 
 /** Resolve manifest-declared assets to opaque references. */
-export interface OpenPetsAssetsApi {
+export interface FamiliarOSAssetsApi {
   /** Resolve a manifest-declared icon. */
-  icon(name: string): OpenPetsAssetRef;
+  icon(name: string): FamiliarOSAssetRef;
   /** Resolve a manifest-declared raster image. */
-  image(name: string): OpenPetsAssetRef;
+  image(name: string): FamiliarOSAssetRef;
   /** Resolve a manifest-declared, install-time-sanitized SVG. */
-  svg(name: string): OpenPetsAssetRef;
+  svg(name: string): FamiliarOSAssetRef;
   /** Resolve a manifest-declared spritesheet. */
-  sprite(name: string): OpenPetsAssetRef;
+  sprite(name: string): FamiliarOSAssetRef;
   /** Resolve a manifest-declared sound. */
-  sound(name: string): OpenPetsAssetRef;
+  sound(name: string): FamiliarOSAssetRef;
 }
 
 // ---------------------------------------------------------------------------
 // Rich bubbles (§1)
 // ---------------------------------------------------------------------------
 
-/** A button rendered inside a bubble. Requires `pet:interact`. */
-export interface OpenPetsBubbleAction {
+/** A button rendered inside a bubble. Requires `familiar:interact`. */
+export interface FamiliarOSBubbleAction {
   /** Short, stable id (`[A-Za-z0-9._:-]`, 1–64 chars). */
   id: string;
   label: string;
   style?: "default" | "primary" | "danger";
-  icon?: OpenPetsIconRef;
+  icon?: FamiliarOSIconRef;
   /** Dismiss the bubble when this action fires. Default true. */
   dismissesBubble?: boolean;
 }
 
-/** An inline input rendered inside a bubble. Requires `pet:interact`. */
-export interface OpenPetsBubbleInput {
+/** An inline input rendered inside a bubble. Requires `familiar:interact`. */
+export interface FamiliarOSBubbleInput {
   id: string;
   type: "text" | "number" | "select";
   placeholder?: string;
@@ -169,9 +169,9 @@ export interface OpenPetsBubbleInput {
 }
 
 /** A HUD item shown in the host-rendered pinned mini-HUD bubble. */
-export interface OpenPetsBubbleHudItem {
+export interface FamiliarOSBubbleHudItem {
   /** Named host icon or bundled icon asset reference. */
-  icon: OpenPetsIconRef;
+  icon: FamiliarOSIconRef;
   /** Numeric value between 0 and 100 inclusive. */
   value: number;
   /** Optional short display label. */
@@ -181,36 +181,36 @@ export interface OpenPetsBubbleHudItem {
 }
 
 /** Descriptor for a host-rendered mini HUD layout, used in pinned bubbles. */
-export interface OpenPetsBubbleHud {
+export interface FamiliarOSBubbleHud {
   /** List of HUD items (usually up to 4 items). */
-  items: OpenPetsBubbleHudItem[];
+  items: FamiliarOSBubbleHudItem[];
 }
 
 /**
  * A structured, host-rendered bubble descriptor. The plugin describes; the
  * host renders — no raw HTML or live DOM ever crosses the SDK boundary.
  */
-export interface OpenPetsBubble {
+export interface FamiliarOSBubble {
   // --- content ---
   /** Host-rendered mini HUD layout for pinned bubbles. */
-  hud?: OpenPetsBubbleHud;
+  hud?: FamiliarOSBubbleHud;
   /** Plain text, length-capped, content-filtered. */
   text?: string;
   /** Limited markdown (bold/italic/code/line breaks), host-sanitized. */
   markdown?: string;
   /** Named host icon or a bundled icon asset. Body media is icon-only; use `indicator` for icon + message. */
-  icon?: OpenPetsIconRef;
+  icon?: FamiliarOSIconRef;
   /** Bundled, install-time-sanitized SVG. Body media is icon-only; use `indicator` for icon + message. */
-  svg?: OpenPetsAssetRef;
+  svg?: FamiliarOSAssetRef;
   /** Bundled raster image. Body media is icon-only; use `indicator` for icon + message. */
-  image?: OpenPetsAssetRef;
-  tone?: OpenPetsStatusTone;
+  image?: FamiliarOSAssetRef;
+  tone?: FamiliarOSStatusTone;
   /** Optional top-row indicator/header. Intended primarily for alerts. */
-  indicator?: OpenPetsAlertIndicator | false;
+  indicator?: FamiliarOSAlertIndicator | false;
   /** Theme-token name, not a raw color string. */
   accent?: string;
   /**
-   * Marks content as model-generated. Requires `pet:speak:dynamic` and the
+   * Marks content as model-generated. Requires `familiar:speak:dynamic` and the
    * global "allow AI speech" setting; uses the relaxed dynamic screen instead
    * of the static ambient filter (§13.1).
    */
@@ -221,35 +221,35 @@ export interface OpenPetsBubble {
   durationMs?: number;
   /** Ignore duration; stay until dismissed or replaced. */
   sticky?: boolean;
-  /** Occupy the persistent pinned slot (max 1 per pet). Requires `pet:pin`. */
+  /** Occupy the persistent pinned slot (max 1 per familiar). Requires `familiar:pin`. */
   pin?: boolean;
   dismissOn?: Array<"timeout" | "click" | "petClick" | "action" | "outsideClick">;
   /** Feeds the bubble arbiter. Default "normal". */
   priority?: "low" | "normal" | "high" | "urgent";
 
   // --- interaction ---
-  actions?: OpenPetsBubbleAction[];
-  input?: OpenPetsBubbleInput;
+  actions?: FamiliarOSBubbleAction[];
+  input?: FamiliarOSBubbleInput;
 }
 
 /** Why a bubble went away. */
-export type OpenPetsBubbleDismissReason = "timeout" | "click" | "replaced" | "manual" | "unpinned";
+export type FamiliarOSBubbleDismissReason = "timeout" | "click" | "replaced" | "manual" | "unpinned";
 
 /**
  * Live handle to a shown bubble. Lets the plugin update it in place
  * (progress, countdowns, streamed tokens) and receive interaction callbacks.
  */
-export interface OpenPetsBubbleHandle {
+export interface FamiliarOSBubbleHandle {
   readonly id: string;
-  update(patch: Partial<OpenPetsBubble>): Promise<void>;
+  update(patch: Partial<FamiliarOSBubble>): Promise<void>;
   dismiss(): Promise<void>;
-  /** Promote this bubble to the pinned slot (§1.5). Requires `pet:pin`. */
+  /** Promote this bubble to the pinned slot (§1.5). Requires `familiar:pin`. */
   pin(): Promise<void>;
   /** Release the pinned slot. */
   unpin(): Promise<void>;
   onAction(handler: (actionId: string) => void | Promise<void>): void;
   onSubmit(handler: (values: Record<string, string | number>) => void | Promise<void>): void;
-  onDismiss(handler: (reason: OpenPetsBubbleDismissReason) => void): void;
+  onDismiss(handler: (reason: FamiliarOSBubbleDismissReason) => void): void;
 }
 
 // ---------------------------------------------------------------------------
@@ -257,7 +257,7 @@ export interface OpenPetsBubbleHandle {
 // ---------------------------------------------------------------------------
 
 /** Options for opening a sandboxed plugin panel (§7.2). Requires `ui:panel`. */
-export interface OpenPetsPanelOptions {
+export interface FamiliarOSPanelOptions {
   /** Name of a manifest-declared panel page (`panels` block). */
   panel: string;
   title?: string;
@@ -266,7 +266,7 @@ export interface OpenPetsPanelOptions {
 }
 
 /** Handle to a sandboxed plugin panel window. */
-export interface OpenPetsPanelHandle {
+export interface FamiliarOSPanelHandle {
   readonly id: string;
   show(): Promise<void>;
   hide(): Promise<void>;
@@ -278,16 +278,16 @@ export interface OpenPetsPanelHandle {
 }
 
 /** Alert header indicator rendered above alert text. Custom art must be a manifest-declared asset. */
-export interface OpenPetsAlertIndicator {
+export interface FamiliarOSAlertIndicator {
   /** Visible/accessibility label shown next to the icon. */
   label?: string;
   /** Named host icon or manifest-declared icon asset (`ctx.assets.icon(...)`). */
-  icon?: OpenPetsIconRef;
+  icon?: FamiliarOSIconRef;
   /** Manifest-declared sanitized SVG asset (`ctx.assets.svg(...)`). */
-  svg?: OpenPetsAssetRef;
+  svg?: FamiliarOSAssetRef;
   /** Manifest-declared raster/icon image asset. */
-  image?: OpenPetsAssetRef;
-  tone?: OpenPetsStatusTone;
+  image?: FamiliarOSAssetRef;
+  tone?: FamiliarOSStatusTone;
   /** Safe CSS color for the icon/SVG (`#hex`, `rgb(a)`, or `hsl(a)`). */
   color?: string;
   /** Safe CSS background color for the circular icon well. */
@@ -299,38 +299,38 @@ export interface OpenPetsAlertIndicator {
 }
 
 /**
- * Must-not-miss pet alert. Alerts render as sticky high-priority bubbles and
+ * Must-not-miss familiar alert. Alerts render as sticky high-priority bubbles and
  * may also request best-effort sound and OS notification delivery.
  */
-export interface OpenPetsAlert extends Omit<OpenPetsBubble, "sticky" | "priority"> {
+export interface FamiliarOSAlert extends Omit<FamiliarOSBubble, "sticky" | "priority"> {
   /** Optional sound to play with the alert. Requires `audio` only when set. */
-  sound?: OpenPetsSoundRef;
+  sound?: FamiliarOSSoundRef;
   /** Optional OS notification. Requires `notify` only when set. */
   notify?: { title: string; body?: string; sound?: boolean };
 }
 
 /** Handle to a live alert bubble. */
-export interface OpenPetsAlertHandle extends OpenPetsBubbleHandle {
+export interface FamiliarOSAlertHandle extends FamiliarOSBubbleHandle {
   /** Mark the alert acknowledged and dismiss it. */
   acknowledge(): Promise<void>;
 }
 
 /** Bubbles, toasts, panels, and the dynamic context-menu section. */
-export interface OpenPetsUiApi {
-  /** Show a bubble on the default pet. Requires `pet:speak`. */
-  bubble(spec: string | OpenPetsBubble): Promise<OpenPetsBubbleHandle>;
+export interface FamiliarOSUiApi {
+  /** Show a bubble on the default familiar. Requires `familiar:speak`. */
+  bubble(spec: string | FamiliarOSBubble): Promise<FamiliarOSBubbleHandle>;
   /** Show a transient host toast. Requires `ui:toast`. */
-  toast(spec: { text: string; tone?: OpenPetsStatusTone; durationMs?: number }): Promise<void>;
-  /** Show a sticky high-priority alert bubble. Requires `pet:speak`. */
-  alert(spec: OpenPetsAlert): Promise<OpenPetsAlertHandle>;
+  toast(spec: { text: string; tone?: FamiliarOSStatusTone; durationMs?: number }): Promise<void>;
+  /** Show a sticky high-priority alert bubble. Requires `familiar:speak`. */
+  alert(spec: FamiliarOSAlert): Promise<FamiliarOSAlertHandle>;
   /** Open a sandboxed plugin webview panel. Requires `ui:panel`. */
-  panel(spec: OpenPetsPanelOptions): Promise<OpenPetsPanelHandle>;
+  panel(spec: FamiliarOSPanelOptions): Promise<FamiliarOSPanelHandle>;
   /** Fully dynamic context-menu section. Requires `commands`. */
-  menu: OpenPetsMenuApi;
+  menu: FamiliarOSMenuApi;
 }
 
 /** OS notifications. Requires `notify`. */
-export interface OpenPetsNotifyApi {
+export interface FamiliarOSNotifyApi {
   notify(spec: { title: string; body?: string; sound?: boolean }): Promise<void>;
 }
 
@@ -339,18 +339,18 @@ export interface OpenPetsNotifyApi {
 // ---------------------------------------------------------------------------
 
 /** Play named host sounds or bundled plugin sounds. Requires `audio`. */
-export interface OpenPetsAudioApi {
+export interface FamiliarOSAudioApi {
   /**
    * Play a sound. Named host sounds (`"chime"`, `"pop"`, `"nom"`, `"alert"`,
    * `"level-up"`) need no assets; bundled sounds come from
-   * {@link OpenPetsAssetsApi.sound}. Gated by the global sound toggle and
+   * {@link FamiliarOSAssetsApi.sound}. Gated by the global sound toggle and
    * quiet hours.
    */
-  play(sound: OpenPetsSoundRef, options?: { volume?: number }): Promise<void>;
+  play(sound: FamiliarOSSoundRef, options?: { volume?: number }): Promise<void>;
   /** Import a user-picked sound into plugin-owned host storage. Requires `audio` and `files`. */
-  importUserSound(file: OpenPetsPickedFile, opts?: { name?: string }): Promise<OpenPetsUserSoundRef>;
+  importUserSound(file: FamiliarOSPickedFile, opts?: { name?: string }): Promise<FamiliarOSUserSoundRef>;
   /** Forget a previously imported user sound. Requires `audio`. */
-  forgetUserSound(ref: OpenPetsUserSoundRef): Promise<void>;
+  forgetUserSound(ref: FamiliarOSUserSoundRef): Promise<void>;
   stop(handle?: string): Promise<void>;
 }
 
@@ -359,13 +359,13 @@ export interface OpenPetsAudioApi {
 // ---------------------------------------------------------------------------
 
 /** Curated, read-only host event names. */
-export type OpenPetsEventName =
-  | "pet:clicked"
-  | "pet:doubleClicked"
-  | "pet:dragStart"
-  | "pet:dragEnd"
-  | "pet:hover"
-  | "pet:drop"
+export type FamiliarOSEventName =
+  | "familiar:clicked"
+  | "familiar:doubleClicked"
+  | "familiar:dragStart"
+  | "familiar:dragEnd"
+  | "familiar:hover"
+  | "familiar:drop"
   | "idle:enter"
   | "idle:exit"
   | "agent:activity"
@@ -379,30 +379,30 @@ export type OpenPetsEventName =
   | "offline"
   | "day:partChanged";
 
-/** A file delivered by an explicit user drop onto the pet (§13.7). */
-export interface OpenPetsDroppedFile {
+/** A file delivered by an explicit user drop onto the familiar (§13.7). */
+export interface FamiliarOSDroppedFile {
   name: string;
   sizeBytes: number;
   /** One-shot, size-capped read of the dropped file's text content. */
   readText(): Promise<string>;
 }
 
-/** Payload for `pet:drop`. */
-export interface OpenPetsDropEvent {
+/** Payload for `familiar:drop`. */
+export interface FamiliarOSDropEvent {
   kind: "text" | "files";
   text?: string;
-  files?: OpenPetsDroppedFile[];
+  files?: FamiliarOSDroppedFile[];
   petId: string;
 }
 
 /** Payload shapes per event. Unlisted events carry a small data record. */
-export interface OpenPetsEventPayloads {
-  "pet:clicked": { petId: string };
-  "pet:doubleClicked": { petId: string };
-  "pet:dragStart": { petId: string };
-  "pet:dragEnd": { petId: string };
-  "pet:hover": { petId: string };
-  "pet:drop": OpenPetsDropEvent;
+export interface FamiliarOSEventPayloads {
+  "familiar:clicked": { petId: string };
+  "familiar:doubleClicked": { petId: string };
+  "familiar:dragStart": { petId: string };
+  "familiar:dragEnd": { petId: string };
+  "familiar:hover": { petId: string };
+  "familiar:drop": FamiliarOSDropEvent;
   "idle:enter": { idleSeconds: number };
   "idle:exit": { idleSeconds: number };
   "agent:activity": { kind: string; reaction?: string };
@@ -417,118 +417,118 @@ export interface OpenPetsEventPayloads {
   "day:partChanged": { part: "morning" | "afternoon" | "evening" | "night" };
 }
 
-export type OpenPetsEvent<E extends OpenPetsEventName> = OpenPetsEventPayloads[E];
+export type FamiliarOSEvent<E extends FamiliarOSEventName> = FamiliarOSEventPayloads[E];
 
 /**
  * Subscribe to the curated host event stream. Requires `events`
- * (`pet:drop` additionally requires `pet:drop`).
+ * (`familiar:drop` additionally requires `familiar:drop`).
  *
  * The event set is explicitly bounded: no keystrokes, no screen contents, no
  * other apps' window titles, no clipboard, no ambient filesystem watching.
  */
-export interface OpenPetsEventsApi {
-  on<E extends OpenPetsEventName>(event: E, handler: (e: OpenPetsEvent<E>) => void): () => void;
+export interface FamiliarOSEventsApi {
+  on<E extends FamiliarOSEventName>(event: E, handler: (e: FamiliarOSEvent<E>) => void): () => void;
 }
 
 // ---------------------------------------------------------------------------
-// Multi-pet & liveness (§4, §5, §13.6)
+// Multi-familiar & liveness (§4, §5, §13.6)
 // ---------------------------------------------------------------------------
 
-/** Options for {@link OpenPetsPetHandle.moveBy}. */
-export interface OpenPetsMoveByOptions {
+/** Options for {@link FamiliarOSPetHandle.moveBy}. */
+export interface FamiliarOSMoveByOptions {
   x: number;
   y: number;
   durationMs?: number;
 }
 
-/** Options for {@link OpenPetsPetHandle.wander}. */
-export interface OpenPetsWanderOptions {
+/** Options for {@link FamiliarOSPetHandle.wander}. */
+export interface FamiliarOSWanderOptions {
   distance?: number;
   durationMs?: number;
 }
 
 /** Beyond named reactions: a bundled spritesheet animation (§5). */
-export type OpenPetsAnimationState =
-  | OpenPetsReaction
-  | { sprite: OpenPetsAssetRef; loop?: boolean; fps?: number };
+export type FamiliarOSAnimationState =
+  | FamiliarOSReaction
+  | { sprite: FamiliarOSAssetRef; loop?: boolean; fps?: number };
 
-/** Self-perception snapshot returned by {@link OpenPetsPetHandle.getState}. */
-export interface OpenPetsPetState {
-  position: OpenPetsPoint;
-  bounds: OpenPetsRect;
+/** Self-perception snapshot returned by {@link FamiliarOSPetHandle.getState}. */
+export interface FamiliarOSPetState {
+  position: FamiliarOSPoint;
+  bounds: FamiliarOSRect;
   currentAnimation: string;
   visible: boolean;
   dragging: boolean;
 }
 
-export interface OpenPetsPetInfo {
+export interface FamiliarOSPetInfo {
   id: string;
   name: string;
   kind: "default" | "agent" | "plugin";
   visible: boolean;
 }
 
-export interface OpenPetsReactOptions {
+export interface FamiliarOSReactOptions {
   /** Set false to animate without showing the built-in reaction/status message. */
   showMessage?: boolean;
 }
 
-/** Addressable handle to a single pet. */
-export interface OpenPetsPetHandle {
+/** Addressable handle to a single familiar. */
+export interface FamiliarOSPetHandle {
   readonly id: string;
-  /** Requires `pet:speak`. Accepts plain text or a full bubble descriptor. */
-  speak(spec: string | OpenPetsBubble): Promise<OpenPetsBubbleHandle>;
-  /** Requires `pet:reaction`. */
-  react(reaction: OpenPetsReaction, options?: OpenPetsReactOptions): Promise<void>;
-  /** Requires `pet:animate` for sprite states; named reactions need `pet:reaction`. */
-  setAnimation(state: OpenPetsAnimationState): Promise<void>;
-  /** Bounded by the host (0.5–2). Requires `pet:animate`. */
+  /** Requires `familiar:speak`. Accepts plain text or a full bubble descriptor. */
+  speak(spec: string | FamiliarOSBubble): Promise<FamiliarOSBubbleHandle>;
+  /** Requires `familiar:reaction`. */
+  react(reaction: FamiliarOSReaction, options?: FamiliarOSReactOptions): Promise<void>;
+  /** Requires `familiar:animate` for sprite states; named reactions need `familiar:reaction`. */
+  setAnimation(state: FamiliarOSAnimationState): Promise<void>;
+  /** Bounded by the host (0.5–2). Requires `familiar:animate`. */
   setScale(scale: number): Promise<void>;
-  /** Show a status reaction (or clear with null). Requires `pet:reaction`. */
-  setStatusReaction(reaction: OpenPetsReaction | null): Promise<void>;
-  /** Requires `pet:move`. Movement is bounded to the work area. */
-  moveBy(options: OpenPetsMoveByOptions): Promise<void>;
-  /** Requires `pet:move`. */
-  wander(options?: OpenPetsWanderOptions): Promise<void>;
-  /** Requires `pet:move`. */
+  /** Show a status reaction (or clear with null). Requires `familiar:reaction`. */
+  setStatusReaction(reaction: FamiliarOSReaction | null): Promise<void>;
+  /** Requires `familiar:move`. Movement is bounded to the work area. */
+  moveBy(options: FamiliarOSMoveByOptions): Promise<void>;
+  /** Requires `familiar:move`. */
+  wander(options?: FamiliarOSWanderOptions): Promise<void>;
+  /** Requires `familiar:move`. */
   moveToHome(): Promise<void>;
-  /** Animated absolute move. Requires `pet:move`. */
-  moveTo(point: OpenPetsPoint, opts?: { durationMs?: number; easing?: string }): Promise<void>;
-  /** Continuous cursor following with lag. Requires `pet:move`. */
+  /** Animated absolute move. Requires `familiar:move`. */
+  moveTo(point: FamiliarOSPoint, opts?: { durationMs?: number; easing?: string }): Promise<void>;
+  /** Continuous cursor following with lag. Requires `familiar:move`. */
   followCursor(opts?: { enabled: boolean; lag?: number }): Promise<void>;
-  /** Lightweight physics (gravity/bounce). Requires `pet:move`. */
+  /** Lightweight physics (gravity/bounce). Requires `familiar:move`. */
   physics(opts?: { gravity?: boolean; bounce?: number; climbEdges?: boolean }): Promise<void>;
   /**
    * Continuous behavior loop — host-driven, throttled, auto-paused while the
-   * pet is hidden or being dragged. The brain loop for "alive" pets.
+   * familiar is hidden or being dragged. The brain loop for "alive" familiars.
    * Requires `events`. Returns an unsubscribe function.
    */
   onTick(handler: (dtMs: number) => void): () => void;
-  /** Self-perception. Requires `pets:read`. */
-  getState(): Promise<OpenPetsPetState>;
-  /** Requires `pets:manage`. */
+  /** Self-perception. Requires `familiars:read`. */
+  getState(): Promise<FamiliarOSPetState>;
+  /** Requires `familiars:manage`. */
   show(): Promise<void>;
-  /** Requires `pets:manage`. */
+  /** Requires `familiars:manage`. */
   hide(): Promise<void>;
-  /** Close an ephemeral/spawned pet. Requires `pets:manage`. */
+  /** Close an ephemeral/spawned familiar. Requires `familiars:manage`. */
   close(): Promise<void>;
 }
 
-/** Multi-pet registry: list, target, spawn. */
-export interface OpenPetsPetsApi {
-  readonly default: OpenPetsPetHandle;
-  /** Requires `pets:read`. */
-  list(): Promise<OpenPetsPetInfo[]>;
-  get(petId: string): OpenPetsPetHandle;
-  /** Spawn an ephemeral pet window. Requires `pets:manage`. */
+/** Multi-familiar registry: list, target, spawn. */
+export interface FamiliarOSPetsApi {
+  readonly default: FamiliarOSPetHandle;
+  /** Requires `familiars:read`. */
+  list(): Promise<FamiliarOSPetInfo[]>;
+  get(petId: string): FamiliarOSPetHandle;
+  /** Spawn an ephemeral familiar window. Requires `familiars:manage`. */
   spawn(spec: {
     petId: string;
     name?: string;
-    position?: OpenPetsPoint;
+    position?: FamiliarOSPoint;
     ephemeral?: boolean;
-  }): Promise<OpenPetsPetHandle>;
-  /** Requires `pets:read`. Returns an unsubscribe function. */
-  onChange(handler: (pets: OpenPetsPetInfo[]) => void): () => void;
+  }): Promise<FamiliarOSPetHandle>;
+  /** Requires `familiars:read`. Returns an unsubscribe function. */
+  onChange(handler: (familiars: FamiliarOSPetInfo[]) => void): () => void;
 }
 
 // ---------------------------------------------------------------------------
@@ -536,7 +536,7 @@ export interface OpenPetsPetsApi {
 // ---------------------------------------------------------------------------
 
 /** A single field in a command's input form (extended in v3, §8.1). */
-export interface OpenPetsCommandFormField {
+export interface FamiliarOSCommandFormField {
   /** Identifier for this field; the submitted value is keyed by it. */
   id: string;
   type:
@@ -562,20 +562,20 @@ export interface OpenPetsCommandFormField {
 }
 
 /** Optional input form attached to a command. */
-export interface OpenPetsCommandForm {
-  fields: OpenPetsCommandFormField[];
+export interface FamiliarOSCommandForm {
+  fields: FamiliarOSCommandFormField[];
   submitLabel?: string;
 }
 
-/** A right-click pet action registered via {@link OpenPetsCommandsApi.register}. */
-export interface OpenPetsCommand {
+/** A right-click familiar action registered via {@link FamiliarOSCommandsApi.register}. */
+export interface FamiliarOSCommand {
   /** Short, stable id (`[A-Za-z0-9._:-]`, 1–64 chars). */
   id: string;
   title: string;
   description?: string;
-  icon?: OpenPetsIconRef;
+  icon?: FamiliarOSIconRef;
   /** When present, the host opens a dialog and passes validated values to the handler. */
-  form?: OpenPetsCommandForm;
+  form?: FamiliarOSCommandForm;
   /** Top-level item vs grouped plugin submenu. Default "submenu". */
   placement?: "top" | "submenu";
   /** Ordering within its group (higher first). */
@@ -583,8 +583,8 @@ export interface OpenPetsCommand {
   featured?: boolean;
 }
 
-/** A dynamic context-menu item set via {@link OpenPetsMenuApi.setItems}. */
-export interface OpenPetsMenuItem {
+/** A dynamic context-menu item set via {@link FamiliarOSMenuApi.setItems}. */
+export interface FamiliarOSMenuItem {
   id: string;
   title: string;
   enabled?: boolean;
@@ -592,17 +592,17 @@ export interface OpenPetsMenuItem {
 }
 
 /** Fully dynamic context-menu section. Requires `commands`. */
-export interface OpenPetsMenuApi {
-  setItems(items: OpenPetsMenuItem[]): Promise<void>;
+export interface FamiliarOSMenuApi {
+  setItems(items: FamiliarOSMenuItem[]): Promise<void>;
   onSelect(handler: (id: string) => void | Promise<void>): () => void;
 }
 
 /** Handler invoked when a command runs, with validated form values when present. */
-export type OpenPetsCommandHandler = (values?: Record<string, unknown>) => void | Promise<void>;
+export type FamiliarOSCommandHandler = (values?: Record<string, unknown>) => void | Promise<void>;
 
-/** Register right-click pet actions. Requires `commands`. */
-export interface OpenPetsCommandsApi {
-  register(command: OpenPetsCommand, handler: OpenPetsCommandHandler): Promise<void>;
+/** Register right-click familiar actions. Requires `commands`. */
+export interface FamiliarOSCommandsApi {
+  register(command: FamiliarOSCommand, handler: FamiliarOSCommandHandler): Promise<void>;
   unregister(id: string): Promise<void>;
 }
 
@@ -611,27 +611,27 @@ export interface OpenPetsCommandsApi {
 // ---------------------------------------------------------------------------
 
 /** A daily schedule time, optionally restricted to specific weekdays. */
-export type OpenPetsDailySpec = string | { time: string; days?: number[] };
+export type FamiliarOSDailySpec = string | { time: string; days?: number[] };
 
 /** A callback fired by a schedule. */
-export type OpenPetsScheduleHandler = () => void | Promise<void>;
+export type FamiliarOSScheduleHandler = () => void | Promise<void>;
 
 /**
  * Run callbacks once, on an interval, daily, on a cron expression, or at an
  * absolute time. Wall-clock aware: schedules re-arm after sleep/wake.
  * Requires `schedule`.
  */
-export interface OpenPetsScheduleApi {
+export interface FamiliarOSScheduleApi {
   /** Fire once after `delayMs`. */
-  once(id: string, delayMs: number, handler: OpenPetsScheduleHandler): Promise<void>;
+  once(id: string, delayMs: number, handler: FamiliarOSScheduleHandler): Promise<void>;
   /** Fire repeatedly every `intervalMs` (a minimum interval is enforced). */
-  every(id: string, intervalMs: number, handler: OpenPetsScheduleHandler): Promise<void>;
+  every(id: string, intervalMs: number, handler: FamiliarOSScheduleHandler): Promise<void>;
   /** Fire daily at `HH:mm`, optionally only on the given weekdays (0–6, Sunday = 0). */
-  daily(id: string, spec: OpenPetsDailySpec, handler: OpenPetsScheduleHandler): Promise<void>;
+  daily(id: string, spec: FamiliarOSDailySpec, handler: FamiliarOSScheduleHandler): Promise<void>;
   /** Fire on a 5-field cron expression (`m h dom mon dow`). */
-  cron(id: string, expr: string, handler: OpenPetsScheduleHandler): Promise<void>;
+  cron(id: string, expr: string, handler: FamiliarOSScheduleHandler): Promise<void>;
   /** Fire once at an absolute ISO-8601 timestamp. Past timestamps fire immediately. */
-  at(id: string, isoTimestamp: string, handler: OpenPetsScheduleHandler): Promise<void>;
+  at(id: string, isoTimestamp: string, handler: FamiliarOSScheduleHandler): Promise<void>;
   list(): Promise<Array<{ id: string; nextRunMs: number }>>;
   cancel(id: string): Promise<void>;
   cancelAll(): Promise<void>;
@@ -642,7 +642,7 @@ export interface OpenPetsScheduleApi {
 // ---------------------------------------------------------------------------
 
 /** Persist per-plugin state across restarts (quota: a few MB). Requires `storage`. */
-export interface OpenPetsStorageApi {
+export interface FamiliarOSStorageApi {
   get<T = unknown>(key: string): Promise<T | undefined>;
   set(key: string, value: unknown): Promise<void>;
   delete(key: string): Promise<void>;
@@ -656,7 +656,7 @@ export interface OpenPetsStorageApi {
 // ---------------------------------------------------------------------------
 
 /** Read user configuration and react to changes. Always available. */
-export interface OpenPetsConfigApi {
+export interface FamiliarOSConfigApi {
   get<T = Record<string, unknown>>(): Promise<T>;
   /** Subscribe to config changes. Returns an unsubscribe function. */
   onChange<T = Record<string, unknown>>(handler: (config: T) => void | Promise<void>): () => void;
@@ -667,7 +667,7 @@ export interface OpenPetsConfigApi {
 // ---------------------------------------------------------------------------
 
 /** Inter-plugin pub/sub. Topics should be namespaced `pluginId/topic`. Requires `bus`. */
-export interface OpenPetsBusApi {
+export interface FamiliarOSBusApi {
   /** Publish a clone-safe payload. Rate- and size-capped by the host. */
   publish(topic: string, payload: unknown): Promise<void>;
   subscribe(topic: string, handler: (payload: unknown) => void): () => void;
@@ -677,16 +677,16 @@ export interface OpenPetsBusApi {
 // Network (§12, §13.4)
 // ---------------------------------------------------------------------------
 
-/** Options for {@link OpenPetsNetApi.fetch}. Non-GET methods require `network:write`. */
-export interface OpenPetsNetFetchOptions {
+/** Options for {@link FamiliarOSNetApi.fetch}. Non-GET methods require `network:write`. */
+export interface FamiliarOSNetFetchOptions {
   method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
   headers?: Record<string, string>;
   body?: string;
   timeoutMs?: number;
 }
 
-/** Response returned by {@link OpenPetsNetApi.fetch}. */
-export interface OpenPetsHttpResponse {
+/** Response returned by {@link FamiliarOSNetApi.fetch}. */
+export interface FamiliarOSHttpResponse {
   status: number;
   ok: boolean;
   headers: Record<string, string>;
@@ -698,26 +698,26 @@ export interface OpenPetsHttpResponse {
  * HTTPS fetch to manifest-declared, user-approved hosts. Requires `network`.
  * HTTPS-only with redirect, response-size, and private-IP/SSRF guards.
  */
-export interface OpenPetsNetApi {
-  fetch(url: string, options?: OpenPetsNetFetchOptions): Promise<OpenPetsHttpResponse>;
+export interface FamiliarOSNetApi {
+  fetch(url: string, options?: FamiliarOSNetFetchOptions): Promise<FamiliarOSHttpResponse>;
   /** Streaming fetch (SSE/chunked) for LLM-style responses. */
   stream(
     url: string,
-    options: OpenPetsNetFetchOptions,
+    options: FamiliarOSNetFetchOptions,
     onChunk: (chunk: string) => void,
   ): Promise<{ status: number; ok: boolean }>;
 }
 
 /** v2 GET-only fetch options, kept for back-compat (`ctx.http`). */
-export interface OpenPetsHttpOptions {
+export interface FamiliarOSHttpOptions {
   method?: "GET";
   headers?: Record<string, string>;
   timeoutMs?: number;
 }
 
 /** v2 HTTP namespace, kept for back-compat. Requires `network`. */
-export interface OpenPetsHttpApi {
-  fetch(url: string, options?: OpenPetsHttpOptions): Promise<OpenPetsHttpResponse>;
+export interface FamiliarOSHttpApi {
+  fetch(url: string, options?: FamiliarOSHttpOptions): Promise<FamiliarOSHttpResponse>;
 }
 
 // ---------------------------------------------------------------------------
@@ -725,7 +725,7 @@ export interface OpenPetsHttpApi {
 // ---------------------------------------------------------------------------
 
 /** A tool the model may call (host AI gateway function calling). */
-export interface OpenPetsAiTool {
+export interface FamiliarOSAiTool {
   name: string;
   description?: string;
   /** JSON Schema for the tool's input. */
@@ -733,29 +733,29 @@ export interface OpenPetsAiTool {
 }
 
 /** A tool call requested by the model. */
-export interface OpenPetsAiToolCall {
+export interface FamiliarOSAiToolCall {
   name: string;
   input: Record<string, unknown>;
 }
 
-/** Request for {@link OpenPetsAiApi.complete} / {@link OpenPetsAiApi.stream}. */
-export interface OpenPetsAiRequest {
+/** Request for {@link FamiliarOSAiApi.complete} / {@link FamiliarOSAiApi.stream}. */
+export interface FamiliarOSAiRequest {
   system?: string;
   messages: Array<{ role: "user" | "assistant"; content: string }>;
   maxTokens?: number;
   temperature?: number;
-  tools?: OpenPetsAiTool[];
+  tools?: FamiliarOSAiTool[];
 }
 
 /**
  * Host AI gateway backed by the user's one configured provider/model.
  * Keys live in host config, never in plugin code. Requires `ai`.
  */
-export interface OpenPetsAiApi {
+export interface FamiliarOSAiApi {
   /** Whether a provider is configured. */
   available(): Promise<boolean>;
-  complete(req: OpenPetsAiRequest): Promise<{ text: string; toolCalls?: OpenPetsAiToolCall[] }>;
-  stream(req: OpenPetsAiRequest, onToken: (chunk: string) => void): Promise<{ text: string }>;
+  complete(req: FamiliarOSAiRequest): Promise<{ text: string; toolCalls?: FamiliarOSAiToolCall[] }>;
+  stream(req: FamiliarOSAiRequest, onToken: (chunk: string) => void): Promise<{ text: string }>;
 }
 
 // ---------------------------------------------------------------------------
@@ -763,7 +763,7 @@ export interface OpenPetsAiApi {
 // ---------------------------------------------------------------------------
 
 /** Encrypted per-plugin credentials (OS keychain / safeStorage). Requires `secrets`. */
-export interface OpenPetsSecretsApi {
+export interface FamiliarOSSecretsApi {
   set(key: string, value: string): Promise<void>;
   /** Returned only to the owning plugin. */
   get(key: string): Promise<string | undefined>;
@@ -776,7 +776,7 @@ export interface OpenPetsSecretsApi {
 // ---------------------------------------------------------------------------
 
 /** TTS out (`voice:speak`) and opt-in, push-to-talk STT in (`voice:listen`). */
-export interface OpenPetsVoiceApi {
+export interface FamiliarOSVoiceApi {
   speak(text: string, opts?: { voice?: string; rate?: number }): Promise<void>;
   /**
    * One-shot speech-to-text. Off by default, never ambient, clearly
@@ -791,7 +791,7 @@ export interface OpenPetsVoiceApi {
 // ---------------------------------------------------------------------------
 
 /** Host-mediated OAuth configuration (PKCE by default; no client secret). */
-export interface OpenPetsOauthConfig {
+export interface FamiliarOSOauthConfig {
   provider?: "google" | "microsoft" | "github" | "generic";
   authorizationUrl: string;
   tokenUrl: string;
@@ -803,15 +803,15 @@ export interface OpenPetsOauthConfig {
 }
 
 /** Tokens returned by the host after running the OAuth dance. */
-export interface OpenPetsOauthTokens {
+export interface FamiliarOSOauthTokens {
   accessToken: string;
   refreshToken?: string;
   expiresAt?: number;
 }
 
 /** Host-mediated OAuth: the host opens the system browser and runs PKCE. Requires `auth`. */
-export interface OpenPetsAuthApi {
-  oauth(config: OpenPetsOauthConfig): Promise<OpenPetsOauthTokens>;
+export interface FamiliarOSAuthApi {
+  oauth(config: FamiliarOSOauthConfig): Promise<FamiliarOSOauthTokens>;
   refresh(provider: string): Promise<{ accessToken: string; expiresAt?: number }>;
   signOut(provider: string): Promise<void>;
 }
@@ -821,7 +821,7 @@ export interface OpenPetsAuthApi {
 // ---------------------------------------------------------------------------
 
 /** A user-picked file. Reads are size-capped; no plugin-chosen paths. */
-export interface OpenPetsPickedFile {
+export interface FamiliarOSPickedFile {
   name: string;
   sizeBytes: number;
   readText(): Promise<string>;
@@ -829,8 +829,8 @@ export interface OpenPetsPickedFile {
 }
 
 /** User-initiated file access behind OS dialogs. Requires `files`. */
-export interface OpenPetsFilesApi {
-  pick(opts?: { accept?: string[]; multiple?: boolean }): Promise<OpenPetsPickedFile[]>;
+export interface FamiliarOSFilesApi {
+  pick(opts?: { accept?: string[]; multiple?: boolean }): Promise<FamiliarOSPickedFile[]>;
   save(opts: { suggestedName: string; data: string | Uint8Array }): Promise<void>;
 }
 
@@ -839,7 +839,7 @@ export interface OpenPetsFilesApi {
 // ---------------------------------------------------------------------------
 
 /** Read-only environment info. Always non-sensitive. */
-export interface OpenPetsSystemInfo {
+export interface FamiliarOSSystemInfo {
   platform: "mac" | "win" | "linux";
   locale: string;
   timezone: string;
@@ -849,7 +849,7 @@ export interface OpenPetsSystemInfo {
 }
 
 /** Aggregate machine metrics — never per-process or per-app data. */
-export interface OpenPetsSystemMetrics {
+export interface FamiliarOSSystemMetrics {
   /** 0–100, recent average. */
   cpuPercent: number;
   /** 0–100. */
@@ -858,11 +858,11 @@ export interface OpenPetsSystemMetrics {
 }
 
 /** Read-only environment + open-external + gated clipboard. */
-export interface OpenPetsSystemApi {
+export interface FamiliarOSSystemApi {
   /** Always available. */
-  info(): Promise<OpenPetsSystemInfo>;
+  info(): Promise<FamiliarOSSystemInfo>;
   /** Requires `system:metrics`. */
-  metrics(): Promise<OpenPetsSystemMetrics>;
+  metrics(): Promise<FamiliarOSSystemMetrics>;
   /** HTTPS-only; opens the user's real browser. Requires `system:openExternal`. */
   openExternal(url: string): Promise<void>;
   /**
@@ -879,13 +879,13 @@ export interface OpenPetsSystemApi {
 // ---------------------------------------------------------------------------
 
 /** Show a short status line in the Plugins window. Requires `status`. */
-export interface OpenPetsStatusApi {
-  set(status: OpenPetsStatus): Promise<void>;
+export interface FamiliarOSStatusApi {
+  set(status: FamiliarOSStatus): Promise<void>;
   clear(): Promise<void>;
 }
 
 /** Write to the desktop app log under the `plugin` scope. Always available. */
-export interface OpenPetsLogApi {
+export interface FamiliarOSLogApi {
   debug(...args: unknown[]): Promise<void>;
   info(...args: unknown[]): Promise<void>;
   warn(...args: unknown[]): Promise<void>;
@@ -897,39 +897,39 @@ export interface OpenPetsLogApi {
 // ---------------------------------------------------------------------------
 
 /**
- * The capability object passed to {@link OpenPetsPluginDefinition.start}.
+ * The capability object passed to {@link FamiliarOSPluginDefinition.start}.
  *
  * Each namespace is only functional when the matching permission is approved
  * in the manifest. `config`, `log`, `assets`, and `system.info` are always
  * available.
  *
- * `pet` is an alias for `pets.default` (back-compat + convenience); the v2
- * surface (`ctx.pet.speak(text)`, `ctx.http.fetch`) keeps working.
+ * `familiar` is an alias for `familiars.default` (back-compat + convenience); the v2
+ * surface (`ctx.familiar.speak(text)`, `ctx.http.fetch`) keeps working.
  */
-export interface OpenPetsContext {
-  pets: OpenPetsPetsApi;
-  pet: OpenPetsPetHandle;
-  ui: OpenPetsUiApi;
-  audio: OpenPetsAudioApi;
-  events: OpenPetsEventsApi;
-  assets: OpenPetsAssetsApi;
-  bus: OpenPetsBusApi;
-  schedule: OpenPetsScheduleApi;
-  storage: OpenPetsStorageApi;
-  config: OpenPetsConfigApi;
-  net: OpenPetsNetApi;
-  notify: OpenPetsNotifyApi;
-  ai: OpenPetsAiApi;
-  secrets: OpenPetsSecretsApi;
-  voice: OpenPetsVoiceApi;
-  auth: OpenPetsAuthApi;
-  files: OpenPetsFilesApi;
-  system: OpenPetsSystemApi;
-  commands: OpenPetsCommandsApi;
-  status: OpenPetsStatusApi;
+export interface FamiliarOSContext {
+  familiars: FamiliarOSPetsApi;
+  familiar: FamiliarOSPetHandle;
+  ui: FamiliarOSUiApi;
+  audio: FamiliarOSAudioApi;
+  events: FamiliarOSEventsApi;
+  assets: FamiliarOSAssetsApi;
+  bus: FamiliarOSBusApi;
+  schedule: FamiliarOSScheduleApi;
+  storage: FamiliarOSStorageApi;
+  config: FamiliarOSConfigApi;
+  net: FamiliarOSNetApi;
+  notify: FamiliarOSNotifyApi;
+  ai: FamiliarOSAiApi;
+  secrets: FamiliarOSSecretsApi;
+  voice: FamiliarOSVoiceApi;
+  auth: FamiliarOSAuthApi;
+  files: FamiliarOSFilesApi;
+  system: FamiliarOSSystemApi;
+  commands: FamiliarOSCommandsApi;
+  status: FamiliarOSStatusApi;
   /** v2 alias of `net` (GET-only). */
-  http: OpenPetsHttpApi;
-  log: OpenPetsLogApi;
+  http: FamiliarOSHttpApi;
+  log: FamiliarOSLogApi;
   /**
    * Translate a key against the plugin's own `locales/<locale>.json` catalogs
    * for the active host locale, falling back to the plugin's `en` catalog and
@@ -957,17 +957,17 @@ export interface OpenPetsContext {
   readonly locale: string;
 }
 
-/** The object you pass to {@link OpenPetsPluginApi.register}. */
-export interface OpenPetsPluginDefinition {
+/** The object you pass to {@link FamiliarOSPluginApi.register}. */
+export interface FamiliarOSPluginDefinition {
   /** Runs when the plugin is enabled or the app launches. */
-  start(ctx: OpenPetsContext): void | Promise<void>;
+  start(ctx: FamiliarOSContext): void | Promise<void>;
   /** Optional cleanup. Schedules, commands, bubbles, and subscriptions are torn down for you. */
-  stop?(ctx?: OpenPetsContext): void | Promise<void>;
+  stop?(ctx?: FamiliarOSContext): void | Promise<void>;
 }
 
 /** The injected global used to register a plugin. */
-export interface OpenPetsPluginApi {
-  register(definition: OpenPetsPluginDefinition): void;
+export interface FamiliarOSPluginApi {
+  register(definition: FamiliarOSPluginDefinition): void;
 }
 
 /**
@@ -975,15 +975,15 @@ export interface OpenPetsPluginApi {
  * style used by the official plugins:
  *
  * ```ts
- * export function register(OpenPetsPlugin: OpenPetsPluginApi) {
- *   OpenPetsPlugin.register({ async start(ctx) {} })
+ * export function register(FamiliarOSPlugin: FamiliarOSPluginApi) {
+ *   FamiliarOSPlugin.register({ async start(ctx) {} })
  * }
  * ```
  */
-export type OpenPetsPluginEntry = (api: OpenPetsPluginApi) => void | Promise<void>;
+export type FamiliarOSPluginEntry = (api: FamiliarOSPluginApi) => void | Promise<void>;
 
 /** Field types supported by `configSchema` in the manifest. */
-export type OpenPetsConfigFieldType =
+export type FamiliarOSConfigFieldType =
   | "text"
   | "textarea"
   | "number"
@@ -997,18 +997,18 @@ export type OpenPetsConfigFieldType =
   /** Masked input, encrypted at rest, never logged or echoed (v3). */
   | "secret";
 
-/** v2 alias: the old flat pet namespace shape. */
-export type OpenPetsPetApi = Pick<
-  OpenPetsPetHandle,
+/** v2 alias: the old flat familiar namespace shape. */
+export type FamiliarOSPetApi = Pick<
+  FamiliarOSPetHandle,
   "speak" | "react" | "moveBy" | "wander" | "moveToHome"
 >;
 
 declare global {
   /**
-   * Injected by the OpenPets runtime. Call once at the top level of your
+   * Injected by the FamiliarOS runtime. Call once at the top level of your
    * entry file to register your plugin.
    */
-  const OpenPetsPlugin: OpenPetsPluginApi;
+  const FamiliarOSPlugin: FamiliarOSPluginApi;
 }
 
 export {};
diff --git a/packages/sdk/src/testing.ts b/packages/sdk/src/testing.ts
index a3288d1b..d20b728a 100644
--- a/packages/sdk/src/testing.ts
+++ b/packages/sdk/src/testing.ts
@@ -1,16 +1,16 @@
 /**
- * `@open-pets/plugin-sdk/testing` — the supported plugin test kit (§18.2).
+ * `@familiaros/plugin-sdk/testing` — the supported plugin test kit (§18.2).
  *
  * Lets a plugin's `start` handler run against a fully mocked
- * {@link OpenPetsContext} with no Electron, no network, no real timers, and
+ * {@link FamiliarOSContext} with no Electron, no network, no real timers, and
  * no real user data:
  *
  * ```ts
- * import { createTestHarness } from "@open-pets/plugin-sdk/testing"
+ * import { createTestHarness } from "@familiaros/plugin-sdk/testing"
  * import { register } from "../src/index.js"
  *
  * const h = createTestHarness(register, {
- *   permissions: ["pet:speak", "schedule", "storage"],
+ *   permissions: ["familiar:speak", "schedule", "storage"],
  *   config: { frequency: "low" },
  * })
  * await h.start()
@@ -19,27 +19,27 @@
  * ```
  */
 import type {
-  OpenPetsBubble,
-  OpenPetsBubbleDismissReason,
-  OpenPetsBubbleHandle,
-  OpenPetsAlert,
-  OpenPetsAlertHandle,
-  OpenPetsCommand,
-  OpenPetsCommandHandler,
-  OpenPetsContext,
-  OpenPetsEventName,
-  OpenPetsMenuItem,
-  OpenPetsPermission,
-  OpenPetsPetHandle,
-  OpenPetsPetInfo,
-  OpenPetsPetState,
-  OpenPetsPluginApi,
-  OpenPetsPluginDefinition,
-  OpenPetsPluginEntry,
-  OpenPetsReaction,
-  OpenPetsScheduleHandler,
-  OpenPetsStatus,
-  OpenPetsUserSoundRef,
+  FamiliarOSBubble,
+  FamiliarOSBubbleDismissReason,
+  FamiliarOSBubbleHandle,
+  FamiliarOSAlert,
+  FamiliarOSAlertHandle,
+  FamiliarOSCommand,
+  FamiliarOSCommandHandler,
+  FamiliarOSContext,
+  FamiliarOSEventName,
+  FamiliarOSMenuItem,
+  FamiliarOSPermission,
+  FamiliarOSPetHandle,
+  FamiliarOSPetInfo,
+  FamiliarOSPetState,
+  FamiliarOSPluginApi,
+  FamiliarOSPluginDefinition,
+  FamiliarOSPluginEntry,
+  FamiliarOSReaction,
+  FamiliarOSScheduleHandler,
+  FamiliarOSStatus,
+  FamiliarOSUserSoundRef,
 } from "./index.js";
 
 // ---------------------------------------------------------------------------
@@ -47,26 +47,26 @@ import type {
 // ---------------------------------------------------------------------------
 
 export interface RecordedBubble {
-  spec: OpenPetsBubble;
-  handle: OpenPetsBubbleHandle;
+  spec: FamiliarOSBubble;
+  handle: FamiliarOSBubbleHandle;
   petId: string;
-  updates: Array<Partial<OpenPetsBubble>>;
+  updates: Array<Partial<FamiliarOSBubble>>;
   pinned: boolean;
   dismissed: boolean;
 }
 
 export interface RecordedAlert {
-  spec: OpenPetsAlert;
-  handle: OpenPetsAlertHandle;
+  spec: FamiliarOSAlert;
+  handle: FamiliarOSAlertHandle;
   bubble: RecordedBubble;
-  updates: Array<Partial<OpenPetsBubble>>;
+  updates: Array<Partial<FamiliarOSBubble>>;
   dismissed: boolean;
   acknowledged: boolean;
 }
 
 export interface RecordedSchedule {
   type: "once" | "every" | "daily" | "cron" | "at";
-  handler: OpenPetsScheduleHandler;
+  handler: FamiliarOSScheduleHandler;
   dueMs: number;
   intervalMs?: number;
   daily?: { time: string; days?: number[] };
@@ -86,19 +86,19 @@ export interface MockCalls {
   react: string[];
   reactions: Array<{ reaction: string; options?: { showMessage?: boolean } }>;
   statusReactions: Array<string | null>;
-  status: OpenPetsStatus[];
+  status: FamiliarOSStatus[];
   storage: Map<string, unknown>;
   schedules: Map<string, RecordedSchedule>;
-  commands: Map<string, { meta: OpenPetsCommand; handler: OpenPetsCommandHandler }>;
-  menuItems: OpenPetsMenuItem[];
+  commands: Map<string, { meta: FamiliarOSCommand; handler: FamiliarOSCommandHandler }>;
+  menuItems: FamiliarOSMenuItem[];
   bubbles: RecordedBubble[];
   alerts: RecordedAlert[];
   dismissedBubbles: string[];
   toasts: Array<{ text: string; tone?: string }>;
   notifications: Array<{ title: string; body?: string }>;
   sounds: Array<{ sound: unknown; volume?: number }>;
-  importedUserSounds: Array<{ ref: OpenPetsUserSoundRef; fileName: string; name?: string }>;
-  forgottenUserSounds: OpenPetsUserSoundRef[];
+  importedUserSounds: Array<{ ref: FamiliarOSUserSoundRef; fileName: string; name?: string }>;
+  forgottenUserSounds: FamiliarOSUserSoundRef[];
   busPublishes: Array<{ topic: string; payload: unknown }>;
   netCalls: RecordedNetCall[];
   aiCalls: Array<{ system?: string; messages: Array<{ role: string; content: string }> }>;
@@ -115,12 +115,12 @@ export interface MockCalls {
 const allowedReactions = new Set<string>(["idle", "thinking", "working", "editing", "running", "testing", "waiting", "waving", "success", "error", "celebrating"]);
 
 function assertReaction(value: unknown): void {
-  if (typeof value !== "string" || !allowedReactions.has(value)) throw new Error("Invalid pet reaction.");
+  if (typeof value !== "string" || !allowedReactions.has(value)) throw new Error("Invalid familiar reaction.");
 }
 
 export interface MockContextOptions {
   /** Approved permissions. Omit to approve everything (legacy default). */
-  permissions?: readonly OpenPetsPermission[];
+  permissions?: readonly FamiliarOSPermission[];
   /** Effective plugin config returned by `ctx.config.get()`. */
   config?: Record<string, unknown>;
   /**
@@ -271,10 +271,10 @@ declare class TextEncoder { encode(input?: string): Uint8Array }
 
 export interface MockHarnessCore {
   clock: FakeClock;
-  emit(event: OpenPetsEventName, payload: unknown): Promise<void>;
+  emit(event: FamiliarOSEventName, payload: unknown): Promise<void>;
   fireBubbleAction(bubbleId: string, actionId: string): Promise<void>;
   fireBubbleSubmit(bubbleId: string, values: Record<string, string | number>): Promise<void>;
-  dismissBubble(bubbleId: string, reason?: OpenPetsBubbleDismissReason): Promise<void>;
+  dismissBubble(bubbleId: string, reason?: FamiliarOSBubbleDismissReason): Promise<void>;
   runCommand(commandId: string, values?: Record<string, unknown>): Promise<void>;
   setConfig(config: Record<string, unknown>): Promise<void>;
   net: { mock(urlPrefix: string, response: { status?: number; json?: unknown; text?: string; chunks?: string[] }): void };
@@ -287,7 +287,7 @@ export interface MockHarnessCore {
 }
 
 export function createMockContext(optionsOrConfig: MockContextOptions | Record<string, unknown> = {}): {
-  ctx: OpenPetsContext;
+  ctx: FamiliarOSContext;
   calls: MockCalls;
   harness: MockHarnessCore;
 } {
@@ -335,18 +335,18 @@ export function createMockContext(optionsOrConfig: MockContextOptions | Record<s
   const translate = (key: string, vars?: Record<string, string | number>): string =>
     interpolateVars(lookupCatalog(key) ?? key, vars);
 
-  const requirePermission = (permission: OpenPetsPermission): void => {
+  const requirePermission = (permission: FamiliarOSPermission): void => {
     if (approved !== null && !approved.has(permission)) throw new Error(`Plugin permission is not approved: ${permission}`);
   };
 
-  const makeBubble = (petId: string, spec: string | OpenPetsBubble): OpenPetsBubbleHandle => {
-    requirePermission("pet:speak");
-    const normalized: OpenPetsBubble = typeof spec === "string" ? { text: spec } : { ...spec };
-    if (normalized.actions || normalized.input) requirePermission("pet:interact");
-    if (normalized.pin) requirePermission("pet:pin");
-    if (normalized.dynamic) requirePermission("pet:speak:dynamic");
+  const makeBubble = (petId: string, spec: string | FamiliarOSBubble): FamiliarOSBubbleHandle => {
+    requirePermission("familiar:speak");
+    const normalized: FamiliarOSBubble = typeof spec === "string" ? { text: spec } : { ...spec };
+    if (normalized.actions || normalized.input) requirePermission("familiar:interact");
+    if (normalized.pin) requirePermission("familiar:pin");
+    if (normalized.dynamic) requirePermission("familiar:speak:dynamic");
     const id = newId("bubble");
-    const callbacks: { onAction?: (actionId: string) => void | Promise<void>; onSubmit?: (values: Record<string, string | number>) => void | Promise<void>; onDismiss?: (reason: OpenPetsBubbleDismissReason) => void } = {};
+    const callbacks: { onAction?: (actionId: string) => void | Promise<void>; onSubmit?: (values: Record<string, string | number>) => void | Promise<void>; onDismiss?: (reason: FamiliarOSBubbleDismissReason) => void } = {};
     const record: RecordedBubble = {
       spec: normalized,
       petId,
@@ -357,7 +357,7 @@ export function createMockContext(optionsOrConfig: MockContextOptions | Record<s
         id,
         update: async (patch) => { record.updates.push(patch); Object.assign(record.spec, patch); },
         dismiss: async () => { if (!record.dismissed) { record.dismissed = true; calls.dismissedBubbles.push(id); callbacks.onDismiss?.("manual"); } },
-        pin: async () => { requirePermission("pet:pin"); record.pinned = true; },
+        pin: async () => { requirePermission("familiar:pin"); record.pinned = true; },
         unpin: async () => { record.pinned = false; },
         onAction: (handler) => { callbacks.onAction = handler; },
         onSubmit: (handler) => { callbacks.onSubmit = handler; },
@@ -369,9 +369,9 @@ export function createMockContext(optionsOrConfig: MockContextOptions | Record<s
     if (normalized.text) calls.speak.push(normalized.text);
     return record.handle;
   };
-  const bubbleCallbacks = new Map<string, { record: RecordedBubble; callbacks: { onAction?: (actionId: string) => void | Promise<void>; onSubmit?: (values: Record<string, string | number>) => void | Promise<void>; onDismiss?: (reason: OpenPetsBubbleDismissReason) => void } }>();
+  const bubbleCallbacks = new Map<string, { record: RecordedBubble; callbacks: { onAction?: (actionId: string) => void | Promise<void>; onSubmit?: (values: Record<string, string | number>) => void | Promise<void>; onDismiss?: (reason: FamiliarOSBubbleDismissReason) => void } }>();
 
-  const makeAlert = (spec: OpenPetsAlert): OpenPetsAlertHandle => {
+  const makeAlert = (spec: FamiliarOSAlert): FamiliarOSAlertHandle => {
     if (spec.sound !== undefined) requirePermission("audio");
     if (spec.notify !== undefined) requirePermission("notify");
     const { sound, notify, indicator, ...bubbleSpec } = spec;
@@ -407,39 +407,39 @@ export function createMockContext(optionsOrConfig: MockContextOptions | Record<s
     return record.handle;
   };
 
-  const petInfos: OpenPetsPetInfo[] = [{ id: "default", name: "Default pet", kind: "default", visible: true }];
-  const petState: OpenPetsPetState = { position: { x: 100, y: 100 }, bounds: { x: 100, y: 100, width: 220, height: 240 }, currentAnimation: "idle", visible: true, dragging: false };
+  const petInfos: FamiliarOSPetInfo[] = [{ id: "default", name: "Default familiar", kind: "default", visible: true }];
+  const petState: FamiliarOSPetState = { position: { x: 100, y: 100 }, bounds: { x: 100, y: 100, width: 220, height: 240 }, currentAnimation: "idle", visible: true, dragging: false };
   const tickHandlers = new Set<(dtMs: number) => void>();
 
-  const makePetHandle = (petId: string): OpenPetsPetHandle => ({
+  const makePetHandle = (petId: string): FamiliarOSPetHandle => ({
     id: petId,
     speak: async (spec) => makeBubble(petId, spec),
-    react: async (reaction: OpenPetsReaction, options) => { requirePermission("pet:reaction"); assertReaction(reaction); const record = { reaction: String(reaction), ...(options === undefined ? {} : { options: { ...options } }) }; calls.react.push(record.reaction); calls.reactions.push(record); },
-    setAnimation: async (state) => { if (typeof state === "string") { requirePermission("pet:reaction"); calls.react.push(String(state)); } else { requirePermission("pet:animate"); petState.currentAnimation = `sprite:${state.sprite.name}`; } },
-    setScale: async () => { requirePermission("pet:animate"); },
-    setStatusReaction: async (reaction) => { requirePermission("pet:reaction"); if (reaction !== null) assertReaction(reaction); calls.statusReactions.push(reaction === null ? null : String(reaction)); },
-    moveBy: async () => { requirePermission("pet:move"); },
-    wander: async () => { requirePermission("pet:move"); },
-    moveToHome: async () => { requirePermission("pet:move"); },
-    moveTo: async (point) => { requirePermission("pet:move"); petState.position = { ...point }; },
-    followCursor: async () => { requirePermission("pet:move"); },
-    physics: async () => { requirePermission("pet:move"); },
+    react: async (reaction: FamiliarOSReaction, options) => { requirePermission("familiar:reaction"); assertReaction(reaction); const record = { reaction: String(reaction), ...(options === undefined ? {} : { options: { ...options } }) }; calls.react.push(record.reaction); calls.reactions.push(record); },
+    setAnimation: async (state) => { if (typeof state === "string") { requirePermission("familiar:reaction"); calls.react.push(String(state)); } else { requirePermission("familiar:animate"); petState.currentAnimation = `sprite:${state.sprite.name}`; } },
+    setScale: async () => { requirePermission("familiar:animate"); },
+    setStatusReaction: async (reaction) => { requirePermission("familiar:reaction"); if (reaction !== null) assertReaction(reaction); calls.statusReactions.push(reaction === null ? null : String(reaction)); },
+    moveBy: async () => { requirePermission("familiar:move"); },
+    wander: async () => { requirePermission("familiar:move"); },
+    moveToHome: async () => { requirePermission("familiar:move"); },
+    moveTo: async (point) => { requirePermission("familiar:move"); petState.position = { ...point }; },
+    followCursor: async () => { requirePermission("familiar:move"); },
+    physics: async () => { requirePermission("familiar:move"); },
     onTick: (handler) => { requirePermission("events"); tickHandlers.add(handler); return () => tickHandlers.delete(handler); },
-    getState: async () => { requirePermission("pets:read"); return { ...petState, position: { ...petState.position }, bounds: { ...petState.bounds } }; },
-    show: async () => { requirePermission("pets:manage"); },
-    hide: async () => { requirePermission("pets:manage"); },
-    close: async () => { requirePermission("pets:manage"); },
+    getState: async () => { requirePermission("familiars:read"); return { ...petState, position: { ...petState.position }, bounds: { ...petState.bounds } }; },
+    show: async () => { requirePermission("familiars:manage"); },
+    hide: async () => { requirePermission("familiars:manage"); },
+    close: async () => { requirePermission("familiars:manage"); },
   });
 
   const matchNetMock = (url: string) => netMocks.find((mock) => url.startsWith(mock.urlPrefix));
 
-  const ctx: OpenPetsContext = {
-    pet: makePetHandle("default"),
-    pets: {
+  const ctx: FamiliarOSContext = {
+    familiar: makePetHandle("default"),
+    familiars: {
       default: makePetHandle("default"),
-      list: async () => { requirePermission("pets:read"); return petInfos.map((info) => ({ ...info })); },
+      list: async () => { requirePermission("familiars:read"); return petInfos.map((info) => ({ ...info })); },
       get: (petId) => makePetHandle(petId),
-      spawn: async (spec) => { requirePermission("pets:manage"); const id = newId("pet"); calls.spawnedPets.push(spec.petId); petInfos.push({ id, name: spec.name ?? spec.petId, kind: "plugin", visible: true }); return makePetHandle(id); },
+      spawn: async (spec) => { requirePermission("familiars:manage"); const id = newId("familiar"); calls.spawnedPets.push(spec.petId); petInfos.push({ id, name: spec.name ?? spec.petId, kind: "plugin", visible: true }); return makePetHandle(id); },
       onChange: () => () => undefined,
     },
     ui: {
@@ -468,7 +468,7 @@ export function createMockContext(optionsOrConfig: MockContextOptions | Record<s
       importUserSound: async (file, opts) => {
         requirePermission("audio");
         requirePermission("files");
-        const ref: OpenPetsUserSoundRef = { kind: "user-sound", id: newId("sound"), name: opts?.name ?? file.name };
+        const ref: FamiliarOSUserSoundRef = { kind: "user-sound", id: newId("sound"), name: opts?.name ?? file.name };
         calls.importedUserSounds.push({ ref, fileName: file.name, name: opts?.name });
         return ref;
       },
@@ -478,7 +478,7 @@ export function createMockContext(optionsOrConfig: MockContextOptions | Record<s
     events: {
       on: (event, handler) => {
         requirePermission("events");
-        if (event === "pet:drop") requirePermission("pet:drop");
+        if (event === "familiar:drop") requirePermission("familiar:drop");
         let subscribers = eventSubscribers.get(event);
         if (!subscribers) { subscribers = new Set(); eventSubscribers.set(event, subscribers); }
         const wrapped: EventHandler = (payload) => (handler as (payload: unknown) => void)(payload);
@@ -665,7 +665,7 @@ function isMockOptions(value: MockContextOptions | Record<string, unknown>): val
 // ---------------------------------------------------------------------------
 
 export interface TestHarness extends MockHarnessCore {
-  ctx: OpenPetsContext;
+  ctx: FamiliarOSContext;
   calls: MockCalls;
   start(): Promise<void>;
   stop(): Promise<void>;
@@ -674,7 +674,7 @@ export interface TestHarness extends MockHarnessCore {
   expectSpoke(matcher: string | RegExp): void;
   expectReacted(reaction: string): void;
   expectScheduled(id: string): void;
-  expectBubble(matcher: Partial<OpenPetsBubble> & { textMatch?: RegExp }): void;
+  expectBubble(matcher: Partial<FamiliarOSBubble> & { textMatch?: RegExp }): void;
   expectStored(key: string, predicate?: (value: unknown) => boolean): void;
   expectNetCall(urlSubstring: string): void;
   expectNotified(matcher: string | RegExp): void;
@@ -683,15 +683,15 @@ export interface TestHarness extends MockHarnessCore {
 
 /**
  * Build a batteries-included harness around a plugin definition or an exported
- * `register(OpenPetsPlugin)` entry function.
+ * `register(FamiliarOSPlugin)` entry function.
  */
 export function createTestHarness(
-  plugin: OpenPetsPluginDefinition | OpenPetsPluginEntry,
+  plugin: FamiliarOSPluginDefinition | FamiliarOSPluginEntry,
   options: MockContextOptions = {},
 ): TestHarness {
   const { ctx, calls, harness } = createMockContext(options);
-  let definition: OpenPetsPluginDefinition | null = typeof plugin === "function" ? null : plugin;
-  const entry: OpenPetsPluginEntry | null = typeof plugin === "function" ? plugin : null;
+  let definition: FamiliarOSPluginDefinition | null = typeof plugin === "function" ? null : plugin;
+  const entry: FamiliarOSPluginEntry | null = typeof plugin === "function" ? plugin : null;
 
   const fail = (message: string): never => { throw new Error(message); };
 
@@ -701,9 +701,9 @@ export function createTestHarness(
     calls,
     async start() {
       if (entry) {
-        const api: OpenPetsPluginApi = { register: (registered) => { definition = registered; } };
+        const api: FamiliarOSPluginApi = { register: (registered) => { definition = registered; } };
         await entry(api);
-        if (!definition) fail("Plugin entry never called OpenPetsPlugin.register().");
+        if (!definition) fail("Plugin entry never called FamiliarOSPlugin.register().");
       }
       await definition!.start(ctx);
     },
@@ -711,12 +711,12 @@ export function createTestHarness(
       await definition?.stop?.(ctx);
     },
     async tick(dtMs: number) {
-      // The mock pet handle records tick handlers internally; route through emit-like dispatch.
-      await harness.emit("pet:hover" as OpenPetsEventName, { petId: "default", __tickDtMs: dtMs });
+      // The mock familiar handle records tick handlers internally; route through emit-like dispatch.
+      await harness.emit("familiar:hover" as FamiliarOSEventName, { petId: "default", __tickDtMs: dtMs });
     },
     expectSpoke(matcher) {
       const found = calls.speak.some((message) => (typeof matcher === "string" ? message.includes(matcher) : matcher.test(message)));
-      if (!found) fail(`Expected pet speech matching ${String(matcher)}; got ${JSON.stringify(calls.speak)}`);
+      if (!found) fail(`Expected familiar speech matching ${String(matcher)}; got ${JSON.stringify(calls.speak)}`);
     },
     expectReacted(reaction) {
       if (!calls.react.includes(reaction)) fail(`Expected reaction "${reaction}"; got ${JSON.stringify(calls.react)}`);
diff --git a/plugins/official/openpets.day-routine/assets/routine.svg b/plugins/official/familiaros.day-routine/assets/routine.svg
similarity index 100%
rename from plugins/official/openpets.day-routine/assets/routine.svg
rename to plugins/official/familiaros.day-routine/assets/routine.svg
diff --git a/plugins/official/openpets.day-routine/openpets.plugin.json b/plugins/official/familiaros.day-routine/familiaros.plugin.json
similarity index 97%
rename from plugins/official/openpets.day-routine/openpets.plugin.json
rename to plugins/official/familiaros.day-routine/familiaros.plugin.json
index 10bea5dc..b5008fc2 100644
--- a/plugins/official/openpets.day-routine/openpets.plugin.json
+++ b/plugins/official/familiaros.day-routine/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.day-routine",
+  "id": "familiaros.day-routine",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.day-routine/index.js b/plugins/official/familiaros.day-routine/index.js
similarity index 95%
rename from plugins/official/openpets.day-routine/index.js
rename to plugins/official/familiaros.day-routine/index.js
index 7b871787..1e3bff12 100644
--- a/plugins/official/openpets.day-routine/index.js
+++ b/plugins/official/familiaros.day-routine/index.js
@@ -1,4 +1,4 @@
-// Morning & Evening Routine (openpets.day-routine) — gentle SDK v3 daily companion check-ins.
+// Morning & Evening Routine (familiaros.day-routine) — gentle SDK v3 daily companion check-ins.
 
 export const MORNING_SCHEDULE_ID = "day-routine-morning";
 export const EVENING_SCHEDULE_ID = "day-routine-evening";
@@ -103,8 +103,8 @@ export async function pauseToday(ctx) {
   await ctx.pet.speak(routineSpeechSpec(ctx, ctx.t("speech.paused")));
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await scheduleRoutines(ctx);
       const routineIcon = ctx.assets.icon("routine");
diff --git a/plugins/official/openpets.day-routine/locales/en.json b/plugins/official/familiaros.day-routine/locales/en.json
similarity index 100%
rename from plugins/official/openpets.day-routine/locales/en.json
rename to plugins/official/familiaros.day-routine/locales/en.json
diff --git a/plugins/official/openpets.day-routine/locales/es-419.json b/plugins/official/familiaros.day-routine/locales/es-419.json
similarity index 100%
rename from plugins/official/openpets.day-routine/locales/es-419.json
rename to plugins/official/familiaros.day-routine/locales/es-419.json
diff --git a/plugins/official/openpets.day-routine/locales/ja.json b/plugins/official/familiaros.day-routine/locales/ja.json
similarity index 100%
rename from plugins/official/openpets.day-routine/locales/ja.json
rename to plugins/official/familiaros.day-routine/locales/ja.json
diff --git a/plugins/official/openpets.day-routine/locales/ko.json b/plugins/official/familiaros.day-routine/locales/ko.json
similarity index 100%
rename from plugins/official/openpets.day-routine/locales/ko.json
rename to plugins/official/familiaros.day-routine/locales/ko.json
diff --git a/plugins/official/openpets.day-routine/locales/pt-BR.json b/plugins/official/familiaros.day-routine/locales/pt-BR.json
similarity index 100%
rename from plugins/official/openpets.day-routine/locales/pt-BR.json
rename to plugins/official/familiaros.day-routine/locales/pt-BR.json
diff --git a/plugins/official/openpets.day-routine/locales/zh-Hans.json b/plugins/official/familiaros.day-routine/locales/zh-Hans.json
similarity index 100%
rename from plugins/official/openpets.day-routine/locales/zh-Hans.json
rename to plugins/official/familiaros.day-routine/locales/zh-Hans.json
diff --git a/plugins/official/openpets.day-routine/locales/zh-Hant.json b/plugins/official/familiaros.day-routine/locales/zh-Hant.json
similarity index 100%
rename from plugins/official/openpets.day-routine/locales/zh-Hant.json
rename to plugins/official/familiaros.day-routine/locales/zh-Hant.json
diff --git a/plugins/official/openpets.day-routine/test.js b/plugins/official/familiaros.day-routine/test.js
similarity index 97%
rename from plugins/official/openpets.day-routine/test.js
rename to plugins/official/familiaros.day-routine/test.js
index a28a7452..7a473a1b 100644
--- a/plugins/official/openpets.day-routine/test.js
+++ b/plugins/official/familiaros.day-routine/test.js
@@ -1,4 +1,4 @@
-// Golden test for openpets.day-routine.
+// Golden test for familiaros.day-routine.
 import assert from "node:assert/strict";
 import { readFile } from "node:fs/promises";
 import {
@@ -16,7 +16,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(new URL("../../../packages/sdk/dist/testing.js", import.meta.url)));
 }
@@ -156,4 +156,4 @@ function assertNoMixedBodyMedia(h) {
   h.expectNoErrors();
 }
 
-console.log("openpets.day-routine: all checks passed.");
+console.log("familiaros.day-routine: all checks passed.");
diff --git a/plugins/official/openpets.focus-buddy/assets/focus.svg b/plugins/official/familiaros.focus-buddy/assets/focus.svg
similarity index 100%
rename from plugins/official/openpets.focus-buddy/assets/focus.svg
rename to plugins/official/familiaros.focus-buddy/assets/focus.svg
diff --git a/plugins/official/openpets.focus-buddy/openpets.plugin.json b/plugins/official/familiaros.focus-buddy/familiaros.plugin.json
similarity index 97%
rename from plugins/official/openpets.focus-buddy/openpets.plugin.json
rename to plugins/official/familiaros.focus-buddy/familiaros.plugin.json
index 65de8aee..2d753de9 100644
--- a/plugins/official/openpets.focus-buddy/openpets.plugin.json
+++ b/plugins/official/familiaros.focus-buddy/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.focus-buddy",
+  "id": "familiaros.focus-buddy",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.focus-buddy/index.js b/plugins/official/familiaros.focus-buddy/index.js
similarity index 98%
rename from plugins/official/openpets.focus-buddy/index.js
rename to plugins/official/familiaros.focus-buddy/index.js
index 0c3ca760..8c9dbcd5 100644
--- a/plugins/official/openpets.focus-buddy/index.js
+++ b/plugins/official/familiaros.focus-buddy/index.js
@@ -1,4 +1,4 @@
-// Focus Buddy (openpets.focus-buddy) — SDK v3 Pomodoro-style timer.
+// Focus Buddy (familiaros.focus-buddy) — SDK v3 Pomodoro-style timer.
 
 export const SCHEDULE_ID = "focus-buddy-session-end";
 export const STORAGE_KEY = "session";
@@ -222,8 +222,8 @@ async function handleAction(ctx, id) {
   if (id === "skip-break") return skipToBreak(ctx);
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await reconcile(ctx);
       const focusIcon = ctx.assets.icon("focus");
diff --git a/plugins/official/openpets.focus-buddy/locales/en.json b/plugins/official/familiaros.focus-buddy/locales/en.json
similarity index 100%
rename from plugins/official/openpets.focus-buddy/locales/en.json
rename to plugins/official/familiaros.focus-buddy/locales/en.json
diff --git a/plugins/official/openpets.focus-buddy/locales/es-419.json b/plugins/official/familiaros.focus-buddy/locales/es-419.json
similarity index 100%
rename from plugins/official/openpets.focus-buddy/locales/es-419.json
rename to plugins/official/familiaros.focus-buddy/locales/es-419.json
diff --git a/plugins/official/openpets.focus-buddy/locales/ja.json b/plugins/official/familiaros.focus-buddy/locales/ja.json
similarity index 100%
rename from plugins/official/openpets.focus-buddy/locales/ja.json
rename to plugins/official/familiaros.focus-buddy/locales/ja.json
diff --git a/plugins/official/openpets.focus-buddy/locales/ko.json b/plugins/official/familiaros.focus-buddy/locales/ko.json
similarity index 100%
rename from plugins/official/openpets.focus-buddy/locales/ko.json
rename to plugins/official/familiaros.focus-buddy/locales/ko.json
diff --git a/plugins/official/openpets.focus-buddy/locales/pt-BR.json b/plugins/official/familiaros.focus-buddy/locales/pt-BR.json
similarity index 100%
rename from plugins/official/openpets.focus-buddy/locales/pt-BR.json
rename to plugins/official/familiaros.focus-buddy/locales/pt-BR.json
diff --git a/plugins/official/openpets.focus-buddy/locales/zh-Hans.json b/plugins/official/familiaros.focus-buddy/locales/zh-Hans.json
similarity index 100%
rename from plugins/official/openpets.focus-buddy/locales/zh-Hans.json
rename to plugins/official/familiaros.focus-buddy/locales/zh-Hans.json
diff --git a/plugins/official/openpets.focus-buddy/locales/zh-Hant.json b/plugins/official/familiaros.focus-buddy/locales/zh-Hant.json
similarity index 100%
rename from plugins/official/openpets.focus-buddy/locales/zh-Hant.json
rename to plugins/official/familiaros.focus-buddy/locales/zh-Hant.json
diff --git a/plugins/official/openpets.focus-buddy/test.js b/plugins/official/familiaros.focus-buddy/test.js
similarity index 97%
rename from plugins/official/openpets.focus-buddy/test.js
rename to plugins/official/familiaros.focus-buddy/test.js
index e753ec81..5ba82125 100644
--- a/plugins/official/openpets.focus-buddy/test.js
+++ b/plugins/official/familiaros.focus-buddy/test.js
@@ -1,4 +1,4 @@
-// Golden test for openpets.focus-buddy.
+// Golden test for familiaros.focus-buddy.
 import assert from "node:assert/strict";
 import { readFile } from "node:fs/promises";
 import {
@@ -12,7 +12,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(new URL("../../../packages/sdk/dist/testing.js", import.meta.url)));
 }
@@ -116,4 +116,4 @@ const LOCALES = { en: JSON.parse(await readFile(new URL("./locales/en.json", imp
   overdueBreak.expectSpoke(/Welcome back/);
 }
 
-console.log("openpets.focus-buddy: all checks passed.");
+console.log("familiaros.focus-buddy: all checks passed.");
diff --git a/plugins/official/openpets.fortune-cookie/assets/fortune-cookie.svg b/plugins/official/familiaros.fortune-cookie/assets/fortune-cookie.svg
similarity index 100%
rename from plugins/official/openpets.fortune-cookie/assets/fortune-cookie.svg
rename to plugins/official/familiaros.fortune-cookie/assets/fortune-cookie.svg
diff --git a/plugins/official/openpets.fortune-cookie/openpets.plugin.json b/plugins/official/familiaros.fortune-cookie/familiaros.plugin.json
similarity index 93%
rename from plugins/official/openpets.fortune-cookie/openpets.plugin.json
rename to plugins/official/familiaros.fortune-cookie/familiaros.plugin.json
index 60a2b56e..d3f0bcac 100644
--- a/plugins/official/openpets.fortune-cookie/openpets.plugin.json
+++ b/plugins/official/familiaros.fortune-cookie/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.fortune-cookie",
+  "id": "familiaros.fortune-cookie",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.fortune-cookie/index.js b/plugins/official/familiaros.fortune-cookie/index.js
similarity index 96%
rename from plugins/official/openpets.fortune-cookie/index.js
rename to plugins/official/familiaros.fortune-cookie/index.js
index 42efa588..477be5c4 100644
--- a/plugins/official/openpets.fortune-cookie/index.js
+++ b/plugins/official/familiaros.fortune-cookie/index.js
@@ -1,4 +1,4 @@
-// Daily Fortune Cookie (openpets.fortune-cookie) — cozy SDK v3 daily notes.
+// Daily Fortune Cookie (familiaros.fortune-cookie) — cozy SDK v3 daily notes.
 
 export const SCHEDULE_ID = "fortune-cookie-daily";
 export const STATE_KEY = "state";
@@ -102,8 +102,8 @@ export async function reconcile(ctx) {
   await ctx.schedule.daily(SCHEDULE_ID, normalizeDailyTime(cfg.dailyTime), () => fireDailyFortune(ctx));
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await reconcile(ctx);
       const fortuneIcon = ctx.assets.icon("fortune");
diff --git a/plugins/official/openpets.fortune-cookie/locales/en.json b/plugins/official/familiaros.fortune-cookie/locales/en.json
similarity index 100%
rename from plugins/official/openpets.fortune-cookie/locales/en.json
rename to plugins/official/familiaros.fortune-cookie/locales/en.json
diff --git a/plugins/official/openpets.fortune-cookie/locales/es-419.json b/plugins/official/familiaros.fortune-cookie/locales/es-419.json
similarity index 100%
rename from plugins/official/openpets.fortune-cookie/locales/es-419.json
rename to plugins/official/familiaros.fortune-cookie/locales/es-419.json
diff --git a/plugins/official/openpets.fortune-cookie/locales/ja.json b/plugins/official/familiaros.fortune-cookie/locales/ja.json
similarity index 100%
rename from plugins/official/openpets.fortune-cookie/locales/ja.json
rename to plugins/official/familiaros.fortune-cookie/locales/ja.json
diff --git a/plugins/official/openpets.fortune-cookie/locales/ko.json b/plugins/official/familiaros.fortune-cookie/locales/ko.json
similarity index 100%
rename from plugins/official/openpets.fortune-cookie/locales/ko.json
rename to plugins/official/familiaros.fortune-cookie/locales/ko.json
diff --git a/plugins/official/openpets.fortune-cookie/locales/pt-BR.json b/plugins/official/familiaros.fortune-cookie/locales/pt-BR.json
similarity index 100%
rename from plugins/official/openpets.fortune-cookie/locales/pt-BR.json
rename to plugins/official/familiaros.fortune-cookie/locales/pt-BR.json
diff --git a/plugins/official/openpets.fortune-cookie/locales/zh-Hans.json b/plugins/official/familiaros.fortune-cookie/locales/zh-Hans.json
similarity index 100%
rename from plugins/official/openpets.fortune-cookie/locales/zh-Hans.json
rename to plugins/official/familiaros.fortune-cookie/locales/zh-Hans.json
diff --git a/plugins/official/openpets.fortune-cookie/locales/zh-Hant.json b/plugins/official/familiaros.fortune-cookie/locales/zh-Hant.json
similarity index 100%
rename from plugins/official/openpets.fortune-cookie/locales/zh-Hant.json
rename to plugins/official/familiaros.fortune-cookie/locales/zh-Hant.json
diff --git a/plugins/official/openpets.fortune-cookie/test.js b/plugins/official/familiaros.fortune-cookie/test.js
similarity index 96%
rename from plugins/official/openpets.fortune-cookie/test.js
rename to plugins/official/familiaros.fortune-cookie/test.js
index 622a7d30..fa8911ac 100644
--- a/plugins/official/openpets.fortune-cookie/test.js
+++ b/plugins/official/familiaros.fortune-cookie/test.js
@@ -1,4 +1,4 @@
-// Golden test for openpets.fortune-cookie.
+// Golden test for familiaros.fortune-cookie.
 import assert from "node:assert/strict";
 import {
   DEFAULT_DAILY_TIME,
@@ -14,7 +14,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(
     new URL("../../../packages/sdk/dist/testing.js", import.meta.url)
@@ -146,4 +146,4 @@ async function withFakeNow(nowMs, run) {
   });
 }
 
-console.log("openpets.fortune-cookie: all checks passed.");
+console.log("familiaros.fortune-cookie: all checks passed.");
diff --git a/plugins/official/openpets.launch-buddy/assets/launch-buddy.svg b/plugins/official/familiaros.launch-buddy/assets/launch-buddy.svg
similarity index 100%
rename from plugins/official/openpets.launch-buddy/assets/launch-buddy.svg
rename to plugins/official/familiaros.launch-buddy/assets/launch-buddy.svg
diff --git a/plugins/official/openpets.launch-buddy/openpets.plugin.json b/plugins/official/familiaros.launch-buddy/familiaros.plugin.json
similarity index 98%
rename from plugins/official/openpets.launch-buddy/openpets.plugin.json
rename to plugins/official/familiaros.launch-buddy/familiaros.plugin.json
index 5da6874c..0623f49a 100644
--- a/plugins/official/openpets.launch-buddy/openpets.plugin.json
+++ b/plugins/official/familiaros.launch-buddy/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.launch-buddy",
+  "id": "familiaros.launch-buddy",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.launch-buddy/index.js b/plugins/official/familiaros.launch-buddy/index.js
similarity index 97%
rename from plugins/official/openpets.launch-buddy/index.js
rename to plugins/official/familiaros.launch-buddy/index.js
index 8b8f7475..8272f7ed 100644
--- a/plugins/official/openpets.launch-buddy/index.js
+++ b/plugins/official/familiaros.launch-buddy/index.js
@@ -1,4 +1,4 @@
-// Launch Buddy (openpets.launch-buddy) — gentle startup greetings for SDK v3.
+// Launch Buddy (familiaros.launch-buddy) — gentle startup greetings for SDK v3.
 
 export const MAX_MESSAGE_LENGTH = 180;
 export const MAX_DELAY_SECONDS = 60;
@@ -131,8 +131,8 @@ export async function greet(ctx, { force = false, now = Date.now() } = {}) {
   return true;
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await ctx.commands.register({ id: "greet-now", title: "$t:command.greetNow.title", description: "$t:command.greetNow.description", icon: "sparkles" }, () => greet(ctx, { force: true }));
       await ctx.commands.register({ id: "reset-launch-buddy", title: "$t:command.reset.title", description: "$t:command.reset.description", icon: "check" }, async () => {
diff --git a/plugins/official/openpets.launch-buddy/locales/en.json b/plugins/official/familiaros.launch-buddy/locales/en.json
similarity index 97%
rename from plugins/official/openpets.launch-buddy/locales/en.json
rename to plugins/official/familiaros.launch-buddy/locales/en.json
index 3180ac70..f907488f 100644
--- a/plugins/official/openpets.launch-buddy/locales/en.json
+++ b/plugins/official/familiaros.launch-buddy/locales/en.json
@@ -2,7 +2,7 @@
   "plugin.name": "Launch Buddy",
   "plugin.description": "A friendly startup greeting with gentle timing, reactions, and optional sound.",
   "config.enabled.label": "Enable greetings",
-  "config.enabled.description": "Let Launch Buddy greet you when OpenPets starts.",
+  "config.enabled.description": "Let Launch Buddy greet you when FamiliarOS starts.",
   "config.greetingMode.label": "Greeting style",
   "config.greetingMode.description": "Choose how Launch Buddy picks a message.",
   "config.greetingMode.smart": "Smart time-aware",
@@ -51,6 +51,6 @@
   "message.smart.night": "You’re up late—I'll keep things cozy and quiet.",
   "message.random.0": "Welcome back! Your buddy is ready.",
   "message.random.1": "Nice to see you again. Let’s make this session a good one.",
-  "message.random.2": "OpenPets is awake, and so am I!",
+  "message.random.2": "FamiliarOS is awake, and so am I!",
   "message.random.3": "Hi there—I'll be nearby if you need a boost."
 }
diff --git a/plugins/official/openpets.launch-buddy/locales/es-419.json b/plugins/official/familiaros.launch-buddy/locales/es-419.json
similarity index 97%
rename from plugins/official/openpets.launch-buddy/locales/es-419.json
rename to plugins/official/familiaros.launch-buddy/locales/es-419.json
index f09987f3..b3af734e 100644
--- a/plugins/official/openpets.launch-buddy/locales/es-419.json
+++ b/plugins/official/familiaros.launch-buddy/locales/es-419.json
@@ -2,7 +2,7 @@
   "plugin.name": "Launch Buddy",
   "plugin.description": "Un saludo amistoso al iniciar, con tiempos suaves, reacciones y sonido opcional.",
   "config.enabled.label": "Activar saludos",
-  "config.enabled.description": "Permite que Launch Buddy te salude cuando OpenPets inicia.",
+  "config.enabled.description": "Permite que Launch Buddy te salude cuando FamiliarOS inicia.",
   "config.greetingMode.label": "Estilo de saludo",
   "config.greetingMode.description": "Elige cómo Launch Buddy selecciona un mensaje.",
   "config.greetingMode.smart": "Inteligente según la hora",
@@ -51,6 +51,6 @@
   "message.smart.night": "Sigues despierto tarde; mantendré todo tranquilo y acogedor.",
   "message.random.0": "¡Bienvenido de vuelta! Tu buddy está listo.",
   "message.random.1": "Qué gusto verte otra vez. Hagamos buena esta sesión.",
-  "message.random.2": "OpenPets despertó, ¡y yo también!",
+  "message.random.2": "FamiliarOS despertó, ¡y yo también!",
   "message.random.3": "Hola, estaré cerca si necesitas ánimo."
 }
diff --git a/plugins/official/openpets.launch-buddy/locales/ja.json b/plugins/official/familiaros.launch-buddy/locales/ja.json
similarity index 95%
rename from plugins/official/openpets.launch-buddy/locales/ja.json
rename to plugins/official/familiaros.launch-buddy/locales/ja.json
index f25da20c..70d6ecca 100644
--- a/plugins/official/openpets.launch-buddy/locales/ja.json
+++ b/plugins/official/familiaros.launch-buddy/locales/ja.json
@@ -2,7 +2,7 @@
   "plugin.name": "Launch Buddy",
   "plugin.description": "穏やかなタイミング、リアクション、オプションのサウンドを備えた、フレンドリーな起動時のご挨拶。",
   "config.enabled.label": "挨拶を有効にする",
-  "config.enabled.description": "OpenPetsの起動時にLaunch Buddyから挨拶されるようにします。",
+  "config.enabled.description": "FamiliarOSの起動時にLaunch Buddyから挨拶されるようにします。",
   "config.greetingMode.label": "挨拶スタイル",
   "config.greetingMode.description": "Launch Buddyがメッセージを選択する方法を選択します。",
   "config.greetingMode.smart": "時間認識スマート",
@@ -51,6 +51,6 @@
   "message.smart.night": "夜遅いですね――暖かくして静かにお付き合いします。",
   "message.random.0": "おかえりなさい！準備完了です。",
   "message.random.1": "また会えて嬉しいです。今回のセッションも良いものにしましょう。",
-  "message.random.2": "OpenPetsが起きました。私も準備万端です！",
+  "message.random.2": "FamiliarOSが起きました。私も準備万端です！",
   "message.random.3": "こんにちは。元気を出したい時は、すぐそばにいますよ。"
 }
\ No newline at end of file
diff --git a/plugins/official/openpets.launch-buddy/locales/ko.json b/plugins/official/familiaros.launch-buddy/locales/ko.json
similarity index 95%
rename from plugins/official/openpets.launch-buddy/locales/ko.json
rename to plugins/official/familiaros.launch-buddy/locales/ko.json
index 567e9e54..e58a8ab1 100644
--- a/plugins/official/openpets.launch-buddy/locales/ko.json
+++ b/plugins/official/familiaros.launch-buddy/locales/ko.json
@@ -2,7 +2,7 @@
   "plugin.name": "Launch Buddy",
   "plugin.description": "잔잔한 타이밍, 반응 및 선택 동작 소리를 포함하여 조용하고 친근한 부팅 시작 인사를 제공합니다.",
   "config.enabled.label": "인사말 활성화",
-  "config.enabled.description": "OpenPets가 시작될 때 Launch Buddy가 인사를 건네도록 합니다.",
+  "config.enabled.description": "FamiliarOS가 시작될 때 Launch Buddy가 인사를 건네도록 합니다.",
   "config.greetingMode.label": "인사 스타일",
   "config.greetingMode.description": "Launch Buddy가 메시지를 선택하는 방식을 설정합니다.",
   "config.greetingMode.smart": "시간 맞춤형 스마트",
@@ -51,6 +51,6 @@
   "message.smart.night": "밤이 꽤 늦었네요. 포근하고 조용하게 곁을 지킬게요.",
   "message.random.0": "다시 만나서 반가워요! 당신의 버디가 준비 완료되었습니다.",
   "message.random.1": "다시 만나서 정말 좋아요. 이번 시간을 유익하게 보내봐요.",
-  "message.random.2": "OpenPets가 깨어났으니, 저도 깨어났어요!",
+  "message.random.2": "FamiliarOS가 깨어났으니, 저도 깨어났어요!",
   "message.random.3": "안녕하세요, 도움이 필요하면 언제든 곁에 있을게요."
 }
\ No newline at end of file
diff --git a/plugins/official/openpets.launch-buddy/locales/pt-BR.json b/plugins/official/familiaros.launch-buddy/locales/pt-BR.json
similarity index 97%
rename from plugins/official/openpets.launch-buddy/locales/pt-BR.json
rename to plugins/official/familiaros.launch-buddy/locales/pt-BR.json
index f09f89bb..78c93c62 100644
--- a/plugins/official/openpets.launch-buddy/locales/pt-BR.json
+++ b/plugins/official/familiaros.launch-buddy/locales/pt-BR.json
@@ -2,7 +2,7 @@
   "plugin.name": "Launch Buddy",
   "plugin.description": "Uma calorosa saudação de inicialização com sincronização suave, reações e som opcional.",
   "config.enabled.label": "Habilitar saudações",
-  "config.enabled.description": "Deixar que o Launch Buddy cumprimente você quando o OpenPets iniciar.",
+  "config.enabled.description": "Deixar que o Launch Buddy cumprimente você quando o FamiliarOS iniciar.",
   "config.greetingMode.label": "Estilo de saudação",
   "config.greetingMode.description": "Escolha como o Launch Buddy seleciona uma mensagem.",
   "config.greetingMode.smart": "Inteligente e ciente da hora",
@@ -51,6 +51,6 @@
   "message.smart.night": "Você acordou até tarde—vou manter tudo aconchegante e quieto por aqui.",
   "message.random.0": "Boas-vindas de volta! Seu buddy está pronto.",
   "message.random.1": "Que bom ver você de novo. Vamos tornar essa sessão excelente.",
-  "message.random.2": "O OpenPets acordou, e eu também!",
+  "message.random.2": "O FamiliarOS acordou, e eu também!",
   "message.random.3": "Olá! Estarei por perto se precisar de um incentivo."
 }
\ No newline at end of file
diff --git a/plugins/official/openpets.launch-buddy/locales/zh-Hans.json b/plugins/official/familiaros.launch-buddy/locales/zh-Hans.json
similarity index 95%
rename from plugins/official/openpets.launch-buddy/locales/zh-Hans.json
rename to plugins/official/familiaros.launch-buddy/locales/zh-Hans.json
index 33884f93..50270ba0 100644
--- a/plugins/official/openpets.launch-buddy/locales/zh-Hans.json
+++ b/plugins/official/familiaros.launch-buddy/locales/zh-Hans.json
@@ -2,7 +2,7 @@
   "plugin.name": "Launch Buddy",
   "plugin.description": "友好的启动问候，带有温和的时机、反应和可选的声音。",
   "config.enabled.label": "启用问候",
-  "config.enabled.description": "允许 Launch Buddy 在 OpenPets 启动时向您问好。",
+  "config.enabled.description": "允许 Launch Buddy 在 FamiliarOS 启动时向您问好。",
   "config.greetingMode.label": "问候风格",
   "config.greetingMode.description": "选择 Launch Buddy 选取消息的方式。",
   "config.greetingMode.smart": "智能时间感知",
@@ -51,6 +51,6 @@
   "message.smart.night": "你熬夜了——我会陪着你，保持温馨和安静。",
   "message.random.0": "欢迎回来！你的伙伴已经准备好了。",
   "message.random.1": "很高兴再次见到你。让我们这节会话过得充实愉快。",
-  "message.random.2": "OpenPets 醒了，我也醒了！",
+  "message.random.2": "FamiliarOS 醒了，我也醒了！",
   "message.random.3": "你好——如果你需要鼓励，我就在身旁。"
 }
\ No newline at end of file
diff --git a/plugins/official/openpets.launch-buddy/locales/zh-Hant.json b/plugins/official/familiaros.launch-buddy/locales/zh-Hant.json
similarity index 95%
rename from plugins/official/openpets.launch-buddy/locales/zh-Hant.json
rename to plugins/official/familiaros.launch-buddy/locales/zh-Hant.json
index 774509cd..2945a26c 100644
--- a/plugins/official/openpets.launch-buddy/locales/zh-Hant.json
+++ b/plugins/official/familiaros.launch-buddy/locales/zh-Hant.json
@@ -2,7 +2,7 @@
   "plugin.name": "Launch Buddy",
   "plugin.description": "友好的啟動問候，帶有溫和的時間、反應和可選的聲音。",
   "config.enabled.label": "啟用問候",
-  "config.enabled.description": "允許 Launch Buddy 在 OpenPets 啟動時向您問好。",
+  "config.enabled.description": "允許 Launch Buddy 在 FamiliarOS 啟動時向您問好。",
   "config.greetingMode.label": "問候風格",
   "config.greetingMode.description": "選擇 Launch Buddy 選取訊息的方式。",
   "config.greetingMode.smart": "智慧時間感知",
@@ -51,6 +51,6 @@
   "message.smart.night": "你熬夜了——我會陪著你，保持溫馨和安靜。",
   "message.random.0": "歡迎回來！你的夥伴已經準備好了。",
   "message.random.1": "很高興再次見到你。讓我們這節會話過得充實愉快。",
-  "message.random.2": "OpenPets 醒了，我也醒了！",
+  "message.random.2": "FamiliarOS 醒了，我也醒了！",
   "message.random.3": "你好——如果你需要鼓勵，我就在身旁。"
 }
\ No newline at end of file
diff --git a/plugins/official/openpets.launch-buddy/test.js b/plugins/official/familiaros.launch-buddy/test.js
similarity index 98%
rename from plugins/official/openpets.launch-buddy/test.js
rename to plugins/official/familiaros.launch-buddy/test.js
index 5e8f69e6..598ce79f 100644
--- a/plugins/official/openpets.launch-buddy/test.js
+++ b/plugins/official/familiaros.launch-buddy/test.js
@@ -1,4 +1,4 @@
-// Golden test for openpets.launch-buddy.
+// Golden test for familiaros.launch-buddy.
 import assert from "node:assert/strict";
 import { readFile } from "node:fs/promises";
 import {
@@ -14,7 +14,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(new URL("../../../packages/sdk/dist/testing.js", import.meta.url)));
 }
diff --git a/plugins/official/openpets.magic-8-ball/assets/magic-8-ball.svg b/plugins/official/familiaros.magic-8-ball/assets/magic-8-ball.svg
similarity index 100%
rename from plugins/official/openpets.magic-8-ball/assets/magic-8-ball.svg
rename to plugins/official/familiaros.magic-8-ball/assets/magic-8-ball.svg
diff --git a/plugins/official/openpets.magic-8-ball/openpets.plugin.json b/plugins/official/familiaros.magic-8-ball/familiaros.plugin.json
similarity index 90%
rename from plugins/official/openpets.magic-8-ball/openpets.plugin.json
rename to plugins/official/familiaros.magic-8-ball/familiaros.plugin.json
index 91a448f5..e6b5f9e9 100644
--- a/plugins/official/openpets.magic-8-ball/openpets.plugin.json
+++ b/plugins/official/familiaros.magic-8-ball/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.magic-8-ball",
+  "id": "familiaros.magic-8-ball",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.magic-8-ball/index.js b/plugins/official/familiaros.magic-8-ball/index.js
similarity index 96%
rename from plugins/official/openpets.magic-8-ball/index.js
rename to plugins/official/familiaros.magic-8-ball/index.js
index 0f338109..b241bce8 100644
--- a/plugins/official/openpets.magic-8-ball/index.js
+++ b/plugins/official/familiaros.magic-8-ball/index.js
@@ -1,4 +1,4 @@
-// Magic 8-ball (openpets.magic-8-ball) — official SDK v3 plugin.
+// Magic 8-ball (familiaros.magic-8-ball) — official SDK v3 plugin.
 
 export const HISTORY_KEY = "history";
 export const MAX_HISTORY = 8;
@@ -78,8 +78,8 @@ export async function showLastAnswer(ctx) {
   return last;
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       const icon = ctx.assets.icon("magic8");
 
diff --git a/plugins/official/openpets.magic-8-ball/locales/en.json b/plugins/official/familiaros.magic-8-ball/locales/en.json
similarity index 100%
rename from plugins/official/openpets.magic-8-ball/locales/en.json
rename to plugins/official/familiaros.magic-8-ball/locales/en.json
diff --git a/plugins/official/openpets.magic-8-ball/locales/es-419.json b/plugins/official/familiaros.magic-8-ball/locales/es-419.json
similarity index 100%
rename from plugins/official/openpets.magic-8-ball/locales/es-419.json
rename to plugins/official/familiaros.magic-8-ball/locales/es-419.json
diff --git a/plugins/official/openpets.magic-8-ball/locales/ja.json b/plugins/official/familiaros.magic-8-ball/locales/ja.json
similarity index 100%
rename from plugins/official/openpets.magic-8-ball/locales/ja.json
rename to plugins/official/familiaros.magic-8-ball/locales/ja.json
diff --git a/plugins/official/openpets.magic-8-ball/locales/ko.json b/plugins/official/familiaros.magic-8-ball/locales/ko.json
similarity index 100%
rename from plugins/official/openpets.magic-8-ball/locales/ko.json
rename to plugins/official/familiaros.magic-8-ball/locales/ko.json
diff --git a/plugins/official/openpets.magic-8-ball/locales/pt-BR.json b/plugins/official/familiaros.magic-8-ball/locales/pt-BR.json
similarity index 100%
rename from plugins/official/openpets.magic-8-ball/locales/pt-BR.json
rename to plugins/official/familiaros.magic-8-ball/locales/pt-BR.json
diff --git a/plugins/official/openpets.magic-8-ball/locales/zh-Hans.json b/plugins/official/familiaros.magic-8-ball/locales/zh-Hans.json
similarity index 100%
rename from plugins/official/openpets.magic-8-ball/locales/zh-Hans.json
rename to plugins/official/familiaros.magic-8-ball/locales/zh-Hans.json
diff --git a/plugins/official/openpets.magic-8-ball/locales/zh-Hant.json b/plugins/official/familiaros.magic-8-ball/locales/zh-Hant.json
similarity index 100%
rename from plugins/official/openpets.magic-8-ball/locales/zh-Hant.json
rename to plugins/official/familiaros.magic-8-ball/locales/zh-Hant.json
diff --git a/plugins/official/openpets.magic-8-ball/test.js b/plugins/official/familiaros.magic-8-ball/test.js
similarity index 96%
rename from plugins/official/openpets.magic-8-ball/test.js
rename to plugins/official/familiaros.magic-8-ball/test.js
index 7d9ff1cd..ea07de87 100644
--- a/plugins/official/openpets.magic-8-ball/test.js
+++ b/plugins/official/familiaros.magic-8-ball/test.js
@@ -1,4 +1,4 @@
-// Golden test for openpets.magic-8-ball.
+// Golden test for familiaros.magic-8-ball.
 import assert from "node:assert/strict";
 import { readFile } from "node:fs/promises";
 import {
@@ -14,7 +14,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(new URL("../../../packages/sdk/dist/testing.js", import.meta.url)));
 }
@@ -133,4 +133,4 @@ function assertNoMixedBodyMedia(h) {
   h.expectNoErrors();
 }
 
-console.log("openpets.magic-8-ball: all checks passed.");
+console.log("familiaros.magic-8-ball: all checks passed.");
diff --git a/plugins/official/openpets.mood-check-in/assets/mood.svg b/plugins/official/familiaros.mood-check-in/assets/mood.svg
similarity index 100%
rename from plugins/official/openpets.mood-check-in/assets/mood.svg
rename to plugins/official/familiaros.mood-check-in/assets/mood.svg
diff --git a/plugins/official/openpets.mood-check-in/openpets.plugin.json b/plugins/official/familiaros.mood-check-in/familiaros.plugin.json
similarity index 94%
rename from plugins/official/openpets.mood-check-in/openpets.plugin.json
rename to plugins/official/familiaros.mood-check-in/familiaros.plugin.json
index 9584da19..9cb3d4c3 100644
--- a/plugins/official/openpets.mood-check-in/openpets.plugin.json
+++ b/plugins/official/familiaros.mood-check-in/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.mood-check-in",
+  "id": "familiaros.mood-check-in",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.mood-check-in/index.js b/plugins/official/familiaros.mood-check-in/index.js
similarity index 97%
rename from plugins/official/openpets.mood-check-in/index.js
rename to plugins/official/familiaros.mood-check-in/index.js
index 9a97d082..ab032b82 100644
--- a/plugins/official/openpets.mood-check-in/index.js
+++ b/plugins/official/familiaros.mood-check-in/index.js
@@ -1,4 +1,4 @@
-// Mood Check-in (openpets.mood-check-in) — gentle once-a-day SDK v3 check-in.
+// Mood Check-in (familiaros.mood-check-in) — gentle once-a-day SDK v3 check-in.
 
 export const STORAGE_KEY = "mood-check-in-state";
 export const SCHEDULE_ID = "mood-check-in-daily";
@@ -129,8 +129,8 @@ export async function showSummary(ctx) {
   await ctx.pet.speak(ctx.t("summary.recent", { count: recent.length, mood: ctx.t(`mood.${top}`) }));
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await scheduleNext(ctx);
       const icon = ctx.assets.icon("mood");
diff --git a/plugins/official/openpets.mood-check-in/locales/en.json b/plugins/official/familiaros.mood-check-in/locales/en.json
similarity index 100%
rename from plugins/official/openpets.mood-check-in/locales/en.json
rename to plugins/official/familiaros.mood-check-in/locales/en.json
diff --git a/plugins/official/openpets.mood-check-in/locales/es-419.json b/plugins/official/familiaros.mood-check-in/locales/es-419.json
similarity index 100%
rename from plugins/official/openpets.mood-check-in/locales/es-419.json
rename to plugins/official/familiaros.mood-check-in/locales/es-419.json
diff --git a/plugins/official/openpets.mood-check-in/locales/ja.json b/plugins/official/familiaros.mood-check-in/locales/ja.json
similarity index 100%
rename from plugins/official/openpets.mood-check-in/locales/ja.json
rename to plugins/official/familiaros.mood-check-in/locales/ja.json
diff --git a/plugins/official/openpets.mood-check-in/locales/ko.json b/plugins/official/familiaros.mood-check-in/locales/ko.json
similarity index 100%
rename from plugins/official/openpets.mood-check-in/locales/ko.json
rename to plugins/official/familiaros.mood-check-in/locales/ko.json
diff --git a/plugins/official/openpets.mood-check-in/locales/pt-BR.json b/plugins/official/familiaros.mood-check-in/locales/pt-BR.json
similarity index 100%
rename from plugins/official/openpets.mood-check-in/locales/pt-BR.json
rename to plugins/official/familiaros.mood-check-in/locales/pt-BR.json
diff --git a/plugins/official/openpets.mood-check-in/locales/zh-Hans.json b/plugins/official/familiaros.mood-check-in/locales/zh-Hans.json
similarity index 100%
rename from plugins/official/openpets.mood-check-in/locales/zh-Hans.json
rename to plugins/official/familiaros.mood-check-in/locales/zh-Hans.json
diff --git a/plugins/official/openpets.mood-check-in/locales/zh-Hant.json b/plugins/official/familiaros.mood-check-in/locales/zh-Hant.json
similarity index 100%
rename from plugins/official/openpets.mood-check-in/locales/zh-Hant.json
rename to plugins/official/familiaros.mood-check-in/locales/zh-Hant.json
diff --git a/plugins/official/openpets.mood-check-in/test.js b/plugins/official/familiaros.mood-check-in/test.js
similarity index 96%
rename from plugins/official/openpets.mood-check-in/test.js
rename to plugins/official/familiaros.mood-check-in/test.js
index f5a37f74..74894b03 100644
--- a/plugins/official/openpets.mood-check-in/test.js
+++ b/plugins/official/familiaros.mood-check-in/test.js
@@ -1,4 +1,4 @@
-// Golden test for openpets.mood-check-in.
+// Golden test for familiaros.mood-check-in.
 import assert from "node:assert/strict";
 import { readFile } from "node:fs/promises";
 import {
@@ -14,7 +14,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(new URL("../../../packages/sdk/dist/testing.js", import.meta.url)));
 }
@@ -123,4 +123,4 @@ function timeInMinutes(minutes) {
   h.expectNoErrors();
 }
 
-console.log("openpets.mood-check-in: all checks passed.");
+console.log("familiaros.mood-check-in: all checks passed.");
diff --git a/plugins/official/openpets.reminders/assets/reminder.svg b/plugins/official/familiaros.reminders/assets/reminder.svg
similarity index 100%
rename from plugins/official/openpets.reminders/assets/reminder.svg
rename to plugins/official/familiaros.reminders/assets/reminder.svg
diff --git a/plugins/official/openpets.reminders/openpets.plugin.json b/plugins/official/familiaros.reminders/familiaros.plugin.json
similarity index 96%
rename from plugins/official/openpets.reminders/openpets.plugin.json
rename to plugins/official/familiaros.reminders/familiaros.plugin.json
index a52d9faa..4c562073 100644
--- a/plugins/official/openpets.reminders/openpets.plugin.json
+++ b/plugins/official/familiaros.reminders/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.reminders",
+  "id": "familiaros.reminders",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.reminders/index.js b/plugins/official/familiaros.reminders/index.js
similarity index 98%
rename from plugins/official/openpets.reminders/index.js
rename to plugins/official/familiaros.reminders/index.js
index 5fc421d8..5503773b 100644
--- a/plugins/official/openpets.reminders/index.js
+++ b/plugins/official/familiaros.reminders/index.js
@@ -1,4 +1,4 @@
-// Quick Reminders (openpets.reminders) — a self-contained v3 plugin.
+// Quick Reminders (familiaros.reminders) — a self-contained v3 plugin.
 //
 // Keeps the proven Quick Reminders interaction model (a "Set reminder..." form
 // plus 15/30/60-minute presets from the pet menu) but delivers with the §21.3
@@ -184,7 +184,7 @@ export async function fireReminder(ctx, id) {
 /**
  * Reconcile persisted reminders against the wall clock on start(). Schedules
  * are in-memory per session, so future reminders are re-registered and overdue
- * ones (fired while OpenPets was closed) are delivered as "missed".
+ * ones (fired while FamiliarOS was closed) are delivered as "missed".
  */
 export async function reconcile(ctx) {
   await ctx.schedule.cancelAll();
@@ -227,8 +227,8 @@ async function showReminderList(ctx) {
   );
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await reconcile(ctx);
 
diff --git a/plugins/official/openpets.reminders/locales/en.json b/plugins/official/familiaros.reminders/locales/en.json
similarity index 100%
rename from plugins/official/openpets.reminders/locales/en.json
rename to plugins/official/familiaros.reminders/locales/en.json
diff --git a/plugins/official/openpets.reminders/locales/es-419.json b/plugins/official/familiaros.reminders/locales/es-419.json
similarity index 100%
rename from plugins/official/openpets.reminders/locales/es-419.json
rename to plugins/official/familiaros.reminders/locales/es-419.json
diff --git a/plugins/official/openpets.reminders/locales/ja.json b/plugins/official/familiaros.reminders/locales/ja.json
similarity index 100%
rename from plugins/official/openpets.reminders/locales/ja.json
rename to plugins/official/familiaros.reminders/locales/ja.json
diff --git a/plugins/official/openpets.reminders/locales/ko.json b/plugins/official/familiaros.reminders/locales/ko.json
similarity index 100%
rename from plugins/official/openpets.reminders/locales/ko.json
rename to plugins/official/familiaros.reminders/locales/ko.json
diff --git a/plugins/official/openpets.reminders/locales/pt-BR.json b/plugins/official/familiaros.reminders/locales/pt-BR.json
similarity index 100%
rename from plugins/official/openpets.reminders/locales/pt-BR.json
rename to plugins/official/familiaros.reminders/locales/pt-BR.json
diff --git a/plugins/official/openpets.reminders/locales/zh-Hans.json b/plugins/official/familiaros.reminders/locales/zh-Hans.json
similarity index 100%
rename from plugins/official/openpets.reminders/locales/zh-Hans.json
rename to plugins/official/familiaros.reminders/locales/zh-Hans.json
diff --git a/plugins/official/openpets.reminders/locales/zh-Hant.json b/plugins/official/familiaros.reminders/locales/zh-Hant.json
similarity index 100%
rename from plugins/official/openpets.reminders/locales/zh-Hant.json
rename to plugins/official/familiaros.reminders/locales/zh-Hant.json
diff --git a/plugins/official/openpets.reminders/test.js b/plugins/official/familiaros.reminders/test.js
similarity index 96%
rename from plugins/official/openpets.reminders/test.js
rename to plugins/official/familiaros.reminders/test.js
index 189f4210..63416577 100644
--- a/plugins/official/openpets.reminders/test.js
+++ b/plugins/official/familiaros.reminders/test.js
@@ -1,9 +1,9 @@
-// Golden test for openpets.reminders.
+// Golden test for familiaros.reminders.
 //
 // Runs two ways:
 //   * `node test.js` (via scripts/test-plugins.mjs) — pure-helper unit checks
 //     plus the harness-driven golden test.
-//   * authored against `@open-pets/plugin-sdk/testing`; when that bare
+//   * authored against `@familiaros/plugin-sdk/testing`; when that bare
 //     specifier isn't resolvable from this directory we fall back to the
 //     built workspace dist so the test still runs standalone.
 import assert from "node:assert/strict";
@@ -17,7 +17,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(
     new URL("../../../packages/sdk/dist/testing.js", import.meta.url)
@@ -223,4 +223,4 @@ const LOCALES = {
 // 7) MAX_REMINDERS guard.
 assert.equal(MAX_REMINDERS, 10);
 
-console.log("openpets.reminders: all checks passed.");
+console.log("familiaros.reminders: all checks passed.");
diff --git a/plugins/official/openpets.virtual-pet/assets/virtual-pet.svg b/plugins/official/familiaros.virtual-familiar/assets/virtual-pet.svg
similarity index 100%
rename from plugins/official/openpets.virtual-pet/assets/virtual-pet.svg
rename to plugins/official/familiaros.virtual-familiar/assets/virtual-pet.svg
diff --git a/plugins/official/openpets.virtual-pet/openpets.plugin.json b/plugins/official/familiaros.virtual-familiar/familiaros.plugin.json
similarity index 94%
rename from plugins/official/openpets.virtual-pet/openpets.plugin.json
rename to plugins/official/familiaros.virtual-familiar/familiaros.plugin.json
index b1c2ea8b..658c15af 100644
--- a/plugins/official/openpets.virtual-pet/openpets.plugin.json
+++ b/plugins/official/familiaros.virtual-familiar/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.virtual-pet",
+  "id": "familiaros.virtual-pet",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.virtual-pet/index.js b/plugins/official/familiaros.virtual-familiar/index.js
similarity index 98%
rename from plugins/official/openpets.virtual-pet/index.js
rename to plugins/official/familiaros.virtual-familiar/index.js
index ac2b25f2..bd0a0206 100644
--- a/plugins/official/openpets.virtual-pet/index.js
+++ b/plugins/official/familiaros.virtual-familiar/index.js
@@ -1,4 +1,4 @@
-// Virtual Pet (openpets.virtual-pet) — SDK v3 Virtual Pet companion.
+// Virtual Pet (familiaros.virtual-pet) — SDK v3 Virtual Pet companion.
 
 export const SCHEDULE_ID = "virtual-pet-tick";
 
@@ -334,8 +334,8 @@ export async function reconcile(ctx, now = Date.now()) {
   return savedState;
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await reconcile(ctx);
 
diff --git a/plugins/official/openpets.virtual-pet/locales/en.json b/plugins/official/familiaros.virtual-familiar/locales/en.json
similarity index 100%
rename from plugins/official/openpets.virtual-pet/locales/en.json
rename to plugins/official/familiaros.virtual-familiar/locales/en.json
diff --git a/plugins/official/openpets.virtual-pet/test.js b/plugins/official/familiaros.virtual-familiar/test.js
similarity index 97%
rename from plugins/official/openpets.virtual-pet/test.js
rename to plugins/official/familiaros.virtual-familiar/test.js
index 6d0ea3b8..09fa7d8e 100644
--- a/plugins/official/openpets.virtual-pet/test.js
+++ b/plugins/official/familiaros.virtual-familiar/test.js
@@ -1,4 +1,4 @@
-// Golden test for openpets.virtual-pet.
+// Golden test for familiaros.virtual-pet.
 import assert from "node:assert/strict";
 import { readFile } from "node:fs/promises";
 import {
@@ -12,7 +12,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(new URL("../../../packages/sdk/dist/testing.js", import.meta.url)));
 }
@@ -203,4 +203,4 @@ Object.defineProperty(Date, "now", {
   configurable: true,
 });
 
-console.log("openpets.virtual-pet: all checks passed.");
+console.log("familiaros.virtual-pet: all checks passed.");
diff --git a/plugins/official/openpets.water-reminder/assets/water.svg b/plugins/official/familiaros.water-reminder/assets/water.svg
similarity index 100%
rename from plugins/official/openpets.water-reminder/assets/water.svg
rename to plugins/official/familiaros.water-reminder/assets/water.svg
diff --git a/plugins/official/openpets.water-reminder/openpets.plugin.json b/plugins/official/familiaros.water-reminder/familiaros.plugin.json
similarity index 96%
rename from plugins/official/openpets.water-reminder/openpets.plugin.json
rename to plugins/official/familiaros.water-reminder/familiaros.plugin.json
index ea24ef5f..ddb047c0 100644
--- a/plugins/official/openpets.water-reminder/openpets.plugin.json
+++ b/plugins/official/familiaros.water-reminder/familiaros.plugin.json
@@ -1,6 +1,6 @@
 {
   "manifestVersion": 3,
-  "id": "openpets.water-reminder",
+  "id": "familiaros.water-reminder",
   "name": "$t:plugin.name",
   "description": "$t:plugin.description",
   "version": "1.0.0",
diff --git a/plugins/official/openpets.water-reminder/index.js b/plugins/official/familiaros.water-reminder/index.js
similarity index 97%
rename from plugins/official/openpets.water-reminder/index.js
rename to plugins/official/familiaros.water-reminder/index.js
index 907083cf..2b040a53 100644
--- a/plugins/official/openpets.water-reminder/index.js
+++ b/plugins/official/familiaros.water-reminder/index.js
@@ -1,4 +1,4 @@
-// Water Reminder (openpets.water-reminder) — a small official SDK v3 appliance.
+// Water Reminder (familiaros.water-reminder) — a small official SDK v3 appliance.
 
 export const MINUTE_MS = 60_000;
 export const DAY_MS = 24 * 60 * 60_000;
@@ -181,8 +181,8 @@ export async function reconcile(ctx) {
   await scheduleFromState(ctx);
 }
 
-export function register(OpenPetsPlugin) {
-  OpenPetsPlugin.register({
+export function register(FamiliarOSPlugin) {
+  FamiliarOSPlugin.register({
     async start(ctx) {
       await reconcile(ctx);
 
diff --git a/plugins/official/openpets.water-reminder/locales/en.json b/plugins/official/familiaros.water-reminder/locales/en.json
similarity index 100%
rename from plugins/official/openpets.water-reminder/locales/en.json
rename to plugins/official/familiaros.water-reminder/locales/en.json
diff --git a/plugins/official/openpets.water-reminder/locales/es-419.json b/plugins/official/familiaros.water-reminder/locales/es-419.json
similarity index 100%
rename from plugins/official/openpets.water-reminder/locales/es-419.json
rename to plugins/official/familiaros.water-reminder/locales/es-419.json
diff --git a/plugins/official/openpets.water-reminder/locales/ja.json b/plugins/official/familiaros.water-reminder/locales/ja.json
similarity index 100%
rename from plugins/official/openpets.water-reminder/locales/ja.json
rename to plugins/official/familiaros.water-reminder/locales/ja.json
diff --git a/plugins/official/openpets.water-reminder/locales/ko.json b/plugins/official/familiaros.water-reminder/locales/ko.json
similarity index 100%
rename from plugins/official/openpets.water-reminder/locales/ko.json
rename to plugins/official/familiaros.water-reminder/locales/ko.json
diff --git a/plugins/official/openpets.water-reminder/locales/pt-BR.json b/plugins/official/familiaros.water-reminder/locales/pt-BR.json
similarity index 100%
rename from plugins/official/openpets.water-reminder/locales/pt-BR.json
rename to plugins/official/familiaros.water-reminder/locales/pt-BR.json
diff --git a/plugins/official/openpets.water-reminder/locales/zh-Hans.json b/plugins/official/familiaros.water-reminder/locales/zh-Hans.json
similarity index 100%
rename from plugins/official/openpets.water-reminder/locales/zh-Hans.json
rename to plugins/official/familiaros.water-reminder/locales/zh-Hans.json
diff --git a/plugins/official/openpets.water-reminder/locales/zh-Hant.json b/plugins/official/familiaros.water-reminder/locales/zh-Hant.json
similarity index 100%
rename from plugins/official/openpets.water-reminder/locales/zh-Hant.json
rename to plugins/official/familiaros.water-reminder/locales/zh-Hant.json
diff --git a/plugins/official/openpets.water-reminder/test.js b/plugins/official/familiaros.water-reminder/test.js
similarity index 96%
rename from plugins/official/openpets.water-reminder/test.js
rename to plugins/official/familiaros.water-reminder/test.js
index a6c7ac0b..7f09796c 100644
--- a/plugins/official/openpets.water-reminder/test.js
+++ b/plugins/official/familiaros.water-reminder/test.js
@@ -1,4 +1,4 @@
-// Golden test for openpets.water-reminder.
+// Golden test for familiaros.water-reminder.
 import assert from "node:assert/strict";
 import {
   DAY_MS,
@@ -11,7 +11,7 @@ import {
 
 let createTestHarness;
 try {
-  ({ createTestHarness } = await import("@open-pets/plugin-sdk/testing"));
+  ({ createTestHarness } = await import("@familiaros/plugin-sdk/testing"));
 } catch {
   ({ createTestHarness } = await import(
     new URL("../../../packages/sdk/dist/testing.js", import.meta.url)
@@ -193,4 +193,4 @@ const LOCALES = {
   h.expectNoErrors();
 }
 
-console.log("openpets.water-reminder: all checks passed.");
+console.log("familiaros.water-reminder: all checks passed.");
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index d76ce191..05018e5d 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -17,22 +17,22 @@ importers:
       '@modelcontextprotocol/sdk':
         specifier: ^1.29.0
         version: 1.29.0(zod@4.4.3)
-      '@open-pets/agent-events':
+      '@familiaros/agent-events':
         specifier: workspace:*
         version: link:../../packages/agent-events
-      '@open-pets/claude':
+      '@familiaros/claude':
         specifier: workspace:*
         version: link:../../packages/claude
-      '@open-pets/cli':
+      '@familiaros/cli':
         specifier: workspace:*
         version: link:../../packages/cli
-      '@open-pets/cursor':
+      '@familiaros/cursor':
         specifier: workspace:*
         version: link:../../packages/cursor
-      '@open-pets/mcp':
+      '@familiaros/mcp':
         specifier: workspace:*
         version: link:../../packages/mcp
-      '@open-pets/opencode':
+      '@familiaros/opencode':
         specifier: workspace:*
         version: link:../../packages/opencode
       react:
@@ -48,7 +48,7 @@ importers:
         specifier: 3.3.0
         version: 3.3.0
     devDependencies:
-      '@open-pets/plugin-sdk':
+      '@familiaros/plugin-sdk':
         specifier: workspace:*
         version: link:../../packages/sdk
       '@types/node':
@@ -108,10 +108,10 @@ importers:
 
   packages/claude:
     dependencies:
-      '@open-pets/agent-events':
+      '@familiaros/agent-events':
         specifier: workspace:*
         version: link:../agent-events
-      '@open-pets/client':
+      '@familiaros/client':
         specifier: workspace:*
         version: link:../client
     devDependencies:
@@ -124,19 +124,19 @@ importers:
 
   packages/cli:
     dependencies:
-      '@open-pets/claude':
+      '@familiaros/claude':
         specifier: workspace:*
         version: link:../claude
-      '@open-pets/client':
+      '@familiaros/client':
         specifier: workspace:*
         version: link:../client
-      '@open-pets/cursor':
+      '@familiaros/cursor':
         specifier: workspace:*
         version: link:../cursor
-      '@open-pets/mcp':
+      '@familiaros/mcp':
         specifier: workspace:*
         version: link:../mcp
-      '@open-pets/opencode':
+      '@familiaros/opencode':
         specifier: workspace:*
         version: link:../opencode
     devDependencies:
@@ -165,9 +165,9 @@ importers:
         specifier: ^6.0.3
         version: 6.0.3
 
-  packages/install-pet:
+  packages/install-familiar:
     dependencies:
-      '@open-pets/client':
+      '@familiaros/client':
         specifier: workspace:*
         version: link:../client
       yauzl:
@@ -189,7 +189,7 @@ importers:
       '@modelcontextprotocol/sdk':
         specifier: ^1.29.0
         version: 1.29.0(zod@4.4.3)
-      '@open-pets/client':
+      '@familiaros/client':
         specifier: workspace:*
         version: link:../client
       zod:
@@ -205,10 +205,10 @@ importers:
 
   packages/opencode:
     dependencies:
-      '@open-pets/agent-events':
+      '@familiaros/agent-events':
         specifier: workspace:*
         version: link:../agent-events
-      '@open-pets/client':
+      '@familiaros/client':
         specifier: workspace:*
         version: link:../client
       jsonc-parser:
@@ -222,7 +222,7 @@ importers:
         specifier: ^6.0.3
         version: 6.0.3
 
-  packages/pet-format:
+  packages/familiar-format:
     devDependencies:
       typescript:
         specifier: ^6.0.3
@@ -233,10 +233,10 @@ importers:
       '@earendil-works/pi-coding-agent':
         specifier: '*'
         version: 0.74.0(@modelcontextprotocol/sdk@1.29.0(zod@4.4.3))(ws@8.20.1)(zod@4.4.3)
-      '@open-pets/agent-events':
+      '@familiaros/agent-events':
         specifier: workspace:*
         version: link:../agent-events
-      '@open-pets/client':
+      '@familiaros/client':
         specifier: workspace:*
         version: link:../client
     devDependencies:
diff --git a/scripts/release-npm.mjs b/scripts/release-npm.mjs
index cb5fe4b7..b32a4396 100644
--- a/scripts/release-npm.mjs
+++ b/scripts/release-npm.mjs
@@ -6,7 +6,7 @@ import { spawnSync } from "node:child_process";
 
 const scriptsDir = dirname(fileURLToPath(import.meta.url));
 const repoRoot = resolve(scriptsDir, "..");
-const repository = "alvinunreal/openpets";
+const repository = "alvinunreal/familiaros";
 
 const publishOrder = [
   "packages/sdk",
@@ -18,7 +18,7 @@ const publishOrder = [
   "packages/cursor",
   "packages/pi",
   "packages/cli",
-  "packages/install-pet",
+  "packages/install-familiar",
 ];
 
 const allowedArgs = new Set([
@@ -169,19 +169,19 @@ function run(command, args, options) {
 function printHelp() {
   console.log(`Usage: pnpm release:npm -- --yes
 
-Publishes the public OpenPets npm packages in dependency order.
+Publishes the public FamiliarOS npm packages in dependency order.
 
 Packages:
-  1. @open-pets/plugin-sdk
-  2. @open-pets/client
-  3. @open-pets/agent-events
-  4. @open-pets/mcp
-  5. @open-pets/claude
-  6. @open-pets/opencode
-  7. @open-pets/cursor
-  8. @open-pets/pi
-  9. @open-pets/cli
-  10. install-pet
+  1. @familiaros/plugin-sdk
+  2. @familiaros/client
+  3. @familiaros/agent-events
+  4. @familiaros/mcp
+  5. @familiaros/claude
+  6. @familiaros/opencode
+  7. @familiaros/cursor
+  8. @familiaros/pi
+  9. @familiaros/cli
+  10. install-familiar
 
 Options:
   --yes            publish to npm; without this, runs pnpm publish --dry-run
diff --git a/skills/openpets/SKILL.md b/skills/openpets/SKILL.md
index d179c2d4..5250dab9 100644
--- a/skills/openpets/SKILL.md
+++ b/skills/openpets/SKILL.md
@@ -1,111 +1,111 @@
 ---
-name: openpets
-description: Use when the user asks to install, configure, verify, troubleshoot, or understand OpenPets; install or select a pet; connect Claude Code, OpenCode, Cursor, Codex, or MCP clients; configure a project to use a specific pet; or debug openpets_status, openpets_react, or openpets_say.
+name: familiaros
+description: Use when the user asks to install, configure, verify, troubleshoot, or understand FamiliarOS; install or select a familiar; connect Claude Code, OpenCode, Cursor, Codex, or MCP clients; configure a project to use a specific familiar; or debug familiaros_status, familiaros_react, or familiaros_say.
 license: MIT
 ---
 
-# OpenPets
+# FamiliarOS
 
-OpenPets is a desktop companion app for coding agents. The desktop app runs locally and exposes pet controls through CLI, MCP, hooks, plugins, and local IPC.
+FamiliarOS is a desktop companion app for coding agents. The desktop app runs locally and exposes familiar controls through CLI, MCP, hooks, plugins, and local IPC.
 
 Use this skill to help users onboard quickly and safely:
 
-- install or verify the OpenPets desktop app
-- install pets from the public catalog
+- install or verify the FamiliarOS desktop app
+- install familiars from the public catalog
 - configure Claude Code, OpenCode, Cursor, Codex, or another MCP client
-- configure a project to use a specific pet
-- validate `openpets_status`, `openpets_react`, and `openpets_say`
-- explain how OpenPets works
+- configure a project to use a specific familiar
+- validate `familiaros_status`, `familiaros_react`, and `familiaros_say`
+- explain how FamiliarOS works
 - troubleshoot setup problems
 
-## CLI rule: install once, then use openpets
+## CLI rule: install once, then use familiaros
 
-For the cleanest onboarding, install the OpenPets CLI globally first:
+For the cleanest onboarding, install the FamiliarOS CLI globally first:
 
 ```bash
-npm install -g @open-pets/cli
+npm install -g @familiaros/cli
 ```
 
-Then use the `openpets` command:
+Then use the `familiaros` command:
 
 ```bash
-openpets <command>
+familiaros <command>
 ```
 
 If the user does not want a global install, is in CI, or only needs a one-off command, use this fallback instead:
 
 ```bash
-npx -y @open-pets/cli@latest <command>
+npx -y @familiaros/cli@latest <command>
 ```
 
 For MCP server config, prefer the dedicated MCP package:
 
 ```bash
-npx -y @open-pets/mcp@latest --pet <pet-id>
+npx -y @familiaros/mcp@latest --familiar <familiar-id>
 ```
 
-Do not imply the desktop app installs a shell command by itself. The `openpets` command comes from the optional npm global CLI install.
+Do not imply the desktop app installs a shell command by itself. The `familiaros` command comes from the optional npm global CLI install.
 
 ## Mental model
 
 ```text
 Claude/OpenCode/Codex/Cursor/MCP client
-  -> OpenPets MCP, plugin, hook, or CLI
-  -> @open-pets/client
+  -> FamiliarOS MCP, plugin, hook, or CLI
+  -> @familiaros/client
   -> local IPC discovery/token
-  -> OpenPets desktop app
-  -> default pet or selected agent pet lease
+  -> FamiliarOS desktop app
+  -> default familiar or selected agent familiar lease
 ```
 
-OpenPets requires the desktop app to be installed and running for live pet control.
+FamiliarOS requires the desktop app to be installed and running for live familiar control.
 
 ## Decision tree
 
-- User asks to install OpenPets: follow `workflows/install-openpets.md`.
-- User asks to install a pet: follow `workflows/install-pet.md`.
+- User asks to install FamiliarOS: follow `workflows/install-familiaros.md`.
+- User asks to install a familiar: follow `workflows/install-familiar.md`.
 - User asks to configure a project or agent: follow `workflows/configure-project.md`.
 - User asks to verify Claude Code: follow `workflows/verify-claude.md`.
 - User asks to verify OpenCode: follow `workflows/verify-opencode.md`.
 - User asks about MCP or tool availability: follow `workflows/verify-mcp.md`.
 - User reports something broken: follow `workflows/troubleshoot.md`.
-- User asks how OpenPets works: follow `workflows/explain-architecture.md`.
+- User asks how FamiliarOS works: follow `workflows/explain-architecture.md`.
 
 ## Safety rules
 
-- Prefer official OpenPets CLI/UI flows over hand-editing integration config.
+- Prefer official FamiliarOS CLI/UI flows over hand-editing integration config.
 - Ask before using `--force` or replacing existing user-managed MCP/plugin/hook config.
 - Confirm the project path before project-local configuration.
-- Confirm the pet id before installing or selecting a pet, and make sure it is installed before configuring a project to use it.
-- Do not put secrets, private logs, private paths, source code, URLs, credentials, or sensitive text into pet speech.
+- Confirm the familiar id before installing or selecting a familiar, and make sure it is installed before configuring a project to use it.
+- Do not put secrets, private logs, private paths, source code, URLs, credentials, or sensitive text into familiar speech.
 - Restart Claude Code, OpenCode, or other MCP clients after config changes.
 - Do not promise the desktop app is installed or running; verify it.
-- If setup still fails after normal troubleshooting, encourage the user to report a bug at the OpenPets GitHub repository: https://github.com/alvinunreal/openpets/issues
+- If setup still fails after normal troubleshooting, encourage the user to report a bug at the FamiliarOS GitHub repository: https://github.com/alvinunreal/familiaros/issues
 
 ## Canonical quick commands
 
 ```bash
-npm install -g @open-pets/cli
-openpets status
-openpets pets
-openpets install <pet-id>
-openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
-openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
-openpets configure --agent cursor --pet <pet-id> --cwd <project-path> --yes
-openpets mcp --pet <pet-id>
+npm install -g @familiaros/cli
+familiaros status
+familiaros familiars
+familiaros install <familiar-id>
+familiaros configure --agent claude --familiar <familiar-id> --cwd <project-path> --yes
+familiaros configure --agent opencode --familiar <familiar-id> --cwd <project-path> --yes
+familiaros configure --agent cursor --familiar <familiar-id> --cwd <project-path> --yes
+familiaros mcp --familiar <familiar-id>
 ```
 
-One-off fallback: replace `openpets` with `npx -y @open-pets/cli@latest`.
+One-off fallback: replace `familiaros` with `npx -y @familiaros/cli@latest`.
 
 MCP server command:
 
 ```bash
-npx -y @open-pets/mcp@latest --pet <pet-id>
+npx -y @familiaros/mcp@latest --familiar <familiar-id>
 ```
 
 ## Public resources
 
-- Website: https://openpets.dev
-- Pet catalog: https://openpets.dev/pets/catalog.v3.json
-- GitHub issues: https://github.com/alvinunreal/openpets/issues
+- Website: https://familiaros.dev
+- Familiar catalog: https://familiaros.dev/familiars/catalog.v3.json
+- GitHub issues: https://github.com/alvinunreal/familiaros/issues
 
-Use the docs on `openpets.dev` as the source of truth when details may have changed.
+Use the docs on `familiaros.dev` as the source of truth when details may have changed.
diff --git a/skills/openpets/references/commands.md b/skills/openpets/references/commands.md
index 46fb5af0..d3ae038c 100644
--- a/skills/openpets/references/commands.md
+++ b/skills/openpets/references/commands.md
@@ -1,34 +1,34 @@
-# OpenPets Commands
+# FamiliarOS Commands
 
 Recommended clean setup:
 
 ```bash
-npm install -g @open-pets/cli
-openpets status
-openpets pets
-openpets install <pet-id>
-openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
-openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
-openpets configure --agent cursor --pet <pet-id> --cwd <project-path> --yes
-openpets mcp --pet <pet-id>
+npm install -g @familiaros/cli
+familiaros status
+familiaros familiars
+familiaros install <familiar-id>
+familiaros configure --agent claude --familiar <familiar-id> --cwd <project-path> --yes
+familiaros configure --agent opencode --familiar <familiar-id> --cwd <project-path> --yes
+familiaros configure --agent cursor --familiar <familiar-id> --cwd <project-path> --yes
+familiaros mcp --familiar <familiar-id>
 ```
 
 One-off fallback when the user does not want a global install:
 
 ```bash
-npx -y @open-pets/cli@latest status
+npx -y @familiaros/cli@latest status
 ```
 
 MCP package:
 
 ```bash
-npx -y @open-pets/mcp@latest --pet <pet-id>
+npx -y @familiaros/mcp@latest --familiar <familiar-id>
 ```
 
-Pet catalog:
+Familiar catalog:
 
 ```text
-https://openpets.dev/pets/catalog.v3.json
+https://familiaros.dev/familiars/catalog.v3.json
 ```
 
 For search, fetch `catalog.v3.json`, then fetch its `search` URL and the listed search pages. Use matching search entries' `catalogPage` values to fetch `catalog.v3/page-XXX.json` pages for install metadata.
diff --git a/skills/openpets/references/config-files.md b/skills/openpets/references/config-files.md
index 2af84b6c..fa4a8aa1 100644
--- a/skills/openpets/references/config-files.md
+++ b/skills/openpets/references/config-files.md
@@ -1,20 +1,20 @@
 # Config Files
 
-Prefer official OpenPets configure commands over manual edits.
+Prefer official FamiliarOS configure commands over manual edits.
 
 ## Claude Code
 
 ```text
 ~/.claude/settings.json
 ~/.claude/CLAUDE.md
-~/.claude/openpets.md
+~/.claude/familiaros.md
 <project>/.claude/settings.local.json
 ```
 
 Project command:
 
 ```bash
-openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent claude --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
 ## OpenCode
@@ -23,16 +23,16 @@ openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
 ~/.config/opencode/opencode.json
 ~/.config/opencode/opencode.jsonc
 <project>/.opencode/opencode.jsonc
-<project>/.opencode/openpets.md
+<project>/.opencode/familiaros.md
 ```
 
 Project command:
 
 ```bash
-openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent opencode --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
-If the CLI is not installed globally, replace `openpets` with `npx -y @open-pets/cli@latest`.
+If the CLI is not installed globally, replace `familiaros` with `npx -y @familiaros/cli@latest`.
 
 ## Restart required
 
diff --git a/skills/openpets/references/integrations.md b/skills/openpets/references/integrations.md
index ea4c2126..b9c68dcd 100644
--- a/skills/openpets/references/integrations.md
+++ b/skills/openpets/references/integrations.md
@@ -2,18 +2,18 @@
 
 ## MCP
 
-OpenPets MCP exposes:
+FamiliarOS MCP exposes:
 
 ```text
-openpets_status
-openpets_react
-openpets_say
+familiaros_status
+familiaros_react
+familiaros_say
 ```
 
 Server command:
 
 ```bash
-npx -y @open-pets/mcp@latest --pet <pet-id>
+npx -y @familiaros/mcp@latest --familiar <familiar-id>
 ```
 
 ## Claude Code
@@ -21,7 +21,7 @@ npx -y @open-pets/mcp@latest --pet <pet-id>
 Use the CLI configure flow:
 
 ```bash
-openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent claude --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
 Claude hooks are optional and should not be changed without user approval.
@@ -31,7 +31,7 @@ Claude hooks are optional and should not be changed without user approval.
 Use the CLI configure flow:
 
 ```bash
-openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent opencode --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
 OpenCode usually requires restart after config changes.
@@ -41,7 +41,7 @@ OpenCode usually requires restart after config changes.
 Prefer the official configure flow when available. Otherwise configure an MCP server using:
 
 ```bash
-npx -y @open-pets/mcp@latest --pet <pet-id>
+npx -y @familiaros/mcp@latest --familiar <familiar-id>
 ```
 
-If the CLI is not installed globally, replace `openpets` with `npx -y @open-pets/cli@latest`.
+If the CLI is not installed globally, replace `familiaros` with `npx -y @familiaros/cli@latest`.
diff --git a/skills/openpets/references/source-docs.md b/skills/openpets/references/source-docs.md
index 0460db5e..26e63906 100644
--- a/skills/openpets/references/source-docs.md
+++ b/skills/openpets/references/source-docs.md
@@ -5,8 +5,8 @@ Treat the public docs as canonical when details may have changed.
 Recommended public references:
 
 ```text
-https://openpets.dev
-https://openpets.dev/pets/catalog.v3.json
+https://familiaros.dev
+https://familiaros.dev/familiars/catalog.v3.json
 ```
 
 Repository docs/source pages to keep this skill synced with:
@@ -14,7 +14,7 @@ Repository docs/source pages to keep this skill synced with:
 ```text
 web/content/en/docs/install.md
 web/content/en/docs/quickstart.md
-web/content/en/docs/pets.md
+web/content/en/docs/familiars.md
 web/content/en/docs/cli.md
 web/content/en/docs/mcp.md
 web/content/en/docs/troubleshooting.md
@@ -26,5 +26,5 @@ web/content/en/integrations/opencode.md
 Bug reports:
 
 ```text
-https://github.com/alvinunreal/openpets/issues
+https://github.com/alvinunreal/familiaros/issues
 ```
diff --git a/skills/openpets/workflows/configure-project.md b/skills/openpets/workflows/configure-project.md
index 218bc1ec..a1a20078 100644
--- a/skills/openpets/workflows/configure-project.md
+++ b/skills/openpets/workflows/configure-project.md
@@ -1,25 +1,25 @@
 # Configure a Project
 
-Use this workflow when the user asks to configure the current project or a named project to use OpenPets.
+Use this workflow when the user asks to configure the current project or a named project to use FamiliarOS.
 
 ## Questions to confirm
 
 - Which agent/client should be configured? Common values: `claude`, `opencode`, `cursor`.
 - Which project path should be configured?
-- Which pet should be selected? If the user has not chosen one, list installed pets and use the catalog API to help them choose or install one.
+- Which familiar should be selected? If the user has not chosen one, list installed familiars and use the catalog API to help them choose or install one.
 - Is it okay to update project-local config files?
 
 ## Before configuring
 
-Make sure the selected pet exists locally. If the user did not provide a pet id, start by listing installed pets:
+Make sure the selected familiar exists locally. If the user did not provide a familiar id, start by listing installed familiars:
 
 ```bash
-openpets pets
+familiaros familiars
 ```
 
-If the user wants a pet that is not installed, use the catalog API to confirm the pet id, then install it before writing project config.
+If the user wants a familiar that is not installed, use the catalog API to confirm the familiar id, then install it before writing project config.
 
-- https://openpets.dev/pets/catalog.v3.json
+- https://familiaros.dev/familiars/catalog.v3.json
 
 Catalog search flow:
 
@@ -30,13 +30,13 @@ Catalog search flow:
 5. Fetch the matching entry's `catalogPage` from `catalog.v3/page-XXX.json` to get install metadata.
 
 ```bash
-openpets install <pet-id>
+familiaros install <familiar-id>
 ```
 
 ## Claude Code
 
 ```bash
-openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent claude --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
 Potential files:
@@ -45,20 +45,20 @@ Potential files:
 <project>/.claude/settings.local.json
 ~/.claude/settings.json
 ~/.claude/CLAUDE.md
-~/.claude/openpets.md
+~/.claude/familiaros.md
 ```
 
 ## OpenCode
 
 ```bash
-openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent opencode --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
 Potential files:
 
 ```text
 <project>/.opencode/opencode.jsonc
-<project>/.opencode/openpets.md
+<project>/.opencode/familiaros.md
 ~/.config/opencode/opencode.json
 ~/.config/opencode/opencode.jsonc
 ```
@@ -66,13 +66,13 @@ Potential files:
 ## Cursor
 
 ```bash
-openpets configure --agent cursor --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent cursor --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
 ## Safety
 
 - Use `--force` only after explicit approval.
 - Prefer project-local configuration when the user asks “for this project”.
-- Do not configure a project for a pet that is not installed; install it first.
+- Do not configure a project for a familiar that is not installed; install it first.
 - Ask the user to restart their agent/client after config changes.
-- If the CLI is not installed globally, replace `openpets` with `npx -y @open-pets/cli@latest`.
+- If the CLI is not installed globally, replace `familiaros` with `npx -y @familiaros/cli@latest`.
diff --git a/skills/openpets/workflows/explain-architecture.md b/skills/openpets/workflows/explain-architecture.md
index 3013991f..5277da11 100644
--- a/skills/openpets/workflows/explain-architecture.md
+++ b/skills/openpets/workflows/explain-architecture.md
@@ -1,29 +1,29 @@
-# Explain OpenPets Architecture
+# Explain FamiliarOS Architecture
 
-Use this workflow when the user asks how OpenPets works.
+Use this workflow when the user asks how FamiliarOS works.
 
 ## Short explanation
 
-OpenPets is a local desktop companion app. Coding agents do not directly draw pets; they call local tools or CLI commands. Those commands talk to the desktop app over local IPC, and the desktop app controls the visible pet.
+FamiliarOS is a local desktop companion app. Coding agents do not directly draw familiars; they call local tools or CLI commands. Those commands talk to the desktop app over local IPC, and the desktop app controls the visible familiar.
 
 ## Flow
 
 ```text
 Agent/client
   -> MCP server, plugin, hook, or CLI
-  -> @open-pets/client
+  -> @familiaros/client
   -> local IPC discovery/token
-  -> OpenPets desktop app
-  -> pet window and animation state
+  -> FamiliarOS desktop app
+  -> familiar window and animation state
 ```
 
 ## Integration roles
 
-- MCP exposes `openpets_status`, `openpets_react`, and `openpets_say`.
-- CLI performs setup, pet installation, status checks, and MCP server launch.
+- MCP exposes `familiaros_status`, `familiaros_react`, and `familiaros_say`.
+- CLI performs setup, familiar installation, status checks, and MCP server launch.
 - Claude/OpenCode integrations add the right MCP/plugin/hook configuration and instructions.
-- The desktop app owns pet display, catalog installs, IPC, and routing to the selected/default pet.
+- The desktop app owns familiar display, catalog installs, IPC, and routing to the selected/default familiar.
 
 ## Privacy note
 
-Pet controls are intended to be local. Avoid sending sensitive text as pet speech.
+Familiar controls are intended to be local. Avoid sending sensitive text as familiar speech.
diff --git a/skills/openpets/workflows/install-openpets.md b/skills/openpets/workflows/install-openpets.md
index 25bb79c6..551aba44 100644
--- a/skills/openpets/workflows/install-openpets.md
+++ b/skills/openpets/workflows/install-openpets.md
@@ -1,30 +1,30 @@
-# Install OpenPets
+# Install FamiliarOS
 
-Use this workflow when the user asks to install or start using OpenPets.
+Use this workflow when the user asks to install or start using FamiliarOS.
 
 ## Steps
 
 1. Identify the user's OS if needed.
-2. Direct the user to install the desktop app from the official OpenPets website/docs.
+2. Direct the user to install the desktop app from the official FamiliarOS website/docs.
 3. Ask the user to launch the desktop app and complete first-run onboarding.
-4. Install the CLI if the user wants the clean `openpets` command:
+4. Install the CLI if the user wants the clean `familiaros` command:
 
 ```bash
-npm install -g @open-pets/cli
+npm install -g @familiaros/cli
 ```
 
 5. Verify the app is reachable:
 
 ```bash
-openpets status
+familiaros status
 ```
 
-   One-off fallback: `npx -y @open-pets/cli@latest status`.
+   One-off fallback: `npx -y @familiaros/cli@latest status`.
 
-6. If an MCP-capable agent is already configured, verify with `openpets_status`.
+6. If an MCP-capable agent is already configured, verify with `familiaros_status`.
 
 ## Notes
 
-- The desktop app must be running for live pet control.
+- The desktop app must be running for live familiar control.
 - If status cannot connect, check that the app is open and that local IPC is not blocked.
-- If installation repeatedly fails, ask the user to report the issue at https://github.com/alvinunreal/openpets/issues with OS/version details.
+- If installation repeatedly fails, ask the user to report the issue at https://github.com/alvinunreal/familiaros/issues with OS/version details.
diff --git a/skills/openpets/workflows/install-pet.md b/skills/openpets/workflows/install-pet.md
index e12517f7..150209f4 100644
--- a/skills/openpets/workflows/install-pet.md
+++ b/skills/openpets/workflows/install-pet.md
@@ -1,34 +1,34 @@
-# Install a Pet
+# Install a Familiar
 
-Use this workflow when the user asks to install a pet such as “install pet fox”.
+Use this workflow when the user asks to install a familiar such as “install familiar fox”.
 
 ## Steps
 
-1. Confirm the pet id.
-2. If the pet id is unclear, search the catalog API rather than scraping the website.
-   - https://openpets.dev/pets/catalog.v3.json
+1. Confirm the familiar id.
+2. If the familiar id is unclear, search the catalog API rather than scraping the website.
+   - https://familiaros.dev/familiars/catalog.v3.json
 3. Ensure the desktop app is running.
-4. Install the pet:
+4. Install the familiar:
 
 ```bash
-openpets install <pet-id>
+familiaros install <familiar-id>
 ```
 
-5. Verify available pets:
+5. Verify available familiars:
 
 ```bash
-openpets pets
+familiaros familiars
 ```
 
 6. Optionally verify status:
 
 ```bash
-openpets status
+familiaros status
 ```
 
-If the CLI is not installed globally, replace `openpets` with `npx -y @open-pets/cli@latest`.
+If the CLI is not installed globally, replace `familiaros` with `npx -y @familiaros/cli@latest`.
 
 ## Notes
 
-- Do not hard-code current pet IDs in answers; use the live catalog API when uncertain.
-- If the catalog or zip download fails, mention network access to `openpets.dev` and `zip.openpets.dev` may be required.
+- Do not hard-code current familiar IDs in answers; use the live catalog API when uncertain.
+- If the catalog or zip download fails, mention network access to `familiaros.dev` and `zip.familiaros.dev` may be required.
diff --git a/skills/openpets/workflows/troubleshoot.md b/skills/openpets/workflows/troubleshoot.md
index 98e17aba..8e886837 100644
--- a/skills/openpets/workflows/troubleshoot.md
+++ b/skills/openpets/workflows/troubleshoot.md
@@ -1,6 +1,6 @@
-# Troubleshoot OpenPets
+# Troubleshoot FamiliarOS
 
-Use this workflow when setup or pet control is not working.
+Use this workflow when setup or familiar control is not working.
 
 ## Fast checklist
 
@@ -8,33 +8,33 @@ Use this workflow when setup or pet control is not working.
 2. Does CLI status connect?
 
 ```bash
-openpets status
+familiaros status
 ```
 
-3. Are pets installed/listed?
+3. Are familiars installed/listed?
 
 ```bash
-openpets pets
+familiaros familiars
 ```
 
 4. Did the user restart Claude/OpenCode/MCP client after config changes?
 5. Is the correct project path configured?
-6. Is the selected pet id installed?
-7. Can the machine reach `openpets.dev` and `zip.openpets.dev` for catalog/zip downloads?
+6. Is the selected familiar id installed?
+7. Can the machine reach `familiaros.dev` and `zip.familiaros.dev` for catalog/zip downloads?
 
 ## Common fixes
 
-- Launch or relaunch the OpenPets desktop app.
-- Re-run the relevant `openpets configure ...` command.
+- Launch or relaunch the FamiliarOS desktop app.
+- Re-run the relevant `familiaros configure ...` command.
 - Restart the agent/client after changing MCP/plugin/hook config.
-- Use the catalog API to confirm pet ids: https://openpets.dev/pets/catalog.v3.json
+- Use the catalog API to confirm familiar ids: https://familiaros.dev/familiars/catalog.v3.json
 
-If the CLI is not installed globally, replace `openpets` with `npx -y @open-pets/cli@latest`.
+If the CLI is not installed globally, replace `familiaros` with `npx -y @familiaros/cli@latest`.
 
 ## Bug reports
 
 If normal troubleshooting does not resolve the issue, encourage the user to open an issue at:
 
-https://github.com/alvinunreal/openpets/issues
+https://github.com/alvinunreal/familiaros/issues
 
 Ask them to include OS, app version, agent/client, command attempted, and a short description of what happened. Do not ask them to paste secrets or private logs.
diff --git a/skills/openpets/workflows/verify-claude.md b/skills/openpets/workflows/verify-claude.md
index f6a54797..3e9461ce 100644
--- a/skills/openpets/workflows/verify-claude.md
+++ b/skills/openpets/workflows/verify-claude.md
@@ -1,6 +1,6 @@
 # Verify Claude Code
 
-Use this workflow when the user asks whether Claude Code is connected to OpenPets.
+Use this workflow when the user asks whether Claude Code is connected to FamiliarOS.
 
 ## Steps
 
@@ -10,26 +10,26 @@ Use this workflow when the user asks whether Claude Code is connected to OpenPet
 claude --version
 ```
 
-2. Check the OpenPets MCP entry:
+2. Check the FamiliarOS MCP entry:
 
 ```bash
 claude mcp list
-claude mcp get openpets
+claude mcp get familiaros
 ```
 
 3. If configuration is missing, configure it:
 
 ```bash
-openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent claude --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
-If the CLI is not installed globally, replace `openpets` with `npx -y @open-pets/cli@latest`.
+If the CLI is not installed globally, replace `familiaros` with `npx -y @familiaros/cli@latest`.
 
 4. Ask the user to restart Claude Code.
-5. Verify from Claude with the MCP tool `openpets_status`.
+5. Verify from Claude with the MCP tool `familiaros_status`.
 
 ## Hooks
 
 Claude hooks are optional. Do not install or modify hooks unless the user asks for automatic reactions/status behavior.
 
-If hooks are requested, prefer the official OpenPets configure flow or OpenPets Claude tooling instead of manual edits.
+If hooks are requested, prefer the official FamiliarOS configure flow or FamiliarOS Claude tooling instead of manual edits.
diff --git a/skills/openpets/workflows/verify-mcp.md b/skills/openpets/workflows/verify-mcp.md
index 644ab10a..b08bfffa 100644
--- a/skills/openpets/workflows/verify-mcp.md
+++ b/skills/openpets/workflows/verify-mcp.md
@@ -4,12 +4,12 @@ Use this workflow when MCP tools are missing or unavailable.
 
 ## Expected tools
 
-OpenPets MCP exposes:
+FamiliarOS MCP exposes:
 
 ```text
-openpets_status
-openpets_react
-openpets_say
+familiaros_status
+familiaros_react
+familiaros_say
 ```
 
 ## Server command
@@ -17,23 +17,23 @@ openpets_say
 For MCP client configuration, use:
 
 ```bash
-npx -y @open-pets/mcp@latest --pet <pet-id>
+npx -y @familiaros/mcp@latest --familiar <familiar-id>
 ```
 
 or through the CLI:
 
 ```bash
-openpets mcp --pet <pet-id>
+familiaros mcp --familiar <familiar-id>
 ```
 
-If the CLI is not installed globally, replace `openpets` with `npx -y @open-pets/cli@latest`.
+If the CLI is not installed globally, replace `familiaros` with `npx -y @familiaros/cli@latest`.
 
 ## Checklist
 
 1. Confirm the desktop app is running.
-2. Confirm the MCP client has an OpenPets server entry.
-3. Confirm the server command uses `npx -y @open-pets/mcp@latest --pet <pet-id>` or equivalent.
+2. Confirm the MCP client has an FamiliarOS server entry.
+3. Confirm the server command uses `npx -y @familiaros/mcp@latest --familiar <familiar-id>` or equivalent.
 4. Restart the MCP client.
-5. Call `openpets_status`.
+5. Call `familiaros_status`.
 
-If `openpets_status` says the desktop app or local IPC is unavailable, focus on the desktop app/runtime rather than MCP config.
+If `familiaros_status` says the desktop app or local IPC is unavailable, focus on the desktop app/runtime rather than MCP config.
diff --git a/skills/openpets/workflows/verify-opencode.md b/skills/openpets/workflows/verify-opencode.md
index 885b16ed..54184a0a 100644
--- a/skills/openpets/workflows/verify-opencode.md
+++ b/skills/openpets/workflows/verify-opencode.md
@@ -1,6 +1,6 @@
 # Verify OpenCode
 
-Use this workflow when the user asks whether OpenCode is connected to OpenPets.
+Use this workflow when the user asks whether OpenCode is connected to FamiliarOS.
 
 ## Steps
 
@@ -8,14 +8,14 @@ Use this workflow when the user asks whether OpenCode is connected to OpenPets.
 2. For project-local setup, configure with:
 
 ```bash
-openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
+familiaros configure --agent opencode --familiar <familiar-id> --cwd <project-path> --yes
 ```
 
 3. Check likely project files if needed:
 
 ```text
 <project>/.opencode/opencode.jsonc
-<project>/.opencode/openpets.md
+<project>/.opencode/familiaros.md
 ```
 
 4. Check likely global files if needed:
@@ -26,15 +26,15 @@ openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
 ```
 
 5. Ask the user to quit and restart OpenCode.
-6. Verify with `openpets_status` or:
+6. Verify with `familiaros_status` or:
 
 ```bash
-openpets status
+familiaros status
 ```
 
-If the CLI is not installed globally, replace `openpets` with `npx -y @open-pets/cli@latest`.
+If the CLI is not installed globally, replace `familiaros` with `npx -y @familiaros/cli@latest`.
 
 ## Notes
 
 - OpenCode config is loaded at startup; changes are not usually hot-reloaded.
-- Prefer the OpenPets CLI configure command over manually editing OpenCode config.
+- Prefer the FamiliarOS CLI configure command over manually editing OpenCode config.