Skip to main content

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.

Mounted filesystems expose bookmark controls under fs.bookmark.

​
fs.bookmark.create()

Create a new bookmark on the current commit without switching to it. 
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. 
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.

​
fs.bookmark.list()

List bookmark names for a repository. 
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[]>.