messygit 0.2.0__tar.gz → 0.2.1__tar.gz

messygit-0.2.1/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

messygit-0.2.1/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: messygit
+Version: 0.2.1
+Summary: An AI-powered interactive git CLI with agentic tools for commits, code suggestions, and workflow automation.
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: anthropic>=0.39.0
+Requires-Dist: click>=8.0
+Description-Content-Type: text/markdown
+
+# messygit
+
+**messygit** is an interactive CLI that turns messy git workflows into clean Conventional Commits — stage, commit, push, and get AI-powered project suggestions, all from one interface powered by [Claude](https://www.anthropic.com/api).
+
+## Why use it
+
+- **Interactive REPL** — one command drops you into a persistent session where you can stage, commit, push, and more without leaving.
+- **AI commit messages** — sends your staged diff to Claude and suggests a clean Conventional Commits subject line.
+- **Project suggestions** — an AI agent inspects your repo and recommends concrete next steps.
+- **Safe by default** — only the staged diff is sent to the model. Your API key is never printed in full.
+
+## Requirements
+
+- **Python** 3.10 or newer
+- **Git** (run inside a repository)
+- An **Anthropic API key** with access to the Messages API
+
+## Installation
+
+```bash
+pip install messygit
+```
+
+### Install from source
+
+```bash
+cd messygit
+python -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -e .
+```
+
+## API key
+
+messygit resolves the key in this order:
+
+1. Environment variable **`ANTHROPIC_API_KEY`**
+2. Config file **`~/.messygit/config.json`**
+
+You can set the key from within the messygit interface:
+
+```
+messygit > config YOUR_ANTHROPIC_API_KEY
+```
+
+## Usage
+
+```bash
+messygit
+```
+
+This drops you into the interactive interface:
+
+```
+ mmm    mmm  eeeeeee  sssssss  sssssss  yy   yy  ggggggg  ii  tttttttt
+ mm mm mm m  ee       ss       ss        yy yy   gg       ii     tt
+ mm  mmm  m  eeeee    sssssss  sssssss    yyy    gg  ggg  ii     tt
+ mm       m  ee            ss       ss    yy     gg   gg  ii     tt
+ mm       m  eeeeeee  sssssss  sssssss   yy      ggggg   ii     tt
+
+Type 'help' for commands, 'quit' to exit.
+
+messygit >
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `add <file>` or `add .` | Stage files for commit |
+| `commit` | Generate an AI commit message from staged changes, then commit / cancel / edit |
+| `push` | Push commits to remote |
+| `suggestion` | Get AI-powered next-step suggestions for your project |
+| `config <key>` | Save your Anthropic API key to `~/.messygit/config.json` |
+| `show` | Display a masked API key and its source |
+| `help` | List available commands |
+| `quit` / `exit` | Exit messygit |
+
+### Typical flow
+
+```
+messygit > add .
+Staged everything
+
+messygit > commit
+feat(cli): add interactive REPL with ASCII banner
+Commit with this message? [y/n/e] y
+
+messygit > push
+```
+
+### Commit message style
+
+The model follows **Conventional Commits**: `type(scope): description`
+
+Allowed types: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`. Subjects are one line, imperative, lowercase, no trailing period.
+
+## Publishing to PyPI
+
+This project uses GitHub Actions with [PyPI trusted publishing](https://docs.pypi.org/trusted-publishers/) — no API tokens needed in your repo.
+
+### One-time setup
+
+1. Go to your project on [pypi.org](https://pypi.org/manage/project/messygit/settings/publishing/)
+2. Add a **Trusted Publisher**:
+   - **Owner:** your GitHub username
+   - **Repository:** `messygit`
+   - **Workflow name:** `publish.yml`
+   - **Environment:** leave blank
+
+### To release a new version
+
+1. Bump `version` in `pyproject.toml`
+2. Commit and push
+3. Create a GitHub release:
+
+```bash
+git tag v0.2.0
+git push origin v0.2.0
+```
+
+4. Go to GitHub → Releases → Draft a new release → select the tag → Publish
+
+The workflow at `.github/workflows/publish.yml` will automatically build and upload to PyPI.
+
+### Manual publish (without CI)
+
+```bash
+rm -rf dist/
+python -m build
+twine upload dist/*
+```
+
+## License
+
+MIT (see `pyproject.toml`).

messygit-0.2.1/README.md

@@ -0,0 +1,136 @@
+# messygit
+
+**messygit** is an interactive CLI that turns messy git workflows into clean Conventional Commits — stage, commit, push, and get AI-powered project suggestions, all from one interface powered by [Claude](https://www.anthropic.com/api).
+
+## Why use it
+
+- **Interactive REPL** — one command drops you into a persistent session where you can stage, commit, push, and more without leaving.
+- **AI commit messages** — sends your staged diff to Claude and suggests a clean Conventional Commits subject line.
+- **Project suggestions** — an AI agent inspects your repo and recommends concrete next steps.
+- **Safe by default** — only the staged diff is sent to the model. Your API key is never printed in full.
+
+## Requirements
+
+- **Python** 3.10 or newer
+- **Git** (run inside a repository)
+- An **Anthropic API key** with access to the Messages API
+
+## Installation
+
+```bash
+pip install messygit
+```
+
+### Install from source
+
+```bash
+cd messygit
+python -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -e .
+```
+
+## API key
+
+messygit resolves the key in this order:
+
+1. Environment variable **`ANTHROPIC_API_KEY`**
+2. Config file **`~/.messygit/config.json`**
+
+You can set the key from within the messygit interface:
+
+```
+messygit > config YOUR_ANTHROPIC_API_KEY
+```
+
+## Usage
+
+```bash
+messygit
+```
+
+This drops you into the interactive interface:
+
+```
+ mmm    mmm  eeeeeee  sssssss  sssssss  yy   yy  ggggggg  ii  tttttttt
+ mm mm mm m  ee       ss       ss        yy yy   gg       ii     tt
+ mm  mmm  m  eeeee    sssssss  sssssss    yyy    gg  ggg  ii     tt
+ mm       m  ee            ss       ss    yy     gg   gg  ii     tt
+ mm       m  eeeeeee  sssssss  sssssss   yy      ggggg   ii     tt
+
+Type 'help' for commands, 'quit' to exit.
+
+messygit >
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `add <file>` or `add .` | Stage files for commit |
+| `commit` | Generate an AI commit message from staged changes, then commit / cancel / edit |
+| `push` | Push commits to remote |
+| `suggestion` | Get AI-powered next-step suggestions for your project |
+| `config <key>` | Save your Anthropic API key to `~/.messygit/config.json` |
+| `show` | Display a masked API key and its source |
+| `help` | List available commands |
+| `quit` / `exit` | Exit messygit |
+
+### Typical flow
+
+```
+messygit > add .
+Staged everything
+
+messygit > commit
+feat(cli): add interactive REPL with ASCII banner
+Commit with this message? [y/n/e] y
+
+messygit > push
+```
+
+### Commit message style
+
+The model follows **Conventional Commits**: `type(scope): description`
+
+Allowed types: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`. Subjects are one line, imperative, lowercase, no trailing period.
+
+## Publishing to PyPI
+
+This project uses GitHub Actions with [PyPI trusted publishing](https://docs.pypi.org/trusted-publishers/) — no API tokens needed in your repo.
+
+### One-time setup
+
+1. Go to your project on [pypi.org](https://pypi.org/manage/project/messygit/settings/publishing/)
+2. Add a **Trusted Publisher**:
+   - **Owner:** your GitHub username
+   - **Repository:** `messygit`
+   - **Workflow name:** `publish.yml`
+   - **Environment:** leave blank
+
+### To release a new version
+
+1. Bump `version` in `pyproject.toml`
+2. Commit and push
+3. Create a GitHub release:
+
+```bash
+git tag v0.2.0
+git push origin v0.2.0
+```
+
+4. Go to GitHub → Releases → Draft a new release → select the tag → Publish
+
+The workflow at `.github/workflows/publish.yml` will automatically build and upload to PyPI.
+
+### Manual publish (without CI)
+
+```bash
+rm -rf dist/
+python -m build
+twine upload dist/*
+```
+
+## License
+
+MIT (see `pyproject.toml`).

{messygit-0.2.0/.claude/worktrees/frosty-montalcini-03d71b → messygit-0.2.1}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "messygit"
-version = "0.1.4"
-description = "CLI that drafts Conventional Commits from staged git diffs with Claude, then commit, cancel, or edit."
+version = "0.2.1"
+description = "An AI-powered interactive git CLI with agentic tools for commits, code suggestions, and workflow automation."
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"

messygit-0.2.0/.claude/worktrees/frosty-montalcini-03d71b/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(find /Users/jaydentan/Desktop/projects/messygit -name \"agent.py\" 2>/dev/null)"
-    ]
-  }
-}

messygit-0.2.0/.claude/worktrees/frosty-montalcini-03d71b/.git

@@ -1 +0,0 @@
-gitdir: /Users/jaydentan/Desktop/projects/messygit/.git/worktrees/frosty-montalcini-03d71b

messygit-0.2.0/.claude/worktrees/frosty-montalcini-03d71b/README.md

@@ -1,105 +0,0 @@
-# messygit
-
-**messygit** is a command-line tool that reads your **staged** Git changes, asks **Claude** (via the [Anthropic API](https://www.anthropic.com/api)) to suggest a **Conventional Commits** subject line, and then lets you **commit**, **cancel**, or **edit** the message before running `git commit`.
-
-## Why use it
-
-- Keeps commit subjects consistent (`feat(scope): describe the change`) without thinking up wording from scratch.
-- Only the **staged** diff is sent to the model—what you `git add` is what gets summarized.
-- The API key is never printed in full; `show` uses a masked preview.
-- Clear errors for missing keys, rejected keys, and billing or zero-balance situations.
-
-## Requirements
-
-- **Python** 3.10 or newer  
-- **Git** (run inside a repository)  
-- An **Anthropic API key** with access to the Messages API  
-
-## Installation
-
-```bash
-pip install messygit
-```
-
-This installs the `messygit` command (see `[project.scripts]` in `pyproject.toml`).
-
-### Install from source
-
-From a checkout of this project:
-
-```bash
-cd messygit
-python -m venv .venv
-source .venv/bin/activate   # Windows: .venv\Scripts\activate
-pip install -e .
-```
-
-## API key
-
-messygit resolves the key in this order:
-
-1. Environment variable **`ANTHROPIC_API_KEY`**
-2. Config file **`~/.messygit/config.json`** (written by `messygit config`)
-
-If neither is set, the default command exits with a short message explaining how to fix it.
-
-**Save a key to the config file:**
-
-```bash
-messygit config --key YOUR_ANTHROPIC_API_KEY
-```
-
-**Show a masked key** (which source is active, without revealing the secret):
-
-```bash
-messygit show
-```
-
-## Usage
-
-Typical flow:
-
-```bash
-git add .
-messygit
-```
-
-1. If there is nothing staged, messygit tells you to run `git add` first.  
-2. Otherwise it sends the staged diff to Claude and prints a suggested one-line message.  
-3. You are prompted: **commit** (default), **no** (cancel), or **edit** (open `$EDITOR` to change the message).  
-4. On confirmation, it runs `git commit -m "..."` with your chosen text.
-
-### Commands
-
-| Command | Description |
-|--------|-------------|
-| `messygit` | Generate a message from `git diff --staged`, then prompt to commit / cancel / edit. |
-| `messygit config --key KEY` | Store the Anthropic API key under `~/.messygit/config.json`. |
-| `messygit show` | Print a masked API key and whether it comes from the environment or config file. |
-
-### Commit message style
-
-The model is instructed to follow **Conventional Commits**, for example:
-
-`feat(auth): validate refresh tokens`
-
-Allowed types include: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`. Subjects are one line, imperative, lowercase, no trailing period, and kept within a reasonable length (see your prompts in the package if you customize behavior).
-
-## Development
-
-Without installing the package, from the **repository root** (the directory that contains the `messygit` package folder):
-
-```bash
-.venv/bin/python -m messygit.cli
-```
-
-Subcommands:
-
-```bash
-python -m messygit.cli config --key YOUR_KEY
-python -m messygit.cli show
-```
-
-## License
-
-MIT (see `pyproject.toml`).

messygit-0.2.0/.claude/worktrees/frosty-montalcini-03d71b/messygit/cli.py

@@ -1,112 +0,0 @@
-import os
-
-import click
-
-from .config import (
-    ANTHROPIC_ENV_VAR,
-    CONFIG_FILE,
-    AnthropicInsufficientBalanceError,
-    InvalidAnthropicCredentialsError,
-    MissingApiKeyError,
-    load_api_key,
-    mask_api_key,
-    save_api_key,
-)
-from .git import get_staged_diff, git_commit
-from .llm import generate_commit_message
-
-def _prompt_commit_action(message: str) -> None:
-    """Ask [Y/n/e]: commit, cancel, or edit in $EDITOR."""
-    current = message
-    while True:
-        click.echo(current)
-        choice = click.prompt(
-            "Commit with this message? [y/n/e]",
-            default="Y",
-            show_default=False,
-        ).strip().lower()
-
-        if choice in ("", "y", "yes"):
-            result = git_commit(current)
-            if result.stdout:
-                click.echo(result.stdout, nl=False)
-            if result.stderr:
-                click.echo(result.stderr, nl=False, err=True)
-            if result.returncode != 0:
-                raise click.ClickException("git commit failed.")
-            return
-
-        if choice in ("n", "no"):
-            click.echo("Commit cancelled.")
-            return
-
-        if choice in ("e", "edit"):
-            edited = click.edit(current)
-            if edited is None:
-                click.echo("Editor exited without saving; message unchanged.")
-                continue
-            stripped = edited.strip()
-            if not stripped:
-                click.echo("Empty message ignored; message unchanged.")
-                continue
-            current = stripped
-            continue
-
-        click.echo("Please answer y (yes), n (no), or e (edit).")
-
-@click.group(invoke_without_command=True)
-@click.pass_context
-def main(ctx):
-    """Messy Git is a tool that analyzes your updated code and generates clean commit messages. Let's keep your "messy" messages in check!"""
-    if ctx.invoked_subcommand is None:
-        diff = get_staged_diff()
-        if not diff.strip():
-            raise click.ClickException(
-                "No staged changes found. Run 'git add' first."
-            )
-        try:
-            message = generate_commit_message(diff)
-        except MissingApiKeyError as e:
-            raise click.ClickException(str(e)) from e
-        except InvalidAnthropicCredentialsError as e:
-            raise click.ClickException(str(e)) from e
-        except AnthropicInsufficientBalanceError as e:
-            raise click.ClickException(str(e)) from e
-        _prompt_commit_action(message)
-
-@main.command("config")
-@click.option("--key", type=str, required=True, help="Anthropic API key")
-def config_cmd(key):
-    """Configure your Anthropic API key."""
-    try:
-        save_api_key(key)
-    except ValueError as e:
-        raise click.ClickException(str(e)) from e
-    click.echo(f"API key saved successfully ({mask_api_key(key.strip())})")
-
-@main.command("show")
-def show():
-    """Display masked API key (env takes precedence over config file)."""
-    env_set = ANTHROPIC_ENV_VAR in os.environ
-    env_key = (os.environ.get(ANTHROPIC_ENV_VAR) or "").strip()
-    if env_key:
-        click.echo(f"API key: {mask_api_key(env_key)} (from ANTHROPIC_API_KEY)")
-        return
-    file_key = load_api_key()
-    if file_key:
-        if env_set:
-            click.echo(
-                f"{ANTHROPIC_ENV_VAR} is set but empty; showing key from {CONFIG_FILE}."
-            )
-        click.echo(f"API key: {mask_api_key(file_key)} (from {CONFIG_FILE})")
-        return
-    if env_set:
-        click.echo(
-            f"{ANTHROPIC_ENV_VAR} is set but empty or whitespace-only, and no usable key "
-            f"is stored in {CONFIG_FILE}. Unset the variable or run messygit config --key."
-        )
-        return
-    click.echo("No API key found. Set ANTHROPIC_API_KEY or run messygit config --key.")
-
-if __name__ == "__main__":
-    main()