Agent workspaces
Agent sandbox: workspaces for AI agents on Apple Silicon Macs
Our own account first
Short answer: A Smarty Pants agent workspace keeps one sealed Linux VM open on an Apple Silicon Mac so an AI agent can write files, run several programs and read results back, then end it. Available today: sessions, on Smarty Pants' own account first, not charged while tested. Planned, not available: snapshots and recovery, model calls, fleets, always-on agents, internet access and a CLI or SDK. The Mac's owner always comes first.
An agent sandbox is a place where an AI agent can run code, keep files and try things without touching your own machine. Smarty Pants agent workspaces put that sandbox in a sealed Linux VM on an Apple Silicon Mac that its owner makes available when idle. This page says what works today, what is Planned, and what the trust model means for what you put inside.
What is a Smarty Pants workspace?
One sealed VM kept open so your agent can write files, run several programs and read results back, then end it. Files live until the workspace ends; nothing is kept after.
The VM is ARM64 Linux with no network. The starter kits wrap it as sp.workspace(), and the API has routes to create a session, run commands, move files and end it. Details and limits are on workspace sessions.
What is available today and what is Planned?
Only sessions are available today, and only on Smarty Pants’ own account. Every other piece is Planned and not available.
| Piece | Status | What it lets you do |
|---|---|---|
| Sessions | Available today (Smarty Pants’ own account first, not charged while tested) | One sealed VM for many commands and small files, up to 30 minutes |
| One-file starter kits | Available today | Use sessions from Python with sp.workspace() |
| Snapshots and recovery | Planned | Save a workspace and continue it on another Mac if its Mac goes away |
| Model calls | Planned | Call Smarty Pants models from inside a workspace with a key limited to that workspace and a spending budget |
| Fleets and browser work | Planned | Run several sessions at once, and use a web browser in a workspace |
| Always-on agents | Planned | Keep an agent working for days |
| Internet access | Planned | Reach the internet from inside a workspace |
| CLI and SDK | Planned | Tools for paid developer use |
For one-off code with no files, CPU jobs run a single program for up to 30 seconds.
What does the trust model mean for my data?
The VM protects the Mac’s owner from your code. It does not hide your files or memory from the Mac’s owner. So do not put secrets, keys, personal, customer or regulated data in a workspace.
Workspaces run on Macs other people own. VM isolation protects the owner from guest code. But the person who owns the Mac controls the hardware the VM runs on, so the guest’s contents are not confidential from them. Choose workloads accordingly: public code, test data, throwaway work.
Why does the Mac’s owner come first?
Because these are people’s own computers, lent while idle. If the owner comes back, the workspace ends within 5 seconds and the request says OWNER_RETURNED.
Plan for that. Keep each command short enough to redo, and fetch results you need before the next step. Snapshots and recovery, which will let a workspace continue on another Mac, are Planned and not available.
When is a Smarty Pants workspace the wrong choice?
When you need internet access, long-running work, large files, x86 tools or guaranteed capacity today. Sessions have no network, files up to 8 KB, and 30 minutes at most.
A hosted sandbox service on dedicated servers is the better choice for those needs right now. Smarty Pants workspaces fit small, self-contained agent tasks where the code and data are fine to run on someone else’s Mac.
How do I follow what opens next?
Read the live agent docs. We’ll announce it on smartypants.network/docs/agents when each piece opens. For background on sandboxes in general, see AI agent sandboxes explained.
Frequently asked questions
Can I use Smarty Pants agent workspaces today?
Not from your own account yet. Workspace sessions run on Smarty Pants' own account first and are not charged while tested; everything else on this page is Planned.
Does a workspace have internet access?
No. Today the VM has no network. Internet access from a workspace is Planned and not available.
Are my files in a workspace confidential?
No. VM isolation protects the Mac's owner from guest code, but it does not keep the guest's files or memory confidential from the Mac's owner. Do not put secrets in a workspace.
What happens if the Mac's owner comes back?
The owner comes first. If they return, the workspace ends within 5 seconds and the request reports OWNER_RETURNED.
How is a workspace different from a CPU job?
A CPU job runs one short program and is wiped. A workspace keeps one VM open for many commands and files, for up to 30 minutes.