/flowforge:session:pause

/flowforge:session:pause is the lightweight counterpart to /flowforge:session:end. It pauses the timer, commits and pushes any pending work, and updates the ticket — but keeps the session record intact so you can resume without re-detecting the ticket.

Synopsis

/flowforge:session:pause [commit-message]

From outside Claude Code:

flowforge run flowforge:session:pause [commit-message]

Description

Use pause for short interruptions: a coffee break, a stand-up, a context switch to another task for thirty minutes. The session manifest stays on disk, the timer pauses (it does not stop), the issue receives a progress update, and any uncommitted changes are committed and pushed under either an explicit message or an auto-generated WIP message.

Distinguish carefully from /flowforge:session:end:

Pause keeps the session “open” for resumption. The issue is not closed. The branch is not torn down.
End is the final ceremony: the session manifest is archived, the timer stops, and any closing actions configured for end-of-session run.

If you are unsure which to use, default to pause. The next /flowforge:session:start will pick up where you left off.

Arguments

Position	Name	Required	Description
1	`commit-message`	no	Override the auto-generated `WIP: ...` commit message. When omitted, the command synthesizes a message from the current ticket title and changeset. The literal values `?` and `help` print an in-terminal usage block and exit `0`.

Options

None.

Environment variables

Variable	Direction	Purpose
`ARGUMENTS`	read	Receives the commit message when invoked through the slash-command runtime.
`DEBUG`	read	When set to `1`, enables `set -x` tracing for the bash body.

Examples

Pause with an auto-generated commit message:

/flowforge:session:pause

Pause with an explicit message:

/flowforge:session:pause "WIP: auth flow scaffolding"

Pause with debug tracing:

DEBUG=1 /flowforge:session:pause

Print in-terminal help:

/flowforge:session:pause ?

A successful pause produces output of this shape:

Pausing current work session...
Committed: WIP: auth flow scaffolding
Pushed: feature/123-add-auth -> origin
Timer paused at 01:23:45.

Exit codes

Code	Meaning
`0`	Session paused (resumable), changes committed and pushed.
Non-zero	A precondition failed — typically not in a git repository or not in a FlowForge session. The error message points at the corrective action.

/flowforge:session:start — resume after a pause.
/flowforge:session:end — close the session entirely.
/flowforge:dev:status — confirm timer state.
Sessions — the lifecycle this command participates in.