echomodel 0.2.1__py3-none-any.whl

aicfg/cli/__init__.py

@@ -0,0 +1,24 @@
+import click
+from aicfg.cli.commands import cmds
+from aicfg.cli.context import context_cli
+from aicfg.cli.settings import paths, settings, allowed_tools
+from aicfg.cli.servers import mcp_servers
+from aicfg.cli.sessions import claude_cli
+from aicfg.cli.skills import skills
+
+@click.group()
+def cli():
+    """AI Config Manager (aicfg)"""
+    pass
+
+cli.add_command(cmds)
+cli.add_command(context_cli)
+cli.add_command(paths)
+cli.add_command(settings)
+cli.add_command(allowed_tools)
+cli.add_command(mcp_servers)
+cli.add_command(claude_cli)
+cli.add_command(skills)
+
+if __name__ == "__main__":
+    cli()

aicfg/cli/commands.py

@@ -0,0 +1,185 @@
+import click
+import toml
+import json
+from rich.console import Console
+from rich.table import Table
+from rich import print as rprint
+from aicfg.sdk import commands as sdk
+
+console = Console()
+
+@click.group()
+def cmds():
+    """Manage Gemini slash commands (TOML files)."""
+    pass
+
+@cmds.command()
+@click.argument("name")
+@click.argument("prompt", required=False)
+@click.option("--desc", "-d", help="Description of the command")
+@click.option("--scope", type=click.Choice(["user", "project"]),
+default="user", help="Where to create the command (default: user)")
+@click.option("--namespace", "-ns", help="Optional namespace (subdirectory) for the command")
+def add(name, prompt, desc, scope, namespace):
+    """Add a new command."""
+    if not prompt:
+        description = desc or "My custom command"
+        default_content = (
+            f'description = "{description}"\n'
+            'prompt = """\n'
+            'Write your prompt here...\n'
+            '"""'
+        )
+        edited = click.edit(default_content, extension=".toml")
+        if not edited:
+            rprint("[red]Aborted.[/red] No content provided.")
+            return
+        try:
+            data = toml.loads(edited)
+            prompt = data.get("prompt")
+            desc = data.get("description", desc)
+        except Exception as e:
+            rprint(f"[red]Invalid TOML:[/red] {e}")
+            return
+
+    path = sdk.add_command(name, prompt, desc, scope=scope, namespace=namespace)
+    rprint(f"[green]Created[/green] {path} (Scope: [bold]{scope.upper()}[/bold])")
+
+@cmds.command("list")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON.")
+@click.option("--format", type=click.Choice(["text", "json"]),
+default="text", help="Output format.")
+@click.option("--filter", "filter_pattern", help="Filter by name (supports wildcards e.g. 'commit*')")
+@click.option("--scope", "scopes", multiple=True, type=click.Choice(["user", "registry", "project"]),
+help="Filter by scope (can specify multiple)")
+def list_cmds(as_json, format, filter_pattern, scopes):
+    """List all commands. Optional filters for name and scope."""
+    
+    # Convert tuple to list for SDK, or None if empty (implies all) 
+    scope_list = list(scopes) if scopes else None
+    
+    results = sdk.list_commands(filter_pattern=filter_pattern, scopes=scope_list)
+    results = sorted(results, key=lambda x: x["name"])
+    
+    if as_json or format == "json":
+        console.print_json(data=results)
+        return
+
+    table = Table(title="Custom Slash Commands")
+    table.add_column("Command", style="cyan")
+    
+    # Determine which columns to show
+    show_user = not scope_list or "user" in scope_list
+    show_reg = not scope_list or "registry" in scope_list
+    show_proj = not scope_list or "project" in scope_list
+    
+    if show_user: table.add_column("User", justify="center")
+    if show_reg: table.add_column("Registry", justify="center")
+    if show_proj: table.add_column("Project", justify="center")
+
+    for item in results:
+        # Define icons
+        # Green check if identical (synced), Yellow not-equal sign if diff
+        synced = item["synced"]
+        icon = "[green]✅[/green]" if synced else "[yellow] ≠ [/yellow]"
+        
+        row = [item["name"]]
+        
+        if show_user:
+            row.append(icon if item["user"]["exists"] else "[dim]- [/dim]")
+        if show_reg:
+            row.append(icon if item["registry"]["exists"] else "[dim]- [/dim]")
+        if show_proj:
+            row.append(icon if item["project"]["exists"] else "[dim]- [/dim]")
+        
+        table.add_row(*row)
+
+    console.print(table)
+
+@cmds.command()
+@click.argument("name")
+@click.option("--update", is_flag=True, help="Overwrite if command exists in registry and content differs.")
+@click.option("--source-scope", type=click.Choice(["user", "project"]), help="Explicitly choose source scope for registration.")
+def register(name, update, source_scope):
+    """Register a command from user/project scope to the registry."""
+    try:
+        path = sdk.register_command(name, update=update, source_scope=source_scope)
+        rprint(f"[green]Registered[/green] '{name}' to {path}")
+        rprint(f"[blue]Note:[/blue] Changes to the registry repo ({path.parent}) will need to be committed and pushed to GitHub.")
+    except (ValueError, FileNotFoundError, FileExistsError) as e:
+        rprint(f"[red]Error:[/red] {e}")
+        exit(1)
+
+@cmds.command()
+@click.argument("name")
+def show(name):
+    """Show details of a command."""
+    data = sdk.get_command(name)
+    if not data:
+        rprint(f"[red]Error:[/red] Command '{name}' not found.")
+        return
+    
+    rprint(f"[bold]Description:[/bold] {data.get('description')}")
+    rprint("[bold]Prompt:[/bold]")
+    rprint(data.get("prompt"))
+
+@cmds.command()
+@click.argument("name")
+@click.option("--scope", type=click.Choice(["user", "project", "registry"]),
+default="user", help="Scope to remove from (default: user)")
+def remove(name, scope):
+    """Remove a command from local, project, or registry scope."""
+    success = sdk.delete_command(name, scope=scope)
+    if success:
+        rprint(f"[green]Removed[/green] '{name}' from {scope} scope.")
+    else:
+        rprint(f"[red]Error:[/red] Command '{name}' not found in {scope} scope.")
+
+@cmds.command()
+@click.argument("name")
+def publish(name):
+    """Publish a command from User scope to the Registry."""
+    try:
+        path = sdk.publish_command(name)
+        rprint(f"[green]Published[/green] '{name}' to Registry ({path})")
+    except FileNotFoundError as e:
+        rprint(f"[red]Error:[/red] {e}")
+
+@cmds.command()
+@click.argument("name")
+def install(name):
+    """Install a command from Registry to User scope."""
+    try:
+        path = sdk.install_command(name)
+        rprint(f"[green]Installed[/green] '{name}' to User scope ({path})")
+    except FileNotFoundError as e:
+        rprint(f"[red]Error:[/red] {e}")
+
+@cmds.command()
+@click.argument("name")
+def diff(name):
+    """Show differences between User and Registry versions."""
+    result = sdk.get_diff(name)
+    if not result:
+        rprint(f"Command '{name}' cannot be diffed (must exist in both User and Registry).")
+        return
+
+    repo_lines, xdg_lines = result
+    import difflib
+    
+    diff = difflib.unified_diff(
+        repo_lines, xdg_lines,
+        fromfile=f"Registry ({name})",
+        tofile=f"User ({name})",
+        lineterm=""
+    )
+    
+    for line in diff:
+        if line.startswith("+"):
+            console.print(line, style="green", end="")
+        elif line.startswith("-"):
+            console.print(line, style="red", end="")
+        elif line.startswith("@"):
+            console.print(line, style="cyan", end="")
+        else:
+            print(line, end="")

