What is qiaomu-model-cli?

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

Analysis updated 2026-05-18

★ 28PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

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

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

PythonGrok CLIKimi Code CLIClaude Code CLI

How does it compare?

	joeseesun/qiaomu-model-cli	ademola-lou/threejsgnm	alicankiraz1/codexqb
Stars	28	28	28
Language	Python	Python	Python
Setup difficulty	moderate	moderate	easy
Complexity	3/5	3/5	3/5
Audience	developer	developer	developer

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

How do you get it running?

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.

So what is it?

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.

Copy-paste 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