Cf

cf - Claude Flow SPARC Launcher

A convenient command-line tool for launching Claude Flow SPARC sessions with integrated git worktree management and tmux support.

[claude-flow](https://github.com/ruvnet/claude-code-flow)

[tmux](https://github.com/tmux/tmux/wiki)

Features

• 🚀 Quick SPARC Sessions: Launch Claude Flow SPARC with prompts or interactively
• 🌿 Git Worktree Integration: Automatically create feature branches and worktrees
• 📺 Tmux Window Support: Run sessions in dedicated tmux windows
• ⚙️ Configurable: Customize editor, paths, and naming conventions
• 🔧 Smart Dependencies: Auto-detects and guides installation of required tools

Installation

Prerequisites

• Node.js & npm/npx - For claude-flow installation
• git - For version control and worktree management
• tmux - Optional, only needed for --window option

Quick Setup

1. Make the script executable:

   chmod +x cf

2. Place it in your PATH:

   # Example: copy to a directory in your PATH
   cp cf ~/.local/bin/cf
   # or
   sudo cp cf /usr/local/bin/cf

3. Run it - it will automatically initialize claude-flow if needed:

   cf

Usage

Basic Usage

# Interactive mode - opens editor for prompt
cf

# Interactive mode with NAME (uses config defaults)
cf auth

# Direct prompt mode
cf auth --prompt "Build a REST API for user authentication"

# Show help
cf --help

Git Worktree Integration

# Create feature branch and worktree (explicit)
cf --worktree auth --prompt "Implement user authentication"

# With config enabled (CF_ENABLE_WORKTREE="true"), use NAME directly
cf auth --prompt "Implement user authentication"

# This creates:
# - Branch: feature/auth
# - Worktree: ./worktrees/auth/
# - Runs claude-flow in the worktree directory

Tmux Window Mode

# Run in new tmux window (explicit)
cf --window api --prompt "Build REST API endpoints"

# With config enab