Permissions, Pickers, and Transfer Workflows: New muxd UX Upgrades

This release is focused on day-to-day ergonomics: safer automation defaults, better visibility while work is running, and easier file workflows when your TUI and daemon run on different machines.

Permission Modes for Safer Automation

You can now choose how strict muxd should be before tools execute:

  • ask: prompt before edits and shell actions
  • accept-edits: auto-approve in-repo edits, still ask for shell actions
  • full-auto: auto-approve most actions, with hard denylists for sensitive paths

Switch modes quickly:

/permissions ask
/permissions accept-edits
/permissions full-auto

This gives you a practical balance between speed and safety, depending on the task.

Project Rules Auto-Loaded Into Context

muxd now reads project guidance files automatically:

  • MUXD.md
  • AGENTS.md
  • CLAUDE.md

If one or more are present, they are injected into the system context so the agent follows repo-specific constraints without repeating them every session.

Better Activity Visibility + Background Jobs

Long-running work is now easier to track:

  • Background shell jobs can be launched and monitored with:
    • bash_background
    • bash_output
    • bash_list
    • bash_kill
  • TUI status now surfaces background activity, so the UI no longer feels idle while work continues in the daemon.

New File Workflow: Pick, Attach, Transfer

Remote daemon setups often need file movement before analysis. muxd now has explicit flows for that.

Local attach picker

Use /attach (or /attach pick) to open a local file picker and queue files for your next prompt.

/attach
/attach list
/attach clear

Remote file browsing and copy to local

Use /transfer remote to browse files on the daemon host and copy selected files to the local TUI workspace.

Local upload to remote daemon host

Use /transfer local to pick local files and upload them to the daemon host.

Together, these flows remove the "where is this file?" friction when TUI and daemon are split across machines.

Spinner Style Picker

You can now choose spinner style in the TUI:

  • /spinner opens an interactive picker
  • /config set theme.spinner <style> sets it directly

This includes all built-in Bubble spinner styles (line, dot, mini-dot, jump, pulse, points, globe, moon, monkey, meter, hamburger, ellipsis).

Quality-of-Life Reliability

Several reliability improvements shipped with these UX updates:

  • clearer HTTP error reporting for proxy/session creation failures
  • improved remote status behavior around background task monitoring
  • better handling of node registration host selection

These are the kinds of fixes that make distributed muxd usage feel predictable instead of fragile.

Try It

If you run muxd with a remote hub or daemon, this release is especially worth upgrading for.

Start with:

/permissions ask
/attach
/transfer remote
/transfer local
/spinner

You will feel the difference in one session.