Open-source core · Commercial license

Switch between
Claude↔Codex CLI
without rewriting anything

One shim command. Both CLIs. Your scripts, aliases, and hooks keep working — you just pick which AI is driving today.

~/my-project 
# scripts break when you hardcode one CLI
$ ai "fix this bug"        # which one runs?

# shim: one alias, hot-swappable backend
$ shim use claude
✓ Active: Claude Code (claude 1.0.51)
$ ai "fix this bug"           # → claude

$ shim use codex
✓ Active: OpenAI Codex (codex 1.2.0)
$ ai "fix this bug"           # → codex

$ shim status
active:  codex 1.2.0
standby: claude 1.0.51
aliases: ai → $SHIM_ACTIVE_CLI

License activated — check your email!

Your license key + Discord invite are on the way. Run shim activate <key> to unlock.

View on GitHub

One-time payment · Perpetual license · Discord support included · 14-day refund

The Problem
Two great CLIs.
Zero interoperability.

You try Claude Code one week, then OpenAI drops a better Codex model. Every script, alias, and hook breaks the moment you switch.

Without shim

Scripts hardcode claude or codex. Switching means grepping through shell configs, rewriting CLAUDE.md paths, debugging broken hooks — every time.

With shim

One unified alias (ai by default). Run shim use claude or shim use codex. All scripts, hooks, and CI pipelines keep running — different engine, zero edits.

Features
Open-source core —
everything you need
⚡
Instant switching
shim use <cli> swaps the active backend in under 50ms. No shell restart required.
🎯
Unified alias layer
Map any command (ai, llm, gpt) to the active CLI. Muscle memory stays intact.
🪝
Hook forwarding
CLAUDE.md hooks and pre/post-command scripts pass through transparently regardless of active CLI.
📊
Usage tracking
Per-CLI session stats: tokens used, cost estimate, commands run. Compare models on your actual workloads.
🔧
Flag normalization
Common flags (--model, --no-stream) normalize across CLIs. Write once, run on either.
🐚
Shell agnostic
bash, zsh, fish, nushell. Auto-detects your shell and writes the correct alias syntax on shim init.
Install
Up in 60 seconds

Open-source core is MIT-licensed and free for personal use. The $29 commercial license adds team sync, Discord support, and removes the attribution footer.

1
Install via npm
Requires Node 18+. Have at least one of claude (Claude Code) or codex (OpenAI Codex CLI) already installed.
npm install -g voiddo-claude-codex-shim
2
Initialize
Scans for installed CLIs and writes aliases to your shell config. Source your rc file or open a new terminal.
shim init
3
Pick your active CLI
Switch any time. The unified alias follows automatically.
shim use claude # or: shim use codex
4
(Optional) Activate commercial license
Unlocks team sync, removes attribution, adds Discord support access.
shim activate YOUR_LICENSE_KEY
Pricing
One price. Yours forever.
Commercial License
vøiddo shim
$29
one-time
  • ✓ Perpetual commercial license — use in any project, forever
  • ✓ All current + future open-source features
  • ✓ Team config sync across machines
  • ✓ Attribution notice removed
  • ✓ Discord support channel access
  • ✓ Offline license — no phone-home, ever
Free for personal use. Core is MIT-licensed. Commercial license required for: products you sell, client work, or commercial internal tooling. 14-day no-questions refund — email support@voiddo.com with your order number.
FAQ
Common questions
Yes. The shim works with one or both CLIs. With only Claude Code, it sets up the alias layer and usage tracking. Install Codex later and run shim scan to detect it.
No. The shim sits in front of the CLIs — it doesn't modify them. CLAUDE.md, hooks, and per-directory config all pass through untouched.
No phone-home. The license validates locally against a hash stored in ~/.voiddo-shim/. Fully offline once activated.
Yes — the license is per-developer, not per-machine. Laptop, desktop, servers — all covered. Team sync shares your active CLI and alias config across them.
Direct async support from the vøiddo team. Bug reports, config questions, and feature requests are prioritized for license holders. Typical response: within 24h on weekdays.
Yes — 14-day no-questions refund if the shim doesn't work with your setup. Email support@voiddo.com with your order number.