Skip to content

Standup and changelog

Standup summary

st standup                 # last 24 hours (default)
st standup --hours 48      # look back further
st standup --all           # include all stacks
st standup --json          # raw activity as JSON

Standup summary

Shows merged PRs, opened PRs, recent pushes, and items needing attention. Works with GitHub, GitLab, and Gitea.

Note: "Reviews given" is not yet available on any forge. Efficiently querying reviews authored by a user requires GraphQL (GitHub) or iterating every open PR (GitLab/Gitea), which is too slow for large repositories.

AI standup summary

Generate a concise spoken-style summary using your configured AI agent:

st standup --summary
st standup --summary --hours 48
st standup --summary --agent claude
st standup --summary --jit       # add Jira context via jit

Uses the agent configured under [ai] in ~/.config/stax/config.toml (same agent as st generate --pr-body). Override per-run with --agent.

With --jit, standup inspects your current Jira sprint via the jit CLI and feeds the AI two extra signals:

  • tickets with PRs already in flight
  • likely next backlog tickets without PRs

The summary is word-wrapped into a card fit to your terminal width:

  ✓ Generating standup summary with codex        4.1s

  ╭──────────────────────────────────────────────────────────────────╮
  │                                                                  │
  │  Yesterday I finished the billing webhook retry fix and split    │
  │  the reporting dashboard cleanup into two PRs so review stays    │
  │  small. I also opened a third PR to speed up integration tests   │
  │  by caching seed data, and all three are now in review. Today    │
  │  I'm handling review feedback and preparing the next analytics   │
  │  task.                                                           │
  │                                                                  │
  ╰──────────────────────────────────────────────────────────────────╯

Key phrases are highlighted: completed work in green, new work in cyan, reviews in blue, upcoming tasks in yellow.

Output formats

st standup --summary               # spinner + colored card (default)
st standup --summary --plain-text  # raw text, pipe-friendly
st standup --summary --json        # {"summary": "..."}

Prerequisites

  • An AI agent installed on PATH: claude, codex, gemini, or opencode
  • For --jit: jit on PATH
  • Agent configured in ~/.config/stax/config.toml:
[ai]
agent = "claude"   # or "codex", "gemini", "opencode"

Or pass --agent directly.

Changelog generation

st changelog                   # auto-detect last tag → HEAD
st changelog v1.0.0            # explicit from ref → HEAD
st changelog v1.0.0 v2.0.0     # between two refs
st changelog abc123 def456     # between two commits

PR numbers are extracted from squash-merge commit messages like (#123).

Monorepo tag prefix

With platform-scoped tags like release/ios/v1.2.0, pick the latest tag matching a prefix:

st changelog --tag-prefix release/ios
st changelog --tag-prefix release/android --json

Path filtering

st changelog v1.0.0 --path apps/frontend
st changelog v1.0.0 --path packages/shared-utils

JSON output

st changelog v1.0.0 --json
st changelog --json              # auto-resolved tag appears in "resolved_from"