convez.ai
AgenteDevOps & InfraestruturaIntermediário
Yhazrin

MiWarp

Yhazrin/miwarp

GUI desktop local-first para CLIs de coding com IA, multi-sessão e acesso remoto

Ver no GitHub
BomPluginScore · de 0 a 100

Dashboard desktop nativo para gerenciar agentes de IA (Claude Code, Codex e 15+ provedores) com interface visual, histórico persistente e gerenciamento de sessões. Construído com Tauri (Rust + WebView nativo), funciona 100% local (~50 MB, <200 MB RAM) sem backend na nuvem.

Instalação

$npx convez-ai Yhazrin/miwarp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 4 meses
Versão
v1.1.3
Issues abertas
1
Contribuidores
8

Casos de uso

  • Gerenciar múltiplas sessões de Claude Code/Codex com histórico visual e diffs
  • Alternar entre 15+ provedores de IA (Anthropic, DeepSeek, Ollama local) sem reiniciar
  • Acessar agentes de código do celular ou navegador com emparelhamento remoto
  • Agendar tarefas de codificação para executar em segundo plano enquanto ausente

Veredito

Ferramenta sólida para desenvolvedores que vivem em Claude Code/Codex e querem sair da terminal. Arquitetura leve (Tauri) e totalmente local é um diferencial real. Melhor para quem já domina CLIs de IA — não substitui chatGPT-style, complementa fluxos avançados de desenvolvimento.

README

A tradução para o português deste README ainda está na fila.


What is MiWarp?

MiWarp wraps AI coding CLIs (Claude Code, Codex, …) in a native desktop app, so you get the power of the terminal agent plus a proper visual interface — chat history with diffs, multi-session management, cross-session forwarding, and remote access from your phone.

Everything stays on your machine under ~/.miwarp/. The app itself has no cloud backend; only the LLM API calls go over the network.

It's not an Electron app — built on Tauri v2 (Rust + system WebView), so the install is ~50 MB and RAM usage stays under 200 MB for a normal session.

Who is it for?

Developers who already use Claude Code / Codex from the terminal and want:

  • a visual chat interface with proper markdown, tool cards, and diffs (instead of scrolling terminal output)
  • persistent history — every prompt, every response, every file change, searchable
  • multi-provider switching — Anthropic, DeepSeek, Kimi, Zhipu, OpenRouter, local Ollama, … without restarting
  • session management — fork, resume, rename, forward messages between sessions
  • remote access — pair your phone, run from the browser, schedule tasks to run while you're away

If you just want a chatGPT-style web UI, this isn't it. If you spend hours a day in claude code and want it to feel less like 1995, this is.

What changed in v1.0.7?

The most recent release focuses on polish and the theme/forward workflows that ship in every session:

  • Unified theme system — 12 themes, each with proper light and dark variants. Pick a theme and an "appearance mode" (light / dark / follow system) independently. Follows macOS / Windows system theme live, even when the Settings tab is closed.
  • Forward to session rewritten as a proper "session target selector" — three layered lines per row (title / last message preview / meta), one short project name per group, and an explicit Cancel / Forward button pair.
  • listRunsLite backend — the forward dialog used to take several seconds with hundreds of past runs; now it's instant. (Reads only meta.json, skips the events scan.)
  • Dialog chrome cleanup — removed all elevation-3 / shadow-lg from dialogs, backdrop blur bumped from 2xl to 3xl, dialog titles get a proper border-b header bar (no more zero-padding top-left corner).

See CHANGELOG.md for the full list (1.0.5 → 1.0.7 included).

Capabilities

Chat

  • Visual tool cards — every Claude Code tool call (Read, Edit, Bash, Grep, Write, WebFetch, …) rendered inline with syntax-highlighted diffs, structured output, one-click copy
  • Rich content — markdown with syntax highlighting, thinking blocks, image attachments, file diffs, collapsible tool-burst groups
  • Inline slash commands — /model, /diff, /todos, /tasks, /doctor, /stats, /preview, /ralph, … rendered natively
  • Drag & drop — images, PDFs, directories, path references

