@webinson/peer 0.4.28 → 0.4.29

package/README.md

@@ -107,8 +107,17 @@ peer login --codex you@company.com
 If you already signed in to Peer, use `peer install --codex` in place of the login
 command. Review and trust the Peer Thread Mark hooks in Codex's `/hooks` menu.
 
-In standard Codex, send `peer: start`, `peer: stop`, `peer: list`, `peer: thread`, or
-`peer: all [words] [here] [--newest | --oldest] [page N]`. The hook answers these locally.
+In the desktop Codex composer, type `/` and select one of the skills installed with Peer Thread Mark.
+
+- `/peer` shares this chat. Append a task to share the chat and continue with that task.
+  Append `elephant` or `jellyfish` to select Peer's memory mode, or `stop` to stop sharing.
+- `/peer-list` shows the threads shared in your Peer workspace.
+- `/peer-thread` shows what the current chat saved to your personal OpenViking memory.
+- `/peer-all [words] [here] [--newest | --oldest] [page N]` browses or searches that memory.
+
+You can also send `peer: start [task | elephant | jellyfish]`, `peer: stop`, `peer: list`, `peer: thread`, or
+`peer: all [words] [here] [--newest | --oldest] [page N]` as plain text. The hook handles sharing and
+displays lists and memories locally.
 The plugin uses the [Codex hook API](https://learn.chatgpt.com/docs/hooks) and lives under
 [`mod/codex`](mod/codex) in its own marketplace.
 

package/bin/codex-thread-mark.mjs

@@ -9,6 +9,8 @@ const local = (reason) => ({ decision: "block", reason });
 const MARKETPLACE = "webinson-peer-codex";
 const PLUGIN = `peer-thread-mark@${MARKETPLACE}`;
 const setupFile = (peer) => path.join(peer.home, "codex-cli.json");
+const SKILL_MENTION = /^\$peer-thread-mark:(peer(?:-all|-list|-thread)?)(?=\s|$)/;
+const SKILL_LINK = /^\[(\$peer-thread-mark:[\w-]+)(?:\?[^\]\r\n]*)?\]\((?:\\.|[^\\)\r\n])+\)(?=\s|$)/;
 
 export function installCodex(peer, { client = false } = {}) {
   if (peer.cli.includes(`${path.sep}_npx${path.sep}`)) {
@@ -264,20 +266,24 @@ async function collideHook(input, session, peer) {
 
 async function promptHook(prompt, id, cwd, peer) {
   const session = `codex-${id}`;
+  // The desktop composer can send the namespaced skill as a Markdown link.
+  const link = SKILL_LINK.exec(prompt);
+  const skill = SKILL_MENTION.exec(link?.[1] ?? prompt);
+  const command = skill ? `/${skill[1]}${prompt.slice((link ?? skill)[0].length)}` : prompt;
   // The text form also works in clients that handle slash commands before submitting a turn.
-  const all = /^(?:\/peer-all|peer:\s+all)(?:\s+([\s\S]*))?$/.exec(prompt);
+  const all = /^(?:\/peer-all|peer:\s+all)(?:\s+([\s\S]*))?$/.exec(command);
   if (all) {
     const query = peer.memoryQuery((all[1] ?? "").split(/\s+/).filter(Boolean), cwd || process.cwd());
     return local(await peer.memoryText(query).catch((error) => `Peer: your memories did not load (${error.message})`));
   }
-  if (/^(?:\/peer-list|peer:\s+list)$/.test(prompt)) {
+  if (/^(?:\/peer-list|peer:\s+list)$/.test(command)) {
     try {
       return local(await peer.listText(peer.signedIn()));
     } catch (error) {
       return local(`Peer: ${error.message}`);
     }
   }
-  if (/^(?:\/peer-thread|peer:\s+thread)$/.test(prompt)) {
+  if (/^(?:\/peer-thread|peer:\s+thread)$/.test(command)) {
     try {
       return local(peer.threadMemoryText(await peer.threadMemories(id, true)));
     } catch (error) {
@@ -285,15 +291,18 @@ async function promptHook(prompt, id, cwd, peer) {
     }
   }
 
-  const share = /^(?:\/peer|peer:\s+start)(?:\s+([\s\S]*))?$/.exec(prompt);
+  const share = /^(?:\/peer|peer:\s+start)(?:\s+([\s\S]*))?$/.exec(command);
   const message = share?.[1]?.trim() ?? "";
-  const stop = (share && message === "stop") || /^peer:\s+stop$/.test(prompt);
+  const stop = (share && message === "stop") || /^peer:\s+stop$/.test(command);
   if (share || stop) {
     try {
       if (stop) return local(await setMode(peer, id, cwd, "inactive"));
       const mode = modeOf(peer, session);
-      const said = await setMode(peer, id, cwd, mode === "inactive" ? "elephant" : mode, { working: Boolean(message) });
-      if (!message) return local(said);
+      const selectedMode = /^(elephant|jellyfish)$/i.exec(message)?.[1].toLowerCase();
+      const hasWork = Boolean(message) && !selectedMode;
+      const said = await setMode(peer, id, cwd, selectedMode ?? (mode === "inactive" ? "elephant" : mode), { working: hasWork });
+      if (selectedMode) return local(`${said} Peer memory mode: ${selectedMode}.`);
+      if (!hasWork) return local(said);
       return {
         hookSpecificOutput: {
           hookEventName: "UserPromptSubmit",

package/mod/codex/peer-thread-mark/.codex-plugin/plugin.json

@@ -1,8 +1,9 @@
 {
   "name": "peer-thread-mark",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Share selected Codex threads in Peer and browse their memories.",
   "license": "MIT",
+  "skills": "./skills/",
   "hooks": "./hooks/hooks.json",
   "interface": {
     "displayName": "Peer Thread Mark",

package/mod/codex/peer-thread-mark/skills/peer/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: peer
+description: Share the current Codex chat on Peer, optionally with a task or a memory mode, or stop sharing it.
+---
+
+# Peer
+
+The Peer Thread Mark hook handles sharing before this skill reaches the model. If the user invokes it and the hook has supplied a confirmation, continue with the task they appended.
+
+If the hook did not confirm the action, direct the user to send one of these messages in the chat they want to share or stop sharing.
+
+- `peer: start` shares the chat. Append a task to share it and continue with that task.
+- `peer: start elephant` or `peer: start jellyfish` shares the chat and selects Peer's memory mode.
+- `peer: stop` stops sharing.
+
+If the plain-text command also reaches the model, direct the user to `peer doctor` to check the hook.

package/mod/codex/peer-thread-mark/skills/peer-all/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: peer-all
+description: Browse or search your personal OpenViking memories with Peer, optionally scoped to the current repository.
+---
+
+# Peer all
+
+The Peer Thread Mark hook searches and displays these memories locally. If the request reaches the model, ask the user to send `peer: all` with their search terms and filters as a separate message. The hook accepts `here`, `--newest`, `--oldest`, and `page N`. If the plain-text command also reaches the model, direct them to `peer doctor`.

package/mod/codex/peer-thread-mark/skills/peer-list/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: peer-list
+description: List the people in your Peer workspace and the agent chats they share.
+---
+
+# Peer list
+
+The Peer Thread Mark hook shows this list directly in the chat. If the request reaches the model, ask the user to send `peer: list` by itself so the hook can answer. If that also reaches the model, direct them to `peer doctor`.

package/mod/codex/peer-thread-mark/skills/peer-thread/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: peer-thread
+description: Show what the current Codex chat has saved to your personal OpenViking memory.
+---
+
+# Peer thread
+
+The Peer Thread Mark hook reads the current chat's memories and displays them locally. If the request reaches the model, ask the user to send `peer: thread` by itself. If that also reaches the model, direct them to `peer doctor`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webinson/peer",
-  "version": "0.4.28",
+  "version": "0.4.29",
   "description": "Share chosen Claude Code and Codex threads with your team: who has agents running and on what.",
   "license": "MIT",
   "type": "module",