muxi logs

Stream logs from a running formation with powerful filtering options. Great for debugging, monitoring, and understanding what your agents are doing.

Usage

muxi logs [options]

Requires at least one filter. Press Ctrl+C to stop streaming.

Quick Examples

muxi logs -u alice                    # All logs for a user
muxi logs -s sess_abc123              # Logs for a session
muxi logs --agent weather-bot         # Logs from specific agent
muxi logs --level error               # Errors only
muxi logs -u alice --level error      # Errors for a user

Filters

By User

muxi logs -u alice
muxi logs --user usr_abc123

By Session

muxi logs -s sess_abc123
muxi logs --session sess_abc123

By Request

muxi logs --request req_xyz789

By Agent

muxi logs --agent weather-bot
muxi logs --agent muxi-generalist

By Log Level

muxi logs --level debug      # All levels
muxi logs --level info       # Info and above
muxi logs --level warn       # Warnings and above
muxi logs --level error      # Errors only

By Event Type

Supports wildcards:

muxi logs --event "chat.*"           # All chat events
muxi logs --event "agent.selected"   # Specific event
muxi logs --event "error.*"          # All errors

Combining Filters

# Errors for a specific user
muxi logs -u alice --level error

# Agent activity in a session
muxi logs -s sess_abc123 --agent weather-bot

# Chat events for debugging
muxi logs -u alice --event "chat.*"

Options

Log Output

Logs stream with timestamps in JSON format:

[24-Dec-2024 10:30:45 UTC] {"event": "chat.message", "user_id": "alice", ...}
[24-Dec-2024 10:30:46 UTC] {"event": "agent.selected", "agent": "researcher", ...}

Tips

• Start broad (-u user) then narrow down with additional filters
• Use --level error to quickly find problems
• Use --event "chat.*" to follow conversation flow
• Combine --agent with --level debug for detailed agent debugging

Learn More

• CLI Quick Reference - All CLI commands at a glance
• Observability - Full observability system overview
• Event Types - All 349 event types
• Troubleshooting - Common issues and fixes