alf

alf is a skill for Claude Code, Codex from blacktop/alf. It costs 177 tokens per session (3,537 once invoked), scanned A, original, Apache-2.0.

An AI-controlled LLDB toolkit for Apple Mach-O programs on arm64 or arm64e, the executable format and processor architectures used by Apple platforms. LLDB is a debugger used to inspect running programs and crashes.

In plain words
What is it for?
Use it for crash analysis, LLM-guided fuzzing, macOS kernel debugging through supported virtual or remote setups, and interactive inspection of a live target.
Why use it?
It helps investigate why a program crashed, find bugs through fuzzing, or inspect a live kernel without manually driving every debugger command.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Claude Code; mentions Codex; mentions Gemini CLI.

Good fit Use it for crash analysis, LLM-guided fuzzing, macOS kernel debugging through supported virtual or remote setups, and interactive inspection of a live target.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/blacktop/alf/skills
View source ↗ blacktop/alf
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.

Any agent
npx skills add blacktop/alf --skill skills
Clone the repo
git clone --depth 1 https://github.com/blacktop/alf

Made for: Claude Code, Codex.

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 alf

README.md
[![agentmods](https://agentmods.dev/badge/skills/blacktop/alf/skills/github.svg)](https://agentmods.dev/skills/blacktop/alf/skills)
Your own site
<a href="https://agentmods.dev/skills/blacktop/alf/skills"><img src="https://agentmods.dev/badge/skills/blacktop/alf/skills/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 alf

Your own site · 80×15
<a href="https://agentmods.dev/skills/blacktop/alf/skills"><img src="https://agentmods.dev/badge/skills/blacktop/alf/skills.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 177 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,537 The whole file, excluding the scripts and references it only reads on demand.
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.00177 $0.03537
Opus 5.5 $0.00071 $0.01415
Sonnet 5.5 $0.00035 $0.00707
Haiku 4.5 $0.00018 $0.00354

Measured 1mo ago against content hash ab6dcd05ea76, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

alf 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 1mo 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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

  • alf — 100% identical, 0 lines differ
skills/SKILL.md · 219 lines

How it starts

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

alf — Agentic LLDB Fuzzer

alf lets an AI agent drive LLDB over MCP to analyze crashes, fuzz targets, and debug kernels. Target: Apple Mach-O, arm64(e). Agent-first design: every capability is an MCP tool call.

Choose the entry point by goal

Goal Entry point
Post-mortem analysis of a single crash Crash triage
LLM-driven fuzzing campaign Fuzzing
Kernel / remote-stub debugging (VZ, QEMU, KDP) Kernel debugging
Let an agent freely explore a live target Interactive exploration
Plug alf into Claude Code / Codex / Gemini CLI ACP integration

When in doubt: alf server --transport stdio exposes every capability as MCP tools. Everything else is a higher-level orchestrator around that same tool surface.

Before anything else, verify the host is configured: uv run alf doctor. A failing lldb_launch check almost always means macOS Developer Mode is off — see Gotchas.


Crash triage

Use when: the user has a binary and a crashing input (from libFuzzer, AFL++, Jackalope, etc.) and wants to understand the root cause, classify it, and/or generate a minimized/expanded corpus.

Three levels, pick by how much autonomy the agent should have:

Level Command When
Fully scripted pipeline uv run alf analyze --pipeline --binary <bin> --crash <input> Same output every run; good for CI
LLM-in-the-loop director uv run alf director --binary <bin> --crash <input> --mode auto Need the agent to pick which commands to run
Raw MCP surface alf server + lldb_launch → lldb_crash_context → ... Building a custom workflow, or an outer agent already orchestrates

Sub-commands (alf analyze <subcommand>):

  • triage — capture backtrace, registers, disassembly → logs/*.json
  • classify — heuristic exploitability + LLM bucketing
  • report — render a markdown RCA from a triage JSON
  • minimize — shrink a crash input while preserving the stack hash
  • corpus — synthesize new seeds from a crash (add --llm for LLM-guided)

Read the full file on GitHub · 219 lines

Files

What ships with it

8 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 1mo ago First seen · 219 lines · 177 tokens per session scan A ab6dcd05ea76

Subscribe to this mod's changes

alf is a skill published in the GitHub repository blacktop/alf (2 stars, last pushed 6mo ago), licensed Apache-2.0. It adds 177 tokens to every session and 3,537 once invoked, about $0.0007 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-31.

Related

Other skills, from other repositories

platform-diagnostics

A read-only diagnostic procedure for checking whether an OpenQuantum platform's user interface, task runner, skills, and models are connected correctly. It produces a report with evidence for each check.

xi-zhao/OpenQuantum · 52 tokens

mqt-debugger

An MQT Debugger coding skill for inspecting OpenQASM programs, a text format for describing quantum circuits, through step-by-step simulation. It supports assertions, impact analysis, and error diagnosis.

xi-zhao/OpenQuantum · 51 tokens

review-source-dependencies

Inspect a repository and verify how one package reaches a target dependency.

mappedsky/seizu · 18 tokens

a11y-debugging

Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines. Use when testing semantic HTML, ARIA labels, focus states, keyboard navigation, tap targets, and color contrast.

ChromeDevTools/chrome-devtools-mcp · 50 tokens

debug-optimize-lcp

Guides debugging and optimizing Largest Contentful Paint (LCP) using Chrome DevTools MCP tools. Use this skill whenever the user asks about LCP performance, slow page loads, Core Web Vitals optimization, or wants to understand why their page's main content takes too long to appear. Also use when the user mentions…

ChromeDevTools/chrome-devtools-mcp · 99 tokens

ios-simulator

Verify and debug native, React Native, Expo, or Flutter apps on an iOS Simulator with agent-device. Use when an agent needs to launch an app, inspect its live UI, tap, type, scroll, validate a code change, collect failure evidence, or reproduce a workflow on an iPhone or iPad Simulator.

callstack/agent-device · 69 tokens