bored

README

bored 😴

A TUI for Azure DevOps Boards

Screenshots

Main board

Creating a new issue

Issue details

Installation

go install github.com/laupski/bored@latest

See releases for more info.

Features

Security and Configuration

• Keychained Credentials - PAT stored securely in system keychain
• TOML Config Support - Customizable settings in ~/.config/bored/config.toml

Work Item Management

• View work items in a tabular board view
• Create new work items (Bug, Task, User Story, Feature, Epic)
• Edit work item details (title, state, assigned to, tags)
• Delete work items with confirmation (type title to confirm)
• Open work items in browser

Comments

• View comments with scroll support
• Add new comments
• @mention highlighting

Hierarchy and Related Items

• View parent/child relationships
• Create child work items
• Create parent work items
• Remove hierarchy links
• Navigate directly to related items

Iterations

• View current iteration/sprint
• Change work item iteration

Planning

• Dynamic planning fields based on work item type
• Story Points, Original Estimate, Remaining Work, Completed Work

Filtering and Navigation

• Filter "My Items" vs "All Items"
• Server-side pagination for large backlogs
• Vim-style keyboard navigation (j/k, h/l)
• Dynamic work item types (fetched from project)

Notifications

• Change notifications with system sound alerts
• Automatic tracking of work item revisions

License

Apache 2.0

Documentation

Overview

Package main is the entry point for bored, a terminal user interface (TUI) application for managing Azure DevOps Boards work items.

Installation

Install bored using Go:

go install github.com/laupski/bored@latest

Features

Bored provides a full-featured terminal interface for Azure DevOps including:

• View and manage work items (Bug, Task, User Story, Feature, Epic)
• Create, edit, and delete work items
• Add and view comments with @mention highlighting
• Manage parent/child hierarchy relationships
• Change iterations/sprints
• Update planning fields (Story Points, Estimates, etc.)
• Filter between "My Items" and "All Items"
• Vim-style keyboard navigation (j/k, h/l)
• Change notifications with system sound alerts

Configuration

Credentials are stored securely in the system keychain. Application settings are stored in a TOML config file:

• Linux: ~/.config/bored/config.toml
• macOS: ~/Library/Application Support/bored/config.toml
• Windows: %APPDATA%\bored\config.toml

Packages

The application is organized into the following packages:

• github.com/laupski/bored/azdo: Azure DevOps REST API client
• github.com/laupski/bored/tui: Terminal UI components using Bubble Tea

Package main provides the entry point for bored, a TUI application for managing Azure DevOps Boards work items from the terminal.