Maru Example

// Create a sandbox for a new session
const sandbox = await Sandbox.create("claude-agent-template", {
  metadata: { userId, sessionId },
  timeout: 3600  // 1 hour
})

// Start the agent process
await sandbox.commands.run("claude-code start", { background: true })

// Save session before pausing
const sessionData = await sandbox.files.read("~/.claude/session.jsonl")
await storage.save(sessionId, sessionData)

// Restore session on resume
await sandbox.files.write("~/.claude/session.jsonl", sessionData)

await sandbox.commands.run("claude-code message", {
  onStdout: (data) => {
    ws.send(JSON.stringify({ type: "output", data }))
  }
})

// Agent runs code
const result = await sandbox.commands.run("python3 script.py")

// Agent modifies files
await sandbox.files.write("/workspace/app.py", code)

// Agent runs tests
const testResult = await sandbox.commands.run("pytest")

# Clone the repository
git clone https://github.com/moru-ai/maru
cd maru

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your API keys

# Start the application
npm run dev

# .env
MORU_API_KEY=moru_...
ANTHROPIC_API_KEY=sk-ant-...
DATABASE_URL=postgres://...

maru/
├── apps/
│   ├── web/              # React frontend
│   │   ├── src/
│   │   │   ├── components/
│   │   │   └── hooks/
│   │   └── package.json
│   └── server/           # Node.js backend
│       ├── src/
│       │   ├── routes/
│       │   ├── services/
│       │   └── sandbox/
│       └── package.json
├── packages/
│   └── shared/           # Shared types
└── docker/
    └── agent/            # Agent Dockerfile

const template = Template()
  .fromPythonImage("3.11")
  .runCmd("pip install anthropic")
  .copy("./agent", "/app")
  .setStartCmd("python /app/main.py", waitForPort(8080))

await Template.build(template, { alias: "claude-agent-template" })

async function createSession(userId: string) {
  const sessionId = generateId()

  const sandbox = await Sandbox.create("claude-agent-template", {
    metadata: { userId, sessionId },
    envs: {
      ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY
    }
  })

  return { sessionId, sandboxId: sandbox.sandboxId }
}

async function resumeSession(sessionId: string) {
  const session = await storage.get(sessionId)

  const sandbox = await Sandbox.connect(session.sandboxId)
  await sandbox.connect()  // Resume if paused

  return sandbox
}

async function cleanupSession(sessionId: string) {
  const session = await storage.get(sessionId)

  // Save state
  const workspace = await sandbox.files.read("/workspace", { format: "bytes" })
  await storage.saveWorkspace(sessionId, workspace)

  // Kill sandbox
  await sandbox.kill()
}