ctxgraph-code 0.1.0__tar.gz → 0.1.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.1.0
+Version: 0.1.2
 Summary: Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions.
 Author: ctxgraph-code contributors
 License: MIT
@@ -70,11 +70,21 @@ ctxgraph-code setup
 ctxgraph-code setup
 ```
 
+Interactive walkthrough — prompts for:
+- **File extensions** to scan (`.py`, `.js`, `.ts`, etc.)
+- **Exclude patterns** (folders like `tests/`, globs like `*.generated.py`)
+
 Does everything in one step:
-1. Creates `.ctxgraph/config.toml` with defaults
-2. Builds the knowledge graph from all Python files
+1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
+2. Builds the knowledge graph from all matching files
 3. Creates `.claude/commands/ctxgraph-code.md` with instructions for Claude Code
 
+Non-interactive mode (skip prompts):
+```bash
+ctxgraph-code setup --extensions .py,.js,.ts --exclude tests/,examples/
+ctxgraph-code setup -y                                 # all defaults
+```
+
 ### `init`
 
 ```bash
@@ -87,10 +97,12 @@ Creates the `.ctxgraph/` directory with a default `config.toml`.
 
 ```bash
 ctxgraph-code build
-ctxgraph-code build --exclude "tests/" --exclude "*.generated.py"
+ctxgraph-code build --extensions .py,.js,.ts
+ctxgraph-code build --exclude tests/ --exclude *.generated.py
 ```
 
-Scans all `*.py` files in the project, runs AST analysis:
+Scans all matching files in the project, runs AST analysis. Extensions are read from config (`.py` by default, or whatever was set in `setup`).
+
 - **Imports**: which files import other files
 - **Class definitions**: class names, base classes, methods
 - **Function definitions**: function names, arguments
@@ -99,6 +111,8 @@ Scans all `*.py` files in the project, runs AST analysis:
 
 Stores the result in `.ctxgraph/graph.db`.
 
+> The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Claude Code will also rebuild when it detects the graph is stale.
+
 ### `query`
 
 ```bash
@@ -148,6 +162,17 @@ ctxgraph-code context "add pagination to the users endpoint"
 
 Generates a focused context summary: relevant files, their symbols, and dependency/call edges between them. This is the closest equivalent to `ctxgraph`'s capsule format.
 
+### `view`
+
+```bash
+ctxgraph-code view
+ctxgraph-code view --output tree.txt
+```
+
+Prints a hierarchical directory tree from the graph showing every file and its symbols (classes marked `[C]`, functions/methods marked `[M]`). Also lists import and call edges at the bottom.
+
+Useful for a quick visual scan of the project structure without reading every file.
+
 ### `info`
 
 ```bash
@@ -234,11 +259,13 @@ Claude then uses these commands as needed during the conversation.
 
 ## Configuration
 
-Configure via `.ctxgraph/config.toml` (created by `init` or `setup`):
+Configure via `.ctxgraph/config.toml` (created interactively by `setup` or manually):
 
 ```toml
 [graph]
-# Additional exclude patterns beyond defaults
+# File extensions to scan
+extensions = [".py", ".js", ".ts"]
+# Exclude patterns beyond built-in defaults
 exclude = ["tests/", "examples/"]
 # Follow symlinks when scanning
 follow_symlinks = false
@@ -246,7 +273,7 @@ follow_symlinks = false
 max_file_size_mb = 5
 ```
 
-Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
+Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
 
 ---
 
@@ -256,10 +283,10 @@ Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `ven
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 8 (init, build, query, deps, usedby, overview, symbols, context, setup, info) |
+| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 9 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
-| Visualizer | D3.js HTML + SVG | No |
+| Visualizer | D3.js HTML + SVG | Text tree (`view` command) |
 | Skills system | Yes (customizable skill TOML files) | No |
 | MCP server | Yes | No |
 | Token savings | Yes (capsule DSL compression) | No |

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.2}/README.md

@@ -47,11 +47,21 @@ ctxgraph-code setup
 ctxgraph-code setup
 ```
 
+Interactive walkthrough — prompts for:
+- **File extensions** to scan (`.py`, `.js`, `.ts`, etc.)
+- **Exclude patterns** (folders like `tests/`, globs like `*.generated.py`)
+
 Does everything in one step:
