Repository navigation
v0.2.0
ccc-morph v0.2.0
This release adds persistent workspace notes: a place to keep short notes and reminders next to whatever interactive program you are wrapping, and drop one straight into its prompt when you need it.
ccc-morph is still the same transparent PTY wrapper that remaps key sequences to your own actions for Claude Code, Codex, or any interactive terminal program. v0.2.0 builds the notes feature on top and makes first-run setup easier.
Highlights
- Persistent workspace notes: press
Ctrl-B Nto open the notes hub. Add and edit notes in your$EDITOR, mark one and pressEnterto insert it into the wrapped program's prompt (which archives it), and switch to the archive to restore. Notes are stored per working directory and persist across sessions. - One-command default setup:
ccc-morph --ensure-defaultscreates or tops up your global config with the default bindings (Ctrl-B Nfor the notes hub,Ctrl-B Efor the error viewer). It appends only missing, non-conflicting bindings, so it never overwrites your settings, andinstall.shruns it for you. - Bundled Claude Code config: a Claude app config now ships alongside the Codex one, so Claude Code keeps running while the notes hub or editor is open and redraws cleanly on close.
- Config validation:
ccc-morph --check-config FILEvalidates a config file and exits non-zero with a message if it would not parse.
Everything from v0.1.0 still works unchanged: transparent pass-through, configurable shortcuts (send input, run a background command, open the error viewer, quit), the safe non-interactive fallback, --inspect-key, and self-contained binaries.
Upgrading
Download the new tarball, extract it, and re-run ./install.sh. It swaps in the new binary, adds any newly bundled app configs without overwriting your own, and runs --ensure-defaults to add the new default bindings. Note that --ensure-defaults on its own only updates the global config; re-running install.sh is what installs the app configs.
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 # macOSFull 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.