CodeHero PRO — Οδηγός χρήσης

Πλήρης οδηγός για τη χρήση της πλατφόρμας CodeHero στην ανάπτυξη λογισμικού με AI.

1. Σύνδεση & Dashboard

Σύνδεση

Ανοίξτε τον browser και πηγαίνετε στο https://YOUR_IP:9453. Θα δείτε τη σελίδα σύνδεσης.

Σελίδα σύνδεσης

Προεπιλεγμένα στοιχεία σύνδεσης:

• Όνομα χρήστη: admin
• Κωδικός: admin123

Έλεγχος ταυτότητας δύο παραγόντων (2FA): Αν είναι ενεργός στις ρυθμίσεις, θα σας ζητηθεί ένας 6ψήφιος κωδικός από το Google Authenticator. Με το "Remember this device" παρακάμπτετε το 2FA σε αξιόπιστες συσκευές μέχρι το τέλος του μήνα.

Κλείδωμα λογαριασμού: Μετά από 5 αποτυχημένες προσπάθειες σύνδεσης, ο λογαριασμός κλειδώνει για 15 λεπτά.

Dashboard

Το Dashboard είναι το κεντρικό σας σημείο ελέγχου και δείχνει την κατάσταση του συστήματος σε πραγματικό χρόνο.

Dashboard

Στοιχεία του Dashboard:

• System Status — Αν η υπηρεσία daemon τρέχει
• Quick Stats — Ενεργά projects, ανοιχτά tickets, sessions σήμερα, συνολικά tokens
• Recent Activity — Οι πιο πρόσφατες ενημερώσεις και ολοκληρώσεις tickets
• Token Usage — Γραφήματα κατανάλωσης tokens ανά ημέρα/εβδομάδα/μήνα
• Update Badge — Πράσινο σήμα που εμφανίζεται όταν υπάρχει νέα έκδοση

Η σελίδα Logs

Το Logs (πάνω μενού) ανοίγει τα logs του server το ένα δίπλα στο άλλο — του CodeHero, του web stack, του συστήματος, των containers. Από την v4.55.0 τέσσερις κάρτες στην κορυφή δείχνουν αυτόν τον server τώρα: CPU (πόσο απασχολημένη είναι τώρα, το load average, οι πυρήνες), Memory (χρησιμοποιημένη από τη συνολική, swap), Disk used και Free space (κάθε δίσκος που φιλοξενεί το CodeHero). Ανανεώνονται κάθε 5 δευτερόλεπτα όσο η σελίδα είναι ανοιχτή· σε κινητό μπαίνουν σε διάταξη 2 × 2.

2. Δημιουργία projects

Η σελίδα Projects

Η σελίδα Projects δείχνει όλα τα projects ανάπτυξης σε πλέγμα από κάρτες.

Λίστα projects

Κάθε κάρτα project δείχνει: όνομα project, τύπο, περιγραφή, διαδρομή του φακέλου εργασίας, πλήθος ανοιχτών tickets, provider/μοντέλο και κουμπιά γρήγορων ενεργειών.

Δημιουργία νέου project

Πατήστε "+ New Project" για να ανοίξει το παράθυρο δημιουργίας.

Παράθυρο δημιουργίας project

3. Εισαγωγή projects

Εισαγάγετε υπάρχοντα projects από ZIP, Git ή τοπική διαδρομή.

Παράθυρο εισαγωγής project

Ιδιωτικά αποθετήρια Git

Η βάση δεδομένων της εφαρμογής (v4.55.1+) — η εισαγωγή ενός backup που φτιάχτηκε με την 4.55.1 ή νεότερη κρατά το όνομα, τον χρήστη και τον κωδικό της βάσης του project, ώστε οι ρυθμίσεις της ίδιας της εφαρμογής (.env …) να λειτουργούν χωρίς αλλαγή: ένα project σε container τα παίρνει μέσα στο νέο του container (τη δική του MySQL)· ένα project στον host τα παίρνει όταν αυτός ο server δεν έχει ούτε εκείνη τη βάση ούτε εκείνον τον χρήστη — αλλιώς παίρνει νέα, και το αποτέλεσμα το αναφέρει (ενημερώστε τις ρυθμίσεις της εφαρμογής ή ζητήστε από ένα ticket να το κάνει). Τα παλαιότερα backups επαναφέρονται ακόμη με νέα ονόματα.

Ο κωδικός του project (v4.55.0+) — μια εισαγωγή δεν παίρνει ποτέ κωδικό που έχει άλλο project, ή κωδικό που κρατά ακόμη τα backups ενός διαγραμμένου project (το νέο project θα τα αναλάμβανε): σε κωδικό που φτιάχνει το CodeHero προστίθεται 2, 3, … στο τέλος· ένας κωδικός που πληκτρολογείτε και είναι ήδη σε χρήση σταματά την εισαγωγή με μήνυμα, πριν ξεκινήσει οτιδήποτε, ώστε να διαλέξετε άλλον.

4. Η σελίδα του project

Πατήστε σε οποιοδήποτε project για να δείτε τη σελίδα του. Η σελίδα είναι οργανωμένη σε ενότητες που ανοιγοκλείνουν.

Επισκόπηση

Επισκόπηση project

Η πάνω ενότητα δείχνει τα στοιχεία του project (όνομα, τύπο, tech stack, περιγραφή), τα στοιχεία σύνδεσης με τη βάση δεδομένων με κουμπιά αντιγραφής, το preview URL, κουμπιά γρήγορων ενεργειών (Code Editor, Git Manager, Progress Dashboard, phpMyAdmin, Export, Context Settings, Archive) και στατιστικά χρήσης (tokens, χρόνος, ολοκληρωμένα tickets).

Ανάπτυξη σε παραγωγή

Βγάλτε το project σε ρύθμιση nginx έτοιμη για παραγωγή, με δικό του domain ή subdomain. Περιλαμβάνει διαχείριση πιστοποιητικών SSL.

Απομόνωση σε container (LXC)

Τρέξτε το project στο δικό του απομονωμένο LXC container με αποκλειστικές υπηρεσίες. Δείτε την Ενότητα 31 για όλες τις λεπτομέρειες.

Ρυθμίσεις PHP

Ρυθμίστε την έκδοση PHP του host και το .user.ini για projects που τρέχουν απευθείας στον host μέσω nginx:

• PHP Version — Επιλέξτε και εγκαταστήστε οποιαδήποτε έκδοση PHP (7.4–8.4). Εγκαθίσταται αυτόματα και ενημερώνει τη ρύθμιση του nginx.
• .user.ini Editor — Επεξεργαστείτε ρυθμίσεις PHP (upload_max_filesize, memory_limit, κ.λπ.) σε editor μέσα στη σελίδα ή σε πλήρη οθόνη.

Ρυθμίσεις context

Προσαρμόστε το AI context αυτού του project: επιλέξτε tech stack για να φορτωθούν οι προεπιλογές, επεξεργαστείτε το global context (καθολικοί κανόνες) και το project context (μοτίβα ανά γλώσσα). Το Global Context v6.2 είναι ένας πυρήνας συν οδηγοί κατ' απαίτηση (planning, verify-fix, asking, update, helper, debugging, frontend, database, build, testing, native, release) που ο agent ανοίγει με το εργαλείο codehero_get_guide· βρίσκονται στο /opt/codehero/config/guides/ και φορτώνονται αυτόματα στα tickets [PLAN], [REPLAN], [VERIFY], [FIX], [HELPER], [PEER] και [WORKER].

Αρχεία project

Ανέβασμα αρχείων & αρχεία project

Ανεβάστε αρχεία με drag & drop, περιηγηθείτε στο δέντρο φακέλων, διαγράψτε αρχεία και χρησιμοποιήστε το φίλτρο υποφακέλων. Περιλαμβάνει τα κουμπιά Refresh και Pop Out (άνοιγμα σε νέο παράθυρο).

Database Editor

Database Editor

Κάθε project παίρνει τη δική του βάση MySQL. Τέσσερις καρτέλες: Tables (κάρτες που πατιούνται, με πλήθος γραμμών), Structure (ορισμοί στηλών), Data (περιήγηση με σελιδοποίηση), SQL Query (εκτέλεση ερωτημάτων απευθείας).

Backup & επαναφορά

Backup & επαναφορά

Επιπλέον δυνατότητες: εξαγωγή/εισαγωγή image του container (από την v4.55.0 διαβάζονται μόνο τα δεδομένα του image — ένας δίσκος 50 GB με 3 GB δεδομένα διαβάζει 3 GB — και μια εισαγωγή επιστρέφει αραιό (sparse) image), ιστορικό backups με λήψη/επαναφορά/διαγραφή, και ανέβασμα & επαναφορά από άλλον server.

Πιο γρήγορα (v4.55.0+) — ελαφρύτερη συμπίεση (2–3× πιο γρήγορα για λίγο % μεγαλύτερο μέγεθος)· σε project με container, η δική του βάση, που ζει μέσα στο container, αποθηκεύεται μία φορά (παλιότερα αποθηκευόταν δύο)· το panel μένει γρήγορο όσο τρέχει ένα backup· το backup στο κλείσιμο ενός ticket δεν καθυστερεί πια τα tickets των άλλων projects (μόνο το επόμενο ticket εκείνου του project το περιμένει). Κάθε backup σημειώνει πόσα δευτερόλεπτα πήρε κάθε βήμα.

Automatic / Kept / Safety — το Backup History έχει τρεις καρτέλες. Automatic: όσα φτιάχνει η πλατφόρμα (κλείσιμο ticket, αυτόματα) — κρατιούνται τα 20 νεότερα (οποιοσδήποτε αριθμός· 0 = όλα). Kept: Quick / Full / Complete, εξαγωγές image και κάθε 📌 backup που κρατήσατε — δεν διαγράφονται ποτέ αυτόματα. Safety: όσα παίρνονται ακριβώς πριν από μια επαναφορά — τα 5 νεότερα.

Τίποτα δεν λείπει χωρίς ενημέρωση (v4.54.0+) — κάθε ZIP backup φτιάχνεται με ένα πέρασμα (χωρίς προσωρινό αντίγραφο· φωτογραφίες, βίντεο και αρχεία συμπίεσης αποθηκεύονται όπως είναι), κρατά symlinks, άδειους φακέλους και δικαιώματα αρχείων, και αποθηκεύει τη βάση του project με τις procedures, functions, triggers, events και views της. Ό,τι δεν μπόρεσε να αποθηκευτεί — ένα αρχείο που δεν διαβάζεται, μια βάση που δεν έγινε dump, ένα σταματημένο container — αναφέρεται: ⚠ δίπλα στο backup στη λίστα (περάστε το ποντίκι από πάνω για λεπτομέρειες), στο αποτέλεσμα του κουμπιού και του codehero_unified_backup. Μια βάση με χαλασμένο view αποθηκεύεται κανονικά (παραλείπεται μόνο το view, και κατονομάζεται). Ένα backup εμφανίζεται στη λίστα μόνο όταν ολοκληρωθεί.

