codus
← All documentation

Can my Brain send me a spreadsheet or document in chat?

Yes. In Codus 0.2.225 or later, a Brain can send you files in its chat, and you can send files to it. Ask in plain words, for example "send me that table as a spreadsheet". The file shows in the chat on your computer and in the Codus web app, and every file sent in any Brain chat is kept in the Brain's Files tab in the web app. Files are private to you until you turn on a public link.

Before you start

  • Update Codus on your computer to 0.2.225 or later through Settings → Updates, then fully quit and reopen it.
  • Sign in to the same Codus GitHub account on your computer and in the web app.
  • Keep Codus open on an awake computer. The Brain runs there, so it sends and receives files only while Codus is open.

Which files

Spreadsheets (xlsx, xls, csv, tsv), PDFs, Word documents (docx, doc), PowerPoint (pptx), text (txt, md, json) and zip archives, plus photos and videos. Each file can be up to 50 MB, and a message can carry up to 10 files.

Get a file from the Brain

  1. Ask the Brain for the file in its chat.
  2. On your computer, the file shows as a small card in the chat. Click Open to open it, or Show in Finder to see where it was saved.
  3. In the web app, open Brain, choose the Brain and tap Download on the file in the chat.

Send a file to the Brain

  1. In the web app, open Brain and choose the Brain. Tap Add files next to the message box and choose the files, or drag them onto the chat on a computer. Each shows above the message box; tap its ✕ to take it out.
  2. Write what you want done with it, then tap Send.

Your computer downloads the file into the Brain's folder and tells the Brain where it is. The Add files button appears only once your computer runs 0.2.225 or later; if the web app says to update Codus on your computer, do that first.

The Files tab and public links

In the web app, open Brain, choose the Brain and tap Files. It lists the files sent in that Brain's chat; All files lists everything sent in your Brain chats, on every computer. Search by file name, Download a file, Open the chat it came from, or Delete it.

Each file has a Public link switch. Turn it on and Copy link to give the file to someone without a Codus account: anyone with the link can download it. Turn it off and the link stops working; turn it on again and the file gets a new link, so the old one stays dead. New files at the top of the Files tab sets whether files added from now on start Private (the default) or with a Public link.

On your computer, a file card in a Brain chat has the same Public link switch and Copy link button.

How do I know it worked?

The file card shows in the chat on your computer and in the web app, and the file appears at the top of the Files tab. On your computer, a card that reads Sending to the Codus cloud has not finished uploading yet. If a card shows only Open and Show in Finder, the file stayed on your computer: check you are signed in to Codus, then ask the Brain to send it again.

Read as markdownUpdated 2026-11-12