# src/codegraphcontext/cli/main.py

"""

This module defines the command-line interface (CLI) for the CodeGraphContext application.

It uses the Typer library to create a user-friendly and well-documented CLI.

Commands:

- mcp setup: Runs an interactive wizard to configure the MCP client.

- mcp start: Launches the main MCP server.

- help: Displays help information.

- version: Show the installed version.

"""

import typer

from rich.console import Console

from rich.table import Table

from rich import box

from typing import Optional

import asyncio

import logging

import json

import os

from pathlib import Path

from importlib.metadata import version as pkg_version, PackageNotFoundError

from codegraphcontext.server import MCPServer

from codegraphcontext.core.database import DatabaseManager

from .setup_wizard import run_neo4j_setup_wizard, configure_mcp_client

from . import config_manager

# Import the new helper functions

from .cli_helpers import (

index_helper,

add_package_helper,

list_repos_helper,

delete_helper,

cypher_helper,

cypher_helper_visual,

visualize_helper,

reindex_helper,

clean_helper,

stats_helper,

_initialize_services,

watch_helper,

unwatch_helper,

list_watching_helper,

setup_scip_helper,

)

# Set the log level for the noisy neo4j, asyncio, and urllib3 loggers to keep the output clean.

# Get the log level from config, defaulting to WARNING

def _configure_library_loggers():

"""Configure third-party library loggers based on config setting."""

try:

log_level_str = config_manager.get_config_value('LIBRARY_LOG_LEVEL')

if log_level_str is None:

log_level_str = 'WARNING'

log_level_str = str(log_level_str).upper()

log_level = getattr(logging, log_level_str, logging.WARNING)

except (AttributeError, Exception):

log_level = logging.WARNING

logging.getLogger("neo4j").setLevel(log_level)

logging.getLogger("asyncio").setLevel(log_level)

logging.getLogger("urllib3").setLevel(log_level)

_configure_library_loggers()

# Import visualization module

from .visualizer import (

visualize_call_graph,

visualize_call_chain,

visualize_dependencies,

visualize_inheritance_tree,

visualize_overrides,

visualize_search_results,

check_visual_flag,

)

# Initialize the Typer app and Rich console for formatted output.

app = typer.Typer(

name="cgc",

help="CodeGraphContext: An MCP server for AI-powered code analysis.",

add_completion=True,

)

console = Console(stderr=True)

# Configure basic logging for the application.

logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(name)s - %(message)s')

def get_version() -> str:

"""

Try to read version from the installed package metadata.

Fallback to a dev version if not installed.

"""

try:

return pkg_version("codegraphcontext") # must match [project].name in pyproject.toml

except PackageNotFoundError:

return "0.0.0 (dev)"

# Create MCP command group

mcp_app = typer.Typer(help="MCP client configuration commands")

app.add_typer(mcp_app, name="mcp")

@mcp_app.command("setup")

def mcp_setup():

"""

Configure MCP Client (IDE/CLI Integration).

Sets up CodeGraphContext integration with your IDE or CLI tool:

- VS Code, Cursor, Windsurf

- Claude Desktop, Gemini CLI

- Cline, RooCode, Amazon Q Developer, Goose

- OpenCode (prints stdio config + link to vendor docs)

Works with FalkorDB by default (no database setup needed).

"""

console.print("\n[bold cyan]MCP Client Setup[/bold cyan]")

console.print("Configure your IDE or CLI tool to use CodeGraphContext.\n")

configure_mcp_client()

@mcp_app.command("start")

def mcp_start():

"""

Start the CodeGraphContext MCP server.

Starts the server which listens for JSON-RPC requests from stdin.

This is used by IDE integrations (VS Code, Cursor, etc.).

"""

console.print("[bold green]Starting CodeGraphContext Server...[/bold green]")

_load_credentials()

server = None

loop = asyncio.new_event_loop()

asyncio.set_event_loop(loop)

try:

server = MCPServer(loop=loop, cwd=Path.cwd())

loop.run_until_complete(server.run())

except ValueError as e:

# This typically happens if credentials are still not found after all checks.

console.print(f"[bold red]Configuration Error:[/bold red] {e}")

console.print("Please run `cgc neo4j setup` or use FalkorDB (default).")

except KeyboardInterrupt:

# Handle graceful shutdown on Ctrl+C.

console.print("\n[bold yellow]Server stopped by user.[/bold yellow]")

finally:

# Ensure server and event loop are properly closed.

