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);

const bookmarks = await mesa.bookmarks.list({ repo: "agent-workspace" });
const featureBookmark = bookmarks.bookmarks.find((bookmark) => bookmark.name === "feature/readme")!;

const change = await mesa.changes.create({
  repo: "agent-workspace",
  base_change_id: featureBookmark.change_id,
  message: "Update README",
  author: { name: "Mesa Bot", email: "[email protected]" },
  files: [
    {
      path: "README.md",
      action: "upsert",
      content: Buffer.from("...").toString("base64"),
      encoding: "base64",
    },
  ],
});

await mesa.bookmarks.move({
  repo: "agent-workspace",
  bookmark: "feature/readme",
  change_id: change.id,
});