Phason

Create meaningful, hilarious, poetic, or professional git commits... from your diffs.

Phason is a local LLM-powered CLI tool that turns your staged git diffs into beautiful commit messages in seconds.

Powered by Ollama running LLaMA 3, works fully offline.
Supports tones like funny, pro, casual, even poetic.
Truncates huge diffs automatically to avoid melting your CPU.

---

Installation

1. Install Ollama

Works on macOS, Windows, Linux. No GPU required (but it's faster with one).

# Download and install Ollama
https://ollama.com/download

2. Pull the model

We recommend [llama3:8b] for best balance of speed and quality:

ollama run llama3:8b

You only need to run this once — it will download and cache the model.

3. Install Phason

npm install -g phason

Or for local dev:

git clone https://github.com/your-username/phason
cd phason
npm install
npm link

---

Usage

Generate a commit message from staged changes:

git add .
phason --tone pro

It will:

• Read your git diff
• Talk to LLaMA 3 running on your machine
• Suggest a commit message
• Ask you if you want to use it

---

Tone Options

Tone	Description
pro	Clean, concise, professional
funny	Sarcastic or witty
casual	Like you're texting your teammate
poetic	Shakespeare meets GitHub

phason --tone funny

---

Large Diff Support

By default, we:

• Truncate diffs to ~6000 characters (safe for most models)
• Remove blank lines and comments
• Only keep meaningful context

Use --full to disable truncation (may break on weaker machines):

phason --full --tone casual

---

Built With

• Ollama + LLaMA 3 (llama3:8b)
• Node.js CLI
• Simple-git (for git magic)
• Humor (because devs deserve joy)

---

Shoutout

This is for devs who are tired of writing:

fix: fixed stuff

Let the AI do it — with style.

---

License

MIT — do whatever you want, just don't make it cringe.

---

Contribute

Pull requests welcome. Or just yell at me on Twitter.