ableton-push-hack CLAUDE.md

ableton-push-hack CLAUDE.md is an instructions file for coding agents from federico-pepe/ableton-push-hack. It costs 8,031 tokens per session, scanned A, original, MIT.

Project instructions for Push Hack, an extensible framework for Ableton Push 3 running Linux and Ableton Live. They describe its core components, deployment through SSH, documentation rules, and protection of the device's system partition.

In plain words
What is it for?
Use them when changing Push Manager, Push Display, Push Hack Catalog, installation, deployment, or project documentation.
Why use it?
They keep code, documentation, plans, and release notes aligned while defining which parts belong in this repository and which are optional add-ons.

Instructions file

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/federico-pepe/ableton-push-hack/claude-md
Clone the repo
git clone --depth 1 https://github.com/federico-pepe/ableton-push-hack

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 ableton-push-hack CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/federico-pepe/ableton-push-hack/claude-md.svg)](https://agentmods.dev/instructions/federico-pepe/ableton-push-hack/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/federico-pepe/ableton-push-hack/claude-md"><img src="https://agentmods.dev/badge/instructions/federico-pepe/ableton-push-hack/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 8,031 This file is loaded in full into every session.
When invoked 8,031 The same file — it is already loaded in full.
Security scan A 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.08031 $0.08031
Opus 5 $0.04015 $0.04015
Sonnet 5 $0.01606 $0.01606
Haiku 4.5 $0.00803 $0.00803

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

Security

Grade A, and why

ableton-push-hack CLAUDE.md scanned grade A 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 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| `push-catalog.sh` (embedded into the binary via `make embed`) | All the logic: `q()`/`rq()` (python3-only JSON readers — no jq dependency, mirrors the framework installer's own avoidance of it; `q`'s `catalog` op also
CLAUDE.md · 256 lines

How it starts

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

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Doc sync rule: Keep this file, all docs/ files, and README.md in sync with every code change. If a change affects behaviour, APIs, architecture, or known issues — update the relevant docs in the same commit. Save all implementation plans to /plans/ with filename format YYYY-MM-DD-title-of-the-plan.md. Update CHANGELOG.md's ## [Unreleased] section in the same commit as any change worth noting to a future reader — new behavior, a fix, a changed API. Skip internal refactors and trivial edits.

Project

push-hack — extensible hack framework for Ableton Push 3 (Intel Linux, runs full Ableton Live). Deploys via SSH. Never modifies system partition. Only three hacks are core — built from this repo, installed directly via install.sh: Push Manager (web file browser + display control, port 7701), Push Display (LD_PRELOAD display hook), Push Hack Catalog (on-device installer for community hacks, port 7702). Everything else is optional and installed via Push Hack Catalog rather than built from this repo — see catalog/catalog.json — including Automation (LFO/CC curve sequencer, port 7703), Browser Bridge (Live MIDI Remote Script to load .adv/.adg presets — one-time manual activation required), and Keyboard Visualizer (on-screen piano keyboard sourced from Live's post-transform notes, port 7705).

core/ is a shared Go module (see "Core shared library" below) that push-manager, automation and keyboard-visualizer all depend on via require+replace — extracted per discovery/push-core-refactor.md to kill the ALSA/HTTP/SSE triplication that had silently diverged across the three hacks.

Core constraint: Push is a live performance tool. Hacks must not crash it, hog CPU, or consume significant memory.

⛔ Hard safety rules — never violate, no exceptions:

  • Never modify /boot/ — bricks Push.
  • Never modify /opt/ — read-only system partition. Contains Push3 app, firmware, assets.
  • Never modify kernel parameters — no sysctl -w, no /proc/sys/ writes affecting stability.
  • Never write to /etc/ except: /etc/udev/rules.d/99-push-hack-*.rules, /etc/init.d/push-hack-*, and the LD_PRELOAD line in /etc/init.d/push3 (all managed by install/uninstall scripts).

Read the full file on GitHub · 256 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 · 256 lines · 8,031 tokens per session scan A 27e179d2ab4b

Subscribe to this mod's changes

ableton-push-hack CLAUDE.md is an instructions file published in the GitHub repository federico-pepe/ableton-push-hack (24 stars, last pushed yesterday), licensed MIT. It adds 8,031 tokens to every session, about $0.0402 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.