Class Devbox

Object-oriented interface for working with Devboxes.

Remarks

Overview

The Devbox class provides a high-level, object-oriented API for managing devboxes. Devboxes are containers that run your code in a consistent environment. They have the the following categories of operations:

net - Network operations
cmd - Command execution operations
file - File operations

Quickstart

import { RunloopSDK } from '@runloop/api-client-ts';

const runloop = new RunloopSDK();
const devbox = await runloop.devbox.create({ name: 'my-devbox' });
devbox.cmd.exec('echo "Hello, World!"');
...

Index

Properties

net cmd file

Accessors

Methods

shell getInfo awaitRunning awaitSuspended snapshotDisk snapshotDiskAsync shutdown suspend resume resumeAsync keepAlive

Properties

`Readonly`net

net: DevboxNetOps

Network operations on the devbox.

`Readonly`cmd

cmd: DevboxCmdOps

Command execution operations on the devbox.

`Readonly`file

file: DevboxFileOps

File operations on the devbox.

Accessors

id

get id(): string
Get the devbox ID.

Returns string
The devbox ID
- Defined in src/sdk/devbox.ts:677

Methods

shell

shell(shellName?: string): DevboxNamedShell
Create a named shell instance for stateful command execution.

Named shells are stateful and maintain environment variables and the current working directory (CWD) across commands, just like a real shell on your local computer. Commands executed through the same named shell instance will execute sequentially - the shell can only run one command at a time with automatic queuing. This ensures that environment changes and directory changes from one command are preserved for the next command.
Parameters
- OptionalshellName: string = ...
  The name of the persistent shell session. If not provided, a UUID will be generated automatically.
Returns DevboxNamedShell
A DevboxNamedShell instance for executing commands in the named shell
Example
```
// Create a named shell with a custom name
const shell = devbox.shell('my-session');

// Create a named shell with an auto-generated UUID name
const shell2 = devbox.shell();

// Commands execute sequentially and share state
await shell.exec('cd /app');
await shell.exec('export MY_VAR=value');
await shell.exec('echo $MY_VAR'); // Will output 'value' because env is preserved
await shell.exec('pwd'); // Will output '/app' because CWD is preserved
```
- Defined in src/sdk/devbox.ts:708

getInfo

getInfo(options?: RequestOptions<unknown>): Promise<DevboxView>
Get the complete devbox data from the API.
Parameters
- Optionaloptions: RequestOptions<unknown>
  Request options
Returns Promise<DevboxView>
The devbox data
Example
```
const info = await devbox.getInfo();
console.log(`Devbox name: ${info.name}, status: ${info.status}`);
```
- Defined in src/sdk/devbox.ts:782

awaitRunning

awaitRunning(
    options?: RequestOptions<unknown> & {
        polling?: Partial<PollingOptions<DevboxView>>;
    },
): Promise<DevboxView>
Wait for the devbox to reach the running state. Uses optimized server-side polling for better performance.
Parameters
- Optionaloptions: RequestOptions<unknown> & { polling?: Partial<PollingOptions<DevboxView>> }
  Request options with optional polling configuration
Returns Promise<DevboxView>
The devbox data when running state is reached
Example
```
const devbox = Devbox.fromId(runloop, 'devbox-123');
await devbox.awaitRunning();
console.log('Devbox is now running');
```
- Defined in src/sdk/devbox.ts:800

awaitSuspended

awaitSuspended(
    options?: RequestOptions<unknown> & {
        polling?: Partial<PollingOptions<DevboxView>>;
    },
): Promise<DevboxView>
Wait for the devbox to reach the suspended state. Uses optimized server-side polling for better performance.
Parameters
- Optionaloptions: RequestOptions<unknown> & { polling?: Partial<PollingOptions<DevboxView>> }
  Request options with optional polling configuration
Returns Promise<DevboxView>
The devbox data when suspended state is reached
Example
```
await devbox.suspend();
await devbox.awaitSuspended();
console.log('Devbox is now suspended');
```
- Defined in src/sdk/devbox.ts:820

snapshotDisk

snapshotDisk(
    params?: DevboxSnapshotDiskParams,
    options?: RequestOptions<unknown> & {
        polling?: Partial<PollingOptions<DevboxSnapshotView>>;
    },
): Promise<RunloopSDK.Snapshot>
Create a disk snapshot of the devbox. Returns a snapshot that is completed. If you don't want to block on completion, use snapshotDiskAsync().
Parameters
- Optionalparams: DevboxSnapshotDiskParams
  Snapshot creation parameters
