Log

The log files can be found at ~/.local/state/honeymux/logs/. A rotation is maintained with a 2 MiB cap on each file, keeping the active log plus five archives.

Log files

The active log is honeymux.log. When it reaches its size cap the current file is rotated to honeymux.log.0 and earlier archives shift down by one, so the directory contains at most honeymux.log plus honeymux.log.0 through honeymux.log.4. Each entry is a single line of the form <ISO-8601 timestamp> [<tag>] <message>; the tag identifies the subsystem that wrote the line.

Tags currently in use:

app — General messages
consent — Agent-hook install decisions (accept/reject per provider) and history-indexing consent. See Agent Integrations.
fatal — A crash report was written. The matching report lives in ~/.local/state/honeymux/crashes/ and contains the stack trace, pid, session, tmux server, and Bun/platform details.
history — Conversation history indexing progress and failures. See Conversations.
hooks — Agent-hook installer writes (Claude Code, Codex CLI, Gemini CLI, OpenCode).
probe — Terminal capability probing results
proxy — The per-pane proxy process that bridges a local pane to a remote honeymux socket.
remote — Remote Stitching lifecycle: pane conversion, recovery after reconnect, SSH stderr passthrough, and remote pane exits. See Remote Stitching.

When reporting a bug

Include three things so maintainers can reproduce and triage quickly:

Honeymux version, tmux version, and terminal emulator. All three are shown on the About tab of the Main Menu — press Ctrl+G, then Tab to the About tab. hmx -V also prints the Honeymux version from the command line.
A relevant log snippet. Attach a few lines around the problem from ~/.local/state/honeymux/logs/honeymux.log. If the issue produced a crash, also attach the matching file from ~/.local/state/honeymux/crashes/ — the fatal line in the log points at it by path.
What you did and what you expected. A short description of the steps that triggered the behavior, and what the expected outcome was.