Haruno Knowledge base

Chat

Ask Haruno about a company, a file or a task in a conversation you can come back to. This page covers the message box, sending and stopping, and what Haruno shows while it works.

  • Mac appAvailable
  • Windows appAvailable

Chat is where you talk to Haruno. Open Chat in the navigation pane (Ctrl+1 by default). Every chat belongs to the project that is open, and you can find it again later in History.

A conversation: your message, Haruno's answer, and the cards Haruno shows when it needs a decision from you.
A chat with one request from the person, Haruno's short answer, an approval card and a question card, and the message box at the bottom.A chat with one request from the person, Haruno's short answer, an approval card and a question card, and the message box at the bottom.

Writing a message

The message box. The paperclip attaches files, and the arrow sends.
The message box with a typed request, a paperclip button and a send button, under the last messages of a chat.The message box with a typed request, a paperclip button and a send button, under the last messages of a chat.
  • Type in the box and press Enter to send. Shift+Enter starts a new line.
  • The box grows as you type. Drag its top edge to make it taller.
  • Press Up on the first line to bring back a message you sent earlier in this project. Down moves forward again.
  • Type @ and the start of a file name to mention a file from your project. Pick it with Enter or Tab. Esc closes the list. A mention is just text in your message. It is not an attachment.
  • Type / at the start of a message to pick a Playbook. See Slash commands. When a Playbook ran successfully, a line above the answer reads Used Playbook · title. Click it to open that Playbook.
  • Use the paperclip to attach files and folders. See Attachments.
  • The microphone button (Voice input) records you. Press it again to stop. Haruno turns the recording into text and puts it in the message box. It does not send it. Recording stops by itself after a minute.

Describe the result you want, not only the steps. "Summarize the meeting notes in this folder as a table" works better than "open the files".

Sending and stopping

The arrow sends your message. While Haruno works, it turns into Stop. Ctrl+. does the same by default. A line above the box says what Haruno is doing, for example "Thinking". If nothing has arrived for a while, the line tells you that too.

The bar at the bottom of the window is the status line. It shows Ready with a coloured dot, and short notices such as "Chat copied to clipboard". If you are on another page while a chat is working, it shows a spinner there too.

What Haruno shows you

  • Replies appear in the conversation. A Thinking row can be opened to read how Haruno reasoned.
  • Files Haruno writes appear as a card with Preview, Open, Reveal in Explorer and Copy path.
  • The steps behind an answer go to the side panel. Open it from the View menu or with Ctrl+Alt+0. Activities lists every step, the Playbooks the session used, the helpers Haruno started and the sources it used. Preview shows documents as they are written.
  • Questions appear as cards you answer with a click. See When Haruno asks you something.
  • Approval cards appear before Haruno does something that needs your OK, such as running a command. They offer Allow once, Allow for this session and Deny. See Approvals and permission modes.

To work with what you have already said, see Working with messages.

When Haruno cannot answer

What you seeWhat it means
"Sign in to start chatting." with Open SettingsYou are not signed in.
"Usage limit reached. To continue now, add credit or change your plan in the Haruno dashboard." with Open dashboardThe plan's allowance is used up. A version of this message says when it resets, in minutes or hours.
"Payment required. Update your billing in the Haruno dashboard."The plan needs attention in the dashboard.
"Couldn't reach Haruno. Check your connection and try again."The connection failed.
"This chat can't reach …"Haruno asked for a folder outside the ones it was given. Inside a project, a Share this folder… button asks you to confirm before anything is shared. See Which files Haruno can reach.
Advanced view

In the advanced view, the message box also has an Agent or Ask switch and a permission mode menu. The normal view shows neither.

Text size and new chats

Make chat text larger or smaller in Settings ▸ General ▸ Chat zoom, or hold Ctrl and scroll in the chat. Ctrl+0 resets it. File ▸ New Chat (Ctrl+Shift+N by default) starts a fresh conversation.

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

