gws: όλες οι υπηρεσίες της Google με μία εντολή, από το παράθυρο εντολών

Τι κάνει

Σκέψου το Drive όπως το ξέρεις: ανοίγεις τον περιηγητή, πατάς με το ποντίκι, ψάχνεις με το μάτι, κατεβάζεις ένα αρχείο. Το gws κάνει τις ίδιες δουλειές, αλλά τις γράφεις σε κείμενο, από το κέλυφος — το παράθυρο όπου γράφεις εντολές και πατάς Enter. Ό,τι γράφεται σε κείμενο μπορεί να ξανατρέξει αύριο, μόνο του, χωρίς άνθρωπο μπροστά στην οθόνη.

Ένα παράδειγμα δείχνει αμέσως το πιο δυνατό του σημείο. Θέλεις να δεις τι παραμέτρους δέχεται η ενέργεια που απαριθμεί τα αρχεία σου στο Drive. Δεν ψάχνεις σε εγχειρίδια. Γράφεις:

gws schema drive.files.list

Το εργαλείο απαντά με το σχήμα της μεθόδου: τι κάνει, ότι στέλνει αίτημα ανάγνωσης, και κάθε παράμετρο μία προς μία. Αυτό το κείμενο δεν το έχει γράψει κάποιος μέσα στο εργαλείο. Το διάβασε εκείνη τη στιγμή από την περιγραφή που δημοσιεύει η ίδια η Google. Η Google δηλώνει για κάθε υπηρεσία της, σε μορφή που διαβάζει μηχάνημα, ποιες μεθόδους έχει, τι παραμέτρους δέχεται η καθεμία και τι ζητάει από εσένα· η υπηρεσία αυτή λέγεται Discovery Service. Όταν λέμε API, εννοούμε απλώς την πόρτα που δέχεται αιτήματα από προγράμματα. Το gws δεν ξαναγράφει αυτή την πόρτα· τη διαβάζει τη στιγμή που τρέχει και τη μετατρέπει σε εντολές για σένα.

Από εκεί βγαίνει το κύριο πλεονέκτημα: η λίστα των εντολών δεν ξεφεύγει από την πραγματικότητα της υπηρεσίας. Ό,τι αλλάζει η Google, αλλάζει και ό,τι μπορείς να ζητήσεις, χωρίς να περιμένεις αναβάθμιση που κάποιος θα ετοιμάσει στο χέρι. Η σύνταξη είναι μία για όλες τις υπηρεσίες: gws [sub-resource] [flags] — πρώτα η υπηρεσία, μετά ο πόρος μέσα σε αυτήν, μετά η ενέργεια, και στο τέλος οι προαιρετικές ρυθμίσεις.

Οι υπηρεσίες που καλύπτει είναι δεκατέσσερις — τα αρχεία, τα υπολογιστικά φύλλα, το ταχυδρομείο, το ημερολόγιο, τα έγγραφα, οι παρουσιάσεις, οι εργασίες, οι επαφές, οι συνομιλίες, οι τάξεις, οι φόρμες, οι σημειώσεις, οι βιντεοκλήσεις και οι αναφορές διαχείρισης.

Οι ρυθμίσεις είναι λίγες και σταθερές: παράμετροι, σώμα αιτήματος, μορφή απάντησης, σελίδες, έκδοση υπηρεσίας. Δεν πολλαπλασιάζονται μαζί με τις υπηρεσίες.

Και οι απαντήσεις είναι το δεύτερο μισό της ιστορίας. Κάθε απάντηση βγαίνει ως δομημένο κείμενο με ετικέτες — η μορφή που λέμε JSON. Ένας άνθρωπος το διαβάζει και καταλαβαίνει τι γύρισε· ένα πρόγραμμα τραβάει το κομμάτι που θέλει χωρίς να μαντεύει.