if server:

server.shutdown()

loop.close()

@mcp_app.command("tools")

def mcp_tools():

"""

List all available MCP tools.

Shows all tools that can be called by AI assistants through the MCP interface.

"""

_load_credentials()

console.print("[bold green]Available MCP Tools:[/bold green]")

try:

# Instantiate the server to access the tool definitions.

server = MCPServer()

tools = server.tools.values()

table = Table(show_header=True, header_style="bold magenta")

table.add_column("Tool Name", style="dim", width=30)

table.add_column("Description")

for tool in sorted(tools, key=lambda t: t['name']):

table.add_row(tool['name'], tool['description'])

console.print(table)

except ValueError as e:

console.print(f"[bold red]Error loading tools:[/bold red] {e}")

console.print("Please ensure your database is configured correctly.")

except Exception as e:

console.print(f"[bold red]An unexpected error occurred:[/bold red] {e}")

# Abbreviation for mcp setup

@app.command("m", rich_help_panel="Shortcuts")

def mcp_setup_alias():

"""Shortcut for 'cgc mcp setup'"""

mcp_setup()

# Create Neo4j command group

neo4j_app = typer.Typer(help="Neo4j database configuration commands")

app.add_typer(neo4j_app, name="neo4j")

@neo4j_app.command("setup")

def neo4j_setup():

"""

Configure Neo4j Database Connection.

Choose from multiple setup options:

- Local (Docker-based, recommended)

- Local (Binary installation on Linux)

- Hosted (Neo4j AuraDB or remote instance)

- Connect to existing Neo4j instance

Note: This is optional. CodeGraphContext works with FalkorDB by default.

"""

console.print("\n[bold cyan]Neo4j Database Setup[/bold cyan]")

console.print("Configure Neo4j database connection for CodeGraphContext.\n")

run_neo4j_setup_wizard()

# Abbreviation for neo4j setup

@app.command("n", rich_help_panel="Shortcuts")

def neo4j_setup_alias():

"""Shortcut for 'cgc neo4j setup'"""

neo4j_setup()

# Create Context command group

context_app = typer.Typer(help="Manage Contexts (logical workspaces) and Mode")

app.add_typer(context_app, name="context")

@context_app.command("list")

def context_list():

"""List all available contexts and current mode."""

cfg = config_manager.load_context_config()

console.print(f"\n[bold]Current Mode:[/bold] {cfg.mode}")

if cfg.mode == "named":

console.print(f"[bold]Default Context:[/bold] {cfg.default_context or '<none>'}")

contexts = config_manager.list_contexts()

if not contexts:

console.print("\n[yellow]No custom contexts defined. Using global default.[/yellow]")

return

table = Table(title="\nConfigured Contexts")

table.add_column("Name", style="cyan")

table.add_column("Database", style="green")

table.add_column("DB Path", style="dim")

table.add_column("Repos Linked", justify="right")

for ctx in contexts:

marker = " *" if ctx.name == cfg.default_context else ""

table.add_row(

f"{ctx.name}{marker}",

ctx.database,

ctx.db_path,

str(len(ctx.repos))

)

console.print(table)

console.print("[dim] * indicates default context[/dim]\n")

@context_app.command("create")

def context_create(

name: str = typer.Argument(..., help="Name of the new context"),

database: str = typer.Option(None, "--database", "-d", help="Database backend (falkordb, kuzudb, neo4j). Defaults to DEFAULT_DATABASE from config."),

db_path: str = typer.Option(None, "--db-path", help="Explicit path for the DB (defaults to ~/.codegraphcontext/contexts/<name>/db)"),

):

"""Create a new logical context."""

if database is None:

database = config_manager.get_config_value("DEFAULT_DATABASE") or "falkordb"

config_manager.create_context(name, database, db_path)

@context_app.command("delete")

def context_delete(

name: str = typer.Argument(..., help="Name of the context to delete")

):

"""Delete a context from the registry."""

if typer.confirm(f"Are you sure you want to delete context '{name}'? DB files will remain on disk."):

config_manager.delete_context(name)

@context_app.command("mode")

def context_mode(

mode: str = typer.Argument(..., help="Mode to switch to (global, per-repo, named)"),

):

"""Set the system-wide context mode."""

config_manager.set_context_mode(mode.lower())

@context_app.command("default")

def context_default(

name: str = typer.Argument(..., help="Name of the context to set as default"),

):