Sessions

  • Run history & replay — browse every past session, full event replay, resume or fork from any point, soft-delete with recovery
  • Workspace grouping — sessions grouped by project (cwd); full path shown once per group, not in every row
  • Cross-session forward — pick a target session, send a message into it without leaving the current one
  • Rewind — checkpoint and selectively revert file changes with dry-run preview
  • CLI session import — discover and import existing Claude Code CLI sessions

Multi-provider

  • 15+ LLM providers (Anthropic official, DeepSeek, Kimi, Zhipu, Bailian, DouBao, MiniMax, Xiaomi MiMo, Tencent Hunyuan, SiliconFlow, …)
  • 3 API gateways (Vercel AI Gateway, OpenRouter, AiHubMix, ZenMux)
  • Local inference (Ollama, CC Switch, Claude Code Router) + any Anthropic-compatible endpoint
  • Hot-swap between providers without restarting a session

Remote & automation

  • Mobile pairing — QR-code pair a phone or tablet as a remote terminal
  • Web server access — embedded HTTP server with token auth, LAN or cloudflared/ngrok tunnel
  • Scheduled tasks — cron-style recurring prompts
  • Ralph loop — auto-iterate a prompt until a completion condition is met
  • Hook manager — upstream CLI hooks for event-driven automation

Workspace tooling

  • File explorer — syntax highlighting, markdown preview, image preview, git diff
  • Memory editor — CLAUDE.md (user + project scope) with live preview
  • Agent editor — visual editor for custom agent definitions (.md) with form / source modes
  • Permission rules — user + project level, with batch Allow/Deny
  • MCP management — discover servers, view status, reconnect / toggle
  • Usage analytics — per-model token breakdown, cost tracking, daily heatmap
  • Team dashboard — read-only view of Claude Code multi-agent teams (task lists, status, message flow)
  • Doctor diagnostics — system health for CLI, platform, SSH, proxy

App shell

  • 12 themes (Codex, Midnight, Ocean, Dracula, Nord, Morandi, Carbon Pink, Deep Sea Milk, Aurora Pomelo, Pomegranate Mist, Aurora Lime, Dev Preview) with full light / dark variants
  • Light / dark / system mode with live OS follow
  • Custom keybindings with chord support and conflict detection
  • English / 简体中文 i18n
  • System tray with native notifications
  • In-app update checker

Quick start

Option A — Download (macOS)

Grab the latest .dmg from Releases.

Universal binary (Apple Silicon + Intel). Not code-signed — first launch: right-click the app → Open → "Open" to bypass Gatekeeper.

Linux and Windows builds are produced by CI but have not been tested on real machines. The recommended path for those is Option B / C below.

Option B — Automated setup (macOS)

git clone https://github.com/Yhazrin/MiWarp.git
cd MiWarp
./scripts/setup.sh          # add --yes to skip prompts
npm run tauri dev

The setup script auto-detects missing deps (Xcode CLI Tools, Homebrew, Node.js, Rust) and installs them.

Option C — Manual setup

Prerequisites

macOS

xcode-select --install
brew install node
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Linux (Debian / Ubuntu)

sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Windows

Install Rust from https://rustup.rs and Node.js from https://nodejs.org.

Then

git clone https://github.com/Yhazrin/MiWarp.git
cd MiWarp
npm install
npm run tauri dev

First launch

The setup wizard walks you through:

  1. CLI detection — auto-detects Claude Code / Codex, offers install if missing
  2. Authentication — OAuth or API key for your provider
  3. Ready to chat

Re-run anytime from Settings → Setup Wizard.

Supported providers

LLM providers

