stax 0.29.4

Fast stacked Git branches and PRs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

# Standup and Changelog

## Standup summary

```bash
st standup                   # Last 24 hours (default)
st standup --hours 48        # Look back further
st standup --all             # Include all stacks, not just current
st standup --json            # Raw activity data as JSON
```

![Standup summary](../assets/standup.png)

Shows merged PRs, opened PRs, recent pushes, and items that need attention.

## AI standup summary

Generate a concise spoken-style summary of your activity using an AI agent:

```bash
st standup --summary
st standup --summary --hours 48
st standup --summary --agent claude
st standup --summary --agent gemini
st standup --summary --jit
```

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

When `--jit` is enabled, standup also inspects your current Jira sprint via the `jit` CLI and feeds the AI two extra signals:
- tickets that already have PRs in flight
- likely next backlog tickets without PRs yet

The summary is word-wrapped and displayed in a card that fits 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, and upcoming tasks in yellow.

### Output formats

```bash
st standup --summary                   # Spinner + colored card (default)
st standup --summary --plain-text      # Raw text, no colors — pipe-friendly
st standup --summary --json            # {"summary": "..."} JSON
st standup --summary --jit             # Add Jira context via jit
```

### Prerequisites

- An AI agent installed and on `PATH`: `claude`, `codex`, `gemini`, or `opencode`
- Agent configured in `~/.config/stax/config.toml`:

```toml
[ai]
agent = "claude"   # or "codex", "gemini", "opencode"
```

Or pass `--agent` directly to skip config.

## Changelog generation

```bash
st changelog v1.0.0
st changelog v1.0.0 v2.0.0
st changelog abc123 def456
```

### Monorepo filtering

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

### JSON output

```bash
st changelog v1.0.0 --json
```

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