The composer

The composer is the box at the bottom of every chat. Its hint says what it can do: Ask anything · @ to add files · / for commands.

Send a messageCopy Anchor Link

• On a keyboard, Enter sends and Shift Enter starts a new line.
• On a phone's on-screen keyboard, Return adds a new line. Tap the send button to send.

While the agent works, the send button turns into Stop, which interrupts it. You can still send another message with a keyboard:

• Codex takes it into the turn it's working on.
• The other agents queue it and read it when the current turn ends.

If you're offline, your message waits and goes out when you're back online.

Run settingsCopy Anchor Link

The pill in the toolbar holds the session's agent settings: the model, effort, fast mode, account and access level. See Models, Access levels and Accounts.

Under the composer you'll also find:

• Detail: how much of the agent's work the chat shows. Low shows messages only, Medium adds short tool lines, High shows every command and edit.
• The branch: the session's git branch, with Fetch, Pull and Push (or Publish for a new branch).

/ commandsCopy Anchor Link

Type / at the start of a line, or after a space, to open the command menu. It lists:

• supermux's own commands, like /model to pick a model, /stop to interrupt the agent, and /mute to silence notifications from the session,
• the agent's own commands, like Claude Code's or Cursor's slash commands, and Codex's skills (which start with $),
• skills and commands from your plugins, grouped by plugin,
• commands from this project and your own skills.

An empty / shows your recent commands first. Keep typing to filter; the menu understands abbreviations and also searches descriptions. Use ↑ ↓ to move, Enter or Tab to pick, Esc to close.

On a wide screen, the side of the menu shows the highlighted command in full: what it does, where it comes from and how to use it. supermux's own commands run right away. The agent's commands are put into the composer so you can add to them before you send.

Mention files with @Copy Anchor Link

Type @ to pick a file or folder from the project:

• @ on its own lists the project's top folder.
• @src/ lists that folder. Picking a folder keeps the menu open, so you can keep going.
• Anything else searches the whole project by name.

The mention goes into your message as plain text, like @src/server.ts. Claude Code reads the file into the conversation by itself; the other agents open it with their own tools.

Attach photos and filesCopy Anchor Link

• With a mouse: click + to pick files, drag files onto the chat, or paste an image with Ctrl V (⌘ V).
• On a phone or tablet: tap + for Photos, Files, Camera or Record video, or Paste an image you've copied.

Files upload as soon as you add them and show a percentage while they do. A failed upload says Retry; tap it. You can attach any kind of file, up to 500 MB each.

Claude Code and Codex see images directly. The other agents get the file's location on the computer and open it themselves.

Files back from the agentCopy Anchor Link

Agents can send you files too: screenshots, recordings, documents. Pictures and videos show right in the chat, and a tap opens them full screen. Other files show as a card you can download or open.

They can also draw diagrams. Mermaid diagrams appear as pictures you can zoom, with a Show source button.