unused_code: handle git grep no-matches and untracked

.gitignore

@@ -159,3 +159,11 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 .idea/
+
+# AI
+.cursor/
+CLAUDE.md
+.agent-os/
+.cursorrules
+.claude/
+GEMINI.md

apps/jira_utils/jira_information.py

@@ -151,6 +151,7 @@ def process_jira_command_line_config_file(
     config_dict = get_util_config(util_name="pyutils-jira", config_file_path=config_file_path)
     url = url or config_dict.get("url", "")
     token = token or config_dict.get("token", "")
+
     if not (url and token):
         LOGGER.error("Jira url and token are required.")
         sys.exit(1)

apps/unused_code/README.md

@@ -4,11 +4,42 @@ Helper to identify unused code in a pytest repository. It should be run from ins
 
 ## Usage
 
+### Basic Usage
+
 ```bash
+# Analyze all Python files in the current directory (must be a git repository)
 pyutils-unusedcode
+
+# Show help with all available options
 pyutils-unusedcode --help
 ```
 
+### Analyze Specific Files or Directories
+
+```bash
+# Analyze a single Python file
+pyutils-unusedcode --file-path /path/to/your/file.py
+pyutils-unusedcode -f /path/to/your/file.py
+
+# Analyze all Python files in a specific directory recursively
+pyutils-unusedcode --directory /path/to/your/project
+pyutils-unusedcode -d /path/to/your/project
+```
+
+**Note:** When using `--file-path` or `--directory`, the tool will analyze files from any git repository, not just the current working directory.
+
+## Command-Line Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--file-path` | `-f` | Analyze a single Python file for unused functions. Must be an existing .py file. |
+| `--directory` | `-d` | Analyze all Python files in a directory recursively for unused functions. Must be an existing directory. |
+| `--exclude-files` | | Comma-separated list of files to exclude from analysis. |
+| `--exclude-function-prefixes` | | Comma-separated list of function prefixes to exclude from analysis. |
+| `--config-file-path` | | Path to custom config file (default: `~/.config/python-utility-scripts/config.yaml`). |
+| `--verbose` | `-v` | Enable verbose logging for debugging. |
+| `--help` | | Show help message with all available options. |
+
 ## Config file
 
 To skip unused code check on specific files or functions of a repository, a config file with the list of names of such files and function prefixes should be added to