@g3nomaly/g3n-mods 0.0.0-stage → 0.1.0

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,224 @@
+// 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'])
+
+/** Frontmatter of a Markdown file as flat `key: value` pairs, quotes stripped. */
+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
+}
+
+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; a missing folder reads as none. */
+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. */
+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. */
+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. */
+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. */
+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}` }] } })
+}
+
+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>
+      )
+    }
+
+    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"] }

package/mods/context-bar/hooks/register.tsx

@@ -0,0 +1,187 @@
+// packages/g3n-mods/mods/context-bar/hooks/register.tsx
+import { atom, read, update } from 'claude-code'
+import type { EngineInterface, Register } from 'claude-code'
+
+import type { ContextRow, ContextSnapshot } from '../types'
+
+const PANE = 'context-bar'
+const TITLE = 'Context'
+const snapshot = atom({ plugin: 'context-bar', key: 'snapshot' } as const, null)
+
+/** Fewest milliseconds between two measurements; measure events in between fold into one. */
+const MEASURE_GAP_MS = 2000
+
+/** Approximate pixel width of one cell of the editor's code font. */
+const CELL_PX = 7
+
+const FREE_COLOR = '#2b3240'
+const MARKER_COLOR = '#e6c167'
+
+/** Bar label and color per source, matched against the engine's category names in order. */
+const SOURCES: ReadonlyArray<{ match: RegExp; label: string; color: string }> = [
+  { match: /system prompt/i, label: 'system prompt', color: '#6b8fd6' },
+  { match: /mcp/i, label: 'mcp tools', color: '#9b87f5' },
+  { match: /tool/i, label: 'tools', color: '#5fb3c4' },
+  { match: /agent/i, label: 'agents', color: '#7cc47f' },
+  { match: /memory/i, label: 'memory files', color: '#e6c167' },
+  { match: /skill/i, label: 'skills', color: '#f09bb5' },
+  { match: /message/i, label: 'messages', color: '#e0775a' },
+]
+
+/** Tokens as the screenshots spell them: `892`, `4.2k`, `52k`, `1M`. */
+export function formatTokens(tokens: number): string {
+  if (tokens >= 1_000_000) return `${+(tokens / 1_000_000).toFixed(1)}M`
+  if (tokens >= 10_000) return `${Math.round(tokens / 1000)}k`
+  if (tokens >= 1000) return `${+(tokens / 1000).toFixed(1)}k`
+  return String(Math.round(tokens))
+}
+
+function percentOf(part: number, whole: number): number {
+  return whole > 0 ? Math.round((part / whole) * 100) : 0
+}
+
+/**
+ * Measures the context window by source. Categories of the same source add
+ * up into one row; deferred tools and the compaction buffer are left out.
+ *
+ * @returns the snapshot, or `null` before the session has measured anything
+ */
+async function measure($: EngineInterface): Promise<ContextSnapshot | null> {
+  const usage = await $.session.usage({ breakdown: 'summary' })
+  const breakdown = usage.context.breakdown
+  if (breakdown === undefined) return null
+
+  const rows: ContextRow[] = SOURCES.map(source => ({ label: source.label, tokens: 0, color: source.color }))
+  let free = 0
+  for (const category of breakdown.categories) {
+    if (category.kind === 'free') free += category.tokens
+    if (category.kind !== 'used') continue
+    const index = SOURCES.findIndex(source => source.match.test(category.name))
+    const row = index === -1 ? undefined : rows[index]
+    if (row !== undefined) row.tokens += category.tokens
+  }
+
+  return {
+    rows: [...rows, { label: 'free', tokens: free, color: FREE_COLOR }],
+    used: breakdown.totalTokens,
+    window: breakdown.rawMaxTokens,
+    compactAt: breakdown.isAutoCompactEnabled ? breakdown.autoCompactThreshold : undefined,
+    measuredAt: await $.clock.now(),
+  }
+}
+
+/** The bar as one SVG: a rect per source, the free remainder, and a mark at the compaction point. */
+function barSvg(snap: ContextSnapshot, width: number): string {
+  const height = 14
+  let x = 0
+  const rects = snap.rows.map(row => {
+    const w = snap.window > 0 ? (row.tokens / snap.window) * width : 0
+    const rect = `<rect x="${x.toFixed(2)}" y="0" width="${w.toFixed(2)}" height="${height}" fill="${row.color}"/>`
+    x += w
+    return rect
+  })
+  const marker = snap.compactAt === undefined || snap.window === 0
+    ? ''
+    : `<rect x="${Math.min(width - 2, (snap.compactAt / snap.window) * width).toFixed(2)}" y="0" width="2" height="${height}" fill="${MARKER_COLOR}"/>`
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><rect width="${width}" height="${height}" rx="3" fill="${FREE_COLOR}"/>${rects.join('')}${marker}</svg>`
+}
+
+let lastMeasured = 0
+let isScheduled = false
+
+/** Measures now, or once the gap since the last measurement has passed; calls in between fold into one. */
+async function refresh($: EngineInterface): Promise<void> {
+  const now = await $.clock.now()
+  const wait = lastMeasured + MEASURE_GAP_MS - now
+  if (wait > 0) {
+    if (isScheduled) return
+    isScheduled = true
+    $.clock.after(wait, () => {
+      isScheduled = false
+      void refresh($)
+    })
+    return
+  }
+  lastMeasured = now
+  const snap = await measure($).catch(() => null)
+  if (snap !== null) await update($, snapshot, () => snap)
+}
+
+export const register: Register = on => {
+  on('session.start', async ($, e, next) => {
+    await $.command.register({ name: 'context-bar', description: 'Show or hide the context window bar' })
+    void $.ui.open({ id: PANE, title: TITLE })
+    void refresh($)
+    return next(e)
+  })
+
+  on('command.run', { command: 'context-bar' }, async $ => {
+    const isOpen = (await $.ui.panes()).some(pane => pane.id === PANE)
+    if (isOpen) {
+      await $.ui.close({ id: PANE })
+      return { text: 'Context bar hidden.' }
+    }
+    await $.ui.open({ id: PANE, title: TITLE })
+    await refresh($)
+    return { text: 'Context bar shown.' }
+  })
+
+  on('session.measure', async ($, e, next) => {
+    const result = await next(e)
+    void refresh($)
+    return result
+  })
+
+  on('turn.complete', async ($, e, next) => {
+    const result = await next(e)
+    if (e.agentId === undefined) void refresh($)
+    return result
+  })
+
+  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
+    const snap = await read($, snapshot)
+    const { Box, Text } = $.ui.resolve(e)
+    if (snap === null) return <Text dimColor>No context measured yet. It fills in after the first reply.</Text>
+
+    const columns = Math.max(24, e.props.bodyColumns)
+    const used = percentOf(snap.used, snap.window)
+    const compacts = snap.compactAt === undefined ? '' : ` · compacts at ${formatTokens(snap.compactAt)}`
+
+    let bar
+    if (e.surface === 'terminal') {
+      const cells = snap.rows.map(row => ({ row, n: Math.round((row.tokens / Math.max(1, snap.window)) * columns) }))
+      bar = <Text>{cells.map(({ row, n }) => <Text color={row.color}>{'█'.repeat(n)}</Text>)}</Text>
+    } else {
+      const { Svg } = $.ui.resolve(e)
+      const width = columns * CELL_PX
+      bar = <Svg source={barSvg(snap, width)} alt={`context ${used}% used`} width={width} height={14} />
+    }
+
+    return (
+      <Box flexDirection="column" gap={1}>
+        <Box flexDirection="row" justifyContent="space-between">
+          <Text>
+            <Text color="#e0775a">◆ </Text>
+            <Text bold>context window</Text>
+          </Text>
+          <Text>
+            <Text bold>{formatTokens(snap.used)}</Text>
+            <Text dimColor> of {formatTokens(snap.window)}{compacts} </Text>
+            <Text bold color="#9be39f" backgroundColor="#2f4a33"> {used}% </Text>
+          </Text>
+        </Box>
+        {bar}
+        <Box flexDirection="row" flexWrap="wrap" columnGap={3}>
+          {snap.rows.map(row => (
+            <Text>
+              <Text color={row.color}>■ </Text>
+              <Text dimColor={row.label === 'free'}>{row.label} </Text>
+              <Text bold={row.label !== 'free'} dimColor={row.label === 'free'}>{formatTokens(row.tokens)}</Text>
+              {row.label === 'free' ? '' : <Text dimColor> {percentOf(row.tokens, snap.window)}%</Text>}
+            </Text>
+          ))}
+        </Box>
+      </Box>
+    )
+  })
+}

package/mods/context-bar/types/index.d.ts

@@ -0,0 +1,25 @@
+// packages/g3n-mods/mods/context-bar/types/index.d.ts
+
+/** One source of context use as the bar draws it, e.g. `{ label: "mcp tools", tokens: 52000, color: "#9b87f5" }`. */
+export type ContextRow = {
+  label: string
+  tokens: number
+  color: string
+}
+
+/** The context window as last measured: what each source uses, the window and where compaction runs. */
+export type ContextSnapshot = {
+  rows: ContextRow[]
+  used: number
+  window: number
+  /** Token count at which auto-compaction runs; absent when it is off */
+  compactAt?: number
+  /** Milliseconds since the epoch */
+  measuredAt: number
+}
+
+declare module 'claude-code' {
+  interface PluginState {
+    'context-bar': { snapshot: ContextSnapshot | null }
+  }
+}

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

@@ -0,0 +1,9 @@
+{
+  "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.",
+  "author": {
+    "name": "g3ntrovert"
+  },
+  "types": "./types/index.d.ts"
+}

package/mods/custom-crab-agents/hooks/hooks.json

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