gws is a sophisticated CLI tool designed to bridge the gap between technical code changes and business impact. It leverages cutting-edge AI to automate your daily standups, pull request descriptions, and project management updates.
Choose the AI that fits your workflow. Support for Google Gemini Pro, Anthropic Claude 3, and Local Ollama (Llama 3/Mistral) for privacy-conscious environments.
Generate professional reports in JSON, Markdown, or Premium HTML. Use the specialized HTML template for management reviews with responsive design and high-impact visuals.
gws pr create now performs an AI-driven Risk Assessment. It calculates impact levels, identifies sensitive code areas (Security, API, DB), and automatically applies categorized GitHub labels.
Summarize the collective work of an entire GitHub Organization or Team with one command (--org). Generate persona-driven reports for Managers (strategic impact) or Auditors (evidence-based performance reviews).
Gain data-driven insights into project health. gws automatically calculates Health Scores (0-10) and identifies Predictive Bottlenecks by analyzing the ratio of feature development to technical debt.
Total control over your reporting engine. Use Custom AI Templates (~/.gws/templates/) to override prompts, or use the Webhook Listener to trigger summaries from external CI/CD events.
brew tap RDX463/tap
brew install RDX463/tap/github-work-summaryDownload the latest release from the Releases page and move it to your /usr/local/bin.
- GitHub Login:
gws login - AI Provider:
gws ai-login --provider gemini - Project Context (Optional):
gws tickets-login jira - Run Summary:
gws summary -i --ai
| Command | Description |
|---|---|
gws summary |
Generate work reports. Use -i for TUI, --ai for insights. |
gws pr create |
Create an AI-powered Pull Request from your current branch. |
gws schedule |
Configure automated background reports (macOS). |
gws watch |
Monitor your schedule in a persistent foreground process. |
gws tickets-login |
Securely store Jira or Linear API credentials. |
gws ai-login |
Configure Gemini or Anthropic API keys. |
gws profiles |
Manage different work/client/OSS configurations. |
gws share setup |
Configure Slack, Discord, Teams, Notion, or Email. |
gws webhook start |
Start an HTTP listener for event-driven summaries. |
Your privacy is paramount. GWS never stores secrets in plain text.
- GitHub Tokens & API Keys: Stored securely in the native system keychain (macOS Keychain, Linux Secret Service).
- Local AI: Use Ollama to keep all your code analysis entirely on-device.
MIT © RDX463