codigest 0.3.9__tar.gz → 0.4.0__tar.gz

{codigest-0.3.9 → codigest-0.4.0}/.github/workflows/publish.yml

@@ -25,7 +25,7 @@ jobs:
     
     # Python 3.14 설정 (uv 이용)
     - name: Set up Python
-      run: uv python install 3.14
+      run: uv python install 3.15
     
     # 의존성 설치 및 빌드 (uv build 하나로 해결)
     - name: Build package
@@ -48,7 +48,7 @@ jobs:
         uses: astral-sh/setup-uv@v5
 
       - name: Set up Python
-        run: uv python install 3.14
+        run: uv python install 3.15
 
       - name: Install Python and Sphinx dependencies
         run: |

codigest-0.4.0/.python-version

@@ -0,0 +1 @@
+3.15

codigest-0.4.0/CITATION.cff

@@ -0,0 +1,24 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+type: software
+title: "Codigest: codebase and terminal context manager for LLM-assisted development"
+abstract: >-
+  Command-line tool that extracts project snapshots, change-tracked diffs,
+  structural (semantic) diffs and captured terminal output as LLM-ready XML,
+  and serves them to AI agents over MCP.
+authors:
+  - family-names: Yong
+    given-names: Isaac
+    email: isaacyong@naver.com
+    affiliation: Sogang University
+repository-code: "https://github.com/NaNIsaac/codigest"
+url: "https://pypi.org/project/codigest/"
+license: MIT
+version: 0.4.0
+date-released: "2026-10-15"
+keywords:
+  - LLM
+  - developer tools
+  - code context
+  - MCP
+  - CLI

codigest-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Isaac Yong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{codigest-0.3.9 → codigest-0.4.0}/PKG-INFO

@@ -1,20 +1,21 @@
 Metadata-Version: 2.5
 Name: codigest
-Version: 0.3.9
+Version: 0.4.0
 Summary: Human-Centered Codebase Context Manager for LLMs
 Project-URL: Homepage, https://github.com/NaNIsaac/codigest
 Project-URL: Repository, https://github.com/NaNIsaac/codigest
 Project-URL: Issues, https://github.com/NaNIsaac/codigest/issues
-Author-email: Codigest Team <sngd024@google.com>
+Author-email: Isaac Yong <isaacyong@naver.com>
 License: MIT
+License-File: LICENSE
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
-Requires-Python: >=3.14
+Requires-Python: >=3.15
 Requires-Dist: loguru
 Requires-Dist: pathspec
 Requires-Dist: pyperclip
