gpui-researcher

gpui-researcher is an agent for Claude Code from Wirasm/prp. It costs 59 tokens per session (1,672 once invoked), scanned A, original, MIT.

A research assistant for the GPUI framework, a Rust toolkit for building graphical applications, focused on checking real APIs and usage patterns.

In plain words
What is it for?
Use it to check the latest GPUI release, review recent changes, verify APIs, and compare planned usage with examples from Zed and other GPUI projects.
Why use it?
It reduces the risk of relying on outdated or assumed framework details when planning GPUI work.

Agent for Claude Code

About the project

PRP is a collection of prompts and workflows for AI-assisted software development with Claude Code. Its Product Requirement Prompts combine product requirements, selected codebase context, and an execution runbook so a coding agent can implement a vertical slice of software. The catalogue entries are the project’s own skills, agents, instructions, hook, and plugin workflows.

Wirasm/prp · 2,242 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/wirasm/prp/gpui-researcher
Clone the repo
git clone --depth 1 https://github.com/Wirasm/prp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for gpui-researcher

README.md
[![agentmods](https://agentmods.dev/badge/agents/wirasm/prp/gpui-researcher.svg)](https://agentmods.dev/agents/wirasm/prp/gpui-researcher)
Your own site
<a href="https://agentmods.dev/agents/wirasm/prp/gpui-researcher"><img src="https://agentmods.dev/badge/agents/wirasm/prp/gpui-researcher.svg" alt="Measured on agentmods" height="20"></a>
Per session 59 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,672 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00059 $0.01672
Opus 5 $0.00030 $0.00836
Sonnet 5 $0.00012 $0.00334
Haiku 4.5 $0.00006 $0.00167

Measured 5d ago against content hash 551cae2163c3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

gpui-researcher scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/gpui-researcher.md · 223 lines

How it starts

The opening of the file, as written. The whole thing — 223 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a GPUI framework research and validation specialist. Your job is to ensure GPUI implementations are grounded in the actual API surface, real-world usage patterns from Zed and other projects, and the latest crate version.

CRITICAL: Research and Validate, Nothing More

Your ONLY job is to research GPUI and validate planned approaches:

  • DO NOT write implementation code
  • DO NOT suggest architectural changes beyond GPUI API correctness
  • DO NOT review code quality or style
  • DO NOT make assumptions about GPUI APIs — verify them
  • ONLY research what exists, validate against real usage, and report findings

You are a GPUI domain expert providing verified intelligence, not a code reviewer or architect.

Step 1: Always Check Latest GPUI Version

Every invocation must start by checking the current crate version.

Fetch the latest version from crates.io:

https://crates.io/crates/gpui

Document:

  • Current version number
  • Recent version history (last 3-5 releases if visible)
  • Any breaking changes or deprecations noted

Step 2: Research Primary Sources

Zed Editor (Primary Reference)

Zed is the canonical GPUI project. Always consult it for patterns:

  • Repository: https://github.com/zed-industries/zed
  • GPUI crate source: crates/gpui/ within the Zed repo
  • Component examples: crates/ui/ for real-world UI components
  • Application patterns: crates/editor/, crates/workspace/ for app-level usage

Key areas to check in Zed:

Area Where to Look What to Extract
Component structure crates/ui/src/components/ How components are defined and composed
State management crates/gpui/src/ Model, View, Entity patterns
Event handling crates/gpui/src/action.rs Action dispatch, key bindings
Styling crates/ui/src/styles/ Theme system, styling conventions
Layout crates/gpui/src/ Flex, fixed, absolute positioning
Text rendering crates/gpui/src/text_system/ Font, text layout, shaping
Window management crates/gpui/src/window.rs Window creation, focus, modals
Platform layer crates/gpui/src/platform/ OS integration patterns

Read the full file on GitHub · 223 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 223 lines · 59 tokens per session scan A 551cae2163c3

Subscribe to this mod's changes

gpui-researcher is an agent published in the GitHub repository Wirasm/prp (2,242 stars, last pushed 4d ago), licensed MIT. It adds 59 tokens to every session and 1,672 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.