fips-agents-cli 0.1.0__py3-none-any.whl

fips_agents_cli/__init__.py

@@ -0,0 +1,5 @@
+"""FIPS Agents CLI - A tool for creating and managing FIPS-compliant AI agent projects."""
+
+from fips_agents_cli.version import __version__
+
+__all__ = ["__version__"]

fips_agents_cli/__main__.py

@@ -0,0 +1,6 @@
+"""Allow execution via python -m fips_agents_cli."""
+
+from fips_agents_cli.cli import main
+
+if __name__ == "__main__":
+    main()

fips_agents_cli/cli.py

@@ -0,0 +1,34 @@
+"""Main CLI entry point for fips-agents-cli."""
+
+import click
+from rich.console import Console
+
+from fips_agents_cli.commands.create import create
+from fips_agents_cli.version import __version__
+
+console = Console()
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="fips-agents")
+@click.pass_context
+def cli(ctx):
+    """
+    FIPS Agents CLI - A tool for creating and managing FIPS-compliant AI agent projects.
+
+    Use 'fips-agents COMMAND --help' for more information on a specific command.
+    """
+    ctx.ensure_object(dict)
+
+
+# Register commands
+cli.add_command(create)
+
+
+def main():
+    """Main entry point for the CLI application."""
+    cli(obj={})
+
+
+if __name__ == "__main__":
+    main()

