Repolode
Submit
aitobox

aitobox/ATBClone

A macOS engine for creating multiple isolated copies of apps like WeChat, Chrome or Cursor, each with its own data directory and proxy.

View on GitHubWebsite
Stars
436
Forks
41
Open issues
0
Last commit
20 hours ago

What is it?

ATBClone is a command-line and GUI tool for macOS that creates multiple independent copies of an application. Each clone gets its own user data directory, so you can run separate accounts or workspaces of the same app side by side.

The tool uses two strategies. Hard clone duplicates the whole app bundle, edits its Info.plist and bundle identifier, and redirects HOME and TMPDIR for isolation. Soft clone builds a lightweight wrapper that passes --user-data-dir or --profile arguments and proxy environment variables, which suits editors and browsers. Each clone can also use its own HTTP or SOCKS5 proxy, with credentials stored in the macOS Keychain.

The project ships 34 built-in recipes for apps such as WeChat, QQ, Telegram, Chrome, Cursor and VS Code. For unlisted apps, its prober inspects the Mach-O architecture and sandbox entitlements and generates a recipe. Commands cover cloning, listing, updating clones after the primary app upgrades, and removing clones with or without their data.

Key features

  • 01Hard clone and soft clone strategies for different app types
  • 02Isolated HOME and TMPDIR data directories per clone
  • 03Per-clone HTTP or SOCKS5 proxy with authentication
  • 04Built-in recipes for 34 popular apps and AI clients
  • 05Prober generates recipes for apps without one
  • 06Custom YAML recipes in ~/ATBClone/recipes/

Use cases

  • Running two WeChat or QQ accounts on one Mac
  • Keeping separate Chrome profiles routed through different proxies
  • Maintaining work and personal instances of Cursor or VS Code
  • Scripting clone creation and updates in CI or automation

Quick start

  1. 1

    Install the CLI from the README's Python package path (pip install from source)

  2. 2

    Run the interactive wizard to create your first clone

    atbclone wizard
  3. 3

    List your cloned apps

    atbclone list

Things to know

  • macOS only; it does not run on Windows or Linux.
  • Built-in dylib and launcher injection targets Mach-O apps, and some strategies depend on app architecture.
  • Stripping App Sandbox and ad-hoc re-signing modify the copied app and may affect its behavior or updates.

Topics

#macos#app-cloning#multi-instance#proxy#sandbox#cli#automation

FAQ

What is ATBClone?
A macOS engine for creating multiple isolated copies of apps like WeChat, Chrome or Cursor, each with its own data directory and proxy. ATBClone is a command-line and GUI tool for macOS that creates multiple independent copies of an application. Each clone gets its own user data directory, so you can run separate accounts or workspaces of the same app side by side.
Is ATBClone free to use? What license does it have?
ATBClone is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is ATBClone still maintained?
Actively maintained. The last commit to ATBClone was on Oct 19, 2026.
What can I use ATBClone for?
Running two WeChat or QQ accounts on one Mac Keeping separate Chrome profiles routed through different proxies Maintaining work and personal instances of Cursor or VS Code Scripting clone creation and updates in CI or automation
How do I install ATBClone?
Install the CLI from the README's Python package path (pip install from source) Run the interactive wizard to create your first clone: atbclone wizard List your cloned apps: atbclone list
Where can I get ATBClone?
The source code and installation instructions are on GitHub: https://github.com/aitobox/ATBClone

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects