> ## Documentation Index
> Fetch the complete documentation index at: https://mcpjam-mintlify-docs-update-pr-3305-1784516603326.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Computer

> A personal cloud Linux workstation for your project — open a terminal, run tools, and give your agents a real bash environment

Each project gives every member an opt-in **Computer**: a personal cloud Linux
workstation with a web terminal and a `bash` tool your agents can call. It boots
from a base image (Debian + Node + Python) or a custom [environment](#environments)
you define, sleeps automatically after about 30 minutes idle or shortly after
you close the terminal, and wakes on next use.

Open it from the **Computer** tab. The first time you open the terminal, MCPJam
provisions the machine; after that it resumes in about a second.

## Agent tools

When the **Computer** tab is open, agents have access to four tools for managing
the computer's lifecycle. These tools are only available while you are on the
Computer screen and require a signed-in project.

| Tool                    | What it does                                                                                                                                                              |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ui_start_computer`     | Provisions the computer on first use, or wakes it if it is asleep. Counts against the daily start cap — a cap rejection is returned as an error and the start is refused. |
| `ui_hibernate_computer` | Puts the computer to sleep immediately. Non-destructive: files and state are preserved.                                                                                   |
| `ui_reset_computer`     | Resets the computer to its image, **wiping all files**. Requires confirmation.                                                                                            |
| `ui_delete_computer`    | Tears the computer down entirely, **deleting all files**. Requires confirmation.                                                                                          |

<Note>
  Opening the interactive terminal is a human action and is not available as an
  agent tool. The terminal token never appears in the agent transcript.
</Note>

Agents can check the computer's current state (lifecycle status, environment,
whether a terminal is open) via the app snapshot (`ui_snapshot_app`) while on
the Computer screen.

## Sleep and hibernate

Your computer sleeps automatically when it has been idle for about 30 minutes,
or shortly after you close the terminal. Sleeping is non-destructive — the disk
and memory are snapshotted and restored on wake, so everything you left running
is still there.

To put the computer to sleep immediately, click **Hibernate now** in the
Computer tab toolbar (only visible when the computer is running). You'll be
asked to confirm, then the terminal closes and the machine hibernates. It wakes
automatically the next time you open the terminal or an agent calls the `bash`
tool.

## Environments

An environment is a custom Docker image your computer boots from, defined by a
small Dockerfile (allowlisted base images, `FROM` + `RUN` only). Build it, then
**Use on computer** to boot from it. Environments can be kept private to you or
shared with the whole project. Manage them from **Change** on the image strip.

<Note>
  Environment definitions (their Dockerfiles) live in the project database, not
  on any one computer's disk — see [Data & persistence](#data-and-persistence).
</Note>

## Data & persistence

Your computer is **scratch space, not durable storage.** Treat it like a fresh
dev box you can rebuild at any time — convenient and fast, but not a place to
keep the only copy of anything.

<Warning>
  Files persist when your computer sleeps, but they aren't backed up — keep
  anything important in git or elsewhere.
</Warning>

### What persists

* **The filesystem.** When your computer sleeps, its entire disk and memory are
  captured in a pause snapshot and restored on wake, so files you created and
  tools you installed are still there when you come back.

### What wipes it

Each of these rebuilds the machine from its image and **deletes every file on
the disk**:

* **Reset** — restores the computer to a clean copy of its current image.
* **Changing the image** — switching to a different environment (or back to the
  base image) rebuilds from that image.
* **Delete** — tears the computer down entirely.
* **Guest inactivity** — computers owned by signed-out (guest) sessions are
  deleted when idle instead of paused, so their files don't carry over between
  sessions. Sign in for a computer that sleeps and resumes with its disk intact.

### What survives independently

These live in the project database (Convex), not on the computer's disk, so they
are unaffected by reset, image changes, or deletion:

* **Cloud skills** attached to the project.
* **Environment Dockerfiles** — the definitions of your custom images. Deleting
  a computer never deletes your environments; you can boot a fresh computer from
  the same image again.

### The no-backup caveat

There is no backup and no volume behind the computer — the pause snapshot *is*
the storage. Once the disk is wiped by any of the actions above, its contents
are gone for good. Anything you want to keep should live in version control, a
remote, or another durable store.