@g3nomaly/g3n-mods 0.1.2 → 0.1.4

package/.claude-plugin/marketplace.json

@@ -19,19 +19,19 @@
     {
       "name": "custom-crab-agents",
       "source": "./mods/custom-crab-agents",
-      "description": "Each subagent as a crab with a hat: effort tier, model, steps, context, tokens, cost and time.",
+      "description": "Draws each subagent in the agents panel as a crab with a hat: effort tier, model, steps, context, tokens, cost and time.",
       "version": "0.1.0"
     },
     {
       "name": "delete-guard",
       "source": "./mods/delete-guard",
-      "description": "Denies rm -rf and other permanent deletes and points Claude to the trash.",
+      "description": "Holds rm -rf and other permanent deletes on a card that lists what they remove, until you press Delete or Cancel.",
       "version": "0.1.0"
     },
     {
       "name": "focus-mode",
       "source": "./mods/focus-mode",
-      "description": "A timed focus block with a countdown, a progress bar and an end button.",
+      "description": "A timed focus block in which you're away: Claude asks no questions and gets no permission prompts. Countdown, progress bar and end button.",
       "version": "0.1.0"
     },
     {

package/README.md

@@ -22,16 +22,16 @@ Then open the project in VS Code and trust the workspace. New sessions load the
 |---|---|---|
 | `agents-panel` | The agents in `.claude/agents` with their model and a run button. A running agent shows a spinner, and a toast says when it starts and finishes | `/agents-panel` |
 | `context-bar` | One bar of context-window use split by source, with the total and where compaction starts | `/context-bar` |
-| `custom-crab-agents` | Each subagent as a crab with a hat: effort tier, model, steps, context, tokens, cost and time | `/crabs` |
-| `delete-guard` | Denies `rm -rf` and other permanent deletes and tells Claude which trash command to use instead | `/delete-guard on \| off` |
-| `focus-mode` | A timed focus block with a countdown, a progress bar and an end button. 25 minutes unless you pass a number | `/focus-mode [minutes] \| end` |
+| `custom-crab-agents` | Adds each subagent to the agents panel as a crab with a hat: effort tier, model, steps, context, tokens, cost and time. Needs `agents-panel`, which installing it adds | `/agents-panel` |
+| `delete-guard` | Off by default: deletes run unasked. Turn it on with the switch in its pane, or `/delete-guard on`; it stays on in later sessions. While on, `rm -rf` and other permanent deletes wait on a card listing the files, their sizes and whether git can restore them, until you press **Delete** or **Cancel**. Cancel tells Claude which trash command to use instead. With nothing to draw the card on, the delete is refused | `/delete-guard on \| off` |
+| `focus-mode` | A timed focus block in which you're away: Claude's questions are refused, so it picks for itself and says what it assumed, and permission prompts are refused, so it works around the step and lists it for later. Countdown, progress bar and end button. 25 minutes unless you pass a number | `/focus-mode [minutes] \| end` |
 | `handoff` | Writes a handoff with the `handoff` skill, clears the session, and attaches the handoff to your next prompt | `/handoff-new [what the next session is for]` |
 | `hide-personal-data` | Masks names, emails, phone numbers, IBANs and card numbers in replies. Hover a mask to read it | `/hide-personal-data on \| off` |
 | `mini-game` | Minesweeper, to play while Claude works | `/mini-game` |
 | `tool-timeline` | Each tool call with its duration. A denied call is struck through, next to the call that replaced it | `/tool-timeline` |
 | `you-should-know` | A card under long replies with their key point, a headline and one supporting line. It costs one small Haiku call per reply of 1500 characters or more | none |
 
-For `agents-panel`, `context-bar`, `custom-crab-agents` and `tool-timeline`, the command opens the pane and running it again closes it.
+For `agents-panel`, `context-bar` and `tool-timeline`, the command opens the pane and running it again closes it.
 
 Three mods take settings, declared under `userConfig` in their `.claude-plugin/plugin.json`:
 

package/mods/agents-panel/hooks/register.tsx

@@ -1,6 +1,6 @@
 // packages/g3n-mods/mods/agents-panel/hooks/register.tsx
 import { atom, read, update } from 'claude-code'
-import type { EngineInterface, Register } from 'claude-code'
+import type { EngineInterface, Register, RenderElement } from 'claude-code'
 
 import type { AgentDef, RunningAgent } from '../types'
 
@@ -20,6 +20,27 @@ const NAMED_COLORS: Readonly<Record<string, string>> = {
 const SPINNER = ['◐', '◓', '◑', '◒']
 const DONE_STATUSES = new Set(['completed', 'failed', 'killed', 'idle'])
 
+/** Key prefix of the panel's own elements; an add-on looks for it to find the panel's tree. */
+export const OWN_KEY = 'agents:'
+
+/** Key prefix an add-on's section carries, such as custom-crab-agents' crabs, so the panel knows to show it. */
+export const ADDON_KEY = 'addon:'
+
+/**
+ * Tells whether a drawn tree holds an element whose key starts with `prefix`.
+ *
+ * @param tree - Tree as a `ui.render` chain returned it, or one of its children.
+ * @param prefix - Key prefix to look for, e.g. `addon:`.
+ * @returns True when some element's key starts with `prefix`.
+ */
+export function holdsKey(tree: unknown, prefix: string): boolean {
+  if (Array.isArray(tree)) return tree.some(child => holdsKey(child, prefix))
+  if (typeof tree !== 'object' || tree === null) return false
+  const { props, children } = tree as { props?: { key?: unknown }; children?: unknown }
+  if (typeof props?.key === 'string' && props.key.startsWith(prefix)) return true
+  return holdsKey(children, prefix)
+}
+
 /**
  * Parses the frontmatter of a Markdown file into flat `key: value` pairs.
  *
@@ -157,6 +178,7 @@ export const register: Register = on => {
   on('session.start', async ($, e, next) => {
     await $.command.register({ name: 'agents-panel', description: 'Show or hide the agents panel' })
     await loadAgents($)
+    void $.ui.open({ id: PANE, title: TITLE })
     $.clock.every(1000, () => void pollRunning($))
     return next(e)
   })
@@ -183,8 +205,13 @@ export const register: Register = on => {
     return result
   }).catch(($, e, next) => next(e))
 
-  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
+  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e, next) => {
     const { Box, Text, Button } = $.ui.resolve(e)
+    // An add-on that depends on this panel, such as custom-crab-agents, may draw beneath this hook; its section joins the panel.
+    const below: RenderElement | undefined = await next(e).catch(() => undefined)
+    const addOn = below !== undefined && holdsKey(below, ADDON_KEY) ? below : undefined
+    /** Puts an add-on's section under the panel's own tree, when one was drawn beneath. */
+    const withAddOn = (own: RenderElement) => (addOn === undefined ? own : <Box flexDirection="column" gap={1}>{own}{addOn}</Box>)
     const list = await read($, agents)
     const runs = await read($, running)
     const now = await $.clock.now()
@@ -202,11 +229,11 @@ export const register: Register = on => {
     )
 
     if (list.length === 0) {
-      return (
-        <Box flexDirection="column" gap={1}>
+      return withAddOn(
+        <Box key={`${OWN_KEY}body`} flexDirection="column" gap={1}>
           {header}
           <Text dimColor>No agents in {AGENTS_DIR} or ~/{AGENTS_DIR}. Add one with /agents.</Text>
-        </Box>
+        </Box>,
       )
     }
 
@@ -264,14 +291,14 @@ export const register: Register = on => {
           )
         })()
 
-    return (
-      <Box flexDirection="column" gap={1}>
+    return withAddOn(
+      <Box key={`${OWN_KEY}body`} flexDirection="column" gap={1}>
         {header}
         {input}
         {section('project')}
         {section('user')}
         <Text dimColor>click ▶ run to start one · /agents-panel to hide</Text>
-      </Box>
+      </Box>,
     )
   })
 }

