agentmux 0.8.0

Multi-agent coordination runtime with inter-agent messaging across CLI, MCP, tmux, and ACP.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

use ratatui::{
    Frame,
    layout::{Constraint, Direction, Layout},
    style::Modifier,
    text::{Line, Span},
    widgets::{Block, Borders, Clear, Paragraph, Wrap},
};

use super::super::super::state::AppState;
use super::super::geometry::centered_rect;

pub(in crate::tui::render) fn render_help_overlay(frame: &mut Frame, _state: &AppState) {
    let popup = centered_rect(72, 80, frame.area());
    frame.render_widget(Clear, popup);
    let block = Block::default().borders(Borders::ALL).title("Help");
    let inner = block.inner(popup);
    frame.render_widget(block, popup);

    let columns = Layout::default()
        .direction(Direction::Horizontal)
        .constraints([Constraint::Percentage(50), Constraint::Percentage(50)])
        .split(inner);

    let left_lines = vec![
        help_section_heading("Modes"),
        Line::from("F4: Toggle Communication / Interaction"),
        Line::from("F1: Toggle help"),
        Line::from("F2: Open picker (sessions)"),
        Line::from("F3: Open events overlay"),
        Line::from("F5: Open picker (bundles)"),
        Line::from("Ctrl+R: Refresh recipients"),
        Line::from("Ctrl+C: Quit from anywhere"),
        Line::from(""),
        help_section_heading("Communication Mode (default)"),
        Line::from("Tab / Shift+Tab: Focus next/previous"),
        Line::from("Ctrl+Space: Trigger completion in To"),
        Line::from("Up/Down in To: Navigate completion"),
        Line::from("Arrows/Home/End in To: Move cursor"),
        Line::from("Ctrl+A/Ctrl+E in To: Field start/end"),
        Line::from("Ctrl+U in To: Clear field"),
        Line::from("Arrows/Home/End in Message: Move cursor"),
        Line::from("Ctrl+A/Ctrl+E in Message: Line start/end"),
        Line::from("Enter: Accept completion / send"),
        Line::from("Ctrl+J: Insert newline in Message"),
        Line::from("Esc in Message: Snap history to latest"),
        Line::from("PgUp/PgDn: Scroll chat history"),
        Line::from("Mouse wheel: Scroll chat history"),
        Line::from(""),
        help_section_heading("To Field Grammar"),
        Line::from("session — route to active bundle"),
        Line::from("session@bundle — route to named bundle"),
        Line::from("session@GLOBAL — relay-wide user"),
        Line::from("Comma-separate multiple recipients"),
    ];
    let right_lines = vec![
        help_section_heading("Interaction Mode"),
        Line::from("PgUp/PgDn: Scroll look snapshot"),
        Line::from("Write input (write has text or no pending):"),
        Line::from("  Arrows/Home/End: Move write cursor"),
        Line::from("  Enter: Dispatch write to active target"),
        Line::from("  Ctrl+J: Insert newline"),
        Line::from("  Backspace: Backspace write input"),
        Line::from("Choose (write empty and pending exists):"),
        Line::from("  Left/Right: Previous/next request"),
        Line::from("  Up/Down: Previous/next ACP option"),
        Line::from("  Enter: Resolve selected option"),
        Line::from("  c: Resolve as cancelled"),
        Line::from(""),
        help_section_heading("Picker (F2 sessions / F5 bundles)"),
        Line::from("Up/Down: Move selection in column"),
        Line::from("Tab / Left/Right: Switch column"),
        Line::from("Type / Backspace: Filter column"),
        Line::from("Enter (bundle col): Switch bundle"),
        Line::from("Enter (session, Comm): Insert into To"),
        Line::from("Enter (session, Interact): Open look"),
        Line::from("Esc / F2 / F5: Close picker"),
        Line::from("Auto-opens entering Interaction w/o target"),
    ];

    frame.render_widget(
        Paragraph::new(left_lines).wrap(Wrap { trim: false }),
        columns[0],
    );
    frame.render_widget(
        Paragraph::new(right_lines).wrap(Wrap { trim: false }),
        columns[1],
    );
}

fn help_section_heading(text: &'static str) -> Line<'static> {
    Line::from(Span::styled(
        text,
        ratatui::style::Style::default().add_modifier(Modifier::BOLD),
    ))
}