[English](../../README.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md) | [Italiano](README.it.md) | [Dansk](README.da.md) | [日本語](README.ja.md) | [Polski](README.pl.md) | [Русский](README.ru.md) | [Bosanski](README.bs.md) | [العربية](README.ar.md) | [Norsk](README.no.md) | [Português (Brasil)](README.pt-BR.md) | [ไทย](README.th.md) | [Türkçe](README.tr.md) | [Українська](README.uk.md) | [বাংলা](README.bn.md) | [Ελληνικά](README.el.md) | [Tiếng Việt](README.vi.md) # Mercury CLI Το Mercury CLI (mercury-cli.ai, πακέτο npm `mercury-tech-cli`) εκτελεί πράκτορες AI για συγγραφή κώδικα στο τερματικό σας, μέσα στα δικά σας αποθετήρια git, σε macOS, Linux και Windows. Ιστότοπος: [mercury-cli.ai](https://mercury-cli.ai) · Αποθετήριο: [github.com/Whq02/MercuryCLI](https://github.com/Whq02/MercuryCLI) (`Whq02/MercuryCLI`) · npm: `mercury-tech-cli` Ένας πράκτορας διαβάζει και επεξεργάζεται αρχεία, εκτελεί εντολές shell, περνά βήμα προς βήμα από δοκιμές και αποσφαλματωτές και ελέγχει τα αποτελέσματα. Εσείς επιλέγετε τον πάροχο μοντέλων, το ίδιο το μοντέλο και τι επιτρέπεται να κάνει ο πράκτορας: - **Πολλαπλές συνεδρίες στο Concourse και απομονωμένα worktrees:** εκτελέστε πολλές συνεδρίες δίπλα-δίπλα στο Session Concourse (`/concourse`) και αναθέστε παράλληλη εργασία σε crewmates (συνεργάτες, `Crewmate`) διαφορετικών παρόχων, σε απομονωμένα αντίγραφα εργασίας του `git worktree`, με μισθώσεις αρχείων του έργου, ώστε οι παράλληλοι πράκτορες να μην αντικαθιστούν την εργασία ο ένας του άλλου. - **22 πάροχοι μοντέλων, `/llmhost` και `/localsetup`:** κρατήστε και τους 22 παρόχους συνδεδεμένους ταυτόχρονα (OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot/Kimi, Z.AI/GLM, OpenRouter, Hugging Face, xAI/Grok, Meta/Muse, Mistral, Nous Portal, OpenCode Zen, Qwen, MiniMax, Together AI, Cohere, Groq, Cerebras, Fireworks AI, Melious AI, OrcaRouter) και αλλάζετε παρόχους και μοντέλα μέσα στη συνομιλία. Ανοίξτε το `/llmhost` για να επιλέξετε μοντέλο, να ελέγξετε την κβαντοποίησή του, τον διαχωρισμό `conversations × context` και το επίπεδο σκέψης του, και για να το εκτελέσετε σε μισθωμένη GPU (Runpod, Vast.ai ή Lambda), στον δικό σας υπολογιστή (`mercury host`) ή σε υπάρχοντα διακομιστή. Εκτελέστε ένα τοπικό μοντέλο στο TensorFold με το `/tensorfold` ([docs/TENSORFOLD.md](../TENSORFOLD.md)), ή εκτελέστε `/localsetup` για να εγκαταστήσετε ή να συνδέσετε το Ollama, μαζί με το LM Studio, το vLLM και το llama.cpp. - **Υβριδική μνήμη έργου RAG Mneme:** χρησιμοποιεί ένα σημασιολογικό μοντέλο embeddings BGE 118 MB που εκτελείται στη συσκευή (`bge-base-en-v1.5`), κατάταξη λέξεων BM25, παρακολούθηση αναφορών, καρφιτσωμένους κανόνες αυτολεξεί, αρχικό πλαίσιο εκκίνησης που λαμβάνει υπόψη τον κλάδο, ελέγχους αντιφάσεων κατά την εγγραφή, σημειώσεις παράδοσης μεταξύ συνεδριών και το γράφημα στον περιηγητή, που ανοίγει με το `/memory page`. - **Εργαλεία μεταγλωττιστή, AST και αποσφαλμάτωσης DAP:** συνδέει την ανάλυση κώδικα μέσω LSP και αναδιαρθρώσεις με προεπισκόπηση (`LspRead`, `LspRename`, `LspMoveSymbol`, `LspMoveFile`, `LspCodeAction`, `LspFormat`), δομική αναζήτηση και επανεγγραφή με AST tree-sitter σε 57 γλώσσες (`AstSearch`, `AstEdit`), ενσωματωμένο αποσφαλματωτή Debug Adapter Protocol (`Debug`) με προσαρμογείς (`debugpy`, `js-debug`, `lldb`, `gdb`, `dlv`) για βηματική αποσφαλμάτωση αποτυχημένων δοκιμών σε Python, Node, Go και Rust, καθώς και μόνιμα κελιά `Eval` σε Python και JavaScript. - **`WebSearch` χωρίς κλειδιά και `WebFetch` σε markdown:** αναζητά μέσω της εγγενούς αναζήτησης του παρόχου, κλειδιών Brave ή Tavily, επίσημων API (Stack Exchange, npm, PyPI, crates.io, GitHub, Hacker News, Wikipedia), SearXNG και DuckDuckGo χωρίς κλειδί, και ανακτά δημόσια τεκμηρίωση σε markdown εντός προϋπολογισμού κλήσης 38.000 χαρακτήρων. - **Έλεγχος υπολογιστή, φωνητική είσοδος Whisper, χρονοδρομολόγηση Saturn και γέφυρες προς επεξεργαστές:** ελέγχει εφαρμογές επιφάνειας εργασίας (`Computer`), μεταγράφει τη φωνητική υπαγόρευση push-to-talk στη συσκευή με το Whisper (`/voice`), προγραμματίζει επαναλαμβανόμενες ή μίας χρήσης συνεδρίες με το Saturn (`/saturn`) και συνδέεται με το VS Code μέσω του Agent Client Protocol (`mercury acp`), μαζί με τα Unity, Blender, Godot και Aseprite. - **Δημιουργία βίντεο (`Video`):** στείλτε prompts και αρχεία αναφοράς του έργου σε μια ρυθμισμένη γεννήτρια MiniMax ([docs/VIDEO.md](../VIDEO.md)) και αποθηκεύστε το παραγόμενο MP4 και ένα προαιρετικό καρέ προεπισκόπησης PNG στο 1ο δευτερόλεπτο μέσα στο έργο σας. Το Mercury χρησιμοποιείται για την ανάπτυξη του ίδιου του Mercury: πολλές συνεδρίες και μοντέλα δουλεύουν σε μεγάλες εργασίες. Το δύσκολο είναι να παρακολουθείς αυτή τη δουλειά: τι εκτελείται ακόμη, τι άλλαξε και τι χρειάζεται απόφαση. Κάθε συνεδρία γράφει τη δική της σημείωση παράδοσης όταν τελειώνει, και η επόμενη διαβάζει αυτή τη σημείωση μία φορά στην εκκίνηση, μαζί με τους καρφιτσωμένους κανόνες μου, και έτσι αποτρέπεται η δηλητηρίαση του πλαισίου μεταξύ συνεδριών. ![Η δομική αναζήτηση εντοπίζει τρεις κλήσεις console.log με βάση τη μορφή τους σε τρία αρχεία, και η δομική επεξεργασία τις ξαναγράφει σε logger.debug σε δοκιμαστική εκτέλεση και έπειτα εφαρμόζει την αλλαγή](../media/syntax-search-edit-clean.gif) Το Mercury είναι ανοιχτού κώδικα υπό την Apache License 2.0, όπως και τα SDK στο [sdk/](../../sdk/) και στο [sdk-py/](../../sdk-py/). ## Εγκατάσταση Τα αρχεία έκδοσης είναι διαθέσιμα για Mac με Apple silicon και Intel, Linux x64 και arm64, καθώς και Windows x64 και arm64. Εγκαταστήστε το `git` ξεχωριστά· κάθε αρχείο περιλαμβάνει Node και ripgrep, οπότε δεν χρειάζεται ξεχωριστή εγκατάσταση Node. Επιλέξτε έναν τρόπο εγκατάστασης: ```sh curl -fsSL https://mercury-cli.ai/install | sh # macOS και Linux (x64 και arm64) irm https://mercury-cli.ai/install.ps1 | iex # Windows (x64 και arm64), στο PowerShell 7 brew install Whq02/mercury/mercury # Homebrew: macOS και Linux x64 npm install -g mercury-tech-cli # npm; το `bun install -g mercury-tech-cli` είναι το ίδιο πακέτο mise use -g npm:mercury-tech-cli # mise, μέσω του πακέτου npm ``` Οι διευθύνσεις εγκατάστασης διατηρούν προσεγγιστικές μετρήσεις αιτημάτων σεναρίων ανά πηγή και ημέρα UTC (οι ολοκληρωμένες εγκαταστάσεις δεν μετρώνται)· ο μετρητής δεν αποθηκεύει διεύθυνση IP, συμβολοσειρά user-agent ή cookie. Ανοίξτε ένα νέο τερματικό ή εκτελέστε τη γραμμή `export PATH=…` που εμφανίζει το πρόγραμμα εγκατάστασης του shell, έπειτα ελέγξτε με `mercury --version` και εκτελέστε `mercury` μέσα από ένα αποθετήριο για να ξεκινήσετε την [πρώτη εκτέλεση](#η-πρώτη-εκτέλεση). Στο PowerShell των Windows, καθώς και μετά από εγκατάσταση με Homebrew, npm, bun ή mise, η εντολή `mercury` λειτουργεί στο ίδιο τερματικό.
Μέθοδοι εγκατάστασης, ενημερώσεις και επαλήθευση έκδοσης ### Πώς διαφέρουν οι μέθοδοι εγκατάστασης Τα προγράμματα εγκατάστασης για shell και PowerShell λαμβάνουν τη νεότερη έκδοση για την πλατφόρμα σας, ελέγχουν το SHA-256 της έναντι του `SHA256SUMS.txt`, την αποσυμπιέζουν και εκτελούν τη δική της εντολή `mercury install`. Τόσο το Homebrew όσο και το πακέτο npm είναι καρφιτσωμένα σε συγκεκριμένη έκδοση και δημοσιεύονται ξανά μετά από ετικέτα, γι' αυτό μπορεί να καθυστερούν σε σχέση με τη νεότερη έκδοση. Οι εντολές Homebrew χρησιμοποιούν το πλήρες όνομα tap `Whq02/mercury/mercury` (το απλό `mercury` στο `homebrew-core` είναι άλλο πρόγραμμα). Το πακέτο npm `mercury-tech-cli` είναι ένας εκκινητής που κατεβάζει την καρφιτσωμένη έκδοσή του· το mise εγκαθιστά το ίδιο πακέτο. Η εντολή `mercury install --uninstall` αφαιρεί την εγκατεστημένη έκδοση και το shim της εντολής, διατηρώντας τη διαμόρφωσή σας και τις συνεδρίες σας (αν εγκαταστήσατε τον εκκινητή npm, εκτελέστε επίσης `npm uninstall -g mercury-tech-cli`). Η εγκατάσταση του Mercury γίνεται σε επίπεδο χρήστη και δεν απαιτεί δικαιώματα διαχειριστή. Μπορείτε να εκτελέσετε ξανά μια εντολή εγκατάστασης χωρίς κίνδυνο. ### Διαδρομές εγκατάστασης Οι εκδόσεις βρίσκονται στον κατάλογο διαμόρφωσης, στη διαδρομή `~/.mercury/versions/` (`%USERPROFILE%\.mercury\versions` στα Windows). Η εντολή `mercury` εγκαθίσταται στο `~/.local/bin` σε macOS και Linux, ή στο `%LOCALAPPDATA%\Mercury\bin` στα Windows. Η `mercury install` προσθέτει τον κατάλογο της εντολής στο PATH μία φορά: μια προστατευμένη γραμμή στο αρχείο εκκίνησης του shell σας ή μια καταχώριση στο PATH του χρήστη στα Windows. Ένα νέο τερματικό λαμβάνει την αλλαγή αυτόματα. ### Ενημερώσεις Χρησιμοποιήστε `mercury update` με οποιαδήποτε μέθοδο εγκατάστασης. Για εγκατάσταση με το πρόγραμμα shell ή PowerShell, ή με `mercury install`, η εντολή ενημερώνει το Mercury επιτόπου. Το `--check` ελέγχει για ενημερώσεις, το `--status` αναφέρει την κατάσταση ενημέρωσης, και το `--rollback` επιστρέφει στην προηγούμενη έκδοση, η οποία παραμένει στον δίσκο. Για το Homebrew, η εντολή ζητά επιβεβαίωση πριν εκτελέσει `brew upgrade Whq02/mercury/mercury`. Η προεπιλεγμένη απάντηση είναι όχι· πληκτρολογήστε `y` για έγκριση. Το Mercury εμφανίζει τη ροή εξόδου της εντολής καθώς φτάνει και ελέγχει την εγκατεστημένη έκδοση στο τέλος. Χρησιμοποιήστε `--yes` για να παραλείψετε την ερώτηση στα σενάρια. Ο εκκινητής npm χρησιμοποιεί την ίδια δομή εκδόσεων με τα προγράμματα εγκατάστασης και αναθέτει κάθε εκτέλεση στην εγκατεστημένη έκδοση. Έτσι, το `mercury update` ενημερώνει μια εγκατάσταση npm επιτόπου, μέσω του δικού του καναλιού ενημερώσεων του Mercury. Η εντολή `npm update -g mercury-tech-cli` αλλάζει μόνο την έκδοση που εγκαθιστά το πακέτο κατά την πρώτη εκτέλεση. Το ίδιο ισχύει και με το mise. Το `--check` διαβάζει την ίδια λίστα εκδόσεων για κάθε μέθοδο εγκατάστασης και σας λέει πώς να ενημερώσετε τη δική σας. Όταν υπάρχει διαθέσιμη ενημέρωση, η αρχική οθόνη εμφανίζει μία φορά το `vX.Y.Z available · mercury update` στην κάτω δεξιά γωνία, και η συνομιλία εμφανίζει την ίδια ειδοποίηση μέχρι να ενημερώσετε. Ορίστε `MERCURY_UPDATE_NOTICE=0` για να κρύψετε και τα δύο. Τα αιτήματα εγκατάστασης και ενημέρωσης λαμβάνουν ανώνυμα τη δημόσια λίστα εκδόσεων και τα αρχεία. Μπορείτε να τα εκτελέσετε χωρίς λογαριασμό ή διακριτικό. Αν ένα ανώνυμο αίτημα απορριφθεί, το Mercury συμβουλεύεται το GitHub CLI (`gh`) στο οποίο έχετε συνδεθεί. Μετά από μια ενημέρωση, το Mercury ελέγχει αν η εντολή στο PATH σας δείχνει στην ενημερωμένη εγκατάσταση. Αν προηγείται άλλη εγκατάσταση ή αν η ενημερωμένη εντολή λείπει από το PATH, εξηγεί το πρόβλημα και τη διόρθωση. Το `mercury health` αναφέρει το ίδιο πρόβλημα. ### Επαλήθευση έκδοσης Πριν ενεργοποιήσει μια έκδοση, το Mercury ελέγχει το αρχείο της έναντι του `SHA256SUMS.txt`. Απαιτεί επίσης το φορτίο (payload) να είναι υπογεγραμμένο με το κλειδί έκδοσης του Mercury, από τη λίστα εμπιστοσύνης που είναι ενσωματωμένη στο πρόγραμμα, πριν προετοιμάσει την ενημέρωση. Μια απορριφθείσα υπογραφή αφήνει την ενεργή εγκατάσταση αμετάβλητη. Χρησιμοποιήστε το `--allow-unsigned` για να αποδεχθείτε ένα φορτίο χωρίς υπογραφή. Το Mercury εξακολουθεί να απορρίπτει άγνωστα κλειδιά υπογραφής, κατεστραμμένα μπλοκ υπογραφής και τροποποιημένο περιεχόμενο. Το αποτέλεσμα της εντολής και η τοπική της εγγραφή δείχνουν και τα δύο ότι επιτρέψατε ένα φορτίο χωρίς υπογραφή. Τα αρχεία έκδοσης είναι υπογεγραμμένα. Εκτελέστε `mercury health` για να ελέγξετε την υπογραφή της εγκατεστημένης έκδοσης. Ένα αρχείο χωρίς υπογραφή έκδοσης επισημαίνεται ως μη υπογεγραμμένο. Η εγκατάσταση και η ενημέρωση το απορρίπτουν, εκτός αν δώσετε `--allow-unsigned`. Το [docs/TRUST.md](../TRUST.md) εξηγεί τα αποτελέσματα επαλήθευσης και πώς να ελέγξετε ένα αρχείο χειροκίνητα. Το [docs/TERMINAL-RUNTIME.md](../TERMINAL-RUNTIME.md) καλύπτει την επαλήθευση κατά την εκκίνηση. ### Σημειώσεις πλατφορμών Υπάρχουν αρχεία έκδοσης για κάθε πλατφόρμα της παραπάνω λίστας. Κάθε άλλο μηχάνημα κάνει κατασκευή από τον πηγαίο κώδικα. Διατίθενται αρχεία έκδοσης για Intel Mac.
## Απαιτήσεις Τα αρχεία έκδοσης περιλαμβάνουν το Node 24 LTS. Ο εκκινητής, το `mercury install` και το `mercury update` χρησιμοποιούν αυτό το ενσωματωμένο runtime· το `git` είναι η μόνη ξεχωριστή απαίτηση για την ίδια την έκδοση. Για κατασκευή από τον πηγαίο κώδικα χρειάζεστε: - **Node 24 LTS**, στην υποστηριζόμενη περιοχή `>=24.20.0 <25`. Το `.node-version` καρφιτσώνει το patch που χρησιμοποιείται για τις κατασκευές και περιλαμβάνεται στα αρχεία έκδοσης. - **bun 1.4.4** για την κατασκευή. Δεν περιλαμβάνεται στις εκδόσεις. - **git**. Στα Windows, εκτελέστε το PowerShell 7 μέσα στο Windows Terminal ή στο τερματικό του VS Code. Δείτε το [docs/INSTALL-WINDOWS-FROM-SOURCE.md](../INSTALL-WINDOWS-FROM-SOURCE.md). Το ελάχιστο όριο του Node περιλαμβάνει τη διόρθωση για το nodejs/node#56645. Κάτω από την 24.20.0, οι headless εντολές `run` που καλούν εργαλείο διακόπτονται κατά την έξοδο στα Windows. Οι εκκινητές επιλέγουν το Node με την εξής σειρά: το ρητά ορισμένο εκτελέσιμο `MERCURY_NODE`, το ενσωματωμένο runtime και έπειτα μια συμβατή εγκατάσταση Node στο PATH. Αν λείπει το runtime, ο εκκινητής αναφέρει σφάλμα. ### Shell στα Windows Τα αρχεία έκδοσης περιλαμβάνουν τη μηχανή shell του Mercury (`brush`), συμβατή με bash, και στα Windows εξυπηρετεί το εργαλείο Bash από προεπιλογή: βρίσκει ένα πρόγραμμα `.cmd` ή `.bat`, όπως το `npm`, με το απλό του όνομα μέσω του PATHEXT, περνά το `%VAR%` και το `^` σε αρχείο batch χωρίς αλλαγές, εκτελεί ένα πρόγραμμα που δίνεται με σχετική διαδρομή μετά από `cd`, και διατηρεί την κατάσταση του shell μεταξύ των κλήσεων. Το `bash.exe` του Git for Windows δεν απαιτείται· αν είναι εγκατεστημένο, το `MERCURY_SHELL_ENGINE=system` ή η τιμή `system` στο `/config`, στο Shell engine, εκτελεί το εργαλείο Bash μόνο μέσω του `bash.exe`. Διαβάστε τη γραμμή `shell` του ελέγχου κατάστασης για να δείτε ποιο shell είναι ενεργό και γιατί: την ενσωματωμένη μηχανή (η προεπιλογή στα Windows, ή ενεργοποιημένη από την καρφίτσα ή τη ρύθμιση) ή το Git Bash, όταν η μηχανή έχει απενεργοποιηθεί ή το πακέτο της λείπει. Σε macOS και Linux, το προεπιλεγμένο shell είναι το shell του συστήματος· ορίστε `MERCURY_SHELL_ENGINE=brush`, ή επιλέξτε `brush` στο `/config`, στο Shell engine, ώστε να εκτελείται και εκεί το εργαλείο Bash στην ενσωματωμένη μηχανή, με μόνιμη κατάσταση shell. Μια κατασκευή από τον πηγαίο κώδικα χωρίς το πακέτο μηχανής ή το Git for Windows εκκινεί κανονικά, αλλά το εργαλείο Bash δεν είναι διαθέσιμο. Το εργαλείο PowerShell παραμένει διαθέσιμο, και η διάγνωση `shell` εξηγεί πώς να επαναφέρετε την υποστήριξη του Bash. ## Κατασκευή από τον πηγαίο κώδικα Το Mercury κατασκευάζεται με bun και εκτελείται σε Node 24 LTS. Εγκαταστήστε [τις απαιτήσεις κατασκευής από τον πηγαίο κώδικα](#απαιτήσεις), συμπεριλαμβανομένου του bun 1.4.4: ```sh curl -fsSL https://bun.com/install | bash -s -- bun-v1.4.4 # macOS και Linux powershell -c "& ([scriptblock]::Create((irm https://bun.com/install.ps1))) -Version 1.4.4" # Windows, στο PowerShell 7 bun --version # 1.4.4 ``` Έπειτα, σε ένα κλώνο αυτού του αποθετηρίου: ```sh bun run setup # μία φορά· bun install + τα vendored πακέτα bun run build.ts # γράφει τα dist/mercury.mjs + dist/manifest.json node dist/mercury.mjs --version node dist/mercury.mjs node dist/mercury.mjs health --json ``` ### Υποστήριξη τερματικού Η διεπαφή πλήρους οθόνης χρειάζεται πραγματικό TTY, αλλά δεν έχει ελάχιστο μέγεθος τερματικού. Η πλήρης διάταξη ξεκινά από 100 στήλες επί 26 γραμμές· τα μικρότερα παράθυρα χρησιμοποιούν συμπαγή διάταξη. Το Mercury χρησιμοποιεί χρώμα 24 bit όταν το τερματικό δηλώνει υποστήριξη μέσω του `COLORTERM=truecolor` ή αναγνωρίζεται ως iTerm2, Ghostty, WezTerm, Kitty, Windows Terminal ή VS Code. Τα άλλα τερματικά χρησιμοποιούν 256 χρώματα, μεταξύ αυτών και το Terminal της Apple στο macOS 15 και σε παλαιότερες εκδόσεις. Η γραμμή Terminal color του ελέγχου κατάστασης αναφέρει το εντοπισμένο βάθος χρώματος και την αιτία. Ορίστε `MERCURY_TRUECOLOR=1` για ένα τερματικό που υποστηρίζει πραγματικό χρώμα αλλά δεν το δηλώνει, ή `MERCURY_TRUECOLOR=0` για να επιβάλετε 256 χρώματα. ### Προαιρετικά στοιχεία Το `setup` ανακτά τα ενσωματωμένα πακέτα δυνατοτήτων: pyright, debugpy, js-debug, επιπλέον γραμματικές, το runtime του Node για την πλατφόρμα και το brush. Αν μια λήψη αποτύχει, εκείνο το πακέτο παραλείπεται, και η κατασκευή και τα επηρεαζόμενα εργαλεία αναφέρουν το ελλείπον στοιχείο. Η εκτέλεση μόνο του `bun install` παράγει κατασκευή χωρίς αυτά τα πακέτα. Για να υποστηρίξετε φωνητική είσοδο, εκτελέστε το `setup` με εγκατεστημένο το Rust. Έτσι μεταγλωττίζεται το `native/voice`. Προσθέστε το cmake για να μεταγλωττιστεί και το `native/whisper`. Με εγκατεστημένο το Rust, το `setup` μεταγλωττίζει επίσης το addon του οδηγού επιφάνειας εργασίας (`native/desktop`), μέσω του οποίου λειτουργεί το εργαλείο `Computer`. Επίσης με εγκατεστημένο το Rust, το `setup` μεταγλωττίζει το τοπικό addon embeddings (`native/embed`, `bun run scripts/vendor/build-embed.ts`) και ανακτά το μοντέλο BGE των 118 MB (`bun run scripts/vendor/fetch-embed-models.ts --default`)· χωρίς cargo, το πακέτο παραλείπεται, το setup το αναφέρει, και η αναζήτηση στη μνήμη Mneme γίνεται μόνο με αντιστοίχιση λέξεων. Κάθε αρχείο έκδοσης περιέχει το πακέτο embeddings που έχει μεταγλωττιστεί για την πλατφόρμα του· σε Linux και Windows, οι υπολογισμοί τρέχουν σε διανυσματοποιημένο πυρήνα, οπότε μια ανάκληση με βάση το νόημα (Recall) διαρκεί περίπου ένα δέκατο του δευτερολέπτου (μερικά εκατοστά σε macOS, όπου χρησιμοποιείται το Accelerate). Αν μια εγγενής κατασκευή δεν έχει τα εργαλεία της, το setup την παραλείπει και ο έλεγχος κατάστασης αναφέρει το ελλείπον addon. Η μηχανή shell των Windows μεταγλωττίζεται επίσης στον υπολογιστή σας, επειδή το upstream δεν έχει δυαδικό αρχείο για Windows. Δείτε το [Shell στα Windows](#shell-στα-windows) και το [docs/TERMINAL-RUNTIME.md](../TERMINAL-RUNTIME.md) για τη μηχανή shell `brush`. Η κατασκευή γράφει μόνο στον κατάλογο `dist/`. Η διαμόρφωση και οι συνεδρίες βρίσκονται στο `~/.mercury`, ή στον κατάλογο που ορίζει το `MERCURY_CONFIG_DIR`, και δημιουργούνται κατά την πρώτη εκτέλεση. Στα Windows, εκτελέστε απευθείας το `node dist\mercury.mjs`. ### Εγκατάσταση κατασκευής από τον πηγαίο κώδικα ως εντολής Το `scripts/ops/deploy-runtime.sh` δημοσιεύει μια κατασκευή από καθαρό δέντρο σε νέο φάκελο `/runtime/builds/` και δείχνει το `runtime/current` σε αυτόν (το `runtime/dist` είναι το παλαιότερο όνομα του ίδιου συνδέσμου). Το `scripts/ops/deploy-launcher.sh` εγκαθιστά τον εκκινητή στο `/bin/mercury`. Προσθέστε αυτόν τον κατάλογο στο PATH· για zsh: ```sh echo 'export PATH="$HOME/.mercury/bin:$PATH"' >> ~/.zshrc ``` Ο εκκινητής σταματά με σφάλμα αν λείπει το runtime. Δεν μεταβαίνει σε άλλη κατασκευή. Η επιλογή του Node ακολουθεί τη σειρά της ενότητας [Απαιτήσεις](#απαιτήσεις). Για εγκατάσταση έκδοσης, εκτελέστε `mercury install` ή `mercury update`, που δεν αλλάζουν τα αντίγραφα εργασίας του πηγαίου κώδικα· δείτε [Ενημερώσεις](#ενημερώσεις). Το [AGENTS.md](../../AGENTS.md) είναι ο σύντομος οδηγός κατασκευής και εκτέλεσης. Το [BUILD-NOTES.md](../../BUILD-NOTES.md) καλύπτει την κατασκευή με περισσότερες λεπτομέρειες. ## Η πρώτη εκτέλεση Στην πρώτη διαδραστική εκτέλεση, επιλέξτε εμφάνιση και έπειτα συνδεθείτε σε έναν πάροχο. Η οθόνη προεπισκοπεί τις αλλαγές θέματος καθώς περιηγείστε. Το True Black είναι η προεπιλογή· οι άλλες επιλογές είναι το θέμα oasis dark και το Black and white, το οποίο δεν εφαρμόζει χρώμα: χρησιμοποιεί τα δικά του χρώματα κειμένου και φόντου του τερματικού, όπως φαίνεται το Mercury σε τερματικό χωρίς χρώμα. Μπορείτε να το αλλάξετε αργότερα με το `/appearance`. Μπορείτε επίσης να επιλέξετε «sign in later» για να περιηγηθείτε χωρίς να συνδέσετε λογαριασμό. Όταν ένα κλειδί παρόχου στο περιβάλλον σας έχει ήδη συνδέσει έναν πάροχο, το βήμα σύνδεσης δεν εμφανίζεται. Στη συνέχεια, το βήμα Guardrails σάς υπενθυμίζει να ελέγχετε τις αλλαγές και τις εντολές του Mercury, καθώς και ότι όσα διαβάζει μπορεί να περιέχουν οδηγίες για το μοντέλο. Σε τερματικό που το Mercury ξέρει να ρυθμίζει (Terminal.app, η οικογένεια VS Code, Alacritty, Zed), ένα βήμα Terminal keys μπορεί να ρυθμίσει τις συντομεύσεις αλλαγής γραμμής στις ρυθμίσεις του ίδιου του τερματικού (στο Terminal.app σε macOS ορίζει το `Option+Enter` για αλλαγή γραμμής και σιωπά τον ήχο ειδοποίησης του τερματικού σε όλα τα προφίλ, κάτι που ισχύει μετά την επανεκκίνηση του Terminal.app· στην οικογένεια VS Code, στο Alacritty και στο Zed γράφει το `Shift+Enter` για αλλαγή γραμμής). Είναι απενεργοποιημένο εκτός αν το επιλέξετε, και διατηρείται αντίγραφο ασφαλείας. Στη συνέχεια, το Mercury ρωτά αν εμπιστεύεστε τον φάκελο που ανοίξατε. Τίποτα από όσα ζητά η διαμόρφωση του χώρου εργασίας δεν εκτελείται πριν χορηγήσετε αυτή την εμπιστοσύνη. Η χορήγηση καλύπτει ολόκληρο το αποθετήριο· αν την αρνηθείτε, το Mercury τερματίζει. Δείτε το [docs/TRUST.md](../TRUST.md). Μια συνηθισμένη διαδραστική εκκίνηση ανοίγει την αρχική οθόνη. Έχει δέκα καταχωρίσεις μενού, και η Continue Last Session εμφανίζεται μόνο αφού αποκτήσετε ιστορικό συνεδριών: - **New Session in \** ξεκινά μια νέα συνεδρία στον τρέχοντα φάκελο. - **Continue Last Session** επιστρέφει στην πιο πρόσφατη συνομιλία σας. - **Boot Menu** ρυθμίζει τις μελλοντικές συνεδρίες, συμπεριλαμβανομένων των motion και crewmates. - **MCPs & Skills** επιλέγει τι θα φορτώσει η επόμενη συνεδρία. Δείτε το [docs/KIT.md](../KIT.md). - **Agents** δημιουργεί και επεξεργάζεται πράκτορες. - **Health Check** ελέγχει την εγκατάσταση. - **Saturn Scheduler** προγραμματίζει συνεδρίες. Δείτε το [docs/SATURN.md](../SATURN.md). - **Logins** συνδέει λογαριασμούς παρόχων. - **Session Concourse** ανοίγει τη λίστα συνεδριών του τρέχοντος έργου. - **Sessions · Projects** σάς επιτρέπει να επιλέξετε συνεδρία ή αποθετήριο. Οι καταχωρίσεις του μενού ανοίγουν πάνω από την αρχική οθόνη, και το `Esc` επιστρέφει στην καταχώριση που επιλέξατε. Η λίστα συνεδριών ανοίγει σε χωριστή οθόνη, και είναι διαθέσιμη και με `Shift+→`. Ένα όρισμα prompt, το `--continue` ή το `--resume` σάς οδηγεί απευθείας στη συνομιλία. ### Motion και crewmates Η ενότητα Performance του Boot Menu περιλαμβάνει τη ρύθμιση Motion: `auto`, `full`, `reduced` ή `off`. Ελέγχει την κινούμενη εικόνα αναμονής στη διεπαφή και είναι διαθέσιμη επίσης στο `/config`. Στην ενότητα Agents, ο διακόπτης Crewmates καθορίζει αν οι νέες συνεδρίες λαμβάνουν το εργαλείο Crewmate. Η απενεργοποίηση του διακόπτη αφαιρεί το εργαλείο· οι προσπάθειες εκκίνησης αυτού του είδους εργασίας επιστρέφουν την ίδια εξήγηση. Μέσα σε μια συνεδρία, το `/crewmates on|off` αλλάζει τη ρύθμιση από τον επόμενο γύρο. ## Η καθημερινή ροή: Session Concourse, git worktrees και crewmates ### Έναρξη συνεδρίας και απομόνωση worktrees Πατήστε `Enter` στο New Session για να δημιουργήσετε συνεδρία στον τρέχοντα φάκελο με το προεπιλεγμένο μοντέλο σας. Το Mercury ανοίγει τη συνομιλία του και την προσθέτει ταυτόχρονα στη λίστα συνεδριών. Κρατά μια έτοιμη διεργασία πίσω από το μενού, για να μειώσει την εργασία κατά την εκκίνηση. Η εκκίνηση μιας άλλης συνεδρίας δεν σταματά την προηγούμενη. Μπορείτε να αφήσετε μια εργασία να τρέχει και να δουλέψετε αλλού. Εκκινήστε με `--worktree [name]` (ή ζητήστε ένα `worktree` στη συνομιλία, για να εκτελεστεί το `EnterWorktree`), ώστε η συνεδρία να αποκτήσει δικό της κλάδο και δικό της αντίγραφο εργασίας κάτω από το `.mercury/worktrees/`. Οι παράλληλοι crewmates μπορούν επίσης να εκτελούνται σε απομονωμένα worktrees και να συντονίζουν κοινά αρχεία με μισθώσεις αρχείων του έργου· δείτε [Τι περιλαμβάνει](#τι-περιλαμβάνει-μνήμη-mneme-rag-lsp-ast-για-57-γλώσσες-αποσφαλματωτής-dap-αναζήτηση-στον-ιστό-και-γέφυρες) και [docs/CREW.md](../CREW.md). ### Εργασία στη συνομιλία Περιγράψτε την εργασία με απλά λόγια. Ο πράκτορας διαβάζει, επεξεργάζεται, εκτελεί και ελέγχει κώδικα βάσει της λειτουργίας δικαιωμάτων που επιλέξατε. Οι κλήσεις εργαλείων εμφανίζονται καθώς εκτελούνται, είτε ως συμπαγείς κάρτες είτε με πλήρη έξοδο. Επιλέξτε την εμφάνιση στο `/config`, στην ενότητα Tool output· η ρύθμιση αποθηκεύεται για τις επόμενες εκκινήσεις. Χρησιμοποιήστε τα `/model` και `/effort` για να ρυθμίσετε τη συνεδρία. Το `/permissions` ελέγχει τι μπορεί να εκτελείται χωρίς έγκριση και τι πρέπει να ζητά πρώτα άδεια. Ελέγξτε τις αλλαγές με το `/diff`, ανά πηγή, αρχείο και τμήμα (hunk). Το `! ` εκτελεί μια εντολή shell μέσα στη συνομιλία, με ζωντανή προβολή των τελευταίων γραμμών της εξόδου. Το `/runs` εμφανίζει τα shell και τους crewmates που τρέχουν (το `/tasks` ανοίγει τον ίδιο πίνακα), και το `/crewmates` ανοίγει τη ζωντανή προβολή Crew. Μεταξύ των γύρων, το `/clear` αποθηκεύει την τρέχουσα συνομιλία και ανοίγει μια νέα συνεδρία, ενώ το `/restart` μεταφέρει τη συνομιλία σε μια νεοεγκατεστημένη έκδοση του Mercury. Το `/title` ονομάζει τη συνομιλία και το `/help` παραθέτει τις διαθέσιμες εντολές. ### Μετάβαση μεταξύ οθονών Τα `Shift+←` και `Shift+→` μετακινούν ανάμεσα στις οθόνες που είναι διαθέσιμες αυτή τη στιγμή. Μια νέα εκκίνηση έχει την αρχική οθόνη και τη λίστα συνεδριών. Η οθόνη συνομιλίας προστίθεται όταν εστιάζεται μια συνεδρία και αφαιρείται όταν κλείσει η τελευταία συνομιλία. Οι υποδείξεις πλήκτρων εμφανίζουν μόνο τις διαθέσιμες μετακινήσεις. Το κλείσιμο όλων των συνομιλιών σάς επιστρέφει στην αρχική οθόνη. Χρησιμοποιήστε το `--chat` για να έχετε μόνο την αρχική οθόνη και τη συνομιλία, χωρίς τη λίστα συνεδριών. Το `--concourse-off` αποθηκεύει αυτή την προτίμηση για τις μελλοντικές εκκινήσεις· το `--concourse-on` ή το `/config` την ενεργοποιεί ξανά. ### Διαχείριση συνεδριών στο Session Concourse Ανοίξτε τη λίστα συνεδριών με το `/concourse` ή με `Shift+→` από την αρχική οθόνη. Εμφανίζει πρώτα τις συνεδρίες που τρέχουν στο τρέχον έργο, ακολουθούμενες από τις αποθηκευμένες συνομιλίες που δεν τρέχουν, με τη νεότερη πρώτη. Κάθε συνεδρία που τρέχει έχει ένα κελί NOW με την τρέχουσα δραστηριότητά της. Επιλέξτε μια γραμμή και πατήστε `Enter` για να επιστρέψετε στη συνομιλία, ενώ οι υπόλοιπες συνεδρίες συνεχίζουν να τρέχουν. Μια συνεδρία που κατέρρευσε παραμένει στη λίστα συνεδριών ως NEEDS YOU, μαζί με την αιτία, έως ότου την απελευθερώσετε. Το [docs/SESSIONS.md](../SESSIONS.md) καλύπτει τον κύκλο ζωής της συνεδρίας. ## Πάροχοι και μοντέλα: συνδέσεις, `/localsetup` και `/llmhost` Χρησιμοποιήστε το `/logins` για να συνδέσετε έναν πάροχο. Ανοίγει τον ίδιο κατάλογο συνδέσεων που χρησιμοποιείται κατά τη ρύθμιση. Το `/accounts` διαχειρίζεται αργότερα τις συνδεδεμένες θέσεις παρόχων. - **OpenAI:** συνδρομή ChatGPT ή κλειδί API. - **Anthropic:** συνδρομή Claude, σύνδεση στο Console ή κλειδί API. - **OpenRouter:** πρόσβαση στον κατάλογο μέσω OAuth ή κλειδιού API· τα αιτήματα προς τα μοντέλα απαγορεύουν τη συλλογή δεδομένων και απαιτούν πάντα από τον πάροχο να υποστηρίζει όλες τις παραμέτρους του αιτήματος. Το `/config → OpenRouter routing policy` ορίζει τις επιλογές εφεδρικής διαδρομής και μηδενικής διατήρησης δεδομένων· επιλέξτε open για να χαλαρώσετε την πολιτική και να αφήσετε τη δρομολόγηση στο OpenRouter. - **Google Gemini:** Sign in with Google, κλειδί API ή δικός σας πελάτης OAuth. Το Sign in with Google εκτελεί το Gemini με βάση την ποσόστωση του πακέτου που έχει ο λογαριασμός Google (δωρεάν λογαριασμός, Google AI Pro ή Google AI Ultra), μέσω του δικού του πελάτη Antigravity της Google: το prompt, τα σχήματα των εργαλείων και τα αποτελέσματα των εργαλείων στέλνονται στο τελικό σημείο Code Assist της Google, μέσω αυτού του πελάτη και του συνδεδεμένου λογαριασμού, και το `/model` εμφανίζει τη λίστα μοντέλων που η Google παρέχει στον λογαριασμό. Ένα κλειδί API ή ο δικός σας πελάτης OAuth χρεώνει αντί γι' αυτό ένα έργο Cloud. - **Hugging Face:** σύνδεση με κωδικό συσκευής ή διακριτικό Hub. - **Kimi (Moonshot):** σύνδεση με κωδικό συσκευής ή κλειδί API. - **GLM (Z.AI):** κλειδί συνδρομής GLM Coding Plan ή γενικό κλειδί API πληρωμής κατά χρήση. Το `/logins zai` αποθηκεύει οποιοδήποτε από τα δύο και καταγράφει το πακέτο· το `ZAI_API_KEY` λειτουργεί επίσης, και το `ZAI_KEY_PLAN=coding|general` ονομάζει το πακέτο (αν δεν είναι ορισμένο, το Mercury το διαβάζει από τη λίστα μοντέλων του ίδιου του κλειδιού). - **DeepSeek:** κλειδί API από την πλατφόρμα DeepSeek (`/logins deepseek`, ή `DEEPSEEK_API_KEY`). - **xAI (Grok):** συνδεθείτε με τη συνδρομή σας Grok (SuperGrok / X Premium) ή επικολλήστε ένα κλειδί API μέσω του `/logins xai`. - **Meta (Muse):** Sign in with Meta (συνδρομή Muse Code, κωδικός συσκευής στο πρόγραμμα περιήγησης) ή κλειδί Model API πληρωμής κατά χρήση. Το Sign in with Meta ανταλλάσσει τον κωδικό συσκευής με τα τελικά σημεία OIDC της Meta (`https://auth.meta.com/oidc/device/authorization/` και `/oidc/device/token/`) με το δημόσιο client id του Muse Code, στέλνει μία φορά το προκύπτον διακριτικό λογαριασμού στο `https://api.meta.ai/muse-code/key` για να εκδώσει το κλειδί API της συνδρομής (και σε περιορισμένες αναγνώσεις `/usage` για το επίπεδο και τα παράθυρα χρήσης του πακέτου), και στέλνει μόνο το εκδοθέν κλειδί σε κάθε αίτημα μοντέλου προς το `https://api.meta.ai/v1`. Ένα επικολλημένο κλειδί Model API ή το `MODEL_API_KEY` / `META_API_KEY` χρεώνεται με βάση τη χρήση. - **Qwen:** κλειδί QwenCloud (Token Plan ή πληρωμή κατά χρήση) ή κλειδί Alibaba Cloud Model Studio (πληρωμή κατά χρήση, Token Plan ή Coding Plan), το οποίο ελέγχεται στο δικό του τελικό σημείο πριν αποθηκευτεί· ένα κλειδί πακέτου εμφανίζει τα μοντέλα του πακέτου, με πρώτο το Qwen3.8 Max. - **MiniMax:** κλειδί Open Platform ή κλειδί συνδρομής M Plan. - **Together AI** και **Cohere:** κλειδί API. - **Groq**, **Cerebras** και **Fireworks AI:** κλειδί API· το κλειδί κάθε οικογένειας μπορεί επίσης να προέρχεται από μια εντολή που ορίζεται στο `credentials.keyCommands.`. Τα Mistral, Nous Portal και OpenCode Zen συνδέονται επίσης μέσω του `/logins`, δηλαδή συνολικά 22 οικογένειες παρόχων με σύνδεση. Οι τοπικοί διακομιστές μοντέλων (Ollama, LM Studio, vLLM και llama.cpp) και τα προσαρμοσμένα τελικά σημεία συμβατά με το OpenAI λειτουργούν χωρίς σύνδεση παρόχου. Εκτελέστε το `/localsetup` για να εγκαταστήσετε ή να εκκινήσετε το Ollama, να κατεβάσετε ένα μοντέλο που χωράει στη μνήμη σας, να ορίσετε το παράθυρο περιεχομένου του ή να συνδέσετε έναν εκτελούμενο διακομιστή LM Studio, vLLM ή llama.cpp ([docs/LOCAL-SETUP.md](../LOCAL-SETUP.md)). Κάθε πάροχος χρησιμοποιεί το δικό του πρωτόκολλο, τα δικά του διαπιστευτήρια και τον δικό του χειρισμό σφαλμάτων, και τα αιτήματα δεν επιστρέφουν ποτέ σε άλλο πάροχο. Δείτε το [docs/ENGINES.md](../ENGINES.md). Το `/llmhost` εμφανίζει τα μοντέλα που μπορείτε να φιλοξενήσετε και δείχνει πού μπορεί να εκτελεστεί καθένα από αυτά αυτή τη στιγμή: σε GPU μισθωμένη από τη Runpod, το Vast.ai ή τη Lambda, στον δικό σας υπολογιστή ή σε αποθηκευμένο υπολογιστή SSH (`mercury host`), ή σε υπάρχοντα διακομιστή μοντέλων. Κάθε σελίδα μοντέλου δείχνει τις επιλογές κβαντοποίησης, πώς ο προϋπολογισμός μνήμης GPU μοιράζεται ανάμεσα σε παράλληλες συνομιλίες (`conversations × context`) και το προεπιλεγμένο επίπεδο σκέψης (το οποίο αλλάζει το `/effort` ανά αίτημα). Οι μισθώσεις GPU απαιτούν ρητή επιβεβαίωση της ωριαίας τιμής, και η ρύθμιση συνεχίζεται στο παρασκήνιο αν κλείσετε το αναδυόμενο παράθυρο. Στη Runpod μπορείτε επίσης να ρυθμίσετε την ποιότητα, τον διαχωρισμό του πλαισίου και τη σκέψη πριν από τη μίσθωση ή σε ήδη εκτελούμενο pod (`Tune`), να κρατάτε τα βάρη σε τόμο γρήγορης φόρτωσης και να ορίσετε ελέγχους διαθεσιμότητας ανά 5 δευτερόλεπτα. Οι μισθώσεις Vast.ai και Lambda είναι νέες στην 1.0.0-beta.40 και επαληθεύτηκαν έναντι των δημοσιευμένων API των παρόχων με δοκιμαστικά δεδομένα (fixtures)· δεν πραγματοποιήθηκαν ζωντανές μισθώσεις. Δείτε το [docs/LLM-HOST.md](../LLM-HOST.md). Οι νέες συνεδρίες χρησιμοποιούν τον πάροχο που συνδέσατε τελευταίο και το νεότερο μοντέλο που είναι διαθέσιμο σε αυτόν τον λογαριασμό. Τα μοντέλα στα οποία ο λογαριασμός δεν έχει πρόσβαση παραλείπονται. Αν αυτός ο πάροχος δεν έχει χρησιμοποιήσιμο μοντέλο, το Mercury ελέγχει τον επόμενο πιο πρόσφατα συνδεδεμένο πάροχο. Αυτή η επιλογή γίνεται κατά την έναρξη της συνεδρίας· ένα αποτυχημένο αίτημα μέσα σε υπάρχουσα συνεδρία μένει στον πάροχό του. Το `/model` εξηγεί την επιλογή. Μια λέξη οικογένειας επιλέγει το νεότερο μοντέλο αυτής της οικογένειας: `/model grok`, `/model deepseek`, `/model kimi` ή `/model glm`. Χωρίς συνδεδεμένο πάροχο, η αρχική οθόνη και το `/model` σάς οδηγούν στο `/logins`. Το `/defaultprovider` σάς επιτρέπει να ορίσετε ρητά έναν πάροχο ως την πιο πρόσφατη επιλογή. Η πρόσβαση στους παρόχους παραμένει υπό τους δικούς τους όρους και τη δική τους διαθεσιμότητα. Η άδεια χρήσης του Mercury δεν τους αντικαθιστά. ## Headless CLI: `mercury run`, Docker και JSON-RPC runner Η ίδια κατασκευή εκτελείται χωρίς τη διαδραστική διεπαφή. Το `node dist/mercury.mjs --help` απαριθμεί κάθε σημαία. Το `mercury run ""` εκτελεί ένα prompt χωρίς διεπαφή τερματικού: ```sh mercury run "Summarise this repository." --format text mercury run "Summarise this repository." --format json mercury run "Summarise this repository." --format rows ``` - `text` εμφανίζει την απάντηση· η αιτία μιας αποτυχημένης σειράς πηγαίνει στο stderr. - `json` εμφανίζει την τελευταία γραμμή `outcome` ως ένα αντικείμενο JSON. - `rows` γράφει ένα αντικείμενο JSON ανά γραμμή: `session`, έπειτα ένα `turn` και τις γραμμές του `text`, `reasoning`, `tool_call`, `tool_result` και `step`, και στο τέλος τη γραμμή `outcome`. Οι αναμονές, η πρόοδος των εργαλείων, οι εργασίες παρασκηνίου και οι ειδοποιήσεις έχουν τις δικές τους γραμμές. Κάθε γραμμή φέρει τα `seq`, `timestamp` και `session_id`· οι γραμμές μέσα σε έναν γύρο φέρουν επιπλέον τον αριθμό του `turn`. Το `seq` αριθμεί τη ροή αυτής της εκτέλεσης από το 1· το `turn` μετρά τους γύρους της συνεδρίας, οπότε μια εκτέλεση που συνεχίζει μια αποθηκευμένη συνομιλία (`-c`, `-r`, `--fork`) αριθμεί τον γύρο της μετά από εκείνους που ήδη περιέχει, και η γραμμή `session` της ονομάζει τη συνομιλία που συνεχίζει στο `resume_of`. Τύποι γραμμών εξόδου, ανά το πεδίο `type` τους: - `session`: η γραμμή έναρξης: `version`, `build` (οι πρώτοι δώδεκα δεκαεξαδικοί χαρακτήρες του δέντρου από το οποίο προήλθε το bundle, όπως τους εμφανίζει το `mercury daemon status`· απουσιάζει όταν δίπλα στο bundle δεν υπάρχει manifest), `resume_of` (σε εκτέλεση που συνεχίζει μια συνομιλία, το αναγνωριστικό συνεδρίας της συνομιλίας που συνεχίζεται· ταυτίζεται με το `session_id`, εκτός αν η εκτέλεση έγινε fork), `cwd`, `model`, `mode`, καθώς και τα `tools`, `mcp_servers`, `commands`, `agents`, `skills` και `extensions` της συνεδρίας, και το `tools_withheld` (υπάρχει όταν ένας κανόνας άρνησης αποκρύπτει ένα εργαλείο με το απλό όνομά του: σε κάθε καταχώριση, τα `tool`, `rule` και `source`). - `turn`: ένας γύρος που είναι `started` ή `waiting`, με το `turn_id` του· το `model`, τα `message_ids` και το πλήθος των `agents`, όταν είναι γνωστά. - `text`: ένα ολοκληρωμένο μπλοκ κειμένου: `message_id`, `block`, `text` και η `phase` του (`commentary` ή `final_answer`). - `reasoning`: ένα ολοκληρωμένο μπλοκ συλλογισμού: `message_id`, `block`, `text`, ή `redacted: true`. - `tool_call`: μια κλήση εργαλείου: `call_id`, `tool`, `input`, με το `message_id` και το `block` της. - `tool_result`: το αποτέλεσμα της κλήσης: `call_id`, `status` (`ok`, `error`, `aborted` ή `refused`) και `output`. Μια κλήση που το μοντέλο τη διαμόρφωσε τόσο άστοχα ώστε να απορριφθεί πριν από την εκτέλεση (άγνωστο εργαλείο, ορίσματα που δεν είναι έγκυρο JSON ή δεν ταιριάζουν με το σχήμα του εργαλείου), εξακολουθεί να έχει το ζεύγος της: μια γραμμή `tool_call` με τα ορίσματα όπως δόθηκαν (`{}` όταν δεν ήταν αντικείμενο) και μια γραμμή `tool_result` με κατάσταση `refused`, της οποίας το `output` είναι η αιτία· ακολουθεί η διορθωτική `notice`. Μια τέτοια κλήση δεν εκτελέστηκε ποτέ και δεν είναι άρνηση. - `tool_update`: πρόοδος ενός εργαλείου που τρέχει: `call_id`, `tick`, `source` (`shell`, `powershell`, `mcp` ή `eval`) και όσα από τα `line`, `elapsed_s`, `lines`, `bytes`, `budget_ms`, `progress` και `total` αναφέρει η κλήση. Μια κλήση shell ή PowerShell στέλνει σήμα καθώς φτάνει η έξοδος (μια εντολή που δεν εκτυπώνει τίποτα δεν στέλνει ποτέ σήμα), μια κλήση MCP όταν ο διακομιστής της αναφέρει πρόοδο, μια κλήση Eval όσο τρέχει το κελί της· κανένα άλλο εργαλείο δεν στέλνει σήμα· μια κλήση Browser ή Crewmate σιωπά μέχρι το αποτέλεσμά της. - `step`: μία κλήση μοντέλου του κύριου νήματος: `message_id`, `model`, `usage` και `stop`, όταν το μοντέλο δήλωσε γιατί σταμάτησε. - `outcome`: το αποτέλεσμα του γύρου, που περιγράφεται παρακάτω. - `close`: η σημείωση που αφήνεται για την επόμενη συνεδρία κατά το κλείσιμο: `state` (`stored`, `skipped` ή `none`), `note_chars` και το `usage` των κλήσεων μοντέλου που την έγραψαν, ώστε όποιος αθροίζει τη χρήση όλων των γραμμών να φτάνει στο σύνολο του αποτελέσματος. Όταν το prompt δίνεται ως όρισμα, η σημείωση ζητείται μέσα στον τελευταίο γύρο και το `close` προηγείται του `outcome` αυτού του γύρου· με `--input rows` ακολουθεί το τελευταίο `outcome`, αφού κλείσει το stdin. - `wait`: αναμονή για το μοντέλο: `state` (`first_byte`, `retry`, `silence`, `loading` ή `done`) με τα μεγέθη που συνοδεύουν αυτή την κατάσταση, όπως τα `since_ms`, `attempt` και `of`, `delay_ms`, `reason` και `http_status`. - `heartbeat`: η ροή του μοντέλου έδωσε σημείο ζωής μετά από τουλάχιστον ένα δευτερόλεπτο χωρίς αναλυμένο συμβάν: έφτασαν byte που δεν παρήγαγαν γραμμή. Η γραμμή δεν περιέχει τίποτε άλλο και εμφανίζεται το πολύ μία φορά το δευτερόλεπτο· η συχνότητα εξαρτάται από το σχήμα της ροής του παρόχου, οπότε μια ροή που δεν κάνει ποτέ παύση ανάμεσα στα συμβάντα δεν εκπέμπει καμία. - `compaction`: μια συμπίεση, `started`, `progress` ή `ended`: `trigger` (`manual`, `auto` ή `overflow`), `stage`, `fill`, `summary_tokens` και, στο τέλος, `exit` (`landed`, `cancelled` ή `failed`). - `mode`: η λειτουργία δικαιωμάτων άλλαξε: `mode`. - `rate_limit`: η κατάσταση του ορίου του παρόχου: `status` (`allowed`, `warning` ή `rejected`), `window`, `resets_at`, `utilization` και τα πεδία υπέρβασης. - `task`: μια εργασία παρασκηνίου `started`, `progress` ή `ended`: `task_id`, `task_type`, `description`, `usage`, `summary`, `status` (`completed`, `failed` ή `stopped`) και `output_file`, όσο γίνονται γνωστά. - `notice`: μια `warning` ή `error` για τον αναγνώστη: `text`, και ένα `code`, όπως `input_refused`. - `command_output`: η έξοδος μιας slash εντολής που δεν έφτασε ποτέ στο μοντέλο: `command` και `text`. - `mission_updated`: το ledger εργασιών της συνεδρίας άλλαξε· διαβάστε το ξανά. - `samples_updated`: τα δείγματα της συνεδρίας άλλαξαν· διαβάστε τα ξανά. Το `--partial` με `--format rows` προσθέτει τις γραμμές `block_start`, `text_delta`, `reasoning_delta`, `tool_input_delta` και `retracted`. Οι διαφορές (deltas) ανήκουν στο `message_id` και στο `block`· μια γραμμή `retracted` ανακαλεί τις διαφορές του μηνύματος. Η ολοκληρωμένη γραμμή κειμένου ή εργαλείου είναι η πλήρης τιμή. Το αποτέλεσμα περιέχει τα `schema`, `turn_id`, `status`, `steps`, `wall_ms`, `usage`, `models` και `denials`, με `answer` σε περίπτωση ολοκλήρωσης και `error` (`message`, `class`, προαιρετικό `detail`) σε περίπτωση αποτυχίας. Τα `stop`, `api_ms`, `cost_usd`, το ζητηθέν αποτέλεσμα `structured` και τα `notices` περιλαμβάνονται όταν είναι διαθέσιμα. Το `wall_ms` είναι ο χρόνος που πέρασε για τον γύρο. Το `api_ms` είναι το άθροισμα των διαρκειών κάθε αιτήματος μοντέλου που έκανε ο γύρος (συμπεριλαμβανομένων των επαναλήψεων και των αιτημάτων των crewmates που έτρεξαν παράλληλα με το κύριο νήμα)· γι' αυτό μπορεί να ξεπερνά το `wall_ms` όταν τα αιτήματα επικαλύπτονταν. Το `cost_usd` είναι το κόστος σε USD των τιμολογημένων αιτημάτων του γύρου, ανεξάρτητα από την κατάσταση: ένα αίτημα που το Mercury δεν μπορεί να τιμολογήσει (δεν υπάρχει τιμή στο αρχείο, δεν αναφέρεται κόστος στην απάντηση) δεν προσθέτει τίποτα σε αυτό και αφήνει το μοντέλο του στο `models` χωρίς δικό του `cost_usd`· το πεδίο απουσιάζει μόνο όταν δεν τιμολογήθηκε τίποτα στον γύρο. Με είσοδο μέσω συνδρομής Claude, τα αιτήματα Anthropic δεν έχουν τιμή σε δολάρια, οπότε ούτε αυτά ούτε η γραμμή περιέχουν `cost_usd`· η χρήση παραμένει. Η χρήση ονομάζει τα `input_tokens` (μαζί με τα cached tokens), `cached_input_tokens`, `cache_write_input_tokens`, `output_tokens` και, όταν αναφέρονται, τα `reasoning_output_tokens`, αθροισμένα σε όλο το κύριο νήμα και τους crewmates. Το `models` αναλύει τη χρήση tokens ανά μοντέλο. Το `steps` μετρά μόνο τις κλήσεις μοντέλου του κύριου πράκτορα· οι κλήσεις μοντέλου των crewmates εμφανίζονται ως δικές τους γραμμές `step`, με ετικέτα `parent_call_id`. Η κατάσταση είναι μία από τις εξής: `completed`, `blocked`, `refused`, `failed`, `interrupted`, `turn_limit`, `budget_limit`, `time_limit`, `schema_unmet` ή `loop_stopped`. Μια εκτέλεση με `--max-time` (δευτερόλεπτα, ή `10m`, `1h`) τερματίζει με `time_limit` στο επόμενο βήμα, μόλις εξαντληθεί ο χρόνος· η κλήση μοντέλου ή ο κύκλος εργαλείων που βρίσκεται σε εξέλιξη δεν διακόπτονται. Μια ολοκληρωμένη εκτέλεση τερματίζει με κωδικό 0, τα υπόλοιπα αποτελέσματα με κωδικό 1, και ένα σφάλμα χρήσης με κωδικό 2. Τα SIGINT και SIGTERM τερματίζουν με κωδικούς 130 και 143, αφού έχει καταγραφεί το αποτέλεσμα του διακοπέντος γύρου. Μια απορριφθείσα κλήση εργαλείου καταγράφεται στο `denials`. Όταν η άρνηση ήταν ερώτημα που κανείς δεν μπόρεσε να απαντήσει (εκτέλεση χωρίς φιλοξενούντα σε λειτουργία που ζητά έγκριση, `--mode dontAsk`, ή ερώτημα φιλοξενούντος που έληξε) και καμία μεταγενέστερη κλήση εργαλείου στον γύρο δεν πέτυχε, η εκτέλεση είναι `blocked`: η απάντηση διατηρείται, το `error` ονομάζει το εργαλείο και τον τρόπο συνέχισης (`--allowed-tools`, άλλο `--mode`, ή φιλοξενούντα που απαντά σε ερωτήματα), και η εκτέλεση τερματίζει με κωδικό 1. Αν μια μεταγενέστερη κλήση εργαλείου στον ίδιο γύρο πετύχει, ο γύρος ανακάμπτει, ολοκληρώνεται ως `completed` (κωδικός 0) και εκδίδει μια προειδοποιητική `notice` (`" was not approved; the run continued with other tools."`). Μια άρνηση που απαντήσατε (μέσω κανόνα άρνησης, hook ή φιλοξενούντα που είπε όχι) αφήνει έναν ολοκληρωμένο γύρο ολοκληρωμένο. Μια αναπάντητη κλήση `AskUserQuestion` τερματίζει επίσης την εκτέλεση ως `blocked`, με την ερώτηση παρατεθειμένη στο `error`· το Mercury διαβάζει το αποτέλεσμα από τα καταγεγραμμένα ερωτήματα της εκτέλεσης, όχι από το κείμενο της απάντησης, οπότε μια ερώτηση που γράφεται μόνο στην απάντηση ολοκληρώνεται ως `completed`. Μια άγνωστη slash εντολή παίρνει `refused` με την ίδια πρόταση που δίνει η διαδραστική οθόνη (`Unknown command: /name · /help lists commands`) και τερματίζει με κωδικό 1. Το `--input rows` απαιτεί `--format rows` και διαβάζει ένα αντικείμενο εισόδου ανά γραμμή: ```sh printf '%s\n' '{"type":"prompt","content":"Summarise this repository."}' | mercury run --input rows --format rows ``` Οι τύποι εισόδου είναι το `prompt` με `content` (κείμενο ή μπλοκ text/image), το `shell` με `command`, και το `note` με `to` (αναγνωριστικό πράκτορα) και `content`. Καθένας δέχεται ένα προαιρετικό `id`· οι γραμμές prompt και shell δέχονται επιπλέον `priority` (`now`, `next` ή `later`), `sent_at` και `origin`. Ένα απορριφθέν σχήμα εισόδου παράγει `notice` με κωδικό `input_refused`· το μη έγκυρο JSON τερματίζει την εκτέλεση. Αυτές οι γραμμές μεταφέρουν μόνο είσοδο· οι απαντήσεις σε ερωτήματα δικαιωμάτων γίνονται μέσω του πρωτοκόλλου του runner, που περιγράφεται παρακάτω. Χρησιμοποιήστε το `mercury run -` ή στείλτε κείμενο στο `mercury run` με pipe, για να διαβάσετε ολόκληρο το prompt από το stdin. Δίπλα σε ένα όρισμα prompt, το κείμενο του pipe προστίθεται ως οριοθετημένο πλαίσιο: το pipe διαβάζεται μέχρι να κλείσει ή να μείνει σιωπηλό για ένα δευτερόλεπτο, έτσι ώστε μια ροή που συνεχίζει να τροφοδοτεί να διαβάζεται μέχρι το τέλος της, ενώ ένα pipe που μένει ανοιχτό και σιωπηλό δεν κρατά την εκτέλεση. Χωρίς prompt, και με τερματικό στο stdin, το `run` εμφανίζει τη βοήθεια χρήσης και τερματίζει με κωδικό 2. Το `--mode ` επιλέγει τη λειτουργία δικαιωμάτων. Το `--sovereign` εκτελείται χωρίς ερωτήματα δικαιωμάτων, και το `--allow-sovereign` καθιστά αυτή τη λειτουργία διαθέσιμη για μεταγενέστερη αλλαγή. Η πολιτική δικαιωμάτων και οι κανόνες άρνησης εξακολουθούν να ισχύουν. Ένας χρήστης root που μπαίνει στη λειτουργία sovereign λαμβάνει μία ειδοποίηση στο stderr· η εκτέλεση συνεχίζεται. Χρησιμοποιήστε το `-c` για να συνεχίσετε την πιο πρόσφατη συνομιλία, το `-r` για να την επαναφέρετε με ID, τίτλο ή επιλογέα, το `-w` για εκτέλεση σε διαχειριζόμενο worktree, και το `--lean` για μια ελάχιστη συνεδρία. Το `run` δεν έχει φιλοξενούντα που να απαντά σε ερωτήματα δικαιωμάτων: οι κανόνες δικαιωμάτων και η λειτουργία του αποφασίζουν τι μπορεί να εκτελεστεί, και μια κλήση που χρειάζεται ακόμη έγκριση απορρίπτεται. ### Εικόνα headless Το `Dockerfile` στη ρίζα του αποθετηρίου δημιουργεί εικόνα Linux x64 για CI και διακομιστές. Το σημείο εισόδου της είναι το `mercury` και η προεπιλεγμένη εντολή της το `run`, οπότε η εικόνα εκτελεί ένα prompt πάνω σε ένα προσαρτημένο δέντρο και τερματίζει με τον κωδικό της εκτέλεσης: ```sh docker build -t mercury . docker run --rm -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" -v "$PWD":/work mercury run "Summarise this repository." --format text docker run --rm mercury --version ``` Η εικόνα περιέχει το bundle, το runtime Node 24 της (στο `PATH`), τα ενσωματωμένα εργαλεία αναζήτησης, shell, αποσφαλμάτωσης, γλωσσών και εικόνων, το `git` και το κατάστημα πιστοποιητικών· δεν υπάρχει αρχική οθόνη ούτε ροή σύνδεσης. Εκτελείται ως μη-root χρήστης `mercury`, με τον φάκελο διαμόρφωσής του μέσα στο κοντέινερ (`MERCURY_CONFIG_DIR`), και το `/work` είναι ο κατάλογος εργασίας του. Τα χρώματα και το ποντίκι ακολουθούν την ανίχνευση τερματικού του ίδιου του προϊόντος, και το `--user 0` εκτελείται ως root με την ίδια ειδοποίηση sovereign που περιγράφηκε παραπάνω. Ένα κλειδί παρόχου φτάνει ως μεταβλητή περιβάλλοντος, με τα ίδια ονόματα που διαβάζει το προϊόν παντού: `ANTHROPIC_API_KEY` ή `ANTHROPIC_AUTH_TOKEN`, `OPENAI_API_KEY`, `GEMINI_API_KEY` ή `GOOGLE_API_KEY`, `XAI_API_KEY` (και `XAI_MANAGEMENT_API_KEY` για τον μετρητή χρήσης του), `DEEPSEEK_API_KEY`, `MOONSHOT_API_KEY`, `ZAI_API_KEY`, `OPENROUTER_API_KEY`, `HF_TOKEN`, `MISTRAL_API_KEY` (και `MISTRAL_ADMIN_API_KEY` για τον μετρητή οργανισμού), `NOUS_API_KEY`, `OPENCODE_API_KEY`, `MINIMAX_API_KEY`, `TOGETHER_API_KEY` ή `TOGETHER_AI_API_KEY`, `COHERE_API_KEY` ή `CO_API_KEY`, `GROQ_API_KEY`, `CEREBRAS_API_KEY`, `FIREWORKS_API_KEY`, `DASHSCOPE_API_KEY`, `MODEL_API_KEY` ή `META_API_KEY`, `MERCURY_COMPAT_API_KEY` για ένα προσαρμοσμένο τελικό σημείο συμβατό με το OpenAI και `MERCURY_LOCAL_API_KEY` για έναν τοπικό διακομιστή. Χωρίς κλειδί, η εκτέλεση αρνείται σε μία γραμμή και τερματίζει με κωδικό 1. Το `docker run -i … mercury run -` διαβάζει το prompt από το stdin. ### Φιλοξενία συνεδρίας Το `mercury runner` εξυπηρετεί μια συνεδρία σε έναν φιλοξενούντα μέσω stdio: JSON-RPC 2.0, ένα μήνυμα ανά γραμμή. Ο φιλοξενών στέλνει πρώτα το `initialize` και περιμένει την απάντηση πριν στείλει εργασία: ```json {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocol":1,"host":{"name":"my-host","version":"1.0.0"},"capabilities":{"holds_asks":true,"elicitation":false,"partial_rows":false}}} ``` Το όνομα και η έκδοση του φιλοξενούντος μεταφέρονται κάτω από το `host`· το `capabilities` δηλώνει τα `holds_asks`, `elicitation` και `partial_rows`. Κάθε `id` αιτήματος είναι θετικός ακέραιος: ένα αίτημα με οποιοδήποτε άλλο `id` παίρνει απάντηση `-32600` με `id: null`, γι' αυτό αριθμείτε τα αιτήματα από το 1. Το `queue/add` δέχεται το ίδιο αντικείμενο prompt, shell ή note με την είσοδο γραμμών παραπάνω. Η έξοδος έρχεται σε ειδοποιήσεις `row`. Το `session/facts` διαβάζει την κατάσταση της συνεδρίας· το `session/set_mode` αλλάζει τη λειτουργία δικαιωμάτων αμέσως· τα `session/set_model` και `session/set_effort` αλλάζουν το μοντέλο και το effort, και μια αλλαγή που γίνεται ενώ τρέχει ένας γύρος κρατείται μέχρι το τέλος του γύρου: απαντά με `at: "turn_end"`, και έπειτα το `session/applied` την ανακοινώνει. Το `turn/interrupt` σταματά έναν γύρο· κλείστε το stdin για να τερματίσετε τη συνεδρία. Τα ερωτήματα δικαιωμάτων φτάνουν ως `permission/request`, με `kind: "tool"` ή `kind: "network"`. Ο φιλοξενών απαντά με `outcome: "allow"` ή `outcome: "deny"`· μια αποδοχή μπορεί να φέρει τροποποιημένα `input` και `rules`. Ένα ερώτημα που αποσύρθηκε στέλνει `$/cancel_request` με το `request_id` του. Το `holds_asks` δίνει στον φιλοξενούντα την κατοχή του χρονομέτρου του ερωτήματος. Ένα ερώτημα MCP χρησιμοποιεί το `elicitation/request` μόνο όταν ο φιλοξενών δηλώνει `elicitation`· διαφορετικά απαντάται με `cancel`. Μια άγνωστη μέθοδος παίρνει `-32601`, οι λανθασμένες παράμετροι `-32602`, ένα `id` που δεν είναι θετικός ακέραιος `-32600`, και ένα αίτημα πριν από την αρχικοποίηση `-32002`. Μια άρνηση κανόνα είναι `-32010`, με μια πρόταση στο `error.message` και μια αιτία στο `error.data.kind`, όπως `mode`, `model`, `effort` ή `claim`. Ο runner απαντά σε μια κακοσχηματισμένη γραμμή με `-32700` και συνεχίζει· τρεις συνεχόμενες κακοσχηματισμένες γραμμές τον τερματίζουν. ### Άλλες εντολές Οι διαθέσιμες εντολές περιλαμβάνουν: - **`mercury health`**: διαγνωστική αναφορά, γνωστή και ως πιστοποιητικό κατάστασης (health certificate). Το `--json` επιστρέφει την πλήρη αναφορά, το `--deep` εκτελεί τη βαθιά απογραφή και το `--fix` εκτελεί καθοδηγούμενες διορθώσεις. - **`mercury auth login []|list|status []|logout []|mint`**: σύνδεση (`login []`), λίστα οικογενειών παρόχων (`list`), έλεγχος αν ένας λογαριασμός είναι συνδεδεμένος (`status []`), αποσύνδεση (`logout []`) ή έκδοση ενός μακράς διάρκειας διακριτικού Anthropic (`mint`). - **`mercury models [--json]`**: εμφανίζει τα μοντέλα στα οποία έχουν πρόσβαση οι συνδεδεμένοι λογαριασμοί (τα ίδια στοιχεία με το `mercury://models`). - **`mercury mcp`**: διαχείριση διακομιστών MCP με τα `add`, `import`, `list`, `get`, `remove`, `trust-reset` και `serve`. - **`mercury extensions`**: εγκατάσταση επεκτάσεων και διαχείριση των πηγών τους. Ενέργειες: `list`, `sources`, `add`, `remove`, `refresh`, `install`, `trust`, `enable`, `disable`, `update`, `uninstall`, `fence`, `unfence`, `inspect` και `scaffold`. - **`mercury roster`**: εμφανίζει το απόθεμα των πρακτόρων. - **`mercury usage`**: εκτυπώνει τη συμπαγή γραμμή με τα στοιχεία που δείχνει η οθόνη `/usage`· το `--json` εκτυπώνει ολόκληρη την ένδειξη: τα παράθυρα κάθε συνδεδεμένου παρόχου με τη χρήση και την επαναφορά τους, τα μεγέθη και τις πιστώσεις που δήλωσε, το καθένα με την πηγή και την ηλικία του, καθώς και τις δαπάνες της συνεδρίας ανά μοντέλο, όπως τις διαβάζει η οθόνη (ο αναγνώστης κάθε συνδεδεμένου παρόχου δειγματίζεται μία φορά, όπως κατά το άνοιγμα). - **`mercury daemon run|status|stop|restart`**: εκτελεί, ελέγχει, σταματά ή επανεκκινεί το παρασκηνιακό daemon. Οι θέσεις συνεδριών του είναι θυγατρικές διεργασίες `mercury runner`· το daemon στέλνει σε αυτές τα prompt και φιλοξενεί τα ερωτήματα δικαιωμάτων τους. - **`mercury sessions list`** (επίσης απλά `mercury sessions`): εμφανίζει τις αποθηκευμένες συνεδρίες αυτού του έργου, από τις νεότερες: το αναγνωριστικό, τη στιγμή της τελευταίας εγγραφής, το μέγεθος, `live` όταν το daemon τη φιλοξενεί τώρα, και τον τίτλο ή το πρώτο prompt· το `--all` διαβάζει κάθε έργο, το `--limit ` περιορίζει τη λίστα. Το αναγνωριστικό είναι αυτό που ανοίγει ξανά το `mercury --resume ` και αφαιρεί το `sessions delete`. - **`mercury sessions delete `**: διαγράφει μία αποθηκευμένη συνεδρία σκόπιμα — το αρχείο καταγραφής της και τις εγγραφές που φυλάσσονται δίπλα της (αποδείξεις, στιγμιότυπο επανέναρξης) — μετά από ερώτηση· το `--yes` παραλείπει την ερώτηση για σενάρια. Μια συνεδρία που φιλοξενεί τώρα το daemon απορρίπτεται, και ένα άγνωστο αναγνωριστικό απορρίπτεται με υπόδειξη προς τη λίστα (`/sessions` μέσα στο Mercury). Οι αποθηκευμένες συνεδρίες αλλιώς δεν διαγράφονται ποτέ μόνες τους. - **`mercury host [status|start|stop|restart|logs|uninstall|add|recipes]`**: εκτελεί έναν τοπικό ή SSH υπολογιστή ως διακομιστή μοντέλων για κάθε συνεδρία που μοιράζεται τον κατάλογο διαμόρφωσης (`compat/box-/`), χρησιμοποιώντας ένα επαληθευμένο τοπικό αποθετήριο βαρών ή μια επιβεβαιωμένη λήψη. Δείτε το [docs/LLM-HOST.md](../LLM-HOST.md). - **`mercury lsp list`** και **`mercury lsp install `**: ο κατάλογος των language servers, με κάθε server είτε εγκατεστημένο (με το δυαδικό του) είτε απόντα (με τη λύση εγκατάστασής του)· το `install` εμφανίζει τη λύση ενός server, ζητά επιβεβαίωση, εκτελεί ακριβώς αυτήν (το `--yes` παραλείπει την ερώτηση για σενάρια) και αναφέρει πού εγκαταστάθηκε το δυαδικό. Ένας άγνωστος server απορρίπτεται με τον κατάλογο. Το Mercury δεν εγκαθιστά ποτέ language server μόνο του· το άνοιγμα ενός αρχείου ξεκινά μόνο έναν server που είναι ήδη εγκατεστημένος. - **`mercury acp`**: εξυπηρετεί έναν επεξεργαστή μέσω του Agent Client Protocol, με ένα θυγατρικό runner για κάθε συνεδρία. Το `mercury bridge install` εγκαθιστά την επέκταση VS Code· το `mercury bridge status` την ελέγχει· το `mercury bridge uninstall` την αφαιρεί. - **`mercury godot run|check|capture|frames|profile|tour|jobs|cancel|result`**: διαχειρίζεται εργασίες του engine για το έργο Godot στον τρέχοντα κατάλογο. Το Mercury εκτελεί σουίτες σε δικούς του headless workers από ένα παγωμένο αντίγραφο του έργου. Η υπηρεσία περιλαμβάνει πύλη μεταγλώττισης, λήψεις, στατιστικά καρέ, ολοκληρωμένα προφίλ, πρόσβαση στην ουρά εργασιών, ακύρωση και αποτελέσματα ανά αναγνωριστικό. Δείτε το [docs/VULCAN-GODOT-TOOLS.md](../VULCAN-GODOT-TOOLS.md). - **`mercury image `**: εμφανίζει μια εικόνα στο τερματικό. - **`mercury install`** και **`mercury update`** (ψευδώνυμο `upgrade`): εγκαθιστούν ή ενημερώνουν αρχεία έκδοσης· με `--json` το έγγραφο εμφανίζεται στο stdout ανεξάρτητα από το αποτέλεσμα, και ο κωδικός εξόδου δείχνει αν η εντολή απέτυχε. Δείτε το [Εγκατάσταση](#εγκατάσταση). - **`mercury version`** και **`mercury help [command]`**: εμφανίζουν τη γραμμή έκδοσης ή μια σελίδα βοήθειας, το ίδιο με τα `--version` και `--help`· καμία από τις δύο δεν ξεκινά συνεδρία. ## Τι περιλαμβάνει: μνήμη Mneme RAG, LSP, AST για 57 γλώσσες, αποσφαλματωτής DAP, αναζήτηση στον ιστό και γέφυρες - **Υβριδική μνήμη έργου RAG Mneme.** Το Mneme είναι ενεργοποιημένο εξ ορισμού και διατηρεί τα γεγονότα κάθε έργου σε απλές σελίδες markdown ανά θέμα (`Retain`, `Recall`, `Reflect`, `Correct`). Το Recall συνδυάζει ένα σημασιολογικό μοντέλο embeddings BGE 118 MB που εκτελείται στη συσκευή (`bge-base-en-v1.5` `q8_0`, MIT, περιλαμβάνεται σε κάθε αρχείο έκδοσης, μεταγλωττισμένο για την πλατφόρμα του· δείτε [Προαιρετικά στοιχεία](#προαιρετικά-στοιχεία)) με κατάταξη λέξεων BM25 με stemming, στάθμιση φρεσκάδας και παρακολούθηση αναφορών μέσω reciprocal rank fusion (`k = 60`). Οι καρφιτσωμένοι κανόνες (`pin: true`) φορτώνονται αυτολεξεί στο ράφι καρφιτσωμένων και αλλάζουν μόνο με τον λόγο σας. Στην έναρξη μιας συνεδρίας, το Mercury βαθμολογεί τα μη καρφιτσωμένα γεγονότα και τις προηγούμενες σημειώσεις σε σχέση με τον τρέχοντα κλάδο σας, τα πρόσφατα αγγιγμένα αρχεία και τη σημείωση παράδοσης της τελευταίας συνεδρίας, μέσα σε ειδικό όριο εκκίνησης (`memory.startLimit`, προεπιλογή 4.000 χαρακτήρες). Οι έλεγχοι αντιφάσεων κατά την εγγραφή πιάνουν αλλαγές πολικότητας, άρνησης και αριθμών πριν αποθηκευτεί ένα αντιφατικό γεγονός. Κάθε συνεδρία γράφει κατά την έξοδο μια σημείωση παράδοσης με δικά της λόγια, για τη σελίδα εισόδου της επόμενης συνεδρίας, και προαιρετικά μια καταχώριση ημερολογίου συνεδρίας. Το `/memory` ανοίγει το κέντρο μνήμης, και το `/memory page` σχεδιάζει τη βιβλιοθήκη στον περιηγητή σας ως γράφημα κόμβων και ακμών. Δείτε το [docs/MNEME.md](../MNEME.md). - **Ανάλυση κώδικα LSP, επανεγγραφές AST για 57 γλώσσες, αποσφαλματωτής DAP και κελιά `Eval`.** Ανάγνωση με αγκυρώσεις και ατομικές επεξεργασίες σε πολλά αρχεία (`ChangeSet`)· ερωτήματα προς τον language server (`LspRead`) και αναδιαρθρώσεις με προεπισκόπηση και εφαρμογή (`LspRename`, `LspMoveSymbol`, `LspMoveFile`, `LspCodeAction`, `LspFormat`)· αναζήτηση και επανεγγραφή συντακτικού δέντρου (`AstSearch`, `AstEdit`) με τις μετα-μεταβλητές (meta-variables) `$NAME` και `$$$NAME` σε 57 γραμματικές στα αρχεία έκδοσης (16 σε κάθε κατασκευή `bun install` και 41 στο πακέτο γραμματικών)· μόνιμα κελιά κώδικα σε Python (`python3`) και JavaScript (ES module του Node) (`Eval`)· και ένας αποσφαλματωτής Debug Adapter Protocol (`Debug`) που οδηγεί τα `debugpy`, `js-debug`, `lldb`, `gdb`, `dlv`, `netcoredbg`, `rdbg`, τον αποσφαλματωτή adapter του Dart SDK, το `kotlin-debug-adapter`, τον αποσφαλματωτή adapter του elixir-ls και το Godot. Στο εργαλείο `Test`, η λειτουργία `debug` μεταφέρει ένα αποτυχημένο τεστ Python (`pytest`, `unittest`), JavaScript/TypeScript (`node-test`, `vitest`, `jest`), Go (`go test`) ή Rust (`cargo test`) απευθείας σε μια συνεδρία `Debug`. Δείτε το [docs/LANGUAGE-SERVICE.md](../LANGUAGE-SERVICE.md), [συναλλαγές αλλαγών](../CHANGE-TRANSACTIONS.md), [δομικά μοτίβα](../STRUCTURAL-PATTERNS.md), [κελιά κώδικα](../EVAL.md) και [τον αποσφαλματωτή](../DEBUGGER.md). - **`WebSearch` χωρίς κλειδιά και `WebFetch` σε markdown.** Το `WebSearch` ακολουθεί μία αλυσίδα: πρώτα την εγγενή αναζήτηση του παρόχου σε πραγματικό χρόνο, όταν το μοντέλο της συνεδρίας την υποστηρίζει (`ProviderSearch`), έπειτα τα αποθηκευμένα κλειδιά Brave ή Tavily, έπειτα τα επίσημα API που επιλέγονται ανάλογα με τη μορφή του ερωτήματος (Stack Exchange, npm, PyPI, crates.io, αναζήτηση κώδικα GitHub, Hacker News Algolia, Wikipedia), έπειτα τα ρυθμισμένα JSON API του SearXNG (`MERCURY_SEARCH_SEARXNG_INSTANCES`) και τέλος την εξαγωγή σελίδων DuckDuckGo χωρίς κλειδί (ενεργή εξ ορισμού· απενεργοποιείται στο `/config` ή με `MERCURY_SEARCH_KEYLESS=0`). Κάθε απάντηση μένει κάτω από 2.000 tokens και ονομάζει την πηγή που απάντησε. Το `WebFetch` διαβάζει δημόσιες σελίδες ως markdown με τα δικά τους λόγια, εντός προϋπολογισμού κλήσης 38.000 χαρακτήρων (μια σελίδα που χρειάζεται πρόγραμμα περιήγησης διαβάζεται μέσω του φιλοξενούμενου αναγνώστη `r.jina.ai`, εκτός αν οριστεί `MERCURY_FETCH_READER=0`, και μια ιδιωτική διεύθυνση δικτύου δεν του αποστέλλεται ποτέ). Δείτε το [docs/ENGINES.md](../ENGINES.md). - **Πράκτορες, crewmates από διαφορετικούς παρόχους (`Crewmate`), worktrees και μισθώσεις αρχείων.** Δύο ενσωματωμένοι πράκτορες (`mercury-crew` για ανατεθειμένη εργασία κάθε είδους και `mercury-scout` για αναγνώριση μόνο για ανάγνωση) βρίσκονται δίπλα στους ορισμούς πρακτόρων που δημιουργείτε στο `/agents`. Εκκινήστε crewmates σε οποιονδήποτε συνδεδεμένο πάροχο, απομονώστε την παράλληλη εργασία σε αντίγραφα εργασίας `git worktree` (`isolation: "worktree"`), συντονίστε κοινά αρχεία με μισθώσεις αρχείων έργου εντός διεργασίας (`mcp__mercury__lease_take`, `mcp__mercury__lease_release`, `mcp__mercury__lease_list`), και κατευθύνετε ή συνεχίστε crewmates με όνομα ή αναγνωριστικό μέσω των `SendMessage` και `ResumeCrewmate`. Παρακολουθήστε τους crewmates στο `/crewmates` και στο `/runs`. Δείτε το [docs/CREW.md](../CREW.md). - **Έλεγχος υπολογιστή σε επιφάνεια εργασίας.** Ενεργοποιημένος εξ ορισμού όταν είναι διαθέσιμος ο εγγενής οδηγός επιφάνειας εργασίας. Το εργαλείο `Computer` τραβά στιγμιότυπα οθόνης και ελέγχει το ποντίκι και το πληκτρολόγιο στην εφαρμογή που βρίσκεται στο προσκήνιο. Το Mercury επαληθεύει την εφαρμογή με βάση το όνομα και την ταυτότητά της πριν από κάθε ενέργεια, και ζητά έγκριση εκτός αν οι κανόνες δικαιωμάτων σας, η άδεια της συνεδρίας, η ρύθμιση πρόσβασης ή η λειτουργία δικαιωμάτων ήδη το επιτρέπουν· σταματά με το `Esc`, επιτρέπει σε μία μόνο συνεδρία να ελέγχει την επιφάνεια εργασίας κάθε φορά, και δεν αποθηκεύει τα στιγμιότυπα οθόνης στο αρχείο της αποθηκευμένης συνομιλίας. Για να αφαιρέσετε το εργαλείο, ορίστε `MERCURY_COMPUTER_USE=0`. Δείτε το [docs/COMPUTER-USE.md](../COMPUTER-USE.md). - **Φωνητική είσοδος Whisper στη συσκευή (`/voice`).** Το `/voice on` κατεβάζει το αγγλικό μοντέλο ομιλίας των 60 MB (`base.en-q5_1`) στην πρώτη χρήση, επαληθεύει το SHA-256 digest του και ενεργοποιεί την υπαγόρευση· το `/voice off` την απενεργοποιεί. Κρατήστε πατημένο το πλήκτρο διαστήματος για 1 δευτερόλεπτο για να μιλήσετε και αφήστε το για να σταματήσετε, ή εκτελέστε απλώς το `/voice` για να ξεκινήσετε και να σταματήσετε μια ηχογράφηση όσο η φωνή είναι ενεργή. Το Whisper μεταγράφει στη συσκευή, οπότε ο ήχος της φωνής δεν φεύγει ποτέ από τον υπολογιστή σας· το `MERCURY_WHISPER_MODEL` επιλέγει το `tiny.en-q5_1`, το `small.en-q5_1`, το πολυγλωσσικό `base-q5_1` ή ένα τοπικό αρχείο `.gguf`. Δείτε το [docs/VOICE.md](../VOICE.md). - **Προγραμματισμός cron και συνεδριών Saturn (`/saturn`).** Προγραμματίστε ένα prompt για υπάρχουσα συνεδρία (`CronCreate`, `CronList`, `CronDelete`, `ScheduleWakeup`, `/loop`) ή προγραμματίστε μια νέα συνεδρία να ξεκινά σε καθορισμένη ώρα. Τα προγράμματα μπορούν να εκτελούνται μία φορά ή να επαναλαμβάνονται. Δείτε το [docs/SATURN.md](../SATURN.md). - **Γέφυρες για VS Code (ACP), Unity, Blender, Godot και Aseprite.** Το `mercury acp` συνδέεται με επεξεργαστές που υποστηρίζουν το Agent Client Protocol. Η επέκταση VS Code (`mercury bridge install`) εκτελεί το Mercury μέσα στον επεξεργαστή μέσω αυτού του πρωτοκόλλου: συνομιλία, συνεδρίες, πράκτορες, αντικείμενα και αναθεωρήσεις, με την επιλογή και τη διάγνωση του επεξεργαστή να συνοδεύουν κάθε prompt. Ξεχωριστές, προαιρετικές ενσωματώσεις συνδέονται με ενεργούς επεξεργαστές Unity (`MERCURY_UNITY=1`), Blender (`MERCURY_BLENDER=1`) και Godot (`MERCURY_GODOT_TOOLS=1`), με πρόσβαση παρτίδας στο Aseprite (`MERCURY_ASEPRITE=1`). Δείτε τα [Unity](../UNITY-BRIDGE.md), [Blender](../BLENDER-BRIDGE.md), [Godot](../VULCAN-GODOT-TOOLS.md) και [Aseprite](../ASEPRITE-BRIDGE.md). - **Επεκτάσεις.** Κάθε επέκταση έχει ένα μανιφέστο. Προσθέστε πηγές από URL git, τοπικό φάκελο ή αρχείο, εγκεκριμένες με το hash των contributions τους. Δείτε το [docs/EXTENSIONS.md](../EXTENSIONS.md). - **MCPs & Skills.** Ρύθμιση ανά αποθετήριο για το τι φορτώνουν οι συνεδρίες, με ονομαστικά presets και στοιχεία ελέγχου που μπορείτε να αλλάξετε κατά τη διάρκεια μιας συνεδρίας. Δείτε το [docs/KIT.md](../KIT.md). - **Διαγνωστικά.** Ο έλεγχος κατάστασης και το `/health` παράγουν αναφορά που στηρίζεται σε διαγνωστικά τεκμήρια, με ετυμηγορία `certified`, `caution` ή `fault` και επαληθευμένες διορθώσεις. Δείτε το [docs/HEALTH-CERTIFICATE.md](../HEALTH-CERTIFICATE.md). - **Εμπιστοσύνη και δικαιώματα.** Εμπιστοσύνη χώρου εργασίας, κανόνες και λειτουργίες δικαιωμάτων, καθώς και οι εντολές που αρνείται κάθε συνεδρία. Δείτε το [docs/TRUST.md](../TRUST.md). - **Apollo Mode**, η συνέντευξη προδιαγραφών: απαντήστε στις ερωτήσεις του πράκτορα για να ολοκληρώσετε την προδιαγραφή με την οποία θα φτιάξει ένα πρωτότυπο. Δείτε το [docs/APOLLO-MODE.md](../APOLLO-MODE.md). - **Ανάκαμψη.** Ατομική δημοσίευση, λειτουργίες με ημερολόγιο και συμφιλίωση κατά την εκκίνηση. Δείτε το [docs/DURABILITY.md](../DURABILITY.md). Οι σημαίες χρόνου εκτέλεσης ορίζονται στο `src/substrate/flagRegistry.ts`, εκτίθενται ως ρυθμίσεις `MERCURY_*` και εμφανίζονται κατ' απαίτηση. Η συμβατότητα των ενσωματώσεων τεκμηριώνεται στο [docs/COMPATIBILITY.md](../COMPATIBILITY.md). Το πλήρες ευρετήριο τεκμηρίωσης είναι το [docs/README.md](../README.md). ## Εντολές slash Το `/help` εμφανίζει τις διαθέσιμες διαδραστικές εντολές. Για αναζήτηση εντολών με ανοχή σε λάθη χρησιμοποιήστε το `/palette`. Ο πίνακας παρακάτω ομαδοποιεί τις ενσωματωμένες εντολές που είναι ενεργές εξ ορισμού ανά κατηγορία, όπως αυτές που χρησιμοποιεί το `/help`· η ζωντανή λίστα περιλαμβάνει επιπλέον το `/samples` στην κατηγορία `current work` όταν είναι ενεργό το Samples (`MERCURY_SAMPLES=1` ή η γραμμή Samples του Boot Menu), και όσες δεξιότητες ή εντολές επεκτάσεων υπάρχουν. | Ενότητα | Εντολές | | --- | --- | | current work | `/run` `/runs` `/workbench` `/diff` `/mission` (/goal) | | crew & delegation | `/agents` `/crewmates` `/crew` `/daemon` `/saturn` `/seats` `/kill` `/unkill` | | session & context | `/clear` `/compact` `/context` `/rewind` `/sessions` `/concourse` `/rename` `/title` `/contract` `/export` `/copy` `/usage` `/realms` `/restart` | | memory & goals | `/memory` `/console` | | model & effort | `/model` `/effort` `/submodels` `/advise` `/caching` `/tensorfold` | | git & review | `/review` `/audit` | | health & introspection | `/health` `/verify` `/trace` `/capabilities` `/lsp` | | config & setup | `/config` `/jev` `/localsetup` `/llmhost` `/permissions` `/hooks` `/mcp` `/extensions` `/skills` `/browser` `/orient` `/keybindings` `/keys` `/vim` `/mouse` `/keysetup` `/bootmenu` `/voice` | | appearance & cockpit | `/appearance` `/critter` `/palette` `/zen` `/browse` | | account & app | `/logins` `/logout` `/accounts` `/defaultprovider` `/update-notes` `/feedback` `/help` `/exit` | | Εντολή | Τι κάνει | | --- | --- | | `/imagesetup` | Ρυθμίστε τοπικά μοντέλα εικόνας και βίντεο. | | `/llmhost` | Επιλέξτε ένα μοντέλο για μίσθωση στη Runpod, το Vast.ai ή τη Lambda, για εκτέλεση στον δικό σας υπολογιστή ή για σύνδεση υπάρχοντος διακομιστή. | | `/tensorfold` | Εκτελέστε ένα τοπικό μοντέλο στο TensorFold: εγκαταστήστε τη μηχανή, κατεβάστε ένα μοντέλο, διαθέστε το σε αυτό το Mac, μοιραστείτε το στο δίκτυό σας ή μισθώστε μια GPU για αυτό, και μεταβείτε σε αυτό, όλα σε μία οθόνη. | | `/restart` | Μεταφέρει αυτή τη συνομιλία στην εγκατεστημένη έκδοση του Mercury· οι ενεργές παρακολουθήσεις και τα shell παρασκηνίου σταματούν. | | `/mcp` | Εμφάνιση διακομιστών, σύνδεση, περιήγηση στα εργαλεία και στις παραμέτρους κάθε διακομιστή, επανασύνδεση ή εναλλαγή ενός διακομιστή για αυτή τη συνομιλία. | Το `/mouse off` επιστρέφει τον δρομέα στο τερματικό για την εγγενή επιλογή και αντιγραφή κειμένου. Η προτίμηση αποθηκεύεται και εμφανίζεται στο `/config` ως Mouse capture. Ένα απαιτούμενο όρισμα ξεκινά με `<…>` στη χρήση (usage) μιας δεξιότητας. Για παράδειγμα, τα `/update-config` και `/debug` χρειάζονται όρισμα. Αν στείλετε μία από αυτές μόνη της, λαμβάνετε την περιγραφή και τη χρήση της· δεν ξεκινά καμία σειρά. Αν την επιλέξετε στη λίστα υποδείξεων και πατήσετε Enter, το `/name ` μένει έτοιμο για να προσθέσετε το όρισμα. Το `/loop` δεν έχει απαιτούμενο όρισμα και εκτελείται αμέσως. ## Αναφορά προβλήματος Για σύντομη αναφορά, χρησιμοποιήστε [τη φόρμα δοκιμαστών](https://mercury-cli.ai/report) ή το `/bug --short ` μέσα στο Mercury. Ζητά το λειτουργικό σας σύστημα, τι δοκιμάσατε και τι χάλασε· δεν χρειάζεται αποτύπωση διαγνωστικών. Εκτελέστε το `/bug ` μέσα στο Mercury για να δείτε προεπισκόπηση μιας αναφοράς πριν την υποβάλετε μέσω του GitHub CLI (`gh`) στο οποίο έχετε συνδεθεί. Χωρίς το `gh`, το Mercury αποθηκεύει τοπικό σχέδιο κάτω από τον κατάλογο διαμόρφωσης και σας δείχνει τη σελίδα ζητημάτων (issues) του αποθετηρίου. Μπορείτε επίσης να ανοίξετε ζήτημα απευθείας με το πρότυπο bug, provider/model ή feature request. Συμπεριλάβετε την έξοδο του `--version`, το λειτουργικό σας σύστημα, το τερματικό σας και τα ακριβή βήματα. Οι αναφορές σφαλμάτων και παρόχων χρειάζονται επίσης το `mercury health --json`, ή το `node dist/mercury.mjs health --json` για κατασκευή από τον πηγαίο κώδικα. Μια μεταγραφή της οθόνης με το σφάλμα βοηθά. Αναφέρετε προβλήματα ασφαλείας ιδιωτικά μέσω της καρτέλας Security του αποθετηρίου. Κρατήστε τα εκτός δημόσιων ζητημάτων (issues). Δείτε το [SECURITY.md](../../SECURITY.md). Το [CONTRIBUTING.md](../../CONTRIBUTING.md) καλύπτει τα ζητήματα, τα pull requests και τους ελέγχους. ## Άδεια χρήσης Το Mercury CLI διέπεται από την Apache License 2.0 (`Apache-2.0`) στο [LICENSE.md](../../LICENSE.md). Τα SDK TypeScript και Python στο [sdk/](../../sdk/) και στο [sdk-py/](../../sdk-py/) (`mercury-cli-sdk` στο npm και στο PyPI) διέπονται επίσης από την Apache License 2.0 (`Apache-2.0`), το καθένα από το αρχείο LICENSE που το συνοδεύει ([sdk/LICENSE](../../sdk/LICENSE) και [sdk-py/LICENSE](../../sdk-py/LICENSE)). Η χρήση του ονόματος και των σημάτων του Mercury καλύπτεται από την [πολιτική εμπορικών σημάτων](../../TRADEMARKS.md). Οι ενσωματωμένες άδειες τρίτων αναγράφονται στο [THIRD_PARTY_NOTICES.md](../../THIRD_PARTY_NOTICES.md).