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

> Manage bookmarks inside a mounted Mesa filesystem.

Mounted filesystems expose bookmark controls under `fs.bookmark`.

## fs.bookmark.create()

Create a new bookmark on the current commit without switching to it.

```ts theme={null}
await fs.bookmark.create({ repo: 'app', name: 'feature/auth' });
```

<ParamField path="repo" type="string" required>
  Repository name.
</ParamField>

<ParamField path="name" type="string" required>
  Bookmark name.
</ParamField>

## fs.bookmark.move()

Move an existing bookmark to point at a change.

```ts theme={null}
const current = await fs.change.current({ repo: 'app' });
await fs.bookmark.move({ repo: 'app', name: 'main', changeId: current.changeId });
```

<ParamField path="repo" type="string" required>
  Repository name.
</ParamField>

<ParamField path="name" type="string" required>
  Bookmark name.
</ParamField>

<ParamField path="changeId" type="string" required>
  Change ID to move the bookmark to.
</ParamField>

## fs.bookmark.list()

List bookmark names for a repository.

```ts theme={null}
const bookmarks = await fs.bookmark.list({ repo: 'app' });
console.log(bookmarks);
```

<ParamField path="repo" type="string" required>
  Repository name.
</ParamField>

## Response

`create(...)` and `move(...)` return `Promise<void>`. `list(...)` returns `Promise<string[]>`.