SCTY-Inc/mirofish-cli

What it solves

MiroFish CLI provides a way to simulate social media reactions to specific documents or requirements. It allows users to predict public reaction over time by simulating AI agents arguing and posting on platforms like Twitter and Reddit.

How it works

The tool takes input documents (PDF, Markdown, or text files) and a plain-English requirement. It then builds a knowledge graph and deploys AI agents that simulate social media interactions. The process concludes with the generation of a report, a machine-readable verdict.json containing predictions and confidence levels, and SVG snapshots of the simulation.

Who it’s for

Researchers, policy makers, or analysts who need to predict how information or a specific policy might be perceived and debated on social media platforms.

Highlights

• Multi-platform simulation: Supports simulated Twitter, Reddit, and parallel simulations.
• Knowledge Graph integration: Uses a knowledge graph to ground the simulation in the documents provided.
• Comprehensive reporting: Generates detailed reports including a summary, a verdict file, and visual SVG snapshots.
• CLI-first approach: Designed to run as a command-line tool using the claude or codex CLI providers.