gfty AGENTS.md

gfty AGENTS.md is an instructions file for Codex, OpenCode from rkana-org/gfty. It costs 3,806 tokens per session, scanned A, original, MIT.

Repository instructions for gfty, a Rust toolchain that turns SVG label artwork and typed TOML bin descriptions into reproducible Gridfinity geometry for Onshape. Onshape is a browser-based computer-aided design system.

In plain words
What is it for?
Use them when changing the CLI, browser designer, Nix builds, SVG composition, geometry JSON, or Onshape FeatureScripts.
Why use it?
They describe the data flow, repository boundaries, and invariants needed to keep generated labels, bins, plates, and FeatureScripts compatible.

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/rkana-org/gfty/agents-md
Clone the repo
git clone --depth 1 https://github.com/rkana-org/gfty

Made for: Codex, OpenCode.

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 gfty AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/rkana-org/gfty/agents-md.svg)](https://agentmods.dev/instructions/rkana-org/gfty/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/rkana-org/gfty/agents-md"><img src="https://agentmods.dev/badge/instructions/rkana-org/gfty/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,806 This file is loaded in full into every session.
When invoked 3,806 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.03806 $0.03806
Opus 5 $0.01903 $0.01903
Sonnet 5 $0.00761 $0.00761
Haiku 4.5 $0.00381 $0.00381

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

Security

Grade A, and why

gfty 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 4d 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 · 335 lines

How it starts

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

gfty development guide

Scope and purpose

gfty is a Rust CLI/package, Nix module, browser designer, and Onshape FeatureScripts for reproducibly turning SVG label artwork and typed bin TOML into colored Onshape geometry. It supports standalone bins, individual labels, row-major multi-label plates, and the Gridfinity Ultimate web workflow.

The current end-to-end model is:

  1. Typed bin TOML -> canonical Gridfinity Ultimate configuration JSON.
  2. Label TOML + SVG template/icons -> composed SVG.
  3. Composed SVG -> compact schema-version-2 geometry JSON grouped by filament.
  4. A referenced bin configuration produces the blank prototype in Onshape.
  5. featurescripts/labels/gfty_label_instances.fs copies that prototype, creates the artwork, and joins multi-label output with sacrificial connector plates.
  6. Nix builders expose reproducible bin/label/plate bundles and flake-parts outputs.

Read the repository README.md before changing user-facing behavior. The parent repository also has /home/malte/onshape/AGENTS.md; in particular, local FeatureScript docs are in ../featurescript-docs/ and standard-library source is in ../std-library/.

Repository map

  • designer/: Gridfinity Ultimate browser application and Nix site package.
  • featurescripts/: every maintained FeatureScript, organized by labels, configuration, and divider generation.
  • src/main.rs: command dispatch, output behavior, and inspection.
  • src/cli.rs: Clap interface. Keep stdout clean for data-producing commands.
  • src/config.rs: label TOML schema, path resolution, discovery, and validation.
  • src/bin_config.rs: current bin TOML, divider normalization, canonical model JSON conversion, and generated-part discovery.
  • src/component_config.rs: independent base/rim/swappable-label/set schemas, compatibility checks, carrier configurations, and semantic request keys.
  • src/artifact_cache.rs: verified runtime STEP/PNG cache outside the Nix store.
  • src/create.rs: unsaved label creation and reusable TOML saving.
  • src/credentials.rs: protected Onshape credential-file discovery.
  • src/onshape.rs: signed encode/translate/poll/download API operations.
  • src/step.rs: expected filament manifest validation and atomic downloads.
  • docs/ARCHITECTURE.md: current configuration, geometry, Onshape transport, cache, Nix-boundary, FeatureScript, and designer contracts.
  • src/template.rs: SVG template contract and icon-box metadata.
  • src/compose.rs: shared label composition pipeline.
  • src/color.rs: SVG fill/stroke discovery, sidecars, overrides, preview colors.
  • src/layout.rs: icon flow/alignment.
  • src/svg.rs: reusable usvg parser and text outlining.
  • src/export.rs: schema-version-2 geometry export.
  • src/plate.rs: dimension-constrained row-major plate layout.
  • src/terminal_preview.rs: native rasteroid previews.
  • src/watch.rs: dependency watching and rebuild presentation.
  • featurescripts/labels/gfty_label_instances.fs: version-2 Onshape importer.
  • featurescripts/configuration/variable_configured_derived.fs: wrapper around native Derived which forwards current variables into source configuration IDs.
  • featurescripts/configuration/extract_json_config.fs: Gridfinity JSON-to-variable bridge.
  • featurescripts/dividers/walls_grid.fs: divider and easy-grab wall generator.
  • nix/mk-label.nix, nix/mk-plate.nix: passthru builders.
  • flake-module.nix: typed flake-parts label/plate definitions and nested output packages.
  • examples/: standalone flake-parts integration test and documentation.
  • tests/bin-designer-conformance.js: verifies the browser default configuration against a frozen JSON fixture.
  • .github/workflows/designer-pages.yml: deploys packages.designer from designer-v* tags.

Read the full file on GitHub · 335 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. 4d ago First seen · 335 lines · 3,806 tokens per session scan A 878d52f34049

Subscribe to this mod's changes

gfty AGENTS.md is an instructions file published in the GitHub repository rkana-org/gfty (45 stars, last pushed 23d ago), licensed MIT. It adds 3,806 tokens to every session, about $0.0190 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.