"""Set the default named context (used when --context is omitted in named mode)."""

config_manager.set_default_context(name)

# ============================================================================

# CREDENTIALS LOADING PRECEDENCE

# ============================================================================

def _load_credentials(cli_context_flag: Optional[str] = None):

"""

Loads configuration and credentials from various sources into environment variables.

Uses per-variable precedence - each variable is loaded from the highest priority source.

Priority order (highest to lowest):

1. Runtime environment variables (shell/CI)

2. Local `.env` in project directory (project-specific overrides)

3. Global `~/.codegraphcontext/.env` (user defaults, including `cgc config set`)

4. Local `mcp.json` env vars (project defaults)

1. Local `mcp.json` env vars (highest - explicit MCP server config)

2. ``<cwd>/.codegraphcontext/.env`` only (no parent-directory walk)

3. Global `~/.codegraphcontext/.env` (lowest - user defaults)

Step 2 skips duplicate loading when that file is the same path as the global file.

Arbitrary repo-root `.env` files are not loaded—only CodeGraphContext config paths.

"""

from dotenv import dotenv_values, find_dotenv

from codegraphcontext.cli.config_manager import (

ensure_config_dir,

codegraphcontext_dotenv_at_cwd,

normalize_config_path,

)

# Ensure config directory exists (lazy initialization)

ensure_config_dir()

# Snapshot runtime environment BEFORE merging config files.

# These values must remain highest priority.

runtime_env = dict(os.environ)

# Collect all config sources in precedence order (lowest to highest)

config_sources = []

config_source_names = []

key_source_map = {}

key_defined_in = {}

def _append_source(source_name: str, source_values: dict):

if not source_values:

return

config_sources.append(source_values)

config_source_names.append(source_name)

for k, v in source_values.items():

if v is None:

continue

key_source_map[k] = source_name

key_defined_in.setdefault(k, []).append(source_name)

# 4. Local mcp.json (lowest priority - project defaults)

mcp_file_path = Path.cwd() / "mcp.json"

if mcp_file_path.exists():

try:

with open(mcp_file_path, "r", encoding="utf-8", errors="replace") as f:

mcp_config = json.load(f)

server_env = mcp_config.get("mcpServers", {}).get("CodeGraphContext", {}).get("env", {})

if isinstance(server_env, dict):

normalized_env = {}

for env_key, env_value in server_env.items():

if env_value is not None and "PATH" in env_key:

normalized_env[env_key] = normalize_config_path(str(env_value), absolute=True)

else:

normalized_env[env_key] = env_value

server_env = normalized_env

_append_source("mcp.json", server_env)

except Exception as e:

console.print(f"[yellow]Warning: Could not load mcp.json: {e}[/yellow]")

# 3. Global .env file (user defaults)

global_env_path = Path.home() / ".codegraphcontext" / ".env"

if global_env_path.exists():

try:

with open(global_env_path, "r", encoding="utf-8", errors="replace") as f:

_append_source(str(global_env_path), dotenv_values(stream=f))

except Exception as e:

console.print(f"[yellow]Warning: Could not load global .env: {e}[/yellow]")

# 2. Local project .env (project-specific overrides)

try:

dotenv_path = find_dotenv(usecwd=True, raise_error_if_not_found=False)

if dotenv_path:

with open(dotenv_path, "r", encoding="utf-8", errors="replace") as f:

_append_source(str(dotenv_path), dotenv_values(stream=f))

except Exception as e:

console.print(f"[yellow]Warning: Could not load .env from current directory: {e}[/yellow]")

# 2. <cwd>/.codegraphcontext/.env only (overrides global when distinct)

try:

local_cgc_env = codegraphcontext_dotenv_at_cwd(Path.cwd())

if local_cgc_env and local_cgc_env.resolve() != global_env_path.resolve():

with open(local_cgc_env, "r", encoding="utf-8", errors="replace") as f:

vals = dotenv_values(stream=f)

_append_source(str(local_cgc_env), vals)

except Exception as e:

console.print(

f"[yellow]Warning: Could not load .codegraphcontext/.env at cwd: {e}[/yellow]"

)

# Merge all configs with proper precedence (later sources override earlier ones)

merged_config = {}

for config in config_sources:

merged_config.update(config)

# Apply merged config to environment, but never override runtime env.

# Apply merged config to environment.

# IMPORTANT: DB-selection keys set in the shell must win over .env defaults.

