oh-my-opencode 5.0.0-beta.5 → 5.0.0-beta.51

package/dist/mcp/index.d.ts

@@ -1,8 +1,6 @@
 import { createWebsearchConfig } from "./websearch";
-import { type CodegraphMcpConfigOptions } from "./codegraph";
 import { type LocalMcpConfig } from "./lsp";
 import type { RuntimeExecutableResolver } from "./runtime-executable";
-import type { CodegraphConfig } from "../config/schema/codegraph";
 export { McpNameSchema, type McpName } from "./types";
 type RemoteMcpConfig = {
     type: "remote";
@@ -13,12 +11,10 @@ type RemoteMcpConfig = {
 };
 type BuiltinMcpConfig = RemoteMcpConfig | LocalMcpConfig;
 type BuiltinMcpOptions = {
-    readonly codegraph?: Pick<CodegraphMcpConfigOptions, "env" | "fileExists" | "homeDir" | "provisioned" | "requireResolve">;
     readonly cwd?: string;
     readonly resolveExecutable?: RuntimeExecutableResolver;
 };
 type BuiltinMcpSourceConfig = {
-    readonly codegraph?: Partial<CodegraphConfig>;
     readonly disabled_tools?: readonly string[];
     readonly websearch?: Parameters<typeof createWebsearchConfig>[0];
 };

package/dist/mcp/types.d.ts

@@ -1,6 +1,5 @@
 import { z } from "zod";
 export declare const McpNameSchema: z.ZodEnum<{
-    codegraph: "codegraph";
     context7: "context7";
     grep_app: "grep_app";
     lsp: "lsp";

package/dist/oh-my-opencode.schema.json

@@ -61,7 +61,7 @@
         "enum": [
           "goal",
           "refactor",
-          "start-work",
+          "ulw-execute",
           "stop-continuation",
           "remove-ai-slops",
           "hyperplan"
@@ -90,7 +90,7 @@
       "type": "boolean"
     },
     "telemetry": {
-      "description": "Enable or disable anonymous telemetry. Default: enabled when omitted. Set to false to disable. Independent of codegraph.telemetry.",
+      "description": "Enable or disable anonymous telemetry. Default: enabled when omitted. Set to false to disable.",
       "type": "boolean"
     },
     "model_fallback": {
@@ -9206,7 +9206,7 @@
       "properties": {
         "defaultConcurrency": {
           "type": "number",
-          "minimum": 1
+          "minimum": 0
         },
         "providerConcurrency": {
           "type": "object",
@@ -9233,6 +9233,11 @@
           "minimum": 1,
           "maximum": 9007199254740991
         },
+        "maxLiveDescendantsPerRoot": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
         "staleTimeoutMs": {
           "type": "number",
           "minimum": 60000
@@ -9544,50 +9549,6 @@
       ],
       "additionalProperties": false
     },
-    "codegraph": {
-      "type": "object",
-      "properties": {
-        "auto_init": {
-          "default": true,
-          "type": "boolean"
-        },
-        "auto_provision": {
-          "default": true,
-          "type": "boolean"
-        },
-        "daemon": {
-          "default": true,
-          "type": "boolean"
-        },
-        "enabled": {
-          "default": true,
-          "type": "boolean"
-        },
-        "excluded_roots": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "install_dir": {
-          "type": "string"
-        },
-        "telemetry": {
-          "type": "boolean"
-        },
-        "watch_debounce_ms": {
-          "type": "number",
-          "minimum": 0
-        }
-      },
-      "required": [
-        "auto_init",
-        "auto_provision",
-        "daemon",
-        "enabled"
-      ],
-      "additionalProperties": false
-    },
     "team_mode": {
       "type": "object",
       "properties": {
@@ -9890,6 +9851,19 @@
       },
       "additionalProperties": false
     },
+    "ulw_execute": {
+      "type": "object",
+      "properties": {
+        "auto_commit": {
+          "default": true,
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "auto_commit"
+      ],
+      "additionalProperties": false
+    },
     "start_work": {
       "type": "object",
       "properties": {

package/dist/plugin/chat-message/types.d.ts

@@ -19,7 +19,7 @@ export type ChatMessageInput = {
         readonly modelID: string;
     };
 };
-export type StartWorkHookOutput = {
+export type UlwExecuteHookOutput = {
     readonly parts: Array<{
         readonly type: string;
         readonly text?: string;
@@ -29,7 +29,7 @@ export type SessionModelOverride = {
     readonly providerID: string;
     readonly modelID: string;
 };
-export type WorkStartingCommand = "start-work" | "ralph-loop" | "ulw-loop";
+export type WorkStartingCommand = "ulw-execute" | "ralph-loop" | "ulw-loop";
 type ChatMessageHook = {
     "chat.message"?: (input: ChatMessageInput, output: ChatMessageHandlerOutput) => Promise<void>;
 };
@@ -77,7 +77,7 @@ export type ChatMessageHooks = {
     noSisyphusGpt?: ChatMessageHook | null;
     noHephaestusNonGpt?: ChatMessageHook | null;
     hephaestusAgentsMdInjector?: ChatMessageHook | null;
-    startWork?: ChatMessageHook | null;
+    ulwExecute?: ChatMessageHook | null;
     goal?: GoalHook | null;
     todoContinuationEnforcer?: TodoContinuationEnforcerHook | null;
 };

package/dist/plugin/chat-message/ulw-execute-message.d.ts

@@ -0,0 +1,5 @@
+import type { ChatMessageHooks, ChatMessageInput, ChatMessageHandlerOutput, UlwExecuteHookOutput, WorkStartingCommand } from "./types";
+export declare function isUlwExecuteHookOutput(value: unknown): value is UlwExecuteHookOutput;
+export declare function isUlwExecuteFallbackTemplate(promptText: string): boolean;
+export declare function clearStoppedContinuationBeforeUlwExecute(hooks: ChatMessageHooks, sessionID: string, command: WorkStartingCommand): void;
+export declare function runUlwExecuteHookIfApplicable(hooks: ChatMessageHooks, input: ChatMessageInput, output: ChatMessageHandlerOutput): Promise<void>;

package/dist/plugin/event-session-lifecycle.d.ts

@@ -3,6 +3,7 @@ import type { Managers } from "../create-managers";
 import type { FirstMessageVariantGate, PluginEventContext } from "./event-types";
 export declare const TMUX_ACTIVITY_EVENT_TYPES: ReadonlySet<string>;
 export declare function isCompactionAgent(agent: string): boolean;
+export declare function shouldDispatchOpenClawSessionEvent(sessionID: string): boolean;
 export declare function dispatchOpenClawSessionEvent(args: {
     pluginConfig: OhMyOpenCodeConfig;
     pluginContext: PluginEventContext;

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -20,7 +20,6 @@ export declare function createCoreHooks(args: {
     modelFallback: ReturnType<typeof import("../../hooks").createModelFallbackHook> | null;
     anthropicContextWindowLimitRecovery: ReturnType<typeof import("../../hooks").createAnthropicContextWindowLimitRecoveryHook> | null;
     autoUpdateChecker: ReturnType<typeof import("../../hooks").createAutoUpdateCheckerHook> | null;
-    codegraphBootstrap: ReturnType<typeof import("../../hooks").createCodegraphBootstrapHook> | null;
     astGrepSgProvision: ReturnType<typeof import("../../hooks").createAstGrepSgProvisionHook> | null;
     agentUsageReminder: ReturnType<typeof import("../../hooks").createAgentUsageReminderHook> | null;
     nonInteractiveEnv: ReturnType<typeof import("../../hooks").createNonInteractiveEnvHook> | null;
@@ -28,7 +27,7 @@ export declare function createCoreHooks(args: {
     goal: ReturnType<typeof import("../../hooks").createGoalHook> | null;
     editErrorRecovery: ReturnType<typeof import("../../hooks").createEditErrorRecoveryHook> | null;
     delegateTaskRetry: ReturnType<typeof import("../../hooks").createDelegateTaskRetryHook> | null;
-    startWork: ReturnType<typeof import("../../hooks").createStartWorkHook> | null;
+    ulwExecute: ReturnType<typeof import("../../hooks").createUlwExecuteHook> | null;
     prometheusMdOnly: ReturnType<typeof import("../../hooks").createPrometheusMdOnlyHook> | null;
     sisyphusJuniorNotepad: ReturnType<typeof import("../../hooks").createSisyphusJuniorNotepadHook> | null;
     noSisyphusGpt: ReturnType<typeof import("../../hooks").createNoSisyphusGptHook> | null;
@@ -58,6 +57,7 @@ export declare function createCoreHooks(args: {
     planFormatValidator: ReturnType<typeof import("../../hooks").createPlanFormatValidatorHook> | null;
     claudeCodeHooks: ReturnType<typeof import("../../hooks").createClaudeCodeHooksHook> | null;
     keywordDetector: ReturnType<typeof import("../../hooks").createKeywordDetectorHook> | null;
+    btwSideContextInjector: ReturnType<typeof import("../../features/btw-side").createBtwSideContextInjectorHook>;
     contextInjectorMessagesTransform: ReturnType<typeof import("../../features/context-injector").createContextInjectorMessagesTransformHook>;
     teamModeStatusInjector: ReturnType<typeof import("../../hooks").createTeamModeStatusInjector> | null;
     teamMailboxInjector: ReturnType<typeof import("../../hooks").createTeamMailboxInjector> | null;

package/dist/plugin/hooks/create-session-hooks.d.ts

@@ -3,7 +3,7 @@ import type { BackgroundManager } from "../../features/background-agent";
 import type { ModelFallbackControllerAccessor } from "../../hooks/model-fallback";
 import type { ModelCacheState } from "../../plugin-state";
 import type { PluginContext } from "../types";
-import { createSessionNotification, createThinkModeHook, createModelFallbackHook, createAnthropicContextWindowLimitRecoveryHook, createAutoUpdateCheckerHook, createCodegraphBootstrapHook, createAstGrepSgProvisionHook, createAgentUsageReminderHook, createNonInteractiveEnvHook, createInteractiveBashSessionHook, createEditErrorRecoveryHook, createDelegateTaskRetryHook, createTaskResumeInfoHook, createStartWorkHook, createPrometheusMdOnlyHook, createSisyphusJuniorNotepadHook, createNoSisyphusGptHook, createNoHephaestusNonGptHook, createHephaestusAgentsMdInjectorHook, createQuestionLabelTruncatorHook, createPreemptiveCompactionHook, createRuntimeFallbackHook, createLegacyPluginToastHook } from "../../hooks";
+import { createSessionNotification, createThinkModeHook, createModelFallbackHook, createAnthropicContextWindowLimitRecoveryHook, createAutoUpdateCheckerHook, createAstGrepSgProvisionHook, createAgentUsageReminderHook, createNonInteractiveEnvHook, createInteractiveBashSessionHook, createEditErrorRecoveryHook, createDelegateTaskRetryHook, createTaskResumeInfoHook, createUlwExecuteHook, createPrometheusMdOnlyHook, createSisyphusJuniorNotepadHook, createNoSisyphusGptHook, createNoHephaestusNonGptHook, createHephaestusAgentsMdInjectorHook, createQuestionLabelTruncatorHook, createPreemptiveCompactionHook, createRuntimeFallbackHook, createLegacyPluginToastHook } from "../../hooks";
 import { createGoalHook } from "../../hooks/goal";
 export type SessionHooks = {
     preemptiveCompaction: ReturnType<typeof createPreemptiveCompactionHook> | null;
@@ -12,7 +12,6 @@ export type SessionHooks = {
     modelFallback: ReturnType<typeof createModelFallbackHook> | null;
     anthropicContextWindowLimitRecovery: ReturnType<typeof createAnthropicContextWindowLimitRecoveryHook> | null;
     autoUpdateChecker: ReturnType<typeof createAutoUpdateCheckerHook> | null;
-    codegraphBootstrap: ReturnType<typeof createCodegraphBootstrapHook> | null;
     astGrepSgProvision: ReturnType<typeof createAstGrepSgProvisionHook> | null;
     agentUsageReminder: ReturnType<typeof createAgentUsageReminderHook> | null;
     nonInteractiveEnv: ReturnType<typeof createNonInteractiveEnvHook> | null;
@@ -20,7 +19,7 @@ export type SessionHooks = {
     goal: ReturnType<typeof createGoalHook> | null;
     editErrorRecovery: ReturnType<typeof createEditErrorRecoveryHook> | null;
     delegateTaskRetry: ReturnType<typeof createDelegateTaskRetryHook> | null;
-    startWork: ReturnType<typeof createStartWorkHook> | null;
+    ulwExecute: ReturnType<typeof createUlwExecuteHook> | null;
     prometheusMdOnly: ReturnType<typeof createPrometheusMdOnlyHook> | null;
     sisyphusJuniorNotepad: ReturnType<typeof createSisyphusJuniorNotepadHook> | null;
     noSisyphusGpt: ReturnType<typeof createNoSisyphusGptHook> | null;

package/dist/plugin/hooks/create-transform-hooks.d.ts

@@ -3,9 +3,11 @@ import type { MonitorManager } from "../../features/monitor";
 import type { PluginContext } from "../types";
 import { createClaudeCodeHooksHook, createKeywordDetectorHook, createMonitorStatusInjectorHook, createTeamMailboxInjector, createTeamModeStatusInjector, createToolPairValidatorHook } from "../../hooks";
 import { createContextInjectorMessagesTransformHook } from "../../features/context-injector";
+import { createBtwSideContextInjectorHook } from "../../features/btw-side";
 export type TransformHooks = {
     claudeCodeHooks: ReturnType<typeof createClaudeCodeHooksHook> | null;
     keywordDetector: ReturnType<typeof createKeywordDetectorHook> | null;
+    btwSideContextInjector: ReturnType<typeof createBtwSideContextInjectorHook>;
     contextInjectorMessagesTransform: ReturnType<typeof createContextInjectorMessagesTransformHook>;
     teamModeStatusInjector: ReturnType<typeof createTeamModeStatusInjector> | null;
     teamMailboxInjector: ReturnType<typeof createTeamMailboxInjector> | null;

package/dist/plugin/messages-transform.d.ts

@@ -8,6 +8,7 @@ type MessagesTransformOutput = {
     messages: MessageWithParts[];
 };
 type MessagesTransformHooks = {
+    btwSideContextInjector?: CreatedHooks["btwSideContextInjector"];
     contextInjectorMessagesTransform?: CreatedHooks["contextInjectorMessagesTransform"];
     teamModeStatusInjector?: CreatedHooks["teamModeStatusInjector"];
     teamMailboxInjector?: CreatedHooks["teamMailboxInjector"];

package/dist/plugin-dispose.d.ts

@@ -6,5 +6,8 @@ export declare function createPluginDispose(args: {
     skillMcpManager: {
         disconnectAll: () => Promise<void>;
     };
+    tuiStateMirror?: {
+        stop: () => void;
+    };
     disposeHooks: () => void;
 }): PluginDispose;

package/dist/shared/agent-tool-restrictions.d.ts

@@ -2,5 +2,4 @@ type AgentToolRestrictionsOptions = {
     includeTeamToolDenylist?: boolean;
 };
 export declare function getAgentToolRestrictions(agentName: string, options?: AgentToolRestrictionsOptions): Record<string, boolean>;
-export declare function hasAgentToolRestrictions(agentName: string): boolean;
 export {};

package/dist/shared/compaction-agent-config-checkpoint.d.ts

@@ -3,6 +3,7 @@ export type CompactionAgentConfigCheckpoint = {
     model?: {
         providerID: string;
         modelID: string;
+        variant?: string;
     };
     tools?: Record<string, boolean>;
 };

package/dist/shared/index.d.ts

@@ -67,9 +67,11 @@ export * from "./prompt-tools";
 export * from "./prompt-failure-classifier";
 export * from "./compaction-marker";
 export * from "./internal-initiator-marker";
+export * from "./runtime-fallback-retry-marker";
 export * from "./plugin-command-discovery";
 export { SessionCategoryRegistry } from "./session-category-registry";
 export * from "./plugin-identity";
+export * from "./plugin-entry-shape";
 export * from "./log-legacy-plugin-startup-warning";
 export * from "./legacy-workspace-migration";
 export * from "./task-system-enabled";

package/dist/shared/legacy-plugin-warning.d.ts

@@ -1,7 +1,8 @@
+import { type PluginEntry } from "./plugin-entry-shape";
 export interface LegacyPluginCheckResult {
     hasLegacyEntry: boolean;
     hasCanonicalEntry: boolean;
-    legacyEntries: string[];
+    legacyEntries: PluginEntry[];
     configPath: string | null;
 }
 export declare function checkForLegacyPluginEntry(overrideConfigDir?: string): LegacyPluginCheckResult;

package/dist/shared/normalize-sdk-response.d.ts

@@ -1,4 +1,5 @@
 export interface NormalizeSDKResponseOptions {
+    /** Return the raw response when data is missing, except when the fallback requires an array. */
     preferResponseOnMissingData?: boolean;
 }
 export declare function normalizeSDKResponse<TData>(response: unknown, fallback: TData, options?: NormalizeSDKResponseOptions): TData;

package/dist/shared/omo-process-sweep.d.ts

@@ -1,17 +1,15 @@
-import { sweepCodegraphZombies, sweepOrphanedLspDaemonProxies, sweepStaleLspDaemonVersions } from "@oh-my-opencode/utils/process-sweep";
+import { sweepOrphanedLspDaemonProxies, sweepStaleLspDaemonVersions } from "@oh-my-opencode/utils/process-sweep";
 export interface OmoFamilySweepOptions {
     readonly log?: (message: string) => void;
 }
 export interface OmoFamilySweeps {
-    readonly sweepCodegraph: typeof sweepCodegraphZombies;
     readonly sweepLspProxies: typeof sweepOrphanedLspDaemonProxies;
     readonly sweepStaleLspDaemons: typeof sweepStaleLspDaemonVersions;
 }
-export declare function sweepCodegraphZombiesBestEffort(options: OmoFamilySweepOptions, sweep?: typeof sweepCodegraphZombies): Promise<void>;
 export declare function sweepOrphanedLspDaemonProxiesBestEffort(options: OmoFamilySweepOptions, sweep?: typeof sweepOrphanedLspDaemonProxies): Promise<void>;
 export declare function sweepStaleLspDaemonVersionsBestEffort(options: OmoFamilySweepOptions, sweep?: typeof sweepStaleLspDaemonVersions): Promise<void>;
 /**
- * Runs all three omo sweep families concurrently. NEVER rejects: each family
+ * Runs every omo sweep family concurrently. NEVER rejects: each family
  * is wrapped best-effort so a sweep failure can only produce a log line, not
  * a startup failure. Callers fire-and-forget the returned promise.
  */

package/dist/shared/plugin-entry-migrator.d.ts

@@ -1,3 +1,4 @@
-export declare function isLegacyEntry(entry: string): boolean;
-export declare function isCanonicalEntry(entry: string): boolean;
-export declare function toCanonicalEntry(entry: string): string;
+import { type PluginEntry } from "./plugin-entry-shape";
+export declare function isLegacyEntry(entry: PluginEntry): boolean;
+export declare function isCanonicalEntry(entry: PluginEntry): boolean;
+export declare function toCanonicalEntry(entry: PluginEntry): PluginEntry;

package/dist/shared/plugin-entry-shape.d.ts

@@ -0,0 +1,6 @@
+export type PluginEntryOptions = Record<string, unknown>;
+export type PluginTupleEntry = readonly [string, PluginEntryOptions];
+export type PluginEntry = string | PluginTupleEntry;
+export declare function isPluginTupleEntry(entry: unknown): entry is PluginTupleEntry;
+export declare function getPluginEntryName(entry: PluginEntry): string;
+export declare function withPluginEntryName(entry: PluginEntry, name: string): PluginEntry;

package/dist/shared/runtime-fallback-retry-marker.d.ts

@@ -0,0 +1,16 @@
+export declare const OMO_RUNTIME_FALLBACK_RETRY_MARKER = "<!-- OMO_RUNTIME_FALLBACK_RETRY -->";
+type RuntimeFallbackRetryTextPartLike = {
+    type?: string;
+    text?: string;
+};
+export declare function hasRuntimeFallbackRetryMarker(text: string): boolean;
+export declare function createRuntimeFallbackRetryTextPart(text: string): {
+    type: "text";
+    synthetic: true;
+    metadata: {
+        compaction_continue: true;
+    };
+    text: string;
+};
+export declare function isRuntimeFallbackRetryTextParts(parts: readonly RuntimeFallbackRetryTextPartLike[] | undefined): boolean;
+export {};

package/dist/shared/shell-env.d.ts

@@ -13,7 +13,7 @@ export type ShellType = "unix" | "powershell" | "cmd" | "csh";
  * specific (BASH_VERSION, MSYSTEM, WSL_DISTRO_NAME) — TERM is excluded
  * because some PowerShell users set it manually.
  */
-export declare function detectShellType(): ShellType;
+export declare function detectShellType(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): ShellType;
 /**
  * Shell-escape a value for use in environment variable assignment.
  *

package/dist/skills/ast-grep/AGENTS.md

@@ -0,0 +1,51 @@
+# ast-grep — Vendored Structural-Search Skill
+
+**Generated:** 2026-08-24 (f3642fcda)
+
+## OVERVIEW
+
+Vendored skill teaching agents ast-grep (`sg`) structural search/rewrite, plus a stdlib-Python helper CLI that wraps the `sg` binary. Vendoring pin in `SOURCE`: upstream `code-yeongyu/ast-grep-skill @ 3148c69` (ast-grep 0.45.0), "vendored as a sync; do not fork-drift". Earned this file: own executable surface (749-LOC helper + installers + smoke tests) and a no-fork-drift upstream contract that has no analogue elsewhere in `shared-skills`.
+
+## STRUCTURE
+
+```
+ast-grep/
+├── SKILL.md / README.md          # agent workflow / user overview
+├── SOURCE                        # upstream pin — the no-fork-drift contract
+├── scripts/ast_grep_helper.py    # 749-LOC stdlib CLI (argparse; no deps)
+├── install.sh / install.ps1      # macOS/Linux + Windows installers
+├── references/                   # cli, install, patterns, pitfalls, recipes, yaml-rules (510 LOC), sgconfig
+└── tests/smoke.{sh,ps1}          # POSIX + PowerShell smoke (also shell syntax + content checks)
+```
+
+## HELPER CLI (`scripts/ast_grep_helper.py`)
+
+Subcommands: `search`, `replace` (dry-run; `--apply` to write), `scan`, `test`, `new`, `langs`, `doctor`, `install`, `validate`. Resolves the `sg`/`ast-grep` binary across PATH, Homebrew, npm, and OMO caches, validates patterns before executing, and shells out — it never links ast-grep as a library. Internal handlers `cmd_*`; utilities `validate_pattern`, `normalize_lang`, `resolve_binary`, `run_sg`. Nothing in-repo imports it; docs and skills invoke it by path. `omo-opencode/src/cli/install-ast-grep-sg.ts` locates this skill dir to install the binary.
+
+## CONVENTIONS
+
+- AST patterns, never regex, for syntax-shaped queries; `$VAR` singles, `$$$` multis; patterns must parse as complete code in the target language.
+- Two-pass rewrites: preview with `--json=compact`, apply separately with `--update-all` — the flags are mutually exclusive in `sg`.
+- `sgconfig.yml` discovered upward; `ruleDirs`, optional `testConfigs`/`utilDirs`, language globs, custom languages, injections.
+- Upstream syncs land as whole vendored refreshes matching `SOURCE`; local edits ride along until the next sync absorbs or reverts them.
+
+## ANTI-PATTERNS
+
+- NO regex constructs (`.*`, `.+`, `\w`, `\d`, literal `|`) inside AST patterns — that is the skill's #1 pitfall.
+- No incomplete patterns (e.g. Python `def $F($$$):` without a body).
+- NEVER `--apply` a rewrite without the dry-run preview first.
+- Text/comment/byte queries go to `rg`, not structural matching.
+- Do not fork-drift from the `SOURCE` pin; a sync is a vendored refresh, not a merge.
+
+## COMMANDS
+
+```bash
+# from packages/shared-skills/skills/ast-grep/
+python3 scripts/ast_grep_helper.py search '<PATTERN>' --lang ts [path]
+python3 scripts/ast_grep_helper.py replace '<PATTERN>' '<REWRITE>' --lang ts   # dry-run; add --apply
+python3 scripts/ast_grep_helper.py doctor
+bash tests/smoke.sh          # or: pwsh tests/smoke.ps1
+# direct:  sg run -p '<PATTERN>' --lang ts path
+```
+
+- Parent: [`packages/shared-skills/AGENTS.md`](../../AGENTS.md).

package/dist/skills/ast-grep/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ast-grep
-description: "Use ast-grep (sg) for AST-aware code search and rewrite across 25 languages. Trigger for structural code matching or deterministic codemods: find every function/call/class/import shaped like X, rewrite console.log to logger.info, strip `as any`, migrate require() to import, find empty catch blocks or missing await, and scan/apply YAML rules. Prefer this over rg/grep when the target is syntax shape rather than text; use rg for string contents, comments, filenames, or regex-style byte searches."
+description: "Searches and rewrites code by AST shape across 25 languages. Use when the target is a syntax pattern (every call/class/import shaped like X, a codemod, a YAML rule) rather than literal text; for plain strings, comments, or filenames, use rg."
 ---
 
 # ast-grep

package/dist/skills/coding-agent-sessions/AGENTS.md

@@ -0,0 +1,62 @@
+# coding-agent-sessions — Cross-Platform Session Finder (Python)
+
+**Generated:** 2026-08-24 (f3642fcda)
+
+## OVERVIEW
+
+The only shared skill besides `ultimate-browsing` carrying a real sub-project: a Python package + CLI that finds, lists, searches, and reads local coding-agent session transcripts across ~25 platforms (Codex, Claude, OpenCode, OMO/Senpi/pi, and a long tail), normalizing them into one `Session` model. Earned this file: 33 files, 23 Python modules, own test suite, own `pyrightconfig.json`, own `.npmignore` (ships in the npm package minus tests/caches).
+
+## STRUCTURE
+
+```
+coding-agent-sessions/
+├── SKILL.md                      # router: platform table → references/<platform>.md
+├── references/                   # codex, claude, opencode, senpi, all-platforms (store layouts per platform)
+├── agents/openai.yaml            # Codex agent role declaration
+├── scripts/
+│   ├── find-agent-sessions.py    # thin shebang entry (PEP 723, >=3.11); runpy → agent_sessions.cli
+│   ├── agent_sessions/           # the package (12 modules)
+│   └── tests/                    # 6 pytest modules
+└── pyrightconfig.json            # extraPaths scripts/, excludes scripts/tests
+```
+
+## PUBLIC API (`scripts/agent_sessions/`)
+
+| Module | Key exports |
+|--------|-------------|
+| `scanners.py` | `scan`, `DEFAULT_PLATFORMS`, `PLATFORM_SCANNERS`, per-platform `scan_*` (codex, claude, opencode, senpi, oh_my_pi, gajae_code, …) |
+| `types.py` | `Session`, `Options`, `Json`, `JsonMap` — imported by nearly every module and test |
+| `transcript.py` | parallel file reads, normalization, timestamps, session ids; `recent`, `MAX_PLATFORM_FILES` |
+| `cli.py` | command parsing, filtering, payload construction, JSON emission (283 LOC — behavioral hotspot) |
+| platform adapters | `file_scanners.py` (file-backed providers), `opencode.py` (CLI/SQLite/storage fallbacks), `sqlite_scanners.py`, `sqlite_optional_scanners.py`, `pi_family.py`, `aside_scanner.py`, `kiro_scanner.py` |
+
+## CLI CONTRACT
+
+`python3 scripts/find-agent-sessions.py <command>`; aliases `find`=`search`, `read`=`get`. Commands: `list`, `find`/`search` (repeated `--query` lanes, `--from 7d`, repeated `--platform`, `--workers`, `--cwd/--model`, `--include-subagents`, `--limit`), `get`/`read <session-id>`. Output is JSON with `match_reasons` and reconstructed first/last user prompts — that JSON shape is the stable contract.
+
+## CONVENTIONS
+
+- Stdlib-only Python (`>=3.11`), `from __future__ import annotations`, pathlib everywhere; no third-party deps at runtime.
+- Probe-first, bounded discovery: platform-specific roots checked before broad globbing; optional platforms excluded from default search when they cannot reconstruct user prompts.
+- Main sessions hide subagent children by default but report child counts; `--include-subagents` flips it. Parent/child linkage preserved and records deduplicated.
+- Tests are pytest with `tmp_path` + `MonkeyPatch` isolation; in-file `# pyright: ignore[reportMissingImports]`-style relaxations for import diagnostics only.
+- `.npmignore` strips `scripts/tests/`, `pyrightconfig.json`, and caches from the shipped skill.
+
+## ANTI-PATTERNS
+
+- NEVER answer from normalized previews alone — pull the raw transcript (`read`/`get`) for exact evidence.
+- Usage-only stores are NOT transcript sources.
+- A Claude subagent's embedded `sessionId` is NOT its identity — use its `agentId` + parent-directory linkage.
+- Don't add a platform by globbing blindly; register it in `PLATFORM_SCANNERS`/`DEFAULT_PLATFORMS` with a bounded root probe.
+
+## COMMANDS
+
+```bash
+# from packages/shared-skills/skills/coding-agent-sessions/
+python3 scripts/find-agent-sessions.py list --limit 20
+python3 scripts/find-agent-sessions.py find "commit" --from 7d --platform senpi --platform opencode
+python3 scripts/find-agent-sessions.py read <session-id>
+pytest scripts/tests
+```
+
+- Parent: [`packages/shared-skills/AGENTS.md`](../../AGENTS.md).

package/dist/skills/coding-agent-sessions/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: coding-agent-sessions
-description: "MUST USE when asked to find, read, list, search, inspect, fetch, export, or reconstruct coding-agent sessions across Codex, Claude Code/Desktop, OpenCode, Senpi/pi, oh-my-pi (omp), gajae-code (gjc), OpenClaw, Factory Droid, Amp, Gemini/Kimi/Qwen CLIs, Codebuff, Roo/Kilo/Cline, Kodu, Cursor CLI, Aider, Aside browser-agent sessions, or unknown local agent logs. Covers transcripts, session IDs, rollout JSONL, state SQLite, Claude projects/pre-compact histories, OpenCode messages/parts, child/subagent linkage, cwd/model/time/token filters, archives, and cost clues. Expands fuzzy recall into parallel query lanes and first probes known stores so absent platforms are skipped cheaply. Triggers: coding agent sessions, Codex/Claude/OpenCode/Senpi/pi/oh-my-pi/omp/gajae-code/gjc/OpenClaw/Droid/Amp/Kodu/Cursor/Aider/Aside sessions, transcript search, session history, session ID, read transcript, token usage, subagent sessions, what did I do yesterday, did we already do this."
+description: "Finds, reads, and reconstructs coding-agent sessions across Codex, Claude, OpenCode, OMO/Senpi, and other local agent logs. Use when asked to find or search past sessions, transcripts, or subagent runs, or to recover what an earlier session did."
 ---
 
 # Coding Agent Sessions
@@ -15,7 +15,7 @@ Find local coding-agent sessions across agent products before answering from mem
    |---|---|
    | Codex / OpenAI Codex CLI | `references/codex.md` |
    | Claude Code / Claude Desktop histories | `references/claude.md` |
-   | Senpi / pi coding-agent logs | `references/senpi.md` |
+   | OMO / Senpi / pi coding-agent logs | `references/senpi.md` |
    | oh-my-pi (`omp`, `~/.omp`) and gajae-code (`gjc`, `~/.gjc`) logs | `references/senpi.md` |
    | OpenCode / oh-my-openagent (formerly oh-my-opencode) storage | `references/opencode.md` |
    | OpenClaw, Droid, Amp, Gemini, Kimi, Qwen, Codebuff, Roo/Kilo/Cline, Kodu, Cursor CLI, Aider, Kiro, Goose, Hermes, Crush, Zed, Aside | `references/all-platforms.md` |
@@ -120,6 +120,7 @@ Use `references/codex.md` for Codex storage details.
 |---|---|
 | Missing Codex sessions | Set `CODEX_HOME` or pass `--root /path/to/.codex`. |
 | Missing oh-my-pi / gajae-code sessions | Those stores live in `~/.omp/agent/sessions` and `~/.gjc/agent/sessions`. For a custom `PI_CONFIG_DIR` / `PI_CODING_AGENT_DIR`, pass that agent dir with `--root`. |
+| Missing OMO / Senpi sessions | The `senpi` platform searches `~/.omo/agent/sessions`, `~/.senpi/agent/sessions`, and `~/.pi/agent/sessions` (plus matching profile roots). Pass a nonstandard agent directory with `--root`. |
 | Missing OpenCode sessions | Pass the data dir that contains `messages/` and `parts/`, often `~/.opencode` or `~/.local/share/opencode`. |
 | Missing Claude sessions | Search `~/.claude/projects`, `~/.claude/transcripts`, and `~/.claude/pre-compact-session-histories`; use `--root` for nonstandard config dirs. |
 | Missing Aside sessions | The Aside browser agent stores per-user data under `~/.aside/u/<n>/` (`sessions/<date>_<id>/messages.jsonl` transcripts + a `state.db` index; `agents/*/sessions/` is just a hardlink mirror). Pass `--root` for a nonstandard `.aside` dir or an exported user dir. |

package/dist/skills/coding-agent-sessions/references/all-platforms.md

@@ -10,7 +10,7 @@ Registered platform keys: `codex`, `claude`, `senpi`, `oh-my-pi`, `gajae-code`,
 |---|---|---|
 | Codex | `$CODEX_HOME`, `~/.codex` | `%CODEX_HOME%`, `%USERPROFILE%\.codex` |
 | Claude | `~/.claude` | `%USERPROFILE%\.claude`, `%APPDATA%\Claude` |
-| Senpi / pi | `~/.senpi/agent`, `~/.pi/agent` | `%USERPROFILE%\.senpi\agent`, `%USERPROFILE%\.pi\agent` |
+| OMO / Senpi / pi | `~/.omo/agent`, `~/.senpi/agent`, `~/.pi/agent` | `%USERPROFILE%\.omo\agent`, `%USERPROFILE%\.senpi\agent`, `%USERPROFILE%\.pi\agent` |
 | oh-my-pi (`omp`) | `~/.omp/agent`, `~/.omp/profiles/*/agent`, `$XDG_DATA_HOME/omp` | `%USERPROFILE%\.omp\agent` |
 | gajae-code (`gjc`) | `~/.gjc/agent`, `~/.gjc/profiles/*/agent`, `$XDG_DATA_HOME/gjc` | `%USERPROFILE%\.gjc\agent` |
 | OpenCode | `$OPENCODE_HOME`, `~/.opencode`, `~/.local/share/opencode` | `%OPENCODE_HOME%`, `%APPDATA%\opencode`, `%USERPROFILE%\.opencode` |

package/dist/skills/coding-agent-sessions/references/senpi.md

@@ -1,10 +1,10 @@
-# Senpi / pi Family Coding-Agent Sessions
+# OMO / Senpi / pi Family Coding-Agent Sessions
 
-The pi family (Senpi, oh-my-pi, gajae-code) shares one session format, so one scanner serves all three under separate platform keys.
+The pi family (OMO/Senpi, oh-my-pi, gajae-code) shares one session format, so one scanner serves all three under separate platform keys.
 
 | Platform key | Aliases | Config root | Sessions |
 |---|---|---|---|
-| `senpi` | - | `~/.senpi`, `~/.pi` | `<root>/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` |
+| `senpi` | - | `~/.omo`, `~/.senpi`, `~/.pi` | `<root>/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` |
 | `oh-my-pi` | `omp`, `ohmypi` | `~/.omp` | `~/.omp/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` |
 | `gajae-code` | `gjc`, `gajae` | `~/.gjc` | `~/.gjc/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` |
 
@@ -14,7 +14,7 @@ Extra roots scanned for every pi-family platform:
 - XDG stores (macOS/Linux, default profile): `$XDG_DATA_HOME/<app>/sessions/**` and `$XDG_DATA_HOME/<app>/profiles/<profile>/sessions/**`, where `<app>` is `senpi`, `omp`, or `gjc`. XDG flattens the `agent/` path segment.
 - A custom `PI_CONFIG_DIR` / `PI_CODING_AGENT_DIR` / `GJC_CONFIG_DIR` store: pass that agent directory with `--root`.
 
-`~/.senpi/agent/settings.json`, `models.json`, and `auth.json` provide environment context; oh-my-pi and gajae-code keep the same files plus `config.yml` and `models.yml` next to their sessions directory.
+`~/.omo/agent` and `~/.senpi/agent` are the current and legacy OMO/Senpi stores. Their `settings.json`, `models.json`, and `auth.json` files provide environment context; oh-my-pi and gajae-code keep the same files plus `config.yml` and `models.yml` next to their sessions directory.
 
 Common event types:
 

package/dist/skills/coding-agent-sessions/scripts/agent_sessions/pi_family.py

@@ -5,7 +5,7 @@ from pathlib import Path
 from .transcript import env_path, existing, jsonl_parallel, recent, stem_id
 from .types import Session
 
-SENPI_CONFIG_DIRS = (".senpi", ".pi")
+SENPI_CONFIG_DIRS = (".omo", ".senpi", ".pi")
 OH_MY_PI_CONFIG_DIRS = (".omp",)
 GAJAE_CODE_CONFIG_DIRS = (".gjc",)