ProviderEndpointAuth
AnthropicOfficial APIAPI Key
DeepSeekapi.deepseek.com/anthropicBearer
Kimi (Moonshot)api.moonshot.cn/anthropicBearer
Kimi For Codingapi.kimi.com/coding/Bearer
Zhipu (智谱)open.bigmodel.cn/api/anthropicBearer
Zhipu (智谱 Intl)api.z.ai/api/anthropicBearer
Bailian (Coding Plan)coding.dashscope.aliyuncs.com/apps/anthropicBearer
Bailian (百炼 API)dashscope.aliyuncs.com/apps/anthropicBearer
DouBao (豆包)ark.cn-beijing.volces.com/api/codingBearer
MiniMaxapi.minimax.io/anthropicBearer
MiniMax (China)api.minimaxi.com/anthropicBearer
Xiaomi MiMo (小米)api.xiaomimimo.com/anthropicBearer
Xiaomi MiMo (Token Plan)token-plan-cn.xiaomimimo.com/anthropicBearer
Tencent Hunyuan (混元)api.hunyuan.cloud.tencent.com/anthropicBearer
SiliconFlow (硅基流动)api.siliconflow.com/Bearer

API gateways

PlatformEndpointAuth
Vercel AI Gatewayai-gateway.vercel.shBearer
OpenRouteropenrouter.ai/apiBearer
AiHubMixaihubmix.comBearer
ZenMuxzenmux.ai/api/anthropicBearer

Local

PlatformEndpoint
Ollamalocalhost:11434
CC Switchlocalhost:15721
Claude Code Routerlocalhost:3456
CustomAny Anthropic-compatible endpoint

Architecture

┌─────────────────────────────────────────────────────────┐
│  MiWarp Desktop (Tauri v2)                              │
│  ┌─────────────────────────────────────────────────┐   │
│  │  Frontend (Svelte 5 + SvelteKit static)         │   │
│  │  • chat UI · tool cards · settings · themes    │   │
│  └─────────────────────────────────────────────────┘   │
│                          │  IPC                          │
│  ┌─────────────────────────────────────────────────┐   │
│  │  Backend (Rust)                                  │   │
│  │  • session_actor (per-run process lifecycle)    │   │
│  │  • turn_engine (phase / timeout)                 │   │
│  │  • storage (runs, events, settings, …)          │   │
│  │  • web server (mobile pairing)                   │   │
│  │  • scheduler · hook manager                      │   │
│  └─────────────────────────────────────────────────┘   │
│                          │  stream-JSON / PTY / pipe    │
│  ┌─────────────────────────────────────────────────┐   │
│  │  Claude Code CLI  /  Codex CLI                  │   │
│  │  (long-lived child processes)                    │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘

Tech stack

LayerTech
FrameworkTauri v2 (Rust + WebView)
FrontendSvelte 5 + SvelteKit (adapter-static)
StylingTailwind CSS v3 + CSS variables
Terminalxterm.js
Markdownmarked + highlight.js
SanitizeDOMPurify
i18nCustom lightweight runtime (en + zh-CN)
TestingVitest + Rust unit tests

Data storage — everything at ~/.miwarp/, no cloud:

~/.miwarp/
├── settings.json          # user settings
├── keybindings.json       # custom shortcuts
├── runs/                  # session history
│   └── {run-id}/
│       ├── meta.json      # run metadata
│       ├── events.jsonl   # event log
│       └── artifacts.json # summary
└── …

Platform support — actively developed and tested on macOS. Windows and Linux compile and run, but are not on the "thoroughly tested" list. Bug reports and platform-specific fixes are welcome.

Development

npm install              # install dependencies
npm run tauri dev        # dev mode with hot reload
npm test                 # run vitest
npm run lint             # eslint
npm run format           # prettier
npm run check            # svelte-check (type)
npm run i18n:check       # i18n key alignment
npm run verify           # full CI gate (lint + format + check + i18n + test + build + rust)

See CONTRIBUTING.md for code conventions, commit style, and PR guidelines.

License

Apache License 2.0

Copyright 2025-2026 MiWarp Contributors.

Ver o original no GitHub

Bom para

Relacionados