claude-launcher 0.1.0__py3-none-any.whl

claude_launcher/utils/logging.py

@@ -0,0 +1,79 @@
+"""Logging configuration for claude-launcher."""
+
+import logging
+import sys
+from pathlib import Path
+from typing import Optional
+
+from platformdirs import user_log_path
+
+
+def setup_logging(
+    level: str = "INFO",
+    log_file: Optional[Path] = None,
+    verbose: bool = False,
+) -> logging.Logger:
+    """Configure logging for claude-launcher.
+
+    Args:
+        level: Logging level (DEBUG, INFO, WARNING, ERROR)
+        log_file: Optional path to log file
+        verbose: If True, set level to DEBUG
+
+    Returns:
+        Configured logger instance
+    """
+    # Create logger
+    logger = logging.getLogger("claude_launcher")
+
+    # Set level
+    if verbose:
+        logger.setLevel(logging.DEBUG)
+    else:
+        logger.setLevel(getattr(logging, level.upper(), logging.INFO))
+
+    # Clear existing handlers
+    logger.handlers.clear()
+
+    # Console handler (stderr)
+    console_handler = logging.StreamHandler(sys.stderr)
+    console_handler.setLevel(logging.WARNING)  # Only warnings and errors to console
+    console_formatter = logging.Formatter("%(levelname)s: %(message)s")
+    console_handler.setFormatter(console_formatter)
+    logger.addHandler(console_handler)
+
+    # File handler (if log file specified or in debug mode)
+    if log_file or verbose:
+        if log_file is None:
+            log_dir = user_log_path("claude-launcher")
+            log_dir.mkdir(parents=True, exist_ok=True)
+            log_file = log_dir / "claude-launcher.log"
+
+        file_handler = logging.FileHandler(log_file)
+        file_handler.setLevel(logging.DEBUG)
+        file_formatter = logging.Formatter(
+            "%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+            datefmt="%Y-%m-%d %H:%M:%S",
+        )
+        file_handler.setFormatter(file_formatter)
+        logger.addHandler(file_handler)
+
+        if verbose:
+            logger.info(f"Logging to file: {log_file}")
+
+    # Don't propagate to root logger
+    logger.propagate = False
+
+    return logger
+
+
+def get_logger(name: str = "claude_launcher") -> logging.Logger:
+    """Get logger instance.
+
+    Args:
+        name: Logger name (default: claude_launcher)
+
+    Returns:
+        Logger instance
+    """
+    return logging.getLogger(name)

claude_launcher/utils/paths.py

@@ -0,0 +1,61 @@
+"""Path utilities for claude-launcher."""
+
+import os
+from pathlib import Path
+
+
+def expand_path(path_str: str) -> Path:
+    """Expand path with ~ and environment variables.
+
+    Args:
+        path_str: Path string to expand
+
+    Returns:
+        Expanded Path object
+
+    Examples:
+        >>> expand_path("~/projects")
+        Path('/home/user/projects')
+
+        >>> expand_path("$HOME/work")
+        Path('/home/user/work')
+    """
+    # Expand environment variables
+    expanded = os.path.expandvars(path_str)
+    # Expand ~ to home directory
+    return Path(expanded).expanduser().resolve()
+
+
+def validate_directory(path: Path) -> bool:
+    """Check if a path exists and is a directory.
+
+    Args:
+        path: Path to validate
+
+    Returns:
+        True if path exists and is a directory, False otherwise
+    """
+    return path.exists() and path.is_dir()
+
+
+def get_relative_path(path: Path, base: Path) -> Path:
+    """Get relative path from base, or return path if not relative.
+
+    Args:
+        path: Path to make relative
+        base: Base path
+
+    Returns:
+        Relative path if possible, otherwise original path
+
+    Examples:
+        >>> get_relative_path(Path("/home/user/projects/foo"), Path("/home/user"))
+        Path('projects/foo')
+
+        >>> get_relative_path(Path("/other/path"), Path("/home/user"))
+        Path('/other/path')
+    """
+    try:
+        return path.relative_to(base)
+    except ValueError:
+        return path

