Get current flow state metrics with security scanning.

Returns metrics about repository health including:

• minutes_since_last_commit: Time elapsed since last commit

• uncommitted_lines: Total lines changed

• uncommitted_files: Number of modified files

• branch_name: Current Git branch

• status: Health indicator (ok, warning, danger)

• security_flags: Any detected security issues

Get actionable recommendations with security awareness.

Analyzes repository and returns suggestions based on:

• Commit frequency and change size thresholds

• Branch age and main-branch synchronization

• Security scan results

Update FlowCheck configuration thresholds.

Supported parameters:

• max_minutes_without_commit: Minutes before suggesting checkpoint (default: 60)

• max_lines_uncommitted: Lines before suggesting split (default: 500)

Search commit history semantically.

Find commits by meaning rather than exact keyword matching. Example: "authentication changes" finds commits about OAuth, login, tokens.

Validate current work against ticket requirements.

Checks if code changes align with the stated ticket/task. Flags scope creep using GitHub Issues integration.

Sanitize content by redacting secrets and PII.

Use this before including file contents in prompts or outputs. Replaces sensitive data with [REDACTED_TYPE] tokens.

Start a new FlowCheck session for audit correlation.

Sessions help correlate tool calls across a task for auditing. Call this at the beginning of a task.

Get information about the current session.

Returns session statistics including:

• session_id: Unique session identifier

• tool_calls: Number of tool calls in this session

• duration_seconds: Session duration

Returns: Dictionary with session information.

End the current FlowCheck session.

Call this at the end of a task to finalize audit records.

Returns: Dictionary with final session statistics.