gitcortex 0.3.0__py3-none-macosx_11_0_arm64.whl

gitcortex/__init__.py

@@ -0,0 +1,24 @@
+__version__ = "0.3.0"
+
+import os
+import stat
+import subprocess
+import sys
+
+
+def _binary_path() -> str:
+    bin_name = "gcx.exe" if sys.platform == "win32" else "gcx"
+    return os.path.join(os.path.dirname(__file__), "_bin", bin_name)
+
+
+def main() -> None:
+    binary = _binary_path()
+    if not os.path.isfile(binary):
+        sys.exit(
+            f"gcx binary not found at {binary}.\n"
+            "Try reinstalling: pip install --force-reinstall gitcortex"
+        )
+    # Ensure the binary is executable (wheels may not preserve the bit)
+    current = os.stat(binary).st_mode
+    os.chmod(binary, current | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+    sys.exit(subprocess.call([binary] + sys.argv[1:]))

gitcortex/_bin/.gitignore

@@ -0,0 +1 @@
+gcx

gitcortex-0.3.0.dist-info/METADATA

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: gitcortex
+Version: 0.3.0
+Summary: Git-aware code knowledge graph — incremental AST indexing on every commit, MCP server for AI assistants
+Project-URL: Homepage, https://github.com/bharath03-a/GitCortex
+Project-URL: Repository, https://github.com/bharath03-a/GitCortex
+Project-URL: Bug Tracker, https://github.com/bharath03-a/GitCortex/issues
+License: MIT
+Keywords: ai,code-graph,git,mcp,tree-sitter
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# gitcortex
+
+A code knowledge graph for Git repositories. GitCortex indexes your codebase on every commit and answers questions like "what calls this function?" or "what changed between these two branches?" — so your AI coding assistant can work with real structure instead of scanning raw files.
+
+## Install
+
+```bash
+pip install gitcortex
+# or
+pipx install gitcortex
+# or
+uv tool install gitcortex
+```
+
+Supports macOS (Apple Silicon + Intel), Linux (x86_64 + arm64), and Windows (x64). No Rust or compiler required — a pre-built binary is bundled in the wheel.
+
+## Quick start
+
+```bash
+cd your-repo
+gcx init       # index the repo + install git hooks
+gcx serve      # start the MCP server for your AI assistant
+```
+
+After `gcx init`, the graph updates automatically on every `git commit`, `merge`, `rebase`, and `checkout`. No manual re-runs needed.
+
+## What it does
+
+GitCortex builds a queryable graph of your codebase — functions, structs, classes, interfaces, call relationships, inheritance chains — and keeps it current automatically.
+
+- **Works with**: Rust, Python, TypeScript, JavaScript, Go, Java
+- **Integrates with**: Claude Code, Cursor, Windsurf, GitHub Copilot, Antigravity
+- **Per-branch graphs**: switching branches gives you the graph for that branch instantly
+- **Zero runtime dependency**: single self-contained binary, nothing else to install
+
+## Commands
+
+### `gcx init`
+
+Index the current repo, install git hooks, and register the MCP server with your editor.
+
+```bash
+gcx init                     # auto-detects your editor
+gcx init --editor cursor     # target a specific editor: claude, cursor, windsurf, copilot
+gcx init --editor all        # write configs for every supported editor
+```
+
+### `gcx serve`
+
+Start the MCP server so your AI assistant can query the knowledge graph.
+
+```bash
+gcx serve
+```
+
+Once running, your AI assistant has access to tools like `find_callers`, `lookup_symbol`, `list_definitions`, `trace_path`, and more.
+
+### `gcx query`
+
+Query the graph from the terminal without an AI assistant.
+
+```bash
+gcx query lookup-symbol MyStruct
+gcx query find-callers process_request
+gcx query list-definitions src/lib.rs
+```
+
+### `gcx blast-radius`
+
+See which parts of the codebase are affected by changes between two branches — useful before merging.
+
+```bash
+gcx blast-radius --base main --head feat/my-feature
+gcx blast-radius --base main --head feat/my-feature --format github-comment
+```
+
+### `gcx viz`
+
+Open an interactive graph in your browser.
+
+```bash
+gcx viz                         # opens on port 5678
+gcx viz --port 9000
+gcx viz --branch feat/my-feature
+gcx viz --format dot > graph.dot   # export as Graphviz DOT
+```
+
+### `gcx export`
+
+Generate a readable Markdown map of the codebase at `.gitcortex/context.md`. The git hook keeps it up to date automatically.
+
+```bash
+gcx export
+```
+
+### `gcx status`
+
+Show node and edge counts for the current branch.
+
+```bash
+gcx status
+```
+
+### `gcx clean`
+
+Wipe the local graph store and re-index from scratch on the next commit.
+
+```bash
+gcx clean
+```
+
+## MCP tools available to your AI assistant
+
+| Tool | What it answers |
+|---|---|
+| `lookup_symbol` | Where is `MyStruct` defined? |
+| `find_callers` | What calls `process_request`? |
+| `find_callees` | What does `handle_request` call? |
+| `list_definitions` | What's defined in `src/auth.rs`? |
+| `find_implementors` | What implements `AuthProvider`? |
+| `trace_path` | How do you get from `main` to `validate_token`? |
+| `find_unused_symbols` | What's never called (dead code candidates)? |
+| `get_subgraph` | Everything within 2 hops of `UserService` |
+| `detect_changes` | What changed + who's affected vs main? |
+| `symbol_context` | Callers, callees, and uses for a symbol |
+
+All tools accept an optional `branch` parameter.
+
+## Configuration
+
+`.gitcortex/config.toml` (committed to your repo, shared with your team):
+
+```toml
+[index]
+languages = ["rust", "typescript", "python", "go"]
+max_file_size_kb = 500
+```
+
+`.gitcortex/ignore` (`.gitignore` syntax — files to exclude from indexing):
+
+```
+target/
+build/
+**/*.generated.rs
+```
+
+## License
+
+MIT — free for commercial and open-source use.
+
+[GitHub](https://github.com/bharath03-a/GitCortex) · [Issues](https://github.com/bharath03-a/GitCortex/issues)

gitcortex-0.3.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+gitcortex/__init__.py,sha256=-aCxEktYu-BcSG9tMbO1V2as20b_tHDWW682FPFYVX8,711
+gitcortex/_bin/.gitignore,sha256=eqRdoINJ6Ddnr127eoTJ6aSbh2SNtCz4Z_4Rob7SNgM,4
+gitcortex/_bin/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitcortex/_bin/gcx,sha256=0DDtSPXBaKvTWN7bBHwMRv9ge5rNZWTnfbdfxCgSGyo,25991920
+gitcortex-0.3.0.dist-info/METADATA,sha256=5kWbh7_lr2UO5hjgQGGcpBf7ajY10kZCoUV9eghGwSk,5167
+gitcortex-0.3.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+gitcortex-0.3.0.dist-info/entry_points.txt,sha256=4Te0pK4yB3kVq-3K1qyrQSJ155wP43UXMGYrMqsLQb0,39
+gitcortex-0.3.0.dist-info/RECORD,,

gitcortex-0.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

gitcortex-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gcx = gitcortex:main