This feature is in beta. Help us shape it.
Connect
- CLI
1
Run tero
Open your terminal and run:This opens the Tero TUI, which guides you through setup.
Don’t have the CLI installed? See the quickstart.
2
Log in to Tero
The TUI opens your browser to create an account or log in. Complete the flow in your browser, then confirm the code shown in your terminal. The TUI logs you in automatically.
3
Select GitHub
The TUI asks which integration you want to connect. Select GitHub.
4
Install the GitHub App
The TUI opens your browser to install the Tero GitHub App. Select which repositories Tero can access — you can grant access to all repositories or select specific ones.
5
Authorize
GitHub asks you to authorize the app. Review the permissions and approve. You’re redirected back to Tero.
6
Done
Tero confirms the connection. You can now open PRs, create issues, and sync policies to your repositories.
Actions
With GitHub connected, Tero can take action directly in your repositories:Pull requests
Tero opens PRs to fix instrumentation issues — removing debug output, cleaning up excessive logging, fixing waste at the source.
Issues
Tero creates issues for waste your team should review. Assigned to the right team based on your service catalog.
Policy sync
Tero syncs policies to a git repository. Version control, audit history, review before apply.
Permissions
The Tero GitHub App requests these permissions:| Permission | Access | Why |
|---|---|---|
| Contents | Read & Write | Read code to find instrumentation, create branches, push commits |
| Pull requests | Read & Write | Open PRs, track PR status |
| Issues | Read & Write | Create issues for teams to review |
| Metadata | Read | Basic repository information |
You can limit Tero to specific repositories during installation. Update repository access anytime in your GitHub App settings.