r266-tech

r266-tech / sub2cli

Public

Sub2API gateway subscription → Codex CLI / Codex App injector. macOS-native, zero-deps Python single-file. Supports codex2api.com and any self-hosted Sub2API instance.

api-gateway channel-switcher cli codex codex-cli
12
5
80% credibility
Found May 24, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

sub2cli is a macOS application that helps people manage their Codex AI assistant connections. It provides a visual dashboard where users can add multiple relay services (third-party API providers) and official Codex accounts, test which endpoints work best, view account balances and usage, and automatically configure Codex to use their preferred setup. The app handles the technical details of switching between different services and accounts, creates automatic backups before making changes, and can be used either through a desktop interface or a terminal-based control panel.

How It Works

1
💡 You hear about a better way to use Codex

You've been using Codex but switching between different services and accounts feels complicated. You discover sub2cli, a tool that promises to make managing everything in one place.

2
📥 You install the app on your Mac

You download the app and drag it to your Applications folder. The app walks you through getting started with a friendly interface.

3
🔗 You connect your preferred relay service

You add your favorite third-party service (or Codex's official service) by entering your account details. The app saves your login information securely in your Mac's password manager.

4
⚡ You test which endpoints work fastest

With one click, you see which servers respond quickest. You can even test different pricing groups to find the best deal for your needs.

5
🎯 You pick your favorite setup

You select the relay, endpoint, and pricing group that work best for you. The app shows you exactly what will change before anything is modified.

6
✨ Everything is configured automatically

The app sets up Codex for you - updating all the necessary settings and files. It creates a backup first, so you can always undo if something goes wrong.

🎉 Codex is ready to use

Your Codex assistant is now connected to your chosen service. Switching between different accounts or relays is as easy as clicking a button.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 12 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is sub2cli?

sub2cli is a Python-based gateway that connects Sub2API relay subscriptions to Codex CLI and Codex App on macOS. It automates the tedious process of switching between API relays, testing endpoint availability, and configuring local Codex settings -- tasks that normally require manually editing config files and juggling browser logins. The tool ships as a native macOS desktop app with a terminal REPL option, letting you manage multiple relay endpoints, check account balances and subscription usage, batch-test model availability across groups, and push configurations directly to Codex with a single command. It reads auth tokens from your browser via CDP and stores credentials securely in the macOS Keychain.

Why is it gaining traction?

The main hook is eliminating the multi-step ritual of testing relays and patching Codex config files by hand. Instead of finding a key, choosing an endpoint, editing config.toml, and restarting Codex hoping your session survives, you get a visual dashboard that probes every endpoint, shows latency, batch-tests groups against specific models, and writes the selected configuration with automatic rollback backups. The desktop UI follows a dark industrial aesthetic with status lights and operational tags, which resonates with developers who want their tooling to feel intentional rather than cobbled together.

Who should use this?

Developers running Codex CLI or Codex App on macOS who rely on Sub2API relays or codex2api.com will get the most value. If you juggle multiple relay accounts, test different pricing tiers or model availability across groups, or simply want a visual way to switch Codex providers without touching dotfiles, this fills a specific gap. It's less useful if you use a single relay with a stable configuration or rely entirely on OpenAI's official API.

Verdict

sub2cli solves a real pain point for Codex power users on macOS, but its credibility score of 0.80% and 12 stars reflect a very early-stage project with limited community validation. The feature set is comprehensive, the backup/rollback approach is thoughtful, and the dual CLI/desktop UX covers different workflows well. That said, the unsigned macOS distribution, sparse test coverage, and lack of signed builds mean you're accepting some operational risk. Worth trying if your workflow involves frequent relay switching -- just keep rollback commands handy and monitor the GitHub releases for updates.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.