Τέλος, το ίδιο το πρόγραμμα είναι μικρό. Η έκδοση μέσω του διανομέα πακέτων της Node είναι ένας εκκινητής 10.329 bytes με μηδέν εξαρτήσεις· το αυτόνομο αρχείο για Windows είναι 5,88 MB και είναι γραμμένο σε Rust, χωρίς τίποτα εγκατεστημένο από κάτω. Ο κατασκευαστής δηλώνει ότι μαζί του έρχονται πάνω από σαράντα έτοιμες οδηγίες χρήσης για βοηθούς τεχνητής νοημοσύνης· ισχυρισμός του, δεν τον μετρήσαμε.

Τι δεν κάνει

Πρώτο και πιο σημαντικό: δεν είναι επίσημα υποστηριζόμενο προϊόν της Google. Το γράφει το ίδιο, μόνο του, με την εντολή που τυπώνει την έκδοσή του: «This is not an officially supported Google product.» Ανήκει σε αποθετήριο του οργανισμού googleworkspace, αλλά υποστήριξη δεν σημαίνει αυτό: καμία εγγύηση, καμία δέσμευση ότι θα μείνει.

Δεύτερο: δεν σου δίνει πρόσβαση μόνο του. Ζήτησε πραγματικά δεδομένα χωρίς σύνδεση και θα πάρεις άρνηση με κωδικό 401. Δεν είναι βλάβη: το εργαλείο σου λέει ακριβώς τι λείπει. Για τον λογαριασμό σου χρειάζεσαι δικά σου διαπιστευτήρια από έργο που φτιάχνεις στο Google Cloud — άδεια που δίνεις σε μια εφαρμογή χωρίς να της δώσεις τον κωδικό σου, δηλαδή OAuth — μία φορά, μερικά λεπτά.

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

Τέταρτο: δεν έχει παράθυρο, κουμπιά ή εικονίδια. Δεν θα μαντέψει για σένα τι θέλεις να ρωτήσεις.

Πέμπτο: δεν είναι σταθερό στη μορφή του. Το αρχείο περιγραφής του δηλώνει μόνο του «under active development, expect breaking changes as we march toward v1.0»: ενεργή ανάπτυξη, με αλλαγές που θα σπάσουν παλιές χρήσεις, μέχρι την πρώτη σταθερή έκδοση. Μην το βάλεις σε σύστημα που θα τρέχει άθικτο δύο χρόνια.

Έκτο: δεν εκδίδεται τακτικά. Η τελευταία κυκλοφορία, η 0.22.5, ανέβηκε στις 31 Μαρτίου 2026, ενώ η τελευταία πίεση κώδικα στο αποθετήριο είναι στις 3 Νοεμβρίου 2026: ζωντανό αποθετήριο, αργός ρυθμός κυκλοφοριών. Τα 139 ανοιχτά ζητήματα δείχνουν τις εκκρεμότητες.

Έβδομο: δεν υπάρχει έκδοσή του για Python — όποιος δουλεύει με Python θα το καλέσει ως εξωτερικό πρόγραμμα, όχι ως βιβλιοθήκη.

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

Για τον άνθρωπο που θέλει να αυτοματοποιήσει δουλειές στη σουίτα της Google χωρίς να γράψει ούτε τη σύνδεση ούτε τα αιτήματα: αυτά έρχονται έτοιμα, πίσω από μία ομοιόμορφη εντολή.

Για τον άνθρωπο που τρέχει βοηθούς τεχνητής νοημοσύνης μέσα στο παράθυρο εντολών: ο βοηθός τρέχει μία εντολή, παίρνει δομημένο κείμενο, και δουλεύει πάνω σε αυτό.

Για όποιον γράφει προγράμματα και θέλει να δει τι δέχεται μια μέθοδος πριν γράψει κώδικα, χωρίς λογαριασμό και χωρίς κλειδί: του ζητάς το σχήμα και σου το δίνει ζωντανά.

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

Εγκατάσταση

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

Μέσω του διανομέα πακέτων της Node

Ο διανομέας λέγεται npm, είναι το μαγαζί από όπου κατεβάζεις έτοιμα προγράμματα γραμμής εντολών με μία εντολή, και χρειάζεται η Node στην έκδοση 18 ή νεότερη — αυτό το δηλώνει το ίδιο το πακέτο. Από όποιον φάκελο θέλεις, τρέξε:

