CAMEL-23226: Add TUI dashboards for Camel JBang by gnodet · Pull Request #22197 · apache/camel

gnodet · 2026-03-23T14:22:18Z

Summary

Add full-screen TUI (Terminal User Interface) dashboards to Camel JBang using TamboUI, providing rich interactive monitoring and browsing capabilities directly in the terminal. The TUI is implemented as a separate plugin module (camel-jbang-plugin-tui), loaded via the @CamelJBangPlugin SPI mechanism.

New Commands

Command	Description
`camel monitor`	Multi-tab dashboard with overview, routes, processors, health, endpoints, log, and trace tabs
`camel catalog-tui`	Interactive component catalog browser with search and detail view

Monitor Tabs

Overview — Live integration list with status, uptime, throughput sparklines, memory gauge
Routes — Route list with state, message counts, timing stats, and processor detail
Processors — Per-route processor breakdown with message counts and timing
Health — Health check dashboard with UP/DOWN indicators
Endpoints — Endpoint list with direction, component, and route association
Log — Scrollable log viewer with level filtering (TRACE/DEBUG/INFO/WARN/ERROR), follow mode, and detail panel
Trace — Exchange trace viewer with detail panel for headers, body, and exchange properties

Key Features

Live data refresh with configurable intervals
Keyboard navigation (arrow keys, tab switching via number keys)
Color-coded status indicators (green/yellow/red)
Sparkline throughput charts in overview
Log level filtering and follow mode
Trace detail with headers/body toggle
Memory gauge with heap usage
Vanishing effect for stopped integrations
Fuzzy search in catalog browser

Dependencies

Add TamboUI 0.2.0-SNAPSHOT dependencies (tamboui-tui, tamboui-widgets, tamboui-jline3-backend)

Module Structure

dsl/camel-jbang/camel-jbang-plugin-tui/ — new plugin module
- CamelMonitor.java — multi-tab monitor dashboard
- CamelCatalogTui.java — interactive catalog browser
- TuiHelper.java — shared TUI utilities
- TuiPlugin.java — plugin registration via SPI

Test plan

camel monitor shows running integrations with live stats across all tabs
Log tab correctly parses ANSI-stripped log lines with regex-based parser
Trace tab correctly parses backlog trace JSON format
All null fields handled safely (no NPEs in rendering)
camel catalog-tui browses components with search and detail view
All TUI views handle Ctrl+C/q cleanly

- Add `camel monitor` full-screen TUI dashboard with tabs for overview, routes, health checks, endpoints, and log viewer - Add `camel top tui` htop-style route performance dashboard with sortable columns and live refresh - Add `camel log tui` scrollable log viewer with level filtering, follow mode, and grep support - Add `camel trace tui` exchange trace viewer with detail panel showing headers, body, and exchange properties - Add `camel health` TUI health check dashboard with UP/DOWN indicators and memory gauge - Add `camel catalog tui` interactive component catalog browser with search/filter and component detail view - Upgrade JLine from 4.0.7 to 4.0.9 - Add TamboUI dependencies for terminal UI rendering - Use TamboUI's built-in JLine 3 backend (compatible with JLine 4.0.9) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-23T14:22:54Z

🌟 Thank you for your contribution to the Apache Camel project! 🌟
🤖 CI automation will test this PR automatically.

🐫 Apache Camel Committers, please review the following items:

First-time contributors require MANUAL approval for the GitHub Actions to run
You can use the command /component-test (camel-)component-name1 (camel-)component-name2.. to request a test from the test bot although they are normally detected and executed by CI.
You can label PRs using build-all, build-dependents, skip-tests and test-dependents to fine-tune the checks executed by this PR.
Build and test logs are available in the summary page. Only Apache Camel committers have access to the summary.

⚠️ Be careful when sharing logs. Review their contents before sharing them publicly.

github-actions · 2026-03-23T14:47:20Z

🧪 CI tested the following changed modules:

