Download Pairling for iOS

02Install Pairling

Control your CLI coding sessions remotely with your iPhone.

Works with your CLIs Claude Code Codex Gemini CLI OpenCode Grok Build Hermes Agent Devin Prime Intellect OMP Aperture CLI

A full extension of your Mac’s coding sessions. That’s Pairling.

01 / Share

Share anything as context

Use the iPhone Share menu to queue text, links, photos, videos, documents, and other files for Pairling. The Share Extension copies accepted items into a protected local inbox; Pairling then transfers them to PairDrop.

Choose Pairling from another app’s Share menu. The extension accepts text, links, images, videos, and files, copies each item into Pairling’s protected app-group inbox, and confirms whether it was queued.

Pairling requests a background transfer after it queues an item. If iOS cannot schedule that work, the confirmation tells you to open Pairling. The app also drains the inbox the next time it enters the foreground.

Completed items arrive in PairDrop through Pairling Connect. Review them in Pairling, then attach an uploaded item to an existing session when you want an agent to use its Mac path.

The Share Extension never starts or changes a coding session. It queues locally; you decide in Pairling where an uploaded item goes.
02 / PairDrop

Send any file to your Mac... and back

Move files between your iPhone, Mac, and agents through Pairling Connect. PairDrop stores everything on your own drive, gives agents exact local paths, and lets you preview, organise, export, reuse, or send a result into another session.

PairDrop is a private file space shared by Pairling on your iPhone and Mac. Send any file from Files, Photos, another iPhone app, or an agent running on your Mac. Pairling transfers it through Pairling Connect and stores it on your own drive instead of placing it in a hosted storage account.

Search your files and sort them by name, type, date, size, or tags. Preview a file on the iPhone, save it to Files, share it with another app, rename it, organise it, or remove it from PairDrop. The same library remains available on your Mac.

Attach any PairDrop item to a session and Pairling gives the agent the exact local path. The agent can inspect the file, use it while working, and publish a result back into PairDrop. You can then open that result on the iPhone or pass it into another session.

Your Mac stores the files. PairDrop uses your own drive space and moves every item through your private Pairling connection.
03 / Publish to PairDrop

Let your agents send you files via PairDrop

Give Claude, Codex, or another agent a safe command for publishing finished work into PairDrop. Pairling checks the project path, copies the file without changing the original, records its source, and makes it available on your iPhone.

Claude, Codex, and other agents can publish a finished file directly into PairDrop. The agent runs pairling pairdrop publish <path> or calls the same action through a tool. Pairling checks that the source is a regular file inside the repository and rejects any path that leaves the allowed project.

Pairling copies the file into PairDrop without removing or changing the original. It records the filename, size, file hash, source session, provider, repository, and time. The agent receives a receipt as soon as the copy is complete.

The file appears in PairDrop on your iPhone. Preview it, save it to Files, share it with another app, attach it to another session, or keep it stored on your Mac. Deleting the PairDrop copy leaves the original project file untouched.

The original stays in the repository. PairDrop gives you a separate copy with its source and publishing history attached.
04 / Record and Transcribe

Record a conversation while Pairling transcribes it

Record a meeting, interview, journal entry, or spoken explanation while Pairling transcribes it on your iPhone. Keep the saved audio, editable transcript, and word timings together, then turn the material into a prompt or send it to your Mac.

Pairling records audio and transcribes it in real time on your iPhone. Use it for a meeting, interview, one to one, journal entry, or a spoken explanation that is easier to say than type. You can pause, resume, edit the transcript, and see each part appear while people are still speaking.

You can also import an existing recording for transcription. Pairling keeps the audio, transcript, and word timings together. During playback, the timed transcript follows the current word. Edit the transcript, regenerate its timings, or extract key points on your iPhone with Apple Intelligence.

Sync the audio, transcript, key points, and prompt to your Mac through PairDrop and Pairling Connect. You can share the notes, attach the saved audio to a session, or shape the transcript into a prompt and send it to a selected coding session.

The audio remains available after transcription. Play it back, correct the transcript, sync it to your Mac, or turn it into a prompt for an agent.
05 / Prompt Helper

Turn rough ramblings into clear prompts

Turn unfinished ideas, transcripts, notes, and spoken explanations into direct prompts before sending them anywhere. Choose a reusable helper, use Apple Intelligence on the iPhone, or send the draft to an agent when the rewrite needs repository context.

The starting text can be an unfinished idea, a long spoken explanation, a meeting transcript, an interview, a journal entry, or notes copied from another app. Prompt Helper works on the draft inside Compose before you send it anywhere.

Choose a helper that removes repetition, shortens the text, makes the request more specific, turns it into direct instructions, or softens the tone. Create your own helper by describing how you want Pairling to write. Save that guidance as a posture and use it again on any draft.

Use Apple Intelligence for a private rewrite on the iPhone. When the prompt needs project context, choose Claude, Codex, or another provider agent and send the draft into your repository for deeper analysis. Pairling keeps the original draft available so you can compare the result, undo it, edit it, or try another helper.

You choose how Pairling helps. Shape the draft on your iPhone or let an agent use the repository to understand it properly.
06 / Compose

Build prompts from recordings, files and project context

Bring recordings, transcripts, shared links, PairDrop files, notes, and session context into one prompt workspace. Set the posture, structure, detail, proof, and final format, then save, reuse, send, or launch the finished prompt.

Compose is the full workspace for creating a prompt before it becomes agent work. Bring in a recording, transcript, shared link, PairDrop file, photo, note, previous prompt, or material from a running session. Pairling keeps every source beside the editable draft so you can see what the prompt is based on.

