@agent-native/core 0.114.5 → 0.114.7

package/src/cli/skills-content/help.ts

@@ -2,13 +2,14 @@ export const HELP = `npx @agent-native/core@latest skills
 
 Usage:
   npx @agent-native/core@latest skills list
-  npx @agent-native/core@latest skills status [assets|content|design-exploration|visual-edit|visual-plan|visual-recap|visualize-repo|context-xray|scaffold] [--client codex|claude-code|pi|all] [--scope user|project] [--json]
-  npx @agent-native/core@latest skills update [assets|content|design-exploration|visual-edit|visual-plan|visual-recap|visualize-repo|context-xray|scaffold] [--client codex|claude-code|pi|all] [--scope user|project] [--dry-run] [--json]
-  npx @agent-native/core@latest skills add assets|content|design-exploration|visual-edit|visual-plan|visual-recap|visualize-repo|context-xray [--client codex|claude-code|cowork|cursor|opencode|github-copilot|all] [--scope user|project] [--mode hosted|local-files|self-hosted] [--mcp-url <url>] [--no-connect] [--with-github-action] [--yes] [--dry-run] [--json]
+  npx @agent-native/core@latest skills status [assets|content|rewind|design-exploration|visual-edit|visual-plan|visual-recap|visualize-repo|context-xray|scaffold] [--client codex|claude-code|pi|all] [--scope user|project] [--json]
+  npx @agent-native/core@latest skills update [assets|content|rewind|design-exploration|visual-edit|visual-plan|visual-recap|visualize-repo|context-xray|scaffold] [--client codex|claude-code|pi|all] [--scope user|project] [--dry-run] [--json]
+  npx @agent-native/core@latest skills add assets|content|rewind|design-exploration|visual-edit|visual-plan|visual-recap|visualize-repo|context-xray [--client codex|claude-code|cowork|cursor|opencode|github-copilot|all] [--scope user|project] [--mode hosted|local-files|self-hosted] [--mcp-url <url>] [--no-connect] [--with-github-action] [--yes] [--dry-run] [--json]
   npx @agent-native/core@latest skills add <manifest-or-app-dir|skill-repo> [--skill <name>] [--client ...] [--yes]
 
 Examples:
   npx @agent-native/core@latest skills add assets
+  npx @agent-native/core@latest skills add rewind --client codex --scope user --yes
   npx @agent-native/core@latest skills add content --mode local-files
   npx @agent-native/core@latest skills add design-exploration
   npx @agent-native/core@latest skills add visual-edit

package/src/cli/skills-content/index.ts

@@ -8,6 +8,7 @@
 export * from "./help.js";
 export * from "./assets-skill.js";
 export * from "./content-skill.js";
+export * from "./rewind-skill.js";
 export * from "./design-exploration-skill.js";
 export * from "./design-visual-edit-skill.js";
 export * from "./plan-setup-auth.js";

package/src/cli/skills-content/rewind-skill.ts

@@ -0,0 +1,52 @@
+export const REWIND_SKILL_MD = `---
+name: rewind
+description: >-
+  Retrieve recent local Clips Rewind context when the user says "Look at
+  Rewind," asks what just happened, or refers to something they recently said
+  or saw.
+metadata:
+  visibility: exported
+---
+
+# Rewind
+
+Use Clips Rewind as local screen memory. Start broad enough to find the right
+moment, then read only the smallest relevant range.
+
+## Retrieval Flow
+
+1. Call \`screen_memory_status\` first. If the newest segment is still open,
+   wait for it to finalize rather than substituting an older segment.
+2. Search \`screen_memory_search_chapters\` before requesting raw recent
+   context. Use the user's words, the visible app or project, and the likely
+   time range as clues.
+3. If several chapters plausibly match, show the candidates and ask which one
+   the user means. Do not blend separate workstreams together.
+4. Read the smallest useful range with \`screen_memory_recent_context\`.
+   Restate what you recovered before acting, and flag transcription or coverage
+   uncertainty.
+5. Use \`screen_memory_frame_at\` for one exact visual moment or
+   \`screen_memory_contact_sheet\` to scan a bounded range. Prefer local frames
+   before escalating to cloud processing.
+6. Request the smallest relevant timestamp range through Clips' bounded private
+   Clip handoff only when local text and frames are insufficient, such as
+   garbled speech, important motion, dense analysis, or a Clip the user wants
+   to keep and query later.
+
+## Boundaries
+
+- Rewind recordings, screenshots, audio, transcripts, OCR, and indexes remain
+  local unless the user explicitly asks for a bounded Clip handoff.
+- Do not reveal archive filesystem paths, crawl Clips' app-data folders, or
+  bypass the Screen Memory MCP broker.
+- Do not upload frames returned by local Screen Memory tools.
+- Treat foreground apps and chapter labels as evidence, not proof of intent.
+- If the Screen Memory MCP is missing, explain that the one-time setup needs to
+  be repaired with:
+
+  \`npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes\`
+
+  Replace \`<client>\` with the current compatible host: \`codex\`,
+  \`claude-code\`, \`cursor\`, \`opencode\`, \`github-copilot\`, or \`cowork\`.
+  Ask the user to restart the host if it cannot reload MCP servers in place.
+`;

