tingly-box: Instructions file for Claude Code

CLAUDE.md

tingly-box CLAUDE.md is an instructions file for Claude Code from tingly-dev/tingly-box. It costs 1,067 tokens per session, scanned A, original, MPL-2.0.

A set of project instructions for Tingly-Box, a technical product that connects language models to remote controls and safety checks. It puts user experience first when designing features, reviewing changes, and building the frontend.

In plain words
What is it for?
Use it when adding or changing Tingly-Box features, reviewing pull requests, or working on its frontend and icons. It also points agents to the project's user-experience principles before they begin work.
Why use it?
It gives coding agents the product context and design rules they need to make consistent decisions. This reduces the risk of technically correct changes that make the product harder to use.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md; mentions AGENTS.md.

This is tingly-dev/tingly-box's own configuration. It tells Claude Code how to work on tingly-box itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything tingly-box configures →

Reuse

Borrowing it

Nothing to install: this file belongs to tingly-dev/tingly-box. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/tingly-dev/tingly-box/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/tingly-dev/tingly-box

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 tingly-box CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/tingly-dev/tingly-box/claude-md/github.svg)](https://agentmods.dev/instructions/tingly-dev/tingly-box/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/tingly-dev/tingly-box/claude-md"><img src="https://agentmods.dev/badge/instructions/tingly-dev/tingly-box/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for tingly-box CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/tingly-dev/tingly-box/claude-md"><img src="https://agentmods.dev/badge/instructions/tingly-dev/tingly-box/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,067 This file is loaded in full into every session.
When invoked 1,067 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.01067 $0.01067
Opus 5.5 $0.00427 $0.00427
Sonnet 5.5 $0.00213 $0.00213
Haiku 4.5 $0.00107 $0.00107

Measured 12d ago against content hash 25163052f1d3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

tingly-box CLAUDE.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 12d 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.md · 80 lines

How it starts

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

Tingly-Box

An Intelligence Orchestrator including LLM gateway, remote control and guard rails.

Guideline

UX-First (highest priority)

Tingly-Box is a technical product, but the product itself is the core — UX always comes first. Technology has to be implemented sensibly, and sometimes it must yield. When UX conflicts with implementation convenience, the direction of compromise is always to push UX further, not to dilute it.

Before building a new feature or changing an existing one, read .design/ux-principles.md. It distills 12 judgment criteria from real work (organize information architecture around user questions; eliminate mode pickers; split name collisions; separate orthogonal axes; show concrete values instead of aliases; smart defaults over toggles; diagnostics must traverse the real path; embed education in the product; reduce visual noise; "done" ≠ locked; surface the artifact for the next action; scope side effects to the current surface), and includes a checklist usable directly in PR review.

New feature design and PR review should be explicitly checked against these principles; deviations require a clear justification.

Frontend

API related code is generated by swagger. For each new feature, use a placeholder function for api (if not support for current version).

  • use MUI for new frontend component.
  • take care of layout while add new pages.
  • The theme, icons and page primitives (PageLayout, PageHeader, Surface, EmptyState, DialogHeader, ConfirmDialog, CopyIconButton) live in frontend/packages/ui (@tingly/ui), shared with the embedded Projects pages. Change them there; the old src/ paths only re-export.

Icons

General UI icons come from @/components/icons (Tabler icons adapted to MUI via tablerMui()). Do not import @mui/icons-material directly.

  • Prefer the predefined, MUI-named icons: import { Close, Add, Delete, Search } from '@/components/icons' (same API as MUI — fontSize / color semantic colors all work).
  • When one isn't predefined, use the generic factory: const Foo = tablerMui(IconFoo) (IconFoo from @tabler/icons-react), and add it to index.tsx if it's worth reusing.
  • Brand / provider logos still go through BrandIcons.tsx / ProviderIcon.tsx (Lobehub + custom SVG).
  • See .design/icon-hierarchy.md for details.

Read the full file on GitHub · 80 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. 12d ago Changed · +7 lines · +69 tokens per session 25163052f1d3
  2. 15d ago Changed · +4 lines · +122 tokens per session 083dfd5e3f8e
  3. 19d ago Changed · +4 lines · +19 tokens per session 20f73161a15a
  4. 21d ago Changed · +4 lines · +38 tokens per session 1b5abcc8cfd4
  5. 1mo ago First seen · 61 lines · 819 tokens per session scan A bbd48534fd85

Subscribe to this mod's changes

tingly-box CLAUDE.md is an instructions file published in the GitHub repository tingly-dev/tingly-box (367 stars, last pushed today), licensed MPL-2.0. It adds 1,067 tokens to every session, about $0.0043 per session on Opus 5.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