claude_launcher-0.1.0.dist-info/METADATA

@@ -0,0 +1,332 @@
+Metadata-Version: 2.4
+Name: claude-launcher
+Version: 0.1.0
+Summary: Fast context switching for Claude Code in multi-project environments
+Author: Solent Labs™
+License: MIT
+Project-URL: Homepage, https://github.com/solentlabs/claude-launcher
+Project-URL: Repository, https://github.com/solentlabs/claude-launcher
+Project-URL: Issues, https://github.com/solentlabs/claude-launcher/issues
+Keywords: claude,launcher,project-switcher,productivity,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: iterfzf>=1.4.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: tomli>=2.0.0; python_version < "3.11"
+Requires-Dist: tomli-w>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Dynamic: license-file
+
+# Claude Launcher
+
+Fast context switching for Claude Code in multi-project environments.
+
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> **Community Project** - This is an independent tool built by the community, not affiliated with Anthropic.
+
+## Overview
+
+Claude Launcher is a productivity tool for developers working with multiple Claude Code projects. It provides fast project discovery, tree-structured navigation, and intelligent context switching with an interactive fuzzy-search interface powered by fzf.
+
+## Features
+
+- 🔍 **Auto-discovery** - Automatically finds git repositories in configured directories
+- 📋 **Alphabetical organization** - Projects sorted by path for easy navigation
+- ⚡ **Smart defaults** - Cursor starts on your last opened project
+- 🔎 **Fuzzy search** - Interactive project selection powered by fzf
+- 📄 **Rich previews** - Shows CLAUDE.md, git status, and directory contents
+- 🎯 **Manual paths** - Add non-git projects manually
+- 🔄 **Git clone integration** - Clone and launch repositories directly
+- 🛡️ **Error recovery** - Automatic database corruption recovery
+- 🖥️ **Cross-platform** - Works on Linux, macOS, and Windows
+
+## Installation
+
+### From PyPI (Recommended)
+```bash
+pip install claude-launcher
+```
+
+### From Source (Development)
+```bash
+git clone https://github.com/solentlabs/claude-launcher.git
+cd claude-launcher
+pip install -e .
+```
+
+### With Development Dependencies
+```bash
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+### Initial Setup
+Run the first-time setup wizard to configure scan directories:
+
+```bash
+claude-launcher --setup
+```
+
+You'll be prompted to enter directories to scan for projects (e.g., `~/projects`, `~/work`).
+
+### Basic Usage
+
+```bash
+# Launch interactive project selector
+claude-launcher
+
+# Jump directly to last opened project
+claude-launcher --recent
+
+# List all discovered projects
+claude-launcher --list
+```
+
+### Managing Projects
+
+```bash
+# Add a manual project path
+claude-launcher --add
+
+# Remove a manual path
+claude-launcher --remove
+
+# Clone a git repository
+claude-launcher --clone
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `claude-launcher` | Launch interactive project selector |
+| `claude-launcher --setup` | Run first-time setup or reconfigure |
+| `claude-launcher --add` | Add a manual project path via directory browser |
+| `claude-launcher --remove` | Remove a manual path |
+| `claude-launcher --list` | List all discovered projects |
+| `claude-launcher --recent` | Jump to last opened project |
+| `claude-launcher --clone` | Clone a git repository |
+
+## Configuration
+
+Configuration files are stored in platform-specific locations:
+
+- **Linux/WSL:** `~/.config/claude-launcher/config.toml`
+- **macOS:** `~/Library/Application Support/claude-launcher/config.toml`
+- **Windows:** `%LOCALAPPDATA%\claude-launcher\config.toml`
+
+### Configuration Options
+
+```toml
+[scan]
+# Directories to scan for git repositories
+paths = [
+    "~/projects",
+    "~/work",
+    "/mnt/c/Users/username/dev",  # WSL example
+]
+
+# Maximum directory depth to scan
+max_depth = 5
+
+# Directories to skip during scanning
+prune_dirs = [
+    "node_modules",
+    ".cache",
+    "venv",
+    "__pycache__",
+    ".git",
+]
+
+[ui]
+# Preview pane width (characters)
+preview_width = 70
+
+# Show git status in preview
+show_git_status = true
+
+[history]
+# Maximum access history entries to keep
+max_entries = 50
+```
+
+### Path Expansion
+
+Paths in configuration support:
+- Tilde expansion: `~/projects` → `/home/user/projects`
+- Environment variables: `$HOME/projects` → `/home/user/projects`
+
+## Data Storage
+
+Project data (manual paths, history) is stored in SQLite:
+
+- **Linux/WSL:** `~/.local/share/claude-launcher/projects.db`
+- **macOS:** `~/Library/Application Support/claude-launcher/projects.db`
+- **Windows:** `%LOCALAPPDATA%\claude-launcher\projects.db`
+
+## How It Works
+
+1. **Discovery**: Scans configured directories for `.git` folders
+2. **Manual Paths**: Combines discovered repos with manually added paths
+3. **Sorting**: Sorts all projects alphabetically by path
+4. **Selection**: Shows fuzzy-searchable list with preview pane
+5. **Default Cursor**: Positions cursor on last opened project
+6. **Launch**: Changes to selected directory and executes `claude` command
+7. **Tracking**: Records selection for next session
+
+## Preview Pane
+
+The preview pane shows:
+
+1. **CLAUDE.md** (first 20 lines) - Project-specific Claude Code instructions
+2. **Git Status** - Current working tree status (if git repo)
+3. **Directory Listing** - Top-level files and folders
+
+## Windows Terminal Integration
+
+Add to your Windows Terminal `settings.json`:
+
+```json
+{
+    "name": "Claude Launcher",
+    "commandline": "wsl.exe -d Ubuntu -- bash -lic claude-launcher",
+    "icon": "📂"
+}
+```
+
+## Error Handling
+
+Claude Launcher includes robust error recovery:
+
+- **Database corruption**: Automatically backs up and recreates
+- **Missing manual paths**: Auto-removes from database
+- **Invalid config**: Falls back to sensible defaults
+- **Git failures**: Gracefully degrades (shows project without status)
+- **Permission errors**: Logs and continues scanning
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=claude_launcher --cov-report=term-missing
+
+# Run specific test file
+pytest tests/test_discovery.py
+
+# Run with verbose output
+pytest -v
+```
+
+### Code Quality
+
+```bash
+# Format code
+black src/ tests/
+
+# Type checking
+mypy src/
+
+# Lint
+flake8 src/ tests/
+```
+
+### Project Structure
+
+```
+claude-workflow/
+├── src/claude_launcher/
+│   ├── core/           # Core functionality
+│   │   ├── models.py   # Data models
+│   │   ├── config.py   # Configuration management
+│   │   ├── discovery.py # Project discovery
+│   │   └── storage.py  # SQLite storage
+│   ├── ui/             # User interface
+│   │   ├── selector.py # Main TUI
+│   │   ├── preview.py  # Preview generation
+│   │   └── browser.py  # Directory browser
+│   ├── utils/          # Utilities
+│   │   └── git.py      # Git operations
+│   └── cli.py          # CLI entry point
+└── tests/              # Test suite
+```
+
+## Requirements
+
+- **Python**: 3.8 or higher
+- **fzf**: Interactive fuzzy finder ([installation guide](https://github.com/junegunn/fzf#installation))
+  - Ubuntu/Debian: `sudo apt install fzf`
+  - macOS: `brew install fzf`
+  - Windows: `choco install fzf`
+- **Git**: For repository discovery and status
+- **Claude Code CLI**: Must be installed and in PATH
+
+## Troubleshooting
+
+### "claude command not found"
+Ensure Claude Code CLI is installed and accessible in your PATH.
+
+### No projects found
+1. Run `claude-launcher --setup` to configure scan paths
+2. Verify paths exist and contain git repositories
+3. Check permissions on directories
+
+### Database errors
+The database auto-recovers from corruption. Check for `.db.backup.*` files if you need to restore data.
+
+### Permission denied during scan
+Some directories may not be readable. These are automatically skipped with a warning.
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new functionality
+4. Ensure all tests pass
+5. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Changelog
+
+### 0.1.0 (Initial Release)
+- Project discovery with git repository scanning
+- Alphabetical sorting with last-opened default
+- Interactive fuzzy search with preview pane
+- Manual path management
+- Git clone integration
+- Error recovery
+- Cross-platform support

claude_launcher-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+claude_launcher/__init__.py,sha256=Mx2xmzSCBzceFDYJn38FjVmROwuwGk-L0eqBt0JXbNA,96
+claude_launcher/__main__.py,sha256=f3pKnCN2ClMQp04jcxA2CJsbLB5i9x02Ay393rqR6G4,124
+claude_launcher/cli.py,sha256=NvZfl43h_YlYTEUPKySfq1_63lDnbKHeKpKauQf2nbY,6171
+claude_launcher/core/__init__.py,sha256=blrH7IxttUY1lNfB1ODWfQi-JGOXzGZgtstLVWzaTe0,46
+claude_launcher/core/config.py,sha256=_8P46YZOshbfztCbOcUHZ_1y2WlNJl-ymg4DhmIpH3g,7295
+claude_launcher/core/discovery.py,sha256=kconwnfBD0-6G1_QDAfdlX120DOO4iorT0Hgnqj5bHI,2882
+claude_launcher/core/models.py,sha256=HcUVExgO0BOU7ZW1MXIEkpPfH_GVvSdOaehJ_s_eROY,3251
+claude_launcher/core/storage.py,sha256=kEWYH64Wgq7S0_x4OlE-bmzZMPegcPecO6RUxlru13I,7172
+claude_launcher/ui/__init__.py,sha256=ldsGr4N1T3u_S6h1yp0henOvStzyx6nV6hla7assi4M,53
+claude_launcher/ui/_preview_helper.py,sha256=AU87OodttgRrM5NHYaKx7v6LHVDz6XGyHpRST1eWgKg,2179
+claude_launcher/ui/browser.py,sha256=2U4lkeB99Md637KHmUT_pnGfEOpsLwBonqmjCjHTIpU,5624
+claude_launcher/ui/preview.py,sha256=S5DAcrlCR11TazftVu3QYbTdcULXn2Mhk8epoqBPAdM,8966
+claude_launcher/ui/selector.py,sha256=4n1lzakNaZzRtC6GdSeQVvDDSA6rycDPjBqUi0eylmc,10293
+claude_launcher/utils/__init__.py,sha256=6cemx9bytMG4GZrbEtxhqwzhIaLMRGlRkj90PCOrH4k,45
+claude_launcher/utils/git.py,sha256=mry84cLf07qBWdNmeeTA5J4XSMrz0J7--arpI4mVSOw,4102
+claude_launcher/utils/logging.py,sha256=0v9qR3Iln3l4K72LBEdZC6Xzd4L5Qp_zEwQ62QOv9Dg,2218
+claude_launcher/utils/paths.py,sha256=rbREoVCAbGV9-YaSiZg2I0ExmsOnWbjnDKwSd933g9s,1457
+claude_launcher-0.1.0.dist-info/licenses/LICENSE,sha256=3EyvXvCOXv-KdxLeyLGTwf0_q1buihHRW4Y02himIjk,1085
+claude_launcher-0.1.0.dist-info/METADATA,sha256=LCNJVAZhOq-g5ABfxwIjbeabpP8eiGOB2SRP1GC-sNE,9527
+claude_launcher-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+claude_launcher-0.1.0.dist-info/entry_points.txt,sha256=9D2wFyj4LPXZmEdIb2V-8GZanXTTNfuhcadIHGuX8iU,60
+claude_launcher-0.1.0.dist-info/top_level.txt,sha256=lcBURRPJ6SvXsbBBnO2DmobA3hCFcSMQz9IVqg4gDr0,16
+claude_launcher-0.1.0.dist-info/RECORD,,

claude_launcher-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

claude_launcher-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+claude-launcher = claude_launcher.cli:app

claude_launcher-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Claude Launcher Contributors
+
+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.

claude_launcher-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+claude_launcher