Odel
Yaver

Yaver

Local
@kivanccakmak4GoUpdated 1mo ago

Phone-first local dev MCP for Claude Code and Codex: install Yaver, pair mobile, run, build, deploy.

Yaver — an open-source, self-hostable MCP server. Your coding agent builds a full-stack app on your own machine, it hot-reloads on your real phone, and you keep fixing it from inside the running app.

Tests yaver-cli on npm License: FSL-1.1-Apache-2.0

Demo: a task sent from a phone runs on the desktop agent and the app reloads live on the device

Watch the full demo →

What Yaver is

AI writes the code in seconds. The loop around it — build, install, reproduce, describe what's wrong, get back to the agent — still takes hours. Yaver closes that loop.

The yaver agent runs on hardware you already own: a Mac, a Linux box, a WSL machine, a Pi, or a VPS. Your coding agent works there, against your real repo. Every other surface — phone, watch, TV, car, AR/VR, browser — is a remote control and a preview target for that one machine.

It runs on the AI subscription you already pay for — no token markup, and your code never leaves your machine.

iOS and Android are the deepest path today. Watch, TV, car, and AR/VR surfaces live in this repo and share the same core.

Quick start

npm install -g yaver-cli
yaver auth
yaver serve

On a headless box (Pi, VPS, SSH-only), yaver auth --headless prints a short code and a URL you can open from any browser.

npm is the only supported install path, on macOS (Apple Silicon + Intel), Linux (x64 + arm64), and Windows via WSL2. It downloads a signed, notarized agent binary for your platform.

Then grab the app and pair it with that machine:

Download Yaver on the App Store Get Yaver on Google Play

Open Yaver, pick a project from your dev box, preview it on your phone, shake to vibe-code — fix a bug, ship a small feature, or tweak a style — and a fresh bundle lands in seconds. One screen, real device, no extra hardware.

Use it from your coding agent

Yaver ships an MCP server, so Claude Code, Codex, or opencode can drive your machine directly. You don't need a global install first — npx pulls the server on first run. Register it once, then ask the agent to call yaver_lazy_setup; it surfaces a sign-in link and pairs your device from inside the chat.

# Claude Code
claude mcp add --scope user yaver -- npx -y yaver-cli yaver-mcp

# Codex
codex mcp add yaver -- npx -y yaver-cli yaver-mcp

# opencode
npm install -g yaver-cli && yaver mcp setup opencode

Already installed globally? yaver mcp setup claude-code (or codex / opencode) writes the same entry, and yaver auth auto-registers every installed runner on first sign-in. Yaver is published to the official MCP registry as io.github.kivanccakmak/yaver. Codex Desktop can also load the repo-local plugin in plugins/yaver.

Full tool list and HTTP/remote setup: MCP guide.

How it works

The yaver agent runs on your own machine and holds your repo, tasks, vault and builds. Surfaces connect directly over a LAN beacon and QUIC, falling back to a self-hostable QUIC relay that stores nothing. A thin hosted plane carries identity and device discovery only.

  1. Start yaver serve on your own machine.
  2. Pair a surface — the mobile app, the web dashboard, or another Yaver client.
  3. Send a task to your coding agent from whichever surface is nearest.
  4. Watch terminal, build, and reload progress stream back live.
  5. Push the fix to a real device, or deploy from your own machine when it's ready.

The CLI, agent, relay, and backend are all self-hostable. Client apps currently reach you through a thin hosted coordination plane for identity and device discovery; full client self-host is on the way.

What works today

  • Drive Claude Code, Codex, OpenCode, Aider, Goose, or another terminal agent from the Yaver agent.
  • Push React Native / Expo bundles to a paired phone through the native Hermes path.
  • Capture dev-build feedback with screenshots, logs, and replay context.
  • Stream task, build, and reload progress to mobile or the web dashboard.
  • Keep peer discovery, relay, and vault flows local-first.
  • Build against SDKs and examples for React Native, Flutter, web, Unity, Go, Python, and JS/TS.

What it costs

A solo developer can run the open-source stack at $0.

ComponentRuns onCost
Yaver CLI + agentYour dev machine$0
Yaver surface appsiOS / Android / watch / TV / car / AR/VR$0
Web dashboardBrowser$0
Backend on your own machineYour Mac / Linux / WSL / VPS$0 + your hardware
Relay serverSelf-host on any VPS$0
AI models (Ollama)Your GPU or CPU$0

The whole open-source stack is free: mobile app, CLI, agent, web dashboard, SDKs, and self-hosted relay. That's everything you need to build and iterate. Your coding agent brings its own login or subscription — Yaver never resells tokens.

An optional managed-cloud option, for people who don't want to run their own always-reachable box, is coming later. Self-hosting stays free.

Repository map

PathPurpose
desktop/agent/Go agent, CLI surfaces, local API, relay/P2P/runtime integrations
mobile/React Native mobile app and native preview container
watch/, wear/, tvos/Apple Watch, Wear OS, and Apple TV client surfaces
web/Next.js marketing site and dashboard
backend/convex/Hosted identity, session, and device-discovery metadata
relay/QUIC relay service
sdk/Public SDKs and feedback clients
demo/Small fixture apps used to test SDK and push flows
demo-videos/Source notes for the landing/demo clips
docs/Architecture notes, setup guides, audits, handoffs, and planning material

Documentation

Docs index · Setup · Contributing · Runtime architecture · Protocol · Feedback SDK · Security · License

If an AI coding agent is setting Yaver up for you, point it at the canonical machine guide first:

curl -s https://yaver.io/llms.txt

Markdown in this repo is context, not source of truth. If a doc and the code disagree, trust the code and fix the doc in the same change.

Development

# Web dashboard / landing
cd web && npm install && npm run dev

# Go agent tests
cd desktop/agent && go test ./...

Run the narrower package tests for the area you change — the repo spans Go, Node, React Native, Swift, Kotlin, Flutter, Unity, and embedded C.

License

The repo uses a split license: the core is FSL-1.1, which auto-converts to Apache-2.0 after two years, and the client SDKs are Apache-2.0 so you can embed them in closed-source apps. See docs/planning/LICENSING.md.

If your legal team needs the core under different terms, a commercial license is available — email kivanc.cakmak@simkab.com.