> ## 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. For merge, move, and delete operations, use `mesa.bookmarks`.

```python theme={null}
async with mesa.fs.mount(repos=["app"]) as fs:
    bookmarks = await fs.bookmarks.list("app")
    await fs.bookmarks.create("app", "feature-x")
```

## 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>

## Errors

`create(...)` raises `FileExistsError` when the bookmark already exists.

<Tip>
  Use `mesa.bookmarks.move(...)`, `mesa.bookmarks.merge(...)`, and `mesa.bookmarks.delete(...)` for full bookmark management through the REST API.
</Tip>