> ## 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.
# content.get()
> Read a file, symlink, or directory listing from a repository.
Read repository content without mounting MesaFS.
**Required scope: `read`**
```ts theme={null}
import { Buffer } from 'node:buffer';
const file = await mesa.content.get({ repo: 'app', path: 'README.md' });
if (file.type === 'file') {
console.log(Buffer.from(file.content, 'base64').toString('utf8'));
}
```
Read a directory listing:
```ts theme={null}
const root = await mesa.content.get({ repo: 'app', path: '', depth: 1 });
if (root.type === 'dir') {
for (const entry of root.entries) console.log(entry.type, entry.path);
}
```
## Options
Repository name.
Organization override.
Repository-relative path. Omit or pass an empty string for the repository root.
Change to read from. Defaults to the current change at the default bookmark tip.
Directory traversal depth from `0` to `10`.
## Response
Regular file content.
Symbolic link content.
Directory listing.
### ContentFile
Content variant discriminator.
Base name of the file.
Repository-relative path.
Git object SHA.
Whether this path is conflicted when known.
Size in bytes.
Encoding used for `content`.
Base64-encoded file bytes.
POSIX file mode.
Extended attributes for this path. Values are base64-encoded.
### ContentSymlink
Content variant discriminator.
Base name of the symlink.
Repository-relative path.
Git object SHA.
Whether this path is conflicted when known.
Size in bytes.
Encoding used for `content`.
Base64-encoded symlink target bytes.
POSIX symlink mode.
Extended attributes for this path. Values are base64-encoded.
### ContentDirectory
Content variant discriminator.
Base name of the directory.
Repository-relative path.
Git object SHA.
Number of direct children in this directory.
Directory entries returned for the requested depth.
Extended attributes attached to this directory. Values are base64-encoded.
### ContentDirectoryEntry
Entry variant discriminator.
Base name of the entry.
Repository-relative path.
Git object SHA.
Size in bytes for file and symlink entries.
POSIX mode for file and symlink entries.