> ## 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' });
```

**repo** `string` *required*

Repository name.

**name** `string` *required*

Bookmark name.

## fs.bookmark.move()

Move an existing bookmark to point at a change.

Moves must advance history unless `allowBackwards: true` is provided.

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

**repo** `string` *required*

Repository name.

**name** `string` *required*

Bookmark name.

**changeId** `string` *required*

Change ID to move the bookmark to.

**allowBackwards** `boolean` (default: false)

Allow an intentional backward or sideways move.

## fs.bookmark.list()

List bookmark names for a repository.

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

**repo** `string` *required*

Repository name.

## Response

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.