npm install -g @googleworkspace/cli

Το γράμμα «g» σημαίνει ότι το πρόγραμμα μπαίνει κάπου κεντρικά, ώστε να το φωνάζεις από παντού, όχι μόνο μέσα σε έναν φάκελο έργου. Μετά τον έλεγχο:

gws --version

Αν δεις τον αριθμό της έκδοσης και την ειδοποίηση ότι δεν είναι επίσημο προϊόν της Google, η εγκατάσταση πέτυχε.

Το αυτόνομο αρχείο, χωρίς Node

Αν δεν θέλεις καθόλου Node, πάρε το έτοιμο αρχείο της έκδοσης από τη σελίδα των κυκλοφοριών στο github.com/googleworkspace/cli. Για Windows το αρχείο λέγεται google-workspace-cli-x86_64-pc-windows-msvc.zip, είναι 5,88 MB, και το έχουν κατεβάσει 113.993 άνθρωποι πριν από σένα. Ξεζιπάρισέ το σε φάκελο που φτιάχνεις εσύ, και από μέσα από αυτόν τον φάκελο τρέξε:

gws --version

Εδώ δεν χρειάζεται τίποτα άλλο στη μηχανή: είναι ένα μόνο εκτελέσιμο, χωρίς εξαρτήσεις χρόνου εκτέλεσης.

Η σύνδεση με τον λογαριασμό σου

Μέχρι εδώ βλέπεις σχήματα. Για πραγματικά δεδομένα χρειάζεσαι σύνδεση, και το εργαλείο την περιγράφει μόνο του: ή τρέχεις την εντολή σύνδεσης, ή του δίνεις αρχείο με τα διαπιστευτήριά σου μέσω της μεταβλητής GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE. Τα διαπιστευτήρια έρχονται από έργο που φτιάχνεις στο Google Cloud, στο δωρεάν πλάνο. Μία φορά το στήνεις.

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

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

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

Claude Code

Άνοιξέ το μέσα στον φάκελο του έργου σου και ζήτα του τη δουλειά με λόγια. Ο βοηθός θα τρέξει πρώτα:

gws schema drive.files.list

και μετά, αφού δει ποιες παράμετροι υπάρχουν, την πραγματική κλήση:

gws drive files list --params '{"pageSize": 10}' --format json

Δεν προσθέτεις τίποτα σε κανένα αρχείο ρυθμίσεων. Το μόνο που μπορεί να σου ζητηθεί είναι άδεια για εντολές κελύφους, γιατί οι βοηθοί ζητούν επιβεβαίωση πριν τρέξουν κάτι που δεν έχεις εγκρίνει.

Codex CLI

Το ίδιο ακριβώς μοτίβο, με τον ίδιο διαχωρισμό: πρώτα το σχήμα, μετά η κλήση.

gws schema gmail.users.messages.list

gws gmail users messages list --params '{"maxResults": 5}' --format json

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

Cursor

Εδώ το κέλυφος είναι ενσωματωμένο στον επεξεργαστή. Ο βοηθός τρέχει τις ίδιες εντολές στο τερματικό που βρίσκεται μέσα στο παράθυρο, από τον φάκελο του έργου.

gws schema sheets.spreadsheets.values.get

gws sheets spreadsheets values get --params '{"spreadsheetId": "...", "range": "A1:C10"}' --format table

Όταν λείπει ένα αναγνωριστικό, το δίνεις εσύ — το εργαλείο δεν μαντεύει ποιο φύλλο εννοείς.

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

Κερδίζει στην ομοιομορφία. Δεκατέσσερις υπηρεσίες, μία σύνταξη: μία σελίδα σημειώσεων αντί για επτά.

Κερδίζει στον φακό. Το σχήμα μιας μεθόδου βγαίνει ζωντανά, μέσα σε ένα δευτερόλεπτο, χωρίς λογαριασμό και χωρίς κλειδί. Αυτό είναι το πιο δυνατό σημείο του και το μετρήσαμε.

