Files

T

Samuel Enocsson 2555afce19 Initial commit: Azure DevOps TUI client

A terminal-based user interface for browsing and managing Azure DevOps
work items. Features include:

- Browse work items with filtering by area, iteration, state, and type
- View work item details with markdown rendering
- Open work items in browser
- Create git branches from work items
- Update work item state
- Keyboard-driven navigation

🤖 Generated with [Claude Code](https://claude.ai/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-12-04 09:56:11 +01:00

2.4 KiB

Raw Blame History

devops-tui

A terminal user interface (TUI) for Azure DevOps Boards, inspired by jira-cli and JiraTUI.

Features

View Azure DevOps work items in a clean terminal interface
Filter by Sprint, State, and Assigned To
Vim-style navigation (j/k/g/G)
Fullscreen detail view
Open work items in browser
Cross-platform (Windows, macOS, Linux)

Installation

Build from source

go build -o devops-tui .

Move to PATH

mv devops-tui /usr/local/bin/

Configuration

Create a config file at ~/.config/devops-tui/config.yaml:

# Azure DevOps connection
organization: "my-organization"
project: "my-project"
team: "my-team"

# Authentication (or use AZURE_DEVOPS_PAT env variable)
pat: "your-personal-access-token"

# UI settings
theme: "default"

# Default filters at startup
defaults:
  sprint: "current"
  state: "all"
  assigned: "me"

Environment Variables

Variable	Description
`AZURE_DEVOPS_PAT`	Personal Access Token (recommended)
`AZURE_DEVOPS_ORG`	Organization (overrides config)
`AZURE_DEVOPS_PROJECT`	Project (overrides config)
`AZURE_DEVOPS_TEAM`	Team (overrides config)

PAT Permissions

Your Personal Access Token needs these scopes:

Work Items (Read) - Read work items
Project and Team (Read) - List sprints/iterations

Keyboard Shortcuts

Global

Key	Description
`Tab`	Switch to next panel
`Shift+Tab`	Switch to previous panel
`?`	Show/hide help
`Ctrl+r`	Reload data
`q` / `Ctrl+c`	Quit

Key	Description
`j` / `↓`	Move down
`k` / `↑`	Move up
`g`	Go to first item
`G`	Go to last item

Actions

Key	Description
`Enter` / `Space`	Select filter / Open in browser
`v`	View fullscreen details

Detail View

Key	Description
`Esc` / `q`	Back to main view
`Enter`	Open in browser
`j` / `k`	Scroll description

Tech Stack

Bubble Tea - TUI framework
Bubbles - UI components
Lip Gloss - Styling
Viper - Configuration

License

MIT

2.4 KiB Raw Blame History