# E.g. `DEFAULT_DATABASE=falkordb cgc index …` must not be overridden by

# DEFAULT_DATABASE=neo4j sitting in ~/.codegraphcontext/.env

DB_OVERRIDE_KEYS = {"CGC_RUNTIME_DB_TYPE", "DEFAULT_DATABASE"}

for key, value in merged_config.items():

if value is not None: # Only set non-None values

if key in runtime_env:

continue

if "PATH" in key:

value = normalize_config_path(str(value), absolute=True)

os.environ[key] = str(value)

# Report what was loaded

if config_source_names:

if len(config_source_names) == 1:

console.print(f"[dim]Loaded configuration from: {config_source_names[-1]}[/dim]")

else:

console.print(f"[dim]Loaded configuration from: {', '.join(config_source_names)}[/dim]")

else:

console.print("[yellow]No configuration file found. Using defaults.[/yellow]")

default_db_sources = list(key_defined_in.get("DEFAULT_DATABASE", []))

if "DEFAULT_DATABASE" in runtime_env:

default_db_sources.append("environment")

if len(default_db_sources) > 1:

winners = "environment" if "DEFAULT_DATABASE" in runtime_env else key_source_map.get("DEFAULT_DATABASE", "defaults")

console.print(

"[dim]DEFAULT_DATABASE defined in multiple sources: "

f"{', '.join(default_db_sources)}; using: {winners}[/dim]"

)

# Detect the context to see if it specifies a custom database

if cli_context_flag is None:

import sys

for i, arg in enumerate(sys.argv):

if arg in ("--context", "-c"):

if i + 1 < len(sys.argv):

cli_context_flag = sys.argv[i + 1]

break

elif arg.startswith("--context="):

cli_context_flag = arg.split("=", 1)[1]

break

from codegraphcontext.cli.config_manager import resolve_context

ctx = None

try:

ctx = resolve_context(cli_context_flag)

except Exception:

pass

# Determine if there is a runtime database override.

runtime_db = os.environ.get("CGC_RUNTIME_DB_TYPE")

has_runtime_override = (

runtime_db is not None

or "DATABASE_TYPE" in runtime_env

or "DEFAULT_DATABASE" in runtime_env

)

# If there is no runtime override, but the context defines a database,

# set DEFAULT_DATABASE to the context database to ensure that's what gets initialized.

if not has_runtime_override and ctx and ctx.mode != "global" and ctx.database:

os.environ["DEFAULT_DATABASE"] = ctx.database

# Now select the database based on precedence:

# 1. CGC_RUNTIME_DB_TYPE

# 2. DATABASE_TYPE or DEFAULT_DATABASE from runtime environment (shell variables)

# 3. Context database

# 4. DATABASE_TYPE or DEFAULT_DATABASE from merged config files (.env files)

# 5. Auto-detect fallback

if runtime_db:

default_db = runtime_db.lower()

db_source = "runtime-env (CGC_RUNTIME_DB_TYPE)"

elif "DATABASE_TYPE" in runtime_env:

default_db = runtime_env["DATABASE_TYPE"].lower()

db_source = "environment (DATABASE_TYPE)"

elif "DEFAULT_DATABASE" in runtime_env:

default_db = runtime_env["DEFAULT_DATABASE"].lower()

db_source = "environment (DEFAULT_DATABASE)"

elif not has_runtime_override and ctx and ctx.mode != "global" and ctx.database:

default_db = ctx.database.lower()

db_source = f"context ({ctx.context_name or 'resolved'})"

elif os.environ.get("DATABASE_TYPE") and "DATABASE_TYPE" in key_source_map:

default_db = os.environ["DATABASE_TYPE"].lower()

db_source = key_source_map["DATABASE_TYPE"]

elif os.environ.get("DEFAULT_DATABASE") and "DEFAULT_DATABASE" in key_source_map:

default_db = os.environ["DEFAULT_DATABASE"].lower()

db_source = key_source_map["DEFAULT_DATABASE"]

else:

# No explicit choice — ask the factory which backend it will use

try:

from codegraphcontext.core import get_database_manager

_mgr = get_database_manager()

default_db = _mgr.get_backend_type() # e.g. 'falkordb' / 'kuzudb'

except Exception:

# Factory failed entirely — still show a best-guess

from codegraphcontext.core import _is_falkordb_available

default_db = "falkordb" if _is_falkordb_available() else "kuzudb"

db_source = "auto-detect"

# Print selection banner

if default_db == "neo4j":

