bash-classify 0.1.0__tar.gz → 0.1.1__tar.gz

{bash_classify-0.1.0 → bash_classify-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bash-classify
-Version: 0.1.0
+Version: 0.1.1
 Summary: Classify bash commands as READONLY, WRITE, DANGEROUS, or UNKNOWN
 Project-URL: Homepage, https://github.com/fprochazka/bash-classify
 Project-URL: Repository, https://github.com/fprochazka/bash-classify
@@ -61,35 +61,26 @@ $ echo 'find . -name "*.pyc" -delete' | bash-classify | jq '.classification'
 "DANGEROUS"
 ```
 
-## Claude Code hook
-
-Install as a Claude Code hook to auto-allow read-only commands and require approval for everything else:
-
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.command' | bash-classify",
-            "timeout": 5000,
-            "on_output": [
-              {
-                "matcher": "\"classification\": \"READONLY\"",
-                "action": "approve"
-              }
-            ]
-          }
-        ]
-      }
-    ]
-  }
-}
+## Claude Code plugin
+
+The repo includes a Claude Code plugin that auto-allows readonly bash commands via a `PreToolUse` hook. Install it as a marketplace:
+
+```bash
+# First, install the bash-classify CLI
+uv tool install bash-classify
+
+# Then install the plugin marketplace
+claude plugin add /path/to/bash-classify
+```
+
+Or from GitHub directly:
+
+```bash
+claude plugin add https://github.com/fprochazka/bash-classify
 ```
 
+Once installed, any Bash tool call classified as `READONLY` is auto-approved — no permission prompt. Everything else (WRITE, DANGEROUS, UNKNOWN) still requires confirmation.
+
 ## Command database
 
 The classification database includes 120+ command definitions covering common Unix utilities, package managers, container tools, cloud CLIs, and more.
@@ -142,6 +133,17 @@ uv run pytest
 
 To add or modify command definitions, see [docs/classification-guidance.md](docs/classification-guidance.md). All YAML files in `src/bash_classify/commands/` are validated against a [JSON Schema](schemas/command.schema.json) — your IDE will provide autocomplete if it supports the `# $schema:` comment.
 
+## Releasing
+
+Version is derived automatically from git tags via `hatch-vcs` — no manual version bumping needed.
+
+```bash
+git tag v<version>
+git push origin v<version>
+```
+
+The `publish.yml` GitHub Action builds and publishes to PyPI automatically via trusted publishing.
+
 ## License
 
 [MIT](LICENSE)

{bash_classify-0.1.0 → bash_classify-0.1.1}/README.md

@@ -32,35 +32,26 @@ $ echo 'find . -name "*.pyc" -delete' | bash-classify | jq '.classification'
 "DANGEROUS"
 ```
 
-## Claude Code hook
-
-Install as a Claude Code hook to auto-allow read-only commands and require approval for everything else:
-
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.command' | bash-classify",
-            "timeout": 5000,
-            "on_output": [
-              {
-                "matcher": "\"classification\": \"READONLY\"",
-                "action": "approve"
-              }
-            ]
-          }
-        ]
-      }
-    ]
-  }
-}
+## Claude Code plugin
+
+The repo includes a Claude Code plugin that auto-allows readonly bash commands via a `PreToolUse` hook. Install it as a marketplace:
+
+```bash
+# First, install the bash-classify CLI
+uv tool install bash-classify
+
+# Then install the plugin marketplace
+claude plugin add /path/to/bash-classify
+```
+
+Or from GitHub directly:
+
+```bash
+claude plugin add https://github.com/fprochazka/bash-classify
 ```
 
+Once installed, any Bash tool call classified as `READONLY` is auto-approved — no permission prompt. Everything else (WRITE, DANGEROUS, UNKNOWN) still requires confirmation.
+
 ## Command database
 
 The classification database includes 120+ command definitions covering common Unix utilities, package managers, container tools, cloud CLIs, and more.
@@ -113,6 +104,17 @@ uv run pytest
 
 To add or modify command definitions, see [docs/classification-guidance.md](docs/classification-guidance.md). All YAML files in `src/bash_classify/commands/` are validated against a [JSON Schema](schemas/command.schema.json) — your IDE will provide autocomplete if it supports the `# $schema:` comment.
 
+## Releasing
+
+Version is derived automatically from git tags via `hatch-vcs` — no manual version bumping needed.
+
+```bash
+git tag v<version>
+git push origin v<version>
+```
+
+The `publish.yml` GitHub Action builds and publishes to PyPI automatically via trusted publishing.
+
 ## License
 
 [MIT](LICENSE)

{bash_classify-0.1.0 → bash_classify-0.1.1}/src/bash_classify/cli.py

@@ -95,7 +95,33 @@ def main() -> None:
         1 - parse error (invalid bash syntax)
         2 - internal error
     """
+    if len(sys.argv) > 1 and sys.argv[1] in ("-h", "--help"):
+        print("Usage: bash-classify < command")
+        print("       echo 'ls -la' | bash-classify")
+        print()
+        print("Reads a bash expression from stdin, classifies it, and outputs JSON.")
+        print()
+        print("Exit codes:")
+        print("  0  successfully classified")
+        print("  1  empty input")
+        print("  2  internal error")
+        sys.exit(0)
+
+    if len(sys.argv) > 1 and sys.argv[1] in ("-v", "--version"):
+        from importlib.metadata import version
+
+        print(f"bash-classify {version('bash-classify')}")
+        sys.exit(0)
+
     try:
+        import select
+
+        # Timeout if no data arrives within 5 seconds
+        ready, _, _ = select.select([sys.stdin], [], [], 5.0)
+        if not ready:
+            print("bash-classify: timed out waiting for input on stdin (use --help for usage)", file=sys.stderr)
+            sys.exit(1)
+
         expression = sys.stdin.read().strip()
         if not expression:
             sys.exit(1)