Metadata-Version: 2.4
Name: cosyterm
Version: 0.3.1
Summary: Your terminal, but make it cozy. One command to install a curated, Catppuccin-themed dev setup — Ghostty, Starship, eza, tmux, NeoVim, and more.
License: MIT
License-File: LICENSE
Keywords: terminal,shell,dotfiles,catppuccin,starship,ghostty,neovim,tmux,developer-tools,cli
Author: Joshua Harris
Author-email: joshymole@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Shells
Classifier: Topic :: Utilities
Project-URL: Homepage, https://github.com/JoshuaHarris391/cosyterm
Project-URL: Issues, https://github.com/JoshuaHarris391/cosyterm/issues
Project-URL: Repository, https://github.com/JoshuaHarris391/cosyterm
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/palette/macchiato.png" width="600" />
</p>

<h1 align="center">cosyTerm</h1>

<p align="center">
  <strong>Your whole terminal stack, themed in one command.</strong><br/>
  <sub>Ghostty, your shell, Starship, eza, tmux, NeoVim — all Catppuccin Mocha, fully reversible.</sub>
</p>

<p align="center">
  <a href="https://pypi.org/project/cosyterm/"><img src="https://img.shields.io/pypi/v/cosyterm?color=cba6f7&style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
  <a href="https://github.com/JoshuaHarris391/cosyterm/actions"><img src="https://img.shields.io/github/actions/workflow/status/JoshuaHarris391/cosyterm/ci.yml?style=for-the-badge&logo=github&logoColor=white&color=a6e3a1" alt="CI"></a>
  <a href="LICENSE"><img src="https://img.shields.io/github/license/JoshuaHarris391/cosyterm?style=for-the-badge&color=89b4fa" alt="License"></a>
  <a href="#"><img src="https://img.shields.io/badge/macOS_%7C_Linux-supported-f5c2e7?style=for-the-badge&logo=apple&logoColor=white" alt="Platform"></a>
</p>

<p align="center">
  <img src="assets/img/screenshot.png" width="800" alt="cosyTerm screenshot" />
</p>

---

## Install

```bash
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](https://www.nerdfonts.com/)** | 10 patched fonts — JetBrains Mono, Commit Mono, Cascadia Code, and more |
| **[Ghostty](https://ghostty.org)** | GPU-accelerated terminal emulator by Mitchell Hashimoto |
| **[Fish](https://fishshell.com/) or [Zsh](https://www.zsh.org/)** | Fish (recommended) or Zsh (POSIX-compatible) |
| **[Starship](https://starship.rs)** | Cross-shell prompt — git, language versions, right-aligned and clean |
| **[eza](https://eza.rocks)** | `ls` with icons, colors, git status, and tree views |
| **[tmux](https://github.com/tmux/tmux)** | Terminal multiplexer with pastel status bar at top |
| **[NeoVim](https://neovim.io) + [LazyVim](https://lazyvim.github.io)** | IDE-grade editor, pre-configured, zero setup |

## Docs

- **[Safety model](docs/safety.md)** — every command that runs, every URL fetched, every `sudo` — plus backups and blast-radius guarantees.
- **[Recovery](docs/recovery.md)** — `cosyterm doctor`, `cosyterm restore`, and the `--dry-run` preview.
- **[Automation](docs/automation.md)** — scripted installs (`COSYTERM_YES=1`, `COSYTERM_NVIM_CHOICE`), re-running a single step, and the Python API.
- **[Design philosophy](docs/philosophy.md)** — 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](CONTRIBUTING.md).

## Credits

- Setup guide by **[Guillaume Moigneu](https://devcenter.upsun.com/posts/my-terminal-setup-mac-linux/)** at Upsun
- Theme: **[Catppuccin](https://catppuccin.com)** by the Catppuccin community
- Prompt: **[Starship](https://starship.rs)**
- Terminal: **[Ghostty](https://ghostty.org)** by Mitchell Hashimoto
- Editor: **[NeoVim](https://neovim.io)** + **[LazyVim](https://lazyvim.github.io)**

## License

[MIT](LICENSE)