Ask Pairling to analyse a transcript and help you decide what the prompt needs to achieve. Set its posture, output length, structure, level of detail, required proof, and final format. Use the supplied controls or create your own variables when the prompt needs a custom shape.

Review the finished prompt and save it to your library. Copy it, revise it, reuse it, send it to a running session, or use it to start new work. The same prompt can launch one agent or become the objective for a multi-agent orchestration.

One draft can go anywhere. Keep it as a reusable prompt, send it into an existing session, start a new session, or launch an orchestration.
07 / Orchestrations

Set an objective and let agents work on it together

Turn one objective into coordinated work across a planner and several agents. Set their roles, access, limits, tests, and stopping conditions, then follow every worker and change the plan from your iPhone while the orchestration runs.

Start an orchestration from a prompt, transcript, shared item, PairDrop file, saved Compose draft, or existing session. Choose the Mac, repository, provider, planner, and workers. Give each worker a role yourself or let the planner divide the objective into separate tasks and coordinate the work.

Set what the agents can access and which commands they can run. Choose how much review they need, how long they can work, how much model usage they can consume, and what proof they must produce. Add acceptance checks and tests. Tell Pairling to stop after the first useful finding, when the tests pass, when the budget is reached, or when time expires.

Follow the planner and every worker from your iPhone. Read their transcripts, inspect commands, review file changes, follow test results, and see when an agent is blocked or waiting for permission. Give a worker more context, change its task, add or remove workers, pause the whole orchestration, or stop one worker without stopping the rest. Pairling gathers the final changes, evidence, tests, unresolved questions, and finished files into one result.

You remain in control throughout the run. Change the plan, steer one worker, review the evidence, or stop the work from your iPhone.
08 / Notifications and Live Activity

Keep tabs on your turn's progress

Follow running work through notifications, the Lock Screen, and the Dynamic Island. See progress, tests, connection state, and requests for attention, then reply, approve, pause, stop, or open the exact transcript from your iPhone.

Pairling notifies you when an agent asks a question, requests permission, becomes stuck, loses its connection, reaches a limit, finishes a task, changes a file, or completes a result. Choose the events you want for each project, session, or orchestration. Pairling groups repeated events so one worker never floods your Lock Screen.

A Live Activity follows running work on the Lock Screen and in the Dynamic Island. It shows the Mac, project, provider, current task, elapsed time, worker progress, tests, and anything that needs your attention. Reply with text or voice, approve or deny a request, pause or continue the work, stop a session, or open the exact transcript that caused the alert.

Updates continue while Pairling is in the background. Every update includes its time, and Pairling marks information as stale when the Mac is no longer reachable. Hide project details on the Lock Screen while keeping the controls available. Notification history shows what happened, how you responded, and whether each action reached the Mac.

Every alert opens the work that caused it. Every action returns a receipt so you know the Mac received it.
github.com / pairling / issue / 184
pairling / pairling

Stream freezes after reconnect

Safari session viewer stops updating after the phone changes networks.

FilesPairDropDone

Send the source.

This file will be stored on your Mac.

crash.mov 84.2 MB / QuickTime movie
Pairling ConnectConnected
Stored on Mac~/PairDrop
TransferComplete
LibraryRecording18:42

Interview with Alex

Recording and transcribing on this iPhone.

Live transcript / Alex

The reconnect problem begins when the phone changes networks. The session remains open, but new events stop appearing.

AudioRecording
TranscriptLive
Sync to MacOn
PauseUse transcript
CancelCompose•••

Build the prompt.

Source material

Interview transcript + Issue #184 + crash.mov

Prompt controls

Actionable · Detailed · Include proof

Prompt

Reproduce the reconnect failure, protect auth, fix the stream, and prove it with tests.

Save promptChoose destination
New session · Running session · Orchestration
ComposePrompt helper18 sec

“Can you look at this? Reproduce it first. Do not touch auth. Run the stream tests.”

GoalReproduce the stream crash.
GuardrailDo not change auth.
ProofRun the stream tests.
Use this prompt Keep editing
BriefStart runReady

Set the bounds.

Project~/pairling
ProviderCodex
Agents3 max
Time20 min
StopTests pass
ChangesReview first
ReproduceTrace stream failure
InspectRead reconnect path
TestRun stream suite
Start 3 agents
12:18
Saturday 18 July
Pairling / Codex14 min

Three agents running

Reproduced. Two stream tests remain.

ReplyReview

Nothing needs you yet.

FilesPairDrop•••
Run stopped / 14 of 14 tests pass
diagnosis.md

Published by Codex from Pairling session 0214. Ready to preview.

StoredOn your Mac
SourceSession 0214
Size4 KB
Preview Save or share

Scene 1: Share

01 / Share

Share anything as context

The complete control surface.

09 / Pairling Index

Pairling Index.

09.01Access / Connect

Connect and manage your Macs with Pairling Connect.

Pair several Macs and reach them remotely through Pairling Connect. Seamlessly switch your Mac control surface anytime.

Pair a Mac by scanning a QR code or pasting its pairing link. Pairling stores the device credential in the iPhone Keychain. When the key remains valid, Face ID reconnects the Mac without another QR code.

Pairling Connect uses Pairling’s embedded private network connection, so the iPhone does not need a separate Tailscale app. Pairling uses a local route when both devices are nearby. You can keep several Macs and choose the active one. Connection Health shows the current route and any connection error. Advanced setups can add an SSH tunnel. Forgetting a Mac revokes its access.