Changes
List and inspect change proposals from the CLI.
Change proposals are created when you run st push. They represent a feature branch that is proposed to be merged into dev. You can list, inspect, and act on them from the CLI.
st changes
List all change proposals for the current project.
st changesOutput:
ID TITLE STATUS +/- AUTHOR AGE
────────────────────────────────────────────────────────────────────────────────────────────
chg_abc123 Add dark mode toggle proposed +45/-3 alice 2m
chg_def456 Fix signup validation needs_restack +12/-1 bob 1h
chg_ghi789 Set up Tailwind CSS merged +80/-0 alice 3h
Statuses
| Status | Meaning |
|---|---|
proposed | Open and waiting for review |
merged | Approved and merged into dev |
denied | Rejected — branch changes were not merged |
needs_restack | Has conflicts with dev and must be restacked before merging |
Options
| Flag | Description |
|---|---|
--status <status> | Filter by status: proposed, merged, denied, needs_restack |
--mine | Show only changes proposed by the currently logged-in user |
Examples
# Show only open changes
st changes --status proposed
# Show only your changes
st changes --minest change <id> [action]
View details of a specific change, or perform an action on it.
# View details
st change chg_abc123
# Approve (merge into dev)
st change chg_abc123 approve
# Deny (reject without merging)
st change chg_abc123 deny
# Restack (rebase onto current dev to resolve conflicts)
st change chg_abc123 restackViewing a change
st change chg_abc123Output:
Add dark mode toggle
Status: proposed
Branch: add-dark-mode
Author: alice
Age: 2m
Files changed:
~ app/settings/page.tsx
~ components/theme-toggle.tsx
https://app.strayl.dev/alice/my-app?change=chg_abc123
Actions
| Action | Description |
|---|---|
approve | Merge the change into dev |
deny | Reject the change (branch is not merged) |
restack | Rebase the branch onto current dev to resolve needs_restack conflicts |