has_neo4j_creds = all([

os.environ.get("NEO4J_URI"),

os.environ.get("NEO4J_USERNAME"),

os.environ.get("NEO4J_PASSWORD")

])

if has_neo4j_creds:

neo4j_db = os.environ.get("NEO4J_DATABASE")

if neo4j_db:

console.print(f"[cyan]Using database: neo4j (source: {db_source}, database: {neo4j_db})[/cyan]")

else:

console.print(f"[cyan]Using database: neo4j (source: {db_source})[/cyan]")

else:

console.print("[yellow]⚠ DEFAULT_DATABASE=neo4j but credentials not found. Falling back to default.[/yellow]")

elif default_db == "falkordb":

console.print(f"[cyan]Using database: falkordb (source: {db_source})[/cyan]")

elif default_db == "kuzudb":

console.print(f"[cyan]Using database: kuzudb (source: {db_source})[/cyan]")

elif default_db == "ladybugdb":

console.print(f"[cyan]Using database: ladybugdb (source: {db_source})[/cyan]")

elif default_db == "falkordb-remote":

host = os.environ.get("FALKORDB_HOST")

if host:

console.print(f"[cyan]Using database: falkordb-remote (source: {db_source}, host: {host})[/cyan]")

else:

console.print("[yellow]⚠ DATABASE_TYPE=falkordb-remote but FALKORDB_HOST not set.[/yellow]")

else:

console.print(f"[cyan]Using database: {default_db} (source: {db_source})[/cyan]")

# Persist selection metadata for downstream diagnostics and error messages.

os.environ["CGC_SELECTED_DATABASE"] = default_db

os.environ["CGC_DB_SELECTION_SOURCE"] = db_source

# ============================================================================

# CONFIG COMMAND GROUP

# ============================================================================

config_app = typer.Typer(help="Manage configuration settings")

app.add_typer(config_app, name="config")

@config_app.command("show")

def config_show():

"""

Display current configuration settings.

Shows all configuration values including database, indexing options,

logging settings, and performance tuning parameters.

"""

config_manager.show_config()

@config_app.command("set")

def config_set(

key: str = typer.Argument(..., help="Configuration key to set"),

value: str = typer.Argument(..., help="Value to set")

):

"""

Set a configuration value.

Examples:

cgc config set DEFAULT_DATABASE neo4j

cgc config set INDEX_VARIABLES false

cgc config set MAX_FILE_SIZE_MB 20

cgc config set DEBUG_LOGS true

"""

config_manager.set_config_value(key, value)

@config_app.command("reset")

def config_reset():

"""

Reset all configuration to default values.

This will restore all settings to their defaults.

Your current configuration will be backed up.

"""

if typer.confirm("Are you sure you want to reset all configuration to defaults?", default=False):

config_manager.reset_config()

else:

console.print("[yellow]Reset cancelled[/yellow]")

@config_app.command("db")

def config_db(backend: str = typer.Argument(..., help="Database backend: 'neo4j', 'falkordb', 'falkordb-remote', 'kuzudb', or 'ladybugdb'")):

"""

Quickly switch the default database backend.

Shortcut for 'cgc config set DEFAULT_DATABASE <backend>'.

Examples:

cgc config db neo4j

cgc config db falkordb

cgc config db kuzudb

"""

backend = backend.lower()

if backend not in ['falkordb', 'falkordb-remote', 'neo4j', 'kuzudb', 'ladybugdb']:

console.print(f"[bold red]Invalid backend: {backend}[/bold red]")

console.print("Must be 'falkordb', 'falkordb-remote', 'neo4j', 'kuzudb', or 'ladybugdb'")

raise typer.Exit(code=1)

updated = config_manager.set_config_value("DEFAULT_DATABASE", backend)

if not updated:

console.print(f"[bold red]Failed to switch default database to {backend}[/bold red]")

raise typer.Exit(code=1)

console.print(f"[green]✔ Default database switched to {backend}[/green]")

# ============================================================================

# BUNDLE COMMAND GROUP - Pre-indexed Graph Snapshots

# ============================================================================

bundle_app = typer.Typer(help="Create and load pre-indexed graph bundles")

app.add_typer(bundle_app, name="bundle")

@bundle_app.command("export")

