- OAuth 2.0 Device Flow login with secure OS keychain storage
- Interactive startup dashboard menu with keyboard navigation
- Interactive multi-select repository picker in terminal
- Commit fetch for selected repos (last 24 hours)
- Categorized output: Features/Implementations, Bug Fixes, Other
- Colorized summary output with per-repo grouping
logoutcommand to remove saved token safely- Built-in update notifier with changelog highlights when a newer release exists
curl -fsSL https://raw.githubusercontent.com/RDX463/github-work-summary/main/install.sh | bashbrew tap RDX463/tap
brew install RDX463/tap/github-work-summarygws # Interactive dashboard menu
gws login
gws summary
gws logout# Latest release
curl -fsSL https://raw.githubusercontent.com/RDX463/github-work-summary/main/install.sh | bash
# Specific version
curl -fsSL https://raw.githubusercontent.com/RDX463/github-work-summary/main/install.sh | GWS_VERSION=v0.1.1 bashInstaller outputs:
github-work-summarygws(shortcut)
- Download matching archive from Releases.
- Extract binary.
- Move binary into a folder on
PATH.
go install github.com/RDX463/github-work-summary@latestgit clone https://github.com/RDX463/github-work-summary.git
cd github-work-summary
go build -o github-work-summary .gws # Interactive startup menu (arrow keys + enter)
gws login # Authenticate with GitHub
gws repos # Pick repositories interactively
gws summary # Generate work summary (last 24h)
gws logout # Remove stored token from keychain
gws --help # Show all commands
gws --version # Show installed versionInside repos and summary repo picker:
1 3 5toggle specific items2-6toggle a rangeaselect allnclear allddoneqcancel
If your installed version is older than the latest GitHub release, the CLI shows:
- current version -> latest version
- changelog highlights (top bullet points from latest release notes)
- direct update command
Disable update checks (for CI/non-network environments):
export GWS_NO_UPDATE_CHECK=1- Open
https://github.com/settings/developers - Go to OAuth Apps -> your app
- Enable Device Flow
Optional credential env vars:
GITHUB_CLIENT_IDGITHUB_CLIENT_SECRET
Tokens are stored using native OS credential stores:
- macOS: Keychain
- Linux: Secret Service (
gnome-keyringcompatible) - Windows: Credential Manager
Enable Device Flow in your GitHub OAuth App settings.
gws logingws loginIf there are no commits in the last 24 hours, summary prints a clean no-activity message.
go fmt ./...
go build ./...
go test ./...See CONTRIBUTING.md for setup, PR guidelines, and testing checklist.
See SECURITY.md for supported versions and private vulnerability reporting.
MIT.