Introduction

import { Mesa } from "@mesadev/rest";

// Initialize the SDK
const mesa = new Mesa({
  apiKey: process.env.MESA_API_KEY,
});

// Create a repository - an isolated folder with its own version history and access controls
const repo = await mesa.repos.create({ name: "acme-workspace" });

// Open the repository locally as a virtual filesystem
const fs = mesa.fs.open(repo.id)

// Run an agent within the repository. All changes get persisted automatically.
await generateText({
  model: "gpt-5.3-codex",
  prompt: "Write a README for the repository",
  tools: {
    bash: fs.bashTool.aiSDK()
  }
});

const file = await mesa.content.get({
  repo: "agent-workspace",
  path: "README.md",
});
console.log(file.content);

await mesa.commits.create({
  repo: "agent-workspace",
  branch: "feature/readme",
  message: "Update README",
  author: { name: "Mesa Bot", email: "bot@acme.dev" },
  edits: [
    {
      path: "README.md",
      action: "update",
      content: "...",
    },
  ],
});