aicfg/cli/context.py

@@ -0,0 +1,183 @@
+"""CLI commands for managing AI assistant context files."""
+import json
+import click
+from rich import print as rprint
+from rich.table import Table
+from aicfg.sdk import context as context_sdk
+from aicfg.sdk import settings as settings_sdk
+
+
+@click.group(name="context")
+def context_cli():
+    """Manage AI assistant context files."""
+    pass
+
+
+@context_cli.command("status")
+@click.option("--scope", type=click.Choice(["user", "project"]), default=None,
+              help="Filter to specific scope (default: show all)")
+@click.option("--format", "output_format", type=click.Choice(["table", "json"]), default="table")
+def status(scope, output_format):
+    """Show the current state of context files for both user and project scopes."""
+    result = context_sdk.get_context_status(scope)
+
+    if output_format == "json":
+        rprint(json.dumps(result, indent=2))
+        return
+
+    rprint(f"[dim]Working directory:[/dim] {result['working_directory']}")
+    if result.get("git_root"):
+        rprint(f"[dim]Git root:[/dim] {result['git_root']}")
+    rprint()
+
+    for scope_name, scope_data in result["scopes"].items():
+        table = Table(title=f"{scope_name.title()} Scope")
+        table.add_column("File", style="cyan")
+        table.add_column("Status", style="green")
+        table.add_column("Details", style="dim")
+
+        for file_name, info in scope_data["files"].items():
+            if not info["exists"]:
+                file_status = "[yellow]missing[/yellow]"
+                details = info["path"]
+            elif info["is_symlink"]:
+                if info.get("points_to_unified"):
+                    file_status = "[green]symlink (unified)[/green]"
+                else:
+                    file_status = "[red]symlink (other)[/red]"
+                details = f"-> {info['symlink_target']}"
+            else:
+                file_status = "present"
+                details = info["path"]
+
+            table.add_row(file_name, file_status, details)
+
+        rprint(table)
+        rprint(f"[dim]State: {scope_data['state']}[/dim]\n")
+
+
+@context_cli.command("unify")
+@click.option("--scope", type=click.Choice(["user", "project"]), default="user",
+              help="Scope to unify (default: user)")
+def unify(scope):
+    """
+    Unify CLAUDE.md and GEMINI.md into a single shared CONTEXT.md.
+
+    Combines context files into a unified location, then creates symlinks
+    so both tools read from the same file.
+
+    This operation is idempotent - running it multiple times is safe.
+    """
+    result = context_sdk.unify_context(scope)
+
+    if result["success"]:
+        rprint(f"[green]Success![/green]\n")
+        rprint(result["message"])
+
+        if result.get("backups"):
+            rprint(f"\n[dim]Backups created:[/dim]")
+            for backup in result["backups"]:
+                rprint(f"  [dim]{backup}[/dim]")
+
+        if result.get("symlinks_created"):
+            rprint(f"\n[dim]Symlinks created:[/dim]")
+            for symlink in result["symlinks_created"]:
+                rprint(f"  [dim]{symlink}[/dim]")
+    else:
+        rprint(f"[red]Failed![/red]\n")
+        rprint(result.get("message", result.get("error", "Unknown error")))
+        raise SystemExit(1)
+
+
+@context_cli.command("analyze")
+@click.argument("scope", type=click.Choice(["user", "project", "all"]))
+@click.argument("prompt")
+@click.option("--model", default=None, help="Gemini model override")
+@click.option("--format", "output_format", type=click.Choice(["text", "json"]), default="text")
+def analyze(scope, prompt, model, output_format):
+    """
+    Analyze context files using Gemini.
+
+    SCOPE: 'user', 'project', or 'all' to analyze both scopes together.
+
+    PROMPT: Your question or analysis request about the context files.
+    """
+    result = context_sdk.analyze_context(scope, prompt, model)
+
+    if output_format == "json":
+        rprint(json.dumps(result, indent=2))
+        return
+
+    if result.get("success"):
+        rprint(result["response"])
+    else:
+        rprint(f"[red]Error:[/red] {result.get('error', 'Unknown error')}")
+        raise SystemExit(1)
+
+
+@context_cli.command("revise")
+@click.argument("scope", type=click.Choice(["user", "project"]))
+@click.argument("prompt")
+@click.option("--model", default=None, help="Gemini model override")
+@click.option("--format", "output_format", type=click.Choice(["text", "json"]), default="text")
+def revise(scope, prompt, model, output_format):
+    """
+    Revise context file using Gemini.
+
+    SCOPE: 'user' or 'project' (cannot revise both at once).
+
+    PROMPT: Instructions for how to modify the context file.
+    """
+    result = context_sdk.revise_context(scope, prompt, model)
+
+    if output_format == "json":
+        rprint(json.dumps(result, indent=2))
+        return
+
+    if result.get("success"):
+        rprint(f"[green]Success![/green] {result['message']}")
+        rprint(f"[dim]Backup: {result['backup']}[/dim]")
+    else:
+        rprint(f"[red]Error:[/red] {result.get('error', 'Unknown error')}")
+        raise SystemExit(1)
+
+
+# Subgroup for file-names management (Gemini-specific setting)
+@context_cli.group(name="file-names")
+def file_names():
+    """Manage context.fileName setting (Gemini-specific)."""
+    pass
+
+
+@file_names.command("list")
+def list_file_names():
+    """List configured context file names."""
+    path, files = settings_sdk.get_context_files()
+    rprint(f"[bold]Config:[/bold] {path}")
+    if not files:
+        rprint("[yellow]No context files configured.[/yellow]")
+        return
+    table = Table(show_header=True, header_style="bold cyan")
+    table.add_column("File Name")
+    for f in sorted(files):
+        table.add_row(f)
+    rprint(table)
+
+
+@file_names.command("add")
+@click.argument("filename")
+def add_file_name(filename):
+    """Add a context file name."""
+    path = settings_sdk.add_context_file(filename)
+    rprint(f"[green]Added[/green] '{filename}' to {path}")
+
+
+@file_names.command("remove")
+@click.argument("filename")
+def remove_file_name(filename):
+    """Remove a context file name."""
+    path, removed = settings_sdk.remove_context_file(filename)
+    if removed:
+        rprint(f"[green]Removed[/green] '{filename}' from {path}")
+    else:
+        rprint(f"[red]File '{filename}' not found in {path}[/red]")

