# oh-my-kimi (OMK)

<p align="center">
  <img src="https://raw.githubusercontent.com/wang-h/oh-my-kimi/main/docs/shared/omk-character-spark-initiative.jpg" alt="oh-my-kimi character" width="280">
  <br>
  <em>Ξεκινήστε το Codex πιο δυναμικά και αφήστε το OMK να προσθέσει καλύτερα prompts, workflows και runtime υποστήριξη όταν η δουλειά μεγαλώνει.</em>
</p>

[![npm version](https://img.shields.io/npm/v/oh-my-kimi)](https://www.npmjs.com/package/oh-my-kimi)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
[![Discord](https://img.shields.io/discord/1452487457085063218?color=5865F2&logo=discord&logoColor=white&label=Discord)](https://discord.gg/PUwSMR9XNk)

**Ιστοσελίδα:** https://github.com/wang-h/oh-my-kimi  
**Τεκμηρίωση:** [Ξεκινώντας](./docs/getting-started.html) · [Agents](./docs/agents.html) · [Skills](./docs/skills.html) · [Ενσωματώσεις](./docs/integrations.html) · [Demo](./DEMO.md) · [Οδηγός OpenClaw](./docs/openclaw-integration.md)

Το OMK είναι ένα workflow layer για το [Kimi Code CLI](https://moonshotai.github.io/kimi-cli/en/).

Διατηρεί το Codex ως μηχανή εκτέλεσης και διευκολύνει τα εξής:
- να ξεκινάτε μια πιο δυναμική συνεδρία Codex από προεπιλογή
- να ακολουθείτε μία συνεπή ροή από διευκρίνιση μέχρι ολοκλήρωση
- να ενεργοποιείτε το βασικό μονοπάτι με `$deep-interview`, `$ralplan`, `$team` και `$ralph`
- να κρατάτε οδηγίες έργου, σχέδια, αρχεία καταγραφής και κατάσταση στον φάκελο `.omk/`

## Προτεινόμενη προεπιλεγμένη ροή

Αν θέλετε την προεπιλεγμένη εμπειρία OMK, ξεκινήστε εδώ:

```bash
npm install -g oh-my-kimi oh-my-kimi
omk setup
omk --madmax --high
```

Στη συνέχεια εργαστείτε κανονικά μέσα στο Codex:

```text
$deep-interview "clarify the authentication change"
$ralplan "approve the auth plan and review tradeoffs"
$ralph "carry the approved plan to completion"
$team 3:executor "execute the approved plan in parallel"
```

Αυτή είναι η βασική ροή.
Ξεκινήστε δυνατά, ξεκαθαρίστε πρώτα όταν χρειάζεται, εγκρίνετε το σχέδιο και μετά επιλέξτε `$team` για συντονισμένη παράλληλη εκτέλεση ή `$ralph` για επίμονο βρόχο ολοκλήρωσης.

## Σε τι χρησιμεύει το OMK

Χρησιμοποιήστε το OMK αν σας αρέσει ήδη το Codex και θέλετε ένα καλύτερο καθημερινό περιβάλλον εργασίας γύρω του:
- μια τυπική ροή βασισμένη στα `$deep-interview`, `$ralplan`, `$team` και `$ralph`
- εξειδικευμένους ρόλους και βοηθητικά skills όταν πραγματικά χρειάζονται
- καθοδήγηση έργου μέσω scoped `AGENTS.md`
- επίμονη κατάσταση στον `.omk/` για σχέδια, αρχεία καταγραφής, μνήμη και παρακολούθηση λειτουργίας

Αν θέλετε απλό Codex χωρίς επιπλέον επίπεδο ροής εργασίας, πιθανότατα δεν χρειάζεστε το OMK.

## Γρήγορη εκκίνηση

### Απαιτήσεις

- Node.js 20+
- Εγκατεστημένο Kimi Code CLI: `npm install -g oh-my-kimi`
- Ρυθμισμένη αυθεντικοποίηση Codex
- `tmux` σε macOS/Linux αν θέλετε αργότερα τον ανθεκτικό team runtime
- `psmux` σε native Windows αν θέλετε αργότερα τη λειτουργία team για Windows

### Μια καλή πρώτη συνεδρία

Εκκινήστε το OMK με τον προτεινόμενο τρόπο:

```bash
omk --madmax --high
```

Στη συνέχεια δοκιμάστε την τυπική ροή:

```text
$deep-interview "clarify the authentication change"
$ralplan "approve the safest implementation path"
$ralph "carry the approved plan to completion"
$team 3:executor "execute the approved plan in parallel"
```

Χρησιμοποιήστε `$team` όταν το εγκεκριμένο σχέδιο χρειάζεται συντονισμένη παράλληλη εργασία ή `$ralph` όταν ένας επίμονος υπεύθυνος πρέπει να το φέρει μέχρι τέλους.

## Ένα απλό νοητικό μοντέλο

Το OMK **δεν** αντικαθιστά το Codex.

Προσθέτει ένα καλύτερο workflow layer γύρω του:
- **Codex** κάνει την πραγματική δουλειά του agent
- **Keywords ρόλων OMK** κάνουν τους χρήσιμους ρόλους επαναχρησιμοποιήσιμους
- **Skills OMK** κάνουν τα συνηθισμένα workflows επαναχρησιμοποιήσιμα
- **`.omk/`** αποθηκεύει σχέδια, αρχεία καταγραφής, μνήμη και κατάσταση εκτέλεσης

Οι περισσότεροι χρήστες καλό είναι να βλέπουν το OMK ως **καλύτερη δρομολόγηση εργασιών + καλύτερο workflow + καλύτερο runtime**, όχι ως ένα σύνολο εντολών για χειροκίνητη χρήση όλη μέρα.

## Ξεκινήστε εδώ αν είστε νέοι

1. Εκτελέστε `omk setup`
2. Εκκινήστε με `omk --madmax --high`
3. Χρησιμοποιήστε `$deep-interview "..."` όταν το αίτημα ή τα όρια είναι ακόμη ασαφή
4. Χρησιμοποιήστε `$ralplan "..."` για να εγκρίνετε το σχέδιο και τους συμβιβασμούς
5. Επιλέξτε `$team` για συντονισμένη παράλληλη εκτέλεση ή `$ralph` για επίμονο βρόχο ολοκλήρωσης

## Συνήθη surfaces μέσα στη συνεδρία

| Λειτουργία | Χρήση |
| --- | --- |
| `$deep-interview "..."` | αποσαφήνιση πρόθεσης, ορίων και μη-στόχων |
| `$ralplan "..."` | έγκριση σχεδίου υλοποίησης και συμβιβασμών |
| `$ralph "..."` | επίμονος βρόχος ολοκλήρωσης και επαλήθευσης |
| `$team "..."` | συντονισμένη παράλληλη εκτέλεση όταν η εργασία είναι αρκετά μεγάλη |
| `/skills` | περιήγηση στα διαθέσιμα skills και βοηθητικά εργαλεία |

Χρησιμοποιήστε `$deep-interview` όταν το αίτημα είναι ακόμη ασαφές, τα όρια δεν είναι ξεκάθαρα ή θέλετε το OMK να πιέσει μέχρι να ξεκαθαρίσει πρόθεση, μη-στόχους και όρια αποφάσεων πριν περάσει στο `$ralplan` και έπειτα στο `$team` ή στο `$ralph`.

Τυπικές περιπτώσεις:
- ασαφείς greenfield ιδέες που χρειάζονται πιο καθαρή πρόθεση και εύρος
- brownfield αλλαγές όπου το OMK πρέπει πρώτα να εξετάσει το repo και μετά να κάνει στοχευμένες ερωτήσεις επιβεβαίωσης
- αιτήματα όπου θέλετε έναν βρόχο διευκρίνισης μία-ερώτηση-τη-φορά αντί για άμεσο σχεδιασμό ή υλοποίηση

## Προχωρημένες λειτουργίες / για διαχειριστές

Αυτά είναι χρήσιμα, αλλά δεν είναι ο βασικός τρόπος για να ξεκινήσετε.

### Team runtime

Χρησιμοποιήστε τον team runtime όταν χρειάζεστε ειδικά ανθεκτικό συντονισμό tmux/worktree, όχι ως τον προεπιλεγμένο τρόπο για να ξεκινήσετε με το OMK.

```bash
omk team 3:executor "fix the failing tests with verification"
omk team status <team-name>
omk team resume <team-name>
omk team shutdown <team-name>
```

### Setup, doctor και HUD

Αυτές είναι λειτουργίες διαχείρισης/υποστήριξης:
- `omk setup` εγκαθιστά prompts, skills, ρυθμίσεις και scaffolding AGENTS
- `omk doctor` επαληθεύει την εγκατάσταση όταν κάτι φαίνεται λάθος
- `omk hud --watch` είναι λειτουργία παρακολούθησης/κατάστασης, όχι η κύρια ροή εργασίας του χρήστη

### Explore και sparkshell

- `omk explore --prompt "..."` είναι για αναζήτηση μόνο ανάγνωσης στο repository
- `omk sparkshell <command>` είναι για επιθεώρηση απευθείας από το shell και στοχευμένη επαλήθευση

Παραδείγματα:

```bash
omk explore --prompt "find where team state is written"
omk sparkshell git status
omk sparkshell --tmux-pane %12 --tail-lines 400
```

### Σημειώσεις πλατφόρμας για τη λειτουργία team

Η `omk team` χρειάζεται ένα tmux-συμβατό backend:

| Πλατφόρμα | Εγκατάσταση |
| --- | --- |
| macOS | `brew install tmux` |
| Ubuntu/Debian | `sudo apt install tmux` |
| Fedora | `sudo dnf install tmux` |
| Arch | `sudo pacman -S tmux` |
| Windows | `winget install psmux` |
| Windows (WSL2) | `sudo apt install tmux` |

## Γνωστά ζητήματα

### Mac με Intel: υψηλή χρήση CPU `syspolicyd` / `trustd` κατά την εκκίνηση

Σε ορισμένα Mac με Intel, η εκκίνηση του OMK, ειδικά με `--madmax --high`, μπορεί να αυξήσει απότομα τη χρήση CPU των `syspolicyd` / `trustd` ενώ το macOS Gatekeeper επαληθεύει πολλές ταυτόχρονες εκκινήσεις διεργασιών.

Αν συμβεί αυτό, δοκιμάστε:
- `xattr -dr com.apple.quarantine $(which omk)`
- προσθέστε την εφαρμογή τερματικού σας στη λίστα επιτρεπόμενων Developer Tools στις ρυθμίσεις Ασφάλειας του macOS
- χρησιμοποιήστε χαμηλότερο επίπεδο ταυτόχρονων εκτελέσεων (για παράδειγμα, αποφύγετε `--madmax --high`)

## Τεκμηρίωση

- [Ξεκινώντας](./docs/getting-started.html)
- [Οδηγός Demo](./DEMO.md)
- [Κατάλογος Agents](./docs/agents.html)
- [Αναφορά Skills](./docs/skills.html)
- [Ενσωματώσεις](./docs/integrations.html)
- [Οδηγός OpenClaw / notification gateway](./docs/openclaw-integration.md)
- [Συνεισφορά](./CONTRIBUTING.md)
- [Αρχείο αλλαγών](./CHANGELOG.md)

## Γλώσσες

- [English](./README.md)
- [한국어](./README.ko.md)
- [日本語](./README.ja.md)
- [简体中文](./README.zh.md)
- [繁體中文](./README.zh-TW.md)
- [Tiếng Việt](./README.vi.md)
- [Español](./README.es.md)
- [Português](./README.pt.md)
- [Русский](./README.ru.md)
- [Türkçe](./README.tr.md)
- [Deutsch](./README.de.md)
- [Français](./README.fr.md)
- [Italiano](./README.it.md)
- [Ελληνικά](./README.el.md)

## Συνεισφέροντες

| Ρόλος | Όνομα | GitHub |
| --- | --- | --- |
| Δημιουργός & Επικεφαλής | Yeachan Heo | [@Yeachan-Heo](https://github.com/Yeachan-Heo) |
| Συντηρητής | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |

## Ιστορικό Αστεριών

[![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-kimi&type=date&legend=top-left)](https://www.star-history.com/#Yeachan-Heo/oh-my-kimi&type=date&legend=top-left)

## Άδεια

MIT