Haruno Knowledge base

The message box

The box at the bottom of Chat. Type, attach files and folders, point at a file with @, run a Playbook with a slash, dictate by voice, and send or stop.

  • Mac appAvailableThe Permissions row of its plus menu is in the advanced view only.
  • Windows appAvailableDescribed on the Chat page, with Attachments and Slash commands.

The message box is where you write to Haruno. It sits at the bottom of Chat, and of the chat column beside other pages. Besides text it takes files, folders, Playbooks and your voice.

The parts

  • The plus button (Add Context), on the left. It opens a menu. See below.
  • The box. It says Message Haruno…. Drag the grip above it up or down to make it taller or shorter. Haruno remembers the height.
  • The microphone, on the right, when voice input is on offer. See below.
  • Send, which turns into Stop while Haruno works.

Return sends. Shift and Return together start a new line. ↑ on the first line brings back the message you sent before, and ↓ walks forward again. Your unfinished text comes back when you walk past the newest one. The full list of keys is in Keyboard shortcuts.

You can keep typing while Haruno works. Send waits until the reply is finished. The same is true while Haruno prepares its isolated space for the first time, or while an update installs: Send waits and your text is kept.

The plus button

The menu holds, from the top:

RowWhat it does
Attach File, Attach FolderGives Haruno a file or a folder to work with
Manage Playbooks…Opens the Playbooks window. See Playbooks
Recent PlaybooksThe Playbooks you used last. Pick one to put its command in the box
Project (name)Shows the project this chat is in. Pick another, or No project, to move it. See Chats in a project
Permissions (Auto)Advanced view only. Names the mode in force and lets you change it. See Permissions and approvals
New ChatStarts a new chat. Always the last row

The choices under Recent Playbooks and the project choices are off while Haruno is working.

Attach files and folders

There are three ways.

  • The menu. Attach File or Attach Folder.
  • Drag. Drop files or folders onto the box. It says Drop files to attach.
  • Paste. Copy files in Finder, or copy a picture, and paste into the box. A pasted picture is saved with the chat.

Each attachment shows as a small chip above the box, with a cross to remove it. Chips stay on the chat after you send, so Haruno keeps working with the same files in the next message. The crosses are off while Haruno is working, because it may be reading the file at that moment.

Haruno checks what a file really is, not only its name. Programs and shortcuts cannot be attached. The note says Programs and shortcuts can't be attached. If a check takes too long, the file is left out and the note says so. A folder is refused only if it is an application. A pasted picture that is very large is refused. The note says This image is too large to paste. Attach the original file instead.

Point at a file with @

Type @ and the first letters of a name. A list shows matching files and folders from the chat's working folder. Move with the arrow keys, then press Return or Tab to choose one, or click it. Esc closes the list. The name goes into your message as text. Choosing a name does not send the message and does not attach the file. If nothing matches, the list says No matching files.

Run a Playbook with a slash

Type / at the very start of the message. A list of your Playbooks appears. Choose one the same way. Its command goes into the box. Add any words you like after it and press Return. A slash anywhere else in the message is just text. See Playbooks.

Dictate

Click the microphone and speak. A waveform and a timer show while it listens. Click again to stop. The words appear in the box, ready for you to read and send. A recording stops by itself after a minute.

  • The recording is sent to Haruno's transcription service to be turned into text, then discarded. Haruno records only while the microphone is on.
  • You have to be signed in. If you are not, the button is off, and hovering says Sign in to use voice input. Open Settings (⌘,).
  • The first time, macOS asks to allow the microphone. If you said no, Haruno says Haruno can't use the microphone. Allow it in System Settings ▸ Privacy & Security ▸ Microphone.

Who has it

Everyone, in the normal view and the advanced view. The Permissions row is the advanced view only.

What to tell a customer

