srcodex 0.2.0__py3-none-any.whl

srcodex-0.2.0.dist-info/METADATA

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: srcodex
+Version: 0.2.0
+Summary: Semantic code explorer with AI-powered search and analysis
+Author-email: Jonathan Antoun <jonathan.antoun@amd.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Jonathan03ant/srcodex
+Project-URL: Repository, https://github.com/Jonathan03ant/srcodex
+Project-URL: Issues, https://github.com/Jonathan03ant/srcodex/issues
+Keywords: code-search,semantic-analysis,ai,llm,code-exploration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: textual[syntax]>=0.47.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn>=0.23.0
+Requires-Dist: anthropic>=0.7.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: tqdm>=4.66.0
+Dynamic: license-file
+
+# srcodex
+
+**Semantic code explorer with AI-powered search and analysis**
+
+srcodex builds a semantic graph of your codebase and provides AI-powered exploration through natural language queries. Think of it as an intelligent code search that understands relationships, call graphs, and architecture.
+
+## Why srcodex?
+
+Unlike generic code assistants (Claude CLI, GitHub Copilot, etc.) that read entire files to answer questions, srcodex uses a **semantic graph database** to understand your code:
+
+| Question | Generic Assistant | srcodex |
+|----------|------------------|---------|
+| "Who calls function X?" | Grep entire codebase (20K tokens) | `get_callers('X')` (200 tokens) |
+| "Show call chain A→B" | Read multiple files, manual tracing | Graph query (500 tokens) |
+| "Find all ioctls" | Grep + read matches (15K tokens) | Database search (300 tokens) |
+| "Explain module Y" | Read 10+ files (30K tokens) | Aggregate query (2K tokens) |
+
+**Result:** 90% more token-efficient, instant relationship queries, and unique capabilities impossible for file-based tools (call chains, data flow analysis, architecture visualization).
+
+## Features
+
+- **Semantic Indexing**: Builds a persistent graph of symbols, functions, types, and their relationships
+- **AI-Powered Search**: Ask questions in natural language about your code
+- **Call Graph Analysis**: Trace function calls, dependencies, and execution paths
+- **Terminal UI**: Beautiful terminal interface with file browser and AI chat
+- **Multi-Language**: Supports C, C++, Python, and more
+- **Fast**: SQLite-backed graph queries with intelligent caching
+- **Portable**: `.srcodex/` directory makes indexed projects shareable
+
+## Installation
+
+```bash
+pip install srcodex
+```
+
+## Quick Start
+
+```bash
+# Index your codebase (first time)
+cd /path/to/your/project
+srcodex
+
+# Output:
+# No .srcodex/ found. Index this directory? (y/n) y
+# [Indexing happens...]
+# [TUI launches]
+
+# Next time - instant launch
+srcodex
+```
+
+## Usage
+
+Once indexed, use the TUI to:
+- Browse files and symbols
+- Search across your codebase
+- Chat with AI about your code architecture
+- Trace call chains and dependencies
+
+### Example AI Queries
+
+```
+"What does the init_system function do?"
+"Show me all functions that call malloc"
+"Trace the execution path from main to shutdown"
+"What structs are defined in config.h?"
+```
+
+## Configuration
+
+Copy `.env.example` to `.env` and configure your API key:
+
+```bash
+# Public Anthropic API
+ANTHROPIC_API_KEY=sk-ant-your-key-here
+
+# Or enterprise gateway (if applicable)
+AMD_LLM_API_KEY=your-subscription-key
+```
+
+## Requirements
+
+- Python 3.9+
+- Universal CTags (`brew install universal-ctags` or `apt install universal-ctags`)
+- Cscope (optional, for call graph)
+- Claude API key (Anthropic or enterprise gateway)
+
+## How It Works
+
+1. **Indexing**: Extracts symbols, relationships, and metadata using CTags and Cscope
+2. **Graph Building**: Creates semantic graph with typed edges (CALLS, INCLUDES, ACCESSES)
+3. **AI Integration**: Claude queries the graph using specialized tools (not reading full files)
+4. **Token Efficiency**: **99%+ reduction** in tokens vs. traditional code assistants
+   - **Breakthrough caching architecture**: 25-100 tokens per query after initial cache build
+   - Aggressive parallel tool batching (20-40 tools per iteration)
+   - 3-iteration cache strategy: iterations 1-3 cached, iteration 4 answers with cached data
+   - Semantic graph queries instead of file reads (10-100x more efficient)
+   - **Real example**: 500 input tokens vs 60,000+ for traditional file-based approaches
+   - Cache persists across queries - subsequent questions cost nearly nothing!
+
+## Project Structure
+
+After indexing, your project will have:
+
+```
+your-project/
+├── .srcodex/
+│   ├── metadata.json       # Project stats
+│   ├── config.toml         # Indexing config
+│   ├── data/
+│   │   └── project.db      # Semantic graph
+│   └── logs/               # Debug logs
+└── [your source files...]
+```
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/Jonathan03ant/srcodex.git
+cd srcodex
+
+# Install in development mode
+pip install -e .
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Contributing
+
+Contributions welcome! Please open an issue or pull request.
+
+## Links
+
+- [GitHub Repository](https://github.com/Jonathan03ant/srcodex)
+- [Issue Tracker](https://github.com/Jonathan03ant/srcodex/issues)
+- [Documentation](https://github.com/Jonathan03ant/srcodex/wiki)

srcodex-0.2.0.dist-info/RECORD

@@ -0,0 +1,52 @@
+srcodex/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/cli.py,sha256=YgozQzlpbvLZ89K4eq2DuliKX5Rgn837rK25L_M4BqU,8810
+srcodex/backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/backend/chat.py,sha256=5A24H6g-0mzdrYYg995UnIDZ2LDFvpKRs19iW_ShXxM,2708
+srcodex/backend/main.py,sha256=n3BiCPZLnJPrxsxITG8WbHgC1wTyGw4EQVUYQrV-p-c,3620
+srcodex/backend/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/backend/services/claude_service.py,sha256=id97cqj6WUXWz-lBGc7nPqClchI1ZGA7b7B1OJ1uzBA,35952
+srcodex/backend/services/config_loader.py,sha256=4DqSI7ihlBI3p6GyJKIkrAImN-9juq6SlBdEUWNe8c0,3342
+srcodex/backend/services/file_access_tools.py,sha256=enydn86Z9oHMbndNiYTzCBk3BauP8j8TImtSKF9y6Jg,9523
+srcodex/backend/services/file_tree.py,sha256=MDv_dLesjSDe5jM-Lz3D9bSpTHteBNVSOlAYbeZAvdM,16639
+srcodex/backend/services/graph_tools.py,sha256=PvainlbfePh1qjJzbSNJlb5oWdNzXmCQ8ex7Hl9mSYk,32123
+srcodex/backend/services/logger_setup.py,sha256=I5w_p7YN-qz_K4HVwtA72-RMIz7zcCdKQuLyX2N-wnA,3075
+srcodex/backend/services/session_manager.py,sha256=9cfdiuaXbv6X8lc8Mmj_-th-3VL8vsaM-7o2HCWksTY,2615
+srcodex/backend/services/status_tracker.py,sha256=qMDKKM4_KU9MWe7h_gh2R7kZ6IWgeB2sE_Pg5-IeJrA,2840
+srcodex/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/core/config.py,sha256=4DqSI7ihlBI3p6GyJKIkrAImN-9juq6SlBdEUWNe8c0,3342
+srcodex/core/logger.py,sha256=L9o9Iigp7giThv9dPf0rdkPNGWj0Nv66k1j2YYrtY1E,573
+srcodex/indexer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/indexer/cscope_client.py,sha256=buD4acWjiYd0tITh16jThqxSp9oMVqe7zSZK6JRPEbc,6025
+srcodex/indexer/ctags_compat.py,sha256=aoZWl8Jf4aVKAms9LNCRJdwDVj2hEiTAWPY7AKbQUwQ,8516
+srcodex/indexer/ctags_parser.py,sha256=CWoRbY--VVdUFfgI8jYhwzBmh8HljslLgjO6SbAp-vQ,17840
+srcodex/indexer/explorer.py,sha256=iYpY6vEY9S4nvIUN32LT1oupa9835e-62ChA047eF3Y,3902
+srcodex/indexer/field_access_analyzer.py,sha256=WQYwOi_A3mEO2tNxgxpk6ipeFNU_KoLu76HDI9SaEWw,15701
+srcodex/indexer/indexer.py,sha256=TNaMdx_kjbbz6IY01w9HK5RA7xnEqcCOBpiP8IovTl4,24929
+srcodex/indexer/reference_ingestor.py,sha256=F_L9CiEtxIaN_YpYnUS7dea1EvPS9ygsIvenLg1Rj9E,11642
+srcodex/indexer/reference_resolver.py,sha256=crXqWcxfmtkCoP0F-wj4h6SgSBtQOt60qsGDST455gA,19859
+srcodex/tui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/tui/app.py,sha256=0edfeMFEDJ2eocE65_yUe9PQMfVj1EnyWbvfeMd4uJI,3719
+srcodex/tui/app.tcss,sha256=FztI4lVQFrgrPjGixY5mLyBwFCJBH3__pbapYbP1cuk,346
+srcodex/tui/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/tui/components/logger.py,sha256=QP_7eRAEfrB277dIE1XfsxcypM-C2T8VJR2QUE6M5Jw,1648
+srcodex/tui/components/bars/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/tui/components/bars/chat_header.py,sha256=IHF9bttzggbyj-HemzQ5tPRsQ8ACubX8CooiuGTzkog,1182
+srcodex/tui/components/bars/code_tab_bar.py,sha256=LiHLVeKbBaTLdI-ehdgpuSDZKDM8aDCbn2ONsObH0ss,4528
+srcodex/tui/components/bars/footer_bar.py,sha256=yRP2MsZavvnr_m5mHMAAnEtzi9RlHK23bV5u3skLjZs,4326
+srcodex/tui/components/bars/left_tab.py,sha256=wZruoIMpQdlN0Y_cmiGFUcS-whaGf-NcIXbdLlSYO_M,1359
+srcodex/tui/components/panels/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/tui/components/panels/chat_panel.py,sha256=2wWKXpBU6wip7vQ376T33vsy5NCkwmbWsaTcv_Jd4zk,18613
+srcodex/tui/components/panels/code_panel.py,sha256=0KxOrH8vl5KzJ_R5PW45p1iSBsf6Ef8BTDrFJScFuWw,8424
+srcodex/tui/components/panels/side_panel.py,sha256=49lySjN3w7IXjBhA5A__6olNhuUG5tZSFrkeBlViQjs,4636
+srcodex/tui/components/views/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/tui/components/views/explorer_view.py,sha256=SKUARolNsjVTcTjRU21YB5sxrtH4UE_-_FYGoYj2Wic,496
+srcodex/tui/components/views/search_view.py,sha256=0xwOo3M3Uv69jJQnjHw_WowUZfQ5E9_XWdWKqBdvgI4,5023
+srcodex/tui/components/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+srcodex/tui/components/widgets/file_browser.py,sha256=siqEu9VEVQ4hG06O5_M7d6O6LW7zP1EXZ6BPkZ_oYr4,363
+srcodex/tui/components/widgets/find_box.py,sha256=S8kxwPxvSqSpRyZiF5b4c7MzCjj7U3MSTjEDMA5KfGQ,2291
+srcodex-0.2.0.dist-info/licenses/LICENSE,sha256=p75i2wt6HFYrFvok9afEIdy2UwUTt7iPxxnON5unYqI,1072
+srcodex-0.2.0.dist-info/METADATA,sha256=lMjf1NW40gqRwUmdp1bmop77xDb_5UjAuyCQ8v9C-xE,5623
+srcodex-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+srcodex-0.2.0.dist-info/entry_points.txt,sha256=5_H5DykVL75PuahLmHjU9YdLQ0l_5nkQr5qqtDSnRCA,45
+srcodex-0.2.0.dist-info/top_level.txt,sha256=TKAhNgUXRNdtqqJeCkEFzq_8ep3FICJjvNxnV_j2xg0,8
+srcodex-0.2.0.dist-info/RECORD,,

srcodex-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

srcodex-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+srcodex = srcodex.cli:main

srcodex-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jonathan L'Work
+
+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.

srcodex-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+srcodex