mirage-cli
v1.1.1
Published
Mirage CLI — free Gemini + Qwen coding agent with session-key proxy, Roblox Studio MCP tools and Ink TUI
Maintainers
Readme
mirage-cli
Free Gemini + Qwen coding agent in your terminal. No API keys — it talks to the web sessions you already have, through a built-in local proxy. Includes file tools, Roblox Studio MCP tools, and an Ink TUI.
Install
npm install -g mirage-cliRequires Node.js 20+.
Use
mirage # TUI (pick model with /models)
mirage chat -m gemini-3.8-flash "insert a part into my game"
mirage chat -m qwen3.8-max "explain this repo"
mirage login # Google login once — session cookies save automatically
mirage proxy # builtin OpenAI-compatible server on :8081
mirage models # list modelsAny OpenAI client can point at http://localhost:8081/v1 while the CLI (or mirage proxy) runs.
Free models (session key, no API key)
| Model | Session |
|---|---|
| gemini-3.8-flash (+ 3.7/3.6/3.5, pro, auto, lite) | mirage login (or /login in TUI) — Chrome opens once, you sign into Google, cookies save to cookie.txt by themselves. Manual fallback: paste SID=...; ...; __Secure-1PSID=... from DevTools → Application → Cookies on gemini.google.com |
| qwen3.8-max (+ 3.7-plus, omni, max) | auto-read from the logged-in chat.qwen.ai browser storage, or paste the token value into qwen-token.txt |
Each user runs with their own session. Never share your cookie.txt / qwen-token.txt.
Extras
/statusin TUI checks Roblox Studio MCP instances;execute_luaucreates parts/scripts straight in Studio.- ESC once = hint, ESC twice = interrupt generation (like opencode).
- Identical prompt+model answers are cached for 3 min (
MIRAGE_CACHE_TTL_SEC,/clearwipes it).