-1. Creates `.ctxgraph/config.toml` with defaults
-2. Builds the knowledge graph from all Python files
+1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
+2. Builds the knowledge graph from all matching files
 3. Creates `.claude/commands/ctxgraph-code.md` with instructions for Claude Code
 
+Non-interactive mode (skip prompts):
+```bash
+ctxgraph-code setup --extensions .py,.js,.ts --exclude tests/,examples/
+ctxgraph-code setup -y                                 # all defaults
+```
+
 ### `init`
 
 ```bash
@@ -64,10 +74,12 @@ Creates the `.ctxgraph/` directory with a default `config.toml`.
 
 ```bash
 ctxgraph-code build
-ctxgraph-code build --exclude "tests/" --exclude "*.generated.py"
+ctxgraph-code build --extensions .py,.js,.ts
+ctxgraph-code build --exclude tests/ --exclude *.generated.py
 ```
 
-Scans all `*.py` files in the project, runs AST analysis:
+Scans all matching files in the project, runs AST analysis. Extensions are read from config (`.py` by default, or whatever was set in `setup`).
+
 - **Imports**: which files import other files
 - **Class definitions**: class names, base classes, methods
 - **Function definitions**: function names, arguments
@@ -76,6 +88,8 @@ Scans all `*.py` files in the project, runs AST analysis:
 
 Stores the result in `.ctxgraph/graph.db`.
 
+> The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Claude Code will also rebuild when it detects the graph is stale.
+
 ### `query`
 
 ```bash
@@ -125,6 +139,17 @@ ctxgraph-code context "add pagination to the users endpoint"
 
 Generates a focused context summary: relevant files, their symbols, and dependency/call edges between them. This is the closest equivalent to `ctxgraph`'s capsule format.
 
+### `view`
+
+```bash
+ctxgraph-code view
+ctxgraph-code view --output tree.txt
+```
+
+Prints a hierarchical directory tree from the graph showing every file and its symbols (classes marked `[C]`, functions/methods marked `[M]`). Also lists import and call edges at the bottom.
+
+Useful for a quick visual scan of the project structure without reading every file.
+
 ### `info`
 
 ```bash
@@ -211,11 +236,13 @@ Claude then uses these commands as needed during the conversation.
 
 ## Configuration
 
-Configure via `.ctxgraph/config.toml` (created by `init` or `setup`):
+Configure via `.ctxgraph/config.toml` (created interactively by `setup` or manually):
 
 ```toml
 [graph]
-# Additional exclude patterns beyond defaults
+# File extensions to scan
+extensions = [".py", ".js", ".ts"]
+# Exclude patterns beyond built-in defaults
 exclude = ["tests/", "examples/"]
 # Follow symlinks when scanning
 follow_symlinks = false
@@ -223,7 +250,7 @@ follow_symlinks = false
 max_file_size_mb = 5
 ```
 
-Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
+Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
 
 ---
 
@@ -233,10 +260,10 @@ Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `ven
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 8 (init, build, query, deps, usedby, overview, symbols, context, setup, info) |
+| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 9 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
-| Visualizer | D3.js HTML + SVG | No |
+| Visualizer | D3.js HTML + SVG | Text tree (`view` command) |
 | Skills system | Yes (customizable skill TOML files) | No |
 | MCP server | Yes | No |
 | Token savings | Yes (capsule DSL compression) | No |

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ctxgraph-code"
-version = "0.1.0"
+version = "0.1.2"
 description = "Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions."
 readme = "README.md"
 license = {text = "MIT"}

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.2}/src/ctxgraph_code/cli.py

@@ -17,6 +17,7 @@ from ctxgraph_code.render import (
     render_deps,
     render_overview,
     render_symbols,
+    render_treeview,
     render_usedby,
 )
 