Κερδίζει στο βάρος. Δεν φορτώνει τίποτα σε καμία συνεδρία, δεν κρατά διεργασία στη μνήμη, δεν ζητά συνδρομή, δεν έχει διεργασίες από πίσω. Μηδέν εξαρτήσεις στο πακέτο, ένα αρχείο 5,88 MB στη χειρότερη περίπτωση.

Κερδίζει και στην αποδοχή: 32.119 αστέρια, 1.986 διακλαδώσεις, 55.182 λήψεις την τελευταία εβδομάδα και 186.794 τον τελευταίο μήνα. Δεν είναι ένα πείραμα ενός ανθρώπου που το ξέχασε.

Χάνει στην ωριμότητα. Η τελευταία κυκλοφορία είναι του Μαρτίου ενώ οι αλλαγές συνεχίζονται: όποιος το βάλει σε κρίσιμη δουλειά, το βάζει με τα μάτια ανοιχτά.

Χάνει, τελικά, στο ότι δεν δεσμεύεται κανείς για αυτό: δεν είναι επίσημο προϊόν της Google και τα 139 ανοιχτά ζητήματα είναι εκεί.

Δοκιμή

Κατέβασα το επίσημο αρχείο της έκδοσης 0.22.5 για Windows, των 5,88 MB, και το ξεζίπαρα σε φάκελο που έφτιαξα εγώ. Από εκεί έτρεξα τέσσερα πράγματα, και αυτά είναι τα μόνα που μέτρησα.

Πρώτο, η έκδοση:

gws --version

Απάντησε gws 0.22.5, και αμέσως από κάτω τύπωσε τη φράση «This is not an officially supported Google product.» Το είπε μόνο του, χωρίς να το ρωτήσω — και είναι το σημαντικότερο που πρέπει να ξέρει κάποιος πριν το βάλει σε δουλειά.

Δεύτερο, το κείμενο βοήθειας:

gws --help

Τύπωσε την επιφάνεια των εντολών και τη λίστα των υπηρεσιών — και οι δεκατέσσερις ήταν εκεί — και ανακοίνωσε τη σύνταξη gws [sub-resource] [flags] με τις ρυθμίσεις για παραμέτρους, σώμα αιτήματος, μορφή απάντησης, σελίδες και έκδοση υπηρεσίας.

Τρίτο, και το πιο δυνατό, το σχήμα:

gws schema drive.files.list

Δούλεψε χωρίς λογαριασμό, χωρίς κλειδί, χωρίς σύνδεση. Γύρισε το πραγματικό σχήμα της μεθόδου, ζωντανά από την υπηρεσία περιγραφής της Google: περιγραφή, τη μέθοδο του αιτήματος, και τους παραμέτρους έναν έναν — ποια συλλογή κοιτάς, με ποιο φίλτρο ψάχνεις, πόσα αποτελέσματα θέλεις τη φορά.

Τέταρτο, η αστοχία. Ζήτησα πραγματικά αρχεία χωρίς να έχω συνδεθεί:

gws drive files list --params '{"pageSize": 5}'

Η απάντηση ήταν καθαρή, με κωδικό 401 και μήνυμα: «Access denied. No credentials provided. Run gws auth login or set GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE to an OAuth credentials JSON file.» Δηλαδή: το εργαλείο δεν σου δίνει πρόσβαση μόνο του, σου λέει όμως ακριβώς τι λείπει. Πολλοί δοκιμάζουν, βλέπουν άρνηση και νομίζουν ότι το εργαλείο είναι χαλασμένο. Δεν είναι: λείπει η σύνδεση.

Αυτά είναι τα μόνα που έτρεξα. Ό,τι άλλο αναφέρεται εδώ από τον κατασκευαστή — όπως οι έτοιμες οδηγίες για βοηθούς — το γράφω ως ισχυρισμό του, όχι ως μέτρησή μου.

Τι κοστίζει

