machinist

machinist is an agent for coding agents from Yuno15-bb/c-brain. It costs 69 tokens per session (1,283 once invoked), scanned B, original, Apache-2.0.

An agent that investigates a Mac's physical resource problems, including high memory use, CPU load, heat, battery drain, and abandoned processes. It works alongside an automatic monitor that checks the machine periodically.

In plain words
What is it for?
Use it when the computer becomes sluggish or hot, fans run constantly, animations persist, or battery life drops. It can also provide a resource-status report and explain cases the automatic monitor cannot resolve.
Why use it?
A resource-heavy development process can make a fanless or memory-limited laptop slow, hot, or power-hungry. This helps identify causes and decide what action is safe.

Agent

Part of the c-brain plugin — 3 skills, 8 agents, 5 hooks shipped together

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/yuno15-bb/c-brain/machinist
Clone the repo
git clone --depth 1 https://github.com/Yuno15-bb/c-brain

Or install c-brain, the plugin that ships this one along with the rest of its 3 skills, 8 agents, 5 hooks.

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 machinist

README.md
[![agentmods](https://agentmods.dev/badge/agents/yuno15-bb/c-brain/machinist.svg)](https://agentmods.dev/agents/yuno15-bb/c-brain/machinist)
Your own site
<a href="https://agentmods.dev/agents/yuno15-bb/c-brain/machinist"><img src="https://agentmods.dev/badge/agents/yuno15-bb/c-brain/machinist.svg" alt="Measured on agentmods" height="20"></a>
Per session 69 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,283 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. 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.00069 $0.01283
Opus 5 $0.00034 $0.00642
Sonnet 5 $0.00014 $0.00257
Haiku 4.5 $0.00007 $0.00128

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

Security

Grade B, and why

machinist scanned grade B with 1 finding 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.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

| Watts / temperatures | `sudo powermetrics --samplers smc,cpu_power -i 1000` | Requires sudo — ask, do not force |
agents/machinist.md · 66 lines

How it starts

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

You are the machinist of the trunk. The [[mechanic]] maintains the trunk's software infrastructure (hooks, symlinks, capsule); the others maintain the knowledge. You maintain the physical machine: RAM, CPU, heat, battery life.

The hardware context is not negotiable: a fanless laptop with limited RAM has no thermal headroom to waste. Every permanent watt is a watt that becomes heat no fan will carry away. Adjust the thresholds below to the machine you are actually on — but never assume it has margin.

Your enforcer already runs without you

hooks/machiniste.py makes a round every 10 minutes via launchd (com.claudebrain.machiniste), with no LLM and zero quota. It measures, kills orphaned dev servers under strict rules, and reports the rest.

  • state/machiniste.json — the last round
  • state/machiniste.jsonl — full history, one line per round
  • sessions/machiniste.log — readable log, written only when something happens
  • python3 ~/.c-brain/trunk/hooks/machiniste.py --report — the state in five lines

Your job starts where the rules stop: understanding why the machine is suffering, when the daemon can only observe.

Your method — measure, never assume

  1. Announce: python3 ~/.c-brain/trunk/hooks/brain_status.py busy auditing "machine round", then … idle at the end.
  2. Read the last round (--report) and the .jsonl history: the trend says more than the snapshot.
  3. Measure before concluding. Put a number on every hypothesis over a 60-second window, never on a hunch.
  4. Look for the three families (below).
  5. Act on what is safe, propose the rest. Every action is measured before and after.
  6. Distil what is new: a cross-cutting lesson goes to lessons/, and you flag it to the [[gardener]].

The three families of waste

1. The abandoned

A process whose parent is launchd (ppid 1) when it should be living inside a terminal is a dev server whose window was closed. It survives, it holds its memory, nobody sees it.

Read the full file on GitHub · 66 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 · 66 lines · 69 tokens per session scan B 8e81801943ed

Subscribe to this mod's changes

machinist is an agent published in the GitHub repository Yuno15-bb/c-brain (2 stars, last pushed 9d ago), licensed Apache-2.0. It adds 69 tokens to every session and 1,283 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

graph-reviewer

Validates knowledge graphs for correctness, completeness, and quality. Runs systematic checks and renders approval or rejection decisions.

Egonex-AI/Understand-Anything · 26 tokens

article-analyzer

Analyzes markdown files using pre-parsed structural data and LLM inference to extract knowledge graph nodes and edges (entities, claims, implicit relationships, topic clustering).

Egonex-AI/Understand-Anything · 36 tokens

design-analyzer

Analyzes Figma structural nodes (pages, screens, components, instances, tokens) from a deterministic manifest and adds semantic enrichment — concise summaries, tags, and a screen's purpose — plus conservative related edges. Does NOT invent structural nodes or edges.

Egonex-AI/Understand-Anything · 56 tokens

apple-neural-performance-expert

Use this agent when you need expert guidance on optimizing neural network operations on Apple platforms, including Metal Performance Shaders (MPS), MLX framework optimization, low-level array operations, GPU kernel optimization, memory management for ML workloads, or performance profiling of neural network code. This…

FluidInference/FluidAudio · 0 tokens

bestmode

You are an agent - please keep going until the user’s query is completely resolved, before ending your turn and yielding back to the user.

raphaelmansuy/edgequake · 0 tokens

detection-matrix

Standardized checklist for analyzing and onboarding new AI coding agent CLIs. Each cell must be filled with observed values from live sessions before the agent is considered fully supported.

sstraus/tuicommander · 0 tokens