JohannesTK/workflow

โ˜… 0Forks 0PythonGitHub โ†—Compare

README

workflow - Agent-based CLI Automation

An intelligent CLI tool that helps technical users automate their daily workflows using AI agents.

Features

  • ๐Ÿค– Agent-based architecture - Orchestrator + specialized subagents (Coder, Executor, Reviewer)
  • ๐Ÿ“ Natural language workflow creation - Describe what you want, get executable code
  • ๐Ÿ”„ Learn from failures - Reviewer agent analyzes errors and suggests improvements
  • ๐Ÿ”ง Code-first approach - All workflows are readable Python/bash scripts
  • ๐Ÿงฉ Composable workflows - Chain multiple workflows together
  • ๐Ÿ“Š Execution history - Learn from past runs to improve reliability

Quick Start

# Install
pip install -e .

# Set up API key
export ANTHROPIC_API_KEY=your_key_here

# Create your first workflow
workflow teach daily-backup "Backup my postgres database to S3"

# Run it
workflow run daily-backup

# View history
workflow history daily-backup

Architecture

Orchestrator Agent
โ”œโ”€โ”€ Coder Agent (generates scripts)
โ”œโ”€โ”€ Executor Agent (runs workflows safely)
โ””โ”€โ”€ Reviewer Agent (analyzes failures, suggests fixes)

Examples

Data Pipeline

workflow teach etl-job "Fetch sales data from API, transform with pandas, load to warehouse"

DevOps Workflow

workflow teach deploy "Run tests, build docker image, push to ECR, update ECS"

System Admin

workflow teach backup "Tar important directories, encrypt, sync to S3"

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black .
ruff check .

License

MIT

Contributors

JohannesTK

Issues