cmd

Overview ¶

cmd/cache.go — cache inspection and management.

cmd/mr.go — merge request management with colored terminal diff.

cmd/renovate.go — Renovate bot MR triage for dependency hygiene.

Identifies Renovate MRs by author (renovate-bot, renovate[bot]) or source branch prefix "renovate/", groups by bump type (major/minor/patch), and enables bulk approve or merge.

cmd/search.go — cross-instance full-text search across issues, epics, MRs. Runs concurrent searches against all configured hosts (or a subset via --host).

cmd/shields.go — two complementary features:

1. "badge" subcommand: generate shields.io badge markdown for a project's health metrics (open issues, pipeline, milestone progress, label counts).

2. "chips" subcommand: print colored label chips to the terminal using lipgloss — the in-terminal equivalent of GitLab's label shields. Used internally by the TUI, but also callable standalone.

cmd/standup.go — auto-generate a daily standup from the local journal.

Yesterday section: all journal ops in the last N hours (default 24h, use 72h on Mondays to cover the weekend). Today section: open issues assigned to the current user on the active host. Blockers: issues with label "blocked" assigned to current user.

Output targets: stdout (default), file, Slack webhook, Teams webhook.

cmd/sync.go — bidirectional cross-instance sync for issues, epics, milestones.

Deduplication strategy:

issues/epics  — hidden HTML comment appended to description:
  <!-- ggvalet-sync-src: https://host/group/proj/-/issues/42 -->
  Safe to re-run: items already carrying this marker are skipped.
milestones    — title-match on the destination (milestones have no body).

cmd/timeline.go — Gantt-style terminal timeline for epics and milestones.

Example output:

Timeline — gitlab.thalesdigital.io            ↓ today (2026-05-28)
2026  Apr       May       Jun       Jul       Aug       Sep
──────────────────────────────────────────────────────────────────
◆ Q3 Security Hardening                             65%
  ████████████████████████████████░░░░░░░░░░░░░░░░░
⬡ Sprint 12                    done
  ██████████████████████████████████  100%
⬡ Sprint 13
      ██████████████████░░░░░░░░░░░░  48%
⬡ Sprint 14
                    ░░░░░░░░░░░░░░░░   0%

cmd/tui.go — interactive terminal UI for ggvalet.

Layout (80×24 example):

┌─ ggvalet ────────────── host: gitlab.thalesdigital.io ─┐
│  [Issues]  Epics  Milestones  Journal                       │
├───────────────────────────┬──────────────────────────────────┤
│  ● #42 Implement OIDC…   │  #42 Implement OIDC refresh      │
│  ● #41 Fix JWT expiry…   │                                  │
│  ✓ #40 SHIELD forensics  │  State:    ● opened              │
│                           │  Assignee: @nchorfa              │
│                           │  Milestone: Sprint 14            │
│                           │  Labels:   security · backend    │
│                           │  ──────────────────────          │
│                           │  Description…                    │
├───────────────────────────┴──────────────────────────────────┤
│  Tab/1-4: switch  j/k: navigate  /: filter  o: open  q: quit│
└──────────────────────────────────────────────────────────────┘

Work Items are a newer GitLab feature, available via both REST and GraphQL. This file uses the host-neutral provider.WorkItem surface, which maps to GitLab's /projects/:id/work_items REST endpoint. On GitHub/Gitea the provider returns ErrUnsupported. Requires GitLab 15.1+ with work_items feature flag enabled on your instance.