iFlow CLI GitHub Action

Run iFlow CLI commands within your GitHub workflows

github.com/iflow-ai/iflow-cli-action

A Docker-based action with Node.js 22, npm, and uv pre-installed

Key Features

Docker-based

Pre-installed Node.js 22, npm, and uv for optimal performance

Configurable Auth

Support for iFlow API authentication with custom endpoints

Flexible Execution

Timeout control and working directory configuration

GitHub Integration

Summary reports in PRs and seamless issue/PR workflows

Installation & Usage

Add to your GitHub workflow:

- name: Run iFlow CLI
  uses: iflow-ai/iflow-cli-action@v1.3.0
  with:
    prompt: "Analyze this codebase"
    api_key: \${{ secrets.IFLOW_API_KEY }}

See documentation for detailed setup instructions

Issue Triage Example

- name: iFlow CLI Issue Triage
  uses: iflow-ai/iflow-cli-action@v1.3.0
  with:
    api_key: \${{ secrets.IFLOW_API_KEY }}
    prompt: |
      ## Role
      You are an issue triage assistant...
      
      ## Steps
      1. Run: \`gh label list\` to get all available labels
      2. Review the issue title and body
      3. Classify by kind and priority
      4. Apply labels with \`gh issue edit\`
      5. Remove "status/needs-triage" if present

Advanced Features

Custom Settings

Provide complete settings.json for advanced configuration

MCP Servers

Connect to external tools via Model Context Protocol

Pre-Execution Commands

Run setup commands before iFlow execution with precmd

Extra Arguments

Pass additional CLI arguments with extra_args

Common Use Cases

Code Review

prompt: "Review this PR for quality, security, and best practices"

Documentation

prompt: "/init && Generate comprehensive API documentation"

Testing

prompt: "Suggest a comprehensive testing strategy"

Architecture

prompt: "Analyze system architecture for improvements"

Configuration Options

Input Description Required
prompt The prompt to execute with iFlow CLI Yes
api_key iFlow API key for authentication Yes
base_url Custom base URL for iFlow API No
model Model name to use (default: Qwen3-Coder) No
timeout Timeout in seconds (1-86400) No

Available Models

  • Qwen3-Coder (default) - Excellent for code analysis and generation
  • Kimi-K2 - Good for general AI tasks and longer contexts
  • DeepSeek-V3 - Advanced reasoning and problem-solving
  • Custom models supported via OpenAI-compatible APIs

Get your API key at iflow.cn

Thank You!

Explore the possibilities with iFlow CLI GitHub Action

Documentation: iflow-ai.github.io/iflow-cli-action

Contribute: GitHub Repository

License: MIT