dbagent-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{dbagent_cli-0.1.0 → dbagent_cli-0.1.2}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: dbagent-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Universal Database Introspection and Script Generation AI Agent (CLI)
-Author: DB-Agent Team
+Author: Santhosh Gupta
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: typer>=0.9.0

{dbagent_cli-0.1.0 → dbagent_cli-0.1.2}/dbagent/__init__.py

@@ -2,4 +2,5 @@
 DB-Agent: Universal Database Introspection and Script Generation AI Agent (CLI).
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
+__author__ = "Santhosh Gupta"

{dbagent_cli-0.1.0 → dbagent_cli-0.1.2}/dbagent/cli.py

@@ -14,7 +14,7 @@ from rich.table import Table
 from prompt_toolkit import PromptSession
 from prompt_toolkit.history import FileHistory
 
-from dbagent import __version__
+from dbagent import __version__, __author__
 from dbagent.config import ConfigManager
 from dbagent.connectors.factory import create_connector
 from dbagent.schema.formatter import SchemaFormatter
@@ -145,6 +145,86 @@ def _display_pipeline_result(result: PipelineResult, show_sql: bool = True) -> N
         print_code(result.sql, "sql", "Generated SQL")
 
 
+def display_command_guide() -> None:
+    """Display comprehensive command reference table."""
+    print_banner()
+    console.print("[bold cyan]DB-Agent Command Reference & Guide[/bold cyan]\n")
+
+    # Table 1: Core Query & Chat
+    t1 = Table(title="[bold green]1. Core Query & Interactive Commands[/bold green]", show_header=True, header_style="bold cyan", border_style="dim")
+    t1.add_column("Command", style="bold white", width=18)
+    t1.add_column("How to Use (Example)", style="cyan", width=42)
+    t1.add_column("When to Use", style="dim")
+    t1.add_row(
+        "ask",
+        'db-agent ask "list top 10 users" --db devdb',
+        "Ask in natural language -> generates SQL & immediately shows results.",
+    )
+    t1.add_row(
+        "chat",
+        "db-agent chat --db devdb",
+        "Interactive multi-turn CLI session. Auto-executes reads, remembers schema.",
+    )
+    t1.add_row(
+        "run",
+        'db-agent run "SELECT * FROM users" --db devdb',
+        "Directly execute raw SQL queries on the database with Rich table output.",
+    )
+    console.print(t1)
+    console.print("")
+
+    # Table 2: Database Management
+    t2 = Table(title="[bold yellow]2. Database & Schema Commands[/bold yellow]", show_header=True, header_style="bold cyan", border_style="dim")
+    t2.add_column("Command", style="bold white", width=18)
+    t2.add_column("How to Use (Example)", style="cyan", width=42)
+    t2.add_column("When to Use", style="dim")
+    t2.add_row(
+        "connect",
+        "db-agent connect <url> --alias prod_db",
+        "Test credentials and save connection URL under a friendly alias name (< 0.1s).",
+    )
+    t2.add_row(
+        "scan",
+        "db-agent scan --db prod_db --export db.md",
+        "Deeply inspect tables, columns, relations, indexes, and export to Markdown/JSON.",
+    )
+    t2.add_row(
+        "profiles",
+        "db-agent profiles",
+        "List all saved database aliases and their connection URLs.",
+    )
+    console.print(t2)
+    console.print("")
+
+    # Table 3: AI & Code Generation
+    t3 = Table(title="[bold magenta]3. Standalone AI & Generator Commands[/bold magenta]", show_header=True, header_style="bold cyan", border_style="dim")
+    t3.add_column("Command", style="bold white", width=18)
+    t3.add_column("How to Use (Example)", style="cyan", width=42)
+    t3.add_column("When to Use", style="dim")
+    t3.add_row(
+        "setup",
+        "db-agent setup",
+        "1-Click offline AI setup. Downloads Ollama & coding model for 100% standalone use.",
+    )
+    t3.add_row(
+        "generate",
+        'db-agent generate "create ETL" --db devdb -o etl.py',
+        "Generate dialect SQL, Alembic migrations, Python ETL, or APIs to files.",
+    )
+    t3.add_row(
+        "config",
+        "db-agent config",
+        "Interactive wizard to set default AI provider (Ollama, Gemini, Groq, OpenRouter).",
+    )
+    t3.add_row(
+        "models",
+        "db-agent models",
+        "Check status (Online/Offline) of local Ollama models and cloud AI providers.",
+    )
+    console.print(t3)
+    console.print("\n[dim]Run [bold]db-agent <command> --help[/bold] for detailed options on any command.[/dim]\n")
+
+
 # ---------------------------------------------------------------------------
 # CLI Commands
 # ---------------------------------------------------------------------------
@@ -156,11 +236,16 @@ def main(
 ):
     """DB-Agent CLI entry point."""
     if version:
-        console.print(f"DB-Agent version [bold cyan]{__version__}[/bold cyan]")
+        console.print(f"DB-Agent version [bold cyan]{__version__}[/bold cyan] by [bold]{__author__}[/bold]")
         raise typer.Exit()
     if ctx.invoked_subcommand is None:
-        print_banner()
-        console.print("[dim]Run [bold]db-agent --help[/bold] to see all available commands, or [bold]db-agent chat[/bold] to start interactive mode.[/dim]\n")
+        display_command_guide()
+
+
+@app.command(name="guide")
+def guide_command():
+    """Display comprehensive command reference, usage examples, and when to use each command."""
+    display_command_guide()
 
 
 # ---- ask (flagship seamless command) ----

{dbagent_cli-0.1.0 → dbagent_cli-0.1.2}/dbagent_cli.egg-info/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: dbagent-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Universal Database Introspection and Script Generation AI Agent (CLI)
-Author: DB-Agent Team
+Author: Santhosh Gupta
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: typer>=0.9.0

{dbagent_cli-0.1.0 → dbagent_cli-0.1.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dbagent-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "Universal Database Introspection and Script Generation AI Agent (CLI)"
 readme = "README.md"
 requires-python = ">=3.9"
 authors = [
-    { name = "DB-Agent Team" }
+    { name = "Santhosh Gupta" }
 ]
 dependencies = [
     "typer>=0.9.0",