package/src/cli/skills.ts

@@ -33,6 +33,10 @@ import {
   installLocalContextXray,
 } from "./context-xray-local.js";
 import { CLIENTS, type ClientId } from "./mcp-config-writers.js";
+import {
+  installScreenMemoryForClient,
+  resolveScreenMemoryStoreDir,
+} from "./mcp.js";
 import { PR_VISUAL_RECAP_SETUP, writePrVisualRecapWorkflow } from "./recap.js";
 import { setupAgentSymlinks } from "./setup-agents.js";
 import {
@@ -46,6 +50,7 @@ import {
   EXEMPLAR_REFERENCE_MD,
   HELP,
   LOCAL_FILES_REFERENCE_MD,
+  REWIND_SKILL_MD,
   VISUAL_PLANS_SKILL_MD,
   VISUAL_RECAP_SKILL_MD,
   VISUALIZE_REPO_SKILL_MD,
@@ -161,6 +166,40 @@ export const BUILT_IN_APP_SKILLS = {
     }),
     skillMarkdown: CONTENT_SKILL_MD,
   },
+  rewind: {
+    skillName: "rewind",
+    screenMemoryMcp: true,
+    manifest: normalizeAppSkillManifest({
+      schemaVersion: 1,
+      id: "rewind",
+      displayName: "Rewind",
+      description:
+        "Retrieve recent local Clips screen memory, chapters, transcripts, and exact frames through a privacy-preserving agent workflow.",
+      hosted: {
+        url: "https://clips.agent-native.com",
+        mcpUrl: "https://clips.agent-native.com/mcp",
+      },
+      mcp: { serverName: "clips-screen-memory" },
+      auth: { mode: "none" },
+      surfaces: [
+        {
+          id: "rewind-memory",
+          path: "/",
+          description:
+            "Search and inspect the user's local Clips Rewind memory through a bounded local MCP broker.",
+        },
+      ],
+      skills: [
+        {
+          path: "skills/rewind",
+          visibility: "exported",
+          exportAs: "rewind",
+        },
+      ],
+      hostAdapters: ["plain-skill", "claude-skill", "generic-mcp"],
+    }),
+    skillMarkdown: REWIND_SKILL_MD,
+  },
   design: {
     skillName: "design-exploration",
     extraSkills: {
@@ -356,6 +395,7 @@ export const BUILT_IN_APP_SKILLS = {
      */
     extraFiles?: Record<string, Record<string, string>>;
     localOnly?: boolean;
+    screenMemoryMcp?: boolean;
   }
 >;
 
@@ -379,6 +419,10 @@ const BUILT_IN_APP_SKILL_ALIASES = {
   "local-content": "content",
   "content-local-files": "content",
   "agent-native-content": "content",
+  rewind: "rewind",
+  "screen-memory": "rewind",
+  "clips-rewind": "rewind",
+  "agent-native-rewind": "rewind",
   design: "design",
   "ui-design": "design",
   "ux-design": "design",
@@ -421,6 +465,7 @@ const BUILT_IN_APP_SKILL_DISPLAY_ALIASES = {
     "content-local-files",
     "agent-native-content",
   ],
+  rewind: ["screen-memory", "clips-rewind", "agent-native-rewind"],
   design: [
     "design-exploration",
     "visual-edit",
@@ -811,6 +856,12 @@ function isLocalOnlyBuiltInSkill(
   return Boolean(entry && "localOnly" in entry && entry.localOnly);
 }
 
+function isScreenMemoryMcpBuiltInSkill(
+  entry: (typeof BUILT_IN_APP_SKILLS)[BuiltInAppSkillId] | null | undefined,
+): boolean {
+  return Boolean(entry && "screenMemoryMcp" in entry && entry.screenMemoryMcp);
+}
+
 function targetSupportsInstallMode(
   targetId: string | undefined,
 ): targetId is ModeAwareAppSkillId {
@@ -1019,6 +1070,7 @@ function skillFilesForBuiltIn(
       skillName,
       mcpUrl:
         isLocalOnlyBuiltInSkill(entry) ||
+        isScreenMemoryMcpBuiltInSkill(entry) ||
         localFilesModeSkipsMcp(appSkillId, options.planMode)
           ? ""
           : (options.mcpUrl ?? entry.manifest.hosted.mcpUrl),
@@ -1238,9 +1290,10 @@ function builtInSkillsRootForAgent(
 ): string {
   const home = homeDir() ?? baseDir;
   if (scope === "project") {
-    if (agent === "codex") return path.join(baseDir, ".agents", "skills");
-    if (agent === "pi") return path.join(baseDir, ".agents", "skills");
-    return path.join(baseDir, ".claude", "skills");
+    if (agent === "claude-code" || agent === "claude-code-cli") {
+      return path.join(baseDir, ".claude", "skills");
+    }
+    return path.join(baseDir, ".agents", "skills");
   }
   if (agent === "codex") {
     return process.env.CODEX_HOME
@@ -1250,6 +1303,13 @@ function builtInSkillsRootForAgent(
   if (agent === "pi") {
     return path.join(home, ".agents", "skills");
   }
+  if (
+    agent === "cursor" ||
+    agent === "opencode" ||
+    agent === "github-copilot"
+  ) {
+    return path.join(home, ".agents", "skills");
+  }
   return path.join(home, ".claude", "skills");
 }
 
@@ -2128,6 +2188,11 @@ const BUILT_IN_SKILL_PROMPT_OPTIONS: SkillsTargetPromptContext["options"] = [
     label: "content",
     hint: BUILT_IN_APP_SKILLS.content.manifest.description,
   },
+  {
+    value: "rewind",
+    label: "rewind",
+    hint: BUILT_IN_APP_SKILLS.rewind.manifest.description,
+  },
   {
     value: "design-exploration",
     label: "design-exploration",
@@ -3309,7 +3374,13 @@ export async function addAgentNativeSkill(
     );
   }
   const knownBuiltIn = knownTarget ? BUILT_IN_APP_SKILLS[knownTarget] : null;
+  const installsScreenMemoryMcp = isScreenMemoryMcpBuiltInSkill(knownBuiltIn);
   const baseDir = options.baseDir ?? process.cwd();
+  if (installsScreenMemoryMcp && parsed.mcpUrl) {
+    throw new Error(
+      "Rewind uses the local Clips Screen Memory MCP and does not accept --mcp-url.",
+    );
+  }
   if (isLocalOnlyBuiltInSkill(knownBuiltIn)) {
     if (parsed.planMode) {
       throw new Error(
@@ -3415,7 +3486,9 @@ export async function addAgentNativeSkill(
     );
   }
   installTarget = preserveMcpUrlAppPathOverride(installTarget, parsed.mcpUrl);
-  const skillsAgents = skillsAgentsForClients(clients);
+  const skillsAgents = installsScreenMemoryMcp
+    ? clients
+    : skillsAgentsForClients(clients);
   if (parsed.dryRun) {
     try {
       const localManifestPath = shouldWriteContentLocalFilesManifest(
@@ -3443,9 +3516,11 @@ export async function addAgentNativeSkill(
         displayName: installTarget.displayName,
         skillNames: installTarget.skillNames,
         skillsAgents,
-        mcpUrl: localFilesModeSkipsMcp(modeAwareTargetId, planMode)
+        mcpUrl: installsScreenMemoryMcp
           ? ""
-          : installTarget.loaded.manifest.hosted.mcpUrl,
+          : localFilesModeSkipsMcp(modeAwareTargetId, planMode)
+            ? ""
+            : installTarget.loaded.manifest.hosted.mcpUrl,
         mcpClients: shouldRegisterMcp ? mcpClients : [],
         dryRun: true,
         commands: [
@@ -3545,7 +3620,29 @@ export async function addAgentNativeSkill(
       dryRun: Boolean(parsed.dryRun),
     });
 
-    if (shouldRegisterMcp) {
+    if (shouldRegisterMcp && installsScreenMemoryMcp) {
+      const screenMemoryDir = resolveScreenMemoryStoreDir();
+      if (!screenMemoryDir) {
+        throw new Error(
+          "No local Clips Screen Memory store was found. Turn Rewind on in Clips, then run the setup again.",
+        );
+      }
+      registeredMcpClients = mcpClients.map((client) => {
+        commands.push(
+          `npx @agent-native/core@latest mcp install-screen-memory --client ${client} --scope ${parsed.scope}`,
+        );
+        installScreenMemoryForClient(
+          client,
+          screenMemoryDir,
+          baseDir,
+          parsed.scope,
+        );
+        return client;
+      });
+      options.telemetry?.track("skills_cli mcp registered", {
+        skills: installTarget.skillNames.join(","),
+      });
+    } else if (shouldRegisterMcp) {
       commands.push(
         `npx @agent-native/core@latest app-skill ensure --manifest ${installTarget.loaded.file} --client ${parsed.client} --scope ${parsed.scope} --yes`,
       );
@@ -3655,9 +3752,11 @@ export async function addAgentNativeSkill(
       instructionSource,
       skillNames: installTarget.skillNames,
       skillsAgents,
-      mcpUrl: localFilesModeSkipsMcp(modeAwareTargetId, planMode)
+      mcpUrl: installsScreenMemoryMcp
         ? ""
-        : installTarget.loaded.manifest.hosted.mcpUrl,
+        : localFilesModeSkipsMcp(modeAwareTargetId, planMode)
+          ? ""
+          : installTarget.loaded.manifest.hosted.mcpUrl,
       mcpClients: registeredMcpClients,
       dryRun: parsed.dryRun,
       commands,
@@ -3689,10 +3788,13 @@ function listSkills(options: RunSkillsOptions = {}) {
           ] ?? [],
         name: entry.manifest.displayName,
         description: entry.manifest.description,
-        mcpUrl: isLocalOnlyBuiltInSkill(entry)
-          ? ""
-          : entry.manifest.hosted.mcpUrl,
-        local: isLocalOnlyBuiltInSkill(entry),
+        mcpUrl:
+          isLocalOnlyBuiltInSkill(entry) || isScreenMemoryMcpBuiltInSkill(entry)
+            ? ""
+            : entry.manifest.hosted.mcpUrl,
+        local:
+          isLocalOnlyBuiltInSkill(entry) ||
+          isScreenMemoryMcpBuiltInSkill(entry),
         source: "agent-native",
       })),
     ...publicSkillEntries(options).map((entry) => ({

package/src/client/resources/ResourceTree.tsx

@@ -120,6 +120,8 @@ export interface ResourceTreeProps {
   headingHint?: React.ReactNode;
   /** Scope-specific action shown beside the section heading. */
   sectionAction?: React.ReactNode;
+  /** Scope-specific action shown beneath an empty collection message. */
+  emptyStateAction?: React.ReactNode;
 }
 
 interface CreatingState {
@@ -638,6 +640,7 @@ export function ResourceTree({
   readOnly = false,
   headingHint,
   sectionAction,
+  emptyStateAction,
 }: ResourceTreeProps) {
   const [expanded, setExpanded] = useState<Set<string>>(() => new Set());
   const [creating, setCreating] = useState<CreatingState | null>(null);
@@ -848,11 +851,14 @@ export function ResourceTree({
       {isEmpty && !creating && !isLoading && (
         <div className="flex items-start gap-2 border-y border-border/60 px-2 py-4">
           <IconFile className="mt-0.5 size-3.5 shrink-0 text-muted-foreground" />
-          <p className="text-xs text-muted-foreground">
-            {variant === "collection"
-              ? "No resources in this collection yet"
-              : "No files yet"}
-          </p>
+          <div className="flex flex-col items-start gap-2">
+            <p className="text-xs text-muted-foreground">
+              {variant === "collection"
+                ? "No resources in this collection yet"
+                : "No files yet"}
+            </p>
+            {emptyStateAction}
+          </div>
         </div>
       )}
     </div>

package/src/client/resources/ResourcesPanel.tsx

@@ -1,3 +1,4 @@
+import { Button } from "@agent-native/toolkit/ui/button";
 import {
   IconPlus,
   IconUpload,
@@ -82,6 +83,42 @@ import {
 const WORKSPACE_DOCS_URL = "https://agent-native.com/docs/workspace";
 const LOCAL_WORKSPACE_RESOURCE_METADATA_SOURCE = "local-workspace-resource";
 
+const EMPTY_RESOURCE_ACTION_LABELS: Record<ResourceView, string> = {
+  files: "Add file",
+  instructions: "Add instructions",
+  agents: "Add agent",
+  memory: "Add memory",
+  skills: "Add skill",
+  learnings: "Add learning",
+  "remote-agents": "Add remote agent",
+};
+
+const EMPTY_RESOURCE_SEEDS: Partial<
+  Record<ResourceView, { path: string; content: string; mimeType?: string }>
+> = {
+  instructions: {
+    path: "AGENTS.md",
+    content: "# Agent Instructions\n\n",
+    mimeType: "text/markdown",
+  },
+  memory: {
+    path: "memory/MEMORY.md",
+    content: "# Memory\n\n",
+    mimeType: "text/markdown",
+  },
+  learnings: {
+    path: "LEARNINGS.md",
+    content: "# Learnings\n\n",
+    mimeType: "text/markdown",
+  },
+  "remote-agents": {
+    path: "remote-agents/new-agent.json",
+    content:
+      '{\n  "id": "new-agent",\n  "name": "New agent",\n  "description": "",\n  "url": "",\n  "color": "#6B7280"\n}\n',
+    mimeType: "application/json",
+  },
+};
+
 export type ResourceView =
   | "files"
   | "instructions"
@@ -228,6 +265,9 @@ function CreateMenu({
   onCreated,
   showToast,
   mcpIntegrations,
+  triggerVariant = "icon",
+  triggerLabel,
+  initialView = "menu",
 }: {
   scope: ResourceScope;
   resourceFilter?: ResourceView;
@@ -257,6 +297,9 @@ function CreateMenu({
     message: string,
     opts?: { resourceId?: string; durationMs?: number },
   ) => void;
+  triggerVariant?: "icon" | "outline";
+  triggerLabel?: string;
+  initialView?: CreateMenuView;
 }) {
   const t = useT();
   const [open, setOpen] = useState(false);
@@ -313,7 +356,7 @@ function CreateMenu({
 
   useEffect(() => {
     if (open) {
-      setView("menu");
+      setView(initialView);
       setValue("");
       setAgentName("");
       setAgentDescription("");
@@ -326,7 +369,7 @@ function CreateMenu({
       setSkillUploadFileName("");
       setSkillFlyoutOpen(false);
     }
-  }, [open]);
+  }, [initialView, open]);
 
   useEffect(() => {
     if (view !== "menu" && view !== "agent-form") {
@@ -642,22 +685,36 @@ The result should be a reusable agent profile, not a one-off task response.`,
             e.target.value = "";
           }}
         />
-        <Tooltip>
-          <TooltipTrigger asChild>
-            <PopoverTrigger asChild>
-              <button
-                type="button"
-                className={cn(
-                  "flex h-6 w-6 items-center justify-center rounded-md text-muted-foreground hover:text-foreground hover:bg-accent/50",
-                  open && "bg-accent/50 text-foreground",
-                )}
-              >
-                <IconPlus className="h-3.5 w-3.5" />
-              </button>
-            </PopoverTrigger>
-          </TooltipTrigger>
-          <TooltipContent>Create new...</TooltipContent>
-        </Tooltip>
+        {triggerVariant === "outline" ? (
+          <PopoverTrigger asChild>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              className="h-7 gap-1.5 px-2.5 text-xs"
+            >
+              <IconPlus className="size-3.5" />
+              {triggerLabel ?? "Add resource"}
+            </Button>
+          </PopoverTrigger>
+        ) : (
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <PopoverTrigger asChild>
+                <button
+                  type="button"
+                  className={cn(
+                    "flex h-6 w-6 items-center justify-center rounded-md text-muted-foreground hover:text-foreground hover:bg-accent/50",
+                    open && "bg-accent/50 text-foreground",
+                  )}
+                >
+                  <IconPlus className="h-3.5 w-3.5" />
+                </button>
+              </PopoverTrigger>
+            </TooltipTrigger>
+            <TooltipContent>Create new...</TooltipContent>
+          </Tooltip>
+        )}
         <PopoverContent
           align="end"
           sideOffset={6}
@@ -1522,6 +1579,70 @@ export function ResourcesPanel({
     );
   };
 
+  const renderEmptyStateAction = (targetScope: ResourceScope) => {
+    if (targetScope === "shared" && !canEditOrg) return null;
+
+    const label = resourceFilter
+      ? EMPTY_RESOURCE_ACTION_LABELS[resourceFilter]
+      : "Add resource";
+
+    if (
+      !resourceFilter ||
+      resourceFilter === "files" ||
+      resourceFilter === "agents" ||
+      resourceFilter === "skills"
+    ) {
+      return (
+        <CreateMenu
+          scope={targetScope}
+          resourceFilter={resourceFilter}
+          onCreateFile={(name) => handleCreateFromToolbar(targetScope, name)}
+          onCreateResource={(path, content, mimeType, opts) =>
+            handleCreateResourceFromToolbar(
+              targetScope,
+              path,
+              content,
+              mimeType,
+              opts,
+            )
+          }
+          onCreateMcpServer={handleCreateMcpServer}
+          canCreateOrgMcp={canCreateOrgMcp}
+          hasOrg={hasOrgForMcp}
+          showToast={showToast}
+          mcpIntegrations={mcpIntegrations}
+          triggerVariant="outline"
+          triggerLabel={label}
+          initialView={resourceFilter === "files" ? "file" : "menu"}
+        />
+      );
+    }
+
+    const seed = EMPTY_RESOURCE_SEEDS[resourceFilter];
+    if (!seed) return null;
+
+    return (
+      <Button
+        type="button"
+        variant="outline"
+        size="sm"
+        className="h-7 gap-1.5 px-2.5 text-xs"
+        disabled={createResource.isPending}
+        onClick={() =>
+          handleCreateResourceFromToolbar(
+            targetScope,
+            seed.path,
+            seed.content,
+            seed.mimeType,
+          )
+        }
+      >
+        <IconPlus className="size-3.5" />
+        {label}
+      </Button>
+    );
+  };
+
   return (
     <div
       className={cn(
@@ -1881,6 +2002,7 @@ export function ResourcesPanel({
                 title="Personal"
                 titleTooltip="Files visible only to you"
                 sectionAction={renderScopeCreateMenu("personal")}
+                emptyStateAction={renderEmptyStateAction("personal")}
               />
             )}
             {showSharedTree && (
@@ -1915,6 +2037,7 @@ export function ResourcesPanel({
                 readOnly={!canEditOrg}
                 headingHint={!canEditOrg ? "Read only" : undefined}
                 sectionAction={renderScopeCreateMenu("shared")}
+                emptyStateAction={renderEmptyStateAction("shared")}
               />
             )}
           </div>