> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mesa.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# fs.bookmarks

> Manage bookmarks from a mounted Mesa filesystem.

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

```python theme={null}
from mesa_sdk import repo

async with mesa.fs(
    layout={"/workspace": repo("app", mode="rw")},
    authors=[{"name": "Workspace Agent", "email": "agent@example.com"}],
).mount() 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

<ParamField path="list(repo)" type="async -> list[str]">
  Return every bookmark name on a mounted repository.
</ParamField>

<ParamField path="create(repo, name)" type="async -> None">
  Create a bookmark at the active change's commit.
</ParamField>

<ParamField path="move(repo, name, *, change_id, allow_backwards=False)" type="async -> None">
  Move a bookmark to a change. The move must advance history unless
  `allow_backwards=True` is provided.
</ParamField>

## Errors

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

<Tip>
  Use `mesa.bookmarks` for bookmark operations through the REST API, including
  moving, merging, and deleting bookmarks.
</Tip>