def bundle_export(

output: str = typer.Argument(..., help="Output path for the .cgc bundle file"),

repo: Optional[str] = typer.Option(None, "--repo", "-r", help="Specific repository path to export (default: export all)"),

no_stats: bool = typer.Option(False, "--no-stats", help="Skip statistics generation"),

context: Optional[str] = typer.Option(None, "--context", "-c", help="Specific context to use"),

):

"""

Export the current graph to a portable .cgc bundle.

Creates a pre-indexed graph snapshot that can be distributed and loaded

instantly without re-indexing. Perfect for sharing famous repositories.

Examples:

cgc bundle export numpy.cgc --repo /path/to/numpy

cgc bundle export my-project.cgc

cgc bundle export all-repos.cgc --no-stats

"""

_load_credentials()

from codegraphcontext.core.cgc_bundle import CGCBundle

services = _initialize_services(context)

if not all(services[:3]):

return

db_manager, _, code_finder = services[:3]

try:

output_path = Path(output)

repo_path = Path(repo).resolve() if repo else None

console.print(f"[cyan]Exporting graph to {output_path}...[/cyan]")

if repo_path:

console.print(f"[dim]Repository: {repo_path}[/dim]")

else:

console.print(f"[dim]Exporting all repositories[/dim]")

bundle = CGCBundle(db_manager)

success, message = bundle.export_to_bundle(

output_path,

repo_path=repo_path,

include_stats=not no_stats

)

if success:

console.print(f"[bold green]{message}[/bold green]")

else:

console.print(f"[bold red]Export failed: {message}[/bold red]")

raise typer.Exit(code=1)

finally:

db_manager.close_driver()

@bundle_app.command("import")

def bundle_import(

bundle_file: str = typer.Argument(..., help="Path to the .cgc bundle file to import"),

clear: bool = typer.Option(False, "--clear", help="Clear existing graph data before importing"),

context: Optional[str] = typer.Option(None, "--context", "-c", help="Specific context to use"),

):

"""

Import a .cgc bundle into the current database.

Loads a pre-indexed graph snapshot into your database. Use --clear to

replace all existing data with the bundle contents.

Examples:

cgc bundle import numpy.cgc

cgc bundle import my-project.cgc --clear

"""

_load_credentials()

from codegraphcontext.core.cgc_bundle import CGCBundle

services = _initialize_services(context)

if not all(services[:3]):

return

db_manager, graph_builder, code_finder = services[:3]

try:

bundle_path = Path(bundle_file)

if not bundle_path.exists():

console.print(f"[bold red]Bundle file not found: {bundle_path}[/bold red]")

raise typer.Exit(code=1)

if clear:

console.print("[yellow]⚠️ Warning: This will clear all existing graph data![/yellow]")

if not typer.confirm("Are you sure you want to continue?", default=False):

console.print("[yellow]Import cancelled[/yellow]")

return

console.print(f"[cyan]Importing bundle from {bundle_path}...[/cyan]")

bundle = CGCBundle(db_manager)

success, message = bundle.import_from_bundle(

bundle_path,

clear_existing=clear

)

if success:

console.print(f"[bold green]{message}[/bold green]")

else:

console.print(f"[bold red]Import failed: {message}[/bold red]")

raise typer.Exit(code=1)

finally:

db_manager.close_driver()

@bundle_app.command("load")

def bundle_load(

bundle_name: str = typer.Argument(..., help="Bundle name or path to load (e.g., 'numpy' or 'numpy.cgc')"),

clear: bool = typer.Option(False, "--clear", help="Clear existing graph data before loading")

):

"""

Load a pre-indexed bundle (download if needed, then import).

This is a convenience command that will:

1. Check if the bundle exists locally

2. Download from registry if not found

3. Import the bundle into the database

Examples:

cgc load numpy

cgc load numpy.cgc --clear

cgc load /path/to/bundle.cgc

"""

_load_credentials()

bundle_path = Path(bundle_name)

# If it's an absolute path or has .cgc extension and exists, use it directly

if bundle_path.is_absolute() or (bundle_path.suffix == '.cgc' and bundle_path.exists()):

bundle_import(str(bundle_path), clear=clear)

return

# Add .cgc extension if not present

if not bundle_path.suffix:

bundle_path = Path(f"{bundle_name}.cgc")

# Check if exists locally

if bundle_path.exists():

console.print(f"[dim]Found local bundle: {bundle_path}[/dim]")

bundle_import(str(bundle_path), clear=clear)

return

# Try to download from registry

console.print(f"[yellow]Bundle '{bundle_name}' not found locally.[/yellow]")

