amadad

Mirofish CLI — AI skill for Claude Code

AI community

Multi-agent AI prediction engine - digital sandbox for scenario simulation (fork of 666ghj/MiroFish).

How to install Mirofish CLI

This entry records only its repository, not the path inside it, so there is no exact command to give. Open amadad/mirofish-cli and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Mirofish CLI does

Multi-agent AI prediction engine - digital sandbox for scenario simulation (fork of 666ghj/MiroFish).

Alternatives in AI

Open Multi Agent — TypeScript multi-agent orchestration engine — one runTeam() call from goal to result 5.8k ★
Desktop Cc Gui — Multi-engine AI coding desktop client (Tauri) 4.4k ★
Coding Agent Template — Multi-agent AI coding platform powered by Vercel Sandbox and AI Gateway 1.8k ★

README

MiroFish

A social simulation scenario engine. Feed it documents describing any scenario, and MiroFish simulates AI agents reacting on social media to explore how events might unfold. Designed for agent-driven workflows — outputs include a machine-readable `verdict.json` alongside the full report.

Fork of [666ghj/MiroFish](https://github.com/666ghj/MiroFish) — fully translated to English, CLI-only, Claude/Codex CLI support added.

What it does

Feed reality seeds — PDFs, markdown, or text files (news articles, policy drafts, financial reports, anything)
Describe what to predict — natural language requirement
MiroFish builds a world — extracts entities and relationships into a knowledge graph, generates AI agent personas with distinct personalities
Agents simulate social media — dual-platform simulation (Twitter + Reddit) where agents post, reply, like, argue, and follow each other
Get a prediction report — AI analyzes all simulation data and produces a report + machine-readable verdict with confidence scores and signals

Quick start

Prerequisites

Python 3.11-3.12
uv (Python package manager)

Setup

cp .env.example .env
# Default: claude-cli (uses your Claude Code subscription)
uv sync

Run a simulation

mirofish run \
  --files docs/policy.pdf notes/context.md \
  --requirement "Predict public reaction over 30 days" \
  --json

# List prior runs (slim summary: run_id, status, created_at, artifact_count)
mirofish runs list --json

# Check run status (full manifest)
mirofish runs status  --json

# Export artifacts
mirofish runs export  --json

CLI options

mirofish run
  --files FILE [FILE ...]     Source files (pdf/md/txt) used to ground the
                              ontology and profiles
  --requirement TEXT          Plain-English simulation requirement
                              (e.g. "How would voters react to X?")