tkmind_go/documentation/docs/experimental/remote-access/mobile-access.md

---
title: Mobile Access via Secure Tunneling
sidebar_position: 1
sidebar_label: Mobile Access
description: Enable remote access to goose from mobile devices using secure tunneling.
---

import { PanelLeft } from 'lucide-react';

Mobile access lets you connect to goose remotely from an iOS mobile device using secure tunneling.

:::warning Experimental Feature
Mobile access is a preview feature in active development. Behavior and configuration may change in future releases.
:::

## How Mobile Access Works

Mobile access connects your iOS device to goose Desktop through a secure tunnel. After you install and configure the **goose AI** app, you can access goose from anywhere.

**Key details:**
- Uses [Lapstone](https://github.com/michaelneale/lapstone-tunnel), a public HTTPS tunnel service provided by Mic Neale
- Easy setup using a QR code with a unique secret key to secure the connection
- Your tunnel URL remains the same across sessions, so you only need to configure your mobile app once
- The connection requires your computer to be awake with goose Desktop running
- Automatically reconnects if interrupted and restarts when you launch goose Desktop

## Setup

### Install the App
1. Install the **goose AI** app on your iOS mobile device from the [App Store](https://apps.apple.com/app/goose-ai/id6752889295)

:::tip App Store QR Code
Follow the steps below to open the `Mobile App` section, then click "scan QR code" in the info box for quick access to the App Store.
:::

### Start the Tunnel
1. Open goose Desktop
2. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar
3. Click `Settings` in the sidebar
4. Click `Session`
5. Scroll down to the `Mobile App` section and click `Start Tunnel`

Once the tunnel starts, you'll see a `Mobile App Connection` QR code for configuring the app.

:::info 
Click `Stop Tunnel` at any time to close the connection.
:::

### Connect the App
1. Open the **goose AI** app on your iOS mobile device
2. Scan the `Mobile App Connection` QR code displayed in goose Desktop
3. The app will automatically configure the connection

You can now access goose Desktop from your mobile device.

## What You Can Do

The mobile app gives you full access to goose:
- Start new conversations or continue existing sessions
- Use all your goose extensions and configurations
- Work from anywhere while your computer handles the processing

## Additional Resources

import ContentCardCarousel from '@site/src/components/ContentCardCarousel';
import mobileShots from '@site/blog/2025-12-19-goose-mobile-terminal/mobile_shots.png';

<ContentCardCarousel
  items={[
    {
      type: 'blog',
      title: 'goose Mobile Access and Native Terminal Support',
      description: 'Learn about two new ways to use goose: iOS app for mobile access and native terminal support with seamless session continuity.',
      thumbnailUrl: mobileShots,
      linkUrl: '/blog/2025/12/19/goose-mobile-terminal',
      date: '2025-12-19',
      duration: '4 min read'
    }
  ]}
/>