- Optionaloptions: RequestOptions<unknown> & {
  polling?: Partial<PollingOptions<DevboxSnapshotView>>;
  }
  Request options with optional polling configuration
Returns Promise<RunloopSDK.Snapshot>
A completed Snapshot instance
Example
```
const snapshot = await devbox.snapshotDisk({ name: 'pre-deployment' });
console.log(`Snapshot ${snapshot.id} created successfully`);
```
- Defined in src/sdk/devbox.ts:838

snapshotDiskAsync

snapshotDiskAsync(
params?: DevboxSnapshotDiskParams,
options?: RequestOptions<unknown>,
): Promise<RunloopSDK.Snapshot>
Create a disk snapshot of the devbox asynchronously. Returns a snapshot that is not yet completed but has started. You can await completion using snapshot.awaitCompleted().
Parameters
- Optionalparams: DevboxSnapshotDiskParams
  Snapshot creation parameters
- Optionaloptions: RequestOptions<unknown>
  Request options
Returns Promise<RunloopSDK.Snapshot>
A Snapshot instance that has started but may not be completed
Example
```
const snapshot = await devbox.snapshotDiskAsync({ name: 'backup' });
// Do other work...
await snapshot.awaitCompleted();
```
- Defined in src/sdk/devbox.ts:861

shutdown

shutdown(options?: RequestOptions<unknown>): Promise<DevboxView>
Shutdown the devbox.
Parameters
- Optionaloptions: RequestOptions<unknown>
  Request options
Returns Promise<DevboxView>
Shutdown result
Example
```
await devbox.shutdown();
```
- Defined in src/sdk/devbox.ts:880

suspend

suspend(options?: RequestOptions<unknown>): Promise<DevboxView>
Suspend the devbox and create a disk snapshot.
Parameters
- Optionaloptions: RequestOptions<unknown>
  Request options
Returns Promise<DevboxView>
Suspend result
Example
```
await devbox.suspend();
// Optionally, wait for the devbox to reach the suspended state
await devbox.awaitSuspended();
```
- Defined in src/sdk/devbox.ts:897

resume

resume(
    options?: RequestOptions<unknown> & {
        polling?: Partial<PollingOptions<DevboxView>>;
    },
): Promise<DevboxView>
Resume a suspended devbox and wait for it to reach the running state.
Parameters
- Optionaloptions: RequestOptions<unknown> & { polling?: Partial<PollingOptions<DevboxView>> }
  Request options with optional polling configuration
Returns Promise<DevboxView>
The devbox data when running state is reached
Example
```
await devbox.resume();
// Devbox is now running
```
- Defined in src/sdk/devbox.ts:913

resumeAsync

resumeAsync(options?: RequestOptions<unknown>): Promise<DevboxView>
Resume a suspended devbox without waiting for it to reach the running state.
Parameters
- Optionaloptions: RequestOptions<unknown>
  Request options
Returns Promise<DevboxView>
Resume result
Example
```
await devbox.resumeAsync();
// Optionally wait for running state
await devbox.awaitRunning();
```
- Defined in src/sdk/devbox.ts:933

keepAlive

keepAlive(options?: RequestOptions<unknown>): Promise<unknown>
Send a keep-alive signal to prevent idle shutdown.
Parameters
- Optionaloptions: RequestOptions<unknown>
  Request options
Returns Promise<unknown>
Keep-alive result
Example
```
// Send keep-alive periodically
setInterval(() => devbox.keepAlive(), 60000);
```
- Defined in src/sdk/devbox.ts:949

Class Devbox

Remarks

Overview

Quickstart

Index

Properties

Accessors

Methods

Properties

Readonlynet

Readonlycmd

Readonlyfile

Accessors

id

Returns string

Methods

shell

Parameters

Returns DevboxNamedShell

Example

getInfo

Parameters

Returns Promise<DevboxView>

Example

awaitRunning

Parameters

Returns Promise<DevboxView>

Example

awaitSuspended

Parameters

Returns Promise<DevboxView>

Example

snapshotDisk

Parameters

Returns Promise<RunloopSDK.Snapshot>

Example

snapshotDiskAsync

Parameters

Returns Promise<RunloopSDK.Snapshot>

Example

shutdown

Parameters

Returns Promise<DevboxView>

Example

suspend

Parameters

Returns Promise<DevboxView>

Example

resume

Parameters

Returns Promise<DevboxView>

Example

resumeAsync

Parameters

Returns Promise<DevboxView>

Example

keepAlive

Parameters

Returns Promise<unknown>

Example

Settings

On This Page

`Readonly`net

`Readonly`cmd

`Readonly`file