Εντολές & Ρυθμίσεις του Google Antigravity CLI (agy) (Cheat Sheet)

Το Antigravity CLI (agy) είναι ο ελαφρύς, βασισμένος σε Go, εγγενής πράκτορας προγραμματισμού τερματικού της Google στην πλατφόρμα Antigravity 2.0. Σχεδιασμένο για παράλληλη εκτέλεση υποπρακτόρων (subagents), απομόνωση με Git worktrees, Agent Skills, plugins και ενσωματώσεις MCP, το agy αντικαθιστά το καταναλωτικό Gemini CLI.

Αυτός ο οδηγός αναφοράς καλύπτει τις παραμέτρους και υποεντολές του agy CLI, τις διαδραστικές εντολές slash, τις συντομεύσεις πληκτρολογίου, τη διαμόρφωση των .agents/ και mcp_config.json, καθώς και τα βήματα μετάβασης από το Gemini CLI.

🔗 Σχετικοί Οδηγοί Αναφοράς: Σύγκριση Εργαλείων AI Προγραμματισμού Τερματικού · Οδηγός Claude Code CLI · Οδηγός OpenAI Codex CLI · Οδηγός Αρχιτεκτονικής AI Agent Skills

1. Εγκατάσταση, Υποεντολές & Παράμετροι Εκκίνησης

1.1 Εγκατάσταση & Εκκίνηση

# Εγκατάσταση του Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Εκκίνηση διαδραστικού TUI (ακολουθήστε τις οδηγίες ελέγχου ταυτότητας κατά την πρώτη εκτέλεση)
agy

1.2 Βασικές Υποεντολές & Παράμετροι Εκκίνησης

Εντολή / Παράμετρος	Περιγραφή	Παράδειγμα Χρήσης
`agy`	Εκκίνηση διαδραστικού TUI στον ενεργό χώρο εργασίας	`agy`
`agy -p "<prompt>"`	Μη διαδραστική (headless) εκτέλεση, εκτυπώνει την έξοδο στο stdout και τερματίζει	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	Εκκίνηση διαδραστικής συνεδρίας με προσυμπληρωμένη αρχική προτροπή	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	Συνέχιση της πιο πρόσφατης συνεδρίας συνομιλίας	`agy -c`
`agy --conversation <id>`	Φόρτωση συγκεκριμένης ιστορικής συνομιλίας βάσει ID	`agy --conversation 42a506e6-...`
`--mode <mode>`	Ορισμός λειτουργίας δικαιωμάτων εκτέλεσης: `default` · `accept-edits` · `auto` (αυτόματη έγκριση σε sandbox) · `plan`	`agy --mode accept-edits`
`--model <model>`	Παράκαμψη του ενεργού μοντέλου για αυτή τη συνεδρία	`agy --model gemini-3.8-flash`
`--effort <level>`	Ορισμός προσπάθειας συλλογισμού (`low` έως `max`, εξαρτάται από το μοντέλο)	`agy --effort high`
`--agent <agent>`	Επισύναψη προσαρμοσμένου προφίλ πράκτορα κατά την εκκίνηση	`agy --agent reviewer`
`--add-dir <path>`	Παραχώρηση πρόσβασης συμφραζομένων χώρου εργασίας σε επιπλέον κατάλογο (επαναλαμβανόμενη)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	Λίστα διαθέσιμων μοντέλων ή διαμορφωμένων προσαρμοσμένων πρακτόρων	`agy models`
`agy plugin <subcmd>`	Διαχείριση plugins: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. Διαδραστικές Εντολές Slash του TUI

Πληκτρολογήστε / μέσα στο agy για να καλέσετε και να συμπληρώσετε αυτόματα τις ενσωματωμένες εντολές:

2.1 Γενικός Έλεγχος, Συνεδρίες & Ιστορικό