The box takes what people already do: type, drag a file in, paste a screenshot, or talk. Anything attached is checked first, and programs are never let in.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,83 @@
    +---
    +title: The message box
    +summary: The box at the bottom of Chat. Type, attach files and folders, point at a file with @, run a Playbook with a slash, dictate by voice, and send or stop.
    +feature: composer
    +covers:
    +  - apple/Sources/ChatUI/Composer.swift
    +  - apple/Sources/ChatUI/AttachmentChips.swift
    +  - apple/Sources/ChatUI/AttachmentImportStatus.swift
    +  - apple/Sources/ChatUI/ComposerPasteboard.swift
    +  - apple/Sources/ChatUI/MentionPickerView.swift
    +  - apple/Sources/ChatUI/PickerPanel.swift
    +  - apple/Sources/ChatUI/VoiceInputButton.swift
    +  - apple/Sources/ChatUI/VoiceRecordingStrip.swift
    +  - apple/Sources/ChatFeature/ChatModel+Attachments.swift
    +  - apple/Sources/ChatFeature/ChatModel+ClipboardAttachments.swift
    +  - apple/Sources/ChatFeature/ChatModel+Voice.swift
    +  - apple/Sources/ChatFeature/MentionController.swift
    +  - apple/docs/file-ingestion.md
    +---
    +
    +The message box is where you write to Haruno. It sits at the bottom of Chat, and of the chat column beside other pages. Besides text it takes files, folders, Playbooks and your voice.
    +
    +## The parts
    +
    +- **The plus button** (<Ui>Add Context</Ui>), on the left. It opens a menu. See below.
    +- **The box.** It says <Ui>Message Haruno…</Ui>. Drag the grip above it up or down to make it taller or shorter. Haruno remembers the height.
    +- **The microphone**, on the right, when voice input is on offer. See below.
    +- **Send**, which turns into **Stop** while Haruno works.
    +
    +<Ui>Return</Ui> sends. <Ui>Shift</Ui> and <Ui>Return</Ui> together start a new line. <Ui>↑</Ui> on the first line brings back the message you sent before, and <Ui>↓</Ui> walks forward again. Your unfinished text comes back when you walk past the newest one. The full list of keys is in [Keyboard shortcuts](/macos/app/keyboard-shortcuts/).
    +
    +You can keep typing while Haruno works. Send waits until the reply is finished. The same is true while Haruno prepares its isolated space for the first time, or while an update installs: Send waits and your text is kept.
    +
    +## The plus button
    +
    +The menu holds, from the top:
    +
    +| Row | What it does |
    +|---|---|
    +| <Ui>Attach File</Ui>, <Ui>Attach Folder</Ui> | Gives Haruno a file or a folder to work with |
    +| <Ui>Manage Playbooks…</Ui> | Opens the Playbooks window. See [Playbooks](/macos/chat/playbooks/) |
    +| <Ui>Recent Playbooks</Ui> | The Playbooks you used last. Pick one to put its command in the box |
    +| <Ui>Project (name)</Ui> | Shows the project this chat is in. Pick another, or <Ui>No project</Ui>, to move it. See [Chats in a project](/macos/chat/project-chats/) |
    +| <Ui>Permissions (Auto)</Ui> | Advanced view only. Names the mode in force and lets you change it. See [Permissions and approvals](/macos/safety/permissions/) |
    +| <Ui>New Chat</Ui> | Starts a new chat. Always the last row |
    +
    +The choices under <Ui>Recent Playbooks</Ui> and the project choices are off while Haruno is working.
    +
    +## Attach files and folders
    +
    +There are three ways.
    +
    +- **The menu.** <Ui>Attach File</Ui> or <Ui>Attach Folder</Ui>.
    +- **Drag.** Drop files or folders onto the box. It says <Ui>Drop files to attach</Ui>.
    +- **Paste.** Copy files in Finder, or copy a picture, and paste into the box. A pasted picture is saved with the chat.
    +
    +Each attachment shows as a small chip above the box, with a cross to remove it. Chips stay on the chat after you send, so Haruno keeps working with the same files in the next message. The crosses are off while Haruno is working, because it may be reading the file at that moment.
    +
    +Haruno checks what a file really is, not only its name. Programs and shortcuts cannot be attached. The note says <Ui>Programs and shortcuts can't be attached.</Ui> If a check takes too long, the file is left out and the note says so. A folder is refused only if it is an application. A pasted picture that is very large is refused. The note says <Ui>This image is too large to paste. Attach the original file instead.</Ui>
    +
    +## Point at a file with @
    +
    +Type <Ui>@</Ui> and the first letters of a name. A list shows matching files and folders from the chat's working folder. Move with the arrow keys, then press <Ui>Return</Ui> or <Ui>Tab</Ui> to choose one, or click it. <Ui>Esc</Ui> closes the list. The name goes into your message as text. Choosing a name does not send the message and does not attach the file. If nothing matches, the list says <Ui>No matching files</Ui>.
    +
    +## Run a Playbook with a slash
    +
    +Type <Ui>/</Ui> at the very start of the message. A list of your Playbooks appears. Choose one the same way. Its command goes into the box. Add any words you like after it and press <Ui>Return</Ui>. A slash anywhere else in the message is just text. See [Playbooks](/macos/chat/playbooks/).
    +
    +## Dictate
    +
    +Click the microphone and speak. A waveform and a timer show while it listens. Click again to stop. The words appear in the box, ready for you to read and send. A recording stops by itself after a minute.
    +
    +- The recording is sent to Haruno's transcription service to be turned into text, then discarded. Haruno records only while the microphone is on.
    +- You have to be signed in. If you are not, the button is off, and hovering says <Ui>Sign in to use voice input. Open Settings (⌘,).</Ui>
    +- The first time, macOS asks to allow the microphone. If you said no, Haruno says <Ui>Haruno can't use the microphone. Allow it in System Settings ▸ Privacy & Security ▸ Microphone.</Ui>
    +
    +## Who has it
    +
    +Everyone, in the normal view and the advanced view. The <Ui>Permissions</Ui> row is the advanced view only.
    +
    +## What to tell a customer
    +
    +The box takes what people already do: type, drag a file in, paste a screenshot, or talk. Anything attached is checked first, and programs are never let in.