Install

npm is the primary install path. Native binaries via Homebrew, Linux packages (Debian/RPM), Docker, or direct download are also available.

Canonical (npm)

Requires Node.js 20+:

npm install -g @zhachory1/mewrite-code

The package installs mewrite and mewritecode aliases alongside mewrite-code. Any works.

mewrite --version
mewrite

Works on macOS, Linux, Windows (PowerShell + WSL). Same package on every platform.

Faster installs

pnpm, yarn, and bun all work too:

pnpm add -g @zhachory1/mewrite-code
yarn global add @zhachory1/mewrite-code
bun add -g @zhachory1/mewrite-code

Other paths

Homebrew (macOS, Linux)

brew tap Zhachory1/mewritecode https://github.com/Zhachory1/mewritecode
brew install mewrite

The tap is auto-updated by the release pipeline.

Debian / Ubuntu

echo "deb [trusted=yes] https://raw.githubusercontent.com/Zhachory1/mewritecode/gh-pages/apt ./" | sudo tee /etc/apt/sources.list.d/mewrite.list
sudo apt update
sudo apt install mewrite-code

The primary command is mewrite; the package also installs mewrite-code and mewritecode aliases.

Fedora / RHEL / CentOS

sudo curl -fsSL https://raw.githubusercontent.com/Zhachory1/mewritecode/gh-pages/yum/mewrite.repo -o /etc/yum.repos.d/mewrite.repo
sudo dnf install mewrite-code  # or yum

The primary command is mewrite; the package also installs mewrite-code and mewritecode aliases.

Snap (tracked, not yet published)

Snap packaging metadata is tracked in snap/snapcraft.yaml. Once published to the Snap Store:

sudo snap install mewrite-code --classic

Docker

docker run --rm -it -v "$PWD:/work" ghcr.io/zhachory1/mewritecode:latest

Mounts your working directory into /work. The image runs as a non-root user.

Windows

npm install -g @zhachory1/mewrite-code

The npm package works on Windows PowerShell and WSL. WSL is the supported terminal path.

Manual download

Grab the platform-specific tarball from the GitHub releases page and extract to a directory on your PATH.

Verify

mewrite --version
mewrite doctor

mewrite doctor reports:

• Kernel and terminal capabilities
• Sandbox availability (Seatbelt / Landlock / Restricted Tokens)
• MCP servers reachable
• Missing tooling (git, ripgrep, fzf — used optionally for fuzzy file pickers)

Auto-update

Me Write Code checks the GitHub releases API once per 24 hours and prompts before applying. To pin a channel:

mewrite self-update --channel stable    # default
mewrite self-update --channel beta
mewrite self-update --channel canary

To update on demand:

mewrite self-update

Rollback is not currently exposed as a CLI command; reinstall the desired version with your package manager if needed.

Uninstall

rm -rf ~/.mewrite
# remove the mewrite-code symlink from your PATH (~/.local/bin/mewrite or /usr/local/bin/mewrite)

Sessions and user config live under ~/.mewrite/agent/. Memory (cavemem) lives in ~/.cavemem/ and is not removed by the above — clean it explicitly if needed.

Headless / CI install

npm install -g @zhachory1/mewrite-code@0.65.2   # pin a version for reproducible CI

See mewrite exec mode for using mewrite inside GitHub Actions.