console.print(f"[cyan]Attempting to download from registry...[/cyan]")

try:

from .registry_commands import download_bundle

# Extract just the name (without .cgc extension)

name = bundle_path.stem

# Download the bundle

downloaded_path = download_bundle(name, output_dir=None, auto_load=True)

if downloaded_path:

# Import the downloaded bundle

bundle_import(downloaded_path, clear=clear)

else:

console.print(f"[bold red]Failed to download bundle '{name}'[/bold red]")

raise typer.Exit(code=1)

except Exception as e:

console.print(f"[bold red]Error: {e}[/bold red]")

console.print(f"[dim]Use 'cgc registry list' to see available bundles[/dim]")

raise typer.Exit(code=1)

# Shortcut commands at root level

@app.command("export", rich_help_panel="Bundle Shortcuts")

def export_shortcut(

output: str = typer.Argument(..., help="Output path for the .cgc bundle file"),

repo: Optional[str] = typer.Option(None, "--repo", "-r", help="Specific repository path to export"),

no_stats: bool = typer.Option(False, "--no-stats", help="Skip generating statistics in the bundle"),

context: Optional[str] = typer.Option(None, "--context", "-c", help="Specific context to use"),

):

"""Shortcut for 'cgc bundle export'"""

bundle_export(output, repo, no_stats, context)

@app.command("load", rich_help_panel="Bundle Shortcuts")

def load_shortcut(

bundle_name: str = typer.Argument(..., help="Bundle name or path to load"),

clear: bool = typer.Option(False, "--clear", help="Clear existing graph data before loading")

):

"""Shortcut for 'cgc bundle load'"""

bundle_load(bundle_name, clear)

# ============================================================================

# REGISTRY COMMAND GROUP - Browse and Download Bundles

# ============================================================================

registry_app = typer.Typer(

help="Browse and download bundles from the registry",

invoke_without_command=True,

)

app.add_typer(registry_app, name="registry")

# Create API command group

api_app = typer.Typer(help="CGC Gateway (HTTP API) commands")

app.add_typer(api_app, name="api")

@api_app.command("start")

def api_start(

host: str = typer.Option("0.0.0.0", help="Host to bind the server to"),

port: int = typer.Option(8000, help="Port to bind the server to"),

reload: bool = typer.Option(False, help="Enable auto-reload (development only)"),

):

"""

Start the CGC Gateway HTTP API server.

This server provides a REST API that can be used by ChatGPT Actions,

Claude, or web frontends to interact with the CodeGraphContext graph.

"""

import uvicorn

console.print(f"[bold green]Starting CGC Gateway on {host}:{port}...[/bold green]")

_load_credentials()

uvicorn.run("codegraphcontext.api.app:app", host=host, port=port, reload=reload)

@registry_app.callback()

def registry_callback(ctx: typer.Context):

"""Browse and download bundles from the registry."""

if ctx.invoked_subcommand is None:

typer.echo(ctx.get_help())

@registry_app.command("list")

def registry_list(

verbose: bool = typer.Option(False, "--verbose", "-v", help="Show detailed information including download URLs"),

unique: bool = typer.Option(False, "--unique", "-u", help="Show only one version per package (most recent)")

):

"""

List all available bundles in the registry.

Shows bundles from both weekly pre-indexed releases and on-demand generations.

By default, shows all versions. Use --unique to see only the most recent version per package.

Examples:

cgc registry list

cgc registry list --verbose

cgc registry list --unique

"""

from .registry_commands import list_bundles

list_bundles(verbose=verbose, unique=unique)

@registry_app.command("search")

def registry_search(

query: str = typer.Argument(..., help="Search query (matches name, repository, or description)")

):

"""

Search for bundles in the registry.

Searches bundle names, repositories, and descriptions for matches.

Examples:

cgc registry search numpy

cgc registry search web

cgc registry search http

"""

from .registry_commands import search_bundles

search_bundles(query)

@registry_app.command("download")

def registry_download(

name: str = typer.Argument(..., help="Bundle name to download (e.g., 'numpy')"),

output_dir: Optional[str] = typer.Option(None, "--output", "-o", help="Output directory (default: current directory)"),

load: bool = typer.Option(False, "--load", "-l", help="Automatically load the bundle after downloading")

):

"""

Download a bundle from the registry.

Downloads the specified bundle to the current directory or specified output directory.

Use --load to automatically import the bundle after downloading.

Examples:

cgc registry download numpy

cgc registry download pandas --output ./bundles

cgc registry download fastapi --load

"""

