mubash.dev / Xpositor

Xpositor

Vibe with confidence. Review line by line.

  • Free
  • VS Code extension
  • Open source
  • Preview
Xpositor reviewing a real change: the diff, and a Code guide walkthrough titled Why --max-turns had to change (the root cause)
Actual development build reviewing a real commitExplanations by Claude Sonnet through Claude Code

Why I built it

While building mapofxp, code review was the part I kept putting off. Xpositor is the tool I made to get past that: review from my phone, wherever I am, with a guide that explains the code the way a friend would.

Mubashir Durrani, maker of Xpositor and mapofxp

Understand

Explain it to me like a friend.

Point the guide at a change and it explains what the code does and why, in plain language, grounded in your repository.

  • Walk me through it

    The guide reads every changed file, groups related changes, explains the intent and suggests an order to review them. Ask questions as you go; side questions branch off without losing your place.

  • Line by line

    Deep review takes one file at a time, in short sections, and explains each block next to the lines it describes. Ask it to explain more simply, or for another example.

  • Listen and follow

    Turn a chapter into a short spoken lesson: context, an example, the code it touches, an edge case and a question to check you understood. The code highlights as it's read aloud, and the voice runs locally on your laptop.

Review

Review at your own pace.

A reader built for a phone screen, and a queue that remembers where you were.

  • A reader made for phones

    Diffs, full source and Markdown, with adjustable code size, line wrapping, folded context and a jump to the next change. Review staged, unstaged or all changes.

  • Keep reviewing offline

    Each capture saves the changes and their source to your phone, so you can keep reading and leaving notes on a train or a flight. Reconnect to your laptop for new changes and AI answers.

  • One file at a time

    Mark a file reviewed and move to the next. Decisions stick to that exact revision, so code that changes comes back for another look. On a laptop, arrow keys move between files and Return marks one done.

  • Private notes on any line

    Leave a question on a line or range and resolve it later. Export your notes as a Markdown summary for your next session at the desk.

  • Room to focus

    A 25-minute focus timer with 5-minute breaks, and a short breathing exercise for when you need a pause.

Actual development build reviewing a real commit

Privacy first

Your code stays yours.

Xpositor reads code and nothing more. What leaves your laptop, and where it goes, is always your choice.

  • Your code stays on your laptop

    A local companion serves a captured snapshot to your phone. Notes and review decisions stay in your phone's browser; guide history stays on the laptop.

  • AI on your terms

    Explanations use the Codex or Claude Code account already signed in on your laptop, and credentials never reach the phone. Only the questions you ask and the code the guide retrieves go to that provider. Paid API mode is never switched on automatically.

  • Read-only by design

    It never edits files, stages changes, creates commits or approves pull requests. Marking a file reviewed is your own progress, not a repository action.

  • Open source

    The source is on GitHub under Apache 2.0, so you can check all of this for yourself.

Local Wi-Fi mode uses HTTP and is meant for trusted networks. The optional HTTPS tunnel relays through Cloudflare as a trusted intermediary. Keep your pairing link private.

From your editor to your phone

How Xpositor works

  1. Open your repository in VS Code.

    The extension starts a local companion on your laptop. Your repository stays there.

  2. Pair your phone.

    Scan the QR code on the same trusted Wi-Fi network. An optional HTTPS tunnel lets you connect from another network.

  3. Review at your own pace.

    Read a captured snapshot, ask questions, and leave notes. Keep the laptop running for new captures and AI responses.

Before you try it

Release, pricing, and source

Is Xpositor free?

The extension is free. Optional AI features use your connected provider account and its limits. Explicit API mode is billed by your provider; it is never enabled automatically. Basic diff review does not need AI.

Where can I install it?

From the VS Code Marketplace. It is a preview, so expect rough edges, and tell me what you find at xpositor@mubash.dev.

Is it open source?

Yes. Xpositor is released under the Apache 2.0 license, and the source is on GitHub.

Which AI does it use?

Codex or Claude Code, through the account you have already signed in with on your laptop, and you choose the model. Basic diff review works without any AI.

Does the voice cost anything?

No. Narration uses Kokoro, a speech model that runs locally on your laptop after a one-time download. Text and code are never sent to a cloud speech service. Narration is English-only for now.

Can I use it offline?

Saved snapshots and notes can be read after disconnecting. Installing the phone app and relaunching it offline requires HTTPS. New captures and AI responses need the laptop; back up your browser data before changing pairing origins.

Install Xpositor.

Install the extension, click the Xpositor icon in the Activity Bar, then scan the QR code with your phone.

A free, open-source (Apache 2.0) preview. For feedback or questions, write to xpositor@mubash.dev.

Install from VS Code Marketplace View source on GitHub