@g3nomaly/g3n-mods 0.0.0-stage → 0.1.1

package/.claude-plugin/marketplace.json

@@ -0,0 +1,68 @@
+{
+  "name": "g3n-mods",
+  "owner": {
+    "name": "g3ntrovert"
+  },
+  "plugins": [
+    {
+      "name": "agents-panel",
+      "source": "./mods/agents-panel",
+      "description": "The agents in .claude/agents with their model and a run button.",
+      "version": "0.1.0"
+    },
+    {
+      "name": "context-bar",
+      "source": "./mods/context-bar",
+      "description": "Context window use as one bar split by source, with the total and the compaction point.",
+      "version": "0.1.0"
+    },
+    {
+      "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.",
+      "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.",
+      "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.",
+      "version": "0.1.0"
+    },
+    {
+      "name": "handoff",
+      "source": "./mods/handoff",
+      "description": "Writes a handoff with the handoff skill, clears the session, and starts the fresh one with your next prompt.",
+      "version": "0.1.0"
+    },
+    {
+      "name": "hide-personal-data",
+      "source": "./mods/hide-personal-data",
+      "description": "Masks names, emails and other personal data in replies; hover to show them.",
+      "version": "0.1.0"
+    },
+    {
+      "name": "mini-game",
+      "source": "./mods/mini-game",
+      "description": "Minesweeper to play while Claude works.",
+      "version": "0.1.0"
+    },
+    {
+      "name": "tool-timeline",
+      "source": "./mods/tool-timeline",
+      "description": "Each tool call with its duration; a denied call is struck through next to the call that replaced it.",
+      "version": "0.1.0"
+    },
+    {
+      "name": "you-should-know",
+      "source": "./mods/you-should-know",
+      "description": "A card under long replies that flags their key point: a headline and one supporting line.",
+      "version": "0.1.0"
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,95 @@
+Copyright (c) 2026 G3NTs - G3nomaly
+
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/mods/agents-panel/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "agents-panel",
+  "version": "0.1.0",
+  "description": "The agents in .claude/agents with their model and a run button.",
+  "author": {
+    "name": "g3ntrovert"
+  },
+  "types": "./types/index.d.ts"
+}

package/mods/agents-panel/hooks/hooks.json

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

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

@@ -0,0 +1,277 @@
+// 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 { AgentDef, RunningAgent } from '../types'
+
+const PANE = 'agents-panel'
+const TITLE = 'Agents'
+const agents = atom({ plugin: 'agents-panel', key: 'agents' } as const, [])
+const running = atom({ plugin: 'agents-panel', key: 'running' } as const, [])
+const task = atom({ plugin: 'agents-panel', key: 'task' } as const, '')
+
+const AGENTS_DIR = '.claude/agents'
+const DEFAULT_TASK = 'Do the job your instructions describe for this project, then report what you did and what you found.'
+const DOT_COLORS = ['#6b8fd6', '#5fb3c4', '#e6c167', '#e0775a', '#b48ead', '#e06c6c', '#7cc47f', '#9b87f5']
+const NAMED_COLORS: Readonly<Record<string, string>> = {
+  red: '#e06c6c', blue: '#6b8fd6', green: '#7cc47f', yellow: '#e6c167',
+  purple: '#b48ead', orange: '#e0775a', pink: '#f09bb5', cyan: '#5fb3c4',
+}
+const SPINNER = ['◐', '◓', '◑', '◒']
+const DONE_STATUSES = new Set(['completed', 'failed', 'killed', 'idle'])
+
+/**
+ * Parses the frontmatter of a Markdown file into flat `key: value` pairs.
+ *
+ * @param text - Full Markdown text, which starts with a `---` block when it has frontmatter.
+ * @returns Fields by key with surrounding quotes stripped, or `{}` when there is no frontmatter.
+ */
+export function frontmatter(text: string): Record<string, string> {
+  const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text)
+  if (match === null) return {}
+  const fields: Record<string, string> = {}
+  for (const line of (match[1] ?? '').split(/\r?\n/)) {
+    const pair = /^([A-Za-z][\w-]*):\s*(.*)$/.exec(line)
+    if (pair === null) continue
+    fields[pair[1] ?? ''] = (pair[2] ?? '').trim().replace(/^(['"])(.*)\1$/, '$2')
+  }
+  return fields
+}
+
+/**
+ * Picks the dot color of an agent: its own color when it names one, else a palette color by position.
+ *
+ * @param agent - Definition whose `color` is tried first.
+ * @param index - Position of the agent in its list, used to pick a palette color.
+ * @returns CSS hex color.
+ */
+function dotColor(agent: AgentDef, index: number): string {
+  const named = agent.color === undefined ? undefined : NAMED_COLORS[agent.color] ?? agent.color
+  return named ?? DOT_COLORS[index % DOT_COLORS.length] ?? '#8a8f98'
+}
+
+/**
+ * Reads every agent definition in one agents folder.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ * @param dir - Folder to read, e.g. `<root>/.claude/agents`.
+ * @param scope - Where the folder lives, as `project` or `user`.
+ * @returns Definitions sorted by name, or `[]` when the folder does not exist.
+ */
+async function readAgentsDir($: EngineInterface, dir: string, scope: AgentDef['scope']): Promise<AgentDef[]> {
+  if (!(await $.fs.exists(dir))) return []
+  const found: AgentDef[] = []
+  for (const entry of await $.fs.list(dir)) {
+    if (entry.kind !== 'file' || !entry.name.endsWith('.md')) continue
+    const fields = frontmatter(await $.fs.read(`${dir}/${entry.name}`))
+    found.push({
+      name: fields.name ?? entry.name.replace(/\.md$/, ''),
+      description: fields.description ?? '',
+      model: fields.model ?? 'inherit',
+      color: fields.color,
+      scope,
+    })
+  }
+  return found.sort((a, b) => a.name.localeCompare(b.name))
+}
+
+/**
+ * Reloads the project's and the user's agent definitions into state.
+ *
+ * A user agent is dropped when the project has one with the same name.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ */
+async function loadAgents($: EngineInterface): Promise<void> {
+  const root = await $.session.root()
+  const home = await $.env.get('HOME')
+  const project = await readAgentsDir($, `${root}/${AGENTS_DIR}`, 'project')
+  const user = home === undefined ? [] : await readAgentsDir($, `${home}/${AGENTS_DIR}`, 'user')
+  const names = new Set(project.map(agent => agent.name))
+  await update($, agents, () => [...project, ...user.filter(agent => !names.has(agent.name))])
+}
+
+/**
+ * Starts one agent with the task typed in the panel, or its standing job when none was typed.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ * @param agent - Definition of the agent to start.
+ */
+async function runAgent($: EngineInterface, agent: AgentDef): Promise<void> {
+  const typed = (await read($, task)).trim()
+  const started = await $.agent.spawn({
+    prompt: typed.length > 0 ? typed : DEFAULT_TASK,
+    subagentType: agent.name,
+    description: `Run ${agent.name} from the agents panel`,
+  })
+  if ('deny' in started) {
+    $.ui.toast(`Could not start ${agent.name}: ${started.deny}`)
+    return
+  }
+  const startedAt = await $.clock.now()
+  await update($, running, list => [...list, { name: agent.name, agentId: started.agentId ?? '', startedAt }])
+  $.ui.toast(`Started ${agent.name}`)
+}
+
+/**
+ * Drops the agents that finished from the running list and says which ones did.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ */
+async function pollRunning($: EngineInterface): Promise<void> {
+  const list = await read($, running)
+  if (list.length === 0) return
+  const known = await $.agent.list()
+  const finished = list.filter(run => {
+    const info = known.find(agent => agent.id === run.agentId)
+    return info !== undefined && DONE_STATUSES.has(info.status)
+  })
+  if (finished.length > 0) {
+    await update($, running, current => current.filter(run => !finished.some(done => done.agentId === run.agentId)))
+    for (const run of finished) $.ui.toast(`${run.name} finished`)
+  } else {
+    $.ui.invalidate('ui.render')
+  }
+}
+
+/**
+ * Puts a finished agent's answer in the transcript as a notice the model does not read.
+ *
+ * Answers longer than 4000 characters are cut to 4000.
+ *
+ * @param $ - Engine handle the hook received, see `EngineInterface`.
+ * @param run - Agent that finished, from the running list.
+ * @param answer - Final text of the agent's reply.
+ */
+async function reportAnswer($: EngineInterface, run: RunningAgent, answer: string): Promise<void> {
+  const text = answer.length > 4000 ? `${answer.slice(0, 4000)}…` : answer
+  await $.session.append({ message: { type: 'system', content: [{ type: 'text', text: `${run.name} finished:\n\n${text}` }] } })
+}
+
+/**
+ * Registers this mod's `agents-panel` command, its session and turn hooks, and its pane.
+ *
+ * @param on - Hook registration function the engine passes in.
+ */
+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($)
+    $.clock.every(1000, () => void pollRunning($))
+    return next(e)
+  })
+
+  on('command.run', { command: 'agents-panel' }, async $ => {
+    if ((await $.ui.panes()).some(pane => pane.id === PANE)) {
+      await $.ui.close({ id: PANE })
+      return { text: 'Agents panel hidden.' }
+    }
+    await loadAgents($)
+    await $.ui.open({ id: PANE, title: TITLE })
+    return { text: 'Agents panel shown.' }
+  })
+
+  on('turn.complete', async ($, e, next) => {
+    const result = await next(e)
+    if (e.agentId === undefined) return result
+    const run = (await read($, running)).find(one => one.agentId === e.agentId)
+    if (run !== undefined) {
+      await update($, running, list => list.filter(one => one.agentId !== e.agentId))
+      await reportAnswer($, run, e.answer)
+      $.ui.toast(`${run.name} finished`)
+    }
+    return result
+  }).catch(($, e, next) => next(e))
+
+  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
+    const { Box, Text, Button } = $.ui.resolve(e)
+    const list = await read($, agents)
+    const runs = await read($, running)
+    const now = await $.clock.now()
+    const frame = SPINNER[Math.floor(now / 250) % SPINNER.length] ?? '◐'
+
+    const header = (
+      <Box flexDirection="row" justifyContent="space-between">
+        <Text>
+          <Text color="#e0775a">◆ </Text>
+          <Text bold>Agents</Text>
+          <Text dimColor> in this project</Text>
+        </Text>
+        <Text dimColor>{runs.length > 0 ? `${frame} ${runs.length} running` : ''}</Text>
+      </Box>
+    )
+
+    if (list.length === 0) {
+      return (
+        <Box flexDirection="column" gap={1}>
+          {header}
+          <Text dimColor>No agents in {AGENTS_DIR} or ~/{AGENTS_DIR}. Add one with /agents.</Text>
+        </Box>
+      )
+    }
+
+    /**
+     * Renders the agents of one scope under a heading, or nothing when the scope has none.
+     *
+     * @param scope - Scope to render, as `project` or `user`.
+     * @returns The section element, or `''` when no agent has that scope.
+     */
+    const section = (scope: AgentDef['scope']) => {
+      const members = list.filter(agent => agent.scope === scope)
+      if (members.length === 0) return ''
+      return (
+        <Box flexDirection="column" gap={1}>
+          <Text>
+            <Text bold color="#8fa1d6">{scope === 'project' ? 'PROJECT' : 'USER'}</Text>
+            <Text dimColor> {scope === 'project' ? AGENTS_DIR : `~/${AGENTS_DIR}`} · {members.length}</Text>
+          </Text>
+          {members.map((agent, index) => {
+            const run = runs.find(one => one.name === agent.name)
+            return (
+              <Box flexDirection="column" paddingLeft={1}>
+                <Box flexDirection="row" justifyContent="space-between">
+                  <Text>
+                    <Text color={dotColor(agent, index)}>● </Text>
+                    <Text bold>{agent.name}</Text>
+                    <Text dimColor> {agent.model}</Text>
+                  </Text>
+                  {run === undefined
+                    ? <Button key={`run:${agent.name}`} label="▶ run" onPress={() => runAgent($, agent)} />
+                    : <Text color="#8fa1d6">{frame} running · {Math.round((now - run.startedAt) / 1000)}s</Text>}
+                </Box>
+                <Box paddingLeft={2}>
+                  <Text dimColor wrap="truncate-end">{agent.description}</Text>
+                </Box>
+              </Box>
+            )
+          })}
+        </Box>
+      )
+    }
+
+    const input = e.surface === 'mobile'
+      ? ''
+      : (() => {
+          const { Input } = $.ui.resolve(e)
+          return (
+            <Input
+              key="task"
+              label="Task"
+              placeholder="what the next run should do (optional)"
+              onInput={value => update($, task, () => value)}
+              onSubmit={value => update($, task, () => value)}
+            />
+          )
+        })()
+
+    return (
+      <Box flexDirection="column" gap={1}>
+        {header}
+        {input}
+        {section('project')}
+        {section('user')}
+        <Text dimColor>click ▶ run to start one · /agents-panel to hide</Text>
+      </Box>
+    )
+  })
+}

package/mods/agents-panel/types/index.d.ts

@@ -0,0 +1,24 @@
+// packages/g3n-mods/mods/agents-panel/types/index.d.ts
+
+/** One agent definition found in an agents folder, read from its frontmatter. */
+export type AgentDef = {
+  name: string
+  description: string
+  /** `sonnet`, `opus`, `haiku`, a model id, or `inherit` */
+  model: string
+  color?: string
+  scope: 'project' | 'user'
+}
+
+/** An agent this panel started that has not finished; `startedAt` is milliseconds since the epoch. */
+export type RunningAgent = {
+  name: string
+  agentId: string
+  startedAt: number
+}
+
+declare module 'claude-code' {
+  interface PluginState {
+    'agents-panel': { agents: AgentDef[]; running: RunningAgent[]; task: string }
+  }
+}

package/mods/context-bar/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "context-bar",
+  "version": "0.1.0",
+  "description": "Context window use as one bar split by source, with the total and the compaction point.",
+  "author": {
+    "name": "g3ntrovert"
+  },
+  "types": "./types/index.d.ts"
+}

package/mods/context-bar/hooks/hooks.json

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