new front

Author: christianalfoni

packages/projects-docs/pages/sdk/_meta.json

@@ -1,6 +1,5 @@
 {
   "index": "Introduction",
-  "quickstart": "Quickstart Guide",
   "key-terms": "Key Terms",
   "core-concepts": "Core Concepts",
   "faq": "FAQ",

packages/projects-docs/pages/sdk/index.mdx

@@ -8,42 +8,43 @@ import { Callout } from 'nextra-theme-docs'
 
 <Hero
   title="CodeSandbox SDK"
-  subtitle="Programmatically spin up (AI) sandboxes"
+  subtitle="Programmatically spin up development environments"
 />
 
 CodeSandbox SDK enables you to quickly create and run isolated sandboxes securely.
-The SDK can be used to run concurrent VMs to support multiple use cases such as browser editors, AI agents, code interpretation and [more](/sdk/use-cases.mdx)
+The SDK can be used to run concurrent VMs to support multiple use cases such as browser editors, AI agents, code interpretation and more.
 
-## Use Cases
+## Quickstart
 
-CodeSandbox SDK is designed to help you build and launch any projects that require:
+1. Create or log into your [CodeSandbox account](https://codesandbox.io/signin)
 
-- An isolated code interpreter.
-- Running multiple development environments at scale.
-- Access to a sandboxed environment.
+2. Next create an API key at [https://codesandbox.io/t/api](https://codesandbox.io/t/api), and enable all scopes. Expose it as `CSB_API_KEY` in your environment.
 
-There are hundreds of use cases that can benefit from these three features. Below are some of the most interesting ones we've come across so far:
+3. Install the SDK:
 
-### AI Agents
+```bash
+npm install @codesandbox/sdk
+```
 
-Agentic workflows are a fast-emerging use case that benefit immensely from CodeSandbox SDK. Using the SDK, You can give each agent a sandbox to resolve user prompts, or you can create autonomous agents running on sandboxes. Doing this ensures they are securely isolated from your system, while still allowing them to interact with each other as required. You can also run multiple agents in parallel, if you want to avoid interaction entirely. Using the forking mechanism, you can also A/B test different agents.
+Your first interaction:
 
-### Development environments
+```js
+import { CodeSandbox } from "@codesandbox/sdk";
 
-You can use the SDK to programmatically provision a sandbox for anybody who needs an environment to code. Allowing you to run multiple development environments in parallel without them interfering with each other, all accessible through the browser.
+const sdk = new CodeSandbox();
+const sandbox = await sdk.sandboxes.create();
+const client = await sandbox.connect();
 
-With the SDK, you can essentially create your own CodeSandbox for your team/company/school!
+const output = await client.commands.run("echo 'Hello World'");
 
-### Code Interpretation
+console.log(output) // Hello World
+```
 
-CodeSandbox SDK allows programmatically spinning up sandboxes (VMs) to execute code in. Providing an ideal environment to interpret code, for both for simple and complex tasks.
+## How to integrate
 
-As these sandboxes exist in total isolation, you can run untrusted code without worrying about it affecting your system.
+To understand how the SDK can be integrated into your product it is critical that you read the following pages:
 
-Many early adopters, such as Blackbox AI, are leveraging the power of CodeSandbox SDK to bring code interpretation capabilities to their generative AI applications. We highly recommend following the [guide by Together AI](https://docs.together.ai/docs/together-code-sandbox) to get CodeSandbox SDK running seamlessly with any of the leading open-source LLMs.
-
-### CI/CD
-
-With the SDK, you can set up your own CI/CD implementation to run tests inside a sandbox and hibernate the sandbox when the tests are done. With our snapshotting technology, you can quickly pick up where you left off if you start the sandbox again to re-run your tests or evaluate the results.
-
-You can also use the SDK to create 1 sandbox that runs your CI/CD preparation, and then clone it multiple times to run your tests in parallel.
+- [**Core Concepts**](/sdk/core-concepts.mdx): It is all about templates, persistence and lifecycles
+- [**Templates**](/sdk/templates.mdx): Drop your end users directly into an optimized running Sandbox
+- [**Lifecycle Management**](/sdk/manage-sandboxes.mdx): Learn about managing cost VS optimizing UX
+- [**Hosts**](/sdk/sandbox-hosts.mdx): Learn about creating an experience around the ports you want to expose from Sandboxes