dsl/camel-jbang
dsl/camel-jbang/camel-jbang-core
dsl/camel-jbang/camel-jbang-plugin-tui
dsl/camel-jbang/camel-launcher
parent

ℹ️ Dependent modules were not tested because the total number of affected modules exceeded the threshold (50). Use the test-dependents label to force testing all dependents.

Build reactor — dependencies compiled but only changed modules were tested (10 modules)

Camel :: JBang :: Core
Camel :: JBang :: Core [jar]
Camel :: JBang :: Parent
Camel :: JBang :: Parent [pom]
Camel :: JBang :: Plugin :: TUI
Camel :: JBang :: Plugin :: TUI [jar]
Camel :: Launcher
Camel :: Launcher [jar]
Camel :: Parent
Camel :: Parent [pom]

apupier · 2026-03-23T14:59:41Z

...l-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/CamelCatalogTui.java

+        try {
+            Class.forName("dev.tamboui.tui.event.KeyModifiers");
+            Class.forName("dev.tamboui.tui.event.KeyEvent");
+            Class.forName("dev.tamboui.tui.event.KeyCode");
+            Class.forName("picocli.CommandLine$IExitCodeGenerator");
+        } catch (ClassNotFoundException e) {
+            // ignore
+        }


What's the interest of callingClass;forName to then ignore exception and do nothing about it?

Claude Code on behalf of Guillaume Nodet