Αντίγραφο ασφαλείας πριν από κάθε επαναφορά (v4.54.0+) — μια επαναφορά μέσα στο project παίρνει πρώτα ένα Safety snapshot ολόκληρου του container (projects σε container) και ένα πλήρες ZIP backup των αρχείων και κάθε βάσης· αν αυτό το αντίγραφο δεν μπορεί να γίνει, δεν επαναφέρεται τίποτα. Η εισαγωγή image container στο project παίρνει πρώτα το αντίγραφο ZIP (το image αντικαθιστά και τα snapshots του container). Ένα backup που επαναφέρεται ως νέο project φέρνει μαζί και τα αντικείμενα της βάσης του — ιδιοκτήτης τους γίνεται ο χρήστης βάσης του νέου project.

Τι αφήνουν έξω τα ZIP backups — μια λίστα που επεξεργάζεστε, ένα μοτίβο ανά γραμμή: από προεπιλογή το .secrets και οι φάκελοι εξαρτήσεων / build / cache (node_modules, vendor, .git, dist, …). Ένα όνομα ταιριάζει με φάκελο ή αρχείο με αυτό το όνομα οπουδήποτε· μια διαδρομή (public/uploads) με εκείνον τον φάκελο από τη ρίζα του project· τα * και ? είναι globs (*.mp4, uploads/tmp/*). Τα Quick / Full / Complete χρησιμοποιούν κάθε γραμμή· το Export και τα αυτόματα backups χρησιμοποιούν μόνο τη γραμμή .secrets. Η λίστα αποθηκεύεται μόνη της καθώς πληκτρολογείτε (η αφαίρεση της γραμμής .secrets ζητά πρώτα επιβεβαίωση)· το Defaults την επαναφέρει.

Secrets

Οι κωδικοί, τα κλειδιά και τα tokens που δίνετε σε ένα ticket φυλάσσονται ως αρχεία στο .secrets/ στη ρίζα του project:

Περισσότερη προστασία — ένας φάκελος στον host. Το κουμπί Create στο panel 🔐 Secrets φτιάχνει το /var/lib/codehero/secrets/<CODE>/, έξω από το project: ποτέ σε git, σε backup, σε export, στο image του container ή σε snapshot. Μόνο τα tickets αυτού του project μπορούν να το χρησιμοποιήσουν· σε project με container είναι ορατό μέσα στο container στην ίδια διαδρομή (το κουμπί επανεκκινεί ένα container που τρέχει μία φορά, ποτέ όσο τρέχει ticket του project). Διαγράφεται μαζί με το project.

Το μενού Secrets (v4.52.1+) δείχνει κάθε αρχείο και των δύο θέσεων, πιο κάτω στο ίδιο panel:

• + New set — τιμές για μία υπηρεσία, π.χ. facebook: σε κάθε γραμμή ένα είδος (Username, Password, API key, Token, Other) που προτείνει το όνομα (FACEBOOK_PASSWORD), μια προαιρετική σημείωση και η τιμή. Αποθηκεύεται ως .secrets/<name>.env, γραμμές KEY='value', δικαιώματα 600 — μια εντολή το διαβάζει με set -a; . .secrets/facebook.env; set +a.
• + Login — όνομα χρήστη και κωδικός μαζί (FACEBOOK_USERNAME + FACEBOOK_PASSWORD)· ένα δεύτερο login στο ίδιο set ζητά πρόθεμα.
• Where — μέσα στο project (.secrets/, η εφαρμογή μπορεί να το διαβάσει) ή στον φάκελο του host (μόνο οι εντολές των tickets).
• Οι τιμές μένουν κρυφές — μόνο ονόματα· το 👁 δείχνει μία τιμή για 30 δευτερόλεπτα· το Edit κρατά κάθε τιμή που αφήνετε κενή.
• Το + File ανεβάζει αρχείο κλειδιού, JSON ή YAML· το Edit as text ανοίγει ένα αρχείο κειμένου. Ένα αρχείο με δική του μορφή εμφανίζεται ως αρχείο — το μενού δεν χαλάει ποτέ από αυτό· τα BOM / CRLF επισημαίνονται.

Το φίλτρο secrets (v4.53.0+) — οι τιμές που κρατάτε στο .secrets/ και στον φάκελο του host δεν φτάνουν ποτέ στον AI provider:

• Το είδος αποφασίζει. 🛡 Password, API key, Token, Other secret· ορατά στο AI: Username και Setting (host, port, URL, ID). Το panel δείχνει 🛡 ή visible ανά κλειδί· το Format δείχνει το πρότυπο. Ένα κλειδί χωρίς είδος κρίνεται από το όνομά του (PASSWORD, PASS, PWD, SECRET, TOKEN, KEY, PRIVATE, AUTH, CREDENTIAL, SALT, SIGNATURE, COOKIE, SESSION — όχι PUBLIC / PUBLISHABLE, όχι ονόματα που τελειώνουν σε TYPE, NAME, ID, URL, HOST, PORT, PATH, FILE, REGION, MODE). Ένα ιδιωτικό κλειδί, ένα αρχείο μίας γραμμής και κάθε άλλο κείμενο προστατεύονται· τα JSON / YAML / INI με βάση τα ονόματα των κλειδιών. Τιμές κάτω από 8 χαρακτήρες δεν μπορούν να αναγνωριστούν (σημειώνονται με ⚠).
• Τι βλέπει το AI — τα ονόματα (ποτέ τιμή)· χρησιμοποιεί τα αρχεία μέσω της διαδρομής τους. Μια έξοδος που περιέχει τιμή δεν αποστέλλεται (⛔· με # codehero-mask βλέπει σημάδια [secret: …])· η εγγραφή μιας τιμής απορρίπτεται· όταν το δικό του κείμενο περιέχει μία, αποθηκεύεται ως stub και γράφεται ξανά. Μια τιμή που δημιουργεί το ίδιο αποθηκεύεται με codehero-secret χωρίς να εμφανιστεί.
• Τα μηνύματά σας — ένα μήνυμα ή μια περιγραφή ticket που περιέχει μία από αυτές τις τιμές δεν αποστέλλεται: η οθόνη κατονομάζει το αρχείο και το κλειδί· το κείμενό σας μένει στο πλαίσιο. Ένας κωδικός που πληκτρολογείται στο chat και δεν βρίσκεται στο .secrets/ δεν φιλτράρεται.
• Προστατεύονται επίσης τα κλειδιά providers της πλατφόρμας και τα logins του Claude / Codex.
• Όρια — ένα screenshot που δείχνει μια τιμή· τιμές κάτω από 8 χαρακτήρες· μια τιμή γραμμένη με το χέρι σε αρχείο που το Claude CLI φορτώνει μόνο του (CLAUDE.md). Το Codex χρειάζεται τα hooks που γράφει η αναβάθμιση στο /etc/codex/requirements.toml· χωρίς αυτά ένα ticket Codex δεν ξεκινά και λέει γιατί.

Danger Zone

Διαγράψτε το project και όλα τα δεδομένα του. Από την v4.55.0 το παράθυρο ρωτά: Take a Complete backup first (η προεπιλογή — αρχεία, κάθε βάση, tickets· αν το backup αποτύχει ή του λείψει μια βάση, π.χ. ενός σταματημένου container, δεν διαγράφεται τίποτα) ή Delete without a backup.

Τα backups που αφήνει ένα διαγραμμένο project — το τελευταίο και τα προηγούμενα — βρίσκονται στο Dashboard → Import Project → Existing backups → Deleted projects: το Import φέρνει πίσω το project (με νέο κωδικό), Download, Delete για ένα, ή Delete all — μαζί και τα dumps των βάσεών του (v4.55.1+). (Πριν από την v4.55.0 το παράθυρο υποσχόταν ένα backup που δεν γινόταν ποτέ.) Μια διαγραφή δεν σβήνει ποτέ βάση ή χρήστη βάσης που χρησιμοποιεί ακόμη άλλο project (v4.55.1+).

5. Ρυθμίσεις project & context

Project context

Κάθε project έχει ένα AI context που βοηθά το AI να καταλάβει τον κώδικα:

• Αυτόματο — Δημιουργείται κατά την ανάλυση του project
• Χειροκίνητο — Προσθέστε δικές σας οδηγίες, πρότυπα κώδικα, σημειώσεις αρχιτεκτονικής
• Αναγνώριση framework — Αναγνωρίζει αυτόματα το tech stack και τα σχετικά αρχεία

Ρυθμίσεις project

Επεξεργαστείτε τις ρυθμίσεις από τη σελίδα του project: αλλάξτε provider, AI model, think mode, ενημερώστε περιγραφή και context, ορίστε τον προεπιλεγμένο τρόπο εκτέλεσης, ρυθμίστε auto-commit και auto-push για το git.

6. Δημιουργία tickets

Τα tickets είναι η βασική μονάδα εργασίας. Κάθε ticket αντιστοιχεί σε μια εργασία που θα ολοκληρώσει το AI.

Δημιουργία ticket

Η σελίδα Tickets

Tickets του project

Δυνατότητες: αλλαγή σειράς με drag-and-drop, φιλτράρισμα κατά κατάσταση/τύπο/προτεραιότητα, μαζικές ενέργειες και οπτική απεικόνιση της σειράς.

7. Τύποι tickets & προτεραιότητα

Τύποι tickets

Προτεραιότητα

8. Τρόποι εκτέλεσης

Ελέγξτε πόση ελευθερία έχει το AI όταν δουλεύει σε tickets.

Λεπτομέρειες του Semi-Autonomous

Εγκρίνονται αυτόματα (χωρίς ερώτηση)

• Δημιουργία/επεξεργασία/διαγραφή αρχείων μέσα στον φάκελο του project
• Εκτέλεση tests (npm test, pytest, phpunit)
• Εντολές build (npm run build, composer install)
• Ενέργειες ανάγνωσης git (git status, git log, git diff)

Χρειάζονται έγκριση

• Εγκατάσταση πακέτων (npm install, pip install)
• Ενέργειες εγγραφής git (git commit, git push)
• Migrations βάσης δεδομένων
• Αιτήματα δικτύου (curl, wget)

Μπλοκάρονται

• Εντολές συστήματος (sudo, apt, systemctl)
• Αλλαγές στον φάκελο .git
• Πρόσβαση σε διαδρομές συστήματος (/etc, /opt/codehero)
• Επικίνδυνες εντολές (rm -rf /, chmod 777)

9. Σειρά εκτέλεσης & εξαρτήσεις

Αριθμοί σειράς

Ελέγξτε τη σειρά εκτέλεσης: δώστε έναν αριθμό (1, 2, 3...) σε κάθε ticket. Οι μικρότεροι αριθμοί τρέχουν πρώτοι. Ίδιος αριθμός = εκτέλεση παράλληλα (όσα ταυτόχρονα επιτρέπουν οι θέσεις MAX_PARALLEL_TICKETS_PER_PROJECT της εγκατάστασης). Ένας μεγαλύτερος αριθμός ξεκινά μόνο όταν κάθε ticket με μικρότερο αριθμό είναι done ή skipped· ένα ticket που μένει σε awaiting_input κρατά πίσω όλα όσα ακολουθούν. Μια εξάρτηση ικανοποιείται μόνο από done/skipped, και στο relaxed και στο strict.

sequence_order=1: [Setup DB, Install deps]     → Run in PARALLEL
sequence_order=2: [Build auth]                  → Waits for seq=1
sequence_order=3: [Users API, Products API]     → Run in PARALLEL

Παράλληλη εργασία και lead mode

Ένα πλάνο τρέχει σειριακά από προεπιλογή: το ένα ticket μετά το άλλο. Tickets μοιράζονται αριθμό σειράς (και τρέχουν παράλληλα) μόνο όταν ζητήσετε παράλληλη εργασία και το planning ticket έχει αποδείξει ότι κανένα δύο από αυτά δεν γράφουν το ίδιο αρχείο.

Μία περίπτωση δεν χρειάζεται έγκριση, γιατί τίποτα δεν μπορεί να συγκρουστεί: το lead mode. Αφού το planning ticket και ο peer του συμφωνήσουν στο πλάνο και έχουν δοθεί οι απαντήσεις σας, ο planner μπορεί να φτιάξει 2–5 στενά συνδεδεμένα μέρη ταυτόχρονα ως tickets [WORKER] που του αναφέρουν:

• ο planner γράφει πρώτα τα κοινά αρχεία (contracts, routes, config, αρχεία πακέτων, κοινό CSS)· ένας worker δεν τα αγγίζει ποτέ·
• κάθε worker παίρνει το δικό του SPEC FILE και μια γραμμή OWNS: με τα μόνα αρχεία που επιτρέπεται να γράψει, μαζί με το δικό του log .specs/<NNN>-<part>.log· μια αλλαγή αρχείου έξω από αυτή τη γραμμή απορρίπτεται από την πλατφόρμα·
• ο planner σταθμεύει με ⏸ WAITING-FOR-ALL-TICKETS #a, #b (…) και ξυπνά μία φορά, όταν κάθε worker έχει απαντήσει ή τελειώσει·
• διαβάζει το log κάθε worker, τρέχει τα tests του, ελέγχει στο git diff ότι ο worker άλλαξε μόνο τα δικά του αρχεία, στέλνει τα ευρήματα πίσω σε εκείνον τον worker και κλείνει ο ίδιος κάθε worker.

Το lead mode είναι για λίγα μικρά, στενά συνδεδεμένα μέρη· μια μεγάλη φάση μένει κανονικά tickets με [VERIFY] και [REPLAN].

Relaxed και strict (deps_include_awaiting)

Η ροή αποφασίζει ποιος κλείνει ένα ticket όταν ο agent τελειώνει τη σειρά του (κάθε εκτέλεση τελειώνει σε awaiting_input). Η αναφορά του agent ξεκινά με δύο γραμμές που διαβάζει ο reviewer: NEEDS THE USER: yes/no και OPEN ISSUES AND DOUBTS: …. Πριν τις γράψει, ο agent ελέγχει τη δική του αναφορά: η εργασία που τελείωσε ή καταγράφηκε αναφέρεται ως ολοκληρωμένη, όχι ως ανοιχτό θέμα· μια τεχνική αμφιβολία που δεν μπορεί να λύσει τη δοκιμάζει με άλλο τρόπο και μετά την πηγαίνει σε ένα helper ticket· μόνο ό,τι πραγματικά χρειάζεται εσάς γίνεται yes. Το yes κρατά πάντα το ticket ανοιχτό για εσάς. Ένα chain ticket ([VERIFY], [FIX], [PLAN], [REPLAN]) κλείνει με το δικό του no· οι αμφιβολίες που αναφέρει μένουν καταγεγραμμένες. Ένα ticket [PEER], [HELPER] ή [WORKER] δεν κλείνει ποτέ αυτόματα: το κλείνει το ticket που το άνοιξε. Ένα build ticket του οποίου οι γραμμές λένε no + none κλείνει με αυτές τις γραμμές (ο έλεγχος είναι το επόμενο [VERIFY]). Μια αναφορά που αντιφάσκει (no και μετά λίστα ανοιχτών θεμάτων) ή που δεν έχει τις δύο γραμμές επιστρέφεται μία φορά: ο reviewer γράφει στο ticket (📨 SYSTEM (auto-reviewer): …), ο agent διορθώνει τις γραμμές του και το ticket κλείνει χωρίς να σας περιμένει· αν και η δεύτερη αναφορά αντιφάσκει, το ticket σας περιμένει (ποτέ βρόχος). Ένα ticket σταθμευμένο με ⏸ WAITING-FOR-TICKET #id (number · title) — ή ⏸ WAITING-FOR-ALL-TICKETS #a, #b (…) — περιμένει εκείνα τα tickets (δείτε Tickets που ανοίγουν άλλα tickets). Ένα planning ticket δεν μπορεί να δημιουργήσει tickets όσο ένας peer, helper ή worker του project είναι ακόμη ανοιχτός (η πλατφόρμα αρνείται), και ένα όριο παραθύρου συνδρομής που αναφέρει το CLI σταματά προσωρινά το ticket και ξαναδοκιμάζει κάθε λίγα λεπτά μέχρι να επανέλθει το παράθυρο.

Ο auto-reviewer, ο watchdog (κάθε 30 λεπτά ελέγχει ότι ένα ticket που τρέχει δεν έχει κολλήσει) και οι περιλήψεις των tickets σκέφτονται σε balanced από προεπιλογή, στον provider του ticket. Αλλάξτε το ανά ρόλο στο heroagent.conf → role_think_modes (close_ticket_reviewer, kill_switch: off, basic, balanced ή ultra).

10. Sub-tickets & parent tickets

Σπάστε σύνθετες εργασίες σε μικρότερα κομμάτια:

1. Δημιουργήστε ένα κύριο (parent) ticket
2. Δημιουργήστε sub-tickets με το Parent Ticket ορισμένο στο κύριο ticket
3. Τα sub-tickets κληρονομούν το project context + λαμβάνουν την περίληψη της συνομιλίας του parent

Τα sub-tickets περιμένουν πρώτα να ολοκληρωθεί ο parent και μετά λαμβάνουν context από τον τίτλο, την περιγραφή και τα τελευταία 50 μηνύματα του parent.

Tickets που ανοίγουν άλλα tickets

Τα tickets ανοίγουν άλλα tickets ενώ δουλεύουν: ένα planning ticket ανοίγει έναν [PEER] που ελέγχει το πλάνο του (και [WORKER]s στο lead mode), ένας verifier ανοίγει ένα [FIX] για τον builder, και κάθε ticket μπορεί να ανοίξει ένα [HELPER] για μια αμφιβολία που δεν μπορεί να λύσει. Η πλατφόρμα καταγράφει ποιος άνοιξε κάθε ticket (created_by_ticket_id). Επικοινωνούν με μηνύματα (codehero_update_ticket(reply=…), με υπογραφή 📨 FROM TICKET #id): ένα ticket που δουλεύει διαβάζει ένα μήνυμα στο επόμενο βήμα του, ένα σταθμευμένο ticket ξυπνά από αυτό. Η πλατφόρμα φροντίζει να μην περιμένει κανείς για πάντα:

Ένα κλειστό ticket (done ή skipped) δεν ξυπνά ποτέ από κανένα από αυτά.

Όταν η απάντησή σας αλλάζει το προϊόν. Απαντάτε στην ερώτηση ενός ticket και η απάντηση αλλάζει μια απαίτηση (για παράδειγμα η προθεσμία πληρωμής γίνεται 45 ημέρες αντί για 30). Το ticket καταγράφει την αλλαγή μία φορά, ως γραμμή στο αρχείο αλλαγών .specs/000-changes.md (οδηγός update.md), ενημερώνει τα specs και τα tests της εργασίας που είναι ακόμη ανοιχτή και στέλνει μια ενημέρωση μόνο για πληροφόρηση στα ημιτελή tickets που αφορά. Κάθε ticket διαβάζει πρώτα το αρχείο αλλαγών, ώστε τα επόμενα tickets, ο verifier και το replan να γνωρίζουν την αλλαγή χωρίς να την επαναλαμβάνετε· ολοκληρωμένη εργασία που αναφέρει ακόμη την παλιά τιμή γίνεται ανοιχτό θέμα που διορθώνει το επόμενο [REPLAN].

11. Κύκλος ζωής tickets & ενέργειες

Καταστάσεις ticket

Λεπτομέρειες ticket

Σελίδα λεπτομερειών ticket

Συνομιλία ticket

Συνομιλία ticket

Σε κινητό, tablet ή αναδιπλούμενη συσκευή η συνομιλία παίρνει την οθόνη. Μέχρι πλάτος 1100 px (tablets, ένα ανοιχτό Galaxy Fold) το μενού βρίσκεται πίσω από το ☰ και οι λεπτομέρειες του ticket ανοίγουν από το Details. Με κύλιση της συνομιλίας προς τα κάτω κρύβεται η μπάρα μενού, και με κύλιση προς τα πάνω εμφανίζεται ξανά. Όσο πληκτρολογείτε, τα 📎 και 🎤 παραμερίζουν ώστε το πλαίσιο κειμένου να πάρει το πλάτος. Ένας μεγάλος τίτλος ticket μένει σε μία γραμμή. Όταν επιστρέφετε στην εφαρμογή αφού η οθόνη ήταν σβηστή, εμφανίζονται τα μηνύματα που έφτασαν στο μεταξύ, χωρίς ανανέωση.

Ενέργειες

12. Αυτόματη επανάληψη

Τα αποτυχημένα tickets μπορούν να ξαναδοκιμάσουν αυτόματα. Κάθε ticket έχει retry_count (ξεκινά από 0) και max_retries (προεπιλογή 3). Όταν ένα ticket αποτύχει, το retry_count αυξάνεται. Αν retry_count < max_retries, το ticket επανέρχεται σε open και δοκιμάζει ξανά.

13. Υποστήριξη πολλών providers

Το CodeHero δρομολογεί μέσω 7 cloud providers — οι πέντε από αυτούς και με συνδρομή σταθερής τιμής — και ενός επιλεγμένου καταλόγου του OpenRouter (24 μοντέλα παρακάτω). Αλλάζετε ανά εργασία — ποτέ δεσμευμένοι. Τοπικά μοντέλα και μοντέλα στον δικό σας server: τα Ollama, vLLM και γενικά OpenAI-compatible endpoints (LM Studio, llama.cpp …) είναι υποστηριζόμενοι adapters — χρειάζονται ρύθμιση και δεν είναι ενεργά από προεπιλογή.

Οι providers μπορεί να προσφέρουν περισσότερα μοντέλα από τα τρία προεπιλεγμένα των ρόλων τους· το εργαλείο codehero_get_model_table δείχνει τα αποδεκτά, με τους ρόλους τους, το vision, το κόστος, τη βαθμολογία και τον ρόλο που κερδίζει η βαθμολογία, και το planning ticket μπορεί να δώσει σε ένα ticket οποιοδήποτε από αυτά (το model του ticket). Με κληρονομημένες ρυθμίσεις και το προεπιλεγμένο μοντέλο του ρόλου, όταν ένα μοντέλο καλύπτει δύο ρόλους, ο ανώτερος ρόλος σκέφτεται ένα βήμα περισσότερο (με ανώτατο το pro)· το δικό του think mode ή μοντέλο ενός ticket υπερισχύει.

Κατάλογος OpenRouter με τιμές & δυνατά σημεία

Τιμές ανά 1M tokens όπως είναι στον πίνακα τιμών αυτής της έκδοσης (εκτιμήσεις· η σελίδα του ίδιου του OpenRouter είναι η έγκυρη). Το Sub σημειώνει μοντέλο του οποίου την οικογένεια μπορείτε να τρέξετε και με συνδρομή σταθερής τιμής μέσω του δικού της provider. Το βάρος Smart είναι 1–10 (10 = η αιχμή του arena).

Βάρη κόστους (προεπιλογές της έκδοσης, 1-10 — μικρότερο = φθηνότερο)

Βάρη ικανότητας (Smart, προεπιλογές της έκδοσης, 1-10 — μεγαλύτερο = ισχυρότερο)

Τα βάρη ικανότητας είναι αρχικές τιμές: μια επόμενη έκδοση μετρά κάθε μοντέλο και ορίζει τη βαθμολογία και τον ρόλο του από τα αποτελέσματα.

Καμία σύνδεση με τα πρόσθετα του λογαριασμού σας Claude / ChatGPT (v4.55.0+) — κάθε Claude CLI που ξεκινά το CodeHero (tickets, ο reviewer, ο assistant) τρέχει χωρίς τους connectors του claude.ai (Gmail, Google Drive, Calendar, Claude Docs), τα skills και τα plugins που συγχρονίζονται από το claude.ai, το εργαλείο Artifact και το Remote Control· το Codex τρέχει χωρίς τις εφαρμογές και τα plugins του ChatGPT. Μόνο για αυτές τις εκτελέσεις — τίποτα στον δίσκο δεν μετακινείται, και οι δικές σας sessions δεν επηρεάζονται. Τα εργαλεία codehero παραμένουν.

Η σύνθεση αλλάζει από έκδοση σε έκδοση: η σελίδα Providers (και το εργαλείο codehero_get_providers_info) δείχνει τα μοντέλα, τα βάρη και τα δυνατά σημεία της δικής σας εγκατάστασης.

14. Ρόλοι developer

Κάθε ticket αποθηκεύει έναν ρόλο developer· το συγκεκριμένο μοντέλο προκύπτει από τα model_aliases του provider στο heroagent.conf, οπότε ένα νέο μοντέλο δεν χρειάζεται καμία αλλαγή στα tickets.

Ο ίδιος ρόλος δεν σημαίνει την ίδια ικανότητα παντού: συγκρίνετε τα βάρη ικανότητας (Ενότητα 13). Ο junior της Anthropic (Sonnet 5.5, βάρος ικανότητας 9) μπορεί να πάρει μέτρια εργασία· ένας junior με βάρος ικανότητας 7 ή λιγότερο παίρνει μόνο τετριμμένη και απλή εργασία.

Ρόλος και think mode ανά είδος ticket

Το planning ticket τα ορίζει για κάθε ticket που δημιουργεί — οικονομία χωρίς απώλεια ποιότητας: το πλάνο το φτιάχνουν δύο seniors διαφορετικών οικογενειών (ο planner και ο peer του) που το ελέγχουν μαζί, με το πολύ τρεις ανταλλαγές· τα build tickets, όπου πηγαίνουν τα περισσότερα tokens, τρέχουν σε junior. Master μόνο όταν το επιλέξετε — στο project ή σε οποιοδήποτε μεμονωμένο ticket· η επιλογή σας υπερισχύει πάντα.

Δυσκολία ενός build ticket

Η στρατηγική eco κατεβαίνει ένα βήμα (ποτέ για δύσκολη εργασία, ποτέ κάτω από junior + off)· η performance ανεβαίνει ένα βήμα. Ένα μέρος που απέτυχε στο παρελθόν ανεβαίνει ένα βήμα.

15. Think Mode (εκτεταμένη σκέψη)

Το ultra δεν είναι ποτέ προεπιλογή project: ανήκει στα tickets της Ενότητας 14 και στη ρητή επιλογή σας. Το think mode αγοράζει κυρίως ταχύτητα και βάθος παρά κόστος — τα περισσότερα tokens είναι το project context που διαβάζεται ξανά σε κάθε βήμα.

Πώς το εφαρμόζει κάθε provider

Όριο context

Κάτω από το Think Mode — στο project, στη φόρμα νέου ticket και στη σελίδα του ticket — το Context limit ορίζει το μέγεθος στο οποίο συμπιέζεται το context ενός ticket. Το Claude CLI και το Codex συμπιέζουν το δικό τους context σε αυτό και ξεκινούν κάθε εκτέλεση μέσα σε αυτό· με τους API providers η δική του συμπίεση του CodeHero τρέχει σε αυτό. Όσο δουλεύει το Claude CLI ή το Codex, το CodeHero εξακολουθεί να συνοψίζει το αποθηκευμένο ιστορικό στα μεγαλύτερα όρια του heroagent.conf, ώστε να μην ξεπερνά ποτέ μία περίληψη. Μικρότερο context σημαίνει λιγότερα tokens σε κάθε κλήση.

• Auto (συνιστάται): ανάλογα με το είδος του ticket και τον provider. Μια τιμή του project κληρονομείται από τα tickets του, όπως το think mode· η δική του τιμή ενός ticket υπερισχύει.
• Ποτέ πάνω από το 80 % του παραθύρου του μοντέλου· ποτέ τόσο χαμηλά ώστε η εκτέλεση να συμπιεστεί ξανά αμέσως (οι σταθερές οδηγίες + το ιστορικό που κρατιέται + 60K χώρος εργασίας).

Η σειρά είναι plan > verify > build > fix. Ένας [PEER] σκέφτεται το ίδιο πρόβλημα με το ticket που τον άνοιξε, οπότε παίρνει τη δική του τιμή εκείνου του ticket, ή το Auto του είδους του στη στήλη του peer (peer ενός planner: 400K / 300K)· χωρίς ticket που τον άνοιξε, του planner. Ένας verifier ανοίγει ένα [FIX] ανά εύρημα (ή ανά μικρή ομάδα στο ίδιο σημείο, το πολύ πέντε ανά κύκλο), κάτι που κρατά κάθε διόρθωση μικρή.

Ένας planner ορίζει τιμή μόνο με λόγο — 100K για ticket που μόνο τρέχει tests, 500K–800K για planning ticket που πρέπει να διαβάσει πολύ μεγάλο baseline. Ο πίνακας βρίσκεται στο heroagent.conf (context_limits).

16. Υποστήριξη εικόνας (vision)

Κάποιοι providers μπορούν να «βλέπουν» — να αναλύουν screenshots, διατάξεις UI και οπτικό περιεχόμενο.

17. Code Editor

Ο ενσωματωμένος Monaco Editor προσφέρει επεξεργασία ποιότητας VS Code μέσα στον browser σας.

Code Editor

• Χρωματισμός σύνταξης για όλες τις κύριες γλώσσες
• Αυτόματη συμπλήρωση με ενσωμάτωση LSP
• Τεκμηρίωση με hover — περάστε το ποντίκι πάνω από συναρτήσεις για τεκμηρίωση
• Μετάβαση στον ορισμό — Ctrl+Click για να πάτε στους ορισμούς
• Εντοπισμός σφαλμάτων σε πραγματικό χρόνο — κυματιστές γραμμές για σφάλματα/προειδοποιήσεις
• Επεξεργασία σε πολλές καρτέλες — όταν οι καρτέλες δεν χωρούν πια, εμφανίζονται κουμπιά ‹ › και μια λίστα όλων των ανοιχτών αρχείων· η ροδέλα του ποντικιού κυλά τις καρτέλες, και η καρτέλα που ανοίγετε είναι πάντα ορατή
• Δέντρο αρχείων — πλοήγηση στα αρχεία του project στην πλαϊνή μπάρα
• Αναζήτηση & αντικατάσταση — Ctrl+H
• Minimap — επισκόπηση του κώδικα στα δεξιά

18. File Explorer

File Explorer

• Δέντρο φακέλων που ανοιγοκλείνει
• Προεπισκόπηση αρχείων για κείμενο, εικόνες και κώδικα
• Ανέβασμα με drag-and-drop ή επιλογή αρχείου
• Δημιουργία, μετονομασία, διαγραφή αρχείων και φακέλων
• Λήψη αρχείων

19. Git Manager

Πλήρης έλεγχος εκδόσεων μέσα από το web περιβάλλον.

Git Manager - αποθετήρια

Το CodeHero εντοπίζει αυτόματα τα αποθετήρια Git στον φάκελο του project σας. Υποστηρίζονται πολλά αποθετήρια ανά project.

Clone & Init

Clone αποθετηρίου

Κάντε clone απομακρυσμένα αποθετήρια (HTTPS/SSH), αρχικοποιήστε νέα αποθετήρια και αποθηκεύστε στοιχεία πρόσβασης Git ανά αποθετήριο.

Clone πάνω σε παλιά αρχεία: τσεκάρετε το Replace local files with the repository's files — πρώτα λαμβάνεται ένα snapshot ασφαλείας (χωρίς αυτό δεν αντικαθίσταται τίποτα)· προαιρετικά διαγράφονται και τα τοπικά αρχεία που δεν υπάρχουν στο αποθετήριο (τα αγνοημένα αρχεία όπως το .env μένουν πάντα, όπως και ένα άλλο αποθετήριο μέσα στον φάκελο). Το παράθυρο δείχνει κάθε βήμα ζωντανά με τον χρόνο του (snapshot ασφαλείας, fetch, checkout). Αρχεία άλλου χρήστη (τα αρχεία που σερβίρονται στο web ανήκουν συχνά στον www-data) περνούν στην ιδιοκτησία σας όταν το αποθετήριο τα παρακολουθεί, ώστε το Git να μπορεί να τα αντικαταστήσει τώρα και να κάνει pull αργότερα· τα υπόλοιπα κρατούν τον ιδιοκτήτη τους. Το Remove repository (Settings → Danger zone) διαγράφει το .git και το .gitignore εκείνου του αποθετηρίου στον δικό του φάκελο και την εγγραφή του με τα αποθηκευμένα στοιχεία πρόσβασης· τα άλλα αρχεία και τα άλλα αποθετήρια του project μένουν.

Αλλαγές & commits

Αλλαγές & commits

Διάταξη όπως η προβολή commit ενός IDE: τα αλλαγμένα αρχεία αριστερά, το καθένα με ένα τσεκ — γίνονται commit μόνο τα τσεκαρισμένα αρχεία (Commit / Commit and Push)· ένα αρχείο χωρίς τσεκ μένει χωρίς commit, και μετά από Refresh. Πατήστε ένα αρχείο για να το δείτε από το τελευταίο commit μέχρι τώρα στα δεξιά: Split = πριν | μετά δίπλα-δίπλα, το Whole file δείχνει και τις αμετάβλητες γραμμές, και η πλήρης οθόνη δίνει στην προβολή όλη την οθόνη. Η προβολή διαφορών: μία κάρτα ανά αρχείο (Added / Modified / Deleted / Renamed, μετρητές +/−), παλιοί και νέοι αριθμοί γραμμών, επισήμανση του αλλαγμένου μέρους μιας γραμμής που άλλαξε, Unified / Split (απομνημονεύεται), οι staged και οι μη staged αλλαγές χωριστά, και Open in editor ↗. Η ίδια προβολή χρησιμοποιείται στο History και στα Backups.

Branches

Branches

Δείτε τοπικά και απομακρυσμένα branches, δημιουργήστε, κάντε checkout, merge με επίλυση conflicts, και διαγράψτε. Το Checkout σε απομακρυσμένο branch σας μεταφέρει στο τοπικό σας branch που το παρακολουθεί (ή το δημιουργεί). Χωρίς ενεργό branch (ένα tag ή ένα commit), η κάρτα δείχνει detached @<commit> και μια ειδοποίηση προσφέρει το Create branch here, ώστε τα commits που γίνονται εκεί να μπορούν να γίνουν push. Το push δημιουργεί νέο branch στο remote και το βάζει να το παρακολουθεί· το History σημειώνει ένα commit ως pushed όταν το έχει ένα απομακρυσμένο branch.

Conflicts

Όταν ένα merge ή pull σταματά σε conflicts, εμφανίζεται η καρτέλα Conflicts (N). Ένα banner λέει τι συγχωνεύεται σε τι, και κάθε αρχείο δείχνει τα μπλοκ conflict δίπλα-δίπλα (ours = το τρέχον branch σας, theirs = το branch που συγχωνεύεται) με επισημασμένες τις λέξεις που διαφέρουν και τις γύρω γραμμές.

• Keep ours / Keep theirs / Keep both — ανά μπλοκ· Ours / Theirs everywhere — όλα τα μπλοκ μαζί (οι αλλαγές που συγχώνευσε μόνο του το git μένουν), και μετά σημειώνεται ως επιλυμένο
• Edit ↗ — ανοίγει το αρχείο στον Code Editor στη γραμμή εκείνου του μπλοκ
• Mark as resolved — απορρίπτεται όσο μένουν σημάδια conflict
• Commit the merge όταν όλα τα αρχεία έχουν επιλυθεί, ή Abort merge

Tags

Tags

Δείτε, δημιουργήστε (lightweight και annotated), κάντε push και διαγράψτε tags.

History

Ιστορικό commits

Log των commits με συντάκτη, ημερομηνία, μήνυμα. Προβολή διαφορών ανά commit. Revert συγκεκριμένων commits. Reset σε οποιοδήποτε commit (soft/mixed/hard).

Stash

Stash

Κάντε stash τις τρέχουσες αλλαγές, δείτε τη λίστα των stashes, apply/pop και drop.

Diff Viewer

Diff Viewer σε πλήρη οθόνη

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

Ιστορικό backups

Ιστορικό backups

Auto-Commit & Auto-Push

Ρυθμίζονται ανά αποθετήριο: auto-commit όταν το AI ολοκληρώνει ένα ticket, auto-push μετά το auto-commit.

Settings

Ρυθμίσεις αποθετηρίου

Διαχείριση του remote URL, στοιχεία πρόσβασης, διακόπτες auto-commit/auto-push, ρύθμιση του προεπιλεγμένου branch.

20. Console (έξοδος σε πραγματικό χρόνο)

Console

• Ζωντανή ροή — Βλέπετε την έξοδο του AI τη στιγμή που γίνεται
• Αυτόματη κύλιση — Ακολουθεί αυτόματα το νέο περιεχόμενο
• Pause/Resume — Σταματάτε την κύλιση για να διαβάσετε
• Χρωματική κωδικοποίηση — Διαφορετικά χρώματα για διαφορετικά είδη εξόδου

21. Web Terminal

Web Terminal

• Πραγματική πρόσβαση σε shell — Πλήρες τερματικό PTY μέσω WebSocket
• Υποστήριξη popup — Άνοιγμα σε popup για πολλές οθόνες
• Πλήρης πρόσβαση sudo
• Υποστήριξη 256 χρωμάτων με xterm.js
• Αντιγραφή/επικόλληση — Συνηθισμένες λειτουργίες clipboard

22. Package Manager

Package Manager

23. Ιστορικό sessions

Ιστορικό sessions

Δείτε όλες τις προηγούμενες sessions εκτέλεσης του AI: ώρες έναρξης/λήξης, διάρκεια, κωδικούς εξόδου (0 = επιτυχία), το σχετικό ticket, χρήση tokens και πλήρες log της session. Φιλτράρισμα κατά ημερομηνία, project ή κατάσταση.

24. Πρόοδος project

Πρόοδος project

Οπτική επισκόπηση: ποσοστό ολοκλήρωσης, πλήθος tickets ανά κατάσταση/τύπο, απεικόνιση της ροής της σειράς, κατανομή μοντέλων και ενσωματωμένος AI assistant για συνομιλία ειδικά για το project.

25. Kill Switch

Σταματήστε το AI αμέσως όταν δουλεύει σε ένα ticket.

Δεν χρειάζεται να σταματήσετε ένα ticket για να του μιλήσετε. Γράψτε στη σελίδα του ticket ή στο chat του κινητού και πατήστε Send ενώ δουλεύει: το μήνυμα φεύγει αμέσως και ο agent το διαβάζει στο επόμενο βήμα του (Claude, Codex και κάθε API provider), στην ίδια εκτέλεση — όπως ένα μήνυμα από άλλο ticket. Ένα μήνυμα που φτάνει καθώς τελειώνει η εκτέλεση ξανανοίγει το ticket, οπότε τίποτα δεν χάνεται. Χρησιμοποιήστε το Kill Switch μόνο για να σταματήσετε την εργασία.

Τι συμβαίνει: ο agent σταματά αμέσως μαζί με όλα όσα ξεκίνησε (το Claude CLI ή τον Codex app server, το sandbox τους, την εντολή που τρέχει), η κατάσταση του ticket γίνεται awaiting_input, και μπορείτε να δώσετε νέες οδηγίες ή διορθώσεις.

Η καρτέλα Live Preview. Δείχνει τη σελίδα του project μέσα στο panel. Από την v4.50.10, όταν η εφαρμογή αρνείται να εμφανιστεί μέσα σε άλλη σελίδα (frame-ancestors 'none' ή X-Frame-Options: DENY), η καρτέλα το λέει και προσφέρει το Open in a new tab αντί να μένει άδεια. Για να βλέπετε μια τέτοια εφαρμογή εκεί κατά την ανάπτυξη, αφήστε την να επιτρέπει το panel μόνο με CSP: frame-ancestors 'self' https://<its own host>:<panel port> στην ανάπτυξη (ποτέ https://*:<panel port> — οποιοσδήποτε host σε εκείνη τη θύρα θα μπορούσε να την ενσωματώσει· κρατήστε το X-Frame-Options, οι browsers το αγνοούν όταν υπάρχει frame-ancestors), 'none' στην παραγωγή.

26. AI Assistant

AI Assistant

• Επιλογή provider — Διαλέξτε οποιονδήποτε ενεργό provider
• Επιλογή μοντέλου — Διαλέξτε ρόλο developer
• Διαχείριση sessions — Πολλές sessions συνομιλίας, αποθηκευμένο ιστορικό
• Αναδυόμενο παράθυρο — Άνοιγμα σε ξεχωριστό παράθυρο
• Φωνητική εισαγωγή — Μιλήστε αντί να πληκτρολογείτε
• Ανέβασμα αρχείων — Μοιραστείτε αρχεία με το AI

AI Project Manager

Από τη σελίδα Projects, πατήστε "Plan with AI" για να ξεκινήσετε μια καθοδηγούμενη session σχεδιασμού project. Ο assistant γράφει την προδιαγραφή μαζί σας (ή εισάγει ένα πακέτο του Spec Builder), δείχνει μια προεπισκόπηση με τις ρυθμίσεις, τα στοιχεία της ημέρας 0 και τις ρυθμίσεις εκτέλεσης, και μετά την επιβεβαίωσή σας δημιουργεί το project, το περιβάλλον του και ακριβώς ένα ticket: το planning ticket ([PLAN] …). Το planning ticket σχεδιάζει πάνω στην πραγματική εγκατάσταση — baseline, δοκιμαστική εκτέλεση, γύροι ελέγχου, και πάντα συμφωνία με ένα ticket [PEER] (άλλη οικογένεια providers όταν υπάρχει ενεργή, αλλιώς ο ίδιος provider) — σας ρωτά μαζεμένα ό,τι προέκυψε από αυτό, και δημιουργεί την πρώτη φάση tickets (με tickets [VERIFY] σε διαφορετικό provider μετά από ριψοκίνδυνη εργασία· ένα πραγματικό project τρέχει σε φάσεις που η καθεμία τελειώνει με ένα ticket [REPLAN]). Μια μικρή αλλαγή σε υπάρχον project είναι ένα συνηθισμένο build ticket, όχι πλάνο.

27. Ειδοποιήσεις Telegram

Ρύθμιση

1. Δημιουργήστε ένα Telegram Bot μέσω του @BotFather — στείλτε /newbot, αντιγράψτε το token
2. Ξεκινήστε μια συνομιλία με το bot σας και στείλτε ένα μήνυμα
3. Πάρτε το Chat ID σας από το https://api.telegram.org/bot<TOKEN>/getUpdates
4. Ρυθμίστε στο Settings — επικολλήστε το Bot Token και το Chat ID, επιλέξτε τύπους ειδοποιήσεων, Test & Save

Τύποι ειδοποιήσεων

Αποστολή: Everything ticked above (όπως πριν) ή Only when I'm needed — μόνο ερωτήσεις προς εσάς, σταματημένες αλυσίδες, όρια χρήσης, αποτυχίες και κολλημένα tickets.

Chain Watch

Μία φορά την ώρα το CodeHero κοιτάζει κάθε project όπου μένει εργασία αλλά δεν τρέχει τίποτα — μόνο τα tickets που θα έπρεπε να τρέχουν τώρα (ποτέ ticket εκτός σειράς) — και βρίσκει γιατί σταμάτησε η αλυσίδα: ένα ticket που περιμένει άλλο που ήδη τελείωσε ή απάντησε, μια απάντηση που δεν αξιοποιήθηκε, ένας peer που έμεινε ανοιχτός, ένα strict ticket που δεν έκλεισε κανείς, μια ερώτηση προς εσάς, μια αποτυχία με παροδική αιτία. Settings → Chain watch: Off, Tell me what it finds (προεπιλογή) ή Restart it when safe (ξυπνά με μια σημείωση ή ξαναδοκιμάζει μια παροδική αποτυχία, το πολύ δύο φορές την ημέρα ανά ticket). Δεν αγγίζει ποτέ ticket που σταματήσατε προσωρινά ή οριστικά ή που σας κάνει ερώτηση, και ποτέ δεν κλείνει, διαγράφει ή αλλάζει τίποτα. Το μικρό του μοντέλο (junior + basic) τρέχει στον provider του ίδιου του ticket, και μετά στον επόμενο ενεργό provider του quick_call_failover στο heroagent.conf.

Αμφίδρομη επικοινωνία

Απαντήστε απευθείας στις ειδοποιήσεις από το κινητό σας. Ξεκινήστε με ? για ερωτήσεις κατάστασης χωρίς να ξανανοίξει το ticket.

28. Settings & ρυθμίσεις

Settings

Όλες οι ρυθμίσεις είναι διαθέσιμες από το κουμπί Settings στην κεφαλίδα. Το παράθυρο έχει 7 καρτέλες:

Settings (γενικά)

• Κωδικός Dashboard — Αλλαγή του κωδικού του admin
• Λήξη session — Αυτόματη αποσύνδεση μετά από αδράνεια
• Θέμα — Σκοτεινό (προεπιλογή)
• Κλειδιά API των providers — Ρυθμίστε κλειδιά για Anthropic, OpenAI, Grok, GLM, QwenCloud, OpenRouter — ή συνδεθείτε σε μια συνδρομή (Claude Code, Codex, Grok Build)
• Telegram — Bot token, Chat ID, προτιμήσεις ειδοποιήσεων

License

Δείτε την κατάσταση της άδειας, την ημερομηνία ενεργοποίησης και τη λήξη. Εισαγάγετε ή ενημερώστε το κλειδί άδειάς σας.

Certificates

• Self-signed — Δημιουργείται αυτόματα κατά την εγκατάσταση (προεπιλογή)
• Let's Encrypt — Ζητήστε δωρεάν πιστοποιητικά SSL για το domain σας
• Custom — Ανεβάστε το δικό σας πιστοποιητικό και ιδιωτικό κλειδί

Domains

Ρυθμίστε δικά σας domains για το dashboard και τις προεπισκοπήσεις των web projects. Το σύστημα ρυθμίζει αυτόματα τα virtual hosts του Nginx.

heroagent.conf

Επεξεργαστείτε απευθείας το κύριο αρχείο ρυθμίσεων του agent. Ελέγχει τα model aliases, τα όρια tokens, τις ρυθμίσεις των providers και τη συμπεριφορά του daemon. Πριν από κάθε αποθήκευση δημιουργείται αυτόματα backup.

system.conf

Επεξεργαστείτε τις ρυθμίσεις επιπέδου συστήματος: ρυθμίσεις Nginx, ρυθμίσεις PHP-FPM και άλλες παραμέτρους του server.

Security

• Change Password — Ενημέρωση του κωδικού admin του dashboard
• Two-Factor Authentication — Ενεργοποίηση/απενεργοποίηση 2FA με TOTP (Google Authenticator, Authy). Περιλαμβάνει ρύθμιση με QR code και εφεδρικούς κωδικούς.

29. Ενημερώσεις συστήματος

Ενημέρωση από το Dashboard

1. Κατεβάστε το ZIP της έκδοσης (codehero-pro-release-X.Y.Z-x86_64.zip, ή -arm64.zip)
2. Dashboard → Settings → 📦 Manual Update: αφήστε εκεί το ZIP (ή πατήστε για να το επιλέξετε)
3. Πατήστε "Install Update"
4. Παρακολουθήστε την έξοδο της κονσόλας σε πραγματικό χρόνο
5. Η σελίδα ανανεώνεται αυτόματα μετά την επιτυχία

Το CodeHero PRO δεν κατεβάζει ενημερώσεις μόνο του — η παλιά λήψη από το GitHub αφαιρέθηκε στην v4.55.1.

Ενημέρωση από τη γραμμή εντολών

cd /root
# Extract the ZIP file provided with your CodeHero PRO license
sudo apt-get update && sudo apt-get install -y unzip    # a fresh Ubuntu has no package lists yet
unzip codehero-pro-release-4.60.3.zip
cd codehero
sudo ./upgrade.sh

Backup και επιστροφή (v4.54.1+)

Πριν αλλάξει οτιδήποτε, η αναβάθμιση αποθηκεύει έναν φάκελο /var/backups/codehero/upgrade-<old version>-<time>/, που διαβάζεται μόνο από τον root: το πρόγραμμα (opt-codehero.tar.gz), τις ρυθμίσεις του /etc/codehero (etc-codehero.tar.gz) και τη βάση της πλατφόρμας (database.sql.gz), με τις εντολές επιστροφής στο ROLLBACK.txt. Κρατιούνται οι 5 νεότεροι. Η αναβάθμιση κρατά επίσης τα logs μέσα σε όρια: τα logs της πλατφόρμας (/var/log/codehero/*.log) περιστρέφονται καθημερινά και κρατιούνται 7 ημέρες, το system journal κρατά το πολύ 500 MB, και το logrotate εγκαθίσταται όταν ο server δεν το έχει.

30. Config File Editor

Επεξεργαστείτε αρχεία ρυθμίσεων του συστήματος απευθείας από το web περιβάλλον:

• heroagent.conf — Κύριες ρυθμίσεις του agent (providers, μοντέλα, tokens)
• Nginx config — Ρυθμίσεις του web server
• PHP config — Ρυθμίσεις PHP-FPM

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

31. Απομόνωση σε container (LXC)

Τρέξτε κάθε project στο δικό του LXC container με πλήρες σύνολο υπηρεσιών. Από την v4.6.3, τα containers περιλαμβάνουν έναν Service Manager για την εγκατάσταση web εφαρμογών, βάσεων δεδομένων και caches από ενσωματωμένο κατάλογο.

Panel του container με κατάσταση, χειριστήρια και snapshots

Δημιουργία container

1. Πηγαίνετε στη σελίδα Project Detail
2. Κυλήστε στην ενότητα Container Isolation (LXC)
3. Επιλέξτε Base Image (συνιστάται Ubuntu 24.04), Disk Size (5-100 GB· βάσεις δεδομένων, σουίτες tests και snapshots γεμίζουν γρήγορα τα 10 GB)
4. Προαιρετικά ενεργοποιήστε τα Auto-Snapshot και DB Migration
5. Πατήστε "Create Container"

Διαχείριση container

Snapshots

Τα snapshots BTRFS προσφέρουν άμεσο backup και επαναφορά, σε τρεις καρτέλες:

• Το 📌 Keep μεταφέρει ένα αυτόματο snapshot στα Kept· το Unpin το επιστρέφει.
• Το Restore γυρίζει το container πίσω, μαζί με τις υπηρεσίες και τις βάσεις· πρώτα λαμβάνεται ένα Safety snapshot της τρέχουσας κατάστασης.
• Το Delete όσο τρέχει ticket του project ρωτά: διαγραφή τώρα (μπορεί να καθυστερήσει το ticket) ή όταν δεν τρέχει κανένα ticket.
• Το hold ≈ (δίπλα στο πλήθος, v4.55.0+) = ό,τι θα ελευθέρωνε η διαγραφή όλων τους — περισσότερο από το άθροισμα των μεγεθών ανά γραμμή: δεδομένα που μοιράζονται πολλά snapshots δεν ανήκουν σε κανένα μόνο του.
• Μετά την αναβάθμιση στην 4.51.0, ένα project με περισσότερα από 20 αυτόματα snapshots δείχνει ένα banner: καρφιτσώστε όσα θέλετε να κρατήσετε· το Apply now διαγράφει τα υπόλοιπα αμέσως· αλλιώς το όριο εφαρμόζεται μόνο του 7 ημέρες μετά την αναβάθμιση.

Βάσεις δεδομένων σε ένα snapshot. Λίγο πριν από ένα snapshot κάθε βάση που τρέχει κάνει flush — με το pre_snapshot.sh της υπηρεσίας της (στο /opt/services/<service>/, δίπλα στο backup.sh· το post_snapshot.sh τρέχει αμέσως μετά), ή με την ίδια ενσωματωμένη εντολή για υπηρεσία που δεν το έχει: MySQL/MariaDB FLUSH TABLES, PostgreSQL CHECKPOINT, MongoDB fsync, Redis SAVE, SQL Server CHECKPOINT. Τίποτα δεν κλειδώνεται και τίποτα δεν μπορεί να καθυστερήσει το snapshot: μια σταματημένη βάση ή container παραλείπεται, κάθε βήμα έχει χρονικό όριο, μια αποτυχία απλώς καταγράφεται. Ένα snapshot είναι συνεπές και χωρίς αυτά — λαμβάνεται σε μια στιγμή, σαν διακοπή ρεύματος, μετά την οποία κάθε βάση ανακάμπτει μόνη της· το flush απλώς κάνει αυτή την ανάκαμψη γρήγορη.

Χώρος στον δίσκο. Ένα snapshot κρατά τις παλιές εκδόσεις των αρχείων που άλλαξαν από τη στιγμή που λήφθηκε — το όριο κρατά αυτό τον χώρο περιορισμένο. Από την v4.50.8 η MySQL σε νέο container τρέχει χωρίς binary logs: ένα container ανάπτυξης δεν κάνει replication, και η MySQL 8 τα κρατούσε 30 ημέρες — gigabytes σε ένα project του οποίου τα tests ξαναγράφουν τη βάση, που τα κρατούσε ξανά κάθε snapshot. Η αναβάθμιση δεν αλλάζει ποτέ ένα υπάρχον container· για να τα απενεργοποιήσετε σε ένα, τρέξτε στο Terminal του:

printf '[mysqld]\nskip-log-bin\n' > /etc/mysql/mysql.conf.d/zz-codehero-dev.cnf
systemctl restart mysql
rm -f /var/lib/mysql/binlog.[0-9]* /var/lib/mysql/binlog.index

Όρια logs. Από την v4.54.3 ένα νέο container κρατά τα logs του σε όρια: το logrotate τρέχει κάθε μέρα (ώστε να ισχύουν οι κανόνες που φέρνουν το nginx, η PHP και η MySQL), τα logs της ίδιας της εφαρμογής — logs/, storage/logs/ και var/log/ στον φάκελο του project, και του pm2 — περιστρέφονται καθημερινά και κρατιούνται τα 7 τελευταία, και το system journal κρατά το πολύ 200 MB. Η αναβάθμιση δεν αλλάζει ποτέ ένα υπάρχον container· για να προσθέσετε όρια logs σε ένα, τρέξτε στο Terminal του (οι διαδρομές καλύπτουν τους προεπιλεγμένους φακέλους project):

apt-get install -y logrotate
systemctl enable --now logrotate.timer
mkdir -p /etc/systemd/journald.conf.d
printf '[Journal]\nSystemMaxUse=200M\n' > /etc/systemd/journald.conf.d/codehero.conf
systemctl restart systemd-journald
cat > /etc/logrotate.d/codehero-app <<'EOF'
/var/www/projects/*/logs/*.log /var/www/projects/*/storage/logs/*.log /var/www/projects/*/var/log/*.log /opt/apps/*/logs/*.log /opt/apps/*/storage/logs/*.log /opt/apps/*/var/log/*.log /home/claude/.pm2/logs/*.log {
    daily
    rotate 7
    missingok
    notifempty
    compress
    delaycompress
    copytruncate
    su root root
}
EOF
chmod 644 /etc/logrotate.d/codehero-app

Κάθε εγκατεστημένο πακέτο φέρνει τον δικό του κανόνα — έναν ανά έκδοση PHP (php7.4-fpm, php8.4-fpm …), MySQL/MariaDB, PostgreSQL, Redis, nginx. Η MongoDB δεν φέρνει κανέναν· μια νέα εγκατάσταση MongoDB παίρνει έναν, και σε παλαιότερο container με MongoDB προσθέστε τον με:

grep -rqs /var/log/mongodb /etc/logrotate.d/ || { printf '%s\n' '/var/log/mongodb/*.log {' '    daily' '    rotate 7' '    missingok' '    notifempty' '    compress' '    delaycompress' '    copytruncate' '    su mongodb mongodb' '}' > /etc/logrotate.d/mongodb-codehero && chmod 644 /etc/logrotate.d/mongodb-codehero; }

Υπηρεσίες container

Ο Service Manager (v4.6.3+) σας επιτρέπει να εγκαθιστάτε, να ελέγχετε και να διαχειρίζεστε υπηρεσίες μέσα στο container χωρίς να αγγίξετε τη γραμμή εντολών.

Κάθε ticket ενός project σε container λαμβάνει τις υπηρεσίες με τις θύρες, τα στοιχεία σύνδεσης και τα scripts τους — και, από την 4.60.2, κάθε runtime γλώσσας που είναι εγκατεστημένο στο container, κάθε έκδοση με την ακριβή εντολή για να την καλέσει (node22 · npm22 · npx22 και τον φάκελό του, python3.12, php8.3 με το FPM socket του, go1.22, ruby3.3, το JAVA_HOME της Java, dotnet). Μπορούν να εγκατασταθούν πολλές εκδόσεις δίπλα-δίπλα, και ένα σκέτο node μπορεί να μην υπάρχει: η λίστα λέει ποια σκέτα ονόματα λειτουργούν και πώς να βάλετε τον φάκελο μιας έκδοσης στο PATH για μια εντολή ή για τον test runner.

Πίνακας υπηρεσιών με ενδείξεις λειτουργίας και κουμπιά ενεργειών

Εγκατάσταση web εφαρμογών

1. Πατήστε "+ Add Service" → Web App
2. Επιλέξτε Language, Version, Server/Framework και Path
3. Πατήστε Install

Εγκατάσταση web εφαρμογής από τον κατάλογο με ένα κλικ

Υποστηριζόμενες γλώσσες & frameworks

Εγκατάσταση βάσεων δεδομένων & caches

1. Πατήστε "+ Add Service" → Database
2. Επιλέξτε τύπο βάσης και Version
3. Πατήστε Install

Εγκατάσταση βάσης δεδομένων με αυτόματα ρυθμισμένη θύρα

Υποστηριζόμενες βάσεις δεδομένων

Διαχείριση βάσης (v4.52.0+): το εικονίδιο 🗄️ μιας υπηρεσίας βάσης την ανοίγει σε ένα εργαλείο στον server, ποτέ μέσα στο container — phpMyAdmin στο https://<server>:9454/ για MySQL / MariaDB, Adminer στο https://<server>:9454/dbmanager/ για PostgreSQL, MSSQL και MongoDB. Δύο υπηρεσίες MySQL σε διαφορετικές θύρες ανοίγουν η καθεμία τη δική της. Και τα δύο ανοίγουν μόνο από το panel, με ένα token μίας χρήσης (60 δευτερόλεπτα, χρησιμοποιείται μία φορά) — ποτέ χρήστης ή κωδικός στο URL· αν ανοιχτούν με άλλον τρόπο, δεν δείχνουν φόρμα σύνδεσης.

Caches

Έλεγχος υπηρεσιών

Κάθε υπηρεσία έχει κουμπιά ενεργειών: Start, Stop, Restart, Delete. Μαζικές ενέργειες στην κορυφή: Stop All, Start All, Refresh Status, Full Backup.

Backup & επαναφορά βάσεων

Οι υπηρεσίες βάσεων υποστηρίζουν Backup (στη δική τους μορφή με χρονοσήμανση· από την v4.55.0 ένα backup MySQL / MariaDB κρατά και τις stored procedures, functions και events — και για υπηρεσία που προστέθηκε πριν από την 4.55.0) και Restore (από αρχείο backup). Το Full Backup είναι το Complete backup του project — αρχεία, κάθε βάση, υπηρεσίες, tickets, το ίδιο με το Backups → Complete· εμφανίζεται στο Backup History και επαναφέρεται από εκεί (πριν από την v4.55.0 έτρεχε ένα παλαιότερο backup που έχανε τις περισσότερες βάσεις και τα δυαδικά αρχεία). Τα backups μπορούν να κατέβουν από το web περιβάλλον. Από την v4.55.1 αυτά τα dumps κρατιούνται μαζί με τα backups του project, στο /var/backups/codehero/<CODE>/services/<service>-<version>/ (πριν: μέσα στον φάκελο του προγράμματος, /opt/codehero/backups/<id>/ — η αναβάθμιση τα μεταφέρει, η παλιά θέση διαβάζεται ακόμη)· μετά από διαγραφή project εμφανίζονται στα Deleted projects. Εκεί πηγαίνει και το dump που λαμβάνεται πριν από το Delete Host DB.

Διαχείριση κωδικών

Τα στοιχεία σύνδεσης των βάσεων δημιουργούνται αυτόματα κατά την εγκατάσταση. Αλλάξτε κωδικούς οποιαδήποτε στιγμή — τα scripts σύνδεσης και τα scripts backup ενημερώνονται αυτόματα.

Terminal του container

Πλήρης πρόσβαση σε shell μέσα στο container με τρεις τρόπους: Inline (ενσωματωμένο), Popup (νέο παράθυρο), Full Page (πλήρης οθόνη). Χρησιμοποιεί xterm.js με υποστήριξη αντιγραφής/επικόλλησης.

Web terminal με πλήρη πρόσβαση σε shell μέσα στο container

Δικές σας υπηρεσίες που φτιάχνουν τα tickets (4.61.0)

Ένα ticket μπορεί να δημιουργήσει μια υπηρεσία που δεν έχει ο κατάλογος — μια μηχανή αναζήτησης, μια ουρά, έναν worker της εφαρμογής σας — μέσα στο container του project. Η πλατφόρμα τη χειρίζεται στη συνέχεια όπως κάθε άλλη υπηρεσία: της κάνει backup, την επαναφέρει, τη μεταφέρει μαζί με το project και τη δείχνει στη λίστα Services με ένα μωβ σήμα custom.

• Πρώτα επαναχρησιμοποίηση. Πρώτα ό,τι υπάρχει ήδη, μετά ο κατάλογος· μια δική σας υπηρεσία μόνο για πραγματικό κενό — ποτέ η ίδια ή παρόμοια μηχανή.
• Το nginx είναι μέρος κάθε container (δεν εμφανίζεται ποτέ ως υπηρεσία): μια δική σας web εφαρμογή ακούει σε μια τοπική θύρα και δηλώνει τη διαδρομή της· το nginx του container τη δρομολογεί. Μια υπηρεσία που είναι η ίδια web server απορρίπτεται.
• Εγκρίνετε κάθε νέα υπηρεσία στο panel Approve / Reject του ticket: την υπηρεσία, τον τύπο, τη μηχανή, τον ρόλο, την έκδοση, τις θύρες, τη διαδρομή, τα δεδομένα της και κάθε παρόμοια υπηρεσία που έχετε ήδη. Το [PLAN] ζητά όλες τις προγραμματισμένες υπηρεσίες μαζί· ένα Approve καλύπτει κάθε ticket του project. Και μια εγκατάσταση από τον κατάλογο από ticket ζητά έγκριση. Το κλικ απαντά ακριβώς στο αίτημα που βλέπετε στην οθόνη σας.
• Έτοιμη πριν από το build: το πλάνο γράφει έναν πίνακα ENVIRONMENT και το SETUP ticket του αποδεικνύει ότι κάθε υπηρεσία λειτουργεί (μια πραγματική λειτουργία και ένα δοκιμαστικό backup) πριν ξεκινήσει οποιοδήποτε build ticket.

Τι είναι: το ticket γράφει τα αρχεία του στο project (.services/<name>/, που κρατιέται μαζί με τον κώδικά σας) και η πλατφόρμα τα αντιγράφει στο /opt/services/<name>/ του container: service.json, install.sh (τρέχει ξανά χωρίς ερωτήσεις — δύο φορές κατά την καταχώριση, και ξανά μόνο του σε επαναφορά σε νέο container) και τα δικά του scripts start / stop / status / backup / restore. Η πλατφόρμα γράφει το platform.env με τους φακέλους του project, ώστε ένα project που επαναφέρεται με νέο όνομα να μην τρέχει ποτέ πάνω στις διαδρομές του παλιού.

Backups και επαναφορές: κάθε επίπεδο backup — και το Quick — περιέχει κάθε δική σας υπηρεσία (φάκελο, αρχεία ρυθμίσεων, τα δεδομένα της). Η επαναφορά στο ίδιο project τη σταματά, επαναφέρει ρυθμίσεις και δεδομένα και την ξεκινά ξανά αν έτρεχε· η επαναφορά ως νέο project ή η εισαγωγή image container την εγκαθιστά και την καταχωρίζει ξανά για το νέο project. Μια αποτυχημένη επαναφορά δεν ξεκινά ποτέ, ούτε στην επόμενη εκκίνηση του container. Τα snapshots τρέχουν τα δικά της scripts snapshot, και ένα rollback αναφέρει τις υπηρεσίες που δεν ταιριάζουν πια.

Το ίδιο το container (4.61.1): ένα ticket μόνο διαβάζει την κατάστασή του — και το δημιουργεί όταν το project δεν έχει ακόμη (μόνο το container· κάθε υπηρεσία μετά από αυτό με την έγκρισή σας). Το σταμάτημα, η καταστροφή ή η μεταφορά του container και η επαναφορά ή διαγραφή ενός snapshot είναι δικές σας ενέργειες: από το panel, ή από τον assistant μόνο μετά το ρητό σας ναι για εκείνη την ενέργεια.

Μεταφορά σε server που τρέχει ακόμη έκδοση πριν από την 4.61: όλα τα άλλα επιστρέφουν· εκείνη η έκδοση αναφέρει τις δικές σας υπηρεσίες ως «Install … failed» και τις αφήνει έξω. Επαναφέρετε το backup σε server 4.61, ή αναβαθμίστε πρώτα εκείνον τον server.

Στη λίστα Services: το Delete μόνο αφαιρεί την καταχώριση μιας δικής σας υπηρεσίας — ο φάκελος και τα δεδομένα της μένουν· οι θύρες, η διαδρομή και τα scripts της αλλάζουν μέσω του φακέλου της (με την έγκρισή σας όταν αλλάζει κάτι που εγκρίνατε). Ένα backup της 4.61.0 που επαναφέρεται σε παλαιότερη έκδοση επαναφέρει τα πάντα εκτός από τις δικές σας υπηρεσίες.

Πότε να χρησιμοποιείτε containers

32. Ανάπτυξη σε παραγωγή

Βάλτε το CodeHero πίσω από μια διάταξη έτοιμη για παραγωγή, με δικά σας domains και SSL.

Nginx reverse proxy

Ρυθμίστε το Nginx στον server σας ώστε να προωθεί στο CodeHero:

server {
    listen 80;
    server_name codehero.yourdomain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name codehero.yourdomain.com;

    ssl_certificate /etc/letsencrypt/live/codehero.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/codehero.yourdomain.com/privkey.pem;

    location / {
        proxy_pass https://127.0.0.1:9453;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # WebSocket support (for console, terminal)
    location /socket.io/ {
        proxy_pass https://127.0.0.1:9453/socket.io/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

Ρύθμιση domain

1. Στρέψτε την εγγραφή DNS A του domain σας στην IP του server σας
2. Ρυθμίστε το domain στην καρτέλα Settings → Domains
3. Το σύστημα θα ρυθμίσει αυτόματα το Nginx

Πιστοποιητικά SSL

Let's Encrypt (συνιστάται):

1. Πηγαίνετε στο Settings → Certificates
2. Εισαγάγετε το όνομα του domain σας
3. Πατήστε "Request Certificate"
4. Τα πιστοποιητικά ανανεώνονται αυτόματα κάθε 90 ημέρες

Δικό σας πιστοποιητικό:

1. Πηγαίνετε στο Settings → Certificates
2. Επιλέξτε "Upload Custom"
3. Δώστε το πιστοποιητικό σας (.pem) και το ιδιωτικό κλειδί

Κανόνες firewall

sudo ufw allow 80/tcp    # HTTP (redirect to HTTPS)
sudo ufw allow 443/tcp   # HTTPS
sudo ufw allow 9453/tcp  # CodeHero Dashboard
sudo ufw allow 9867/tcp  # Web Project Previews

33. Οδηγός σχεδιασμού με AI (σχεδιασμός με εξωτερικό AI)

Το CodeHero συνοδεύεται από το CodeHero Spec Builder — ένα φορητό αρχείο γνώσης που προσθέτετε σε ένα Claude Project ή σε ένα project του ChatGPT. Ο assistant σάς παίρνει τότε συνέντευξη για την επιχείρησή σας σε απλή γλώσσα (μία ερώτηση κάθε φορά, χωρίς τεχνική ορολογία), αποφασίζει ο ίδιος κάθε τεχνικό ζήτημα, ελέγχει τη δουλειά του σε 50 διαδοχικά περάσματα, και παράγει ένα πλήρες πακέτο προδιαγραφής: αρχιτεκτονική, απαιτήσεις, κριτήρια αποδοχής και ένα πλάνο tickets με ρόλους και think modes — σκόπιμα χωρίς providers ή ονόματα μοντέλων, γιατί αυτά εξαρτώνται από την εγκατάστασή σας.

1. Πατήστε Copy planning guide παρακάτω (ή κατεβάστε το αρχείο).
2. Προσθέστε το ως γνώση σε ένα project του Claude/ChatGPT με την οδηγία: “You are the CodeHero Spec Builder. Follow the file exactly.”
3. Απαντήστε στις ερωτήσεις του· παραδίδει το πακέτο προδιαγραφής ως ένα αρχείο Markdown.
4. Επικολλήστε αυτό το πακέτο στον AI Assistant της εφαρμογής (Plan with AI) — δείχνει μια προεπισκόπηση, δημιουργεί το container αν η προδιαγραφή δηλώνει ένα, και μετά την επιβεβαίωσή σας δημιουργεί το project και ένα planning ticket που μεταφέρει το πακέτο· το planning ticket αναθέτει providers από τη λίστα των ενεργών σας και δημιουργεί την πρώτη φάση tickets.

📋 Copy planning guide Άνοιγμα / λήψη του οδηγού →

Ο οδηγός είναι αυτοτελής — δεν χρειάζεται κώδικας ή ανέβασμα αρχείων· οι agents του CodeHero φτιάχνουν τα πάντα από τις περιγραφές των tickets.

34. Συμβουλές & καλές πρακτικές

Πώς γράφετε καλά tickets

Κάντε:

• Να είστε συγκεκριμένοι για αυτό που θέλετε
• Να αναφέρετε διαδρομές αρχείων όταν χρειάζεται
• Να αναφέρετε τη γλώσσα προγραμματισμού/το framework
• Να σπάτε τις μεγάλες εργασίες σε sub-tickets

Μην κάνετε:

• Αόριστες οδηγίες όπως «κάν' το καλύτερο»
• Πολλές άσχετες εργασίες σε ένα ticket
• Να υποθέτετε ότι το AI ξέρει το context από άλλα tickets

Καλό παράδειγμα:

Title: Add user authentication API
Description:
Create REST API endpoints in /api/auth/:
- POST /api/auth/login - Accept email/password, return JWT
- POST /api/auth/register - Create new user
- GET /api/auth/me - Return current user (requires auth)
Use the existing User model in models/user.py.
Use bcrypt for password hashing.

Κακό παράδειγμα:

Title: Auth
Description: Add login

Παράλληλη εκτέλεση

• Τα πλάνα είναι σειριακά από προεπιλογή· πείτε «παράλληλα» όταν το θέλετε — τότε το planning ticket αποδεικνύει ότι τα παράλληλα tickets δεν γράφουν ποτέ το ίδιο αρχείο
• Τα παράλληλα tickets μοιράζονται ένα sequence_order· μοιράστε τα σε διαφορετικούς providers για να αποφύγετε τα rate limits
• Το lead mode τρέχει 2–5 στενά συνδεδεμένα μέρη ως tickets [WORKER], που το καθένα γράφει μόνο τα δικά του αρχεία και το δικό του log
• Το πολύ MAX_PARALLEL_TICKETS_PER_PROJECT tickets τρέχουν ταυτόχρονα ανά project (προεπιλογή 5)

Βελτιστοποίηση κόστους

• Αφήστε το planning ticket να κρίνει το μέγεθος της εργασίας: junior για τετριμμένα, απλά και μέτρια tickets, senior για τα δύσκολα, για το πλάνο, τον peer του, τους verifiers και τους helpers — master μόνο όταν το επιλέξετε (Ενότητα 14)
• Κρατήστε τα tickets μικρά και εστιασμένα: τα περισσότερα tokens είναι το context που διαβάζεται ξανά σε κάθε βήμα — ένα μεγάλο ticket κοστίζει πολύ περισσότερο από ένα υψηλότερο think mode
• Μια συνδρομή (Claude Pro/Max, ChatGPT μέσω Codex CLI, SuperGrok μέσω Grok Build, GLM Coding, QwenCloud Token Plan) μετρά στο ένα δέκατο του βάρους κόστους του API της
• Οι προεπιλογές Qwen του OpenRouter και το Qwen 3.8 Flash του QwenCloud είναι επιλογές χαμηλού κόστους που βλέπουν και εικόνες

35. Αντιμετώπιση προβλημάτων

Ticket κολλημένο σε "in_progress"

Μια εκτέλεση θεωρείται κολλημένη μετά από 60 λεπτά χωρίς ούτε μία γραμμή από τον agent (το STUCK_TIMEOUT_MINUTES στο /etc/codehero/system.conf το αλλάζει). Ένα μακρύ εργαλείο δεν είναι σιωπή: όσο τρέχει ένα εργαλείο — μια σουίτα tests σε μία αναμονή του ProcessManager, μια μακριά εντολή — κάθε οικογένεια providers στέλνει σήμα ζωής κάθε 2 λεπτά (Codex, το Claude CLI και στους δύο τρόπους, οι API providers), για έως 2 ώρες. Ένα μοντέλο που μένει σιωπηλό χωρίς να τρέχει τίποτα εντοπίζεται κανονικά.

1. Ελέγξτε το Console για σφάλματα
2. Χρησιμοποιήστε το Kill Switch (κουμπί Stop ή /stop)
3. Ξαναδοκιμάστε το ticket

Το AI δεν επεξεργάζεται tickets

1. Ελέγξτε τον daemon: systemctl status codehero-daemon
2. Δείτε τα logs: journalctl -u codehero-daemon -f
3. Ελέγξτε τη MySQL: systemctl status mysql
4. Επανεκκίνηση: sudo systemctl restart codehero-web codehero-daemon

Σφάλματα δικαιωμάτων

• Βεβαιωθείτε ότι ο χρήστης claude έχει δικαιώματα ανάγνωσης/εγγραφής
• Ελέγξτε την ιδιοκτησία: ls -la /path/to/project
• Διόρθωση: chown -R claude:claude /path/to/project

Δεν έχετε πρόσβαση στο Dashboard

1. Ελέγξτε τις υπηρεσίες: systemctl status codehero-web nginx
2. Ελέγξτε το firewall: sudo ufw allow 9453
3. Επιβεβαιώστε την IP: hostname -I
4. Ο browser μπορεί να μπλοκάρει το self-signed πιστοποιητικό

Σφάλματα API των providers

• Ελέγξτε το κλειδί API στο Settings
• Δείτε τη σελίδα κατάστασης του provider
• Δοκιμάστε προσωρινά διαφορετικό provider
• Μειώστε τα παράλληλα tickets αν φτάνετε τα rate limits

36. Συντομεύσεις πληκτρολογίου

Code Editor

Web Terminal

Γενικά

37. Εκπαίδευση developers — Το Autonomous Development Framework (ADF)

Το CodeHero υλοποιεί ένα Autonomous Development Framework: οι AI agents φτιάχνουν, ελέγχουν και τεκμηριώνουν ένα προϊόν από μια προδιαγραφή, ενώ οι άνθρωποι δίνουν μόνο ό,τι δεν μπορεί να δώσει κανείς άλλος — την αλήθεια της επιχείρησης, τα στοιχεία πρόσβασης και τις εγκρίσεις. Το εκπαιδευτικό πρόγραμμα για developers διδάσκει αυτό το framework βήμα προς βήμα, με τη σειρά που γίνεται η εργασία σε μια πραγματική παράδοση: συνέντευξη με τον πελάτη, απόφαση για το stack, σχεδιασμός των tickets, εκτέλεση και ανάγνωση της εκτέλεσης, προσαρμογή του global και των project contexts, παράδοση.

🎓 Ανοίξτε το εκπαιδευτικό πρόγραμμα Παρουσίαση για ειδικούς του αντικειμένου →