# ai-sandbox-local

> Run AI SDK harness agents against your real filesystem and processes.

## Docs

- [Introduction](https://ai-sandbox-local.fdarian.com/): A sandbox for the AI SDK's HarnessAgent that runs on your real filesystem and processes.
- [Getting started](https://ai-sandbox-local.fdarian.com/getting-started): Install ai-sandbox-local and run a Claude Code agent on a repo on your machine.
- [Working directory and $HOME](https://ai-sandbox-local.fdarian.com/working-directory): Where the agent works, where the harness keeps its own files, and how to move them.
- [Configuration](https://ai-sandbox-local.fdarian.com/configuration): Environment variables, PATH for apps launched from a GUI, and pnpm build approval.
- [Sessions and processes](https://ai-sandbox-local.fdarian.com/sessions-and-processes): Running commands, the leased port, and how a session shuts down.
- [API reference](https://ai-sandbox-local.fdarian.com/api-reference): Every export of ai-sandbox-local, with its signature and the behavior the types don't show.
- [Limitations](https://ai-sandbox-local.fdarian.com/limitations): What this sandbox doesn't do, and what breaks if you expect it to.

## Agent skills

- [ai-sandbox-local](https://ai-sandbox-local.fdarian.com/.well-known/agent-skills/ai-sandbox-local/SKILL.md): Read the ai-sandbox-local docs instead of answering from memory. Run AI SDK harness agents against your real filesystem and processes. Use when a task involves ai-sandbox-local: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://ai-sandbox-local.fdarian.com/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://ai-sandbox-local.fdarian.com/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://ai-sandbox-local.fdarian.com/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://ai-sandbox-local.fdarian.com/openapi.json.
- [Agent skills](https://ai-sandbox-local.fdarian.com/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://ai-sandbox-local.fdarian.com/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://ai-sandbox-local.fdarian.com/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://ai-sandbox-local.fdarian.com/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://ai-sandbox-local.fdarian.com/sitemap.xml): Every indexable page URL with its last-modified date.