@@ -24,11 +25,25 @@ app = typer.Typer(name="ctxgraph-code", help="Code knowledge graph for Claude Co
 console = Console()
 
 
+def _build_time_label(storage) -> str:
+    ts = storage.get_metadata("build_time")
+    if ts:
+        try:
+            from datetime import datetime
+            dt = datetime.fromtimestamp(float(ts))
+            return dt.strftime("%Y-%m-%d %H:%M")
+        except Exception:
+            return ts
+    return "unknown"
+
+
 SLASH_COMMAND_TEMPLATE = """# ctxgraph-code: Code Relationship Graph
 
 This project has a knowledge graph at `.ctxgraph/graph.db`.
 The graph knows about imports, class hierarchies, and function calls.
 
+**Last build:** {build_time}
+
 **Available commands** (run these as shell commands in the terminal):
 
 - `ctxgraph-code query "search terms"` -- Find relevant files, classes, and functions
@@ -43,6 +58,9 @@ The graph knows about imports, class hierarchies, and function calls.
 - When exploring an unfamiliar area, run `query` to find relevant files, then read them.
 - When asked about architecture, run `overview` for the big picture.
 - For complex tasks, run `context "what I need to do"` for a focused summary.
+
+**Note:** The graph is a static snapshot. If files have changed since the last build,
+run `ctxgraph-code build` to refresh it.
 """
 
 
@@ -70,11 +88,14 @@ def build(
     repo_path: Optional[str] = typer.Argument(
         None, help="Path to repository (default: current directory)"
     ),
+    extensions: Optional[str] = typer.Option(
+        None, "--extensions", help="File extensions to scan, e.g. .py,.js,.ts"
+    ),
     exclude: Optional[list[str]] = typer.Option(
         None, "--exclude", "-e", help="Additional exclude patterns"
     ),
 ):
-    """Build the knowledge graph from Python source files."""
+    """Build the knowledge graph from source files."""
     path = Path(repo_path).resolve() if repo_path else Path.cwd()
 
     settings = Settings(path)
@@ -82,11 +103,16 @@ def build(
     if exclude:
         user_patterns = list((user_patterns or []) + exclude)
 
+    exts = settings.extensions
+    if extensions:
+        exts = [e.strip() for e in extensions.split(",") if e.strip()]
+
     if not (path / ".ctxgraph").exists():
         (path / ".ctxgraph").mkdir(parents=True, exist_ok=True)
 
-    with console.status(f"Analyzing {path}..."):
-        stats = build_graph(path, exclude_patterns=user_patterns)
+    ext_label = ", ".join(exts)
+    with console.status(f"Scanning {ext_label} files in {path}..."):
+        stats = build_graph(path, exclude_patterns=user_patterns, extensions=exts)
 
     table = Table(title="Graph Build Complete")
     table.add_column("Metric", style="cyan")
@@ -247,16 +273,52 @@ def setup(
     repo_path: Optional[str] = typer.Argument(
         None, help="Path to repository (default: current directory)"
     ),
+    extensions: Optional[str] = typer.Option(
+        None, "--extensions", help="File extensions to scan, e.g. .py,.js,.ts"
+    ),
+    exclude: Optional[str] = typer.Option(
+        None, "--exclude", help="Exclude patterns, e.g. tests/,examples/"
+    ),
+    non_interactive: bool = typer.Option(
+        False, "--yes", "-y", help="Skip prompts, use defaults"
+    ),
 ):
-    """Initialize config, build the graph, and configure Claude Code integration."""
+    """Initialize config, build the graph, and configure Claude Code."""
     path = Path(repo_path).resolve() if repo_path else Path.cwd()
 
-    init_project(path)
+    if non_interactive:
+        exts = [".py"]
+        excl = []
+    elif extensions:
+        exts = [e.strip() for e in extensions.split(",") if e.strip()]
+        excl = [e.strip() for e in exclude.split(",") if e.strip()] if exclude else []
+    else:
+        console.print("[bold cyan]ctxgraph-code setup[/bold cyan]")
+        console.print("Let's configure your project graph.\n")
+
+        ext_input = typer.prompt(
+            "File extensions to scan (comma-separated)",
+            default=".py",
+            prompt_suffix=": ",
+        )
+        exts = [e.strip() for e in ext_input.split(",") if e.strip()]
+        if not exts:
+            exts = [".py"]
+
+        excl_input = typer.prompt(
+            "Exclude patterns (comma-separated, e.g. tests/,examples/)",
+            default="",
+            prompt_suffix=": ",
+        )
+        excl = [e.strip() for e in excl_input.split(",") if e.strip()] if excl_input.strip() else []
+
+        console.print()
+
+    init_project(path, extensions=exts, exclude_patterns=excl)
     console.print(f"[green][OK] Initialized .ctxgraph/[/green]")
 
-    settings = Settings(path)
-    with console.status(f"Building graph for {path}..."):
-        stats = build_graph(path, exclude_patterns=settings.exclude_patterns)
+    with console.status(f"Scanning {', '.join(exts)} files in {path}..."):
+        stats = build_graph(path, exclude_patterns=excl, extensions=exts)
 
     table = Table(title="Graph Build Complete")
     table.add_column("Metric", style="cyan")
@@ -273,8 +335,13 @@ def setup(
     claude_dir = path / ".claude" / "commands"
     claude_dir.mkdir(parents=True, exist_ok=True)
     slash_path = claude_dir / "ctxgraph-code.md"
+
+    storage = get_storage(path)
+    build_label = _build_time_label(storage) if storage else "unknown"
+    content = SLASH_COMMAND_TEMPLATE.format(build_time=build_label)
+
     if not slash_path.exists():
-        slash_path.write_text(SLASH_COMMAND_TEMPLATE, encoding="utf-8")
+        slash_path.write_text(content, encoding="utf-8")
         console.print(f"[green][OK] Created {slash_path}[/green]")
     else:
         console.print(f"[yellow]  Skipped (already exists): {slash_path}[/yellow]")
@@ -284,6 +351,33 @@ def setup(
     console.print("Open Claude Code in this project and type [bold]/ctxgraph-code[/bold] to get started.")
 
 
+@app.command()
+def view(
+    repo_path: Optional[str] = typer.Option(
+        None, "--repo", "-r", help="Repository path"
+    ),
+    output: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Save tree to file"
+    ),
+):
+    """Visualize the graph as a directory tree with symbols and edges."""
+    path = Path(repo_path).resolve() if repo_path else Path.cwd()
+
+    storage = get_storage(path)
+    if storage is None:
+        console.print("[red]No graph found. Run [bold]ctxgraph-code build[/bold] first.[/red]")
+        raise typer.Exit(1)
+
+    tree = render_treeview(storage)
+
+    if output:
+        out_path = Path(output)
+        out_path.write_text(tree, encoding="utf-8")
+        console.print(f"Saved tree to [bold]{out_path}[/bold]")
+    else:
+        console.print(tree)
+
+
 @app.command()
 def info(
     repo_path: Optional[str] = typer.Option(
@@ -329,7 +423,7 @@ def version():
     try:
         ver = _v("ctxgraph-code")
     except Exception:
-        ver = "0.1.0"
+        ver = "0.1.2"
     console.print(f"ctxgraph-code version [bold]{ver}[/bold]")
 
 

ctxgraph_code-0.1.2/src/ctxgraph_code/config/init.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+from ctxgraph_code.config.settings import create_default_config
+
+
+def init_project(
+    repo_path: Path,
+    extensions: Optional[list[str]] = None,
+    exclude_patterns: Optional[list[str]] = None,
+) -> Path:
+    cfg_dir = repo_path / ".ctxgraph"
+    cfg_dir.mkdir(parents=True, exist_ok=True)
+
+    create_default_config(repo_path, extensions=extensions, exclude_patterns=exclude_patterns)
+
+    return cfg_dir

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.2}/src/ctxgraph_code/config/settings.py

@@ -8,6 +8,7 @@ from typing import Optional
 
 DEFAULT_CONFIG = {
     "graph": {
+        "extensions": [".py"],
         "exclude": [],
         "follow_symlinks": False,
         "max_file_size_mb": 5,
@@ -43,6 +44,11 @@ class Settings:
             parsed = self._parse_toml(text)
             self._deep_merge(self._data, parsed)
 
+    @property
+    def extensions(self) -> list[str]:
+        exts = self._data["graph"].get("extensions", [".py"])
+        return [e if e.startswith(".") else f".{e}" for e in exts]
+
     @property
     def exclude_patterns(self) -> list[str]:
         return self._data["graph"].get("exclude", [])
@@ -67,8 +73,10 @@ class Settings:
                 key = key.strip()
                 value = value.strip()
 
-                if (value.startswith('"') and value.endswith('"')) or \
-                   (value.startswith("'") and value.endswith("'")):
+                if value.startswith("[") and value.endswith("]"):
+                    value = Settings._parse_toml_array(value)
+                elif (value.startswith('"') and value.endswith('"')) or \
+                     (value.startswith("'") and value.endswith("'")):
                     value = value[1:-1]
                 else:
                     value = Settings._parse_toml_value(value)
@@ -77,6 +85,21 @@ class Settings:
 
         return result
 
+    @staticmethod
+    def _parse_toml_array(text: str) -> list:
+        inner = text[1:-1].strip()
+        if not inner:
+            return []
+        items = []
+        for item in inner.split(","):
+            item = item.strip()
+            if (item.startswith('"') and item.endswith('"')) or \
+               (item.startswith("'") and item.endswith("'")):
+                items.append(item[1:-1])
+            else:
+                items.append(Settings._parse_toml_value(item))
+        return items
+
     @staticmethod
     def _parse_toml_value(value: str):
         if value.lower() in ("true", "false"):
@@ -97,7 +120,11 @@ class Settings:
                 base[key] = value
 
 
-def create_default_config(repo_path: Path):
+def create_default_config(
+    repo_path: Path,
+    extensions: Optional[list[str]] = None,
+    exclude_patterns: Optional[list[str]] = None,
+):
     config_dir = repo_path / ".ctxgraph"
     config_dir.mkdir(parents=True, exist_ok=True)
 
@@ -105,12 +132,20 @@ def create_default_config(repo_path: Path):
     if config_path.exists():
         return
 
+    ext_list = extensions or [".py"]
+    ext_line = ", ".join(f'"{e}"' for e in ext_list)
+
+    excl_list = exclude_patterns or []
+    excl_line = ", ".join(f'"{e}"' for e in excl_list) if excl_list else ""
+
     config_path.write_text(
-        """# ctxgraph-code configuration
+        f"""# ctxgraph-code configuration
 
 [graph]
-# Additional exclude patterns (gitignore is used automatically)
-exclude = []
+# File extensions to scan
+extensions = [{ext_line}]
+# Exclude patterns (gitignore patterns are excluded automatically)
+exclude = [{excl_line}]
 # Follow symlinks when scanning files
 follow_symlinks = false
 # Skip files larger than this many MB

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.2}/src/ctxgraph_code/graph/builder.py

@@ -16,6 +16,7 @@ def build_graph(
     repo_path: str | Path,
     db_path: Optional[str | Path] = None,
     exclude_patterns: Optional[list[str]] = None,
+    extensions: Optional[list[str]] = None,
 ) -> dict:
     repo_path = Path(repo_path).resolve()
     if db_path is None:
@@ -29,8 +30,9 @@ def build_graph(
     combined = Graph()
     stats = {"files_analyzed": 0, "files_skipped": 0, "errors": 0}
 
-    python_files = list(repo_path.rglob("*.py"))
-    for file_path in python_files:
+    exts = set(extensions or [".py"])
+    scan_files = [f for f in repo_path.rglob("*") if f.suffix in exts and f.is_file()]
+    for file_path in scan_files:
         if should_exclude(file_path, repo_path, exclude_patterns):
             stats["files_skipped"] += 1
             continue

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.2}/src/ctxgraph_code/render.py

@@ -235,6 +235,107 @@ def render_context(storage: Storage, query: str, max_nodes: int = 15) -> str:
     return "\n".join(lines)
 
 
+def render_treeview(storage: Storage) -> str:
+    all_nodes = storage.get_all_nodes()
+    all_edges = storage.get_all_edges()
+
+    file_nodes = sorted([n for n in all_nodes if n.type == "file"], key=lambda n: n.path or "")
+    symbol_map: dict[str, list[Node]] = {}
+    for n in all_nodes:
+        if n.type != "file":
+            symbol_map.setdefault(n.parent_id or "", []).append(n)
+
+    dir_tree: dict[str, dict] = {}
+    for node in file_nodes:
+        parts = (node.path or node.name).split("/")
+        for i in range(len(parts)):
+            parent = "/".join(parts[:i]) if i > 0 else "."
+            child = parts[i]
+            if parent not in dir_tree:
+                dir_tree[parent] = {"dirs": set(), "files": []}
+            if i == len(parts) - 1:
+                dir_tree[parent]["files"].append(node)
+            else:
+                dir_tree[parent]["dirs"].add(child)
+
+    stats = storage.stats()
+    bt = storage.get_metadata("build_time")
+    build_label = ""
+    if bt:
+        try:
+            from datetime import datetime
+            build_label = f" (built {datetime.fromtimestamp(float(bt)).strftime('%Y-%m-%d %H:%M')})"
+        except Exception:
+            pass
+
+    lines = [
+        f".ctxgraph/graph.db  ({stats['nodes']} nodes, {stats['edges']} edges){build_label}",
+        "",
+    ]
+
+    def _render_dir(parent: str, prefix: str = ""):
+        entry = dir_tree.get(parent, {"dirs": set(), "files": []})
+        items: list[tuple[str, object]] = []
+        for d in sorted(entry["dirs"]):
+            items.append(("dir", d))
+        for f in sorted(entry["files"], key=lambda x: x.path or x.name):
+            items.append(("file", f))
+
+        for idx, (kind, obj) in enumerate(items):
+            last = idx == len(items) - 1
+            connector = "\\-- " if last else "+-- "
+            ext = "    " if last else "|   "
+
+            if kind == "dir":
+                name = str(obj)
+                lines.append(f"{prefix}{connector}{name}/")
+                child = name if parent == "." else parent + "/" + name
+                _render_dir(child, prefix + ext)
+            else:
+                node = obj
+                basename = (node.path or node.name).split("/")[-1]
+                lines.append(f"{prefix}{connector}{basename}")
+                symbols = sorted(symbol_map.get(node.id, []), key=lambda s: s.lineno)
+                if symbols:
+                    sym_lines = []
+                    for s in symbols:
+                        tag = "C" if s.type == "class" else "M"
+                        summary = f" -- {s.summary}" if s.summary else ""
+                        sym_lines.append(f"    [{tag}] {s.name}{summary}")
+                    for sidx, sl in enumerate(sym_lines):
+                        slast = sidx == len(sym_lines) - 1
+                        sconn = "\\-- " if slast else "+-- "
+                        lines.append(f"{prefix}{ext}{sconn}{sl}")
+
+    _render_dir(".")
+    lines.append("")
+
+    import_edges = [(s, t) for e in all_edges for s, t, r in [(e.source_id, e.target_id, e.relation)] if r == "imports"]
+    call_edges = [(s, t) for e in all_edges for s, t, r in [(e.source_id, e.target_id, e.relation)] if r == "calls"]
+
+    if import_edges:
+        lines.append(f"Imports ({len(import_edges)}):")
+        node_map = {n.id: n for n in all_nodes}
+        for src, tgt in sorted(import_edges, key=lambda x: (x[0], x[1]))[:20]:
+            sn = _short_name(src, node_map) or src
+            tn = _short_name(tgt, node_map) or tgt
+            lines.append(f"  {sn}  ->  {tn}")
+        if len(import_edges) > 20:
+            lines.append(f"  ... and {len(import_edges) - 20} more")
+
+    if call_edges:
+        lines.append(f"\nCalls ({len(call_edges)}):")
+        node_map = {n.id: n for n in all_nodes}
+        for src, tgt in sorted(call_edges, key=lambda x: (x[0], x[1]))[:15]:
+            sn = _short_name(src, node_map) or src
+            tn = _short_name(tgt, node_map) or tgt
+            lines.append(f"  {sn}  ->  {tn}")
+        if len(call_edges) > 15:
+            lines.append(f"  ... and {len(call_edges) - 15} more")
+
+    return "\n".join(lines)
+
+
 def _short_name(node_id: str, node_map: dict[str, Node]) -> Optional[str]:
     if node_id in node_map:
         n = node_map[node_id]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.1.0
+Version: 0.1.2
 Summary: Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions.
 Author: ctxgraph-code contributors
 License: MIT
@@ -70,11 +70,21 @@ ctxgraph-code setup
 ctxgraph-code setup
 ```
 
+Interactive walkthrough — prompts for:
+- **File extensions** to scan (`.py`, `.js`, `.ts`, etc.)
+- **Exclude patterns** (folders like `tests/`, globs like `*.generated.py`)
+
 Does everything in one step:
-1. Creates `.ctxgraph/config.toml` with defaults
-2. Builds the knowledge graph from all Python files
+1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
+2. Builds the knowledge graph from all matching files
 3. Creates `.claude/commands/ctxgraph-code.md` with instructions for Claude Code
 
+Non-interactive mode (skip prompts):
+```bash
+ctxgraph-code setup --extensions .py,.js,.ts --exclude tests/,examples/
+ctxgraph-code setup -y                                 # all defaults
+```
+
 ### `init`
 
 ```bash
@@ -87,10 +97,12 @@ Creates the `.ctxgraph/` directory with a default `config.toml`.
 
 ```bash
 ctxgraph-code build
-ctxgraph-code build --exclude "tests/" --exclude "*.generated.py"
+ctxgraph-code build --extensions .py,.js,.ts
+ctxgraph-code build --exclude tests/ --exclude *.generated.py
 ```
 
-Scans all `*.py` files in the project, runs AST analysis:
+Scans all matching files in the project, runs AST analysis. Extensions are read from config (`.py` by default, or whatever was set in `setup`).
+
 - **Imports**: which files import other files
 - **Class definitions**: class names, base classes, methods
 - **Function definitions**: function names, arguments
@@ -99,6 +111,8 @@ Scans all `*.py` files in the project, runs AST analysis:
 
 Stores the result in `.ctxgraph/graph.db`.
 
+> The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Claude Code will also rebuild when it detects the graph is stale.
+
 ### `query`
 
 ```bash
@@ -148,6 +162,17 @@ ctxgraph-code context "add pagination to the users endpoint"
 
 Generates a focused context summary: relevant files, their symbols, and dependency/call edges between them. This is the closest equivalent to `ctxgraph`'s capsule format.
 
+### `view`
+
+```bash
+ctxgraph-code view
+ctxgraph-code view --output tree.txt
+```
+
+Prints a hierarchical directory tree from the graph showing every file and its symbols (classes marked `[C]`, functions/methods marked `[M]`). Also lists import and call edges at the bottom.
+
+Useful for a quick visual scan of the project structure without reading every file.
+
 ### `info`
 
 ```bash
@@ -234,11 +259,13 @@ Claude then uses these commands as needed during the conversation.
 
 ## Configuration
 
-Configure via `.ctxgraph/config.toml` (created by `init` or `setup`):
+Configure via `.ctxgraph/config.toml` (created interactively by `setup` or manually):
 
 ```toml
 [graph]
-# Additional exclude patterns beyond defaults
+# File extensions to scan
+extensions = [".py", ".js", ".ts"]
+# Exclude patterns beyond built-in defaults
 exclude = ["tests/", "examples/"]
 # Follow symlinks when scanning
 follow_symlinks = false
@@ -246,7 +273,7 @@ follow_symlinks = false
 max_file_size_mb = 5
 ```
 
-Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
+Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
 
 ---
 
@@ -256,10 +283,10 @@ Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `ven
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 8 (init, build, query, deps, usedby, overview, symbols, context, setup, info) |
+| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 9 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
-| Visualizer | D3.js HTML + SVG | No |
+| Visualizer | D3.js HTML + SVG | Text tree (`view` command) |
 | Skills system | Yes (customizable skill TOML files) | No |
 | MCP server | Yes | No |
 | Token savings | Yes (capsule DSL compression) | No |

ctxgraph_code-0.1.0/src/ctxgraph_code/config/init.py

@@ -1,14 +0,0 @@
-from __future__ import annotations
-
-from pathlib import Path
-
-from ctxgraph_code.config.settings import create_default_config
-
-
-def init_project(repo_path: Path) -> Path:
-    cfg_dir = repo_path / ".ctxgraph"
-    cfg_dir.mkdir(parents=True, exist_ok=True)
-
-    create_default_config(repo_path)
-
-    return cfg_dir