ΤΕΥΧΟΣ 067  ·  17 ΝΟΕΜΒΡΙΟΥ 2026 ELEN RSS
CodeCity
ΑΥΤΟΜΑΤΙΣΜΟΙ № 0023

lefthook: οι έλεγχοι που ξεχνάς γίνονται αυτόματοι, και τρέχουν παράλληλα

Το lefthook είναι ένα δυαδικό αρχείο γραμμένο σε Go που τρέχει τα git hooks — pre-commit, commit-msg, pre-push — παράλληλα, με δικό του αρχείο ρυθμίσεων lefthook.yml, χωρίς Node ή Python κατά την εκτέλεση. Η υπόσχεση: οι έλεγχοι που ξεχνάς γίνονται αυτόματοι, οπότε δεν σπρώχνεις σπασμένο κώδικα. Το ζυγίσαμε στο μηχάνημά μας: 14 MB στον δίσκο, ένα αρχείο, μηδέν εξαρτήσεις, μηδέν tokens στο μοντέλο, μηδέν ευρώ. Και βρήκαμε μία παγίδα που αξίζει να την ξέρεις: ένα σπασμένο hook μπορεί να φαίνεται ότι πέρασε, αν το δοκιμάσεις χωρίς να έχεις κάνει git add.

lefthook: οι έλεγχοι που ξεχνάς γίνονται αυτόματοι, και τρέχουν παράλληλα

Τι κάνει

Έχεις πιάσει τον εαυτό σου να ανεβάζει κώδικα που δεν έχεις ελέγξει. Δεν το έκανες από αμέλεια. Ήσουν κουρασμένος, ή βιαζόσουν, ή απλώς ξέχασες. Το lefthook υπάρχει για να μη συμβεί αυτό.

Δύο λέξεις πρώτα, γιατί χωρίς αυτές το υπόλοιπο δεν βγάζει νόημα. Τα «git hooks» είναι σημεία στα οποία το git σταματά και σου δίνει τον λόγο να τρέξεις κάτι δικό σου πριν προχωρήσει. Το πιο γνωστό είναι το pre-commit: τρέχει ακριβώς πριν κλειδώσει το commit. Το commit-msg τρέχει όταν γράφεις το μήνυμα του commit. Το pre-push τρέχει λίγο πριν στείλεις στον απομακρυσμένο server. Αν ένας από αυτούς τους ελέγχους βγει με σφάλμα, η πράξη μπλοκάρει.

Το lefthook αναλαμβάνει να τρέχει όλα αυτά για σένα. Είναι ένα δυαδικό αρχείο γραμμένο σε Go — δηλαδή ένα εκτελέσιμο που δεν χρειάζεται κάποια γλώσσα ή βιβλιοθήκη εγκατεστημένη από πίσω για να δουλέψει. Τις ρυθμίσεις τις διαβάζει από ένα δικό του αρχείο, το lefthook.yml, όπου γράφεις ποιοι έλεγχοι τρέχουν σε ποιο σημείο. Και το βασικό: τους τρέχει παράλληλα, όχι τον έναν μετά τον άλλον.

Αυτό το τελευταίο είναι όλη η αξία. Σκέψου πέντε ελέγχους που ο καθένας παίρνει δύο δευτερόλεπτα. Σειριακά, δέκα δευτερόλεπτα. Παράλληλα, κοντά στα δύο. Στην πράξη οι έλεγχοι είναι οι ίδιοι που θα έτρεχες και με το χέρι — μόνο που δεν τους θυμάσαι ποτέ, και δεν τους περιμένεις.

Το project το συντηρεί η Evil Martians, το στούντιο πίσω από άλλα γνωστά εργαλεία του οικοσυστήματος. Το αποθετήριο ζει από τον Φεβρουάριο του 2019 και έχει σήμερα 8.953 αστέρια, 329 forks και 105 ανοιχτά issues, με άδεια MIT· η τελευταία δραστηριότητα είναι στις 26 Οκτωβρίου 2026 (αποθετήριο).

Μία διευκρίνιση που τη χρειάζεσαι από την αρχή: το lefthook δεν είναι διακομιστής MCP. Δεν μιλάει με το μοντέλο, δεν φορτώνει σχήμα εργαλείων, δεν καταλαμβάνει χώρο στη συνεδρία σου. Είναι εργαλείο του κελύφους, που τρέχει όταν τρέχει το git. Θα το ξαναπούμε στην ώρα του, γιατί πολλοί το μπερδεύουν με ό,τι άλλο κυκλοφορεί τελευταία.

