legion-tty 0.4.12 → 0.4.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9506a28fb68d7623dd1e70e2b69b80e80b2a96486c068dbc2d13a7e2bd9a80ab
-  data.tar.gz: 7ce9e32334ba94891569b073e04246240d8b1637edb930f0c8c86ed80841a155
+  metadata.gz: bc958211b7004e0392a9e96cf2a874d6c54d6f0c6f183d87d80f428e16d3b014
+  data.tar.gz: 13264f1761391724054983f250767d9308aab1a397d0dc1577292268a0f7e031
 SHA512:
-  metadata.gz: b7cf759adc8fcaad726906fd6e95d12a00d5e09bbf3724685a1fae91bdd31d9df31036bc4d826cc7b756f2cb97ae2d560290dbb6c1f0473b8334da48508d5a39
-  data.tar.gz: 7fcce87bc7f909f1e5b5c6d468871860a0a2be6f621a8b446d7948cf2761bf354035911d946c134b74d04b226e19f2b174c010d1fb9e7a39533162f826883865
+  metadata.gz: fd92069e863ebb5bd1185068adf3f50323fb276a2ae0479a8253e0220c1e4bc22a76abb7b8eb73a4c4a22c84be9f22cddf6eea22d510d7772fd459d3d74a1ff9
+  data.tar.gz: afcce634192c2e16f133b0d237cd3720536dfce07e2cae17089f208867546d82d75a58bb352887da1d0d29c0e651d047b79596fea0428d35f152e48f17707069

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.4.13] - 2026-03-19
+
+### Added
+- Help overlay: `/help` now renders as a categorized overlay (SESSION/CHAT/LLM/NAV/DISPLAY/TOOLS) via screen manager
+- Session message count in status bar ("N msgs" segment)
+- `/welcome` command: redisplay the welcome message
+- `/tips` command: show random usage tips (15 tips covering commands, hotkeys, features)
+
 ## [0.4.12] - 2026-03-19
 
 ### Added

data/README.md

@@ -2,30 +2,36 @@
 
 Rich terminal UI for the LegionIO async cognition engine.
 
-**Version**: 0.4.8
+**Version**: 0.4.12
 
