Skip to content

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 23 Jul 00:30
· 7 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.1.0
1c51bae

ccc-morph v0.1.0

First public release of ccc-morph — a transparent PTY wrapper that lets you remap key sequences for any interactive terminal program, without the wrapped program knowing.

The motivating case is bridging Claude Code and Codex: wrap Codex with the bundled config and a stray single Ctrl-D is ignored, while a deliberate Ctrl-D Ctrl-D sends exactly one Ctrl-D — so Claude Code muscle memory no longer nukes your shell. The tool is generic and works with any interactive program.

Highlights

  • Transparent by default — the child inherits your working directory, environment, TERM, and size; output is never re-rendered in normal operation.
  • Configurable shortcuts — remap key sequences to actions via config.toml and per-app configs (a Codex app config ships in the box).
  • Safe fallback — in a pipe or non-interactive shell it just runs your command directly and forwards its exit code.
  • Key inspector — ccc-morph --inspect-key prints the exact bytes a key sends.
  • Self-contained binaries — no Bun, Node.js, or Docker needed to run.

Install

Self-contained binaries for linux-x64, linux-arm64, darwin-x64, and darwin-arm64 are attached below. Download the tarball for your platform and SHA256SUMS.txt, then extract and run the bundled ./install.sh.

Verify the download (optional):

sha256sum -c SHA256SUMS.txt --ignore-missing      # Linux
shasum -a 256 -c SHA256SUMS.txt --ignore-missing  # macOS

Full install, configuration, and usage details are in the README.

Requires Linux or macOS; Windows works via WSL2 (use the linux-x64 binary). Licensed under MIT; see the bundled notices for embedded-runtime licenses.

Assets 8
Loading