Τι δεν κάνει

Το όριό του είναι ένα: να μην υποκαθιστά κεντρικό έλεγχο — δεν είναι διακομιστής κανόνων ούτε «έξυπνος» πράκτορας. Δεν ελέγχει τον κώδικα μέσα στη συζήτηση με έναν βοηθό και δεν φορτώνει ή διαχειρίζεται εκτελέσιμα για λογαριασμό σου. Το lefthook απλά τρέχει τα σκριπτάκια που του ορίζεις όταν καλεί το git. Αν αυτά τα σκριπτάκια απαιτούν Node, Python, ή ειδικά εργαλεία, το lefthook δεν τα εγκαθιστά ούτε τα διαχειρίζεται· εμείς το είδαμε να αποτυγχάνει όταν δεν υπήρχαν τα απαιτούμενα περιβάλλοντα.

Επίσης δεν είναι πανάκεια για πολιτικές ομάδας από μόνο του. Τα hooks είναι τοπικά και μπορούν να παρακαμφθούν με –no-verify ή αν κάποιος δεν τρέξει το lefthook install στην κλωνοποίηση. Στην πράξη, για απόλυτη ασφάλεια χρειάζεται να τρέξεις τους ίδιους ελέγχους στο CI. Τέλος, μην το φορτώνεις με πολύ βαριά, μακροχρόνια integration tests· τα παράλληλα jobs επιβαρύνουν το μηχάνημα σου και δεν αντικαθιστούν ένα οργανωμένο pipeline στον server.

Για ποιον είναι

Για όποιον δουλεύει σε ομάδα, ή μόνος σε πολλά project, και θέλει να σταματήσει να στέλνει κώδικα που χαλάει τον κώδικα των άλλων. Ο ερασιτέχνης που μόλις άκουσε τη λέξη «πράκτορας» θα πιάσει το όφελος από την πρώτη φορά που θα ξεχάσει να τρέξει το τεστ: το εργαλείο το τρέχει μόνο του, και το commit δεν κλείνει αν κάτι δεν περνά. Ο επαγγελματίας κερδίζει κάτι πιο ακριβές: σταματά να μεταφέρει τους κανόνες του project στο κεφάλι του, γιατί τους γράφει μία φορά στο YAML και δεν τους ξανασκέφτεται.

Λάμπει όταν το project έχει πολλούς ελέγχους — μορφοποίηση, στατική ανάλυση, τεστ — και ο χρόνος αναμονής σε κάθε commit άρχισε να σε ενοχλεί. Λάμπει σε project που θα ζήσει καιρό, γιατί το μόνο που κληροδοτείς στον επόμενο είναι ένα αρχείο κειμένου.

Δεν είναι για σένα αν δουλεύεις μόνος σε ένα πρόχειρο script που δεν θα το ξαναδείς. Εκεί το κόστος εγκατάστασης δεν το βγάζει. Και δεν είναι για σένα αν θέλεις κάτι που να ελέγχει τον κώδικα μέσα στην κουβέντα με τον βοηθό· αυτό είναι άλλη κατηγορία εργαλείου, και το lefthook δεν την αγγίζει.

Εγκατάσταση

Θέλεις Node, μόνο και μόνο για να κατεβάσει το δυαδικό· από εκεί και πέρα η εκτέλεση δεν χρειάζεται Node ούτε Python. Το πεδίο engines του πακέτου είναι κενό (null) — δεν απαιτεί καμία έκδοση. Το npm εδώ είναι ο μεταφορέας, όχι η μηχανή.

Τρέχεις από τη ρίζα του project σου:

npm i -D lefthook@2.2.2

Μετά γράφεις το lefthook.yml στη ρίζα, με ένα hook που θέλεις. Και μετά λες στο lefthook να εγκαταστήσει το ίδιο το hook στο git:

npx lefthook install

Αυτό γράφει το hook στο .git/hooks/pre-commit — το σημείο που το git διαβάζει μόνο του. Από εδώ και πέρα δεν καλείς τίποτα χειροκίνητα: το git φωνάζει το lefthook κάθε φορά που κάνεις commit.