@@ -31,12 +32,24 @@ Unlike simple copy-paste tools, Codigest employs a **Context Anchor** system (Sh
 
 > **Note:** You can use the short alias **`cdg`** instead of `codigest` for faster typing.
 
+## Quickstart
+
+```bash
+uv tool install codigest
+
+cdg scan                  # whole project as LLM-ready XML (copied to clipboard)
+cdg init && cdg diff      # set an anchor, later get only what changed
+cdg cap -- pytest -q      # run a command and keep its output
+cdg term -f               # hand the last failed command + output to your LLM
+claude mcp add codigest -- cdg mcp   # let AI agents call all of the above
+```
+
 ## Core Philosophy
 
 * **Read-Only & Safe**: Codigest never modifies your source code. It only reads, analyzes, and formats context.
 * **Context-Aware**: Instead of dumping raw text, it structures code into XML snapshots designed for LLM comprehension.
 * **Session-Based Tracking**: It maintains an internal anchor to track "work-in-progress" changes independently of your Git commits.
-* **Environment Isolated**: Runs in its own isolated Python 3.14 environment via `uv`, ensuring it never conflicts with your project's dependencies.
+* **Environment Isolated**: Runs in its own isolated Python 3.15 environment via `uv`, ensuring it never conflicts with your project's dependencies.
 
 ## Installation
 
@@ -52,13 +65,12 @@ If you don't have `uv` installed, use **Winget** (Windows) or curl (macOS/Linux)
 winget install --id astral-sh.uv
 
 # macOS/Linux
-curl -LsSf [https://astral.sh/uv/install.sh](https://astral.sh/uv/install.sh) | sh
-
+curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
 ### Step 2: Install `codigest`
 
-Install Codigest globally. `uv` will automatically manage the required Python 3.14 environment for you.
+Install Codigest globally. `uv` will automatically manage the required Python 3.15 environment for you.
 
 ```bash
 uv tool install codigest
@@ -192,6 +204,57 @@ cdg clean
 cdg clean -y
 ```
 
+### 9. Terminal Capture & Recall (`cap`, `term`)
+
+Runs a command transparently (output still streams live) and records its command line, combined stdout/stderr, exit code and cwd in a machine-global store. `term` then recalls recent entries as a `<terminal_history>` block for your LLM. Works in any directory, no `cdg init` needed.
+
+* **Use Case:** "This test failed. Here's exactly what I ran and what it printed."
+* **Safety:** Known secret shapes (API keys, tokens, `password=...`) are redacted before anything touches disk. Output of credential commands (`env`, `printenv`, `gh auth token`, ...) is never stored.
+* **Fallback:** Commands not run through `cap` are read from the native shell history (PowerShell, bash, zsh, fish), without output.
+
+**Automatic capture (PowerShell):** `cdg term install` hooks your PowerShell profile so *every* command is captured without the `cap` prefix. Commands run in your current session (`cd`, variables and functions behave normally). Editors, pagers, REPLs and `ssh` are skipped automatically.
+
+* Skip one command: start the line with a space.
+* Skip more programs: `$env:CODIGEST_CAP_SKIP = '^\s*(myrepl|mytui)\b'`
+* Disable for a session: `$env:CODIGEST_NOCAP = 1`. Remove: `cdg term uninstall`.
+* Trade-off: captured programs write to a pipe, not a TTY, so some lose colors or progress bars.
+
+```bash
+cdg term install    # PowerShell: capture everything automatically
+
+# Run and capture (prefix with -- so flags reach the command)
+cdg cap -- pytest -q
+cdg cap "npm run build | tail -20"
+
+# Recall
+cdg term            # last command
+cdg term -n 3       # last 3 commands
+cdg term -i 2       # only the command from 2 runs ago
+cdg term -f         # last failed command
+
+cdg term path       # where captures are stored (override with CODIGEST_HOME)
+cdg term clear      # delete all captures
+```
+
+### 10. For AI Agents (`mcp`)
+
+`cdg mcp` serves Codigest as an [MCP](https://modelcontextprotocol.io) server over stdio, so coding agents can pull context themselves instead of asking you to paste it.
+
+| Tool | Returns |
+| --- | --- |
+| `terminal_history` | Recent commands with output and exit code (`count`, `failed`) |
+| `scan` | Project snapshot (`targets`, `resolve`, `message`) |
+| `diff` / `semdiff` | Text / structural changes since the anchor |
+| `digest` | Signatures and docstrings only |
+| `tree` | Directory tree |
+
+```bash
+# Claude Code
+claude mcp add --scope user codigest -- cdg mcp
+```
+
+Other clients (Cursor, VS Code, Claude Desktop): add a stdio server with command `cdg` and args `["mcp"]`.
+
 ---
 
 ## Configuration
@@ -231,4 +294,4 @@ Codigest maintains a hidden, lightweight Git repository inside `.codigest/anchor
 
 ## License
 
-MIT License
+MIT. See [LICENSE](LICENSE).

{codigest-0.3.9 → codigest-0.4.0}/README.md

@@ -6,12 +6,24 @@ Unlike simple copy-paste tools, Codigest employs a **Context Anchor** system (Sh
 
 > **Note:** You can use the short alias **`cdg`** instead of `codigest` for faster typing.
 
+## Quickstart
+
+```bash
+uv tool install codigest
+
+cdg scan                  # whole project as LLM-ready XML (copied to clipboard)
+cdg init && cdg diff      # set an anchor, later get only what changed
+cdg cap -- pytest -q      # run a command and keep its output
+cdg term -f               # hand the last failed command + output to your LLM
+claude mcp add codigest -- cdg mcp   # let AI agents call all of the above
+```
+
 ## Core Philosophy
 
 * **Read-Only & Safe**: Codigest never modifies your source code. It only reads, analyzes, and formats context.
 * **Context-Aware**: Instead of dumping raw text, it structures code into XML snapshots designed for LLM comprehension.
 * **Session-Based Tracking**: It maintains an internal anchor to track "work-in-progress" changes independently of your Git commits.
-* **Environment Isolated**: Runs in its own isolated Python 3.14 environment via `uv`, ensuring it never conflicts with your project's dependencies.
+* **Environment Isolated**: Runs in its own isolated Python 3.15 environment via `uv`, ensuring it never conflicts with your project's dependencies.
 
 ## Installation
 
@@ -27,13 +39,12 @@ If you don't have `uv` installed, use **Winget** (Windows) or curl (macOS/Linux)
 winget install --id astral-sh.uv
 
 # macOS/Linux
-curl -LsSf [https://astral.sh/uv/install.sh](https://astral.sh/uv/install.sh) | sh
-
+curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
 ### Step 2: Install `codigest`
 
-Install Codigest globally. `uv` will automatically manage the required Python 3.14 environment for you.
+Install Codigest globally. `uv` will automatically manage the required Python 3.15 environment for you.
 
 ```bash
 uv tool install codigest
@@ -167,6 +178,57 @@ cdg clean
 cdg clean -y
 ```
 
+### 9. Terminal Capture & Recall (`cap`, `term`)
+
+Runs a command transparently (output still streams live) and records its command line, combined stdout/stderr, exit code and cwd in a machine-global store. `term` then recalls recent entries as a `<terminal_history>` block for your LLM. Works in any directory, no `cdg init` needed.
+
+* **Use Case:** "This test failed. Here's exactly what I ran and what it printed."
+* **Safety:** Known secret shapes (API keys, tokens, `password=...`) are redacted before anything touches disk. Output of credential commands (`env`, `printenv`, `gh auth token`, ...) is never stored.
+* **Fallback:** Commands not run through `cap` are read from the native shell history (PowerShell, bash, zsh, fish), without output.
+
+**Automatic capture (PowerShell):** `cdg term install` hooks your PowerShell profile so *every* command is captured without the `cap` prefix. Commands run in your current session (`cd`, variables and functions behave normally). Editors, pagers, REPLs and `ssh` are skipped automatically.
+
+* Skip one command: start the line with a space.
+* Skip more programs: `$env:CODIGEST_CAP_SKIP = '^\s*(myrepl|mytui)\b'`
+* Disable for a session: `$env:CODIGEST_NOCAP = 1`. Remove: `cdg term uninstall`.
+* Trade-off: captured programs write to a pipe, not a TTY, so some lose colors or progress bars.
+
+```bash
+cdg term install    # PowerShell: capture everything automatically
+
+# Run and capture (prefix with -- so flags reach the command)
+cdg cap -- pytest -q
+cdg cap "npm run build | tail -20"
+
+# Recall
+cdg term            # last command
+cdg term -n 3       # last 3 commands
+cdg term -i 2       # only the command from 2 runs ago
+cdg term -f         # last failed command
+
+cdg term path       # where captures are stored (override with CODIGEST_HOME)
+cdg term clear      # delete all captures
+```
+
+### 10. For AI Agents (`mcp`)
+
+`cdg mcp` serves Codigest as an [MCP](https://modelcontextprotocol.io) server over stdio, so coding agents can pull context themselves instead of asking you to paste it.
+
+| Tool | Returns |
+| --- | --- |
+| `terminal_history` | Recent commands with output and exit code (`count`, `failed`) |
+| `scan` | Project snapshot (`targets`, `resolve`, `message`) |
+| `diff` / `semdiff` | Text / structural changes since the anchor |
+| `digest` | Signatures and docstrings only |
+| `tree` | Directory tree |
+
+```bash
+# Claude Code
+claude mcp add --scope user codigest -- cdg mcp
+```
+
+Other clients (Cursor, VS Code, Claude Desktop): add a stdio server with command `cdg` and args `["mcp"]`.
+
 ---
 
 ## Configuration
@@ -206,4 +268,4 @@ Codigest maintains a hidden, lightweight Git repository inside `.codigest/anchor
 
 ## License
 
-MIT License
+MIT. See [LICENSE](LICENSE).

{codigest-0.3.9 → codigest-0.4.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "codigest"
-version = "0.3.9"
+version = "0.4.0"
 description = "Human-Centered Codebase Context Manager for LLMs"
-authors = [{name = "Codigest Team", email = "sngd024@google.com"}]
+authors = [{ name = "Isaac Yong", email = "isaacyong@naver.com" }]
 readme = "README.md"
-requires-python = ">=3.14"
+requires-python = ">=3.15"
 license = { text = "MIT" }
 dependencies = [
     "typer",
@@ -17,7 +17,7 @@ dependencies = [
 
 classifiers = [
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Topic :: Software Development :: Libraries :: Python Modules",

codigest-0.4.0/src/codigest/commands/cap.py

@@ -0,0 +1,78 @@
+"""
+`cdg cap` -- run a command transparently and record it for later recall.
+
+Registered on the root app as a single command (not a Typer group), so the
+first word after `cap` is treated as the wrapped program rather than a
+subcommand. It declares no options of its own: everything after `cap` belongs
+to the wrapped command, so flags like `-n` are never stolen from it.
+"""
+from pathlib import Path
+from typing import Annotated
+
+import typer
+from rich.console import Console
+
+lazy from ..core import runner, termstore, shellhist
+
+err_console = Console(stderr=True)
+
+CONTEXT_SETTINGS = {
+    "allow_extra_args": True,
+    "ignore_unknown_options": True,
+}
+
+CommandArgument = Annotated[
+    list[str] | None,
+    typer.Argument(
+        metavar="COMMAND...",
+        help="Command to run. Prefix with `--` so its flags are passed through.",
+    ),
+]
+
+
+def handle(ctx: typer.Context, command: CommandArgument = None) -> None:
+    """
+    [Capture] Run a command, show its output as usual, and record it globally.
+
+    Examples:
+
+        cdg cap -- pytest -q
+
+        cdg cap "npm run build | tail -20"
+    """
+    args = [*(command or []), *ctx.args]
+
+    if not args:
+        err_console.print(
+            "[yellow]Usage:[/yellow] cdg cap -- <command>\n"
+            "[dim]Example: cdg cap -- pytest -q[/dim]"
+        )
+        raise typer.Exit(code=2)
+
+    command_text = runner.join_command(args)
+
+    try:
+        exit_code, output, duration_ms = runner.run(args)
+    except FileNotFoundError as e:
+        err_console.print(f"[red][Error][/red] Command not found: {args[0]}")
+        raise typer.Exit(code=127) from e
+    except RuntimeError as e:
+        err_console.print(f"[red][Error][/red] {e}")
+        raise typer.Exit(code=1) from e
+
+    entry = termstore.Entry(
+        command=command_text,
+        output=output,
+        exit_code=exit_code,
+        cwd=str(Path.cwd()),
+        shell=shellhist.detect_shell(),
+        started_at=termstore.now_iso(),
+        duration_ms=duration_ms,
+    )
+
+    try:
+        termstore.append_entry(entry)
+    except OSError as e:
+        err_console.print(f"[dim]⚠️ Capture not stored: {e}[/dim]")
+
+    raise typer.Exit(code=exit_code)

{codigest-0.3.9 → codigest-0.4.0}/src/codigest/commands/clean.py

@@ -1,9 +1,9 @@
-import typer
-import shutil
 from pathlib import Path
+
+import typer
 from rich.console import Console
 
-from ..core import common
+lazy from ..core import common
 
 app = typer.Typer()
 console = Console()
@@ -19,7 +19,7 @@ def handle(
         resolve_path=True
     ),
     yes: bool = typer.Option(False, "-y", "--yes", "-f", "--force", help="Skip confirmation prompt"),
-):
+) -> None:
     """
     [Cleanup] Removes the .codigest environment and clears all context anchors and artifacts.
     """
@@ -38,8 +38,8 @@ def handle(
             raise typer.Exit()
 
     try:
-        shutil.rmtree(codigest_dir)
+        common.remove_tree(codigest_dir)
         console.print(f"[bold green]✔ Successfully removed .codigest environment from {root_path}[/bold green]")
     except Exception as e:
         console.print(f"[bold red]Error removing .codigest:[/bold red] {e}")
-        raise typer.Exit(1)
+        raise typer.Exit(1) from e

{codigest-0.3.9 → codigest-0.4.0}/src/codigest/commands/diff.py

@@ -1,17 +1,19 @@
-import typer
 from pathlib import Path
-from rich.progress import Progress, SpinnerColumn, TextColumn
+
+import typer
 
 from ..options import CopyOption, StdoutOption, ResolveOption, MessageOption
-from ..core import prompts, shadow, tags, common
-from ..core.output import OutputHandler
+
+lazy from rich.progress import Progress, SpinnerColumn, TextColumn
+lazy from ..core import prompts, shadow, tags, common
+lazy from ..core.output import OutputHandler
 
 app = typer.Typer()
 
 @app.callback(invoke_without_command=True)
 def handle(
     target: Path = typer.Argument(
-        Path.cwd(), 
+        Path.cwd(),
         help="Target directory to check diff",
         exists=True,
         file_okay=False,
@@ -23,7 +25,7 @@ def handle(
     stdout: StdoutOption = False,
     message: MessageOption = "",
     resolve: ResolveOption = False,
-):
+) -> None:
     """
     [Context Update] Shows changes since the last 'codigest scan'.
     Useful for updating LLM context without re-uploading everything.
@@ -34,7 +36,7 @@ def handle(
     # [1] Context Setup
     ctx = common.get_context(target)
     root_path = ctx.root_path
-    
+
     anchor = shadow.ContextAnchor(root_path)
 
     # Check Baseline
@@ -84,7 +86,7 @@ def handle(
 
     # [4] Output
     log_console.print(f"[bold green]Changes Detected![/bold green] ({len(formatted_diff)} chars)")
-    
+
     def _save():
         if save:
             out_path = root_path / ".codigest" / "changes.diff"

{codigest-0.3.9 → codigest-0.4.0}/src/codigest/commands/digest.py

@@ -1,10 +1,12 @@
-import typer
 from pathlib import Path
-from rich.progress import Progress, SpinnerColumn, TextColumn
+
+import typer
 
 from ..options import CopyOption, StdoutOption, ResolveOption, MessageOption
-from ..core import structure, prompts, semdiff, tags, tokenizer, common, cache
-from ..core.output import OutputHandler
+
+lazy from rich.progress import Progress, SpinnerColumn, TextColumn
+lazy from ..core import structure, prompts, semdiff, tags, tokenizer, common, cache
+lazy from ..core.output import OutputHandler
 
 app = typer.Typer()
 
@@ -16,7 +18,7 @@ def handle(
     stdout: StdoutOption = False,
     message: MessageOption = "",
     resolve: ResolveOption = False,
-):
+) -> None:
     """
     [Architectural View] Summarizes the codebase structure (Classes/Functions only).
     """
@@ -26,7 +28,7 @@ def handle(
     # [1] Context Setup
     ctx = common.get_context(target)
     root_path = ctx.root_path
-    
+
     prompt_engine = prompts.get_engine(root_path)
 
     with Progress(
@@ -35,12 +37,12 @@ def handle(
         transient=True,
         console=log_console
     ) as progress:
-        
+
         task = progress.add_task("digest", total=None)
-        
+
         # [2] File Discovery via Context
         files = ctx.get_target_files(ignore_config=False, resolve_deps=resolve)
-        
+
         tree_str = structure.generate_ascii_tree(files, root_path)
 
         content_cache = cache.ContentCache(root_path)
@@ -72,7 +74,7 @@ def handle(
         content_cache.save()
 
         summary_blob = "\n".join(summary_blocks)
-        
+
         try:
             digest_content = prompt_engine.render(
                 "digest",
@@ -83,13 +85,13 @@ def handle(
             )
         except Exception as e:
             log_console.print(f"[red]❌ Rendering Failed:[/red] {e}")
-            raise typer.Exit(1)
-            
+            raise typer.Exit(1) from e
+
         progress.update(task, completed=100)
 
     token_count = tokenizer.estimate_tokens(digest_content)
     log_console.print(f"[bold green]Digest Generated![/bold green] ([bold cyan]~{token_count:,} Tokens[/bold cyan])")
-    
+
     def _save():
         if save:
             out_path = root_path / ".codigest" / "digest.txt"

{codigest-0.3.9 → codigest-0.4.0}/src/codigest/commands/init.py

@@ -1,9 +1,10 @@
-import typer
 from pathlib import Path
+
+import typer
 from rich.console import Console
-from rich.panel import Panel
 
-from ..core import scanner, shadow
+lazy from rich.panel import Panel
+lazy from ..core import scanner, shadow
 
 app = typer.Typer()
 console = Console()
@@ -13,7 +14,7 @@ DEFAULT_CONFIG = """# Codigest Configuration File
 description = "Auto-generated context configuration"
 
 [filter]
-max_file_size_kb = 100 
+max_file_size_kb = 100
 extensions = [
     ".py", ".pyi",
     ".ts", ".tsx", ".js", ".jsx",
@@ -37,7 +38,7 @@ structure = "toon"
 def handle(
     # target 인자 추가 (기본값: 현재 위치)
     target: Path = typer.Argument(
-        Path.cwd(), 
+        Path.cwd(),
         help="Target directory to initialize",
         exists=True,
         file_okay=False,
@@ -45,12 +46,12 @@ def handle(
         resolve_path=True
     ),
     force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing config"),
-):
+) -> None:
     """
     Initialize the .codigest environment and capture the initial state.
     """
     root_path = target  # Typer가 이미 resolve_path=True로 절대경로 변환해줌
-    
+
     config_dir = root_path / ".codigest"
     config_file = config_dir / "config.toml"
     gitignore_file = root_path / ".gitignore"
@@ -61,7 +62,7 @@ def handle(
     if not config_dir.exists():
         config_dir.mkdir()
         console.print("  [green]✔[/green] Created [bold].codigest/[/bold] directory")
-    
+
     if not config_file.exists() or force:
         config_file.write_text(DEFAULT_CONFIG, encoding="utf-8")
         console.print("  [green]✔[/green] Created [bold]config.toml[/bold]")
@@ -75,22 +76,22 @@ def handle(
     console.print("\n[dim]Creating initial context anchor...[/dim]")
     try:
         # Default scan settings for initialization
-        files = scanner.scan_project(root_path) 
+        files = scanner.scan_project(root_path)
         anchor = shadow.ContextAnchor(root_path)
         anchor.update(files)
         console.print("  [green]✔[/green] Baseline snapshot captured.")
     except Exception as e:
         console.print(f"  [red]⚠️ Failed to create initial anchor: {e}[/red]")
 
-    console.print("\n[bold green]✨ Ready to digest![/bold green]") 
+    console.print("\n[bold green]✨ Ready to digest![/bold green]")
     console.print("Try running: [cyan]codigest diff[/cyan] to see changes from now on.")
 
-def _update_gitignore(path: Path):
+def _update_gitignore(path: Path) -> None:
     entry = ".codigest/"
     if not path.exists():
         path.write_text(f"# Git Ignore\n{entry}\n", encoding="utf-8")
         return
-    
+
     if entry not in path.read_text(encoding="utf-8"):
         with path.open("a", encoding="utf-8") as f:
             f.write(f"\n{entry}\n")