# @tanstack/ai-sandbox-local-process

> Local-process sandbox provider for TanStack AI — runs the agent directly on the host through the uniform SandboxHandle (no isolation; trusted/dev use).

Latest version **1.0.0** (published 2026-10-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install @tanstack/ai-sandbox-local-process
pnpm add @tanstack/ai-sandbox-local-process
yarn add @tanstack/ai-sandbox-local-process
bun add @tanstack/ai-sandbox-local-process
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2026-10-22 |
| First published | 2026-06-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 1 |
| Unpacked size | 149.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 3359 |
| Maintainers | tannerlinsley, alemtuzlak, kevinvandy |
| Keywords | ai, tanstack, sandbox, local, harness, agent |

## Links

- npm: https://www.npmjs.com/package/@tanstack/ai-sandbox-local-process
- Repository: https://github.com/TanStack/ai
- npm.io page: https://npm.io/package/@tanstack/ai-sandbox-local-process

## Dependencies (1)

- [@tanstack/ai-utils](https://npm.io/package/@tanstack/ai-utils.md) ^1.0.0

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 1.0.0 (latest) — 2026-10-22
- 0.2.6 — 2026-09-25
- 0.2.5 — 2026-09-03
- 0.2.4 — 2026-08-22
- 0.2.3 — 2026-08-20
- 0.2.2 — 2026-08-19
- 0.2.1 — 2026-08-04
- 0.2.0 — 2026-06-30
- 0.1.0 — 2026-06-30

## README

<div align="center">
  <picture>
    <source
      media="(prefers-color-scheme: dark)"
      srcset="https://tanstack.com/api/readme/ai.png?theme=dark"
    />
    <source
      media="(prefers-color-scheme: light)"
      srcset="https://tanstack.com/api/readme/ai.png"
    />
    <img
      src="https://tanstack.com/api/readme/ai.png"
      alt="TanStack AI"
      width="900"
    />
  </picture>
</div>

<br />

# @tanstack/ai-sandbox-local-process

Local-process sandbox provider for TanStack AI

Runs the harness directly on your host through the uniform `SandboxHandle`, so you can develop an agent without provisioning anything.

> **There is no isolation.** The harness inherits your host environment and there is no boundary between the agent and your machine. Use this for trusted or dev work only; reach for one of the cloud providers when the code is not yours.

## Installation

```bash
npm install @tanstack/ai-sandbox-local-process
# or
pnpm add @tanstack/ai-sandbox-local-process
# or
yarn add @tanstack/ai-sandbox-local-process
```

## Usage

```typescript
import { localProcessSandbox } from '@tanstack/ai-sandbox-local-process'

const dev = localProcessSandbox()
```

Hand the provider to a sandboxed run the same way as any other; see the [sandbox docs](https://tanstack.com/ai/latest/docs/sandbox/overview) for the surrounding wiring.

- **Auth / env:** inherits the host environment. Which credentials the harness uses is set by `authMode` on the harness (`'host'` or `'api-key'`), not by the provider.
- **Snapshot / resume:** none. Each run re-creates and re-bootstraps under the same identity, and the snapshot step is skipped silently.

## Documentation

- [Sandbox overview](https://tanstack.com/ai/latest/docs/sandbox/overview): what a sandbox run is and how the pieces fit
- [Providers](https://tanstack.com/ai/latest/docs/sandbox/providers): every provider side by side, with the capability matrix
- [Harnesses](https://tanstack.com/ai/latest/docs/sandbox/harnesses) and [Harness auth](https://tanstack.com/ai/latest/docs/sandbox/auth): what runs inside, and how it signs in

## License

MIT

---
_Source: https://npm.io/package/@tanstack/ai-sandbox-local-process · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