aicfg/cli/servers.py

@@ -0,0 +1,143 @@
+import click
+from rich import print as rprint
+from rich.table import Table
+from aicfg.sdk import mcp_setup
+
+@click.group(name="mcp")
+def mcp_servers():
+    """Manage MCP servers."""
+    pass
+
+@mcp_servers.command("add")
+@click.option("--name", help="Name for the server")
+@click.option("--path", help="Local repository path")
+@click.option("--command", help="Existing command name")
+@click.option("--url", help="Server URL for remote servers")
+@click.option("--self", "is_self", is_flag=True, help="Register aicfg itself")
+@click.option("--scope", type=click.Choice(["user", "project"]), default="user", help="Where to save")
+@click.option("--args", help="CLI arguments for the server")
+def add_mcp(name, path, command, url, is_self, scope, args):
+    """Register a new MCP server."""
+    try:
+        result = mcp_setup.register_mcp(
+            name=name, path=path, command=command, url=url, 
+            is_self=is_self, scope=scope, args=args
+        )
+        rprint(f"[green]Registered[/green] '{result['name']}' in {result['path']}")
+    except Exception as e:
+        rprint(f"[red]Error:[/red] {e}")
+
+@mcp_servers.command("remove")
+@click.argument("name")
+@click.option("--scope", type=click.Choice(["user", "project"]), default="user")
+def remove_mcp(name, scope):
+    """Remove an MCP server."""
+    try:
+        path, success = mcp_setup.remove_mcp_server(name, scope)
+        rprint(f"[green]Removed[/green] '{name}' from {path}")
+    except Exception as e:
+        rprint(f"[red]Error:[/red] {e}")
+
+@mcp_servers.command("list")
+@click.option("--scope", type=click.Choice(["user", "project"]), default=None,
+              help="Filter by scope (default: show all)")
+@click.option("--filter", "filter_pattern", default=None,
+              help="Wildcard pattern to filter by any column (e.g., '*food*')")
+@click.option("--format", "output_format", type=click.Choice(["table", "json"]), default="table",
+              help="Output format (default: table)")
+def list_mcp(scope, filter_pattern, output_format):
+    """List registered MCP servers from project and/or user settings."""
+    import json
+    result = mcp_setup.list_mcp_servers(scope=scope, filter_pattern=filter_pattern)
+
+    if output_format == "json":
+        click.echo(json.dumps(result, indent=2))
+        return
+
+    # Build title with scope indicator
+    title = "MCP Servers"
+    if result["scope"] != "all":
+        title += f" ({result['scope']} scope)"
+
+    table = Table(title=title)
+    table.add_column("Scope", style="magenta")
+    table.add_column("Name", style="cyan")
+    table.add_column("Command/URL", style="green")
+
+    for entry in result["servers"]:
+        cfg = entry["config"]
+        cmd_url = cfg.get("url") or cfg.get("command")
+        table.add_row(entry["scope"], entry["name"], cmd_url)
+
+    rprint(table)
+
+    # Build footer from summary
+    summary = result["summary"]
+    if "filter" in summary:
+        footer = f"Filter: {summary['filter']} ({summary['shown']} of {summary['total']})"
+    else:
+        footer = f"{summary['total']} total"
+    rprint(f"[dim]{footer}[/dim]")
+
+@mcp_servers.command("show")
+@click.argument("name")
+@click.option("--scope", type=click.Choice(["user", "project"]), default=None,
+              help="Scope to search (default: search both, project first)")
+@click.option("--format", "output_format", type=click.Choice(["table", "json"]), default="table")
+def show_mcp(name, scope, output_format):
+    """
+    Show details for a registered MCP server, including health check.
+
+    Looks up the server by NAME and runs a startup validation to check health.
+    """
+    import json
+    import sys
+
+    result = mcp_setup.get_mcp_server(name, scope=scope)
+
+    if output_format == "json":
+        click.echo(json.dumps(result, indent=2))
+        if not result["found"]:
+            sys.exit(1)
+        return
+
+    if not result["found"]:
+        rprint(f"[red]Error:[/red] {result['error']}")
+        sys.exit(1)
+
+    cfg = result["config"]
+    health = result["health"]
+    status = health["status"]
+
+    # Health badge - big and obvious
+    if status == "ok":
+        badge = "[bold white on green] ✓ HEALTHY [/bold white on green]"
+        version_info = ""
+        if health.get("server_name"):
+            version_info = f"  [dim]{health['server_name']} v{health.get('server_version', '?')}[/dim]"
+        rprint(f"{badge}{version_info}")
+    elif status == "skip":
+        rprint(f"[bold black on yellow] ⊘ SKIPPED [/bold black on yellow]  [dim]{health.get('reason', '')}[/dim]")
+    else:
+        rprint(f"[bold white on red] ✗ FAILED [/bold white on red]  [red]{health.get('error', 'Unknown')}[/red]")
+
+    rprint()
+
+    # Details in a simple table
+    table = Table(show_header=False, box=None, padding=(0, 2))
+    table.add_column(style="dim")
+    table.add_column()
+
+    table.add_row("Name", result["name"])
+    table.add_row("Scope", result["scope"])
+    table.add_row("Type", result["type"])
+
+    if result["type"] == "url":
+        table.add_row("URL", cfg.get("url"))
+    else:
+        table.add_row("Command", cfg.get("command"))
+        args = cfg.get("args", [])
+        if args:
+            table.add_row("Args", " ".join(args))
+
+    rprint(table)