-Think Claude Code meets Codex CLI, but for LegionIO: onboarding wizard with identity detection, streaming AI chat shell, operational dashboard, extensions browser, config editor, and session persistence - all rendered with the [tty-ruby](https://ttytoolkit.org/) gem ecosystem.
+Think Claude Code meets Codex CLI, but for LegionIO: onboarding wizard with identity detection, streaming AI chat shell with 40 slash commands, operational dashboard, extensions browser, config editor, and session persistence - all rendered with the [tty-ruby](https://ttytoolkit.org/) gem ecosystem.
 
 ## Features
 
 - **Onboarding wizard** - First-run setup with Kerberos identity detection, GitHub profile probing, environment scanning, and LLM provider selection
 - **Digital rain intro** - Matrix-style rain using discovered LEX extension names
-- **AI chat shell** - Streaming LLM chat with 27 slash commands, tab completion, markdown rendering, and tool panels
-- **Operational dashboard** - Service status, extension inventory, system info, recent activity (Ctrl+D or `/dashboard`)
-- **Extensions browser** - Browse installed LEX gems by category (core, agentic, service, AI, other) with detail view
-- **Config viewer/editor** - View and edit `~/.legionio/settings/*.json` with vault:// masking
+- **AI chat shell** - Streaming LLM chat with 40 slash commands, tab completion, markdown rendering, and tool panels
+- **Operational dashboard** - Service/LLM status, extension inventory, system info, panel navigation (Ctrl+D or `/dashboard`)
+- **Extensions browser** - Browse installed LEX gems by category with detail view and homepage opener ('o' key)
+- **Config viewer/editor** - View and edit `~/.legionio/settings/*.json` with vault:// masking and JSON validation
 - **Command palette** - Fuzzy-search overlay for all commands, screens, and sessions (Ctrl+K or `/palette`)
 - **Model picker** - Switch LLM providers interactively
-- **Session management** - Auto-save on quit, `/save`, `/load`, `/sessions`, session picker (Ctrl+S)
+- **Session management** - Auto-save on quit, `/save`, `/load`, `/sessions`, `/rename`, session picker (Ctrl+S)
 - **Token tracking** - Per-model pricing for 9 models across 8 providers via `/cost`
 - **Plan mode** - Bookmark messages without sending to LLM (`/plan`)
 - **Personality styles** - Switch between default, concise, detailed, friendly, technical (`/personality`)
 - **Theme selection** - Four built-in themes: purple (default), green, blue, amber (`/theme`)
-- **Conversation tools** - `/compact`, `/copy`, `/diff`, `/search`, `/stats`
+- **Conversation tools** - `/compact`, `/copy`, `/diff`, `/search`, `/grep`, `/stats`, `/undo`
+- **Message pinning** - Pin important messages (`/pin`), view pins (`/pins`), export bookmarks (`/bookmark`)
+- **Command aliases** - Create custom shortcuts for frequently used commands (`/alias`)
+- **Code snippets** - Save and load reusable text snippets (`/snippet`)
+- **Debug mode** - Toggle internal state display (`/debug`)
+- **Session context** - View active settings summary (`/context`)
+- **Toast notifications** - Transient status bar messages for save/load/export/theme actions
 - **Hotkey navigation** - Ctrl+D (dashboard), Ctrl+K (palette), Ctrl+S (sessions), Escape (back)
 - **Tab completion** - Type `/` and Tab to auto-complete slash commands
-- **Input history** - Up/down arrow to navigate previous inputs
-- **Progress panel** - Visual progress bars for long operations (extension scanning, gem ops)
+- **Input history** - Up/down arrow to navigate previous inputs, `/history` to view
+- **Progress panel** - Visual progress bars for long operations
 - **Animated spinner** - Status bar spinner during LLM thinking
 - **Daemon routing** - Routes through LegionIO daemon when available, falls back to direct
 - **Second-run flow** - Skips onboarding, re-scans environment, drops into chat
@@ -74,9 +80,9 @@ legion chat prompt "explain async cognition"
 | `/quit` | Exit (auto-saves session) |
 | `/clear` | Clear message history |
 | `/model <name>` | Switch LLM model at runtime |
-| `/session <name>` | Rename current session |
+| `/session <name>` | Set session name |
 | `/cost` | Show token usage and estimated cost |
-| `/export [md\|json]` | Export chat history to file |
+| `/export [md\|json\|html]` | Export chat history to file |
 | `/tools` | List discovered LEX extensions |
 | `/dashboard` | Toggle operational dashboard |
 | `/hotkeys` | Show registered hotkey bindings |
@@ -91,11 +97,24 @@ legion chat prompt "explain async cognition"
 | `/config` | View and edit settings files |
 | `/theme [name]` | Switch color theme (purple/green/blue/amber) |
 | `/search <text>` | Search message history |
+| `/grep <pattern>` | Regex search across messages |
 | `/compact [N]` | Keep last N message pairs, remove older |
 | `/copy` | Copy last assistant response to clipboard |
 | `/diff` | Show new messages since last session load |
 | `/stats` | Show conversation statistics |
 | `/personality [style]` | Switch personality (default/concise/detailed/friendly/technical) |
+| `/undo` | Remove last user+assistant message pair |
+| `/history` | Show input history |
+| `/pin [N]` | Pin a message (last assistant or by index) |
+| `/pins` | Show all pinned messages |
+| `/rename <name>` | Rename current session (moves saved file) |
+| `/context` | Show active session state summary |
+| `/alias [name] [cmd]` | Create or list command aliases |
+| `/snippet <action>` | Save/load/list/delete code snippets |
+| `/debug` | Toggle debug mode |
+| `/uptime` | Show session elapsed time |
+| `/bookmark` | Export pinned messages to file |
+| `/time` | Show current date and time |
 
 ## Hotkeys
 
@@ -120,16 +139,22 @@ legion-tty
 
   Screens/
     Onboarding           # First-run wizard (rain -> intro -> wizard -> reveal)
-    Chat                 # AI chat REPL with streaming + slash commands
-    Dashboard            # Operational status panels
-    Extensions           # LEX gem browser by category
-    Config               # Settings file viewer/editor
+    Chat                 # AI chat REPL with streaming + 40 slash commands
+      SessionCommands    # save/load/sessions/delete/rename
+      ExportCommands     # export/bookmark/html/json/markdown
+      MessageCommands    # compact/copy/diff/search/grep/undo/pin/pins
+      UiCommands         # help/clear/dashboard/hotkeys/palette/context/stats/debug/history/uptime/time
+      ModelCommands      # model/system/personality switching
+      CustomCommands     # alias/snippet management
+    Dashboard            # Service/LLM status, panel navigation (j/k/1-5)
+    Extensions           # LEX gem browser by category with homepage opener
+    Config               # Settings file viewer/editor with JSON validation
 
   Components/
     DigitalRain          # Matrix-style falling characters
-    InputBar             # Prompt line with tab completion + thinking indicator
-    MessageStream        # Scrollable message history with markdown rendering
-    StatusBar            # Model, plan mode, thinking, tokens, cost, session
+    InputBar             # Prompt line with tab completion + input history
+    MessageStream        # Scrollable message history with markdown + timestamps
+    StatusBar            # Model, plan, debug, notifications, thinking, tokens, cost, session, scroll
     ToolPanel            # Expandable tool use panels
     MarkdownView         # TTY::Markdown rendering
     WizardPrompt         # TTY::Prompt wrappers
@@ -161,6 +186,7 @@ Identity and credentials are stored in `~/.legionio/settings/`:
 - `credentials.json` - LLM provider and API key (chmod 600)
 
 Sessions are stored in `~/.legionio/sessions/`.
+Snippets are stored in `~/.legionio/snippets/`.
 Exports go to `~/.legionio/exports/`.
 Boot logs go to `~/.legionio/logs/tty-boot.log`.
 
@@ -168,8 +194,8 @@ Boot logs go to `~/.legionio/logs/tty-boot.log`.
 
 ```bash
 bundle install
-bundle exec rspec       # 653 examples, 0 failures
-bundle exec rubocop     # 77 files, 0 offenses
+bundle exec rspec       # 836 examples, 0 failures
+bundle exec rubocop     # 92 files, 0 offenses
 ```
 
 ## License

data/lib/legion/tty/components/status_bar.rb

@@ -6,10 +6,11 @@ require_relative 'notification'
 module Legion
   module TTY
     module Components
+      # rubocop:disable Metrics/ClassLength
       class StatusBar
         def initialize
           @state = { model: nil, tokens: 0, cost: 0.0, session: 'default', thinking: false, plan_mode: false,
-                     debug_mode: false }
+                     debug_mode: false, message_count: 0 }
           @notifications = []
         end
 
@@ -46,6 +47,7 @@ module Legion
             notification_segment,
             tokens_segment,
             cost_segment,
+            message_count_segment,
             session_segment,
             scroll_segment
           ].compact
