@agentikos/omega-os 0.19.29 → 0.19.31

package/omega/Agentik_Engine/omega_engine/__init__.py

@@ -188,7 +188,7 @@ from omega_engine.genesis import (
 )
 from omega_engine import plan as plan_v7
 
-__version__ = "0.19.29"
+__version__ = "0.19.31"
 
 __all__ = [
     "__version__",

package/omega/Agentik_Engine/omega_engine/cli.py

@@ -2856,19 +2856,22 @@ def cmd_menu(_args: argparse.Namespace) -> int:
 
 
 def cmd_menu_tui(args: argparse.Namespace) -> int:
-    """`omega menu-tui` — slash-command REPL (default) or Textual TUI.
+    """`omega menu-tui` — fzf arrow-key menu (default) / REPL / Textual.
 
-    v0.19.29 default = plain REPL. Textual was unreliable under
-    tmux + send-keys (focus didn't reach the input). The REPL uses
-    synchronous input() which works EVERYWHERE, plus readline for
-    history + tab completion of slash commands.
+    v0.19.30 default = fzf arrow-key menu. Arrow keys + search-as-you-type
+    + mouse + Enter, with clean grouped layout (CHAT / PROJECTS / AUDITS
+    / INFRASTRUCTURE / HEALTH / SCRAPE / EXIT). Color-themed to Claude
+    (orange #D97757 accents on dark backdrop).
 
-    Opt into Textual: `omega menu-tui --textual` (useful when running
-    omega directly in iTerm/Wezterm/Kitty without tmux send-keys).
+    Flags:
+      --repl     → plain slash REPL (input() loop, type /commands)
+      --textual  → Textual app (opt-in, may break under tmux send-keys)
     """
     from omega_engine.tui import run_tui
-    prefer_textual = getattr(args, "textual", False)
-    return run_tui(prefer_textual=prefer_textual)
+    return run_tui(
+        prefer_textual=getattr(args, "textual", False),
+        force_repl=getattr(args, "repl", False),
+    )
 
 
 def _legacy_fzf_menu(_args: argparse.Namespace) -> int:
@@ -4345,10 +4348,12 @@ def _build_parser() -> argparse.ArgumentParser:
         help="open the interactive whiptail menu (legacy)"
     ).set_defaults(fn=cmd_menu_whiptail)
     p_mt = sub.add_parser("menu-tui",
-        help="slash-command REPL (default) — use --textual for the "
-        "fancier (but tmux-fragile) Textual TUI")
+        help="fzf arrow-key menu (default), --repl for slash REPL, "
+        "--textual for the Textual app")
     p_mt.add_argument("--textual", action="store_true",
-                      help="try the Textual app instead of the REPL")
+                      help="try the Textual app (fragile under tmux)")
+    p_mt.add_argument("--repl", action="store_true",
+                      help="force slash REPL instead of the arrow menu")
     p_mt.set_defaults(fn=cmd_menu_tui)
     sub.add_parser("menu-fzf",
         help="legacy v0.19.26 fzf menu fallback"

package/omega/Agentik_Engine/omega_engine/tmux.py

@@ -325,6 +325,48 @@ def _spawn_with_shell_then_run(
     return name
 
 
+def spawn_chat_in_omega(
+    window_name: str,
+    *,
+    ctx_dir: Path,
+    run_command: str,
+    force_replace: bool = False,
+) -> bool:
+    """v0.19.31 — spawn a chat as a WINDOW inside the Omega master session.
+
+    Returns True when the window exists after the call. The user can
+    then `tmux select-window -t Omega:<name>` (or pick from the menu).
+    Detach (Ctrl-b d) detaches the whole Omega session — user comes
+    back to their shell with Omega still alive, and `omega` re-attaches
+    them straight back to the menu.
+
+    Why windows instead of separate sessions: the user wants `omega`
+    to STAY OMEGA. With separate AISB-chat / Hermes-chat sessions,
+    detaching from one of those landed them in the shell, not back
+    in the Omega menu. Windows under Omega solve that — everything
+    lives under the same session lifecycle.
+    """
+    if not is_alive("Omega"):
+        # Omega master must already be alive — bare `omega` ensures this.
+        spawn_omega_master(ctx_dir.parent.parent.parent)
+    # Probe existing windows.
+    _, list_out = _tmux("list-windows", "-t", "Omega", "-F", "#W")
+    existing = list_out.splitlines() if list_out else []
+    if window_name in existing:
+        if force_replace:
+            _tmux("kill-window", "-t", f"Omega:{window_name}")
+        else:
+            return True
+    # Create the window with the user's interactive shell at ctx_dir, then
+    # send the launch command. Shell stays alive even if the command exits.
+    rc, _ = _tmux("new-window", "-t", "Omega", "-n", window_name,
+                  "-c", str(ctx_dir))
+    if rc != 0:
+        return False
+    _tmux("send-keys", "-t", f"Omega:{window_name}", run_command, "Enter")
+    return True
+
+
 def spawn_aisb_chat(omega_home: str | Path | None = None,
                      force_replace: bool = False) -> str:
     """Spawn the AISB master chat tmux session — REAL Claude Code TUI.
@@ -530,12 +572,20 @@ bind-key Z display-popup -E -w 80% -h 80% "omega tmux menu"
 # Prefix+S — native session list (tmux's built-in choose-tree)
 bind-key S choose-tree -Zs
 
+# Open the Omega menu from anywhere in tmux (Option+/ or Option+z).
+# macOS Option key → enable "Use Option as Meta" in your terminal.
+bind-key -n M-/ run-shell -b "tmux has-session -t Omega 2>/dev/null || tmux new-session -d -s Omega -n menu -c $HOME 'omega menu-tui'; tmux switch-client -t Omega"
+bind-key -n M-z run-shell -b "tmux has-session -t Omega 2>/dev/null || tmux new-session -d -s Omega -n menu -c $HOME 'omega menu-tui'; tmux switch-client -t Omega"
+
 # ════════════════════════════════════════════════════════════════════
-# Visual cues per session category
+# Claude Code LIGHT theme (white-paper)
 # ════════════════════════════════════════════════════════════════════
-set -g status-style "bg=#1a1a2e,fg=#eeeeee"
-set -g status-left  "#[fg=#7aa2f7,bold]#S #[fg=default]│ "
-set -g status-right "#[fg=#888888]%H:%M │ #(omega tmux count 2>/dev/null) sessions"
+set -g status-style "bg=#FAFAF7,fg=#3D3929"
+set -g status-left  "#[fg=#D97757,bold]Ω #S #[fg=#A8A29E]│ "
+set -g status-right "#[fg=#88837A]%H:%M │ #(omega tmux count 2>/dev/null) sessions"
+set -g pane-border-style "fg=#A8A29E"
+set -g pane-active-border-style "fg=#D97757"
+set -g message-style "bg=#E5E2DD,fg=#3D3929"
 """
 
 
@@ -623,18 +673,42 @@ bind-key S choose-tree -Zs
 bind-key r source-file ~/.tmux.conf \\; display-message "tmux.conf reloaded"
 
 # ════════════════════════════════════════════════════════════════════
-# Visual cues per session category — colour the status bar by name.
+# Global Omega menu keybindings (v0.19.31)
+# ════════════════════════════════════════════════════════════════════
+# Open the Omega menu from ANYWHERE in tmux — no prefix needed.
+#
+#   Option+/   or   Option+z      → opens the Omega menu
+#
+# How: spawn the Omega session if missing, then switch the current
+# client to it. Detach (Ctrl-b d) brings you back to your shell with
+# Omega still alive.
+#
+# IMPORTANT — for Option key to work on macOS terminals, enable
+# "Use Option as Meta key" (iTerm2: Profile → Keys → Left/Right Option
+# Key → Esc+). Otherwise the binding stays inactive.
+bind-key -n M-/ run-shell -b "tmux has-session -t Omega 2>/dev/null || tmux new-session -d -s Omega -n menu -c $HOME 'omega menu-tui'; tmux switch-client -t Omega"
+bind-key -n M-z run-shell -b "tmux has-session -t Omega 2>/dev/null || tmux new-session -d -s Omega -n menu -c $HOME 'omega menu-tui'; tmux switch-client -t Omega"
+
+# ════════════════════════════════════════════════════════════════════
+# Claude Code LIGHT theme (white-paper) — status bar + borders
 # ════════════════════════════════════════════════════════════════════
-set -g status-style "bg=#1a1a2e,fg=#eeeeee"
-set -g status-left  "#[fg=#7aa2f7,bold]#S #[fg=default]│ "
-set -g status-right "#[fg=#888888]%H:%M │ #(omega tmux count 2>/dev/null) sessions"
+# Colours derived from tweakcn.com/r/themes/claude.json:
+#   bg #FAFAF7 (cream)  fg #3D3929 (slate)  accent #D97757 (orange)
+#   muted #88837A (warm gray)  border #A8A29E (soft)
+set -g status-style "bg=#FAFAF7,fg=#3D3929"
+set -g status-left  "#[fg=#D97757,bold]Ω #S #[fg=#A8A29E]│ "
+set -g status-right "#[fg=#88837A]%H:%M │ #(omega tmux count 2>/dev/null) sessions"
 set -g status-interval 5
 set -g status-left-length 40
 set -g status-right-length 60
 
-# Pane border colour — softer than default red
-set -g pane-border-style "fg=#333333"
-set -g pane-active-border-style "fg=#7aa2f7"
+# Pane borders — soft warm gray, accent orange on the active pane.
+set -g pane-border-style "fg=#A8A29E"
+set -g pane-active-border-style "fg=#D97757"
+
+# Message + copy-mode prompts — same palette.
+set -g message-style "bg=#E5E2DD,fg=#3D3929"
+set -g mode-style    "bg=#D97757,fg=#FAFAF7"
 """
 
 

package/omega/Agentik_Engine/omega_engine/tui.py

@@ -409,23 +409,269 @@ if TEXTUAL_AVAILABLE:
                 _switch_client(res.session_jump)
 
 
-def run_tui(prefer_textual: bool = False) -> int:
-    """Entry point — `omega menu-tui` calls this.
+def _arrow_menu() -> int:
+    """v0.19.30 — fzf-driven arrow-key menu (the default `omega` UX).
+
+    Clean grouped layout, arrow-key navigation, search-as-you-type,
+    Enter to pick, Esc to refresh. After each action runs INLINE in
+    the same pane, "press Enter to return" then re-render the menu.
+
+    Why fzf and not Textual? Textual's focus model is fragile under
+    tmux + send-keys (v0.19.27 bug). fzf has been arrow-key + mouse
+    capable since 2014; it's lightweight, single-binary, and behaves
+    consistently in every terminal.
+
+    Why fzf and not whiptail? whiptail is fine but visually 1995. fzf
+    gives us a Linear-style search filter and clean ANSI color groups.
+    """
+    import os
+    import shlex
+    import shutil
+    import subprocess
+    from pathlib import Path
+    from omega_engine import __version__
+    from omega_engine import tmux
+
+    if not shutil.which("fzf"):
+        print("  fzf not on PATH — falling back to slash REPL.")
+        print("  install: brew install fzf  (or apt install fzf)")
+        return _plain_repl()
+
+    HOME = Path(os.environ.get("OMEGA_HOME", str(Path.home() / "Omega")))
+    OMEGA_BIN = str(HOME / "Agentik_Tools" / "bin" / "omega")
+
+    # ANSI escapes — used via fzf --ansi.
+    ORANGE = "\033[38;2;217;119;87m"
+    MUTED  = "\033[38;2;136;131;122m"
+    BOLD   = "\033[1m"
+    DIM    = "\033[2m"
+    RST    = "\033[0m"
+
+    def _label(name: str, hint: str = "") -> str:
+        """Two-column label: name on the left, hint dimmed on the right."""
+        if hint:
+            return f"  {name:<36}{DIM}{hint}{RST}"
+        return f"  {name}"
+
+    def _section(name: str) -> str:
+        return f"{ORANGE}{BOLD}── {name} ──{RST}"
+
+    def _build_items() -> list[tuple[str, str]]:
+        """Return (display, action_key) — section headers have key '__sep__'."""
+        provider = _active_provider()
+        sessions = tmux.list_sessions(HOME)
+        return [
+            (_section("CHAT"),                                          "__sep__"),
+            (_label("AISB master chat",  "→ claude (Max OAuth)"),       "open:aisb"),
+            (_label("Hermès companion",  "→ claude (Anthropic API)"),   "open:hermes"),
+            (_label("Switch LLM",        f"current: {provider}"),       "switch:provider"),
+            ("",                                                        "__sep__"),
+            (_section("PROJECTS"),                                      "__sep__"),
+            (_label("New project",       "Genesis pipeline"),           "genesis:new"),
+            (_label("Open project shell"),                              "project:open"),
+            ("",                                                        "__sep__"),
+            (_section("AUDITS & MISSIONS"),                             "__sep__"),
+            (_label("Run a mission",     "verified completion"),        "run:mission"),
+            (_label("Quality Arsenal",   "17 forensic audits"),         "audit:menu"),
+            ("",                                                        "__sep__"),
+            (_section("INFRASTRUCTURE"),                                "__sep__"),
+            (_label("Sessions",          f"{len(sessions)} active"),    "sessions:list"),
+            (_label("Accounts",          "Claude Max pool"),            "accounts:menu"),
+            (_label("Vault",             "encrypted secrets"),          "vault:menu"),
+            ("",                                                        "__sep__"),
+            (_section("HEALTH"),                                        "__sep__"),
+            (_label("omega doctor",      "full health check"),          "cmd:doctor"),
+            (_label("omega status",      "task state"),                 "cmd:status"),
+            ("",                                                        "__sep__"),
+            (_section("SCRAPE"),                                        "__sep__"),
+            (_label("Stealth scrape",    "CloakBrowser"),               "scrape:cloak"),
+            (_label("Fast scrape",       "Scrapling"),                  "scrape:scrapling"),
+            ("",                                                        "__sep__"),
+            (_section("EXIT"),                                          "__sep__"),
+            (_label("Detach",            "session keeps running"),      "detach"),
+            (_label("Quit Omega",        "kills the tmux session"),     "quit:kill"),
+        ]
+
+    def _run_inline(cmd_argv, *, shell: bool = False) -> None:
+        os.system("clear")
+        header = " ".join(cmd_argv) if isinstance(cmd_argv, list) else cmd_argv
+        print(f"  {ORANGE}{BOLD}Ω ›{RST} {header}")
+        print(f"  {MUTED}{'─' * 60}{RST}")
+        if shell:
+            subprocess.run(cmd_argv, shell=True)
+        else:
+            subprocess.run(cmd_argv)
+        print()
+        print(f"  {MUTED}{'─' * 60}{RST}")
+        try:
+            input(f"  {DIM}press Enter to return to Omega menu… {RST}")
+        except (EOFError, KeyboardInterrupt):
+            pass
+
+    def _prompt(label: str) -> str:
+        try:
+            return input(f"  {ORANGE}{label}:{RST} ").strip()
+        except (EOFError, KeyboardInterrupt):
+            return ""
+
+    while True:
+        items = _build_items()
+        lines = [disp for disp, _ in items]
+        header = (
+            f"{ORANGE}{BOLD}Ω  Omega OS v{__version__}{RST}  "
+            f"{MUTED}•  ↑↓ navigate  •  ↵ pick  •  / search  •  Esc refresh{RST}"
+        )
+        try:
+            # Claude Code LIGHT theme (white-paper) — bg cream #FAFAF7,
+            # fg dark slate #3D3929, accent orange #D97757, muted warm
+            # gray #88837A, soft border #A8A29E. Reads cleanly under
+            # both light and dark terminal backgrounds (we override
+            # fzf's bg explicitly).
+            proc = subprocess.run(
+                ["fzf",
+                 "--ansi",
+                 "--prompt=Ω › ",
+                 f"--header={header}",
+                 "--header-first",
+                 "--layout=reverse",
+                 "--height=100%",
+                 "--border=rounded",
+                 "--padding=1,2",
+                 "--no-multi",
+                 "--info=hidden",
+                 "--pointer=▶",
+                 "--marker=●",
+                 "--color="
+                 "bg:#FAFAF7,"
+                 "fg:#3D3929,"
+                 "bg+:#E5E2DD,"
+                 "fg+:#D97757,"
+                 "hl:#D97757,"
+                 "hl+:#D97757,"
+                 "prompt:#D97757,"
+                 "pointer:#D97757,"
+                 "marker:#D97757,"
+                 "header:#88837A,"
+                 "border:#A8A29E,"
+                 "info:#88837A,"
+                 "spinner:#D97757,"
+                 "gutter:#FAFAF7"],
+                input="\n".join(lines), capture_output=True, text=True,
+            )
+        except (KeyboardInterrupt, subprocess.SubprocessError):
+            return 0
+        if proc.returncode != 0:
+            # Esc → refresh.
+            continue
+        pick = proc.stdout.rstrip("\n")
+        action = None
+        for disp, key in items:
+            if disp == pick and key != "__sep__":
+                action = key
+                break
+        if action is None:
+            continue
 
-    v0.19.29 — switched the DEFAULT to the plain slash REPL because the
-    Textual app, while pretty, has unreliable focus/keyboard delivery
-    inside tmux panes launched via send-keys. The user's bug report
-    ("je peux pas taper dans le keyboard ni sélectionner") was reproducible
-    on the VPS too — Textual's Input widget doesn't always claim focus
-    when the app starts under tmux + send-keys.
+        # === Dispatch ===
+        if action == "detach":
+            subprocess.run(["tmux", "detach-client"])
+            return 0
+        if action == "quit:kill":
+            subprocess.run(["tmux", "kill-session", "-t", "Omega"])
+            return 0
+        if action == "open:aisb":
+            # v0.19.31 — open as a WINDOW in Omega, not a separate session.
+            # User stays in Omega; Ctrl-b 0 returns to menu, Ctrl-b d
+            # detaches the whole Omega (and `omega` brings them back).
+            persona = HOME / "Agentik_SSOT" / "agents" / "aisb" / "CLAUDE.md"
+            ctx_dir = tmux._ensure_chat_context_dir(HOME, "aisb-master", persona)
+            tmux.spawn_chat_in_omega(
+                "aisb", ctx_dir=ctx_dir, run_command="claude",
+                force_replace=False,
+            )
+            subprocess.run(["tmux", "select-window", "-t", "Omega:aisb"])
+            continue
+        if action == "open:hermes":
+            persona = HOME / "Agentik_SSOT" / "docs" / "LAYERS.md"
+            ctx_dir = tmux._ensure_chat_context_dir(HOME, "hermes", persona)
+            try:
+                from omega_engine.vault import vault_read
+                api_key = (vault_read(HOME, "ANTHROPIC_API_KEY_HERMES") or "").strip()
+            except Exception:  # noqa: BLE001
+                api_key = ""
+            if not api_key:
+                api_key = (os.environ.get("ANTHROPIC_API_KEY") or "").strip()
+            run_cmd = (f"ANTHROPIC_API_KEY={api_key} claude"
+                       if api_key else "claude")
+            tmux.spawn_chat_in_omega(
+                "hermes", ctx_dir=ctx_dir, run_command=run_cmd,
+                force_replace=False,
+            )
+            subprocess.run(["tmux", "select-window", "-t", "Omega:hermes"])
+            continue
+        if action == "switch:provider":
+            _run_inline([OMEGA_BIN, "switch"]); continue
+        if action == "genesis:new":
+            slug = _prompt("project slug (a-z0-9_-)")
+            if slug:
+                _run_inline([OMEGA_BIN, "genesis", "new", slug])
+            continue
+        if action == "project:open":
+            _run_inline("ls -la ~/Omega/Agentik_Coding/projects/ 2>/dev/null "
+                        "&& echo && echo '(cd into one to start working)'",
+                        shell=True)
+            continue
+        if action == "run:mission":
+            intent = _prompt("mission intent")
+            if intent:
+                _run_inline([OMEGA_BIN, "run", intent])
+            continue
+        if action == "audit:menu":
+            _run_inline(
+                "echo '  Quality Arsenal — 17 forensic audits:' && "
+                "echo '    /codeaudit /uiuxaudit /flowaudit /debugaudit' && "
+                "echo '    /featureaudit /perfaudit /secaudit /a11yaudit' && "
+                "echo '    /seoaudit /dataaudit /apiaudit /copyaudit' && "
+                "echo '    /dxaudit /motionaudit /automationaudit' && "
+                "echo '    /logicaudit /retentionaudit /refontaudit' && "
+                "echo && echo '  invoke from any claude session, or:' && "
+                f"echo '    {OMEGA_BIN} audit <id>'",
+                shell=True)
+            continue
+        if action == "sessions:list":
+            _run_inline("tmux ls", shell=True); continue
+        if action == "accounts:menu":
+            _run_inline([OMEGA_BIN, "account", "list"]); continue
+        if action == "vault:menu":
+            _run_inline([OMEGA_BIN, "vault", "status"]); continue
+        if action == "cmd:doctor":
+            _run_inline([OMEGA_BIN, "doctor"]); continue
+        if action == "cmd:status":
+            _run_inline([OMEGA_BIN, "status"]); continue
+        if action == "scrape:cloak":
+            url = _prompt("URL")
+            if url:
+                _run_inline([OMEGA_BIN, "scrape", url])
+            continue
+        if action == "scrape:scrapling":
+            url = _prompt("URL")
+            if url:
+                _run_inline([OMEGA_BIN, "scrape", url, "--engine", "scrapling"])
+            continue
+
+
+def run_tui(prefer_textual: bool = False,
+            force_repl: bool = False) -> int:
+    """Entry point — `omega menu-tui` calls this.
 
-    The plain REPL uses synchronous `input()` which is rock-solid in any
-    terminal, any tmux config, any TERM value. It accepts the SAME slash
-    commands (/aisb /hermes /switch /audit /mission /scrape /doctor …).
+    v0.19.30 — default is the arrow-key fzf menu (clean grouped layout,
+    arrow keys + search-as-you-type + mouse, color theme matched to
+    Claude). Falls back to plain slash REPL if fzf is missing.
 
-    Opt back into Textual via `omega menu-tui --textual` (or pass
-    prefer_textual=True from code) — useful when iTerm/Wezterm/Kitty
-    runs the menu directly without tmux send-keys interference.
+    Modes:
+      - default       → `_arrow_menu()` (fzf, arrow keys + search)
+      - `--repl`      → `_plain_repl()` (input() loop, slash commands)
+      - `--textual`   → Textual TUI (opt-in, may break under tmux)
     """
     if prefer_textual and TEXTUAL_AVAILABLE:
         try:
@@ -434,9 +680,10 @@ def run_tui(prefer_textual: bool = False) -> int:
             return 0
         except Exception as exc:  # noqa: BLE001
             print(f"  Textual TUI failed: {exc}")
-            print("  Falling back to plain REPL.")
-            return _plain_repl()
-    return _plain_repl()
+            print("  Falling back to arrow-key menu.")
+    if force_repl:
+        return _plain_repl()
+    return _arrow_menu()
 
 
 # ---------------------------------------------------------------------------

package/omega/Agentik_Engine/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "omega-engine"
-version = "0.19.29"
+version = "0.19.31"
 description = "The Omega OS orchestration engine — event-sourced, verified-completion agent graphs."
 readme = "README.md"
 requires-python = ">=3.11"

package/omega/Agentik_SSOT/VERSION

@@ -1 +1 @@
-0.19.29
+0.19.31

package/omega/Agentik_SSOT/clis/clis-catalog.yaml

@@ -74,6 +74,19 @@ native:
     secrets: []
     recommended: true
 
+  - id: paperclipai
+    name: Paperclip (orchestration UI — agent teams, org charts, governance)
+    # Node.js + React app from paperclipai/paperclip. Coordinates multiple
+    # agents (Claude Code, Codex, Cursor, OpenClaw) into teams with org
+    # charts, budgets, governance. Launches a web dashboard + CLI tools.
+    # We use the `onboard` npx flow which handles install + initial config.
+    # Requires Node 20+, pnpm 9.15+ (both checked by step_system_deps).
+    install: { npm_global: "paperclipai" }
+    binary: paperclip
+    secrets: []
+    recommended: false
+    post_install: ["paperclip", "--version"]
+
   - id: scrapling
     name: Scrapling (optional fast scraper — HTTP-first, adaptive elements)
     # Complementary to CloakBrowser. Scrapling shines for non-protected

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentikos/omega-os",
-  "version": "0.19.29",
+  "version": "0.19.31",
   "description": "Omega OS — installable agentic operating system with verified-completion orchestration. Event-sourced engine, 8-block rack, autonomous agents, MCP.",
   "bin": {
     "omega-os": "bin/omega-os.js"