Skip to content
Tarsk

Mobile App

Tarsk includes a mobile app for iOS and Android that connects to the Tarsk server running on your desktop or laptop. The mobile app uses the same interface as the web app, with native features such as QR code scanning for quick setup.

How It Works

Section titled “How It Works”

The mobile app does not run the Tarsk server itself. Instead, it connects over your local Wi-Fi network to a Tarsk instance running on your computer:

  • Your desktop runs the Tarsk server (desktop app or npx tarsk --server)
  • The mobile app connects to that server and provides the same chat, workspace, and project experience
  • All AI processing, git operations, and file system access happen on the desktop — the mobile app is a remote interface

Enabling Network Access

Section titled “Enabling Network Access”

Before the mobile app can connect, enable network access on the desktop:

  1. Open Settings → Settings (app-wide preferences at /settings/general).
  2. Sign in, then turn Mobile & Network Access on.
  3. Restart Tarsk.
  4. Tarsk displays a public address (https://<id>.tarsk.net).
  5. A Mobile App section with a QR code appears on the same page. The code prefers the public address.

With the toggle off (default), Tarsk leaves the bind hostname unset. This does not enforce localhost-only access. Use your firewall to restrict access.

Connecting from the Mobile App

Section titled “Connecting from the Mobile App”

When you open the mobile app and it cannot reach the Tarsk server, a Connect to Tarsk dialog appears.

Manual Entry

Section titled “Manual Entry”
  1. Note the public address shown under Mobile & Network Access on the desktop.
  2. Enter that address in the connection dialog on the mobile app.
  3. Tap Connect.

The app verifies the server is reachable before connecting. Opening the public address asks you to sign in as the account that is signed in on the desktop. If the connection fails, check that the Tarsk server is running.

QR Code Scanning

Section titled “QR Code Scanning”
  1. With network access enabled, scan the QR code in the Mobile App section on the desktop settings page.
  2. On the mobile app, tap the QR code icon in the connection dialog.
  3. Point your camera at the QR code on the desktop screen.

The QR code scanner requires camera permission. If denied, enter the public address manually.

Once connected, the server address is saved. The mobile app reconnects automatically on subsequent launches as long as the server is reachable.

Settings on Mobile

Section titled “Settings on Mobile”

Most settings tabs are available on mobile with the same options as desktop. The Account tab is hidden on mobile.

Font size applies an additional scaling multiplier on narrow viewports. The projects home sidebar collapses and can be toggled open.

Troubleshooting

Section titled “Troubleshooting”

If the mobile app cannot connect:

  • Confirm Mobile & Network Access is on in desktop settings
  • Restart the Tarsk server after enabling network access
  • Use the public address shown on the desktop.
  • Verify the desktop Tarsk server is running
  • If QR scanning fails, enter the address shown on the desktop
Section titled “Related”