@@ -90,6 +92,11 @@ module Legion
           Theme.c(:success, format('$%.3f', @state[:cost])) if @state[:cost].to_f.positive?
         end
 
+        def message_count_segment
+          count = @state[:message_count].to_i
+          Theme.c(:muted, "#{count} msgs") if count.positive?
+        end
+
         def session_segment
           Theme.c(:muted, @state[:session]) if @state[:session]
         end
@@ -132,6 +139,7 @@ module Legion
           result
         end
       end
+      # rubocop:enable Metrics/ClassLength
     end
   end
 end

data/lib/legion/tty/screens/chat/ui_commands.rb

@@ -6,40 +6,61 @@ module Legion
       class Chat < Base
         # rubocop:disable Metrics/ModuleLength
         module UiCommands
+          TIPS = [
+            'Press Tab after / to auto-complete commands',
+            'Use /alias to create shortcuts (e.g., /alias s /save)',
+            'Press Ctrl+K to open the command palette',
+            'Use /grep for regex search (e.g., /grep error|warning)',
+            'Pin important messages with /pin, export with /bookmark',
+            'Use /compact 3 to keep only the last 3 message pairs',
+            "Press 'o' in Extensions browser to open gem homepage",
+            '/export html creates a styled dark-theme HTML export',
+            'Use /snippet save name to save assistant responses for reuse',
+            'The dashboard updates every 5 seconds; press r to refresh',
+            '/context shows your full session state at a glance',
+            'Use /personality technical for code-focused responses',
+            '/debug shows internal state counters in the status bar',
+            'Navigate dashboard panels with j/k or number keys 1-5',
+            'Use /diff to see new messages since a session was loaded'
+          ].freeze
+
+          HELP_TEXT = [
+            'SESSION : /save /load /sessions /delete /rename',
+            'CHAT    : /clear /undo /compact /copy /search /grep /diff /stats',
+            'LLM     : /model /system /personality /cost',
+            'NAV     : /dashboard /extensions /config /palette /hotkeys',
+            'DISPLAY : /theme /plan /debug /context /time /uptime',
+            'TOOLS   : /tools /export /bookmark /pin /pins /alias /snippet /history',
+            '',
+            'Hotkeys: Ctrl+D=dashboard  Ctrl+K=palette  Ctrl+S=sessions  Esc=back'
+          ].freeze
+
           private
 