package/mods/custom-crab-agents/.claude-plugin/plugin.json

@@ -1,9 +1,12 @@
 {
   "name": "custom-crab-agents",
   "version": "0.1.0",
-  "description": "Each subagent as a crab with a hat: effort tier, model, steps, context, tokens, cost and time.",
+  "description": "Draws each subagent in the agents panel as a crab with a hat: effort tier, model, steps, context, tokens, cost and time.",
   "author": {
     "name": "g3ntrovert"
   },
-  "types": "./types/index.d.ts"
+  "types": "./types/index.d.ts",
+  "dependencies": [
+    "agents-panel"
+  ]
 }

package/mods/custom-crab-agents/hooks/register.tsx

@@ -1,11 +1,15 @@
 // packages/g3n-mods/mods/custom-crab-agents/hooks/register.tsx
 import { atom, read, update } from 'claude-code'
-import type { EngineInterface, Register } from 'claude-code'
+import type { EngineInterface, Register, RenderElement } from 'claude-code'
 
 import type { Crab, CrabSteps, PlannedItem } from '../types'
 
-const PANE = 'crabs'
-const TITLE = 'Crabs'
+/** The agents-panel mod's pane, which this mod depends on and draws its crabs into. */
+const PANEL = 'agents-panel'
+
+/** Key prefix of the agents panel's own elements, and the one this section carries so the panel shows it. */
+const PANEL_KEY = 'agents:'
+const ADDON_KEY = 'addon:'
 const crabs = atom({ plugin: 'custom-crab-agents', key: 'crabs' } as const, [])
 const planned = atom({ plugin: 'custom-crab-agents', key: 'planned' } as const, [])
 const contextWindow = atom({ plugin: 'custom-crab-agents', key: 'window' } as const, 1_000_000)
@@ -178,6 +182,21 @@ const isNumber = (v: unknown): v is number => typeof v === 'number'
 /** Tells whether `v` is a non-null object. */
 const isRecord = (v: unknown): v is Record<string, unknown> => typeof v === 'object' && v !== null
 
