Working with the agent

Gosper is an autonomous AI agent. You give it a goal in plain language, and it figures out the steps, does the work, and brings back the results. Under the hood it can write and run real code in a secure sandbox, use external tools and your connected accounts, work on long jobs in the background, and handle files and videos you upload — but you don’t have to think about any of that. You mostly just describe what you want.

This page shows you how to ask for things well, start work that runs on its own, follow along, and collect what comes back.

How working with Gosper feels

You have one ongoing conversation with Gosper, the same way you’d work with a capable teammate. You can ask a quick question, hand off a big project, check in later, and pick the thread back up — it all happens in the same place, and Gosper remembers the context as you go.

When you give Gosper a goal, it doesn’t just answer — it acts. It can break a request into steps, run scripts to crunch data, pull information from tools you’ve connected, and keep going until the goal is met. Your job is mostly to be clear about what you want and what “done” looks like. Gosper handles the how.

Two ways to work: a quick chat or a background task

There are two modes, and picking the right one makes a big difference.

Send a message when you want to go back and forth — quick questions, small jobs, or anything where you want to see a result and react to it right away. Gosper replies in the conversation, and you can keep refining.

“Write a Python script that reads this CSV and gives me the average order value per month, then run it on the file I just uploaded.”

Start a task when the work is bigger, will take a while, or should run on its own while you do other things. Gosper takes the goal, makes a plan, and works through it in the background — even across many steps. You can close the tab and check back later.

“Pull last quarter’s sales data, build a month-over-month trend report with charts, and write a one-page summary I can send to the team.”

A good rule of thumb: if you’d happily wait a few seconds for an answer, send a message. If you’d rather walk away and come back to a finished result, start a task.

Writing a great goal

The clearer your goal, the better the result. You don’t need to write the steps — Gosper plans those — but a strong request usually has four things:

1. The outcome you want — what should exist when this is done.
2. What “good” looks like — format, length, tone, or success criteria.
3. The inputs — files to use, accounts to pull from, or links to start with.
4. Any constraints — deadlines, things to avoid, must-haves.

Here’s the difference in practice:

Instead of: “Look at my sales data.”

Try: “Using the spreadsheet I uploaded, find the three products with the biggest drop in sales since January and explain the likely cause for each in two or three sentences. Give it back as a short bulleted list.”

Instead of: “Make a report.”

Try: “Build a weekly performance report as a PDF: a summary paragraph up top, then a table of key metrics, then one chart of revenue over time. Keep it under two pages and write it for a non-technical audience.”

You don’t have to get it perfect on the first try. Gosper will often ask a clarifying question when something is ambiguous, and you can always steer it mid-way. But a little detail up front saves a lot of back-and-forth.

A few habits that consistently help:

• State the goal, not the keystrokes. “Find the top customers by lifetime value” beats “open the file, sort column D, then…”
• Say how you’ll judge success. “It should match the totals in the invoice” gives Gosper something to check itself against.
• Name the tool or account if it matters. “Post this to my YouTube channel” or “save the file to my Google Drive.”
• Bring the inputs. Attach the file, paste the link, or point to the data. Gosper works best with something concrete to act on.

Kicking off long-running background work

Some goals take many steps — gathering data from several places, processing a large file, running something that takes minutes rather than seconds. That’s exactly what background tasks are for.

When you start a task, Gosper writes itself a plan (a checklist of what it intends to do) and starts working through it. You don’t have to stay and watch. It keeps going on its own, and it can even work on several parts at the same time when that speeds things up — for example, researching five topics in parallel and then combining them into one summary.

“Research the top five competitors in the home-espresso market. For each one, find pricing, key features, and recent customer complaints. Then put it all into a single comparison table and tell me where there’s a gap we could fill.”

Gosper will tackle the competitors concurrently and fold everything into one result when it’s finished. You can keep chatting, start other tasks, or step away entirely.

Following progress

You’re never left guessing. There are a few ways to keep tabs on a running task:

• Watch it live. If you stay in the conversation, you’ll see Gosper’s progress stream in as it works — what it’s doing and what it’s finding.
• Check its plan. For tasks, Gosper keeps a running checklist and updates it as steps are completed, so you can see what’s done and what’s left.
• Ask for a status update anytime. Come back hours later and you can see the current state of everything Gosper is working on — what’s still running, what’s finished, and what’s waiting on you.

If you ever want to redirect a task that’s already running, just say so in the conversation. Gosper can take new guidance mid-flight — “actually, focus only on the EU market” — without starting over.

And if you change your mind entirely, you can cancel a task at any time. Cancelling stops the task and any sub-jobs it spun off.

Working with files and videos

You can upload files for Gosper to work with — spreadsheets, documents, datasets, images, and videos. Once something is uploaded, just refer to it in your request and Gosper will use it.

“Clean up the contact list I uploaded — remove duplicates and fix the inconsistent date formats — and give me back a tidy CSV.”

Videos work the same way. Gosper can take a video you’ve provided, process it, and deliver it where you need it.

“Take the video I uploaded, generate a title and description for it, and upload it to my YouTube channel.”

When Gosper produces something — a report, a cleaned dataset, a chart, a finished video — it comes back as a result you can download. You’ll get the finished files in the conversation, ready to grab.

Connecting your other tools and accounts

Gosper can do more than work in isolation — it can act on your behalf in the apps and services you already use, like YouTube, Gmail, Google Drive, and cloud storage. To do that, it needs your permission first.

When a goal requires one of these, Gosper will walk you through connecting the account, with a secure authorization step that you approve. Once connected, it can use that tool for this and future tasks.

“Find the three most recent invoices in my Gmail, pull out the amounts and due dates, and put them in a spreadsheet.”

You stay in control of what’s connected, and Gosper only uses an account when your goal actually calls for it.

Staying in control with approvals

For anything sensitive or hard to undo — sending an email, publishing publicly, spending against a budget — Gosper will pause and ask for your approval before going ahead. You’ll see what it’s about to do, and the task waits for your yes or no.

This means you can hand off ambitious goals without worrying that Gosper will do something irreversible behind your back. It moves fast on the safe steps and checks in on the consequential ones.

Getting your results

When Gosper finishes, it brings the result back into your conversation: an answer, a summary, and any files it produced, ready to download. For a background task, that’s your signal it’s done — and you can follow up right there if you want a revision.

“Great — now make the same report but for the previous quarter, and shorten the summary to three bullet points.”

Because it’s all one continuous conversation, follow-ups like this are cheap. Gosper already has the context, so refining a result is usually a quick message away.

Quick reference

• Quick, interactive work? Send a message and go back and forth.
• Big or long-running job? Start a task and let it run in the background.
• Want a great result? Say what the outcome is, what “done” looks like, and bring the inputs.
• Need it to use your accounts? Mention the tool; Gosper will help you connect it securely.
• Curious how it’s going? Watch live, check the plan, or ask for a status update.
• Changed your mind? Steer it mid-task, or cancel anytime.
• Worried about risky steps? Gosper pauses for your approval before anything sensitive.

Start simple, be clear about what you want, and let Gosper handle the rest. The more you work with it, the more you’ll learn just how much you can hand off.