Good question! This eagerly pre-loads classes that the TUI input reader daemon thread needs. Without this, during JVM shutdown the classloader may already be closing (especially with JBang's custom classloader) while the input reader thread is still trying to load KeyModifiers, KeyEvent, etc. lazily — causing ClassNotFoundException stack traces on exit.

The comment was missing on this file (the others already had it). Added it now, and will also extract this into a shared utility to avoid the duplication.

If one fails the following classes are not pre-loeaded and there is no error handling that could help understand what happened.

Sure, though, if one fails, the real code (main thread) will certainly fail too with an error that will be logged somewhere. This is really only to avoid the daemon thread to fail with a non actionable exception. I guess another possibility would be to swallow exceptions when closing, but that may hide other problems.

…ogTui Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Move duplicated code (preloadClasses, findPids, loadStatus, truncate, objToLong) from all 6 TUI commands into a shared TuiHelper utility class. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Croway · 2026-03-23T15:48:34Z

Why is the TUI part of Camel JBang core? what about having it as a new plugin?

- Create camel-jbang-plugin-tui with TuiPlugin that registers all TUI commands - Move all TUI source files from camel-jbang-core to camel-jbang-plugin-tui - Remove TamboUI dependencies from camel-jbang-core - Add parentCommands support to @CamelJBangPlugin annotation so plugins can inject subcommands into existing commands (e.g. 'top tui', 'trace tui') - Update PluginHelper to load plugins when target matches parentCommands Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Register TuiPlugin in CamelLauncherMain.postAddCommands() (plugins are loaded explicitly, not via classpath scanning) - Rename parentCommands to commands in @CamelJBangPlugin annotation to cover both top-level commands and parent commands the plugin extends - Include health and monitor in the plugin's commands list Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Consolidate CamelTopTui, CamelTraceTui, CamelLogTui, CamelHealthTui into unified CamelMonitor dashboard with 6 tabs (Overview, Routes, Health, Endpoints, Log, Trace) - Enhanced Routes tab with sort cycling (mean/max/total/failed/name) - Enhanced Health tab with readiness/liveness columns and DOWN filter - Enhanced Log tab with level filtering and follow mode - New Trace tab with exchange-level trace viewer - Redesigned CamelCatalogTui with split-panel layout (component list + options table) and context-sensitive description panel - Added inline per-panel filtering with name-only and full-text toggle (/) - Simplified TuiPlugin to only register top-level commands - Removed commands attribute from @CamelJBangPlugin annotation - Reverted plugin loading mechanism in PluginHelper Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Redesign log tab: table with selectable rows + bottom detail panel - Add LogEntry data class for structured log parsing - Add highlight spacing (ALWAYS) to all tables to prevent content shift - Remove hardcoded column truncation (routes FROM, overview NAME, etc.) - Increase endpoints ROUTE column width - Remove redundant SPACE_CELL buffer fill (Cell.EMPTY already uses space) - Rendering artifacts fix: requires updated TamboUI 0.2.0-SNAPSHOT with refactored AbstractBackend (cursor optimization removed) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Use regex-based parser that handles both old format (space separator) and Spring Boot 3.x/Camel 4.x ISO-8601 format (T separator + timezone) - Strip ANSI color codes from log lines before parsing Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Fix trace file parser to handle actual JSON format (traces array wrapper, numeric uid/timestamp, done/failed booleans instead of status string, nested body/headers/properties structures) - Add null guards for switch expressions (ep.direction, entry.status) - Use getIntegerOrDefault/getLongOrDefault to prevent NPE from null unboxing - Add null checks for route.state, ep.component, proc.id, proc.processor - Move log file reading from render to refreshData tick for better performance - Make traceFilePositions thread-safe with ConcurrentHashMap - Remove dead truncate method in CamelCatalogTui - Revert unneeded PluginHelper.java changes Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

gnodet · 2026-03-23T21:07:11Z

Claude Code on behalf of Guillaume Nodet

@Croway The TUI is already implemented as a separate plugin module (camel-jbang-plugin-tui), not in camel-jbang-core. The initial commit had it in core but it was moved to its own plugin in a follow-up commit (549d945). The plugin is loaded via the @CamelJBangPlugin annotation and SPI mechanism.

Switch from 0.2.0-SNAPSHOT to the released 0.1.0 version and remove the sonatype-snapshots repository block. No 0.2.0-specific APIs are used by the TUI plugin. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions bot added dsl core-build-and-dependencies labels Mar 23, 2026

apupier reviewed Mar 23, 2026

View reviewed changes

gnodet and others added 2 commits March 23, 2026 16:14

CAMEL-23226: Add comment explaining eager class loading in CamelCatal…

0941078

…ogTui Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CAMEL-23226: Extract shared TUI utilities into TuiHelper class

71bde7d

Move duplicated code (preloadClasses, findPids, loadStatus, truncate, objToLong) from all 6 TUI commands into a shared TuiHelper utility class. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

gnodet and others added 3 commits March 23, 2026 17:45

gansheer self-requested a review March 23, 2026 19:10

gnodet and others added 3 commits March 23, 2026 21:20

gnodet marked this pull request as ready for review March 23, 2026 21:09

CAMEL-23226: Use TamboUI 0.1.0 release instead of SNAPSHOT

52f2a7c

Switch from 0.2.0-SNAPSHOT to the released 0.1.0 version and remove the sonatype-snapshots repository block. No 0.2.0-specific APIs are used by the TUI plugin. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

CAMEL-23226: Add TUI dashboards for Camel JBang#22197

CAMEL-23226: Add TUI dashboards for Camel JBang#22197
gnodet wants to merge 10 commits intomainfrom
Guillaume-Nodet/camel-tui

gnodet commented Mar 23, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 23, 2026

Uh oh!

github-actions bot commented Mar 23, 2026 •

edited

Loading

Uh oh!

apupier Mar 23, 2026

Uh oh!

gnodet Mar 23, 2026

Uh oh!

gansheer Mar 23, 2026

Uh oh!

gnodet Mar 23, 2026

Uh oh!

Croway commented Mar 23, 2026

Uh oh!

gnodet commented Mar 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

gnodet commented Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

New Commands

Monitor Tabs

Key Features

Dependencies

Module Structure

Test plan

Uh oh!

github-actions bot commented Mar 23, 2026

Uh oh!

github-actions bot commented Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apupier Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

gnodet Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

gansheer Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

gnodet Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Croway commented Mar 23, 2026

Uh oh!

gnodet commented Mar 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

gnodet commented Mar 23, 2026 •

edited

Loading

github-actions bot commented Mar 23, 2026 •

edited

Loading