Kelpie icon

Kelpie

The browser for agents, support teams, and demos. Drive real devices with LLMs, record a few clean clicks, and send clients a walkthrough that shows exactly where to go.

GitHub Documentation
npm install -g @unlikeotherai/kelpie

What it does

Real browsers, every platform

Native iOS, Android, and macOS apps built on WKWebView, Android WebView, and CEF. No emulators, no desktop wrappers, no Electron.

mDNS discovery

Every running instance advertises _kelpie._tcp on the local network. The CLI auto-discovers all devices with metadata: name, platform, resolution, version.

HTTP + MCP API

Every device runs an HTTP and MCP server. Navigate, screenshot, read DOM, click, fill forms, scroll, evaluate JS — all via structured API calls.

Support walkthrough videos

Record a scripted browser session for support and presentation work. A support team can do a few clean clicks, show a client the exact path to a page, setting, or flow, then send the walkthrough instead of typing instructions.

Group commands

Send the same command to all devices simultaneously. Fill a form across 6 phones at once, or take screenshots of every device in one call.

Annotated screenshots

Capture screenshots with numbered labels on every interactive element. The LLM sees the image and a list of what each number is — visual-first automation.

Smart queries

findButton("Submit") across all devices returns which ones found it. The LLM makes the decision about what to do next.

Safari / Chrome auth

One-tap login using the device's saved passwords. Opens Safari or Chrome Custom Tabs, syncs cookies back into the browser automatically.

Network inspector

Capture all XHR and fetch traffic from loaded pages. See method, URL, status, headers, request/response bodies, timing, and size.

Console capture

Read console output (log, warn, error) and JS errors with stack traces. Buffers up to 5,000 entries, clearable on demand.

Apple TV support

AirPlay from an iPhone or iPad to an Apple TV and it appears as a separate controllable device on the network. Fullscreen browser on the big screen, driven entirely from the CLI.

Architecture

graph TD
    subgraph net["Local Network"]
        subgraph iphone["iPhone"]
            ib["Kelpie Browser"]
            is["HTTP + MCP Server"]
            im["mDNS _kelpie._tcp"]
        end
        subgraph ipad["iPad"]
            pb["Kelpie Browser"]
            ps["HTTP + MCP Server"]
            pm["mDNS _kelpie._tcp"]
        end
        subgraph android["Android"]
            ab["Kelpie Browser"]
            as["HTTP + MCP Server"]
            am["mDNS _kelpie._tcp"]
        end
        subgraph tv["Apple TV (AirPlay)"]
            tb["Fullscreen Browser"]
            ts["HTTP + MCP Server"]
            tm["mDNS _kelpie._tcp"]
        end
    end

    subgraph cli["Kelpie CLI (Node.js)"]
        disc["mDNS Discovery"]
        ind["Individual Commands"]
        grp["Group Commands"]
        help["LLM Help System"]
        mcp["MCP Server"]
    end

    is --> cli
    ps --> cli
    as --> cli
    ts --> cli
    cli --> llm["LLM Agent"]

    style net fill:transparent,stroke:#e0dcd6,stroke-width:1px
    style iphone fill:transparent,stroke:#f4b078,stroke-width:2px
    style ipad fill:transparent,stroke:#f4b078,stroke-width:2px
    style android fill:transparent,stroke:#f4b078,stroke-width:2px
    style tv fill:transparent,stroke:#f4b078,stroke-width:2px
    style cli fill:transparent,stroke:#e8944a,stroke-width:2px
    style llm fill:#e8944a,color:#fff,stroke:#e8944a
    

Quick start

1. Install the CLI

npm install -g @unlikeotherai/kelpie

2. Run the app

Build and run the iOS or Android app on a device, simulator, or emulator. It starts advertising on the network automatically.

3. Discover devices

kelpie discover — lists all Kelpie instances on your network with name, platform, IP, and resolution.

4. Control

kelpie navigate --url https://example.com — or connect your LLM via MCP and let it drive.

Sister projects

AppReveal

Drop-in Swift package that turns any iOS app into an MCP-controllable agent. Exposes 44 tools: screenshot, tap, get DOM, fill forms, navigate, inspect view hierarchy. Discovered via mDNS, accessed over streamable HTTP. Used by Kelpie for debug integration and automated testing.

View on GitHub

Selkie

Zero-trust network layer for device enrollment, session brokering, NAT traversal, and self-hosted infrastructure around the wider UnlikeOtherAI ecosystem.

View on GitHub

Nessie

Voice-first personal AI agent for macOS with a local orchestrator, MCP surface, native app shell, and sub-agent workflow for research and file work.

View on GitHub