git-hook-max 0.1.0__tar.gz

git_hook_max-0.1.0/BRIEF.md

@@ -0,0 +1,66 @@
+# portman — localhost port management CLI
+
+## One-liner
+A zero-dependency CLI that finds and kills processes on localhost ports — no more `lsof -i :3000` → `kill -9` → repeat.
+
+## Target user
+Full-stack developers, DevOps engineers, and anyone who runs local servers (React, Node, Python, Docker, etc.) and constantly hits "EADDRINUSE" / "port already in use" errors.
+
+## Problem
+Every developer wastes minutes per day dealing with stale processes holding ports:
+- "Port 3000 is already in use" — what's using it?
+- Forgot to Ctrl+C a dev server yesterday
+- Docker containers left running
+- Zombie Node/Python processes
+
+Current workflow: `lsof -i :3000` → copy PID → `kill -9 12345` → hope you killed the right thing.
+On Windows: `netstat -ano | findstr :3000` → `taskkill /PID 12345 /F` — even worse.
+
+No dedicated, polished CLI tool exists. Developers cobble together shell aliases.
+
+## Why now
+- AI coding agents (Claude Code, Codex, Cursor) spin up servers automatically and leave them running
+- Microservice development means more concurrent local servers than ever
+- The rise of `pnpm dev`, `next dev`, `vite`, `turbo dev` — more dev servers, more conflicts
+
+## MVP scope (buildable in <1 hour, zero paid deps)
+
+1. `portman list` — show all listening ports with process names and PIDs (cross-platform)
+2. `portman kill <port>` — find and kill the process on a given port, with confirmation
+3. `portman kill --all` — kill all known dev server ports (3000, 3001, 5000, 8000, 8080, etc.)
+4. `portman find <port>` — show what's using a port without killing it
+5. `portman free <port>` — check if a port is available
+6. `portman config` — manage a `~/.portmanrc` with custom port presets and ignore lists
+
+## Tech approach
+- **Language**: Python 3.11+ (stdlib only for core; `psutil` as optional pip dep for better cross-platform support)
+- **Cross-platform**: macOS, Linux, Windows (WSL native)
+- **No API keys, no cloud, no accounts** — runs entirely locally
+- **Install**: `pip install portman-cli` or `brew install portman`
+- **Entry point**: `portman` CLI via `pyproject.toml` scripts
+
+## Monetization
+- **Free tier**: All core commands (list, kill, find, free, config)
+- **Pro tier** ($5/mo or $48/yr):
+  - `portman team` — shared port registry so teammates don't collide on the same ports
+  - `portman ci` — GitHub Actions integration that detects port conflicts in PRs
+  - `portman watch` — background daemon that auto-kills stale processes after N minutes of inactivity
+  - `portman history` — track which projects use which ports over time
+- **Distribution**: npm (`npx portman`), pip, brew, standalone binary (PyInstaller)
+
+## Risks
+1. **Too simple** — might be seen as "just a shell alias." Mitigation: polish the UX (colors, tables, confirmation prompts, `--json` output) so it feels like a real tool.
+2. **Platform differences** — `lsof` vs `netstat` vs `Get-NetTCPConnection`. Mitigation: use `psutil` as the abstraction layer.
+3. **Existing alternatives** — `fkill`, `kill-port` (npm), shell aliases. Mitigation: portman is purpose-built for localhost dev ports with a better UX and team features.
+4. **Low willingness to pay** — developers expect CLI tools to be free. Mitigation: the free tier is fully functional; team/CI features are the paid upsell.
+
+## Definition of done for the MVP
+- [ ] `portman list` works on macOS, Linux, and Windows
+- [ ] `portman kill <port>` finds and kills the process with a confirmation prompt
+- [ ] `portman find <port>` shows process info without killing
+- [ ] `portman free <port>` returns exit code 0 (free) or 1 (in use)
+- [ ] `~/.portmanrc` config file with custom presets
+- [ ] `--json` flag on all commands for scripting
+- [ ] `pyproject.toml` with proper entry point
+- [ ] `pip install -e .` works locally
+- [ ] README with install instructions and examples

git_hook_max-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Eric Joye
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

git_hook_max-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: git-hook-max
+Version: 0.1.0
+Summary: Manage Git hooks across projects with a visual dashboard
+Project-URL: Homepage, https://github.com/ericjoye/git-hook-manager-max
+Project-URL: Issues, https://github.com/ericjoye/git-hook-manager-max/issues
+Author-email: Eric JOYE <eric@ericjoye.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,developer-tools,git,hooks,pre-commit,pre-push
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# git-hook-manager-max
+
+A visual Git hook manager CLI. Create, edit, and manage git hooks without manual shell scripting.
+
+## Install
+
+```bash
+pip install git-hook-manager-max
+```
+
+## Usage
+
+```bash
+ghm list              # List all hooks
+ghm create pre-commit # Create a hook from template
+ghm edit pre-commit   # Edit a hook
+ghm toggle pre-commit # Enable/disable a hook
+ghm templates         # List available templates
+ghm init              # Initialize hooks directory
+```
+
+## Requirements
+
+Python 3.11+, stdlib only.

git_hook_max-0.1.0/PRIVACY.md

@@ -0,0 +1,34 @@
+# Privacy Policy — git-hook-manager-max
+
+**Last updated:** June 20, 2026
+
+## Overview
+
+git-hook-manager-max ("we", "our", "the tool") is a command-line utility that helps developers manage Git hooks across projects. It installs, configures, and shares Git hook scripts.
+
+## Data Collection
+
+**git-hook-manager-max does NOT collect, store, or transmit any data.**
+
+When you use git-hook-manager-max:
+
+- **No data is logged or transmitted.** All operations happen locally on your machine. The tool does not send data to any external server.
+- **No network calls.** git-hook-manager-max does not make any network requests. It operates entirely offline.
+- **No telemetry.** There is no usage tracking, analytics, or telemetry of any kind.
+- **No accounts.** There is no signup, login, or user account system.
+
+## How It Works
+
+git-hook-manager-max reads and writes Git hook scripts in your project's `.git/hooks` directory (or a shared hooks directory you configure). It may also read from a configuration file (e.g., `.githookrc`) in your project or home directory. All file operations are local — your hook scripts and repository data never leave your machine.
+
+## Open Source
+
+git-hook-manager-max is open source under the MIT license. It has zero runtime dependencies — it uses only Python 3.11+ standard library modules.
+
+## Changes to This Policy
+
+We may update this privacy policy from time to time. Any changes will be reflected in the project's source code repository.
+
+## Contact
+
+If you have questions about this privacy policy, contact us at: [YOUR EMAIL ADDRESS]

git_hook_max-0.1.0/README.md

@@ -0,0 +1,24 @@
+# git-hook-manager-max
+
+A visual Git hook manager CLI. Create, edit, and manage git hooks without manual shell scripting.
+
+## Install
+
+```bash
+pip install git-hook-manager-max
+```
+
+## Usage
+
+```bash
+ghm list              # List all hooks
+ghm create pre-commit # Create a hook from template
+ghm edit pre-commit   # Edit a hook
+ghm toggle pre-commit # Enable/disable a hook
+ghm templates         # List available templates
+ghm init              # Initialize hooks directory
+```
+
+## Requirements
+
+Python 3.11+, stdlib only.