# yrp604/rappel

A linux-based assembly REPL for x86, amd64, armv7, and armv8

Repository: https://github.com/yrp604/rappel
Canonical: https://ross.abutalabs.com/products/rappel
Language: C
License: NOASSERTION
License Family: other
Topics: repl, asm, armv7, x86, x86-64, linux, x64, rappel, debugger, ptrace, assembly-repl, assembly, assembly-language, armv8, aarch64, amd64, arm64
Last push: 2024-03-07T04:45:15+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3857, "days_push": 909, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1277, forks 65 (observed 2026-08-28T04:04:13.293936+00:00)

## What it is
Rappel is a Linux-based interactive assembly REPL that runs instructions by rewriting and executing a child process's .text section under ptrace, displaying register and flag states after each step. It supports x86, amd64, armv7, and armv8/aarch64 architectures.

## Use cases
- experiment with x86 assembly instructions interactively
- check how an instruction affects CPU registers and flags
- learn assembly language by typing instructions and seeing results
- test single assembly instructions in a pipe for scripting
- explore amd64 and ARM instruction behavior on Linux

## When to choose
- you want a quick interactive way to try assembly instructions on Linux
- you need to see register and flag effects of individual instructions
- you are learning or teaching x86 or ARM assembly

## When to avoid
- you need a full debugger with breakpoints and memory inspection
- you are on Windows or macOS
- you need Thumb mode support on ARM
- your kernel uses grsecurity PAX_MPROTECT, which breaks ptrace-based memory writes

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: interpreter, developer-tools
- domain: developer-tools, operating-systems
- platform: cli
- tags: assembly-repl, ptrace, x86, amd64, armv7, armv8, aarch64, interactive-learning, debugging, command-line, linux

## Member repositories
- yrp604/rappel (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:13.293936+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:02:53.060293+00:00, confidence not recorded.
  - readme: https://github.com/yrp604/rappel (fetched 2026-08-28T04:04:13.293936+00:00, sha cee453215c84)
- Data as of 2026-08-30T08:39:29.467469+00:00.