Μία παγίδα του Windows που τη συναντήσαμε. Το npm δίνει δύο αρχεία: ένα shim με κατάληξη .cmd, και το πραγματικό .exe κάτω από τον φάκελο lefthook-windows-x64. Αν καλέσεις το shim από το κέλυφος bash, παίρνεις «No such file or directory» — δεν είναι σφάλμα του lefthook, είναι το shim που δεν τρέχει έτσι. Μέσα από npx το πρόβλημα δεν εμφανίζεται.

Ο κατασκευαστής τεκμηριώνει κι άλλους δρόμους εγκατάστασης — Homebrew, go install, απευθείας δυαδικό από τις εκδόσεις. Αυτό είναι ισχυρισμός κατασκευαστή: εμείς τρέξαμε μόνο τον δρόμο του npm, και δεν θα σου περιγράψω βήματα που δεν εκτέλεσα.

Χρήση σε κάθε LLM

Εδώ χρειάζεται προσοχή, γιατί το lefthook δεν μοιάζει με τα εργαλεία που συνήθως παρουσιάζουμε. Δεν είναι διακομιστής MCP. Δεν του γράφεις ρύθμιση τύπου mcpServers, δεν δηλώνεις εκτελέσιμο και ορίσματα, δεν κάνεις επανεκκίνηση για να το δει ο βοηθός. Δεν χρειάζεται καν να το δηλώσεις.

Ο λόγος είναι απλός και αξίζει να τον καταλάβεις. Το lefthook κάθεται πάνω στα git hooks. Τα hooks τρέχουν όταν τρέχει το git — άρα και όταν ο βοηθός κάνει commit. Ο πράκτορας δεν χρειάζεται να ξέρει ότι το lefthook υπάρχει· το git το καλεί μόνο του. Το μόνο που προσθέτεις ανά βοηθό είναι μία οδηγία, ώστε να μη σπάσει το hook με παράκαμψη τύπου --no-verify. Δεν έστησα συνεδρία μέσα σε Claude Code, Codex ή Cursor· οι εντολές είναι του κελύφους, και λέω πού το ξέρω.

Claude Code

Γράφεις τη σύμβαση του project στο CLAUDE.md: πριν από κάθε commit τρέχει το hook, χωρίς παράκαμψη. Και αν θέλεις να το δοκιμάσεις ο ίδιος, τρέχεις από τη ρίζα του project:

npx lefthook run pre-commit

Codex CLI

Το ίδιο, σε αρχείο οδηγιών AGENTS.md στη ρίζα. Δεν υπάρχει ενότητα ρυθμίσεων να προσθέσεις — μόνο η σύμβαση και η ίδια εντολή:

npx lefthook run pre-commit

Cursor

Και εδώ το ίδιο σχήμα: μία οδηγία στους κανόνες του project, καμία δήλωση διακομιστή. Για έλεγχο με το χέρι:

npx lefthook run pre-commit

Σε CI

Εδώ φαίνεται η μεγάλη αρετή του YAML: το ίδιο αρχείο δουλεύει και στο CI, χωρίς δεύτερη ρύθμιση. Βάζεις ένα βήμα που τρέχει την ίδια εντολή πριν από το build:

npx lefthook run pre-commit

Έτσι οι κανόνες δεν ζουν στο μηχάνημα του καθενός, αλλά σε ένα αρχείο που περνά από review όπως όλος ο υπόλοιπος κώδικας. Η ίδια ρύθμιση για τοπικά hooks και για CI είναι, κατά τη γνώμη μας, το πιο υποτιμημένο πλεονέκτημα του εργαλείου.

Πού κερδίζει, πού χάνει

Κερδίζει στο κεντρικό: οι έλεγχοι που ξεχνάς γίνονται αυτόματοι. Στη δοκιμή μας, ένα hook που απαγορεύει τη λέξη TODO μπλόκαρε το commit με exit 1 όταν τη βρήκε, και πέρασε με exit 0 όταν το αρχείο ήταν καθαρό.

Κερδίζει στην ταχύτητα. Η εκτέλεση ήταν 0,09 δευτερόλεπτα για ένα hook — και επειδή τρέχουν παράλληλα, η διαφορά μεγαλώνει όσο προσθέτεις ελέγχους. Κερδίζει στην καθαρότητα: ένα στατικό δυαδικό, μηδέν εξαρτήσεις κατά την εκτέλεση, καμία διεργασία που μένει ανοιχτή. Και κερδίζει στο ότι η ρύθμιση είναι ένα αρχείο κειμένου, που το διαβάζει ο άνθρωπος και το εκτελεί το CI το ίδιο.