aicfg/cli/sessions.py

@@ -0,0 +1,54 @@
+"""CLI commands for Claude Code session search."""
+
+import json
+import re
+import sys
+
+import click
+
+from aicfg.sdk.sessions import (
+    collect_recent_session_files,
+    find_sessions,
+    format_results,
+    DEFAULT_MOST_RECENT,
+)
+
+
+@click.group(name="claude")
+def claude_cli():
+    """Claude Code utilities."""
+    pass
+
+
+@claude_cli.command(name="find-session")
+@click.argument("patterns", nargs=-1, required=True)
+@click.option("--all", "match_all", is_flag=True, help="Require ALL patterns to match (default: any)")
+@click.option("--most-recent", type=int, default=DEFAULT_MOST_RECENT, help=f"Sessions to search (default: {DEFAULT_MOST_RECENT})")
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+@click.option("--max-snippets", type=int, default=3, help="Max snippets per session (default: 3)")
+def find_session(patterns, match_all, most_recent, as_json, max_snippets):
+    """Search recent Claude Code sessions for keywords or patterns.
+
+    Multiple PATTERNS are OR by default. Use --all for AND.
+    """
+    for p in patterns:
+        try:
+            re.compile(p)
+        except re.error as e:
+            click.echo(f"Invalid pattern '{p}': {e}", err=True)
+            sys.exit(1)
+
+    matches = find_sessions(
+        patterns=list(patterns),
+        match_all=match_all,
+        most_recent=most_recent,
+        max_snippets=max_snippets,
+    )
+
+    if as_json:
+        click.echo(json.dumps(matches, indent=2))
+        return
+
+    searched = len(collect_recent_session_files(most_recent))
+    output = format_results(matches, list(patterns), match_all, most_recent, searched)
+    click.echo(output)