Chat Feature

You can use the chat panel to chat with information from Xcode and the project.

Note

To setup the chat feature, please refer to the Chat Feature Setup Guide.

Configurations

You can configure the chat feature in the two places:

1. Feature -> Chat section in the host app.
2. The context menu of the chat window tab.

Contexts

By default, the chat feature will not have any context.

You can add contexts by clicking the + button next to the input field. Or by typing @context in the chat input, the app will show the context list as you type.

To configure each context, you can click the context name in the context list.

Pinned Contexts

If you add a context by clicking the + button next to the input field, the context will be persisted across the chat sessions. You can also delete the context by clicking the x button in the context list.

Temporary Contexts

If you add a context by typing @context in the chat input, the context will be a temporary context. The context will be removed after you send a message.

You can also pin the context by clicking the pin button in the context list.

Recipients

You can add recipients to the chat by typing @recipient in the chat input, the app will show the recipient list as you type. You can use the following built-in recipients:

Recipient	Description
@casual	The casual conversation. It can only access @web and @topic contexts.

Commands

You can add a command to the chat by typing /command in the chat input, the app will show the command list as you type. Here are the commands you can use:

Command	Description
/run	Run a shell command
/shortcut(name)	Run a shortcut that you have in the Shortcuts app

Code Blocks

When the agent sends you a code block in the markdown format, it will be rendered in the chat.

Copy Button

You can copy the code block by clicking the copy button in the code block. You can also drag the copy button to the file tree in Xcode to create a new file with the code block content.

Apply/Create Button

You can use the apply button to apply the code block to the current file. When the button is clicked, the app will open the modification panel and apply the code block to the file.

If the agent is able to detect the file path, the app will automatically apply the code block to the file by default. But you can also choose where to apply the code block.

If the agent is able to detect the file path, but the file doesn’t exist, the app will show the create button. When the button is clicked, the app will open the creation panel and create a new file with the code block content.

Tip

You are recommended to create the file by dragging the copy button to the file tree in Xcode.

Run Button

If the code block is a shell command or AppleScript, you can click the run button to run the command or script.