Background Commands

from gravixlayer import GravixLayer

client = GravixLayer()
sandbox = client.runtime.create()

handle = sandbox.run_cmd(
    command="sh -lc 'echo started; sleep 2; echo finished'",
    background=True,
    timeout=0,
)
print(handle.pid)

finished = handle.wait()
print(finished.exit_code, finished.stdout)

attached = sandbox.command.connect(handle.pid)
print(attached.stdout)

server = sandbox.run_cmd(command="sleep 30", background=True, timeout=0)
server.kill()

sandbox.kill()

import { GravixLayer } from 'gravixlayer';

const client = new GravixLayer();
const sandbox = await client.runtime.create();

const handle = await sandbox.runCmd("sh -lc 'echo started; sleep 2; echo finished'", {
  background: true,
  timeout: 0,
});
console.log(handle.pid);

const finished = await handle.wait();
console.log(finished.exitCode, finished.stdout);

const attached = await sandbox.command.connect(handle.pid);
console.log(attached.stdout);

const server = await sandbox.runCmd('sleep 30', { background: true });
await server.kill();

await sandbox.kill();

# Start a command in the background — prints the command record with its pid
gravixlayer runtime exec "$RT" --background --timeout 0 -- \
  sh -lc 'echo started; sleep 2; echo finished'

# Inspect and manage tracked commands
gravixlayer runtime commands list "$RT"
gravixlayer runtime commands get "$RT" <PID>

# Re-attach to live output (scrollback first, then live)
gravixlayer runtime commands attach "$RT" <PID>

# Stop it — KILL by default; TERM/INT/HUP via --signal
gravixlayer runtime commands kill "$RT" <PID> --signal TERM

curl -sS -X POST "https://api.gravixlayer.ai/v1/agents/runtime/$RT/commands/run" \
  -H "Authorization: Bearer $GRAVIXLAYER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command":"sh","args":["-lc","echo started; sleep 2; echo finished"],"background":true}'