Files & uploads

Gosper doesn’t just talk about your files — it actually works with them. Hand it a spreadsheet, a PDF, a folder of images, or a full-length video, and Gosper can open it, read it, run code against it, transform it, and hand you back the result. This page shows you how to get files (even big ones) to the agent and what it can do once they’re there.

How files work with Gosper

When you share a file, it lands in a private workspace that belongs to your conversation. Think of it as a clean desk that only your agent can see.

From there, Gosper can do real work on it: read the contents, edit them, run code in a secure sandbox to process the file, and save new files back to the same workspace. Anything it produces — a cleaned-up dataset, a converted video, a generated chart — stays in that workspace so you can grab it when it’s done.

You don’t need to tell Gosper how to handle a file. Just describe the outcome you want, and it figures out the steps.

Uploading a file

The simplest way to give Gosper a file is to attach it to your message, then describe what you’d like done.

A few examples of what you might say:

• “Here’s a CSV of last month’s sales. Find the top 10 products by revenue and chart them.”
• “Clean up this contact list — remove duplicates and fix the formatting.”
• “Summarize this 40-page PDF into one page of bullet points.”
• “Convert these PNGs to a single optimized PDF.”

Gosper opens the file, does the work in its sandbox, and replies with the result — often including a new file you can download.

Common formats all work well: documents (PDF, Word, text, Markdown), spreadsheets and data (CSV, Excel, JSON), images, audio, code, and archives. If you’re not sure whether something is supported, just upload it and ask — Gosper will tell you what it can do with it.

Uploading large videos

Large videos are fully supported, and you don’t have to worry about the size. Big uploads are handled in pieces, so a long, high-resolution video transfers reliably instead of failing partway through. Once it arrives, Gosper confirms the file is complete before it starts working.

Things you can ask Gosper to do with a video:

• “Transcribe this video and give me the transcript with timestamps.”
• “Pull out a highlight clip from the most interesting two minutes.”
• “Extract one frame every 10 seconds and tell me when the speaker changes slides.”
• “Compress this 4K recording down to something I can email.”
• “Add captions and re-export it.”

Because video work can take a while, Gosper may run it as a background task. That means you don’t have to sit and wait — the agent keeps working on its own, and you can check back later or ask for a status update. You can keep chatting about other things in the meantime.

Bringing in files from other services

Files don’t always live on your computer. If something is already in cloud storage or another app, you can often point Gosper straight to it instead of downloading and re-uploading.

You can:

• Share a link. Paste a direct link to a file and ask Gosper to fetch and work with it.
• Connect an account. Gosper can link to external services you use — like cloud drives and media platforms — and pull files in (or publish results out) on your behalf. The first time it needs access, it’ll walk you through authorizing the connection.

For example: “Grab the latest export from my drive and turn it into a summary report,” or “Take this video, add a title card, and upload the finished version to my channel.”

Getting your results back

When Gosper finishes, any files it created are waiting for you in the conversation’s workspace, and it’ll point you to them in its reply. You can download the output, ask for changes (“make the chart blue and re-export”), or feed it into the next step of a larger task.

Because everything stays in one workspace per conversation, the agent keeps context across steps. Upload a raw video, get a transcript, then say “now make a 5-bullet summary of that transcript” — Gosper already has the file and knows exactly what you mean.

Tips for best results

• Name the file when it matters. If you’ve shared several files, refer to them by name so Gosper works on the right one.
• Describe the outcome, not the mechanics. “Find the three months with the lowest sales” works better than trying to spell out each step.
• Expect big jobs to run in the background. Long videos and heavy processing may take time. That’s normal — ask for a status update whenever you like.
• Iterate freely. The file stays available, so you can refine the result over several messages without re-uploading.

Whether it’s a quick spreadsheet tweak or a full-length video to transcribe and repackage, you can hand it to Gosper and let it do the work. Go ahead and upload something — then just tell it what you want.