The Console is the main execution view in GitVertex. It shows open PRs across your connected repositories and groups them into sections so you can see what needs attention first.
Console sections
Pull requests are automatically sorted into the following sections based on their state and your relationship to them.
Needs Your Review
PRs where you are a requested reviewer. These are your highest-priority items — someone on your team is waiting for your feedback.
Returned to You
PRs you authored where a reviewer has requested changes. These need your attention before they can move forward.
Approved
PRs you authored that have been approved by all required reviewers. These are ready to merge or are waiting on CI to pass.
Awaiting Review
PRs you authored that still need review from one or more team members. Use this section to follow up with reviewers or reassign reviews.
Drafts
Draft PRs you authored. These are work-in-progress pull requests that are not yet ready for review.
Waiting for Author
A team-wide section showing PRs where the author likely needs to take action. In team view, any open PR that does not fit another section still lands here so nothing disappears from the console.
Personalized and team views
By default, the console tries to personalize sections around your login. If you have no directly assigned items, GitVertex falls back to the team-wide view so you still see what is happening in the workspace.
PR details
Each pull request card shows:
- Title and PR number with a link to the source on GitHub or GitLab.
- Author — avatar and username of the PR creator.
- Reviewers — avatars of assigned reviewers.
- Review status — approved, changes requested, or review required.
- CI status — success, failure, or pending.
- Merge readiness — mergeable, conflicting, or unknown.
- Branch info — base and head branch names.
- Change summary — files changed, lines added, and lines removed.
- Behind base indicator — whether the PR branch is behind the target branch.
Actions
You can take actions directly from the console without leaving GitVertex:
- Merge — Merge an approved pull request.
- Request review — Assign or reassign reviewers.
- Update branch — Sync the PR branch with the base branch to resolve conflicts.
Action availability depends on the current PR state, repository permissions, and provider response.
Filtering
Use the filter bar to narrow the console view:
- Repository — Show PRs from a specific repository.
- Author — Show PRs by a specific team member.
- Status — Filter by mergeable, behind base, merge conflicts, failing CI, or blocked state.
- Last updated — Limit the view to today, the last 7 or 30 days, or a custom date range.
Auto-refresh
The console automatically refreshes when PRs have pending CI or unknown mergeability. You do not need to manually reload the page in those cases.