Εντολή	Λειτουργία	Σημειώσεις & Χρήση
`?` / `/help`	Εμφάνιση όλων των διαθέσιμων εντολών slash και συντομεύσεων	Γρήγορη αναφορά εντός συνεδρίας
`/config` / `/settings`	Άνοιγμα διαδραστικού πίνακα ρυθμίσεων πλήρους οθόνης	Επεξεργασία προτιμήσεων, θεμάτων και δικαιωμάτων (`settings.json`)
`/clear`	Εκκαθάριση ενεργού buffer προτροπής και έναρξη νέας συνεδρίας	Καθαρή μετάβαση σε άσχετη εργασία
`/compact`	Συμπίεση και σύνοψη ιστορικού συνομιλίας	Ανάκτηση χώρου συμφραζομένων σε μακρές εκτελέσεις
`/resume`	Άνοιγμα επιλογέα συνομιλιών για επαναφορά προηγούμενων συνεδριών	Συνέχιση διακοπέντων ροών εργασίας
`/rewind` / `/undo`	Μετάβαση προς τα πίσω στους γύρους της συνομιλίας	Επαναφορά λανθασμένων γύρων ή κατεύθυνσης
`/fork`	Διακλάδωση της συνομιλίας στο τρέχον σημείο ελέγχου	Ασφαλής διερεύνηση παράλληλων κλάδων εργασίας
`/exit` / `/quit`	Έξοδος από τη συνεδρία του `agy` CLI	Ή πατήστε `Ctrl + D Ctrl + D`

2.2 Μοντέλα, Ροές Εργασίας, Πράκτορες & Επεκτάσεις

Εντολή	Λειτουργία	Σημειώσεις & Χρήση
`/model`	Αλλαγή του ενεργού μοντέλου AI στη μέση της συνεδρίας	Εξισορρόπηση ταχύτητας/κόστους έναντι ισχύος συλλογισμού
`/effort`	Επιθεώρηση ή ορισμός προσπάθειας συλλογισμού (`low` έως `max`)	Σημείωση: το `agy -p "/effort"` επιστρέφει έξοδο JSON μόνο για ανάγνωση
`/plan`	Δημιουργία σχεδίου βήμα-προς-βήμα πριν την τροποποίηση αρχείων	Δικλείδα ασφαλείας πριν από μεγάλες αρχιτεκτονικές αλλαγές
`/goal`	Αυτόνομη εκτέλεση έως την ολοκλήρωση χωρίς ενδιάμεσες παύσεις	Κατάλληλο για μακροπρόθεσμες εργασίες
`/grill-me`	Εκτέλεση διαδραστικής συνέντευξης απαιτήσεων πριν τον κώδικα	Αποσαφήνιση οριακών περιπτώσεων και κριτηρίων αποδοχής εκ των προτέρων
`/agent`	Εναλλαγή ή κλήση προσαρμοσμένων προφίλ υποπρακτόρων/πρακτόρων	Φορτώνει ορισμούς από το `.agents/agents/`
`/worktree`	Δημιουργία ή διαχείριση απομονωμένων καταλόγων Git worktree	Εργασία σε παράλληλους κλάδους χωρίς ρύπανση του κύριου δέντρου
`/mcp`	Επιθεώρηση ζωντανής κατάστασης σύνδεσης MCP, logs και επαναφόρτωση ρυθμίσεων	Αντιμετώπιση προβλημάτων τοπικών ή απομακρυσμένων διακομιστών MCP
`/plugin`	Περιήγηση, ενεργοποίηση, απενεργοποίηση ή επιθεώρηση Marketplace plugins	Διαχείριση πακέτων skills, rules, hooks και διακομιστών MCP
`/voice`	Εναλλαγή λειτουργίας φωνητικής υπαγόρευσης	Ισοδύναμη συντόμευση: `F5`

3. Συντομεύσεις Πληκτρολογίου Τερματικού & Σύνταξη Εισόδου

Συντόμευση / Σύνταξη	Ενέργεια	Αποτέλεσμα & Σενάριο
`@<path>`	Αυτόματη συμπλήρωση διαδρομής αρχείου	Εισαγωγή συγκεκριμένων διαδρομών αρχείων ή καταλόγων στα συμφραζόμενα
`!<command>`	Ενσωματωμένη εκτέλεση τερματικού	Προσθέστε το πρόθεμα `!` για άμεση εκτέλεση εντολών shell (π.χ. `!npm run build`)
`Ctrl + G`	Άνοιγμα εξωτερικού επεξεργαστή	Συγγραφή μεγάλων ή πολλαπλών γραμμών προτροπών στον προεπιλεγμένο επεξεργαστή (Vim, VS Code)
`Esc Esc`	Εκκαθάριση ενεργού πλαισίου προτροπής	Διαγραφή εκκρεμούς εισόδου όταν δεν υπάρχει ενεργή ροή
`F5`	Εναλλαγή φωνητικής υπαγόρευσης	Ισοδύναμο με το `/voice`
`Ctrl + D Ctrl + D`	Έξοδος από τη συνεδρία	Διπλό πάτημα `Ctrl + D` για καθαρή έξοδο