History (2 versions)
  1. Windows Playbooks: built-in and learned lists, Keep as mine, used-Playbook lines (#2856) (#2878)
    What changed
    @@ -22,7 +22,7 @@ Chat is where you talk to Haruno. Open **Chat** in the navigation pane (Ctrl+1 b
     - The box grows as you type. Drag its top edge to make it taller.
     - Press **Up** on the first line to bring back a message you sent earlier in this project. **Down** moves forward again.
     - Type **@** and the start of a file name to mention a file from your project. Pick it with **Enter** or **Tab**. **Esc** closes the list. A mention is just text in your message. It is not an attachment.
    -- Type **/** at the start of a message to pick a [Playbook](/windows/chat/playbooks/). See [Slash commands](/windows/chat/slash-commands/).
    +- Type **/** at the start of a message to pick a [Playbook](/windows/chat/playbooks/). See [Slash commands](/windows/chat/slash-commands/). When a Playbook ran successfully, a line above the answer reads **Used Playbook · title**. Click it to open that Playbook.
     - Use the paperclip to attach files and folders. See [Attachments](/windows/chat/attachments/).
     - The microphone button (**Voice input**) records you. Press it again to stop. Haruno turns the recording into text and puts it in the message box. It does not send it. Recording stops by itself after a minute.
     
    @@ -38,7 +38,7 @@ The bar at the bottom of the window is the status line. It shows **Ready** with
     
     - **Replies** appear in the conversation. A **Thinking** row can be opened to read how Haruno reasoned.
     - **Files** Haruno writes appear as a card with **Preview**, **Open**, **Reveal in Explorer** and **Copy path**.
    -- **The steps behind an answer** go to the [side panel](/windows/chat/side-panel/). Open it from the **View** menu or with Ctrl+Alt+0. **Activities** lists every step, the helpers Haruno started and the sources it used. **Preview** shows documents as they are written.
    +- **The steps behind an answer** go to the [side panel](/windows/chat/side-panel/). Open it from the **View** menu or with Ctrl+Alt+0. **Activities** lists every step, the Playbooks the session used, the helpers Haruno started and the sources it used. **Preview** shows documents as they are written.
     - **Questions** appear as cards you answer with a click. See [When Haruno asks you something](/windows/chat/questions-from-haruno/).
     - **Approval cards** appear before Haruno does something that needs your OK, such as running a command. They offer **Allow once**, **Allow for this session** and **Deny**. See [Approvals and permission modes](/windows/safety/approvals-and-permission-modes/).
     
    
  2. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,63 @@
    +---
    +title: Chat
    +summary: Ask Haruno about a company, a file or a task in a conversation you can come back to. This page covers the message box, sending and stopping, and what Haruno shows while it works.
    +feature: chat
    +covers:
    +  - windows-client/haruno-webview/web/src/pages/ChatPage.tsx
    +  - windows-client/haruno-webview/web/src/components/chat/**
    +  - windows-client/haruno-webview/web/src/components/StatusBar.tsx
    +  - windows-client/Haruno.Desktop.ViewModels/ChatViewModel.cs
    +  - windows-client/Haruno.Desktop.Services/Chat/ChatInputHistoryService.cs
    +---
    +
    +Chat is where you talk to Haruno. Open **Chat** in the navigation pane (Ctrl+1 by default). Every chat belongs to the project that is open, and you can find it again later in [History](/windows/chat/history/).
    +
    +<Shot src="/m/68515c122ce4-windows-chat-conversation-light.png" dark="/m/1926883cbe88-windows-chat-conversation-dark.png" alt="A chat with one request from the person, Haruno's short answer, an approval card and a question card, and the message box at the bottom." caption="A conversation: your message, Haruno's answer, and the cards Haruno shows when it needs a decision from you." />
    +
    +## Writing a message
    +
    +<Shot src="/m/746fc42da130-windows-chat-composer-light.png" dark="/m/5630f8705093-windows-chat-composer-dark.png" alt="The message box with a typed request, a paperclip button and a send button, under the last messages of a chat." caption="The message box. The paperclip attaches files, and the arrow sends." />
    +
    +- Type in the box and press **Enter** to send. **Shift+Enter** starts a new line.
    +- The box grows as you type. Drag its top edge to make it taller.
    +- Press **Up** on the first line to bring back a message you sent earlier in this project. **Down** moves forward again.
    +- Type **@** and the start of a file name to mention a file from your project. Pick it with **Enter** or **Tab**. **Esc** closes the list. A mention is just text in your message. It is not an attachment.
    +- Type **/** at the start of a message to pick a [Playbook](/windows/chat/playbooks/). See [Slash commands](/windows/chat/slash-commands/).
    +- Use the paperclip to attach files and folders. See [Attachments](/windows/chat/attachments/).
    +- The microphone button (**Voice input**) records you. Press it again to stop. Haruno turns the recording into text and puts it in the message box. It does not send it. Recording stops by itself after a minute.
    +
    +Describe the result you want, not only the steps. "Summarize the meeting notes in this folder as a table" works better than "open the files".
    +
    +## Sending and stopping
    +
    +The arrow sends your message. While Haruno works, it turns into **Stop**. Ctrl+. does the same by default. A line above the box says what Haruno is doing, for example "Thinking". If nothing has arrived for a while, the line tells you that too.
    +
    +The bar at the bottom of the window is the status line. It shows **Ready** with a coloured dot, and short notices such as "Chat copied to clipboard". If you are on another page while a chat is working, it shows a spinner there too.
    +
    +## What Haruno shows you
    +
    +- **Replies** appear in the conversation. A **Thinking** row can be opened to read how Haruno reasoned.
    +- **Files** Haruno writes appear as a card with **Preview**, **Open**, **Reveal in Explorer** and **Copy path**.
    +- **The steps behind an answer** go to the [side panel](/windows/chat/side-panel/). Open it from the **View** menu or with Ctrl+Alt+0. **Activities** lists every step, the helpers Haruno started and the sources it used. **Preview** shows documents as they are written.
    +- **Questions** appear as cards you answer with a click. See [When Haruno asks you something](/windows/chat/questions-from-haruno/).
    +- **Approval cards** appear before Haruno does something that needs your OK, such as running a command. They offer **Allow once**, **Allow for this session** and **Deny**. See [Approvals and permission modes](/windows/safety/approvals-and-permission-modes/).
    +
    +To work with what you have already said, see [Working with messages](/windows/chat/working-with-messages/).
    +
    +## When Haruno cannot answer
    +
    +| What you see | What it means |
    +|---|---|
    +| "Sign in to start chatting." with **Open Settings** | You are not signed in. |
    +| "Usage limit reached. To continue now, add credit or change your plan in the Haruno dashboard." with **Open dashboard** | The plan's allowance is used up. A version of this message says when it resets, in minutes or hours. |
    +| "Payment required. Update your billing in the Haruno dashboard." | The plan needs attention in the dashboard. |
    +| "Couldn't reach Haruno. Check your connection and try again." | The connection failed. |
    +| "This chat can't reach …" | Haruno asked for a folder outside the ones it was given. Inside a project, a **Share this folder…** button asks you to confirm before anything is shared. See [Which files Haruno can reach](/windows/safety/file-access/). |
    +
    +<Callout variant="info" title="Advanced view">
    +In the advanced view, the message box also has an **Agent** or **Ask** switch and a permission mode menu. The normal view shows neither.
    +</Callout>
    +
    +## Text size and new chats
    +
    +Make chat text larger or smaller in **Settings ▸ General ▸ Chat zoom**, or hold Ctrl and scroll in the chat. Ctrl+0 resets it. **File ▸ New Chat** (Ctrl+Shift+N by default) starts a fresh conversation.