gpui-toolkit AGENTS.md

A set of instructions for using the GPUI toolkit, a collection of Rust libraries for building graphical applications. It summarizes the toolkit’s components, including layout, design, audio, web, and data-visualization packages.

In plain words
What is it for?
Use it when working on GPUI layouts, forms, keyboard or mouse handling, platform backends, web builds, charts, or shared design components.
Why use it?
It gives an AI assistant a map of the available packages and their purposes before it changes or extends a GPUI application.

Instructions file for CodexOpenCode

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 instructions/pierreaubert/gpui-toolkit/agents-md
Clone the repo
git clone --depth 1 https://github.com/pierreaubert/gpui-toolkit

Made for: Codex, OpenCode.

Per session 2,182 This file is loaded in full into every session.
When invoked 2,182 The same file — it is already loaded in full.
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.02182 $0.02182
Opus 5 $0.01091 $0.01091
Sonnet 5 $0.00436 $0.00436
Haiku 4.5 $0.00218 $0.00218

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

Security

Grade A, and why

gpui-toolkit AGENTS.md 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 2d 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.

AGENTS.md · 195 lines

How it starts

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

GPUI Toolkit - Agent's Guide

Quick reference for AI agents working with the GPUI toolkit libraries.

Overview

The gpui-toolkit workspace contains several related crates for building GPUI applications:

Crate Purpose Documentation
gpui-au macOS Audio Unit platform backend — embeds GPUI inside AUv3 ViewControllers via Metal/wgpu lib.rs
gpui-hello-web Minimal wasm/browser spike app (gpui_web + gpui_wgpu canvas) this repo, just wasm-serve-hello
gpui-showcase Component showcase with a wasm/browser entry point (gpui_web + gpui_wgpu canvas) just wasm-serve-showcase
gpui-px (px-showcase) Chart showcase with a wasm/browser entry point just wasm-serve-px
gpui-builder Generic constraint-based layout solver — priority collapse, auto-axis, display tiers, dividers README
gpui-d3rs Low-level D3.js-inspired visualization primitives, incl. vello-backed 2D rasterization (vello2d module, zero-copy via WgpuCustomDraw, vello_cpu fallback) README
gpui-design Platform-adaptive design system (Apple HIG, Material 3, Fluent, Neutral) — spacing, corners, typography, animation README
gpui-ios iOS platform backend (Metal rendering, touch, text) README, AGENTS.md
gpui-pretext High-performance text measurement and multiline layout (Rust port of chenglou/pretext) README
gpui-profiler Lightweight allocation profiling utilities for interactive UI hot paths README
gpui-px High-level Plotly Express-style charting API, including unstructured MeshPlot README
gpui-themes Theme editor and management infrastructure AGENTS.md
gpui-ui-kit Reusable UI components (buttons, forms, layout) with ARIA accessibility support lib.rs, CLAUDE.md
gpui-ui-kit-macros Procedural macros for theme derivation README
figma/ Figma-to-GPUI design system rules and Code Connect mappings DESIGN_SYSTEM_RULES.md, CODE_CONNECT_MAPPINGS.md

Read the full file on GitHub · 195 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. 2d ago First seen · 195 lines · 2,182 tokens per session scan A e239e4965987

Subscribe to this mod's changes

gpui-toolkit AGENTS.md is an instructions file published in the GitHub repository pierreaubert/gpui-toolkit (58 stars, last pushed 2d ago), licensed ISC. It adds 2,182 tokens to every session, about $0.0109 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.

Related

Other instructions, from other repositories

ui-components AGENTS.md

Instructions for starc007/ui-components, covering beui v2 — agent guide, commands, layout, component catalog and components (motion category — primitives).

starc007/ui-components · 6,500 tokens

unity-ui-toolkit-design-system AGENTS.md

Instructions for sinanata/unity-ui-toolkit-design-system, covering agents.md, what this project is, golden rules (do not violate), use the design system in your project and repository layout.

sinanata/unity-ui-toolkit-design-system · 3,290 tokens

web-interface-guidelines AGENTS.md

Instructions for vercel-labs/web-interface-guidelines, covering interactions, keyboard, targets & input, forms and state & navigation.

vercel-labs/web-interface-guidelines · 1,887 tokens

unity-ui-toolkit-design-system copilot-instructions.md

Instructions for sinanata/unity-ui-toolkit-design-system: This repository follows the cross-tool AGENTS.md standard. Read /AGENTS.md for the full guide: the ds- class naming, the token rules, the load-bearing USS import order, build and preview commands, and the pull-request checklist.

sinanata/unity-ui-toolkit-design-system · 258 tokens

tool-ui CLAUDE.md

Instructions for assistant-ui/tool-ui, covering tool ui, commands, tooling, stack and architecture.

assistant-ui/tool-ui · 887 tokens

builder CLAUDE.md

Claude Code instructions for revyme-web/builder, covering revyme - architecture & contribution guide, what revyme is, the core loop, the subsystems and five invariants.

revyme-web/builder · 2,079 tokens