> ## 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.change
> Manage active changes inside a mounted Mesa filesystem.
Mounted filesystems expose change controls under `fs.change`.
## fs.change.new()
Create and switch to a new change from a bookmark or existing change.
```ts theme={null}
const result = await fs.change.new({ repo: 'app', bookmark: 'main', message: 'Try new copy' });
console.log(result.changeOid);
```
Repository name.
Bookmark to fork from. Mutually exclusive with `changeId`.
Change ID to fork from. Mutually exclusive with `bookmark`.
Description for the new change. Omit to create the change with no description; pass `""` explicitly for an empty description.
## fs.change.edit()
Switch to an existing editable change. This never creates a new change.
```ts theme={null}
await fs.change.edit({ repo: 'app', changeId: 'zyxwvutsrqponmlkzyxwvutsrqponmlk' });
```
Repository name.
Bookmark whose existing change should be edited. Mutually exclusive with `changeId`.
Existing change ID to edit. Mutually exclusive with `bookmark`.
## fs.change.list()
List changes reachable from the current checkout's commit.
```ts theme={null}
const changes = await fs.change.list({ repo: 'app', limit: 10 });
```
Repository name.
Maximum number of changes to return. Defaults to `50`. Pass `0` for no limit.
## fs.change.current()
Return the currently active change for a repo.
```ts theme={null}
const current = await fs.change.current({ repo: 'app' });
console.log(current.changeId, current.commitOid);
```
Repository name.
## Response types
Hex-encoded change OID of the now-active change.
Hex-encoded change ID.
Hex-encoded commit OID the change currently points to.