deskfish.
Website appearance
Get Deskfish
A little world. Now with more windows. Meet the app

Give your AI
its own computer.

An open-source agent with its own desktop, memory, and a little personality.
Tell it what you need. Watch it work through the glass.

Meet your Deskfish Watch it work 3 films
App, browser, or VS CodeBring your own modelApache 2.0
their little world,right next to yours.
deskfish — Visual Studio Code
Deskfish — DesktopSCRIPTED REPLAY
Desktop onReady Its own computer
about:blank
Opening the browser…
YOU

Give your fish a task…

Ready for a little errandLinux · sandboxed
01 / 05Give it a task

A scripted replay of our first errand. Watch the real recording

SMALL BY DESIGN. OPEN BY NATURE.
Your machine
Your model
Your call
01 / THE IDEAA desktop agent with a little personality.

A little less busywork.
A little more possibility.

Some tasks just need a patient pair of hands.
Deskfish opens the browser, follows the steps, and takes care of the clicking. All in a computer you can see.

01

Give it a task.

Write like you would to a colleague. Tell it where to go, what matters, and what done looks like.

YOUR WORDS → A PLAN
02

Watch it get to work.

It reads the page, looks at the screen, clicks, and types. A real browser and terminal, live in the app, your browser, or VS Code.

LOOK → THINK → ACT → LOOK
03

Step in. Hand back.

When it needs you, it knocks on the glass. Take the mouse, do your part, and let it carry on.

A HUMAN, WHEN IT MATTERS
02 / MAKE YOURSELF AT HOMESame fish. Same memory. A different window.

Three windows.
One little world.

Deskfish lives on the machine you choose.
How you spend time with it is up to you.

YOUR WAY IN / THE APP

A little place on your desktop.

Download Deskfish, open it, and give it a task. Close the window and it stays in the tray, working. When it needs you, a notification brings you back.

For Linux, macOS, and Windows. No editor needed.

Get to know the app
Deskfish Connected
DESKFISH

Compare the three hotels. Keep the ones with free cancellation.

I checked the cancellation terms. Here’s the shortlist, with the source links.

hotel-shortlist.mdReady to save
Remembered your preference
THE TANK
YOUR NEXT WEEKEND

A little room
to get away.

01
02
03

Three options. Free cancellation.

One shared conversation Illustrated example

A home that stays on. Run Deskfish on your laptop, a small computer at home, or your own server. Its desktop and memory live there; your windows simply connect.

FOR YOUR OTHER AGENT, TOO

A pair of hands for your coding assistant.

Through MCP, a coding agent can hand Deskfish an errand, follow its progress, read the result, and give feedback in the chat. You can watch and stop the work from any window.

Connect over MCP
03 / A PAIR OF HANDSFor all the “open the browser and…” tasks.

Hand off the little things.

And some surprisingly big ones.
Pick an errand. Imagine what you could do with the time.

A REAL DESKFISH FIRSTEXAMPLE PROMPT

Find a home on the web

Go to namecheap.com and buy deskfish.sh for yourself: one year, no add-ons. Stop before the final Pay button and knock.
How it works
01Find the domain and check availability
02Choose one year and skip the add-ons
03Get checkout ready and hand over at Pay
deskfish.shThe domain from our recorded demo

A little fish. Its very own domain.

Illustrative workflows. What an agent can complete depends on your model and the sites it visits.

04 / MEET THE TANK

Its own little world.
A clear boundary.

The tank is a sandboxed Linux desktop on the machine you choose. Its own browser, its own files, its own space to get things done.

The computer is theirs.

Firefox, a terminal, and a home folder that keeps logins and files between restarts.

Your files stay yours.

No host folder is mounted. You choose what crosses the glass with Attach and Save.

The mouse is always within reach.

Watch every step. Take over at any time. Hand back when you’re ready.

Get to know the boundary
THE TANKYOURS TO WATCH
The actual Deskfish Linux desktop, with the fish-in-a-monitor wallpaper and Firefox and Terminal in the dock
A LITTLE KNOCK ON THE GLASS

Deskfish needs you.

Something needs a human touch. Step in, then let it carry on.

Interactive handoff illustration
DEBIAN + OPENBOXPOWERED BY PODMAN OR DOCKER
THE THOUGHTFUL LITTLE DETAILS

More than a fresh pair of fins.

It can read the page.

Read page text directly and click a visible control by name in one step. Screenshots and zoom cover the rest.

Files go both ways.

Attach what it needs. Save what it makes. No shared folder required.

It reads its own manual.

Ask about Deskfish. It looks up the same documentation you use before answering.

Long jobs keep a ledger.

It keeps a summary as the conversation grows. After an interruption, the next task gets a note of where things stopped.

05 / A THREAD THAT CARRIES ONThe work ends. The story keeps going.

