oh-my-kimi 0.11.12

package/Cargo.lock

@@ -0,0 +1,174 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "fs2"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9564fc758e15025b46aa6643b1b77d047d1a56a1aea6e01002ac0c7026876213"
+dependencies = [
+ "libc",
+ "winapi",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92ecc6618181def0457392ccd0ee51198e065e016d1d527a7ac1b6dc7c1f09d2"
+
+[[package]]
+name = "libc"
+version = "0.2.183"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b5b646652bf6661599e1da8901b3b9522896f01e736bad5f723fe7a3a27f899d"
+
+[[package]]
+name = "memchr"
+version = "2.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
+
+[[package]]
+name = "omx-explore-harness"
+version = "0.11.12"
+
+[[package]]
+name = "omx-mux"
+version = "0.11.12"
+dependencies = [
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "omx-runtime"
+version = "0.11.12"
+dependencies = [
+ "omx-mux",
+ "omx-runtime-core",
+ "serde_json",
+]
+
+[[package]]
+name = "omx-runtime-core"
+version = "0.11.12"
+dependencies = [
+ "fs2",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "omx-sparkshell"
+version = "0.11.12"
+dependencies = [
+ "omx-mux",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.149"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83fc039473c5595ace860d8c4fafa220ff474b3fc6bfdb4293327f1a37e94d86"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "winapi"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
+dependencies = [
+ "winapi-i686-pc-windows-gnu",
+ "winapi-x86_64-pc-windows-gnu",
+]
+
+[[package]]
+name = "winapi-i686-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
+
+[[package]]
+name = "winapi-x86_64-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
+
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"

package/Cargo.toml

@@ -0,0 +1,22 @@
+[workspace]
+members = [
+  "crates/omx-explore",
+  "crates/omx-mux",
+  "crates/omx-runtime-core",
+  "crates/omx-runtime",
+  "crates/omx-sparkshell",
+]
+resolver = "2"
+
+[workspace.package]
+
+version = "0.11.12"
+
+edition = "2021"
+license = "MIT"
+repository = "https://github.com/Yeachan-Heo/oh-my-codex"
+
+# The profile that 'dist' will build with
+[profile.dist]
+inherits = "release"
+lto = "thin"

package/README.de.md

@@ -0,0 +1,263 @@
+# oh-my-kimi (OMK)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/wang-h/oh-my-kimi/main/docs/shared/omx-character-spark-initiative.jpg" alt="oh-my-kimi character" width="280">
+  <br>
+  <em>Dein Codex ist nicht allein.</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)
+
+> **[Website](https://github.com/wang-h/oh-my-kimi)** | **[Documentation](https://github.com/wang-h/oh-my-kimi#readme)** | **[CLI Reference](https://github.com/wang-h/oh-my-kimi#command-reference)** | **[Workflows](https://github.com/wang-h/oh-my-kimi#recommended-workflows)** | **[OpenClaw-Integrationsleitfaden](./docs/openclaw-integration.de.md)** | **[GitHub](https://github.com/wang-h/oh-my-kimi)** | **[npm](https://www.npmjs.com/package/oh-my-kimi)**
+
+Multi-Agenten-Orchestrierungsschicht für [Kimi Code CLI](https://moonshotai.github.io/kimi-cli/en/).
+
+## Neu in v0.9.0 — Spark Initiative
+
+Spark Initiative ist das Release, das den nativen Pfad für Exploration und Inspektion in OMX stärkt.
+
+- **Nativer Harness für `omx explore`** — führt Read-only-Repository-Exploration über einen schnelleren und strengeren Rust-Pfad aus.
+- **`omx sparkshell`** — native Operator-Oberfläche für Inspektion mit Zusammenfassungen langer Ausgaben und expliziter tmux-Pane-Erfassung.
+- **Plattformübergreifende native Release-Artefakte** — der Hydration-Pfad für `omx-explore-harness`, `omx-sparkshell` und `native-release-manifest.json` ist jetzt Teil der Release-Pipeline.
+- **Gehärtetes CI/CD** — ergänzt ein explizites Rust-Toolchain-Setup im `build`-Job sowie `cargo fmt --check` und `cargo clippy -- -D warnings`.
+
+Siehe auch die [Release Notes zu v0.9.0](./docs/release-notes-0.9.0.md) und den [Release-Text](./docs/release-body-0.9.0.md).
+
+## Erste Sitzung
+
+Innerhalb von Codex:
+
+```text
+$deep-interview "clarify the auth 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"
+```
+
+Vom Terminal:
+
+```bash
+omx team 4:executor "parallelize a multi-module refactor"
+omx team status <team-name>
+omx team shutdown <team-name>
+```
+
+## Empfohlener Workflow
+
+1. `$deep-interview` — wenn Scope oder Grenzen noch unklar sind.
+2. `$ralplan` — um daraus einen abgestimmten Architektur- und Umsetzungsplan zu machen.
+3. `$team` oder `$ralph` — nutzen Sie `$team` für koordinierte parallele Ausführung oder `$ralph` für einen hartnäckigen Abschluss-/Verifikations-Loop mit einer verantwortlichen Instanz.
+
+## Kernmodell
+
+OMX installiert und verbindet diese Schichten:
+
+```text
+User
+  -> Kimi Code CLI
+    -> AGENTS.md (Orchestrierungs-Gehirn)
+    -> ~/.codex/prompts/*.md (Agenten-Prompt-Katalog)
+    -> ~/.codex/skills/*/SKILL.md (Skill-Katalog)
+    -> ~/.codex/config.toml (Features, Benachrichtigungen, MCP)
+    -> .omx/ (Laufzeitzustand, Speicher, Pläne, Protokolle)
+```
+
+## Hauptbefehle
+
+```bash
+omx                # Codex starten (+ HUD in tmux wenn verfügbar)
+omx setup          # Prompts/Skills/Config nach Bereich installieren + Projekt-.omx + bereichsspezifische AGENTS.md
+omx doctor         # Installations-/Laufzeitdiagnose
+omx doctor --team  # Team/Swarm-Diagnose
+omx team ...       # tmux-Team-Worker starten/Status/fortsetzen/herunterfahren
+omx status         # Aktive Modi anzeigen
+omx cancel         # Aktive Ausführungsmodi abbrechen
+omx reasoning <mode> # low|medium|high|xhigh
+omx tmux-hook ...  # init|status|validate|test
+omx hooks ...      # init|status|validate|test (Plugin-Erweiterungs-Workflow)
+omx hud ...        # --watch|--json|--preset
+omx help
+```
+
+## Hooks-Erweiterung (Additive Oberfläche)
+
+OMX enthält jetzt `omx hooks` für Plugin-Gerüstbau und -Validierung.
+
+- `omx tmux-hook` wird weiterhin unterstützt und ist unverändert.
+- `omx hooks` ist additiv und ersetzt keine tmux-hook-Workflows.
+- Plugin-Dateien befinden sich unter `.omx/hooks/*.mjs`.
+- Plugins sind standardmäßig deaktiviert; aktivieren mit `OMX_HOOK_PLUGINS=1`.
+
+Siehe `docs/hooks-extension.md` für den vollständigen Erweiterungs-Workflow und das Ereignismodell.
+
+## Start-Flags
+
+```bash
+--yolo
+--high
+--xhigh
+--madmax
+--force
+--dry-run
+--verbose
+--scope <user|project>  # nur bei setup
+```
+
+`--madmax` entspricht Codex `--dangerously-bypass-approvals-and-sandbox`.
+Nur in vertrauenswürdigen/externen Sandbox-Umgebungen verwenden.
+
+### MCP workingDirectory-Richtlinie (optionale Härtung)
+
+Standardmäßig akzeptieren MCP-Zustand/Speicher/Trace-Tools das vom Aufrufer bereitgestellte `workingDirectory`.
+Um dies einzuschränken, setzen Sie eine Erlaubnisliste von Wurzelverzeichnissen:
+
+```bash
+export OMX_MCP_WORKDIR_ROOTS="/path/to/project:/path/to/another-root"
+```
+
+Wenn gesetzt, werden `workingDirectory`-Werte außerhalb dieser Wurzeln abgelehnt.
+
+## Codex-First Prompt-Steuerung
+
+Standardmäßig injiziert OMX:
+
+```text
+-c model_instructions_file="<cwd>/AGENTS.md"
+```
+
+Dies kombiniert `AGENTS.md` aus `CODEX_HOME` mit dem Projekt-`AGENTS.md` (falls vorhanden) und legt dann die Laufzeit-Überlagerung darüber.
+Es erweitert das Codex-Verhalten, ersetzt/umgeht aber nicht die Codex-Kernsystemrichtlinien.
+
+Steuerung:
+
+```bash
+OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx     # AGENTS.md-Injektion deaktivieren
+OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx
+```
+
+## Team-Modus
+
+Verwenden Sie den Team-Modus für umfangreiche Arbeiten, die von parallelen Workern profitieren.
+
+Lebenszyklus:
+
+```text
+start -> assign scoped lanes -> monitor -> verify terminal tasks -> shutdown
+```
+
+Operationelle Befehle:
+
+```bash
+omx team <args>
+omx team status <team-name>
+omx team resume <team-name>
+omx team shutdown <team-name>
+```
+
+Wichtige Regel: Fahren Sie nicht herunter, während Aufgaben noch `in_progress` sind, es sei denn, Sie brechen ab.
+
+### Team shutdown policy
+
+Use `omx team shutdown <team-name>` after the team reaches a terminal state.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
+
+Worker-CLI-Auswahl für Team-Worker:
+
+```bash
+OMX_TEAM_WORKER_CLI=auto    # Standard; verwendet claude wenn Worker --model "claude" enthält
+OMX_TEAM_WORKER_CLI=codex   # Codex-CLI-Worker erzwingen
+OMX_TEAM_WORKER_CLI=claude  # Claude-CLI-Worker erzwingen
+OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude,claude  # CLI-Mix pro Worker (Länge=1 oder Worker-Anzahl)
+OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # optional: adaptiven Queue->Resend-Fallback deaktivieren
+```
+
+Hinweise:
+- Worker-Startargumente werden weiterhin über `OMX_TEAM_WORKER_LAUNCH_ARGS` geteilt.
+- `OMX_TEAM_WORKER_CLI_MAP` überschreibt `OMX_TEAM_WORKER_CLI` für Worker-spezifische Auswahl.
+- Trigger-Übermittlung verwendet standardmäßig adaptive Wiederholungsversuche (Queue/Submit, dann sicherer Clear-Line+Resend-Fallback bei Bedarf).
+- Im Claude-Worker-Modus startet OMX Worker als einfaches `claude` (keine zusätzlichen Startargumente) und ignoriert explizite `--model` / `--config` / `--effort`-Überschreibungen, sodass Claude die Standard-`settings.json` verwendet.
+
+## Was `omx setup` schreibt
+
+- `.omx/setup-scope.json` (persistierter Setup-Bereich)
+- Bereichsabhängige Installationen:
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+- Startverhalten: Wenn der persistierte Bereich `project` ist, verwendet `omx` automatisch `CODEX_HOME=./.codex` (sofern `CODEX_HOME` nicht bereits gesetzt ist).
+- Startanweisungen kombinieren `~/.codex/AGENTS.md` (bzw. `CODEX_HOME/AGENTS.md`, wenn überschrieben) mit dem Projekt-`./AGENTS.md` und hängen anschließend die Runtime-Überlagerung an.
+- Vorhandene `AGENTS.md`-Dateien werden nie stillschweigend überschrieben: Interaktive TTY-Läufe fragen vor dem Ersetzen, nicht-interaktive Läufe überspringen das Ersetzen ohne `--force` (aktive Sitzungs-Sicherheitsprüfungen gelten weiterhin).
+- `config.toml`-Aktualisierungen (für beide Bereiche):
+  - `notify = ["node", "..."]`
+  - `model_reasoning_effort = "high"`
+  - `developer_instructions = "..."`
+  - `[features] multi_agent = true, child_agents_md = true`
+  - MCP-Server-Einträge (`omx_state`, `omx_memory`, `omx_code_intel`, `omx_trace`)
+  - `[tui] status_line`
+- Bereichsspezifische `AGENTS.md`
+- `.omx/`-Laufzeitverzeichnisse und HUD-Konfiguration
+
+## Agenten und Skills
+
+- Prompts: `prompts/*.md` (installiert nach `~/.codex/prompts/` für `user`, `./.codex/prompts/` für `project`)
+- Skills: `skills/*/SKILL.md` (installiert nach `~/.codex/skills/` für `user`, `./.codex/skills/` für `project`)
+
+Beispiele:
+- Agenten: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
+- Skills: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
+
+## Projektstruktur
+
+```text
+oh-my-kimi/
+  bin/omx.js
+  src/
+    cli/
+    team/
+    mcp/
+    hooks/
+    hud/
+    config/
+    modes/
+    notifications/
+    verification/
+  prompts/
+  skills/
+  templates/
+  scripts/
+```
+
+## Entwicklung
+
+```bash
+git clone https://github.com/wang-h/oh-my-kimi.git
+cd oh-my-kimi
+npm install
+npm run build
+npm test
+```
+
+## Dokumentation
+
+- **[Vollständige Dokumentation](https://github.com/wang-h/oh-my-kimi#readme)** — Kompletter Leitfaden
+- **[CLI-Referenz](https://github.com/wang-h/oh-my-kimi#command-reference)** — Alle `omx`-Befehle, Flags und Tools
+- **[Benachrichtigungs-Leitfaden](https://github.com/wang-h/oh-my-kimi#notifications)** — Discord, Telegram, Slack und Webhook-Einrichtung
+- **[Empfohlene Workflows](https://github.com/wang-h/oh-my-kimi#recommended-workflows)** — Praxiserprobte Skill-Ketten für häufige Aufgaben
+- **[Versionshinweise](https://github.com/wang-h/oh-my-kimi#release-notes)** — Neuheiten in jeder Version
+
+## Hinweise
+
+- Vollständiges Änderungsprotokoll: `CHANGELOG.md`
+- Migrationsleitfaden (nach v0.4.4 mainline): `docs/migration-mainline-post-v0.4.4.md`
+- Abdeckungs- und Paritätsnotizen: `COVERAGE.md`
+- Hook-Erweiterungs-Workflow: `docs/hooks-extension.md`
+- Setup- und Beitragsdetails: `CONTRIBUTING.md`
+
+## Danksagungen
+
+Inspiriert von [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode), angepasst für Kimi Code CLI.
+
+## Lizenz
+
+MIT

package/README.el.md

@@ -0,0 +1,223 @@
+# oh-my-kimi (OMK)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/wang-h/oh-my-kimi/main/docs/shared/omx-character-spark-initiative.jpg" alt="oh-my-kimi character" width="280">
+  <br>
+  <em>Ξεκινήστε το Codex πιο δυναμικά και αφήστε το OMX να προσθέσει καλύτερα 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)
+
+Το OMX είναι ένα workflow layer για το [Kimi Code CLI](https://moonshotai.github.io/kimi-cli/en/).
+
+Διατηρεί το Codex ως μηχανή εκτέλεσης και διευκολύνει τα εξής:
+- να ξεκινάτε μια πιο δυναμική συνεδρία Codex από προεπιλογή
+- να ακολουθείτε μία συνεπή ροή από διευκρίνιση μέχρι ολοκλήρωση
+- να ενεργοποιείτε το βασικό μονοπάτι με `$deep-interview`, `$ralplan`, `$team` και `$ralph`
+- να κρατάτε οδηγίες έργου, σχέδια, αρχεία καταγραφής και κατάσταση στον φάκελο `.omx/`
+
+## Προτεινόμενη προεπιλεγμένη ροή
+
+Αν θέλετε την προεπιλεγμένη εμπειρία OMX, ξεκινήστε εδώ:
+
+```bash
+npm install -g oh-my-kimi oh-my-kimi
+omx setup
+omx --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` για επίμονο βρόχο ολοκλήρωσης.
+
+## Σε τι χρησιμεύει το OMX
+
+Χρησιμοποιήστε το OMX αν σας αρέσει ήδη το Codex και θέλετε ένα καλύτερο καθημερινό περιβάλλον εργασίας γύρω του:
+- μια τυπική ροή βασισμένη στα `$deep-interview`, `$ralplan`, `$team` και `$ralph`
+- εξειδικευμένους ρόλους και βοηθητικά skills όταν πραγματικά χρειάζονται
+- καθοδήγηση έργου μέσω scoped `AGENTS.md`
+- επίμονη κατάσταση στον `.omx/` για σχέδια, αρχεία καταγραφής, μνήμη και παρακολούθηση λειτουργίας
+
+Αν θέλετε απλό Codex χωρίς επιπλέον επίπεδο ροής εργασίας, πιθανότατα δεν χρειάζεστε το OMX.
+
+## Γρήγορη εκκίνηση
+
+### Απαιτήσεις
+
+- Node.js 20+
+- Εγκατεστημένο Kimi Code CLI: `npm install -g oh-my-kimi`
+- Ρυθμισμένη αυθεντικοποίηση Codex
+- `tmux` σε macOS/Linux αν θέλετε αργότερα τον ανθεκτικό team runtime
+- `psmux` σε native Windows αν θέλετε αργότερα τη λειτουργία team για Windows
+
+### Μια καλή πρώτη συνεδρία
+
+Εκκινήστε το OMX με τον προτεινόμενο τρόπο:
+
+```bash
+omx --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` όταν ένας επίμονος υπεύθυνος πρέπει να το φέρει μέχρι τέλους.
+
+## Ένα απλό νοητικό μοντέλο
+
+Το OMX **δεν** αντικαθιστά το Codex.
+
+Προσθέτει ένα καλύτερο workflow layer γύρω του:
+- **Codex** κάνει την πραγματική δουλειά του agent
+- **Keywords ρόλων OMX** κάνουν τους χρήσιμους ρόλους επαναχρησιμοποιήσιμους
+- **Skills OMX** κάνουν τα συνηθισμένα workflows επαναχρησιμοποιήσιμα
+- **`.omx/`** αποθηκεύει σχέδια, αρχεία καταγραφής, μνήμη και κατάσταση εκτέλεσης
+
+Οι περισσότεροι χρήστες καλό είναι να βλέπουν το OMX ως **καλύτερη δρομολόγηση εργασιών + καλύτερο workflow + καλύτερο runtime**, όχι ως ένα σύνολο εντολών για χειροκίνητη χρήση όλη μέρα.
+
+## Ξεκινήστε εδώ αν είστε νέοι
+
+1. Εκτελέστε `omx setup`
+2. Εκκινήστε με `omx --madmax --high`
+3. Χρησιμοποιήστε `$deep-interview "..."` όταν το αίτημα ή τα όρια είναι ακόμη ασαφή
+4. Χρησιμοποιήστε `$ralplan "..."` για να εγκρίνετε το σχέδιο και τους συμβιβασμούς
+5. Επιλέξτε `$team` για συντονισμένη παράλληλη εκτέλεση ή `$ralph` για επίμονο βρόχο ολοκλήρωσης
+
+## Συνήθη surfaces μέσα στη συνεδρία
+
+| Λειτουργία | Χρήση |
+| --- | --- |
+| `$deep-interview "..."` | αποσαφήνιση πρόθεσης, ορίων και μη-στόχων |
+| `$ralplan "..."` | έγκριση σχεδίου υλοποίησης και συμβιβασμών |
+| `$ralph "..."` | επίμονος βρόχος ολοκλήρωσης και επαλήθευσης |
+| `$team "..."` | συντονισμένη παράλληλη εκτέλεση όταν η εργασία είναι αρκετά μεγάλη |
+| `/skills` | περιήγηση στα διαθέσιμα skills και βοηθητικά εργαλεία |
+
+Χρησιμοποιήστε `$deep-interview` όταν το αίτημα είναι ακόμη ασαφές, τα όρια δεν είναι ξεκάθαρα ή θέλετε το OMX να πιέσει μέχρι να ξεκαθαρίσει πρόθεση, μη-στόχους και όρια αποφάσεων πριν περάσει στο `$ralplan` και έπειτα στο `$team` ή στο `$ralph`.
+
+Τυπικές περιπτώσεις:
+- ασαφείς greenfield ιδέες που χρειάζονται πιο καθαρή πρόθεση και εύρος
+- brownfield αλλαγές όπου το OMX πρέπει πρώτα να εξετάσει το repo και μετά να κάνει στοχευμένες ερωτήσεις επιβεβαίωσης
+- αιτήματα όπου θέλετε έναν βρόχο διευκρίνισης μία-ερώτηση-τη-φορά αντί για άμεσο σχεδιασμό ή υλοποίηση
+
+## Προχωρημένες λειτουργίες / για διαχειριστές
+
+Αυτά είναι χρήσιμα, αλλά δεν είναι ο βασικός τρόπος για να ξεκινήσετε.
+
+### Team runtime
+
+Χρησιμοποιήστε τον team runtime όταν χρειάζεστε ειδικά ανθεκτικό συντονισμό tmux/worktree, όχι ως τον προεπιλεγμένο τρόπο για να ξεκινήσετε με το OMX.
+
+```bash
+omx team 3:executor "fix the failing tests with verification"
+omx team status <team-name>
+omx team resume <team-name>
+omx team shutdown <team-name>
+```
+
+### Setup, doctor και HUD
+
+Αυτές είναι λειτουργίες διαχείρισης/υποστήριξης:
+- `omx setup` εγκαθιστά prompts, skills, ρυθμίσεις και scaffolding AGENTS
+- `omx doctor` επαληθεύει την εγκατάσταση όταν κάτι φαίνεται λάθος
+- `omx hud --watch` είναι λειτουργία παρακολούθησης/κατάστασης, όχι η κύρια ροή εργασίας του χρήστη
+
+### Explore και sparkshell
+
+- `omx explore --prompt "..."` είναι για αναζήτηση μόνο ανάγνωσης στο repository
+- `omx sparkshell <command>` είναι για επιθεώρηση απευθείας από το shell και στοχευμένη επαλήθευση
+
+Παραδείγματα:
+
+```bash
+omx explore --prompt "find where team state is written"
+omx sparkshell git status
+omx sparkshell --tmux-pane %12 --tail-lines 400
+```
+
+### Σημειώσεις πλατφόρμας για τη λειτουργία team
+
+Η `omx 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, η εκκίνηση του OMX, ειδικά με `--madmax --high`, μπορεί να αυξήσει απότομα τη χρήση CPU των `syspolicyd` / `trustd` ενώ το macOS Gatekeeper επαληθεύει πολλές ταυτόχρονες εκκινήσεις διεργασιών.
+
+Αν συμβεί αυτό, δοκιμάστε:
+- `xattr -dr com.apple.quarantine $(which omx)`
+- προσθέστε την εφαρμογή τερματικού σας στη λίστα επιτρεπόμενων 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