Migrate from Charles to Proxyman

Cover Image for Migrate from Charles to Proxyman

It's the mini blog to help you migrate files from Charles to Proxyman.

It's a handy feature if you have a bunch of error log that you've already captured from Charles and would like to investigate or migrate to the Proxyman app.

How it works

Fortunately, Charles has a built-in command that allows us to convert the CHLS file to the HAR format that Proxyman can understand. Thus, please make sure that you have this app on your machine.

FYI: We can manually convert by executing this command on Terminal

./Applications/Charles.app/Contents/MacOS/Charles convert ~/Desktop/input.chls ~/Desktop/output.har

How to use

1. Export Charles Session

We can export the current session in two ways:

  • Right-click on the selected requests -> Export Session -> Select chls format -> Save
  • or File menu -> Export Session as... -> Select chls format -> Save
Migrate from Charles to Proxyman
Migrate from Charles to Proxyman

2. Drag and Drop to Proxyman app

You can drag and drop the file to Proxyman app

Migrate from Charles to Proxyman
Migrate from Charles to Proxyman

3. Automatically convert

At the first time you've used this feature, Proxyman would prompt the warning to make sure you're aware that Proxyman will use Charles to convert automatically.

Migrate from Charles to Proxyman
Migrate from Charles to Proxyman

If Charles app doesn't install on your Mac, Proxyman would prompt the alert.

4. All done

At this step, Proxyman will find the default Charles app path and trigger the command to convert the file.

Migrate from Charles to Proxyman
Migrate from Charles to Proxyman

From here, we can:

  • Repeat & Edit the request for testing
  • Set rule for Map Local & Breakpoint
  • Testing and find the bug 🐞

Manual Convert

You can manually convert chls file to har format by going to:

  • File Menu -> Convert -> Chls to Har and follow the instruction
Migrate from Charles to Proxyman
Migrate from Charles to Proxyman

Helpful hint

If Charles is still available, exporting HAR with content is usually the easiest format to move between tools. A CHLS conversion needs the Charles app because its file format belongs to Charles. After import, check that request and response bodies are present; an export made without content may contain only headers and timing details.


Proxyman is a high-performance macOS app, which enables developers to capture and inspect HTTP/HTTPS requests from apps and domains on iOS device, iOS Simulator and Android devices.

Get it at https://proxyman.com

Noah Tran
Noah Tran

Revised July 16, 2026. Added a simpler HAR option and clearer checks for the CHLS converter.

Bring your saved sessions to Proxyman

Open a HAR file or convert a Charles session, then continue debugging with Proxyman tools.

Download Proxyman