sub2sub

Share Codex and Claude Code subscriptions across devices, task by task, without sharing account credentials.

Support for more tools is in development.

English · 简体中文 · Install · Usage · Contribute · Security

sub2sub is a task proxy for sharing existing AI subscriptions across your devices and team.

Delegate from your current conversation. An authorized device runs the task and returns responses and files; follow up in the same conversation. Each owner controls who can connect and which tools and models they share.

Install the plugin, connect two devices, and try your first task.

What you can do

• Choose shared resources. Select tools and models from connected devices and query remaining Codex quota. Optional automatic host selection follows your candidate order for new tasks; submitted tasks stay on their original device.
• Set sharing rules. Choose authorized clients, models, concurrency limits, access expiry and optional Token budgets. Stop accepting new tasks at any time. Sharing rules
• Collect results and request revisions. Send selected files, receive a complete work copy, and continue the same task. Decide when to apply changes to your project.
• Review resource usage. See task distribution, execution time, models and Token usage, with export support. Management and statistics

Suitable tasks include organizing documents, building offline pages and editing code. Tasks run in separate work copies with task network access, MCP, app and browser integrations disabled. Execution scope and environment requirements · Session visibility

Install

Install on both devices. Choose the app where you will use sub2sub and sign in first; the Host can choose its execution tool separately. Packages include Node, with no npm setup needed.

Ask your AI to install it

Send this to your Codex or Claude Code conversation:

Follow https://github.com/mekoand/sub2sub to install the latest stable sub2sub release for my current app. Confirm the version and enabled status, then explain how to restart and get started.

Or install manually below.

Codex

macOS · Terminal (Apple Silicon or Intel, detected automatically)

/bin/bash -o pipefail -c 'curl -fsSL https://github.com/mekoand/sub2sub/releases/latest/download/install.sh | /bin/bash'

Windows x64 · PowerShell

irm https://github.com/mekoand/sub2sub/releases/latest/download/install.ps1 | iex

After installation, fully quit and reopen Codex Desktop, or exit and restart Codex CLI.

Claude Code

macOS · Terminal (Apple Silicon or Intel)

/bin/bash -o pipefail -c 'curl -fsSL https://github.com/mekoand/sub2sub/releases/latest/download/install.sh | /bin/bash -s -- claude'

Windows x64 · PowerShell

& ([scriptblock]::Create((irm https://github.com/mekoand/sub2sub/releases/latest/download/install.ps1))) -Target claude

Start a new Claude Code session after installation. Devices that only send tasks do not need Codex. Claude Code Hosts currently require macOS; Windows can act as a Client. Requirements and custom paths

Confirm that it loaded

After restarting, ask:

Show sub2sub status and version without changing settings.

Confirm the loaded version and review the first-use settings. Enable sharing when you are ready to receive tasks.

To update, say “Upgrade sub2sub” in the same app and follow its restart instructions for the app or sharing node. Pairings and saved results are preserved. Install, update and troubleshooting

Connect your work nodes

A Host receives and runs tasks; a Client delegates tasks and receives results. One device can serve both roles.

Pair directly on a private network. For different networks, first enable cross-network service.

On the Host:

Generate a sub2sub invitation.

Send the invitation privately to the Client. Paste it into the Client's conversation and ask:

Connect this sub2sub invitation and name it office-mac.

Confirm the file-transfer scope when prompted. Keep the Host awake and connected while sharing; its management conversation can close.

Try one small task

Choose a sample text file, notes.txt, and ask:

Use sub2sub to send only notes.txt to office-mac. Summarize it in summary.md and return that file and a short answer.

Open the local summary.md link when it finishes. Responses and files are saved on your device; the source file stays unchanged.

To revise it:

Continue that task. Make summary.md shorter and save the updated result locally.

The Host reuses the task and working files. Saved results remain available offline. Delegation, results and cleanup

Example: share a teammate's Claude Code subscription

Your teammate signs in to Claude Code on a Mac and authorizes sharing. Connect to it from Codex, name it office-mac, and delegate:

Use sub2sub to send the docs directory to office-mac. Build an offline help site with search, check the links, and return the complete files.

Review the local result, then follow up:

Continue that task. Group the pages by topic and improve the mobile layout.

The Host reuses the working files and Claude session; you receive an updated complete copy. Once satisfied:

Save the latest results, finish the task, and clean up its remote work copy.

Apply changes to your project when ready. Using results and cleanup

Management and statistics

Ask in your conversation:

Open sub2sub management.

Manage connections, sharing rules, tasks and local results, and query Codex quota. Statistics cover task distribution, turns and execution time over 7 or 30 days. View model and Token usage by source, with missing data marked, and export it as JSON.

Management is enabled by default and can be turned off in settings. Task instructions and follow-ups stay in your conversation. Management and statistics

Across networks

Enable cross-network service on both devices, then exchange an invitation as usual. It is off by default. Connections prefer private routes; the bundled Tailcat transport can use public relays when needed. Existing connections can be migrated explicitly. Setup and migration

Compatibility

Choose the Client app and Host execution tool independently.

WorkBuddy and other apps remain untested. Versions and validation details

v0.9.4 updates task file transfers, transfer performance and upgrade maintenance. See the release notes for changes and validation scope.

Development

npm ci --omit=optional --ignore-scripts
npm run check
npm test

Development and packaging · Architecture · Contributing · Changelog

Contribute and give feedback

Contribute documentation, translations, bug reproductions, fixes or tool adapters. Start with the contribution guide (中文). Use Issues for bugs and suggestions, and the private security channel for vulnerabilities.

For help, ask “Help diagnose this sub2sub problem” in your conversation. To report it, say “Submit this issue to GitHub”. The assistant drafts the report, checks for duplicates, and submits it with available tools or gives you the draft. Troubleshooting

MIT © 2026 mekoand