+/**
+ * Tells whether a drawn tree holds an element whose key starts with `prefix`.
+ *
+ * @param tree - Tree as a `ui.render` chain returned it, or one of its children.
+ * @param prefix - Key prefix to look for, e.g. `agents:`.
+ * @returns True when some element's key starts with `prefix`.
+ */
+export function holdsKey(tree: unknown, prefix: string): boolean {
+  if (Array.isArray(tree)) return tree.some(child => holdsKey(child, prefix))
+  if (typeof tree !== 'object' || tree === null) return false
+  const { props, children } = tree as { props?: { key?: unknown }; children?: unknown }
+  if (typeof props?.key === 'string' && props.key.startsWith(prefix)) return true
+  return holdsKey(children, prefix)
+}
+
 /**
  * Applies `patch` to every crab that `match` selects.
  *
@@ -190,14 +209,13 @@ async function patchCrab($: EngineInterface, match: (crab: Crab) => boolean, pat
 }
 
 /**
- * Records a subagent the main thread just started and shows the pane.
+ * Records a subagent the main thread just started.
  *
  * @param $ - Engine handle the hook received, see `EngineInterface`.
  * @param crab - New running crab to add, see `Crab`.
  */
 async function startCrab($: EngineInterface, crab: Crab): Promise<void> {
   await update($, crabs, list => [...list.filter(one => one.id !== crab.id), crab].slice(-KEEP))
-  void $.ui.open({ id: PANE, title: TITLE })
 }
 
 /**
@@ -332,27 +350,17 @@ async function readWindow($: EngineInterface): Promise<void> {
 }
 
 /**
- * Registers this mod's `crabs` command, its session, tool, subagent and turn hooks, and its pane.
+ * Registers this mod's session, tool, subagent and turn hooks, and its section of the agents panel.
  *
  * @param on - Hook registration function the engine passes in.
  */
 export const register: Register = on => {
   on('session.start', async ($, e, next) => {
-    await $.command.register({ name: 'crabs', description: 'Show or hide the subagent crabs' })
     await readWindow($)
     $.clock.every(1000, () => void tick($))
     return next(e)
   })
 
-  on('command.run', { command: 'crabs' }, async $ => {
-    if ((await $.ui.panes()).some(pane => pane.id === PANE)) {
-      await $.ui.close({ id: PANE })
-      return { text: 'Crabs hidden.' }
-    }
-    await $.ui.open({ id: PANE, title: TITLE })
-    return { text: 'Crabs shown.' }
-  })
-
   on('tool.call', { tool: 'Agent' }, async ($, e, next) => {
     if (e.agentId !== undefined) return next(e)
     const startedAt = await $.clock.now()
@@ -398,13 +406,22 @@ export const register: Register = on => {
     return result
   }).catch(($, e, next) => next(e))
 
-  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
+  // Draws into the agents panel: under the panel's tree when the panel's hook lies beneath this one, or alone with an
+  // `addon:` key that the panel's hook picks up when it lies above. Either way the crabs end up under the agents.
+  on('ui.render', { component: 'Pane', requestId: PANEL }, async ($, e, next) => {
     const { Box, Text } = $.ui.resolve(e)
+    const below: RenderElement | undefined = await next(e).catch(() => undefined)
+    const panel = below !== undefined && holdsKey(below, PANEL_KEY) ? below : undefined
+    /** Puts the crabs' section under the panel's tree, when it was drawn beneath. */
+    const joined = (section: RenderElement) => (panel === undefined ? section : <Box flexDirection="column" gap={1}>{panel}{section}</Box>)
+
     const list = await read($, crabs)
     const plan = await read($, planned)
     const window = await read($, contextWindow)
     const now = await $.clock.now()
-    if (list.length === 0 && plan.length === 0) return <Text dimColor>No subagents yet. Each one shows up here as a crab.</Text>
+    if (list.length === 0 && plan.length === 0) {
+      return joined(<Box key={`${ADDON_KEY}crabs`}><Text dimColor>No subagents yet. Each one shows up here as a crab.</Text></Box>)
+    }
 
     const barWidth = Math.max(120, (e.props.bodyColumns - 10) * 7)
     /**
@@ -484,8 +501,9 @@ export const register: Register = on => {
     const running = list.filter(crab => crab.status === 'running')
     const done = list.filter(crab => crab.status !== 'running')
 
-    return (
-      <Box flexDirection="column">
+    return joined(
+      <Box key={`${ADDON_KEY}crabs`} flexDirection="column">
+        <Text bold>Subagents</Text>
         {running.map(card)}
         {done.length > 0 && <Text dimColor>▾ Finished · {done.length}</Text>}
         {done.slice().reverse().map(card)}
@@ -502,7 +520,7 @@ export const register: Register = on => {
             </Box>
           </Box>
         ))}
-      </Box>
+      </Box>,
     )
   })
 }

package/mods/delete-guard/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "delete-guard",
   "version": "0.1.0",
-  "description": "Denies rm -rf and other permanent deletes and points Claude to the trash.",
+  "description": "Holds rm -rf and other permanent deletes on a card that lists what they remove, until you press Delete or Cancel.",
   "author": {
     "name": "g3ntrovert"
   },

package/mods/delete-guard/hooks/hooks.json

@@ -1 +1 @@
-{ "modules": ["./register.ts"] }
+{ "modules": ["./register.tsx"] }