-          # rubocop:disable Metrics/MethodLength
           def handle_help
+            text = HELP_TEXT.join("\n")
+            if @app.respond_to?(:screen_manager) && @app.screen_manager
+              @app.screen_manager.show_overlay(text)
+            else
+              @message_stream.add_message(role: :system, content: text)
+            end
+            :handled
+          end
+
+          def handle_welcome
+            cfg = safe_config
             @message_stream.add_message(
               role: :system,
-              content: "Commands:\n  /help /quit /clear /model <name> /session <name> /cost\n  " \
-                       "/export [md|json] /tools /dashboard /hotkeys /save /load /sessions\n  " \
-                       "/system <prompt> /delete <session> /plan /palette /extensions /config\n  " \
-                       "/theme [name] -- switch color theme (purple, green, blue, amber)\n  " \
-                       "/search <text> -- search message history\n  " \
-                       "/grep <regex> -- regex search message history\n  " \
-                       "/compact [n] -- keep last n message pairs (default 5)\n  " \
-                       "/copy -- copy last assistant message to clipboard\n  " \
-                       "/diff -- show new messages since session was loaded\n  " \
-                       "/stats -- show conversation statistics\n  " \
-                       "/personality [name] -- switch assistant personality\n  " \
-                       "/undo -- remove last user+assistant message pair\n  " \
-                       "/history -- show recent input history\n  " \
-                       "/pin [N] -- pin last assistant message (or message at index N)\n  " \
-                       "/pins -- show all pinned messages\n  " \
-                       "/rename <name> -- rename current session\n  " \
-                       "/context -- show active session context summary\n  " \
-                       "/alias [shortname /command] -- create or list command aliases\n  " \
-                       "/snippet save|load|list|delete <name> -- manage reusable text snippets\n  " \
-                       "/debug -- toggle debug mode (shows internal state)\n  " \
-                       "/uptime -- show how long this session has been active\n  " \
-                       "/time -- show current date, time, and timezone\n  " \
-                       "/bookmark -- export pinned messages to a markdown file\n\n" \
-                       'Hotkeys: Ctrl+D=dashboard  Ctrl+K=palette  Ctrl+S=sessions  Esc=back'
+              content: "Welcome#{", #{cfg[:name]}" if cfg[:name]}. Type /help for commands."
             )
             :handled
           end
-          # rubocop:enable Metrics/MethodLength
+
+          def handle_tips
+            tip = TIPS.sample
+            @message_stream.add_message(role: :system, content: "Tip: #{tip}")
+            :handled
+          end
 
           def handle_clear
             @message_stream.messages.clear

data/lib/legion/tty/screens/chat.rb

@@ -28,7 +28,7 @@ module Legion
         SLASH_COMMANDS = %w[/help /quit /clear /compact /copy /diff /model /session /cost /export /tools /dashboard
                             /hotkeys /save /load /sessions /system /delete /plan /palette /extensions /config
                             /theme /search /grep /stats /personality /undo /history /pin /pins /rename
-                            /context /alias /snippet /debug /uptime /time /bookmark].freeze
+                            /context /alias /snippet /debug /uptime /time /bookmark /welcome /tips].freeze
 
         PERSONALITIES = {
           'default' => 'You are Legion, an async cognition engine and AI assistant. Be helpful and concise.',
@@ -71,6 +71,7 @@ module Legion
             role: :system,
             content: "Welcome#{", #{cfg[:name]}" if cfg[:name]}. Type /help for commands."
           )
+          @status_bar.update(message_count: @message_stream.messages.size)
         end
 
         def running?
@@ -124,6 +125,7 @@ module Legion
             @message_stream.add_message(role: :assistant, content: '')
             send_to_llm(input)
           end
+          @status_bar.update(message_count: @message_stream.messages.size)
           render_screen
         end
 
@@ -336,6 +338,8 @@ module Legion
           when '/uptime' then handle_uptime
           when '/time' then handle_time
           when '/bookmark' then handle_bookmark
+          when '/welcome' then handle_welcome
+          when '/tips' then handle_tips
           else :handled
           end
         end

data/lib/legion/tty/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module TTY
-    VERSION = '0.4.12'
+    VERSION = '0.4.13'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-tty
 version: !ruby/object:Gem::Version
-  version: 0.4.12
+  version: 0.4.13
 platform: ruby
 authors:
 - Esity