flowkit: Command for Claude Code

fk-monitor — Full Pipeline Monitor

Poll project pipeline status every N seconds, detect state changes across all stages, send Telegram notifications, and optionally auto-download completed upscales.

Usage: /fk-monitor [project_id] [orientation] [--download] [--interval N]

• project_id — omit to use most recently active project
• orientation — HORIZONTAL or VERTICAL (auto-detected from video.orientation if omitted)
• --download — auto-download new upscales to output/{slug}/4k/
• --interval N — poll interval in seconds (default: 30)

When to Use

• Long-running batch: submitted image/video/upscale jobs and want to be notified when stages complete
• Unattended generation: step away and get Telegram pings at milestones
• Debugging: spot stalled workers or failed requests early
• Auto-download: pull 4K upscales as they finish without manual polling

Prerequisites

curl -s http://127.0.0.1:8100/health
# extension_connected must be true

Telegram notifications require the mcp__telegram__reply tool to be available in this session.

---

Step 1: Resolve project and slug

If no project_id supplied, fetch the most recent project:

curl -s http://127.0.0.1:8100/api/projects
# Use the last item in the array → id, name

Derive slug from project name:

import unicodedata, re

def slugify(name):
    # Strip diacritics
    normalized = unicodedata.normalize('NFD', name)
    ascii_only = normalized.encode('ascii', 'ignore').decode()
    # Lowercase, replace non-alphanum with underscore
    slug = re.sub(r'[^a-z0-9]+', '_', ascii_only.lower())
    # Collapse and trim
    slug = re.sub(r'_+', '_', slug).strip('_')
    return slug

Examples:

• "My Project - Edition" → my_project_edition
• "Chiến dịch giải cứu F-15E" → chien_dich_giai_cuu_f_15e

Get output dir (also creates directory structure):

curl -s http://127.0.0.1:8100/api/projects/<PID>/output-dir
# Returns: {"slug": "...", "path": "output/...", "meta": {...}}