WTF — Personal Information Dashboard for Your Terminal

Introduction

WTF is a terminal-based personal information dashboard written in Go. It displays data from dozens of services and APIs in a customizable grid layout, giving developers a unified at-a-glance view of their tools and workflows without leaving the terminal.

What WTF Does

• Displays real-time data from GitHub, GitLab, Jira, Jenkins, and more
• Monitors infrastructure via modules for Datadog, New Relic, and OpsGenie
• Shows weather, calendar events, todo lists, and Hacker News feeds
• Supports custom scripts and command output as dashboard widgets
• Provides keyboard navigation for interacting with modules

Architecture Overview

WTF uses a YAML configuration file to define a grid layout of modules. Each module runs independently, polling its data source at a configurable interval. The UI is built on the tview library for Go terminal applications, and each module renders its data into its assigned grid cell. Modules communicate with external APIs using standard HTTP clients.

Self-Hosting & Configuration

• Install via go install, Homebrew (brew install wtfutil), or download binaries
• Configure via ~/.config/wtf/config.yml with grid positions and module settings
• Each module has its own configuration block with API keys and refresh intervals
• Grid layout uses row/column positioning with configurable heights and widths
• Sensitive data like API tokens can be loaded from environment variables

Key Features

• Over 50 built-in modules covering DevOps, productivity, and finance
• Hot-reloading of configuration without restarting the application
• Custom module support for running arbitrary shell commands
• Keyboard shortcuts for focusing, scrolling, and interacting with modules
• Lightweight single binary with no external runtime dependencies

Comparison with Similar Tools

• Sampler — YAML-configured terminal dashboard, focused on shell command visualization
• Grafana — Web-based dashboards for metrics, much heavier and requires a server
• Dashy — Self-hosted web dashboard for links and services, not terminal-based
• Glances — System monitoring TUI, focused on hardware metrics rather than services

FAQ

Q: How do I add a GitHub module? A: Add a GitHub configuration block in config.yml with your personal access token, then set the repository and username fields.

Q: Can I display output from custom scripts? A: Yes. The CmdRunner module executes any shell command and displays its output in a dashboard cell.

Q: Does WTF support multiple configuration profiles? A: Yes. Use the --config flag to point to different YAML files for different contexts.

Q: What are the system requirements? A: WTF runs on any system with a terminal that supports 256 colors. It needs Go 1.16 or later for building from source.

Sources

• https://github.com/wtfutil/wtf
• https://wtfutil.com