selftune 0.2.21 → 0.2.23

package/packages/ui/src/components/skill-health-grid.tsx

@@ -1,3 +1,4 @@
+import * as React from "react";
 import {
   closestCenter,
   DndContext,
@@ -33,27 +34,7 @@ import {
   type SortingState,
   type VisibilityState,
 } from "@tanstack/react-table";
-import {
-  GripVerticalIcon,
-  Columns3Icon,
-  ChevronDownIcon,
-  ChevronsLeftIcon,
-  ChevronLeftIcon,
-  ChevronRightIcon,
-  ChevronsRightIcon,
-  ClockIcon,
-  LayersIcon,
-  FilterIcon,
-  CheckCircleIcon,
-  AlertTriangleIcon,
-  XCircleIcon,
-  CircleDotIcon,
-  HelpCircleIcon,
-} from "lucide-react";
-import * as React from "react";
 
-import { STATUS_CONFIG } from "../lib/constants";
-import { formatRate, timeAgo } from "../lib/format";
 import { Badge } from "../primitives/badge";
 import { Button } from "../primitives/button";
 import { Checkbox } from "../primitives/checkbox";
@@ -76,7 +57,26 @@ import {
 } from "../primitives/select";
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "../primitives/table";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "../primitives/tabs";
+import { STATUS_CONFIG } from "../lib/constants";
 import type { SkillCard, SkillHealthStatus } from "../types";
+import { formatRate, timeAgo } from "../lib/format";
+import {
+  GripVerticalIcon,
+  Columns3Icon,
+  ChevronDownIcon,
+  ChevronsLeftIcon,
+  ChevronLeftIcon,
+  ChevronRightIcon,
+  ChevronsRightIcon,
+  ClockIcon,
+  LayersIcon,
+  FilterIcon,
+  CheckCircleIcon,
+  AlertTriangleIcon,
+  XCircleIcon,
+  CircleDotIcon,
+  HelpCircleIcon,
+} from "lucide-react";
 
 // ---------- Drag handle ----------
 
@@ -152,15 +152,27 @@ function createColumns(
       enableHiding: false,
     },
     {
-      accessorKey: "scope",
-      header: "Scope",
+      accessorKey: "platforms",
+      header: "Platforms",
       cell: ({ row }) => {
-        const scope = row.original.scope;
-        if (!scope) return <span className="text-xs text-muted-foreground">--</span>;
+        const platforms = row.original.platforms;
+        if (!platforms || platforms.length === 0) {
+          const scope = row.original.scope;
+          if (!scope) return <span className="text-xs text-muted-foreground">--</span>;
+          return (
+            <Badge variant="secondary" className="text-[10px]">
+              {scope}
+            </Badge>
+          );
+        }
         return (
-          <Badge variant="secondary" className="text-[10px]">
-            {scope}
-          </Badge>
+          <div className="flex flex-wrap gap-1">
+            {platforms.map((p) => (
+              <Badge key={p} variant="secondary" className="text-[10px]">
+                {p}
+              </Badge>
+            ))}
+          </div>
         );
       },
     },
@@ -349,7 +361,7 @@ export function SkillHealthGrid({
     } else if (activeView === "recent") {
       filtered = cards
         .filter((c) => c.lastSeen !== null)
-        .sort((a: SkillCard, b: SkillCard) => {
+        .sort((a, b) => {
           const aTime = a.lastSeen ? new Date(a.lastSeen).getTime() : 0;
           const bTime = b.lastSeen ? new Date(b.lastSeen).getTime() : 0;
           return bTime - aTime;
@@ -380,7 +392,7 @@ export function SkillHealthGrid({
       columnFilters,
       pagination,
     },
-    getRowId: (row) => row.name,
+    getRowId: (row) => row.id ?? row.name,
     enableRowSelection: true,
     onRowSelectionChange: setRowSelection,
     onSortingChange: setSorting,
@@ -395,10 +407,8 @@ export function SkillHealthGrid({
     getFacetedUniqueValues: getFacetedUniqueValues(),
   });
 
-  const dataIds = React.useMemo<UniqueIdentifier[]>(
-    () => table.getRowModel().rows.map((r) => r.id),
-    [table.getRowModel().rows],
-  );
+  const rows = table.getRowModel().rows;
+  const dataIds = React.useMemo<UniqueIdentifier[]>(() => rows.map((r) => r.id), [rows]);
 
   const isSorted = sorting.length > 0;
 
@@ -407,7 +417,7 @@ export function SkillHealthGrid({
     const { active, over } = event;
     if (active && over && active.id !== over.id) {
       setData((prev) => {
-        const ids = prev.map((d) => d.name);
+        const ids = prev.map((d) => d.id ?? d.name);
         const oldIndex = ids.indexOf(active.id as string);
         const newIndex = ids.indexOf(over.id as string);
         if (oldIndex === -1 || newIndex === -1) return prev;
@@ -537,8 +547,8 @@ export function SkillHealthGrid({
                     checked={column.getIsVisible()}
                     onCheckedChange={(value) => column.toggleVisibility(!!value)}
                   >
-                    {column.id === "scope"
-                      ? "Scope"
+                    {column.id === "platforms"
+                      ? "Platforms"
                       : column.id === "passRate"
                         ? "Pass Rate"
                         : column.id === "uniqueSessions"
@@ -559,7 +569,7 @@ export function SkillHealthGrid({
         value={activeView}
         className="relative flex flex-col gap-4 overflow-auto px-4 lg:px-6"
       >
-        <div className="overflow-hidden rounded-lg border">
+        <div className="overflow-hidden rounded-lg border border-border/15">
           <DndContext
             collisionDetection={closestCenter}
             modifiers={[restrictToVerticalAxis]}

package/packages/ui/src/lib/constants.tsx

@@ -5,7 +5,6 @@ import {
   HelpCircleIcon,
   XCircleIcon,
 } from "lucide-react";
-
 import type { SkillHealthStatus } from "../types";
 
 export const STATUS_CONFIG: Record<

package/packages/ui/src/primitives/card.tsx

@@ -12,7 +12,7 @@ function Card({
       data-slot="card"
       data-size={size}
       className={cn(
-        "group/card flex flex-col gap-4 overflow-hidden rounded-2xl bg-card py-4 text-sm text-card-foreground ring-1 ring-foreground/5 has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:gap-3 data-[size=sm]:py-3 data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
+        "group/card flex flex-col gap-4 overflow-hidden rounded-xl bg-muted py-4 text-sm text-card-foreground border border-border/15 shadow-none has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:gap-3 data-[size=sm]:py-3 data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
         className,
       )}
       {...props}

package/packages/ui/src/primitives/checkbox.tsx

@@ -1,7 +1,7 @@
 import { Checkbox as CheckboxPrimitive } from "@base-ui/react/checkbox";
-import { CheckIcon } from "lucide-react";
 
 import { cn } from "../lib/utils";
+import { CheckIcon } from "lucide-react";
 
 function Checkbox({ className, ...props }: CheckboxPrimitive.Root.Props) {
   return (

package/packages/ui/src/primitives/dropdown-menu.tsx

@@ -1,8 +1,8 @@
-import { Menu as MenuPrimitive } from "@base-ui/react/menu";
-import { ChevronRightIcon, CheckIcon } from "lucide-react";
 import * as React from "react";
+import { Menu as MenuPrimitive } from "@base-ui/react/menu";
 
 import { cn } from "../lib/utils";
+import { ChevronRightIcon, CheckIcon } from "lucide-react";
 
 function DropdownMenu({ ...props }: MenuPrimitive.Root.Props) {
   return <MenuPrimitive.Root data-slot="dropdown-menu" {...props} />;

package/packages/ui/src/primitives/select.tsx

@@ -1,8 +1,8 @@
-import { Select as SelectPrimitive } from "@base-ui/react/select";
-import { ChevronDownIcon, CheckIcon, ChevronUpIcon } from "lucide-react";
 import * as React from "react";
+import { Select as SelectPrimitive } from "@base-ui/react/select";
 
 import { cn } from "../lib/utils";
+import { ChevronDownIcon, CheckIcon, ChevronUpIcon } from "lucide-react";
 
 const Select = SelectPrimitive.Root;
 

package/packages/ui/src/types.ts

@@ -3,8 +3,10 @@
 export type SkillHealthStatus = "HEALTHY" | "WARNING" | "CRITICAL" | "UNGRADED" | "UNKNOWN";
 
 export interface SkillCard {
+  id?: string;
   name: string;
   scope: string | null;
+  platforms: string[];
   passRate: number | null;
   checks: number;
   status: SkillHealthStatus;
@@ -13,6 +15,32 @@ export interface SkillCard {
   lastSeen: string | null;
 }
 
+// -- Job execution types (re-declared for package independence) ---------------
+
+export interface JobExecution {
+  id: string;
+  jobName: string;
+  status: "success" | "error";
+  startedAt: string;
+  durationMs: number;
+  metrics: Record<string, unknown>;
+  error?: string;
+}
+
+export interface JobScheduleEntry {
+  name: string;
+  schedule: string;
+  cronExpression: string;
+  lastRunAt: string | null;
+  lastRunStatus: "success" | "error" | null;
+  lastRunDurationMs: number | null;
+  nextRunAt: string;
+}
+
+export interface JobScheduleState {
+  jobs: JobScheduleEntry[];
+}
+
 // -- Dashboard contract types (re-declared for package independence) ----------
 
 export interface EvalSnapshot {
@@ -31,10 +59,6 @@ export interface EvolutionEntry {
   action: string;
   details: string;
   eval_snapshot?: EvalSnapshot | null;
-  validation_mode?: "structural_guard" | "host_replay" | "llm_judge" | null;
-  validation_agent?: string | null;
-  validation_fixture_id?: string | null;
-  validation_evidence_ref?: string | null;
 }
 
 export interface UnmatchedQuery {
@@ -90,3 +114,147 @@ export interface OrchestrateRunReport {
   skipped: number;
   skill_actions: OrchestrateRunSkillAction[];
 }
+
+// -- Overview panel types (shared between local & cloud dashboards) ----------
+
+export type AutonomyStatusLevel = "healthy" | "watching" | "needs_review" | "blocked";
+
+export interface AutonomyStatus {
+  level: AutonomyStatusLevel;
+  summary: string;
+  skills_observed: number;
+  attention_required: number;
+  pending_reviews: number;
+}
+
+export type TrustBucket = "at_risk" | "improving" | "uncertain" | "stable";
+
+export interface TrustWatchlistEntry {
+  skill_name: string;
+  bucket: TrustBucket;
+  pass_rate: number | null;
+  reason: string;
+  last_seen: string | null;
+}
+
+export type AttentionSeverity = "critical" | "warning" | "info";
+
+export interface AttentionItem {
+  skill_name: string;
+  category: string;
+  severity: AttentionSeverity;
+  reason: string;
+  recommended_action: string;
+  timestamp: string | null;
+}
+
+export type DecisionKind =
+  | "proposal_created"
+  | "proposal_rejected"
+  | "validation_failed"
+  | "proposal_deployed"
+  | "rollback_triggered"
+  | "regression_found";
+
+export interface AutonomousDecision {
+  skill_name: string;
+  kind: DecisionKind;
+  summary: string;
+  timestamp: string;
+}
+
+// -- Trust / skill report types (shared between local & cloud dashboards) ----
+
+export type TrustState =
+  | "low_sample"
+  | "observed"
+  | "watch"
+  | "validated"
+  | "deployed"
+  | "rolled_back";
+
+export type ObservationKind =
+  | "canonical"
+  | "repaired_trigger"
+  | "repaired_contextual_miss"
+  | "legacy_materialized";
+
+export type HistoricalContext = "previously_missed";
+
+export interface ExampleRow {
+  timestamp: string | null;
+  session_id: string;
+  query_text: string;
+  triggered: boolean;
+  confidence: number | null;
+  invocation_mode: string | null;
+  prompt_kind: string | null;
+  source: string | null;
+  platform: string | null;
+  workspace_path: string | null;
+  query_origin: "inline_query" | "matched_prompt" | "missing";
+  is_system_like: boolean;
+  observation_kind: ObservationKind;
+  historical_context?: HistoricalContext | null;
+}
+
+export interface TrustFields {
+  trust: {
+    state: TrustState;
+    summary: string;
+  };
+  coverage: {
+    checks: number;
+    sessions: number;
+    workspaces: number;
+    first_seen: string | null;
+    last_seen: string | null;
+  };
+  evidence_quality: {
+    prompt_link_rate: number;
+    inline_query_rate: number;
+    user_prompt_rate: number;
+    meta_prompt_rate: number;
+    internal_prompt_rate: number;
+    no_prompt_rate: number;
+    system_like_rate: number;
+    invocation_mode_coverage: number;
+    confidence_coverage: number;
+    source_coverage: number;
+    scope_coverage: number;
+  };
+  routing_quality: {
+    missed_triggers: number;
+    miss_rate: number;
+    avg_confidence: number | null;
+    confidence_coverage: number;
+    low_confidence_rate: number | null;
+  };
+  evolution_state: {
+    has_evidence: boolean;
+    has_pending_proposals: boolean;
+    latest_action: string | null;
+    latest_timestamp: string | null;
+    evidence_rows: number;
+    evolution_rows: number;
+  };
+  data_hygiene: {
+    naming_variants: string[];
+    source_breakdown: Array<{ source: string; count: number }>;
+    prompt_kind_breakdown: Array<{ kind: string; count: number }>;
+    observation_breakdown: Array<{ kind: ObservationKind; count: number }>;
+    raw_checks: number;
+    operational_checks: number;
+    internal_prompt_rows: number;
+    internal_prompt_rate: number;
+    legacy_rows: number;
+    legacy_rate: number;
+    repaired_rows: number;
+    repaired_rate: number;
+  };
+  examples: {
+    good: ExampleRow[];
+    missed: ExampleRow[];
+    noisy: ExampleRow[];
+  };
+}

package/skill/SKILL.md

@@ -73,6 +73,7 @@ selftune ingest claude   [--since DATE] [--dry-run] [--force] [--verbose]
 selftune ingest codex                                                          # (experimental)
 selftune ingest opencode                                                       # (experimental)
 selftune ingest openclaw [--agents-dir PATH] [--since DATE] [--dry-run] [--force] [--verbose]  # (experimental)
+selftune ingest pi       [--sessions-dir PATH] [--since DATE] [--dry-run] [--force] [--verbose]  # (experimental)
 selftune ingest wrap-codex -- <codex args>                                     # (experimental)
 
 # Grade group
@@ -109,7 +110,7 @@ selftune export    [TABLE...] [--output/-o DIR] [--since DATE]
 
 # Autonomous loop
 selftune orchestrate [--dry-run] [--review-required] [--auto-approve] [--skill NAME] [--max-skills N] [--recent-window HOURS] [--sync-force] [--max-auto-grade N] [--loop] [--loop-interval SECS]
-selftune sync        [--since DATE] [--dry-run] [--force] [--no-claude] [--no-codex] [--no-opencode] [--no-openclaw] [--no-repair] [--json]
+selftune sync        [--since DATE] [--dry-run] [--force] [--no-claude] [--no-codex] [--no-opencode] [--no-openclaw] [--no-pi] [--no-repair] [--json]
 
 # Discovery + badges
 selftune workflows   [--skill NAME] [--skill-path PATH] [--min-occurrences N] [--window N] [--json] [save --skill NAME --skill-path PATH]
@@ -125,6 +126,25 @@ selftune uninstall          [--dry-run] [--keep-logs] [--npm-uninstall]
 # Hook dispatch (for debugging/manual invocation)
 selftune hook <name>   # prompt-log | session-stop | skill-eval | auto-activate | skill-change-guard | evolution-guard
 
+# Platform hooks (non-Claude-Code agents)
+selftune codex hook
+selftune codex install    [--dry-run] [--uninstall]
+selftune opencode hook
+selftune opencode install [--dry-run] [--uninstall]
+selftune cline hook
+selftune cline install    [--dry-run] [--uninstall]
+selftune pi hook
+selftune pi install       [--dry-run] [--uninstall]
+
+# Registry (team skill distribution)
+selftune registry push [name]      [--version=<semver>] [--summary=<text>]
+selftune registry install <name>   [--global]
+selftune registry sync
+selftune registry status
+selftune registry rollback <name>  [--to=<version>] [--reason=<text>]
+selftune registry history <name>
+selftune registry list
+
 # Alpha enrollment (device-code flow — browser opens automatically)
 selftune init --alpha --alpha-email <email>
 selftune alpha upload [--dry-run]
@@ -143,7 +163,7 @@ selftune status                                                        # shows c
 | evolve rollback, undo, restore, revert evolution, go back, undo last change                                                             | Rollback          | Workflows/Rollback.md                 |
 | watch, monitor, regression, post-deploy, keep an eye on                                                                                 | Watch             | Workflows/Watch.md                    |
 | doctor, health, hooks, broken, diagnose, not working, something wrong                                                                   | Doctor            | Workflows/Doctor.md                   |
-| ingest, import, codex logs, opencode, openclaw, wrap codex                                                                              | Ingest            | Workflows/Ingest.md                   |
+| ingest, import, codex logs, opencode, openclaw, pi, wrap codex                                                                          | Ingest            | Workflows/Ingest.md                   |
 | replay, backfill, claude transcripts, historical sessions                                                                               | Replay            | Workflows/Replay.md                   |
 | contributions, sharing preferences, opt in creator sharing, opt out creator sharing, approve contributions, revoke contributions, preview contributions, upload contributions, relay queue, contribution upload, contribution preview        | Contributions     | Workflows/Contributions.md            |
 | creator contributions, bundle contribution config, selftune.contribute.json, enable creator contribution, disable creator contribution, bulk enable creator contribution, enable all creator contributions, creator prefix config, --all, --prefix  | CreatorContributions | Workflows/CreatorContributions.md  |
@@ -169,6 +189,8 @@ selftune status                                                        # shows c
 | repair, rebuild usage, fix skill usage, trustworthy usage, repair-skill-usage                                                           | RepairSkillUsage  | Workflows/RepairSkillUsage.md         |
 | export canonical, canonical export, canonical telemetry, push payload                                                                   | ExportCanonical   | Workflows/ExportCanonical.md          |
 | hook, run hook, invoke hook, manual hook, debug hook                                                                                    | Hook              | Workflows/Hook.md                     |
+| codex hooks, codex install, codex setup, opencode hooks, opencode install, opencode setup, cline hooks, cline install, cline setup, pi hooks, pi install, pi setup, multi-platform, platform hooks, non-claude hooks, multiple agents, multi-agent | PlatformHooks     | Workflows/PlatformHooks.md            |
+| registry, distribute, push skill, install skill, sync skills, team skills, version control skills, rollback skill                       | Registry          | Workflows/Registry.md                 |
 | export, dump, jsonl, export sqlite, debug export                                                                                        | Export            | _(direct command — no workflow file)_ |
 | status, health summary, skill health, how are skills, skills doing, run selftune                                                        | Status            | _(direct command — no workflow file)_ |
 | last, last session, recent session, what happened, what changed                                                                         | Last              | _(direct command — no workflow file)_ |
@@ -357,10 +379,12 @@ accomplish a task _using_ a skill, route to that skill instead.
 | `Workflows/CreatorContributions.md` | Manage bundled `selftune.contribute.json` configs   | When preparing a skill package for creator contributions |
 | `Workflows/ExportCanonical.md`      | Export canonical telemetry for downstream use       | When exporting data for external consumption    |
 | `Workflows/Hook.md`                 | Manual hook invocation for debugging                | When debugging or testing hooks manually        |
+| `Workflows/PlatformHooks.md`        | Non-Claude-Code platform hook install/config        | When setting up Codex, OpenCode, Cline, or Pi hooks |
 | `references/logs.md`                | Log file formats (telemetry, usage, queries, audit) | When parsing or debugging log files             |
 | `references/grading-methodology.md` | 3-tier grading model, evidence standards            | When grading sessions or interpreting grades    |
 | `references/invocation-taxonomy.md` | 4 invocation types, coverage analysis               | When analyzing trigger coverage                 |
 | `references/interactive-config.md`  | Pre-flight config pattern, model tiers              | Before running mutating workflows               |
 | `references/setup-patterns.md`      | Platform-specific setup patterns                    | During complex setup scenarios                  |
+| `Workflows/Registry.md`            | Registry — team skill distribution commands         | When routing to registry workflow               |
 | `settings_snippet.json`             | Claude Code hook configuration template             | During initialization                           |
 | `assets/*.json`                     | Config templates (activation rules, settings)       | During initialization                           |

package/skill/Workflows/Ingest.md

@@ -3,8 +3,8 @@
 > **Note:** Claude Code is the fully supported platform. Codex, OpenCode, and OpenClaw adapters are experimental and may have gaps.
 
 Import sessions from agent platforms into the shared selftune log format.
-Covers five sub-commands: `ingest claude`, `ingest codex`, `ingest opencode`,
-`ingest openclaw`, and `ingest wrap-codex`.
+Covers six sub-commands: `ingest claude`, `ingest codex`, `ingest opencode`,
+`ingest openclaw`, `ingest pi`, and `ingest wrap-codex`.
 
 ## When to Use Each
 
@@ -14,6 +14,7 @@ Covers five sub-commands: `ingest claude`, `ingest codex`, `ingest opencode`,
 | `ingest codex`      | Codex       | Batch     | Import existing Codex rollout logs                  |
 | `ingest opencode`   | OpenCode    | Batch     | Import existing OpenCode sessions                   |
 | `ingest openclaw`   | OpenClaw    | Batch     | Import existing OpenClaw agent sessions             |
+| `ingest pi`         | Pi          | Batch     | Import existing Pi agent sessions                   |
 | `ingest wrap-codex` | Codex       | Real-time | Wrap `codex exec` to capture telemetry live         |
 
 ---
@@ -200,6 +201,55 @@ Writes to:
 
 ---
 
+## ingest pi
+
+Batch ingest Pi agent session histories into the shared JSONL schema.
+
+### Default Command
+
+```bash
+selftune ingest pi
+```
+
+### Options
+
+| Flag                    | Description                                                        |
+| ----------------------- | ------------------------------------------------------------------ |
+| `--sessions-dir <path>` | Override default `~/.pi/agent/sessions/` directory                |
+| `--since <date>`        | Only ingest sessions modified after this date (e.g., `2026-01-01`) |
+| `--dry-run`             | Show what would be ingested without writing to logs                |
+| `--force`               | Re-ingest all sessions, ignoring the marker file                   |
+| `--verbose` / `-v`      | Show per-session progress during ingestion                         |
+
+### Source
+
+Reads from `~/.pi/agent/sessions/`. Each session file contains Pi agent
+conversation history in JSONL format.
+
+### Output
+
+Writes to:
+
+- `~/.claude/all_queries_log.jsonl` -- extracted user queries
+- `~/.claude/session_telemetry_log.jsonl` -- per-session metrics with `source: "pi"`
+- `~/.claude/skill_usage_log.jsonl` -- skill triggers with `source: "pi"`
+
+### Steps
+
+1. Run `selftune ingest pi --dry-run` to preview what would be ingested
+2. Run `selftune ingest pi` to ingest all sessions
+3. Run `selftune doctor` to confirm logs are healthy
+4. Run `selftune eval generate --list-skills` to see if the ingested sessions appear
+
+### Notes
+
+- Idempotent: uses a marker file to track which sessions have already been ingested.
+  Safe to run repeatedly. Use `--force` to re-ingest everything.
+- Skill detection heuristic: identifies skills by checking for `SKILL.md` file reads in
+  tool calls and by matching known skill names in assistant text content.
+
+---
+
 ## ingest wrap-codex
 
 Wrap `codex exec` with real-time telemetry capture. Drop-in replacement
@@ -269,6 +319,14 @@ through hooks.
 
 > Run `selftune ingest openclaw --since 2026-02-01` with an appropriate date.
 
+**"Ingest Pi sessions"**
+
+> Run `selftune ingest pi`. Reads from `~/.pi/agent/sessions/` automatically.
+
+**"Import only recent Pi sessions"**
+
+> Run `selftune ingest pi --since 2026-02-01` with an appropriate date.
+
 **"Run codex through selftune"**
 
 > Use `selftune ingest wrap-codex -- <codex args>` instead of `codex exec <args>` directly.

package/skill/Workflows/Initialize.md

@@ -6,7 +6,8 @@ Bootstrap selftune for first-time use or after changing environments.
 
 - The user asks to set up selftune, configure selftune, or initialize selftune
 - The agent detects `~/.selftune/config.json` does not exist
-- The user has switched agent platforms (Claude Code, Codex, OpenCode)
+- The user has switched agent platforms (Claude Code, Codex, OpenCode, Pi)
+- The user wants to add hooks for additional platforms (multi-agent setup)
 
 ## Default Command
 
@@ -20,7 +21,7 @@ selftune init --no-alpha [--force]
 
 | Flag                      | Description                                                               | Default       |
 | ------------------------- | ------------------------------------------------------------------------- | ------------- |
-| `--agent <type>`          | Agent platform: `claude_code`, `codex`, `opencode`, `openclaw`            | Auto-detected |
+| `--agent <type>`          | Agent platform: `claude_code`, `codex`, `opencode`, `openclaw`, `pi`      | Auto-detected |
 | `--cli-path <path>`       | Override auto-detected CLI entry-point path                               | Auto-detected |
 | `--force`                 | Reinitialize even if config already exists                                | Off           |
 | `--no-sync`               | Skip historical transcript backfill during init                           | Sync on       |
@@ -136,15 +137,52 @@ Code subagent calls stay up to date.
 | `PostToolUse` (Bash)       | `hooks/commit-track.ts`       | Track git commits for session traceability      | Fast-path: skips non-git Bash commands          |
 | `Stop`                     | `hooks/session-stop.ts`       | Capture session telemetry                       | Runs async (non-blocking), 60s timeout          |
 
-**Codex agents:**
+### 4b. Multi-Platform Hooks
 
-- Use `selftune ingest wrap-codex` for real-time telemetry capture (see `Workflows/Ingest.md`)
-- Or batch-ingest existing sessions with `selftune ingest codex`
+After Claude Code hooks are installed, check whether the user has **other** agent
+CLIs available. Run these checks:
 
-**OpenCode agents:**
+```bash
+which codex 2>/dev/null && echo "codex available"
+which opencode 2>/dev/null && echo "opencode available"
+ls ~/Documents/Cline/Hooks/ 2>/dev/null && echo "cline available"
+ls ~/.pi/agent/ 2>/dev/null && echo "pi available"
+```
+
+If **any** additional platforms are detected, use `AskUserQuestion` listing only
+the platforms that were actually found:
+
+> I detected these agent platforms in addition to your primary one:
+> - [list only detected platforms, e.g. "Codex", "OpenCode"]
+>
+> Would you like to install selftune hooks for any of them? This enables
+> real-time skill tracking across all your agents.
+
+Options:
+- `Yes — install hooks for all detected platforms`
+- `Let me pick — show me the list` (then present only the detected platforms)
+- `No — skip for now` (they can always run `selftune <platform> install` later)
+
+For each platform the user selects, run the install command:
+
+```bash
+selftune codex install      # writes hooks.json entries
+selftune opencode install   # writes shell shim + config entries
+selftune cline install      # creates hook scripts
+selftune pi install         # creates extension hook scripts
+```
+
+Use `--dry-run` first if the user wants to preview. See `Workflows/PlatformHooks.md`
+for platform-specific details.
+
+**Batch ingest** fallback for platforms without real-time hooks or to backfill history:
 
-- Use `selftune ingest opencode` to import sessions from the SQLite database
-- See `Workflows/Ingest.md` for details
+```bash
+selftune ingest codex       # import Codex rollout sessions
+selftune ingest opencode    # import OpenCode sessions from SQLite
+selftune ingest openclaw    # import OpenClaw sessions
+selftune ingest pi          # import Pi sessions
+```
 
 ### 5. Initialize Memory Directory
 
@@ -186,7 +224,7 @@ reported issues before proceeding.
 
 Init automatically runs `selftune sync` to backfill existing session
 transcripts into the SQLite database. This replays Claude Code transcripts,
-Codex rollouts, OpenCode sessions, and OpenClaw sessions so the eval set
+Codex rollouts, OpenCode sessions, OpenClaw sessions, and Pi sessions so the eval set
 and evolution pipeline have data to work with immediately.
 
 The sync step is fail-open — if it encounters errors, init continues.
@@ -387,6 +425,13 @@ retrying with `selftune init --alpha --alpha-email <email> --force`.
 > and optional display name in chat, then run `selftune init --alpha --alpha-email ...`.
 > The browser opens automatically for approval. No manual key management needed.
 
+**User uses multiple agents (Claude Code + Codex, etc.)**
+
+> Run `selftune init` for the primary agent, then offer to install hooks for
+> additional detected platforms. Run `selftune codex install`, `selftune opencode install`,
+> `selftune cline install`, or `selftune pi install` as needed. All platforms
+> write to the same shared log schema — no extra config required.
+
 **Hooks not capturing data**
 
 > Run `selftune doctor` to check hook installation. Parse the JSON output