from .registry_commands import download_bundle

bundle_path = download_bundle(name, output_dir, auto_load=load)

if load and bundle_path:

console.print(f"\n[cyan]Loading bundle...[/cyan]")

bundle_import(bundle_path, clear=False)

@registry_app.command("request")

def registry_request(

repo_url: str = typer.Argument(..., help="GitHub repository URL to index"),

wait: bool = typer.Option(False, "--wait", "-w", help="Wait for generation to complete (not yet implemented)")

):

"""

Request on-demand generation of a bundle.

Submits a request to generate a bundle for the specified GitHub repository.

The bundle will be available in the registry after 5-10 minutes.

Examples:

cgc registry request https://github.com/encode/httpx

cgc registry request https://github.com/pallets/flask

"""

from .registry_commands import request_bundle

request_bundle(repo_url, wait=wait)

# ============================================================================

# DOCTOR DIAGNOSTIC COMMAND

# ============================================================================

@app.command()

def doctor():

"""

Run diagnostics to check system health and configuration.

Checks:

- Configuration validity

- Database connectivity

- Tree-sitter installation

- Required dependencies

- File permissions

"""

console.print("[bold cyan]🏥 Running CodeGraphContext Diagnostics...[/bold cyan]\n")

all_checks_passed = True

config_manager.ensure_first_run_bootstrap()

config_manager.ensure_config_file()

# 1. Check configuration

console.print("[bold]1. Checking Configuration...[/bold]")

config = {}

try:

config = config_manager.load_config()

if config_manager.CONFIG_FILE.exists():

console.print(f" [green]✓[/green] Config loaded from {config_manager.CONFIG_FILE}")

else:

console.print(f" [yellow]ℹ[/yellow] No .env config found, using defaults")

console.print(f" [dim]Config will be created at: {config_manager.CONFIG_FILE}[/dim]")

if config_manager.CONTEXT_CONFIG_FILE.exists():

console.print(f" [green]✓[/green] Context config loaded from {config_manager.CONTEXT_CONFIG_FILE}")

else:

console.print(f" [yellow]ℹ[/yellow] No Context config found")

console.print(f" [dim]Context config will be auto-generated at: {config_manager.CONTEXT_CONFIG_FILE}[/dim]")

# Validate each config value

invalid_configs = []

for key, value in config.items():

is_valid, error_msg = config_manager.validate_config_value(key, value)

if not is_valid:

invalid_configs.append(f"{key}: {error_msg}")

if invalid_configs:

console.print(f" [red]✗[/red] Invalid configuration values found:")

for err in invalid_configs:

console.print(f" - {err}")

all_checks_passed = False

else:

console.print(f" [green]✓[/green] All configuration values are valid")

except Exception as e:

console.print(f" [red]✗[/red] Configuration error: {e}")

all_checks_passed = False

# 2. Check database connectivity

console.print("\n[bold]2. Checking Database Connection...[/bold]")

try:

_load_credentials()

default_db = os.environ.get("CGC_SELECTED_DATABASE") or config.get("DEFAULT_DATABASE", "falkordb")

db_source = os.environ.get("CGC_DB_SELECTION_SOURCE", "unknown")

console.print(f" Default database: {default_db} (source: {db_source})")

if default_db == "neo4j":

uri = os.environ.get("NEO4J_URI")

username = os.environ.get("NEO4J_USERNAME")

password = os.environ.get("NEO4J_PASSWORD")

database_name = os.environ.get("NEO4J_DATABASE")

missing = DatabaseManager.get_missing_credentials(uri, username, password)

console.print(f" [cyan]Credential check:[/cyan] {'OK' if not missing else 'Missing ' + ', '.join(missing)}")

if missing:

console.print(" [red]✗[/red] Neo4j credentials not configured")

console.print(" Run:")

console.print(" cgc config set NEO4J_URI bolt://localhost:7687")

console.print(" cgc config set NEO4J_USERNAME neo4j")

console.print(" cgc config set NEO4J_PASSWORD <your-password>")

all_checks_passed = False

else:

host, port = DatabaseManager.extract_host_port(uri)

console.print(f" [cyan]Endpoint:[/cyan] {host}:{port}")

is_reachable, reachability_msg = DatabaseManager.check_port_reachable(uri)

if is_reachable:

console.print(f" [green]✓[/green] Port {port} is reachable")