A computer of its own.
A little history, too.

The useful facts. The lesson from a difficult task. A page about who it is, written in its own voice. Deskfish carries these between conversations, so your next hello has a little more behind it.

ROOM TO GROWKept where your Deskfish lives
self.md

In its own words.

A small page about how it works, what it cares about, and the people it gets to know. Deskfish revises it during reflection; you can read it and talk about it together.

Read about who it is
A LOOK INSIDE
I do the job all the way through, and I say plainly what I did and what I did not. I check before I claim. A click that landed wrong is mine to notice and fix.
From the starting page that ships with every Deskfish.

Versions are kept. Signatures make outside edits noticeable.

A moment to reflect.

After a few tasks, Deskfish reviews its notes, saves what it learned, and may revise its page. A charter you can edit and a small library of readings give it something to think with. Changes stay folded in the chat, ready to open.

Pick up an earlier conversation. Reopen saved text chats in place, or continue with their transcript as context.Take the thread with you. Export its memory, history, playbooks, and chats to another installation.
06 / ON YOUR TIME

Good work has
a rhythm.

A report on Monday. A check at the end of the day. Give a task a time, and Deskfish comes back to it. Once, daily, weekly, or every few minutes.

Open Scheduled tasks, set when, and describe the work. Close the window; Deskfish keeps going in the background. Results arrive in a new chat, ready when you return.

Scheduled runs use guided mode and a $2 model budget by default, where costs are known. Set a different mode or budget for each schedule.

Find your rhythm
A LITTLE ROUTINEExamples
MON09:00

Start with the bigger picture.

Compare last week’s site traffic with the week before. Bring back the numbers and links.

Every Monday
DAILY17:00

Bring the report home.

Download today’s report from the dashboard and save it in Downloads.

Every day
EVERY90min

Check back when it’s time.

Visit the status page and tell me which services have an active incident.

At a regular interval

Keep Deskfish running and its machine awake. Busy tasks queue; missed times are skipped after a five-minute grace period by default. Enable start at login to bring it back after a restart.

And when the work needs a little waiting?

Standby watches for a screen change or waits out a timer locally. No repeated model calls while waiting. You see the reason and a countdown; Pause and Stop still work.

Meet standby
07 / YOUR CHOICE, ALWAYSThe desktop stays. The mind is up to you.

One tank.
Many kinds of smart.

Click Change next to Model. Choose a provider and a model, then add its key or sign in where supported. Your memory and playbooks stay with Deskfish when you change the model.

NATIVE COMPUTER USE

A familiar mind. A new pair of hands.

Connect directly to Anthropic’s computer-use API. Deskfish handles screenshots, actions, prompt caching, and conversation compaction.

Explore models and providers
IN ANY DESKFISH WINDOW
  1. Open Change next to Model.
  2. Choose Anthropic (direct), then a computer-use model.
  3. Enter that provider’s API key when prompted.

Choose a Claude model that supports computer use.

Prefer settings JSON?
VS CODE · USER SETTINGS
{
  "deskfish.provider": "anthropic",
  "deskfish.model": "<your-computer-use-model>",
  "deskfish.baseUrl": ""
}
Choose a Claude model that supports computer use.
No Deskfish subscription. API key, Grok sign-in, or a local model.Credentials stay with your Deskfish. Hosted inference goes to your chosen provider.
08 / THREE REAL RECORDINGS

Watch it work.
Through the glass.

Three unedited sessions, recorded in VS Code: the chat on the left, its own desktop on the right. It reads a timeline and drafts a post. It prices a trip. And on its first day, it bought this website’s address.

This website’s address was its first errand.

“‘AI’ is a category label; ‘.sh’ is a job description.”
— Deskfish, on keeping deskfish.sh.
REAL TIMENO AUDIONOTHING STAGED

Three real recordings · Real time · No audio

A FEW GOOD QUESTIONS

Curious?
Come closer.

There’s a whole manual

MAKE A LITTLE ROOM

Your AI’s next chapter
starts with a desk.

Choose your desktop app Latest release · app, extension, or server
AppImagedebdmgexeVS Code extensionnpm tarball
App installation guide
01

Give it a home.

Download and open the app. Prefer your editor? Install the extension with Install from VSIX… in VS Code.

02

Bring a mind.

Click Change next to Model. Choose a provider and model, then enter its key or use Grok sign-in.

03

Let it swim.

Turn on the tank. If you need Podman, Deskfish walks you through installation. Give your fish its first task.

In VS CodeInstall the extensionOn your own serverInstall the command, open the web pageAlready running?Connect from your browser

The app is unsigned. macOS and Windows builds still need testing on those systems. Read the installation notes

Early release. Built in the open, with plenty of room to grow.Prefer to build from source?