iFlow CLI GitHub Action

iFlow CLI Action Icon

Run iFlow CLI commands within GitHub workflows

GitHub Repository

Key Features

Docker-based action with pre-installed Node.js, npm, go, cargo, and uv
Configurable authentication with iFlow API
Support for MCP (Model Context Protocol) servers
Agent Client Protocol with Rust WebSocket client
GitHub Actions Summary integration
PR/Issue Integration with comments and reviews

Installation Guide

Basic Usage

Using the action in your GitHub workflow is simple:

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

Getting Started

  1. Add iFlow API key to your GitHub repository secrets as `IFLOW_API_KEY`
  2. Create a workflow file in your `.github/workflows/` directory
  3. Reference the action with your desired prompt
  4. Customize inputs as needed for your use case

Usage Example

Issue Triage Workflow

name: '🏷️ iFLOW CLI Automated Issue Triage'

on:
  issues:
    types: [opened, reopened]
    
jobs:
  triage-issue:
    runs-on: 'ubuntu-latest'
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: 'Run iFlow CLI Issue Triage'
        uses: iflow-ai/iflow-cli-action@v2.0.0
        with:
          api_key: ${{ secrets.IFLOW_API_KEY }}
          prompt: |
            Triage the following issue:
            Issue Title: "${{ github.event.issue.title }}"
            Issue Body: "${{ github.event.issue.body }}"

Inputs and Outputs

Required Inputs

  • prompt - The prompt to execute with iFlow CLI
  • api_key - iFlow API key for authentication

Optional Inputs

  • base_url - Custom base URL for iFlow API
  • model - Model name to use (default: `qwen3-coder-plus`)
  • timeout - Execution timeout in seconds
  • precmd - Shell commands to execute before iFlow CLI

Outputs

  • result - Output from iFlow CLI execution
  • exit_code - Exit code from iFlow CLI execution

Advanced Features

Pre-Execution Commands

precmd: |
  npm install
  git fetch origin main

Custom Settings JSON

settings_json: |
  {
    "theme": "Dark",
    "selectedAuthType": "iflow",
    "apiKey": "${{ secrets.IFLOW_API_KEY }}",
    "baseUrl": "https://custom-api.example.com/v1"
  }

MCP Server Integration

Connect to external tools and services using Model Context Protocol

Common Use Cases

🔍
Code Analysis and Review - Automatically review PRs for code quality and issues
📝
Documentation Generation - Generate technical documentation from code
🧪
Testing Suggestions - Suggest additional test cases for code changes
🏷️
Issue Management - Automatically triage and label GitHub issues
🏗️
Architecture Analysis - Analyze codebase architecture and dependencies

Thank You

iFlow CLI GitHub Action

Enhance your GitHub workflows with AI-powered automation

GitHub Repository iFlow Platform

"Leverage the power of AI to automate your development workflows"

For more information, visit:

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