What's in the Processes list

What a process is

Most commands an agent runs finish in a moment. Some keep running in the background until someone stops them. The most common is a development server: the program that serves your website at an address on your computer, such as http://localhost:3000, while you work on it. Others watch files for changes or carry out a long job.

Agents tell Enjoy about each one they start, so Enjoy can keep track of it. The servers of your project’s apps aren’t listed here: Enjoy runs those itself, and they’re in Apps. See What are apps? A server or watcher keeps running after the agent replies. If the agent is waiting on a long job, like a build or a test run, its conversation stays Working until the job ends and the agent reports back. Before starting a server, Enjoy asks agents to check the processes their conversation already started, so they can reuse one that’s still running. Some agents also report background tasks of their own, which appear here too.

Where to find it

• Select Processes, the icon button just above Project settings, near the bottom of the rail on the left side of the window. A number on it shows how many processes there are. On a phone, or in any narrow window, select Show sidebar at the top left first. You can also press ⌃5 on a Mac, or Alt+5 on Windows and Linux.
• Inside a conversation, a small processes button with a number appears in the message box’s toolbar when that conversation has processes. Select it to see them, then select one to open its details and output in a window over the conversation, so you keep your place. On the computer app, a process serving a website shows its address there too, with Open beside it to show the site next to the conversation.

What the list shows

Processes are grouped under the conversation that started them. Each row shows the process’s name and a dot for its status. On the computer app, when the process is serving a website, its address appears under its name, such as localhost:5173, with an Open button beside it. See Open a running website from Processes.

In a project inside WSL, the processes run in the project’s Linux distribution, and each address the process’s server listens at shows as its own button, under Addresses in its details. Select one to open it. An address marked Linux only is one Windows can’t reach: select it to read why. See An address says Linux only.

Type in Search processes… to find a process by its name, its conversation, or its details. Select a process to see:

• Its address under its name, for a process serving a website on the computer app. Select the copy button beside it to copy the full address, or select the address text yourself.
• A link to the conversation that started it.
• Open in browser, for a process serving a website on the computer app.
• Stop. See Stop a background process.
• Process details, with what the agent recorded about it, such as its folder, command, and address.
• Its Output. See Read a process’s output.

Statuses

• Running: Enjoy has confirmed the process is running on the computer.
• Stop requested…: Enjoy is stopping it.
• Couldn’t stop: stopping failed. The details say why.
• Needs checking: Enjoy can’t confirm the process is still running. Open it and look at its output. If it’s fine, select Mark as good. While any process needs checking, the top of the list shows how many, such as “2 to check”, with Mark all as good.

Enjoy tidies up on its own

Enjoy checks the processes every few seconds. When one exits, it disappears from the list without you doing anything.

• Completing a conversation doesn’t stop its processes. Your website keeps running.
• Deleting a conversation stops the processes it started. So does removing the project from Enjoy.
• Running processes don’t get in your way. You can still switch agents or models, delete conversations, and update Enjoy.
• Quitting Enjoy on a Mac or Linux computer can leave processes your agents registered running in the background, and Enjoy finds them again when you reopen it. On Windows, they end when their agent closes, except in a project inside WSL: there they keep running in the Linux distribution only while it runs. WSL usually stops it within about half a minute after you quit Enjoy, unless something else keeps it running, such as a terminal open there, and wsl --shutdown or restarting Windows stops it too.

When nothing is running, the list says Nothing running yet.

On the web app and the iPhone app

• Web app: the same list, details, output, and Stop. Opening a process’s website from Processes only works in the computer app. The site itself can still show beside its conversation. See See your site from the web app or your iPhone.
• iPhone app: open a conversation and select the processes button in the message box to see that conversation’s processes, follow their output, and stop them.