LoginStart Free

GitHub Integration

Connect GitHub to Telbase and link a repository to a project.

Deploys on push are not available yet
Telbase does not deploy on push, report commit statuses or deploy pull-request previews yet. Your coding agent deploys, with the app's deploy command (telbase apps info <app> prints it).

Connecting GitHub

1

Install the Telbase GitHub App

Run the connect command or go to Settings → GitHub in the dashboard. This opens GitHub to install the Telbase app on your account or organization.

bash
telbase github connect
2

Authorize access

Grant the Telbase app access to the repositories you want to link. You can choose specific repos or grant access to all repos in an organization.

3

Confirm the connection

Once authorized, the CLI confirms the connection. You can now link repositories to your Telbase projects.

bash
telbase github status

Linking a Repository

Link a GitHub repository to an existing Telbase project: the current project, set with telbase projects switch <name>.

bash
# Link a repo to the current project
telbase github link owner/repo

# Verify the link
telbase github status

Each project can be linked to one repository. Linking a different repo replaces the previous link. For monorepos, set a root directory.

You can also link a repo from the dashboard. Open your project, go to Settings → GitHub, select a repository, and choose a branch.

Branch

A link names a branch, main by default:

bash
# Change the link's branch to develop
telbase github branch develop

# Check the link
telbase github status

Root Directory

For monorepo projects where your app lives in a subdirectory, set the link's root directory.

bash
# Set root directory when linking
telbase github link owner/repo --root-dir apps/web

In the dashboard, enter the root directory path when linking a repo, or update it later in Settings → GitHub.

Managing Connections

bash
# View connection and link status
telbase github status

# Unlink the current project from its repo
telbase github unlink

# Disconnect GitHub entirely (removes all links)
telbase github disconnect

Unlinking a project keeps the GitHub connection active. Disconnecting removes the GitHub App installation and all repository links.

Next Steps