fs.bookmarks - Mesa Docs

fs.bookmarks exposes bookmark operations that are local to a mounted filesystem session.

async with mesa.fs.mount(
    repos=["app"],
    authors=[{"name": "Workspace Agent", "email": "agent@example.com"}],
) as fs:
    bookmarks = await fs.bookmarks.list("app")
    await fs.bookmarks.create("app", "feature-x")
    await fs.bookmarks.move("app", "feature-x", change_id="zyxwvutsrqponmlkzyxwvutsrqponmlk")

Methods

async -> list[str]

Return every bookmark name on a mounted repository.

async -> None

Create a bookmark at the active change’s commit.

async -> None

Move a bookmark to a change. The move must advance history unless allow_backwards=True is provided.

Errors

create(...) raises FileExistsError when the bookmark already exists. move(...) rejects backward or sideways moves unless allow_backwards=True.

Use mesa.bookmarks for bookmark operations through the REST API, including moving, merging, and deleting bookmarks.

​Methods

​Errors

Methods

Errors