Posez la question.
Votre machine répond.

Comprenez les chiffres de Linux dans votre terminal.
Des réponses courtes, appuyées sur l’état réel de votre machine.

UN COMPAGNON LINUX / DANS VOTRE TERMINAL

Comprendre le chiffre.
Sans perdre le fil.

Obtenez une réponse concrète sans quitter le terminal. Lisez une courte explication, comparez-la avec votre machine, puis allez plus loin quand vous en avez besoin.

Commencer par la réponse.
Des explications simples sur les chiffres de Linux et les questions de tous les jours, avec les pièges et le pourquoi détaillé à côté de chaque fiche.
Lire votre machine.
Les explications sont posées à côté des faits réels du système, de la mémoire disponible à l’état des processus. Pas besoin de root, et rien n’est modifié.
Toujours sous la main.
Utilisez la ligne de commande, parcourez l’interface du terminal ou lisez le livre dans votre navigateur. Le programme contient tout son contenu et fonctionne hors ligne.

UN COMPAGNON LINUX POUR LE TERMINAL

Une fiche,
trois façons d’y accéder.

La même fiche en ligne de commande, en mode interactif, et pour un agent IA via MCP. Le contenu des fiches est en anglais.

● ● ●alice@laptop ~ · atfq freeLINUX
$ atfq free
17.1  free vs available

TL;DR
  - free: memory nobody is using at all, not even as cache.
  - available: what your apps can still get without swapping.
  - Look at available, not free: the available column of
    the Mem: line in free -h.

      free -h

On your machine
  RAM       10.5 GiB available of 15.5 GiB (68%)
            · 1.1 GiB completely free
  Cache     7.5 GiB in buff/cache, 604.0 MiB of it shared
  Swap      256.0 MiB used of 8.0 GiB · swappiness 60

Pitfalls
  - "free" near zero is normal: Linux fills spare RAM
    with page cache.
  - A little swap in use is not a problem by itself.
    What hurts is constant swapping: watch the si and so
    columns of vmstat 1.

Deep dive: 3 questions. Read them with atfq 17.1 --why

$  

La réponse courte, les chiffres de votre machine, les pièges — et l’explication détaillée à une option près.

$ ATFQ 17.1 --WHY

Chaque fiche répond
dans le même ordre.

Les fiches sont rangées comme un livre, avec un sommaire numéroté sur un seul niveau. Tapez un nom, un synonyme, un numéro de chapitre, ou le message d’erreur que vous venez de recevoir. Le premier écran résout le problème.

01 / TL;DR

En bref

Trois lignes, en langage simple. Si une phrase avait sa place dans une page de manuel, elle a été réécrite.

17.4  The page cache
  - Keeps file data in RAM after
    it has been read or written.
  - Shrinks by itself when apps
    need more: nothing to free.
02 / SUR VOTRE MACHINE

Sur votre machine

Des sondes lisent directement /proc, /sys et /etc. Ce qui est vrai ici, pas en général.

On your machine
  Arch   x86_64, made by Intel
  Level  x86-64-v4: programs
         built for this level or
         below run here
03 / POUR ALLER PLUS LOIN

Pour aller plus loin

Le « pourquoi », replié tant que vous ne le demandez pas. Des questions à ouvrir une par une dans l’interface du terminal.

  ▾ Why do zombies exist at all?
  ▸ How is "available" calculated?
  ▸ What is swappiness and when
    should I change it?
Lire la fiche 17.1 dans le livre (en anglais) →

$ ATFQ PROBE

Il regarde.
Il ne touche jamais.

atfq montre des commandes et lit l’état du système. Il n’exécute jamais vos commandes et ne modifie jamais le système : vous pouvez l’utiliser sur un serveur de production.

  • Lit/proc, /sys, /etcPlus les noms des clés dans ~/.ssh, jamais une clé privée.
  • Lancesystemctl, et rien d’autreAvec des arguments fixes et un délai de 500 ms.
  • RéseauJamaisLe contenu est intégré au programme.
  • RootInutileUne sonde qui ne peut pas répondre affiche « needs root ».

$ ATFQ "EXEC FORMAT ERROR"

Collez l’erreur,
obtenez la fiche.

Les fautes de frappe sont pardonnées, et les messages d’erreur servent de recherche.

  • "exec format error"23.2 ELF et « command not found »
  • memroyPas de correspondance exacte : affiche Memory
  • degradedles services systemd en échec
  • 5.1une fiche, par numéro de chapitre
  • ask disk --redactune question à coller dans une IA, sans le nom de votre machine

$ ATFQ TUI

Vos doigts connaissent
déjà les touches.

Le sommaire à gauche, la page à droite. Les touches de vim, avec les répétitions, et la souris si vous préférez.

jk
se déplacer, défiler (5j pour cinq)
hl
changer de panneau
ggG
début, fin
^d^u
une demi-page
Tab
lien ou question suivante
⏎
ouvrir, déplier
^o⌫
retour
/
chercher dans toutes les fiches
?
la question pour une IA sur cette page
r
relancer les sondes

EN PRATIQUE / LES PREUVES

Un problème.
Ce qui a changé.

Choisissez une cible pour lire ce qui s’est passé : le problème, la découverte et le résultat. Chaque histoire cite ses preuves et l’étendue de sa validation.

Démonstration documentée

Peu de mémoire « libre » ne voulait pas dire RAM pleine.

Problème
La machine virtuelle n’affichait que 1,0 Gio entièrement libre sur 3,9 Gio. Lire cette seule colonne faisait paraître la mémoire bien plus juste qu’elle ne l’était.
Découverte
atfq free a expliqué la différence et lu 2,6 Gio disponibles sur la même machine. La démonstration a vérifié les deux chiffres avec free -h.
Résultat
L’explication a orienté le lecteur vers la mémoire disponible et l’activité du swap, avant de prendre le cache pour un manque de mémoire.

$ ATFQ --VERSION

Posez la question
à votre machine.

Linux uniquement. Les binaires prêts à l’emploi sont statiques : aucune libc particulière n’est requise, Alpine compris. Chaque archive est signée et publie sa somme SHA-256.

PRÊT À L’EMPLOI

Exemple pour x86-64 ; utilisez aarch64 sur ARM.

curl -fLO https://github.com/devutils-org/atfq/releases/latest/download/atfq-x86_64-linux.tar.gz
gh attestation verify atfq-x86_64-linux.tar.gz --repo devutils-org/atfq
tar xzf atfq-x86_64-linux.tar.gz
mkdir -p ~/.local/bin
install -m 755 atfq-x86_64-linux/atfq ~/.local/bin/
DEPUIS LES SOURCES

Avec une chaîne de compilation Rust.

git clone https://github.com/devutils-org/atfq
cd atfq
cargo install --path .
POUR VOTRE AGENT IA

Cinq outils MCP en lecture seule sur stdio.

claude mcp add atfq -- atfq mcp
atfq signifie « Ask The F*cking Question » · MIT OR Apache-2.0, code et contenu