Το claude-handoff είναι ένα open-source εργαλείο γραμμής εντολών που μετατρέπει οποιαδήποτε συνεδρία του Claude Code σε ένα καθαρό handoff.md — ώστε η δουλειά να συνεχίζεται σε ChatGPT, Gemini ή άλλο Claude με ένα απλό paste. Γραμμένο σε καθαρή Python, χωρίς καμία εξάρτηση, σε ένα μόνο αρχείο.
Το πρόβλημα που λύνει
Όταν μια συνεδρία AI coding κρασάρει ή χτυπήσει usage limit, όλο το context — αποφάσεις, αδιέξοδα, μισοτελειωμένες διορθώσεις — κλειδώνεται σε ένα αρχείο που δεν ξανανοίγει. Τα υπάρχοντα εργαλεία δουλεύουν μόνο μέσα στη συνεδρία (πριν πεθάνει) ή βγάζουν θορυβώδη transcripts. Το claude-handoff δουλεύει εκ των υστέρων, πάνω στο ίδιο το αρχείο της συνεδρίας.
Δυνατότητες
- Deterministic export χωρίς κόστος: συνομιλία, αρχεία που άλλαξαν, εντολές που έτρεξαν — χωρίς θόρυβο
- Σύνοψη με LLM: μέσω της συνδρομής Claude (χωρίς API key), τοπικά με Ollama (πλήρως offline) ή με API keys
- Τεράστιες συνεδρίες 1M+ tokens: map-reduce σε chunks με cache — μια διακοπή σημαίνει δωρεάν συνέχιση
- Zero-trust: αυτόματο redaction σε API keys και μυστικά πριν φύγει οτιδήποτε από το μηχάνημα
- Εισαγωγή και από claude.ai και ChatGPT exports — handoff προς κάθε κατεύθυνση
- MCP server mode: κάθε AI agent μπορεί να ζητήσει το handoff άλλης συνεδρίας ως εργαλείο
Αποτελέσματα πρώτης ημέρας
Σε μία ημέρα ανάπτυξης: 11 εκδόσεις στο PyPI, 69 αυτόματα tests σε 6 πλατφόρμες (Linux, macOS, Windows × Python 3.9/3.13), δημοσίευση στο επίσημο MCP Registry και Homebrew formula. Σε πραγματική δοκιμή, συνεδρία 264MB (1,5 εκατ. χαρακτήρες, 323 μηνύματα) έγινε δισέλιδο handoff σε 10,5 λεπτά — και το δεύτερο τρέξιμο ήταν 2,5× γρηγορότερο χάρη στο content-addressed cache.
Τεχνολογίες
Python 3.9+ (stdlib μόνο, zero dependencies), GitHub Actions CI/CD με PyPI Trusted Publishing, Model Context Protocol (MCP), Homebrew packaging. MIT license.
💻 Κώδικας: github.com/Vasilispapg/claude-handoff
📦 Εγκατάσταση: pipx install claude-handoff ή brew install Vasilispapg/tap/claude-handoff
