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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

use ratatui::{
    Frame,
    layout::{Constraint, Direction, Layout, Rect},
    style::{Color, Modifier, Style},
    text::{Line, Span},
    widgets::Paragraph,
};

use super::super::sender_bound_bundle;
use super::super::state::AppState;
use super::cursor::render_active_cursor;
use super::overlays::{
    events::render_events_overlay, help::render_help_overlay, picker::render_picker_overlay,
};

pub(super) const WORKBENCH_MIN_CHAT_HEIGHT: u16 = 1;
pub(super) const WORKBENCH_MIN_COMPOSE_HEIGHT: u16 = 4;
pub(super) const INTERACTION_RAWW_PANE_HEIGHT: u16 = 8;
pub(super) const INTERACTION_TARGET_HEADER_HEIGHT: u16 = 1;

pub(crate) fn render(frame: &mut Frame, state: &mut AppState) {
    let chunks = Layout::default()
        .direction(Direction::Vertical)
        .constraints([
            Constraint::Length(1),
            Constraint::Min(12),
            Constraint::Length(1),
        ])
        .split(frame.area());

    render_header(frame, chunks[0], state);
    render_main(frame, chunks[1], state);
    render_footer(frame, chunks[2], state);
    render_active_cursor(frame, chunks[1], state);

    if state.help_overlay_open {
        render_help_overlay(frame, state);
    }
    if state.picker_open {
        render_picker_overlay(frame, state);
    }
    if state.events_overlay_open {
        render_events_overlay(frame, state);
    }
}

fn render_header(frame: &mut Frame, area: Rect, state: &AppState) {
    let mut spans = vec![Span::styled(
        "Agentmux",
        Style::default()
            .fg(Color::Cyan)
            .add_modifier(Modifier::BOLD),
    )];
    // A relay-wide (`@GLOBAL`) sender is bound to no bundle, so the `Bundle:`
    // field is meaningless — the principal id already encodes the namespace. The
    // browsing bundle survives only as the `List` enumeration target, not as a
    // sender binding, so it is not surfaced in the header for these principals.
    if sender_bound_bundle(&state.sender_session, &state.namespace).is_some() {
        spans.push(Span::raw("  Bundle: "));
        spans.push(Span::styled(
            state.namespace.clone(),
            Style::default()
                .fg(Color::Cyan)
                .add_modifier(Modifier::BOLD),
        ));
    }
    spans.push(Span::raw(format!(
        "  Sender: {}  Pending Deliveries: {}",
        state.sender_session,
        state.pending_deliveries_count()
    )));
    let paragraph =
        Paragraph::new(vec![Line::from(spans)]).style(Style::default().bg(Color::DarkGray));
    frame.render_widget(paragraph, area);
}

pub(super) fn render_main(frame: &mut Frame, area: Rect, state: &mut AppState) {
    match state.mode {
        super::super::state::ScreenMode::Communication => {
            super::communication::render_communication_mode(frame, area, state)
        }
        super::super::state::ScreenMode::Interaction => {
            super::interaction::render_interaction_mode(frame, area, state)
        }
    }
}

fn render_footer(frame: &mut Frame, area: Rect, state: &AppState) {
    let (mode_label, toggle_hint) = match state.mode {
        super::super::state::ScreenMode::Communication => ("[Communication]", "F4 → Interaction"),
        super::super::state::ScreenMode::Interaction => ("[Interaction]", "F4 → Communication"),
    };
    let status_line = state
        .status_history
        .front()
        .map(render_status_line)
        .unwrap_or_else(|| Line::from("Ready."));
    let mut spans = vec![
        Span::styled(
            mode_label,
            Style::default()
                .fg(Color::Cyan)
                .add_modifier(Modifier::BOLD),
        ),
        Span::raw("  "),
        Span::styled(toggle_hint, Style::default().fg(Color::Yellow)),
        Span::raw("  "),
    ];
    spans.extend(status_line.spans);
    let footer = Paragraph::new(Line::from(spans))
        .wrap(ratatui::widgets::Wrap { trim: false })
        .style(Style::default().bg(Color::DarkGray));
    frame.render_widget(footer, area);
}

fn render_status_line(entry: &super::super::state::StatusEntry) -> Line<'static> {
    match entry.code.as_ref() {
        Some(code) => Line::from(vec![
            Span::styled(
                format!("[{code}] "),
                Style::default().fg(Color::Red).add_modifier(Modifier::BOLD),
            ),
            Span::raw(entry.message.clone()),
        ]),
        None => Line::from(Span::raw(entry.message.clone())),
    }
}