How do I message the Brain and send files or screenshots?
Open the Brain's session and choose Agent or Chat at the bottom. Agent shows the selected provider's terminal; Chat is an easier-to-read conversation with the same Brain, not a second worker. You can type a request, attach a file or paste a screenshot.
Before you start
Choose an installed provider and complete its sign-in. If the drawer asks you to install a supported coding agent, follow the setup guide. Brain is not restricted to Claude Code.
Files must be accessible on the computer running the Brain. Adding a local file reference is not a cloud backup and does not make that file available on another computer.
Send a request
- Select the correct Brain tab, then session.
- Choose Chat for a text conversation or Agent for the full terminal.
- Click the input, type your request and use Enter to send. Use Shift+Enter for a new line in the composer; follow the active provider's controls when interacting directly with its terminal.
- If the terminal shows a sign-in, trust or selection prompt, answer that prompt there. Terminal menus may use arrow keys and Enter rather than mouse clicks.
A quiet Chat view is not proof that the underlying agent has stopped; check Agent for progress or an unanswered prompt.
Get back to the newest output
In Codus 0.2.204 or later, when you scroll up in the Brain's Agent terminal, a small down-arrow button appears at the bottom right of the terminal (tooltip Scroll to the latest output). Click it to jump straight back to the newest output. It works with Claude and with Codex. The button disappears once you are back at the bottom.
Scrolling in the Brain also keeps working after you switch provider or restart the Brain in Codus 0.2.204 or later.
Attach files and images
- Drag the file from Finder on Mac or File Explorer on Windows into the input.
- Check that its attachment or file reference appeared. A path identifies the file; it does not prove the agent has opened it.
- Add what you want done with the file and send the request.
- For an image on the clipboard, focus the input and paste using your platform's paste shortcut. Check the image attachment before sending.
Share only files you intend the selected provider to process. Redact passwords, tokens and unrelated customer information from screenshots.
For a photo on your phone, select the intended Brain and use the camera button in its bottom bar (tooltip Send a photo from your phone to this Brain). Scan the QR code and add a note on your phone. See sending a phone photo to a Brain or quadrant for submitting immediately, leaving it in the input and checking receipt.
Keep or change the conversation
Hiding the drawer leaves running Brains alone. Quitting Codus stops local work; reopening a saved conversation does not restart its dev servers or workers automatically. Confirm those restarts with the Brain.
Changing provider or model is a separate operation. Follow provider and model selection and wait for confirmation instead of repeatedly switching.
If the terminal reports that its process exited or failed to start, keep the error text, check that provider's installation and sign-in, then follow the displayed recovery instruction. Do not delete the Brain tab to fix a temporary connection error.
How do I know it worked?
Your request appears in the conversation and the Brain acknowledges it. For a file, ask the Brain to confirm what it can read; an attachment alone is not proof the file was processed.