Τώρα πού χάνει.

Πρώτο, η καινοτομία είναι μέτρια, και θέλουμε να το πούμε καθαρά. Το lefthook δεν ανοίγει καινούργιο δρόμο. Αντικαθιστά το husky — το εργαλείο των JavaScript project που κάνει την ίδια δουλειά. Δεν φέρνει νέα ιδέα· φέρνει καλύτερη εκτέλεση. Παράλληλα αντί σειριακά, ένα στατικό δυαδικό αντί για Node, μηδέν εξαρτήσεις αντί για ένα δέντρο πακέτων. Αυτό δεν είναι μειονέκτημα — είναι ακριβώς ο λόγος που είναι καλή επιλογή για ένα project που θα ζει σε έξι μήνες. Αλλά δεν πρέπει να περιμένεις επανάσταση· περιμένεις κάτι που δουλεύει και δεν σε απασχολεί.

Δεύτερο, η παγίδα της σιωπής. Όταν τρέχεις το hook χωρίς σταθμευμένα αρχεία, παραλείπεται με ένα μήνυμα και βγαίνει με exit 0. Δηλαδή ένα σπασμένο hook μπορεί να φαίνεται «πέρασε», αν το δοκιμάσεις στα τυφλά. Το αναλύουμε στην επόμενη ενότητα, γιατί το βρήκαμε μόνοι μας και είναι το πιο χρήσιμο πράγμα σε αυτό το άρθρο.

Τρίτο, θέλει YAML. Όποιος δεν έχει γράψει ποτέ YAML θα κάνει ένα λάθος στη στοίχιση. Είναι μικρό εμπόδιο, αλλά υπάρχει.

Δοκιμή

Ό,τι ακολουθεί τρέξαμε σε Windows 11, σε Dell Inspiron 3576, με Node 26.7.0, χωρίς κάρτα γραφικών.

Έστησα φρέσκο αποθετήριο git και έγραψα το lefthook.yml με ένα hook που απαγορεύει τη λέξη TODO μέσα στο app.js. Το πρώτο πράγμα που έτρεξα ήταν η εγκατάσταση του hook:

npx lefthook install

Έγραψε το hook στο .git/hooks/pre-commit, όπως περίμενα.

Μετά έβαλα ένα καθαρό app.js, το πρόσθεσα στο staging και έτρεξα τον έλεγχο. Βγήκε exit 0 και τύπωσε «done in 0.09 seconds». Μετά έβαλα μέσα ένα TODO, το πρόσθεσα, και ξανάτρεξα. Βγήκε exit 1 — το commit μπλοκάρει. Δηλαδή η υπόσχεση ισχύει: ο έλεγχος τρέχει, κρίνει, και σταματά το λάθος.

Και μετά η παγίδα, που την ανακάλυψα μόνη μου και αξίζει μία παράγραφο.

Την πρώτη φορά έτρεξα npx lefthook run pre-commit πριν κάνω git add, με άδειο staging. Το hook παραλείφθηκε. Τύπωσε no-todo (skip) no matching staged files και βγήκε με exit 0. Αν δεν το πρόσεχα, θα είχα καταγράψει «πέρασε» — ενώ στην πραγματικότητα δεν είχε τρέξει τίποτα. Αυτή είναι η σιωπηλή αποτυχία που μπορεί να σε κάψει: ένα σπασμένο hook μοιάζει υγιές αν το δοκιμάσεις χωρίς να έχεις σταθμεύσει αρχεία. Το έμαθα όταν η πρώτη μου εκτέλεση βγήκε «καθαρή» χωρίς να έχει ελέγξει τίποτα.

Άρα η συνταγή δοκιμής, με τη σειρά που δουλεύει: εγκαθιστάς με npm i -D lefthook@2.2.2, γράφεις το lefthook.yml, τρέχεις npx lefthook install, κάνεις git add το αρχείο σου, και μετά τρέχεις npx lefthook run pre-commit. Αν παραλείψεις το git add, παίρνεις πράσινο φως για δουλειά που δεν έγινε.

