gitwtfhub

wtf is qiaomu-model-cli?

joeseesun/qiaomu-model-cli — explained in plain English

Analysis updated 2026-05-18

28PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A command line tool that routes tasks to your locally installed Grok, Kimi, and Claude Code assistants and can run them concurrently with live progress and failure retry.

Mindmap

mindmap
  root((qiaomu-model-cli))
    What it does
      Routes tasks to CLI assistants
      Runs assistants concurrently
      Retries only failed jobs
    Assistants
      Grok for search and media
      Kimi for frontend work
      Claude for complex coding
    Reliability
      Live progress events
      Expected output checks
      Process cleanup on interrupt
    Tech stack
      Python
      Grok CLI
      Kimi Code CLI
      Claude Code CLI
    Audience
      Developers using multiple AI CLIs

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run Grok, Kimi, and Claude Code on the same task at once instead of calling each one separately

REASON 2

Have Grok research a topic first, then hand the results to Kimi to build a frontend page

REASON 3

Verify a coding assistant actually produced the expected files before trusting a success message

REASON 4

Retry only the jobs that failed in a previous batch run instead of rerunning everything

What's in the stack?

PythonGrok CLIKimi Code CLIClaude Code CLI

How it stacks up

joeseesun/qiaomu-model-cliademola-lou/threejsgnmalicankiraz1/codexqb
Stars282828
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires the Grok, Kimi, and Claude Code CLIs already installed and logged in, plus Python 3.10 or newer.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

qiaomu-model-cli is a command line tool and agent skill that lets you call three different AI coding assistants installed on your own machine, Grok CLI, Kimi Code CLI, and Claude Code CLI, and run them at the same time instead of one after another. Instead of remembering the specific command line flags each tool needs, you describe a task and this tool routes it to the right assistant with sensible defaults already filled in. Each assistant has a role it defaults to. Grok is used for live web and X search, research, image generation, and video generation. Kimi, which supports a very large context window, is used for frontend work like UI, CSS, and component code. Claude Code is used for the most complex coding, refactoring, and code review tasks, and you can also explicitly pick a specific Claude model instead of the default. Tasks that do not depend on each other can be run as a batch, launching all three assistants at the same time and writing separate logs for each, which is faster than waiting for one to finish before starting the next. Tasks where one assistant needs the output of another, such as Grok researching a topic before Kimi builds a page from it, run in sequence instead through a separate mode. The tool streams each assistant's native progress events live, sends a periodic heartbeat so you can tell a still-running job apart from a stuck one, and writes full logs to disk with restricted file permissions since the raw output may contain task content. To avoid trusting a model's own claim that it finished, you can declare expected output files and verification commands for a job, and the tool checks those before marking a job successful. If a job fails, you can rerun just the failed jobs from a saved summary file instead of repeating the whole batch. Interrupting a run cleans up any background processes those assistants started. Using it requires the Grok, Kimi, and Claude command line tools already installed and logged in on your machine, along with Python 3.10 or newer. The project is released under the MIT License.

Yoink these prompts

Prompt 1
Walk me through installing qiaomu-model-cli and checking that Grok, Kimi, and Claude CLIs are all set up
Prompt 2
Explain how batch mode differs from dual mode for tasks that depend on each other
Prompt 3
Help me write a batch config file that runs Grok, Kimi, and Claude on independent tasks concurrently
Prompt 4
Show me how to use expects and verify_commands so a job only counts as done when its output actually exists

Frequently asked questions

wtf is qiaomu-model-cli?

A command line tool that routes tasks to your locally installed Grok, Kimi, and Claude Code assistants and can run them concurrently with live progress and failure retry.

What language is qiaomu-model-cli written in?

Mainly Python. The stack also includes Python, Grok CLI, Kimi Code CLI.

What license does qiaomu-model-cli use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is qiaomu-model-cli to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is qiaomu-model-cli for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.