{"_id":"@aaaaorg/releasebrief","name":"@aaaaorg/releasebrief","dist-tags":{"latest":"1.1.3"},"versions":{"1.1.3":{"name":"@aaaaorg/releasebrief","version":"1.1.3","description":"AI-powered work summaries from git history. Turn commits into release briefs, standup reports, and team recaps.","type":"module","main":"src/index.js","bin":{"releasebrief":"bin/releasebrief.js"},"scripts":{"test":"node test/run.js","start":"node bin/releasebrief.js"},"keywords":["git","standup","summary","ai","releasebrief","recap","commits","llm","openai","anthropic","ollama","developer-tools","productivity","cli","changelog","weekly-report"],"author":{"name":"aaaaorg"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aaaaorg/releasebrief.git"},"homepage":"https://github.com/aaaaorg/releasebrief#readme","bugs":{"url":"https://github.com/aaaaorg/releasebrief/issues"},"dependencies":{"commander":"^12.1.0","conf":"^13.0.1","chalk":"^5.3.0","inquirer":"^9.3.7","ora":"^8.1.1"},"engines":{"node":">=18.0.0"},"gitHead":"6aa0b011a14b3731c3458998e7031f9203c88747","_id":"@aaaaorg/releasebrief@1.1.3","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-5EFwmCzBcplyTaqlSAz93//iKq6AJFrIqF2xhAQby8+cWeULTBWAXGZ6SnxwoBShrNoyoG5qYjpdhpdzL9NtSA==","shasum":"aad40a0064c5bb5f20a7df56ff1c2f08c02a11ea","tarball":"https://registry.npmjs.org/@aaaaorg/releasebrief/-/releasebrief-1.1.3.tgz","fileCount":13,"unpackedSize":32777,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFuBwGiaScNOL/ARlt+yKH2XLw3uXOeWJlAF2A2g2L0HAiEA8wZVpelT1PBSP9VnZ8b+OeQh+yLkYiWlh7QzFEux/zU="}]},"_npmUser":{"name":"koc","email":"kosekdraw@gmail.com"},"directories":{},"maintainers":[{"name":"koc","email":"kosekdraw@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/releasebrief_1.1.3_1770997422845_0.20921044997288374"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-13T15:43:42.735Z","1.1.3":"2026-02-13T15:43:42.996Z","modified":"2026-02-13T15:43:43.195Z"},"maintainers":[{"name":"koc","email":"kosekdraw@gmail.com"}],"description":"AI-powered work summaries from git history. Turn commits into release briefs, standup reports, and team recaps.","homepage":"https://github.com/aaaaorg/releasebrief#readme","keywords":["git","standup","summary","ai","releasebrief","recap","commits","llm","openai","anthropic","ollama","developer-tools","productivity","cli","changelog","weekly-report"],"repository":{"type":"git","url":"git+https://github.com/aaaaorg/releasebrief.git"},"author":{"name":"aaaaorg"},"bugs":{"url":"https://github.com/aaaaorg/releasebrief/issues"},"license":"MIT","readme":"# releasebrief\n\n**Turn git commits into useful summaries.** AI-powered standups, weekly recaps, and team reports from your commit history.\n\n```bash\nnpx @aaaaorg/releasebrief --week\n```\n\n```\n📋 Git Recap — 47 commits across 3 repos\n\n## Summary\nThis week focused on user authentication and performance improvements.\nKey changes include OAuth integration, caching layer optimization, and\nseveral bug fixes in the payment flow.\n\n### Highlights\n- ✨ Added OAuth2 support for Google and GitHub login\n- ⚡ Reduced API response time by 40% with Redis caching\n- 🐛 Fixed race condition in payment webhook handling\n```\n\n## Features\n\n- 🕐 **Time-based summaries**: `--week`, `--today`, `--since \"Monday\"`\n- 📁 **Multi-repo support**: Scan multiple projects at once\n- 👥 **Team mode**: Get summaries for your whole team\n- 🤖 **Multiple AI providers**: OpenAI, Anthropic, Ollama, OpenRouter\n- 📝 **Flexible formats**: Markdown, plain text, Slack-ready, JSON\n- ⚡ **No AI mode**: Just list commits with `--no-ai`\n\n## Quick Start\n\n```bash\n# Install globally\nnpm install -g @aaaaorg/releasebrief\n\n# Configure your AI provider\nreleasebrief setup\n\n# Generate a weekly summary\nreleasebrief --week\n```\n\n## Usage\n\n```bash\n# Today's commits\nreleasebrief --today\n\n# Last 7 days\nreleasebrief --week\n\n# Custom date range\nreleasebrief --since \"2026-01-01\" --until \"2026-01-31\"\n\n# Filter by author\nreleasebrief --week --author \"Jane\"\n\n# Team summary (all authors)\nreleasebrief --week --team\n\n# Scan multiple repos\nreleasebrief --week --repos ~/projects/app ~/projects/api\n\n# Include file change stats for richer AI context\nreleasebrief --week --diff-stats\n\n# Skip AI, just list commits\nreleasebrief --week --no-ai\n\n# Output as JSON\nreleasebrief --week --format json\n```\n\n## Configuration\n\nRun `releasebrief setup` to configure your AI provider:\n\n```bash\nreleasebrief setup\n# Follow the prompts to set provider and API key\n```\n\nOr set environment variables:\n```bash\nexport OPENAI_API_KEY=\"sk-...\"\n# or\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\n```\n\nCheck current config:\n```bash\nreleasebrief config\n```\n\n### Supported Providers\n\n| Provider | Models | Notes |\n|----------|--------|-------|\n| OpenAI | gpt-4o, gpt-4o-mini, etc. | Best quality |\n| Anthropic | claude-3-5-sonnet, etc. | Great for nuanced summaries |\n| Ollama | llama3.2, mistral, etc. | Free, runs locally |\n| OpenRouter | Any model | Gateway to many providers |\n\n## CI / Automation\n\nRun releasebrief in CI pipelines with zero interactivity:\n\n```bash\n# CI mode: env-var config, no spinners, no prompts\nANTHROPIC_API_KEY=sk-ant-... releasebrief --ci --week --output summary.md\n\n# Post to Slack or Discord via webhook\nreleasebrief --ci --week --webhook https://hooks.slack.com/services/...\n\n# Combine: save file + post webhook + suppress stdout\nreleasebrief --ci --week --output summary.md --webhook $SLACK_URL --quiet\n```\n\n### GitHub Action\n\n```yaml\n- uses: aaaaorg/releasebrief@v1\n  with:\n    provider: anthropic\n    api-key: ${{ secrets.ANTHROPIC_API_KEY }}\n    args: --week --format slack\n    webhook: ${{ secrets.SLACK_WEBHOOK }}\n```\n\n## Output Formats\n\n- **markdown** (default): Clean markdown with headers\n- **plain**: Simple text, no formatting\n- **slack**: Slack-flavored markdown with emojis\n- **json**: Structured data for pipelines\n\n## Examples\n\n### Daily Standup\n```bash\nreleasebrief --today --format plain\n```\n\n### Weekly Team Report\n```bash\nreleasebrief --week --team --repos ~/work/*\n```\n\n### Monthly Summary for a Specific Author\n```bash\nreleasebrief --since \"2026-01-01\" --until \"2026-01-31\" --author \"alice\"\n```\n\n## Requirements\n\n- Node.js 18+\n- Git (in PATH)\n- API key for your chosen LLM provider (or Ollama running locally)\n\n## License\n\nMIT © aaaaorg\n","readmeFilename":"README.md","_rev":"1-99d69e9ab661c274eef19751ca086f4e"}