Imbi Automations：面向 Imbi 项目的 AI 工作流自动化 CLI 工具

CLI tool for executing automated workflows across Imbi projects with AI-powered transformations and GitHub PR integration.

Overview

Imbi Automations is a comprehensive CLI framework that enables bulk automation across software project repositories with deep integration to the Imbi project management system. The tool supports multiple workflow types with advanced filtering, conditional execution, and AI-powered transformations.

Key Features

GitHub Integration: GitHub API integration with comprehensive repository operations
Workflow Engine: Action-based processing with conditional execution
AI Integration: Claude Code SDK for intelligent transformations
Batch Processing: Concurrent processing with resumption capabilities
Template System: Jinja2-based file generation with full project context
Advanced Filtering: Target specific project subsets with multiple criteria

Action Types

Callable Actions: Direct method calls on client instances
Claude Code: Comprehensive AI-powered code transformations
Docker Operations: Container-based file extraction and manipulation
Git Operations: Version control operations and branch management
File Actions: Copy, move, delete, and regex replacement operations
Shell Commands: Execute arbitrary commands with template variables
Template System: Generate files from Jinja2 templates

Documentation

Documentation is available at https://aweber-imbi.github.io/imbi-automations/.

Quick Start

# Run workflows
# Note: Each workflow directory should contain workflow.toml (or config.toml for backward compatibility)
imbi-automations config.toml workflows/workflow-name --all-projects

# Resume from a specific project
imbi-automations config.toml workflows/workflow-name --all-projects --start-from-project my-project-slug

# Run using Docker:

```bash
docker run --rm \
  -v $(pwd)/config.toml:/config/config.toml:ro \
  -v $(pwd)/workflows:/workflows:ro \
  -v ~/.ssh:/root/.ssh:ro \
  -v imbi-cache:/cache \
  aweber/imbi-automations:latest /config/config.toml /workflows/my-workflow --all-projects

Installation

Using uv

uv tool install imbi-automations
uv tool run imbi-automations config.toml workflows/my-workflow --all-projects

From PyPI

pip install imbi-automations
imbi-automations config.toml workflows/my-workflow --all-projects

Docker Installation

Pre-built multi-architecture images are automatically published to both Docker Hub and GitHub Container Registry on every release:

# Pull from Docker Hub (recommended)
docker pull aweber/imbi-automations:latest

# Or pull from GitHub Container Registry
docker pull ghcr.io/aweber-imbi/imbi-automations:latest

# Or use a specific version
docker pull aweber/imbi-automations:1.0.0
docker pull ghcr.io/aweber-imbi/imbi-automations:1.0.0

# Run with docker-compose (recommended)
docker-compose run --rm aweber/imbi-automations /config/config.toml /workflows/my-workflow --all-projects

# Or run directly with docker (Docker Hub)
docker run --rm \
  -v $(pwd)/config.toml:/config/config.toml:ro \
  -v $(pwd)/workflows:/workflows:ro \
  -v ~/.ssh:/root/.ssh:ro \
  -v imbi-cache:/cache \
  aweber/imbi-automations:latest /config/config.toml /workflows/my-workflow --all-projects

# Or run with GHCR
docker run --rm \
  -v $(pwd)/config.toml:/config/config.toml:ro \
  -v $(pwd)/workflows:/workflows:ro \
  -v ~/.ssh:/root/.ssh:ro \
  -v imbi-cache:/cache \
  ghcr.io/aweber-imbi/imbi-automations:latest /config/config.toml /workflows/my-workflow --all-projects

Build from source:

docker build -t imbi-automations:latest .

Docker Volume Mounts:

/config/config.toml - Configuration file (read-only recommended)
/workflows - Workflows directory (read-only recommended)
/cache - Metadata cache directory (persistent)
/workspace - Temporary working directory for repo clones
/root/.ssh - SSH keys for git operations (read-only)
/root/.gnupg - GPG keys for commit signing (optional, read-only)

Important Notes:

Claude Code in containers may have limitations with interactive features
Ensure SSH keys have proper permissions (0600) when mounting
API keys should be in config.toml for security
Use named volumes for cache to improve performance across runs

Development Setup

git clone https://github.com/AWeber-Imbi/imbi-automations.git
cd imbi-automations
uv sync --all-groups --all-extras --frozen
uv run pre-commit install --install-hooks