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.

Read repository content without mounting the filesystem.
root = await mesa.content.get(repo="app", depth=1)
print(root.type)

readme = await mesa.content.get(repo="app", path="README.md")
print(readme.content)  # base64-encoded bytes

Options

repo
str
required
Repository name.
org
str | None
Organization override.
change_id
str | None
Change ID to read from. Defaults to the current change at the repository’s default bookmark tip.
path
str | None
Repository-relative path. Omit for the repository root.
depth
int | None
Directory traversal depth. 0 returns directory metadata only, 1 returns direct children, and the server maximum is 10.

Response variants

The method returns one generated model variant.
type
'file' | 'symlink' | 'dir'
Response discriminator.

File

content
str
Base64-encoded file bytes.
encoding
'base64'
Encoding used for content.
mode
'100644' | '100755'
POSIX file mode.
content
str
Base64-encoded symlink target bytes.
mode
'120000'
POSIX symlink mode.

Directory

child_count
int
Number of direct children in the directory.
entries
list
Directory entries up to the requested depth.

Required scope

read