Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/8BitTacoSupreme/flowstate/llms.txt

Use this file to discover all available pages before exploring further.

flowstate check verifies that the claude CLI is reachable and prints the resolved binary path along with the timeout and max-turns configuration that FlowState will use for bridge calls. Run this before flowstate init to confirm your Claude Code installation is correctly detected.

​
Synopsis

flowstate check [OPTIONS]

​
Options

​
--root PATH
string
default:"."
Project root directory. Used when constructing the bridge configuration (e.g. to resolve FLOWSTATE_CLAUDE_BIN relative paths).

​
Output

​
When the claude CLI is found

claude CLI found: /Users/you/.local/bin/claude
Timeout: 300s | Max turns: 10
  • Path — the absolute path to the detected claude binary
  • Timeout — the subprocess timeout in seconds (default: 300s)
  • Max turns — the --max-turns value passed to the claude CLI (default: 10)

​
When the claude CLI is not found

claude CLI not found.
Install Claude Code or set FLOWSTATE_CLAUDE_BIN to the binary path.

​
Detection order

FlowState searches for the claude binary in this order:
  1. The FLOWSTATE_CLAUDE_BIN environment variable (if set and the file exists)
  2. claude on your PATH (via which)
  3. Common install locations:
    • ~/.local/bin/claude
    • /usr/local/bin/claude
    • /opt/homebrew/bin/claude

​
Overriding the binary path

Set FLOWSTATE_CLAUDE_BIN to point to a non-standard install location: 
export FLOWSTATE_CLAUDE_BIN="/custom/path/to/claude"
flowstate check

​
Example

flowstate check

​
Notes

  • flowstate check is read-only and makes no changes to your project or state file.
  • If claude is not found, flowstate init will fall back to dry-run mode automatically rather than failing.
  • For Claude Code installation instructions, see the Installation guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us