docs: mobile access #6180
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,80 @@ | ||
| --- | ||
| title: Mobile Access via Secure Tunneling | ||
| sidebar_position: 3 | ||
| 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 `Remote Access` 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 `App` | ||
| 5. Scroll down to the `Remote Access` section and click `Start Tunnel` | ||
|
|
||
| Once the tunnel starts, you'll see a `Remote Access 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 `Remote Access 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: '/goose/blog/2025/12/19/goose-mobile-terminal', | ||
| date: '2025-12-19', | ||
| duration: '4 min read' | ||
| } | ||
| ]} | ||
| /> |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
removed the hardcoded region to rely on autodetect