Skip to main content
List repositories using cursor pagination. Required scope: read 
const repos = await mesa.repos.list({ limit: 50 });

for (const repo of repos.repos) {
  console.log(repo.name, repo.default_bookmark, repo.head_change_id);
}

​
Options

​
org
string | undefined
Organization override.
​
cursor
string | undefined
Opaque pagination cursor from a previous response.
​
limit
number | undefined
Maximum number of repositories to return. The server maximum is 100.
​
tags
string | undefined
Comma-separated tag filter string such as env:prod,team:agents.

​
Response

​
next_cursor
string | null
Cursor for the next page, or null when no more results remain.
​
has_more
boolean
Whether another page of results is available.
​
repos
Repo[]
Repository objects.

​
Repo

​
id
string
Repository ID.
​
org
string
Organization slug.
​
name
string
Repository name.
​
default_bookmark
string
Default bookmark name.
​
head_change_id
string
Current change ID at the default bookmark tip.
​
upstream
UpstreamConfig | null
Configured upstream remote, or null when no upstream is configured.
​
created_at
string
Creation time.
​
tags
Record<string, string>
Repository tags.

​
UpstreamConfig

​
url
string
Upstream Git remote URL.
​
auth_kind
'token' | 'username_password' | null
Stored upstream authentication kind, or null when the upstream is public.