Repository navigation
Codec 0.1.6
Python environments activate as you go into a project, tool versions show in the status bar, and ls lists files in color.
What's new
- Project environments activate on their own: go into a folder with a
.venv, or any folder below one, and a question at the top of the pane asks whether to activate it: Always, This Time or Never. Once allowed, Codec activates it as you go in and deactivates it as you leave, with nothing to type, and it's active by the time thecdreturns, socd app && python main.pyuses it. Codec asks first because a folder you downloaded could ship its own.venv/bin/python. Settings › Shell › Project environments lists your answers, to change or forget them. - Tool versions in the status bar: Codec follows which version of each tool your version manager picked for the folder (mise, pyenv, rbenv, nodenv, asdf, nvm, fnm, chruby, and the active conda environment). One chip counts them; click it for each version, where it comes from and the command to install or switch it. It turns to a warning when a tool isn't installed or isn't the version the project asks for. The Commands sidebar notes what each command ran with, and Explain passes it on.
lsin color: folders blue, links cyan, executables green, and every other file in the color its icon has in the file tree, in your theme's colors. The same colors go to eza, GNUlsand Tab completion; colors your own startup files set still win.- Icons with eza: turn on Settings › Shell › Use eza for ls and
lsshows an icon by each name, folders first. Without eza, Settings offers to install it with Homebrew. The icons show in any font, since Codec now carries Nerd Fonts' symbols. - The editor marks changed lines in its gutter, against the last commit: green beside added lines, yellow beside modified ones, and red where lines were deleted.
Install
Codec needs macOS 26 or later, on Apple silicon or Intel.
- Have 0.1.3 or later? Codec installs this one itself: Install in the update alert, then Install and Relaunch. Codec › Check for Updates… looks now.
- Download
Codec-0.1.6.dmgbelow, open it and drag Codec to Applications. - Or with Homebrew:
brew tap srozen/codec https://github.com/srozen/codec, thenbrew install --cask srozen/codec/codec. Already installed?brew upgrade --cask codec.
Most features rely on Codec's zsh integration, which loads automatically, alongside your own .zshrc, unchanged. New here? Start with Getting started.
Opening Codec the first time
Codec isn't notarized by Apple yet, so macOS stops it the first time you open it. Open System Settings › Privacy & Security, scroll down and choose Open Anyway beside Codec, then confirm. After each update, macOS asks again.