Ripul

Help & Guides

One app. Every agent.

Claude Code, Codex and whatever comes next, in one place instead of one app each. What they produce belongs to you rather than to the provider that made it — artefacts, plans and memories are addressed the same way by every model, so changing agent costs you nothing. And because it all runs on your own Mac, the machine comes with it: files, screens, processes, a real terminal and a desktop-class browser, on your phone, with more than one of you able to drive.

What it can do Set up your Mac

Up and running in three steps

  1. Install the Mac companion

    Ripul runs agents on your own machine, so the Mac app is the engine. It takes about two minutes.

  2. Pair your phone

    Scan the pairing code on your Mac and approve the request. Wi-Fi or Tailscale, your choice.

  3. Start your first session

    Pick a machine, a folder and a model, then ask for something small. Watch it work.

Start here

What Ripul is, and the twenty minutes that get you productive.

What Ripul can doThe phone stops being where you check on the work and becomes where you do it.8 min Set up your MacThe companion app is the engine. Install it once and forget about it.4 min Pair your phone with your MacA code, a scan, an approval. Two minutes, and it stays paired.3 min Two ways to reach your MacThrough Ripul, or straight to the machine. If you want to keep every byte on your own network, you can.4 min Run your first sessionMachine, folder, model, question. That is the whole ceremony.4 min

Working with agents

Sessions, models, machines and folders — the daily mechanics.

Running several sessions at onceOne agent per task, all of them working while you read one of them.3 min Fork, rewind and retryConversations are branches, not transcripts. Go back and take the other road.3 min Machines, folders and connectionsWhere the work happens, and how to move between the places it can happen.3 min Choosing a modelPick for the job, pin the ones you use, change your mind mid-conversation.2 min Using your own local modelsModels you run in LM Studio, on your Mac or on another machine, in the same list as the rest.3 min Approvals and staying in controlThe agent asks before it does anything consequential. You answer from your pocket.2 min Setting what tools an agent may useEach coding agent has its own permission settings on your Mac. Here is where they are and what each one does.3 min Bringing someone else into a chatInvite a colleague in, both of you direct the agent, and decide when it should stay out of it.4 min Trainyard: builds and deploys, in turnRun several agents on one project and let them all ship, without one breaking another’s build.7 min

Beyond the chat

Plans, artefacts, memories and the screens that make long work stick.

Plans and To DoAgree the approach before any code moves, then watch it get ticked off.3 min ArtefactsThe things the agent makes, kept somewhere you can find them again.2 min MemoriesTell it once. Stop repeating yourself in every new session.2 min Files, repos and commitsRead the code, see the diff, check the history — without opening the laptop.3 min Repos: the chats behind the codeEveryone working in a repository can see the chat behind each commit, and pick up the conversation that built the code.5 min Reaching into your MacConsole, Processes, Dock and Remote Tabs — the machine itself, from the phone.2 min Your Mac’s screen, on your phoneMirror a window and actually use it — pointer, keyboard and clipboard, not a screenshot.3 min A browser that behaves like a desktop oneReal viewports, a real pointer, real hover. Closer to carrying a small desktop than to browsing on a phone.3 min

Make it yours

Tools, voice and notifications — shaping Ripul around how you work.

Extensions your agent writesDescribe what a site should do differently, and install the result into your browser.3 min Tools and MCPTeach your agents new tricks, and connect the services you already use.3 min Talking to RipulHold the microphone and say what you want. Hands-free, it talks back.2 min Notifications and Live ActivitiesPut the phone away. It will tell you when it needs you.2 min

When something is wrong

The handful of things that go wrong, and what to do about each.

TroubleshootingThe short list of things that break, and the fix for each.4 min
The founder’s story Why I built Ripul

I was desk poor, but time rich.