fips_agents_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI commands for fips-agents-cli."""

fips_agents_cli/commands/create.py

@@ -0,0 +1,182 @@
+"""Create command for generating new projects from templates."""
+
+import sys
+from typing import Optional
+
+import click
+from rich.console import Console
+from rich.panel import Panel
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from fips_agents_cli.tools.filesystem import resolve_target_path, validate_target_directory
+from fips_agents_cli.tools.git import clone_template, init_repository, is_git_installed
+from fips_agents_cli.tools.project import (
+    cleanup_template_files,
+    to_module_name,
+    update_project_name,
+    validate_project_name,
+)
+
+console = Console()
+
+# Template URL for MCP server projects
+MCP_SERVER_TEMPLATE_URL = "https://github.com/rdwj/mcp-server-template"
+
+
+@click.group()
+def create():
+    """Create new projects from templates."""
+    pass
+
+
+@create.command("mcp-server")
+@click.argument("project_name")
+@click.option(
+    "--target-dir",
+    "-t",
+    default=None,
+    help="Target directory for the project (default: current directory)",
+)
+@click.option(
+    "--no-git",
+    is_flag=True,
+    default=False,
+    help="Skip git repository initialization",
+)
+def mcp_server(project_name: str, target_dir: Optional[str], no_git: bool):
+    """
+    Create a new MCP server project from template.
+
+    PROJECT_NAME must start with a lowercase letter and contain only
+    lowercase letters, numbers, hyphens, and underscores.
+
+    Example:
+        fips-agents create mcp-server my-mcp-server
+        fips-agents create mcp-server my-mcp-server --target-dir ~/projects
+    """
+    try:
+        # Step 1: Validate project name
+        console.print("\n[bold cyan]Creating MCP Server Project[/bold cyan]\n")
+
+        is_valid, error_msg = validate_project_name(project_name)
+        if not is_valid:
+            console.print(f"[red]✗[/red] Invalid project name: {error_msg}")
+            sys.exit(1)
+
+        console.print(f"[green]✓[/green] Project name '{project_name}' is valid")
+
+        # Step 2: Resolve and validate target directory
+        target_path = resolve_target_path(project_name, target_dir)
+
+        is_valid, error_msg = validate_target_directory(target_path, allow_existing=False)
+        if not is_valid:
+            console.print(f"[red]✗[/red] {error_msg}")
+            console.print(
+                "\n[yellow]Hint:[/yellow] Choose a different name or remove the existing directory"
+            )
+            sys.exit(1)
+
+        console.print(f"[green]✓[/green] Target directory: {target_path}")
+
+        # Step 3: Check if git is installed
+        if not is_git_installed():
+            console.print(
+                "[yellow]⚠[/yellow] Git is not installed. This is required for cloning templates."
+            )
+            console.print("[yellow]Hint:[/yellow] Install git from https://git-scm.com/downloads")
+            sys.exit(1)
+
+        # Step 4: Clone template repository
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            console=console,
+        ) as progress:
+            progress.add_task(description="Cloning template repository...", total=None)
+            try:
+                clone_template(MCP_SERVER_TEMPLATE_URL, target_path)
+            except Exception as e:
+                console.print("\n[red]✗[/red] Failed to clone template repository")
+                console.print(f"[red]Error:[/red] {e}")
+                console.print(
+                    f"\n[yellow]Hint:[/yellow] Check your internet connection and verify "
+                    f"the template URL is accessible:\n{MCP_SERVER_TEMPLATE_URL}"
+                )
+                sys.exit(1)
+
+        # Step 5: Customize project
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            console=console,
+        ) as progress:
+            progress.add_task(description="Customizing project...", total=None)
+            try:
+                update_project_name(target_path, project_name)
+                cleanup_template_files(target_path)
+            except Exception as e:
+                console.print("\n[red]✗[/red] Failed to customize project")
+                console.print(f"[red]Error:[/red] {e}")
+                sys.exit(1)
+
+        # Step 6: Initialize git repository
+        if not no_git:
+            with Progress(
+                SpinnerColumn(),
+                TextColumn("[progress.description]{task.description}"),
+                console=console,
+            ) as progress:
+                progress.add_task(description="Initializing git repository...", total=None)
+                try:
+                    init_repository(target_path, initial_commit=True)
+                except Exception as e:
+                    console.print("\n[yellow]⚠[/yellow] Failed to initialize git repository")
+                    console.print(f"[yellow]Warning:[/yellow] {e}")
+                    console.print(
+                        "[yellow]You can initialize git manually later with:[/yellow] git init"
+                    )
+
+        # Step 7: Success message with next steps
+        module_name = to_module_name(project_name)
+
+        success_message = f"""
+[bold green]✓ Successfully created MCP server project![/bold green]
+
+[bold cyan]Project Details:[/bold cyan]
+  • Name: {project_name}
+  • Module: {module_name}
+  • Location: {target_path}
+
+[bold cyan]Next Steps:[/bold cyan]
+
+  1. Navigate to your project:
+     [dim]cd {target_path.name}[/dim]
+
+  2. Create and activate a virtual environment:
+     [dim]python -m venv venv[/dim]
+     [dim]source venv/bin/activate[/dim]  # On Windows: venv\\Scripts\\activate
+
+  3. Install the project in editable mode:
+     [dim]pip install -e .[dev][/dim]
+
+  4. Start developing your MCP server!
+     [dim]Edit src/{module_name}/ files to add your functionality[/dim]
+
+  5. Run tests:
+     [dim]pytest[/dim]
+
+[bold cyan]Documentation:[/bold cyan]
+  • Check the README.md in your project for detailed instructions
+  • MCP Protocol docs: https://modelcontextprotocol.io/
+
+Happy coding! 🚀
+"""
+
+        console.print(Panel(success_message, border_style="green", padding=(1, 2)))
+
+    except KeyboardInterrupt:
+        console.print("\n[yellow]⚠[/yellow] Operation cancelled by user")
+        sys.exit(130)
+    except Exception as e:
+        console.print(f"\n[red]✗[/red] Unexpected error: {e}")
+        sys.exit(1)

fips_agents_cli/tools/__init__.py

@@ -0,0 +1 @@
+"""Tools and utilities for fips-agents-cli."""

fips_agents_cli/tools/filesystem.py

@@ -0,0 +1,125 @@
+"""Filesystem utilities for project operations."""
+
+from pathlib import Path
+from typing import Optional
+
+from rich.console import Console
+
+console = Console()
+
+
+def ensure_directory_exists(path: Path, create: bool = False) -> bool:
+    """
+    Check if a directory exists, optionally creating it.
+
+    Args:
+        path: The directory path to check
+        create: Whether to create the directory if it doesn't exist
+
+    Returns:
+        bool: True if directory exists (or was created), False otherwise
+    """
+    if path.exists():
+        return path.is_dir()
+
+    if create:
+        try:
+            path.mkdir(parents=True, exist_ok=True)
+            return True
+        except Exception as e:
+            console.print(f"[red]✗[/red] Failed to create directory {path}: {e}")
+            return False
+
+    return False
+
+
+def check_directory_empty(path: Path) -> bool:
+    """
+    Check if a directory is empty.
+
+    Args:
+        path: The directory path to check
+
+    Returns:
+        bool: True if directory is empty, False otherwise
+    """
+    if not path.exists():
+        return True
+
+    if not path.is_dir():
+        return False
+
+    return not any(path.iterdir())
+
+
+def validate_target_directory(
+    target_path: Path, allow_existing: bool = False
+) -> tuple[bool, Optional[str]]:
+    """
+    Validate that a target directory is suitable for project creation.
+
+    Args:
+        target_path: The target directory path
+        allow_existing: Whether to allow existing directories (must be empty)
+
+    Returns:
+        tuple: (is_valid, error_message)
+               is_valid is True if valid, False otherwise
+               error_message is None if valid, otherwise contains the error description
+    """
+    # Check if parent directory exists
+    parent = target_path.parent
+    if not parent.exists():
+        return False, f"Parent directory does not exist: {parent}"
+
+    # Check if target already exists
+    if target_path.exists():
+        if not allow_existing:
+            return False, f"Directory already exists: {target_path}"
+
+        if not target_path.is_dir():
+            return False, f"Path exists but is not a directory: {target_path}"
+
+        if not check_directory_empty(target_path):
+            return False, f"Directory is not empty: {target_path}"
+
+    return True, None
+
+
+def resolve_target_path(project_name: str, target_dir: Optional[str] = None) -> Path:
+    """
+    Resolve the target path for project creation.
+
+    Args:
+        project_name: The name of the project
+        target_dir: Optional target directory (defaults to current directory)
+
+    Returns:
+        Path: The resolved absolute path for the project
+    """
+    if target_dir:
+        base = Path(target_dir).resolve()
+    else:
+        base = Path.cwd()
+
+    return base / project_name
+
+
+def get_relative_path(path: Path, base: Optional[Path] = None) -> str:
+    """
+    Get a relative path string for display purposes.
+
+    Args:
+        path: The path to convert
+        base: Base path for relative calculation (defaults to current directory)
+
+    Returns:
+        str: Relative path string, or absolute if relative calculation fails
+    """
+    if base is None:
+        base = Path.cwd()
+
+    try:
+        return str(path.relative_to(base))
+    except ValueError:
+        return str(path)

fips_agents_cli/tools/git.py

@@ -0,0 +1,100 @@
+"""Git operations for cloning and initializing repositories."""
+
+import shutil
+from pathlib import Path
+
+import git
+from rich.console import Console
+
+console = Console()
+
+
+def clone_template(repo_url: str, target_path: Path, branch: str = "main") -> None:
+    """
+    Clone a git repository template to a target path.
+
+    Performs a shallow clone (depth=1) for faster cloning and removes the .git
+    directory to allow fresh initialization.
+
+    Args:
+        repo_url: The URL of the git repository to clone
+        target_path: The local path where the repository should be cloned
+        branch: The branch to clone (default: "main")
+
+    Raises:
+        git.GitCommandError: If the clone operation fails
+        OSError: If there are filesystem permission issues
+    """
+    try:
+        # Perform shallow clone for faster operation
+        console.print(f"[cyan]Cloning template from {repo_url}...[/cyan]")
+        git.Repo.clone_from(
+            repo_url,
+            str(target_path),
+            branch=branch,
+            depth=1,
+            single_branch=True,
+        )
+
+        # Remove .git directory to allow fresh initialization
+        git_dir = target_path / ".git"
+        if git_dir.exists():
+            shutil.rmtree(git_dir)
+            console.print("[green]✓[/green] Template cloned successfully")
+
+    except git.GitCommandError as e:
+        console.print(f"[red]✗[/red] Failed to clone template: {e}")
+        raise
+    except Exception as e:
+        console.print(f"[red]✗[/red] Unexpected error during clone: {e}")
+        raise
+
+
+def init_repository(project_path: Path, initial_commit: bool = True) -> None:
+    """
+    Initialize a new git repository in the project directory.
+
+    Args:
+        project_path: Path to the project directory
+        initial_commit: Whether to create an initial commit (default: True)
+
+    Raises:
+        git.GitCommandError: If git operations fail
+    """
+    try:
+        console.print("[cyan]Initializing git repository...[/cyan]")
+
+        # Initialize repository
+        repo = git.Repo.init(str(project_path))
+
+        if initial_commit:
+            # Add all files
+            repo.index.add("*")
+
+            # Create initial commit
+            repo.index.commit("Initial commit from fips-agents-cli")
+
+            console.print("[green]✓[/green] Git repository initialized with initial commit")
+        else:
+            console.print("[green]✓[/green] Git repository initialized")
+
+    except git.GitCommandError as e:
+        console.print(f"[red]✗[/red] Failed to initialize git repository: {e}")
+        raise
+    except Exception as e:
+        console.print(f"[red]✗[/red] Unexpected error during git init: {e}")
+        raise
+
+
+def is_git_installed() -> bool:
+    """
+    Check if git is installed and available in the system PATH.
+
+    Returns:
+        bool: True if git is installed, False otherwise
+    """
+    try:
+        git.Git().version()
+        return True
+    except (git.GitCommandNotFound, git.GitCommandError):
+        return False

fips_agents_cli/tools/project.py

@@ -0,0 +1,163 @@
+"""Project customization and configuration utilities."""
+
+import re
+import shutil
+from pathlib import Path
+from typing import Optional
+
+import tomlkit
+from rich.console import Console
+
+console = Console()
+
+
+def validate_project_name(name: str) -> tuple[bool, Optional[str]]:
+    """
+    Validate project name according to Python package naming conventions.
+
+    Project names must:
+    - Start with a lowercase letter
+    - Contain only lowercase letters, numbers, hyphens, and underscores
+    - Not be empty
+
+    Args:
+        name: The project name to validate
+
+    Returns:
+        tuple: (is_valid, error_message)
+               is_valid is True if valid, False otherwise
+               error_message is None if valid, otherwise contains the error description
+    """
+    if not name:
+        return False, "Project name cannot be empty"
+
+    if not re.match(r"^[a-z][a-z0-9\-_]*$", name):
+        return False, (
+            "Project name must start with a lowercase letter and contain only "
+            "lowercase letters, numbers, hyphens, and underscores"
+        )
+
+    return True, None
+
+
+def to_module_name(project_name: str) -> str:
+    """
+    Convert a project name to a valid Python module name.
+
+    Replaces hyphens with underscores to ensure compatibility with Python imports.
+
+    Args:
+        project_name: The project name (may contain hyphens)
+
+    Returns:
+        str: A valid Python module name (hyphens replaced with underscores)
+    """
+    return project_name.replace("-", "_")
+
+
+def update_project_name(project_path: Path, new_name: str) -> None:
+    """
+    Update the project name in pyproject.toml and rename the source directory.
+
+    This function:
+    1. Updates the 'name' field in pyproject.toml
+    2. Updates the entry point script name if present
+    3. Renames the source directory from the template name to the new module name
+
+    Args:
+        project_path: Path to the project root directory
+        new_name: The new project name (with hyphens allowed)
+
+    Raises:
+        FileNotFoundError: If pyproject.toml or source directory doesn't exist
+        ValueError: If pyproject.toml is malformed
+    """
+    try:
+        console.print(f"[cyan]Customizing project for '{new_name}'...[/cyan]")
+
+        pyproject_path = project_path / "pyproject.toml"
+
+        if not pyproject_path.exists():
+            raise FileNotFoundError(f"pyproject.toml not found at {pyproject_path}")
+
+        # Read and parse pyproject.toml
+        with open(pyproject_path) as f:
+            pyproject = tomlkit.parse(f.read())
+
+        # Get the old project name from pyproject.toml
+        old_name = pyproject.get("project", {}).get("name", "mcp-server-template")
+        old_module_name = to_module_name(old_name)
+        new_module_name = to_module_name(new_name)
+
+        # Update project name
+        if "project" in pyproject:
+            pyproject["project"]["name"] = new_name
+
+            # Update entry point script name if it exists
+            if "scripts" in pyproject["project"]:
+                # Find and update any entry points that reference the old name
+                scripts = pyproject["project"]["scripts"]
+                old_scripts = dict(scripts)
+
+                for script_name, script_path in old_scripts.items():
+                    # Replace old module name with new module name in the path
+                    new_script_path = script_path.replace(old_module_name, new_module_name)
+
+                    # If the script name was based on the old project name, update it
+                    if script_name == old_name or script_name == old_module_name:
+                        del scripts[script_name]
+                        scripts[new_name] = new_script_path
+                    else:
+                        scripts[script_name] = new_script_path
+
+        # Write updated pyproject.toml
+        with open(pyproject_path, "w") as f:
+            f.write(tomlkit.dumps(pyproject))
+
+        console.print("[green]✓[/green] Updated pyproject.toml")
+
+        # Rename source directory
+        src_dir = project_path / "src"
+        old_src_path = src_dir / old_module_name
+        new_src_path = src_dir / new_module_name
+
+        if old_src_path.exists() and old_src_path != new_src_path:
+            shutil.move(str(old_src_path), str(new_src_path))
+            console.print(f"[green]✓[/green] Renamed source directory to '{new_module_name}'")
+        elif not old_src_path.exists():
+            # Template might have a different structure, log a warning
+            console.print(
+                f"[yellow]⚠[/yellow] Source directory 'src/{old_module_name}' not found, "
+                "skipping rename"
+            )
+
+        console.print("[green]✓[/green] Project customization complete")
+
+    except FileNotFoundError as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+    except Exception as e:
+        console.print(f"[red]✗[/red] Failed to customize project: {e}")
+        raise
+
+
+def cleanup_template_files(project_path: Path) -> None:
+    """
+    Remove template-specific files that shouldn't be in the new project.
+
+    Args:
+        project_path: Path to the project root directory
+    """
+    # Files to remove (commonly found in templates)
+    files_to_remove = [
+        ".github/workflows/template-cleanup.yml",  # Template-specific workflows
+    ]
+
+    for file_path in files_to_remove:
+        full_path = project_path / file_path
+        if full_path.exists():
+            try:
+                full_path.unlink()
+                console.print(f"[green]✓[/green] Removed template file: {file_path}")
+            except Exception as e:
+                console.print(f"[yellow]⚠[/yellow] Could not remove {file_path}: {e}")

fips_agents_cli/version.py

@@ -0,0 +1,3 @@
+"""Version information for fips-agents-cli."""
+
+__version__ = "0.1.0"

fips_agents_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,317 @@
+Metadata-Version: 2.4
+Name: fips-agents-cli
+Version: 0.1.0
+Summary: CLI tool for creating and managing FIPS-compliant AI agent projects
+Project-URL: Homepage, https://github.com/rdwj/fips-agents-cli
+Project-URL: Repository, https://github.com/rdwj/fips-agents-cli
+Project-URL: Issues, https://github.com/rdwj/fips-agents-cli/issues
+Author-email: Wes Jackson <wjackson@redhat.com>
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,cli,code-generator,fips,mcp,scaffolding
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.9
+Requires-Dist: click>=8.1.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tomlkit>=0.12.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# FIPS Agents CLI
+
+A command-line tool for creating and managing FIPS-compliant AI agent projects, with a focus on MCP (Model Context Protocol) server development.
+
+## Features
+
+- 🚀 Quick project scaffolding from templates
+- 📦 MCP server project generation
+- 🔧 Automatic project customization
+- 🎨 Beautiful CLI output with Rich
+- ✅ Git repository initialization
+- 🧪 Comprehensive test coverage
+
+## Installation
+
+### Using pipx (Recommended)
+
+```bash
+pipx install fips-agents-cli
+```
+
+### Using pip
+
+```bash
+pip install fips-agents-cli
+```
+
+### From Source (Development)
+
+```bash
+# Clone the repository
+git clone https://github.com/rdwj/fips-agents-cli.git
+cd fips-agents-cli
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install in editable mode with dev dependencies
+pip install -e .[dev]
+```
+
+## Quick Start
+
+### Create a new MCP server project
+
+```bash
+fips-agents create mcp-server my-awesome-server
+```
+
+This will:
+1. Clone the MCP server template
+2. Customize the project with your chosen name
+3. Initialize a git repository
+4. Provide next steps for development
+
+### Specify a target directory
+
+```bash
+fips-agents create mcp-server my-server --target-dir ~/projects
+```
+
+### Skip git initialization
+
+```bash
+fips-agents create mcp-server my-server --no-git
+```
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Display version
+fips-agents --version
+
+# Get help
+fips-agents --help
+fips-agents create --help
+fips-agents create mcp-server --help
+```
+
+### Create MCP Server
+
+```bash
+fips-agents create mcp-server <project-name> [OPTIONS]
+```
+
+**Arguments:**
+- `project-name`: Name for your MCP server project (must start with lowercase letter, contain only lowercase letters, numbers, hyphens, and underscores)
+
+**Options:**
+- `--target-dir, -t PATH`: Target directory for the project (default: current directory)
+- `--no-git`: Skip git repository initialization
+- `--help`: Show help message
+
+**Examples:**
+
+```bash
+# Create in current directory
+fips-agents create mcp-server my-mcp-server
+
+# Create in specific directory
+fips-agents create mcp-server my-server -t ~/projects
+
+# Create without git initialization
+fips-agents create mcp-server my-server --no-git
+```
+
+## Project Name Requirements
+
+Project names must follow these rules:
+- Start with a lowercase letter
+- Contain only lowercase letters, numbers, hyphens (`-`), and underscores (`_`)
+- Not be empty
+
+**Valid examples:** `my-server`, `test_mcp`, `server123`, `my-awesome-mcp-server`
+
+**Invalid examples:** `MyServer` (uppercase), `123server` (starts with number), `my@server` (special characters)
+
+## After Creating a Project
+
+Once your project is created, follow these steps:
+
+```bash
+# 1. Navigate to your project
+cd my-mcp-server
+
+# 2. Create and activate virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# 3. Install the project
+pip install -e .[dev]
+
+# 4. Run tests
+pytest
+
+# 5. Start developing!
+# Edit src/my_mcp_server/ files to add your functionality
+```
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/rdwj/fips-agents-cli.git
+cd fips-agents-cli
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate
+
+# Install with dev dependencies
+pip install -e .[dev]
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=fips_agents_cli --cov-report=html
+
+# Run specific test file
+pytest tests/test_create.py
+
+# Run specific test
+pytest tests/test_create.py::TestCreateMcpServer::test_successful_creation
+```
+
+### Code Quality
+
+```bash
+# Format code with Black
+black src tests
+
+# Lint with Ruff
+ruff check src tests
+
+# Type checking (if using mypy)
+mypy src
+```
+
+### Project Structure
+
+```
+fips-agents-cli/
+├── pyproject.toml          # Project configuration
+├── README.md               # This file
+├── src/
+│   └── fips_agents_cli/
+│       ├── __init__.py     # Package initialization
+│       ├── __main__.py     # Entry point for python -m
+│       ├── cli.py          # Main CLI application
+│       ├── version.py      # Version information
+│       ├── commands/       # CLI command implementations
+│       │   ├── __init__.py
+│       │   └── create.py   # Create command
+│       └── tools/          # Utility modules
+│           ├── __init__.py
+│           ├── filesystem.py  # Filesystem operations
+│           ├── git.py         # Git operations
+│           └── project.py     # Project customization
+└── tests/                  # Test suite
+    ├── __init__.py
+    ├── conftest.py         # Pytest fixtures
+    ├── test_create.py      # Create command tests
+    ├── test_filesystem.py  # Filesystem utilities tests
+    └── test_project.py     # Project utilities tests
+```
+
+## Requirements
+
+- Python 3.9 or higher
+- Git (for cloning templates and initializing repositories)
+
+## Dependencies
+
+- **click** (>=8.1.0): Command-line interface creation
+- **rich** (>=13.0.0): Terminal output formatting
+- **gitpython** (>=3.1.0): Git operations
+- **tomlkit** (>=0.12.0): TOML file manipulation
+
+## Contributing
+
+Contributions are welcome! Please follow these steps:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests (`pytest`)
+5. Format code (`black src tests`)
+6. Commit your changes (`git commit -m 'Add amazing feature'`)
+7. Push to the branch (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
+## Troubleshooting
+
+### Git not found
+
+If you see "Git is not installed" error:
+- **macOS**: `brew install git`
+- **Linux**: `sudo apt-get install git` or `sudo yum install git`
+- **Windows**: Download from https://git-scm.com/downloads
+
+### Directory already exists
+
+If you see "Directory already exists" error:
+- Choose a different project name
+- Remove the existing directory: `rm -rf project-name`
+- Use a different target directory with `--target-dir`
+
+### Template clone fails
+
+If template cloning fails:
+- Check your internet connection
+- Verify the template repository is accessible: https://github.com/rdwj/mcp-server-template
+- Try again later if GitHub is experiencing issues
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Links
+
+- **Repository**: https://github.com/rdwj/fips-agents-cli
+- **Issues**: https://github.com/rdwj/fips-agents-cli/issues
+- **MCP Protocol**: https://modelcontextprotocol.io/
+
+## Changelog
+
+### Version 0.1.0 (MVP)
+
+- Initial release
+- `fips-agents create mcp-server` command
+- Template cloning and customization
+- Git repository initialization
+- Comprehensive test suite
+- Beautiful CLI output with Rich

fips_agents_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+fips_agents_cli/__init__.py,sha256=Jfo6y6T4HIQ-BeeF89w7F-F4BED63KyCIc1yoFGn9OM,167
+fips_agents_cli/__main__.py,sha256=rUeQY3jrV6hQVAI2IE0qZCcUnvXDMj5LiCjhlXsc9PQ,130
+fips_agents_cli/cli.py,sha256=e2QGiAH73pHAjpdf7JdovyNZtc2nyb83LaVaLbLqS5o,718
+fips_agents_cli/version.py,sha256=EeROn-Cy9mXSPq-OrZ--hVR0oQvwMNqIyAgy4w-YowU,70
+fips_agents_cli/commands/__init__.py,sha256=AGxi2-Oc-gKE3sR9F39nIxwnzz-4bcfkkJzaP1qhMvU,40
+fips_agents_cli/commands/create.py,sha256=GvGm8VgsIfqZV_yIXXYzeV-nasLIwuD85_l831YjAho,6403
+fips_agents_cli/tools/__init__.py,sha256=ah4OrYFuyQavuhwguFwFS0o-7ZLGIm5ZWWQK5ZTZZSs,47
+fips_agents_cli/tools/filesystem.py,sha256=G9wzHrgQpoMw3z5EslsyEL91VLlUT6Cf5Rt80DtkwOw,3313
+fips_agents_cli/tools/git.py,sha256=-z2EO7vNZhN6Vuzh34ZbqNteZE4vNnLG8oysgzhmypk,3042
+fips_agents_cli/tools/project.py,sha256=d_qIhsEzPOM55ONSLzheTozXuyuiEEf9OG4hVXISAbk,5730
+fips_agents_cli-0.1.0.dist-info/METADATA,sha256=j3-wAEIftpKnjwj4BVKykYPQh4eDXGva_RNIKh55Qiw,8220
+fips_agents_cli-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fips_agents_cli-0.1.0.dist-info/entry_points.txt,sha256=srO4LAGNp6zcB9zuPW1toLGPyLbcsad9YWsfNxgz20s,57
+fips_agents_cli-0.1.0.dist-info/licenses/LICENSE,sha256=dQJIqi2t9SinZu0yALTYJ8juzosu29KPbjU8WhyboRc,1068
+fips_agents_cli-0.1.0.dist-info/RECORD,,

fips_agents_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

fips_agents_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fips-agents = fips_agents_cli.cli:main

fips_agents_cli-0.1.0.dist-info/licenses/LICENSE

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