cosyterm 0.3.0

Your terminal, but make it cozy. One command to install a curated, Catppuccin-themed dev setup — Ghostty, Starship, eza, tmux, NeoVim, and more.

cosyTerm

Your whole terminal stack, themed in one command.
_{Ghostty, your shell, Starship, eza, tmux, NeoVim — all Catppuccin Mocha, fully reversible.}

---

Install

pip install cosyterm
cosyterm

Seven [y/N] prompts. About two minutes. Nothing installs without you saying yes. Existing configs are moved to a timestamped backup first, so cosyterm restore --latest reverses the whole run.

What you get

Tool	What it does
Nerd Font	10 patched fonts — JetBrains Mono, Commit Mono, Cascadia Code, and more
Ghostty	GPU-accelerated terminal emulator by Mitchell Hashimoto
Fish or Zsh	Fish (recommended) or Zsh (POSIX-compatible)
Starship	Cross-shell prompt — git, language versions, right-aligned and clean
eza	ls with icons, colors, git status, and tree views
tmux	Terminal multiplexer with pastel status bar at top
NeoVim + LazyVim	IDE-grade editor, pre-configured, zero setup

Docs

• Safety model — every command that runs, every URL fetched, every sudo — plus backups and blast-radius guarantees.
• Recovery — cosyterm doctor, cosyterm restore, and the --dry-run preview.
• Automation — scripted installs (COSYTERM_YES=1, COSYTERM_NVIM_CHOICE), re-running a single step, and the Python API.
• Design philosophy — why cosyTerm is opinionated and what it won't add.

---

Try it. If it's not for you, cosyterm restore --latest puts everything back.

Requirements

macOS or Linux · Python 3.8+ · bash · git · Homebrew (macOS) or apt/dnf/pacman (Linux)

Contributing

Open source contributions are welcome. Before adding a new tool or feature, open an issue to discuss it — see CONTRIBUTING.md.

Credits

• Setup guide by Guillaume Moigneu at Upsun
• Theme: Catppuccin by the Catppuccin community
• Prompt: Starship
• Terminal: Ghostty by Mitchell Hashimoto
• Editor: NeoVim + LazyVim

License

MIT