Τι δεν έτρεξα, και το λέω. Δεν έστησα συνεδρία μέσα σε Claude Code, Codex ή Cursor, και δεν θα σου δώσω βήματα που δεν είδα. Δεν μέτρησα κορύφωση μνήμης: η διεργασία ζει περίπου 100 χιλιοστά του δευτερολέπτου, και ένα νούμερο μνήμης από τόσο σύντομη ζωή θα ήταν επινόηση. Τα νούμερα του αποθετηρίου — 8.953 αστέρια, 329 forks, 105 ανοιχτά issues, άδεια MIT, τελευταίο push 26 Οκτωβρίου 2026 — και τα νούμερα του npm — 21.072.106 λήψεις από 26 Σεπτεμβρίου έως 25 Οκτωβρίου 2026, τελευταία έκδοση 2.2.2 δημοσιευμένη 13 Οκτωβρίου 2026 — είναι από την έρευνά μας, όπως τα δίνουν το GitHub και το npm.

Τι κοστίζει

Το μοντέλο. Δικό μας νούμερο: μηδέν tokens. Το lefthook δεν είναι διακομιστής MCP, δεν φορτώνει σχήμα εργαλείων, δεν πιάνει χώρο σε καμία συνεδρία. Δεν πληρώνεις τίποτα στο πλαίσιο του βοηθού, ούτε όταν το χρησιμοποιείς ούτε όταν δεν το χρησιμοποιείς.

Το μηχάνημα. Δικό μας νούμερο: 14 MB στον δίσκο, σε ένα αρχείο — node_modules/lefthook-windows-x64/bin/lefthook.exe, 14.252.032 bytes. Καμία διεργασία που μένει ανοιχτή μετά την εκτέλεση. Μνήμη δεν μέτρησα, για τον λόγο που εξήγησα.

Σε χρήμα, μηδέν. Άδεια MIT, χωρίς κλειδί, χωρίς υπηρεσία, χωρίς λογαριασμό. Δεν υπάρχει πληρωμένο επίπεδο, δεν υπάρχει τηλεμετρία που να ξέρουμε.

Ισχυρισμός κατασκευαστή, όχι δικό μας νούμερο: η υποστήριξη πλατφορμών (macOS, Linux, Windows) και το σύνολο των δυνατοτήτων του YAML. Αυτά τα διαβάζουμε στην τεκμηρίωση, δεν τα δοκιμάσαμε ένα προς ένα.

Ετυμηγορία

Score: 8.3/10.

Το lefthook λύνει ένα πρόβλημα που το ξέρεις αλλά δεν το λες: ανεβάζεις κώδικα που δεν έχεις ελέγξει. Το λύνει αυτόματα, παράλληλα, με ένα στατικό δυαδικό που δεν κουβαλά εξαρτήσεις. Στη δοκιμή μας: exit 0 σε καθαρό αρχείο, exit 1 με ένα TODO, 0,09 δευτερόλεπτα, 14 MB στον δίσκο, μηδέν tokens στο μοντέλο, μηδέν ευρώ.

Τους υπόλοιπους βαθμούς τους κρατά ή τους χάνει για τρεις λόγους. Η καινοτομία είναι μέτρια — αντικαθιστά το husky, δεν ανοίγει δρόμο, και η αξία του είναι η εκτέλεση και η συντήρηση, όχι η ιδέα. Η παγίδα της σιωπής υπάρχει: χωρίς git add, το hook παραλείπεται και βγαίνει με exit 0. Και θέλει YAML, που για κάποιους είναι εμπόδιο.

Πού το προτείνουμε χωρίς δισταγμό: όταν το project θα ζήσει καιρό και θέλεις οι κανόνες να ζουν σε ένα αρχείο κειμένου, ίδιο για το μηχάνημά σου και για το CI. Εκεί το lefthook είναι η σωστή επιλογή, ακριβώς επειδή δεν σε απασχολεί.

Δείτε επίσης

Αν σου χρειάστηκε αυτό, δες και:

Πηγές: αποθετήριο https://github.com/evilmartians/lefthook · πακέτο npm https://www.npmjs.com/package/lefthook · τεκμηρίωση https://lefthook.dev/ · εκδόσεις https://github.com/evilmartians/lefthook/releases

Εγκατάσταση

3 ΒΗΜΑΤΑ
  1. npm i -D lefthook@2.2.2
  2. npx lefthook install
  3. npx lefthook run pre-commit
lefthook: οι έλεγχοι που ξεχνάς γίνονται αυτόματοι, και τρέχουν παράλληλα · ΑΠΟΤΕΛΕΣΜΑ 8,3/10
ΠΗΓΗ
github.com/evilmartians/lefthook