Skip to content
Back to search

pplx-space

MarketplaceWorks with Claude CodeGitHub

Sandboxed Platform for Agentic Code Execution: pluggable-runtime sandboxes for running agent and user code in isolation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/perplexityai/SPACE with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/perplexityai/SPACE'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/perplexityai--space/badge.svg)](/listings/perplexityai--space)

HTML

<a href="/listings/perplexityai--space"><img src="/api/listings/perplexityai--space/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "pplx-space",
  3. "owner": {
  4. "name": "Perplexity AI"
  5. },
  6. "metadata": {
  7. "description": "Claude Code plugins for SPACE development."
  8. },
  9. "plugins": [
  10. {
  11. "name": "pplx-space",
  12. "source": "./.agents/plugins/pplx-space"
  13. }
  14. ]
  15. }
README.md · README · 103 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # SPACE
  2. [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
  3. [Guide](https://space.docs.perplexity.ai/guide/index.html) · [API Reference](https://space.docs.perplexity.ai/api/index.html)
  4. SPACE (Sandboxed Platform for Agentic Code Execution) is a sandbox platform for running code in isolated Firecracker microVMs. Applications use its HTTP API to create Linux environments, execute commands, collect output, and manage sandbox lifecycles.
  5. Use SPACE when your application needs a separate execution environment for an agent, a user workspace, or a code-running job. Your application decides what to run and what results to keep; SPACE manages the sandbox, its processes, and the connection carrying command output.
  6. ## How it works
  7. A **template** supplies the starting environment. A **sandbox** is an instance of that environment with its own VM and writable filesystem; multiple commands can run in the same sandbox.
  8. ```text
  9. Your application
  10. |
  11. +-- Create sandbox from template --> Wait for readiness
  12. |
  13. +-- Create command session --------> Attach to start the process
  14. | Read output and exit result
  15. |
  16. +-- Keep, pause, or suspend --------> Wake when needed
  17. |
  18. +-- Delete sandbox
  19. ```
  20. Sandbox lifecycle changes are asynchronous: the API returns an operation ID that you poll for completion. Command output uses a separate data-plane connection and a session-scoped attachment token.
  21. ## Get started
  22. Follow [Installation and configuration](docs/installation.md) to deploy SPACE in a local Kind cluster and authenticate. Then follow [Your first sandbox](docs/first-sandbox.md) to run a command and collect its output. The setup guide covers Kubernetes; the [architecture guide](docs/architecture.md#request-and-execution-flow) also explains how SPACE can run without it.
  23. ## Documentation
  24. Read the hosted [Guide](https://space.docs.perplexity.ai/guide/index.html) and [API Reference](https://space.docs.perplexity.ai/api/index.html) online. Both update automatically after changes merge. The links below point to source documentation in this checkout.
  25. | Guide | What you will learn |
  26. |---|---|
  27. | [Versioning and compatibility](docs/versioning.md) | Release progression, supported guests, service stability, and upgrade/rollback requirements. |
  28. | [Architecture](docs/architecture.md) | How templates, sandboxes, processes, sessions, and operations relate; what pause and suspend preserve; how the services fit together. |
  29. | [Installation and configuration](docs/installation.md) | Host prerequisites, local Kind deployment, configuration defaults, authentication, verification, and teardown. |
  30. | [Operator CLI](crates/l50_app/admin/cli/README.md) | API access, port forwarding, `space-admin-cli login`, nodes, warm pools, and system-template builds. |
  31. | [Your first sandbox](docs/first-sandbox.md) | A complete API workflow, command customization, output handling, inspection, and deletion. |
  32. | [E2B Compatibility Wrapper](docs/ecw.md) | Configure ECW, create a compatibility API key, use the tested E2B Python SDK, and understand supported behavior and limitations. |
  33. | [API reference](docs/api/index.md) | Endpoints, request and response fields, and examples. |
  34. | [Troubleshooting](docs/troubleshooting.md) | Local setup, authentication, lifecycle operations, command streams, and safe retries. |
  35. | [Operator egress profiles](docs/egress-profiles.md) | Configure named policy additions for federated native and ECW creates. |
  36. | [Observability](docs/observability.md) | Telemetry build features, the Rust/Go selector contract, and unchanged image defaults. |
  37. | [Warm pools](docs/warm-pools.md) | Keep booted sandboxes ready on Kubernetes so creates skip a cold boot. |
  38. | [Base snapshots](docs/base-snapshots.md) | Restore sandboxes from a snapshot on a single node, optionally with a node warm pool. |
  39. ### Build documentation locally
  40. To browse the guide and API together locally, install [mdBook 0.4.52](https://github.com/rust-lang/mdBook/releases/tag/v0.4.52) and the [API build prerequisites](docs/api/index.md#browse-locally). From a clean checkout, run:
  41. ```bash
  42. bash scripts/build-docs.sh
  43. python3 -m http.server 8000 --bind 127.0.0.1 --directory target/docs/site
  44. ```
  45. Open <http://127.0.0.1:8000>. The build also requires Git and Python 3.11+. The standalone commands remain `bash scripts/build-guide-docs.sh` and `bash scripts/build-api-docs.sh`; they also support local uncommitted edits.
  46. The API serves its generated reference at `/openapi-m1.json`, with request fields, response schemas, and errors. `/openapi.json` adds the incubating operations that are not hidden. Some incubating operations, including snapshots, checkpoint, and rollback, are hidden: unless the deployment enables them for your organization, they answer as if they did not exist. Neither document lists them for any caller; `/openapi-full.json` documents every operation and requires API credentials.
  47. ## SPACE API
  48. The SPACE API manages sandbox lifecycles, runs and controls processes, and streams their output. Fields marked `incubating` in the schema are outside the supported contract.
  49. SPACE is implemented in Rust, but applications interact with it over HTTP and server-sent events. You do not need to embed a Rust library to use it; the first-sandbox walkthrough runs a standard-library-only Python example. Installation and cluster diagnostics use Bash.
  50. ## Development
  51. See [DEPENDENCIES.md](DEPENDENCIES.md) when adding or updating third-party code.
  52. After [local installation](docs/installation.md), the Tilt watcher that `up.sh` started keeps running: it rebuilds affected images and rolls their workloads as files change. Rerun `up.sh` to wait for the stack to settle again; do not start a second `tilt up`. The [Kind runbook](infra/space/kind/README.md) covers this development loop, local topology, and template builds.
  53. Use focused unit tests for component logic and the [Kind smoke suites](infra/space/kind/README.md#smoke-test) for runtime behavior. For setup-specific diagnostics, see [host-path troubleshooting](infra/space/kind/README.md#host-paths-and-running-as-a-user-other-than-dev) and [template-build debugging](infra/space/kind/README.md#debugging-a-template-build).
  54. ## Repository layout
  55. ```text
  56. crates/<layer>/ Rust crates by layer: l10_foundation, l20_domain, l30_storage,
  57. l40_api, l50_app, test_support, tools (crates/<layer>/AGENTS.md)
  58. crates/libs/ Crates that predate the layer directories, until they move
  59. docs/ Architecture, setup, API walkthrough, and troubleshooting
  60. examples/ Runnable API examples without an SDK dependency
  61. proto/ gRPC protobuf definitions
  62. templates/firecracker/ Seed builder and template recipes
  63. scripts/ Utility scripts and smoke suites (scripts/tests/)
  64. docker/ Service Dockerfiles and Rust artifact build
  65. ci/ CI checks and artifact build scripts
  66. infra/space/kind/ Local Kind configuration, bootstrap, and development runbook
  67. infra/space/aws/reference/ Reference EKS deployment, applied on a schedule
  68. ```
  69. ## License
  70. SPACE is licensed under the [Apache License, Version 2.0](LICENSE).
  71. See [CONTRIBUTING.md](CONTRIBUTING.md) to propose changes or contribute.
  72. For native API contract, concurrency, recovery, and quarantine coverage, see [Native API hardening](docs/native-api-hardening.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.