01README
Query Forgejo and Gitea instances via the shared /api/v1 REST API.
02Models
@shrug/forgejov2026.04.13.1forgejo.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| host | string | Forgejo or Gitea instance URL (e.g. https://codeberg.org). No trailing slash. |
| token | string | Personal access token for the Forgejo/Gitea instance. |
| metadata | record |
fn list_repos(page: number, limit: number)
List repositories owned by or accessible to the authenticated user.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (1-based). |
| limit | number | Results per page (max 50). |
fn get_repo(owner: string, repo: string)
Get details for a specific repository.
| Argument | Type | Description |
|---|---|---|
| owner | string | Repository owner (user or org login). |
| repo | string | Repository name. |
fn list_issues(owner: string, repo: string, state: enum, page: number, limit: number)
List issues for a repository.
| Argument | Type | Description |
|---|---|---|
| owner | string | Repository owner. |
| repo | string | Repository name. |
| state | enum | Filter by issue state. |
| page | number | Page number (1-based). |
| limit | number | Results per page (max 50). |
fn get_issue(owner: string, repo: string, index: number)
Get a specific issue by number.
| Argument | Type | Description |
|---|---|---|
| owner | string | Repository owner. |
| repo | string | Repository name. |
| index | number | Issue number. |
fn list_pulls(owner: string, repo: string, state: enum, page: number, limit: number)
List pull requests for a repository.
| Argument | Type | Description |
|---|---|---|
| owner | string | Repository owner. |
| repo | string | Repository name. |
| state | enum | Filter by pull request state. |
| page | number | Page number (1-based). |
| limit | number | Results per page (max 50). |
fn get_pull(owner: string, repo: string, index: number)
Get a specific pull request by number.
| Argument | Type | Description |
|---|---|---|
| owner | string | Repository owner. |
| repo | string | Repository name. |
| index | number | Pull request number. |
fn list_releases(owner: string, repo: string, page: number, limit: number)
List releases for a repository.
| Argument | Type | Description |
|---|---|---|
| owner | string | Repository owner. |
| repo | string | Repository name. |
| page | number | Page number (1-based). |
| limit | number | Results per page (max 50). |
Resources
repos(1h)— Repositories accessible to the authenticated user
repo(1h)— Details for a single repository
issues(30m)— Issues for a repository
issue(30m)— A single issue
pulls(30m)— Pull requests for a repository
pull(30m)— A single pull request
releases(1h)— Releases for a repository
03Stats
Downloads
2
Archive size
3.7 KB
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
04Platforms
05Labels