Το εργαλείο. Μηδέν χρήματα. Το gws είναι ανοιχτού κώδικα με άδεια Apache-2.0 και δεν θέλει συνδρομή, ούτε κλειδί που πληρώνεται. Το πραγματικό κόστος είναι χρόνος στησίματος: για πραγματικά δεδομένα χρειάζεσαι δικό σου έργο στο Google Cloud για τα διαπιστευτήρια σύνδεσης (στο δωρεάν πλάνο) — μερικά λεπτά διαδικασίας, όχι χρήμα.

Το πλαίσιο. Δεν είναι διακομιστής MCP, οπότε δεν φορτώνει σχήματα εργαλείων σε κάθε συνεδρία: ο φόρος του σε tokens πριν γράψεις λέξη είναι μηδέν, και δεν χρειάζεται να το δηλώσεις πουθενά. Το βάρος του είναι το ίδιο το πρόγραμμα: 10.329 bytes το πακέτο npm με μηδέν εξαρτήσεις, ή 5,88 MB το αυτόνομο αρχείο για Windows — ένα στατικό δυαδικό, χωρίς GPU και χωρίς τοπικό μοντέλο.

Η δουλειά. Δεν πληρώνεις ανά εντολή· πληρώνεις στα όρια χρήσης των ίδιων των υπηρεσιών Google (τα quotas του λογαριασμού σου), όχι σε κάποιο ταμείο του εργαλείου. Και ένα κόστος σε χρόνο που το μετρήσαμε: χωρίς σύνδεση, κάθε κλήση σε πραγματικά δεδομένα γυρίζει 401 — το gws schema δουλεύει χωρίς λογαριασμό, η ανάγνωση αρχείων όχι.

Η τηλεμετρία. Δεν υπάρχει τηλεμετρία του εργαλείου· οι κλήσεις πάνε στις υπηρεσίες Google με τα δικά σου διαπιστευτήρια.

Ετυμηγορία

Αξίζει αν γράφεις εντολές για δουλειές που επαναλαμβάνονται: εκεί το gws είναι η διαφορά ανάμεσα σε «θα το κάνω όταν βρω χρόνο» και «τρέχει μόνο του κάθε πρωί». Μία σύνταξη για δεκατέσσερις υπηρεσίες, απαντήσεις που τις διαβάζει και άνθρωπος και πρόγραμμα, και ένας φακός για το σχήμα κάθε μεθόδου χωρίς καν λογαριασμό.

Αξίζει ακόμα περισσότερο αν βάζεις βοηθούς τεχνητής νοημοσύνης να δουλεύουν με τα δεδομένα σου: ο βοηθός μαθαίνει ένα πρότυπο εντολών αντί για δεκατέσσερις υπηρεσίες, και δεν πληρώνεις πλαίσιο πριν ξεκινήσεις.

Δεν αξίζει αν θέλεις εφαρμογή με παράθυρα, ή αν χρειάζεσαι κάτι που θα μείνει αμετάβλητο για χρόνια: μια έκδοση κάτω από το 1.0 είναι εργαλείο για δουλειά που αντέχει μια αλλαγή.

Δύο πράγματα να θυμάσαι πριν το εγκαταστήσεις. Πρώτο: το «μηδέν» ισχύει για τα χρήματα, όχι για τον χρόνο. Δεύτερο: δοκίμασε πρώτα το σχήμα χωρίς λογαριασμό· αν σε κερδίσει εκεί, θα σε κερδίσει και μετά τη σύνδεση.

Η δική μου εκτίμηση: το gws είναι από τα καθαρά παραδείγματα μιας αλλαγής που έρχεται — τα εργαλεία γραμμής εντολών ξαναγίνονται ο φυσικός δρόμος για να φτάνει ένας βοηθός στα δεδομένα ενός ανθρώπου, χωρίς να χρειάζεται να του δηλώσεις τίποτα. Το ότι δεν είναι επίσημο προϊόν της Google είναι το πραγματικό του ρίσκο, και το ότι ζει σε ένα αποθετήριο με 32.119 αστέρια είναι η απάντηση σε αυτό.

Πηγές:

https://github.com/googleworkspace/cli

https://registry.npmjs.org/@googleworkspace/cli

https://developers.google.com/workspace