4. Ιεραρχία Διαμόρφωσης & `mcp_config.json`

4.1 Χάρτης Καθολικών έναντι Τοπικών Καταλόγων Χώρου Εργασίας

Επίπεδο	Καθολική Εμβέλεια (Όλοι οι Χώροι Εργασίας)	Εμβέλεια Χώρου Εργασίας (Τοπική Έργου)	Σκοπός
Ρυθμίσεις CLI	`~/.gemini/antigravity-cli/settings.json`	—	Προτιμήσεις CLI, θέμα, επεξεργαστής και προεπιλογές δικαιωμάτων
Συντομεύσεις Πληκτρολογίου	`~/.gemini/antigravity-cli/keybindings.json`	—	Προσαρμοσμένες αντιστοιχίσεις πλήκτρων τερματικού
Οδηγίες Έργου	`~/.gemini/AGENTS.md` ή `GEMINI.md`	`./AGENTS.md` ή `./GEMINI.md`	Μόνιμες συμβάσεις repo, εντολές build/test, ρόλος (persona)
Μόνιμοι Κανόνες (Always-on)	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	Περιορισμοί παρασκηνίου που εισάγονται αυτόματα στα συμφραζόμενα
Agent Skills	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	Αρθρωτά πακέτα Agent Skills με scripts και πόρους
Ρύθμιση MCP	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	Ορισμοί τοπικών stdio και απομακρυσμένων HTTP διακομιστών MCP

⚠️ Ασύμβατο Σχήμα Απομακρυσμένου MCP (serverUrl): Στο mcp_config.json, οι απομακρυσμένοι διακομιστές HTTP MCP πρέπει να χρησιμοποιούν το serverUrl αντί των παλαιών κλειδιών url ή httpUrl — η χρήση του url προκαλεί σιωπηλές αποτυχίες σύνδεσης.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. Μετάβαση από το Παλαιό Gemini CLI στο `agy`

Το δωρεάν καταναλωτικό επίπεδο και τα αιτήματα Google AI Pro/Ultra στο Gemini CLI τερματίστηκαν στις 18 Ιουνίου 2026 (αφήνοντας μόνο το εταιρικό Gemini Code Assist και ροές με χρεώσιμο API key). Βασικές αντιστοιχίσεις μετάβασης στο agy:

Στοιχείο	Παλαιό Gemini CLI	Antigravity CLI (`agy`)	Ενέργεια Μετάβασης
Runtime & Εκτελέσιμο	Ανοιχτού κώδικα TypeScript (`gemini`)	Multi-agent CLI σε Go (`agy`)	Αλλάξτε τις κλήσεις σε `agy`· η αυτόματη αρχικοποίηση (onboarding) εκτελείται κατά την εκκίνηση
Επεκτάσεις	Επεκτάσεις Gemini CLI	Εγγενή plugins του Antigravity	Εκτελέστε `agy plugin import gemini` για μετατροπή και εισαγωγή
Αρχεία Οδηγιών	`GEMINI.md`	`GEMINI.md` και `AGENTS.md`	Πλήρως συμβατό — τα υπάρχοντα `GEMINI.md` λειτουργούν ως έχουν
Τοπική Διαδρομή Skills	`.gemini/skills/`	`.agents/skills/`	Μετακινήστε τους φακέλους skill στο `.agents/skills/<name>/SKILL.md`
Παλαιά Workflows	`.agents/workflows/`	Μεταφέρθηκαν σε Agent Skills	Μετατρέψτε τα workflows ενός αρχείου σε `.agents/skills/` (`/migrate-workflows`)
Ρυθμίσεις & Κλειδιά MCP	Ενσωματωμένα στο `settings.json` με `url`	Αποκλειστικό `mcp_config.json` με `serverUrl`	Διαχωρίστε τα μπλοκ MCP στο `mcp_config.json` και μετονομάστε το `url` σε `serverUrl`