standup-ai 0.1.0

Generate your daily standup from git history using AI

standup-ai

Generate your daily standup from git history — in seconds.

standup-ai                         # scan current dir, auto-detect provider
standup-ai ~/projects ~/work       # scan multiple project directories
standup-ai --style slack --copy    # Slack format, copy to clipboard
standup-ai --hours 48              # look back 2 days
standup-ai --provider ollama       # no API key needed

---

The problem

Every developer on a remote team has to write a daily standup:

"Yesterday I worked on auth, fixed a bug in the login flow, started the JWT implementation. Today I'll finish JWT and write tests."

You already did the work. Why are you also writing about it?

standup-ai reads your git commits and writes the standup for you.

---

Demo

$ standup-ai ~/projects --style slack --copy

╭─────────────────────────── Daily Standup (slack) ──────────────────────────╮
│                                                                              │
│  Shipped JWT auth and fixed two production bugs                              │
│                                                                              │
│  • [gitbrief] Added --changed-only flag for PR review mode                  │
│  • [gitbrief] Implemented git diff embedding with --include-diff            │
│  • [api-service] Fixed null pointer in /users/profile endpoint              │
│  • Today: finish JWT refresh token rotation, write integration tests        │
│                                                                              │
╰──────────────────────────── 4 commits · gitbrief, api-service ─────────────╯

✓ Copied to clipboard

---

Why standup-ai?

git-standup (6k stars) is the closest thing — it lists raw commits from the last 24 hours. Great for finding what you did, but you still have to write the standup yourself.

standup-ai goes further:

Feature	standup-ai	git-standup	manual
Scans multiple repos	✅	✅	❌
AI-generated summary	✅	❌	❌
Slack/bullet/standard styles	✅	❌	❌
Auto-detects your author	✅	✅	❌
Clipboard copy	✅	❌	❌
Works with local LLMs	✅	❌	❌
No API key required (Ollama)	✅	✅	✅

---

Install

pip install standup-ai

Or with pipx (recommended):

pipx install standup-ai

Requires Python 3.9+.

---

Quick Start

# Auto-detects provider from env (ANTHROPIC_API_KEY or OPENAI_API_KEY)
standup-ai

# Scan multiple project directories
standup-ai ~/projects ~/side-projects

# Slack format, copy to clipboard
standup-ai --style slack --copy

# Look back 2 days (e.g. Monday morning for Friday+weekend)
standup-ai --hours 48

# No API key needed — use Ollama
standup-ai --provider ollama --model llama3.2

# Show raw commits before generating
standup-ai --show-commits

# Raw output for piping
standup-ai --raw > standup.txt

---

Providers

Provider	Flag	Requires
Claude (default if key exists)	--provider claude	ANTHROPIC_API_KEY
OpenAI	--provider openai	OPENAI_API_KEY
Ollama (local, free)	--provider ollama	Ollama running

Using Ollama (no API key)

# Install Ollama: https://ollama.ai
ollama pull llama3.2

standup-ai --provider ollama --model llama3.2

---

Output Styles

--style standard (default)

**Yesterday:**
- [myrepo] Implemented JWT authentication with refresh token rotation
- [api-service] Fixed null pointer exception in profile endpoint

**Today:**
- Write integration tests for JWT flow
- Code review on open PRs

**Blockers:**
- None

--style bullet

- Added JWT auth and refresh tokens [myrepo]
- Fixed profile endpoint bug [api-service]
- Today: integration tests + PR reviews

--style slack

Shipped JWT auth and fixed a prod bug

* [myrepo] JWT authentication with refresh token rotation
* [api-service] Profile endpoint null pointer fix
* Today: tests + code review

---

Options

standup-ai [PATH...] [OPTIONS]

Arguments:
  PATH...          Directories to scan (default: current directory)

Options:
  --hours INT      How many hours back to look [default: 24]
  --author TEXT    Filter by author name/email (auto-detected if not set)
  --no-filter      Include all authors (don't filter to current user)
  --provider       claude | openai | ollama (auto-detected from env)
  --model TEXT     Override model name
  --style          standard | bullet | slack [default: standard]
  --copy           Copy output to clipboard
  --raw            Plain text output (no formatting)
  --show-commits   Print raw commits found before generating
  -V, --version    Show version
  -h, --help       Show this message and exit

---

Tips

# Monday morning -- get Friday + weekend commits
standup-ai --hours 72

# Team standup: see what everyone did (no author filter)
standup-ai --no-filter --hours 24

# Add to your shell as an alias
alias standup='standup-ai ~/projects --style slack --copy'

# See what commits were found before generating
standup-ai --show-commits --provider ollama

---

Development

git clone https://github.com/faw21/standup-ai
cd standup-ai
python -m venv .venv && source .venv/bin/activate
.venv/bin/pip install -e ".[dev]"
pytest tests/   # 55 tests, 88% coverage

---

Related Tools

gitbrief — Pack the right files from any repo into LLM-ready context using git history.

gpr — AI-powered PR descriptions and commit messages from your git diff.

# The full AI-powered git workflow:
standup-ai                    # 1. morning standup
gitbrief . --changed-only     # 2. pack context for code review
gpr                           # 3. generate PR description
gpr --commit-run              # 4. commit with AI message

---

License

MIT