ai-coding-assistant 0.5.0__py3-none-any.whl

ai_coding_assistant-0.5.0.dist-info/METADATA

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: ai-coding-assistant
+Version: 0.5.0
+Summary: AI-powered coding assistant with semantic search, intelligent refactoring, and interactive chat
+License: MIT
+License-File: LICENSE
+Keywords: ai,coding-assistant,llm,code-analysis,semantic-search,refactoring,ollama,developer-tools,cli
+Author: Shreyyyas22
+Author-email: waghshreyash22@gmail.com
+Requires-Python: >=3.11
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Dist: chromadb (>=0.5.23,<0.6.0)
+Requires-Dist: gitpython (>=3.1.45,<4.0.0)
+Requires-Dist: networkx (>=3.4.2,<4.0.0)
+Requires-Dist: numpy (>=1.26.0,<2.0.0)
+Requires-Dist: pathspec (>=0.12.1,<0.13.0)
+Requires-Dist: prompt-toolkit (>=3.0.52,<4.0.0)
+Requires-Dist: psutil (>=6.1.1,<7.0.0)
+Requires-Dist: python-louvain (>=0.16,<1.0.0)
+Requires-Dist: pyyaml (>=6.0.3,<7.0.0)
+Requires-Dist: rank-bm25 (>=0.2.2,<0.3.0)
+Requires-Dist: requests (>=2.31.0,<3.0.0)
+Requires-Dist: rich (>=14.2.0,<15.0.0)
+Requires-Dist: sentence-transformers (>=3.3.1,<4.0.0)
+Requires-Dist: tiktoken (>=0.12.0,<0.13.0)
+Requires-Dist: tree-sitter (>=0.23.2,<0.24.0)
+Requires-Dist: tree-sitter-java (>=0.23.0,<0.24.0)
+Requires-Dist: tree-sitter-javascript (>=0.23.0,<0.24.0)
+Requires-Dist: tree-sitter-python (>=0.23.6,<0.24.0)
+Requires-Dist: typer[all] (>=0.21.0,<0.22.0)
+Requires-Dist: watchdog (>=6.0.0,<7.0.0)
+Project-URL: Homepage, https://github.com/Shreyyyas22/ai-coding-assistant
+Project-URL: Issues, https://github.com/Shreyyyas22/ai-coding-assistant/issues
+Project-URL: Repository, https://github.com/Shreyyyas22/ai-coding-assistant
+Description-Content-Type: text/markdown
+
+# AI Coding Assistant
+
+A terminal-based AI coding assistant that helps you understand, navigate, and work with your codebase using natural language.
+
+[![Python Version](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-0.5.0-orange.svg)](https://github.com/your-username/ai-coding-assistant)
+
+---
+
+## Features
+
+- **Natural Language Queries**: Ask questions about your codebase in plain English
+- **Semantic Code Search**: Find code by meaning, not just keywords
+- **Code Explanation**: Get detailed explanations of files and functions
+- **Interactive Chat Mode**: Explore your codebase conversationally
+- **Local-First**: Works with Ollama (free, no API key required)
+- **Privacy-Focused**: Everything runs locally with Ollama
+- **Multi-Language Support**: Python, JavaScript, TypeScript, Java, Go, Rust, and more
+
+---
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install ai-coding-assistant
+```
+
+### Setup (Ollama - Free & Local)
+
+```bash
+# Install Ollama
+curl https://ollama.ai/install.sh | sh
+
+# Pull a code model
+ollama pull codellama
+
+# Start Ollama service
+ollama serve
+```
+
+### Index Your Codebase
+
+```bash
+cd your-project
+assistant index
+```
+
+### Ask Questions
+
+```bash
+assistant ask "How does authentication work?"
+assistant explain src/auth/login.py
+assistant search "JWT token validation"
+```
+
+### Interactive Mode
+
+```bash
+assistant chat
+```
+
+---
+
+## Why AI Coding Assistant?
+
+### No API Key Required
+
+Works great with **Ollama** (free, local, open source). Optionally supports OpenAI and Claude APIs.
+
+### Privacy-First
+
+With Ollama, everything runs locally on your machine. Your code never leaves your computer.
+
+### Fast & Efficient
+
+- Hybrid search (vector + keyword)
+- Smart caching
+- Incremental indexing
+- Only reprocess changed files
+
+---
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `assistant ask` | Ask questions about your code |
+| `assistant index` | Index your codebase |
+| `assistant explain` | Explain specific code |
+| `assistant search` | Search for code |
+| `assistant chat` | Interactive mode |
+| `assistant config` | Manage configuration |
+
+See [Command Reference](docs/commands/README.md) for details.
+
+---
+
+## Documentation
+
+- [Installation Guide](docs/INSTALLATION.md) - Complete setup instructions
+- [Quick Start Guide](docs/QUICKSTART.md) - Get started in 5 minutes
+- [Configuration Guide](docs/CONFIGURATION.md) - Customize settings
+- [Command Reference](docs/commands/README.md) - All commands
+- [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues
+- [FAQ](docs/FAQ.md) - Frequently asked questions
+
+---
+
+## System Requirements
+
+### Minimum
+- Python 3.11+
+- 2GB RAM
+- 1GB disk space
+
+### Recommended
+- Python 3.11+
+- 8GB RAM (for Ollama)
+- 5GB disk space
+
+### Supported Platforms
+- Linux (Ubuntu, Debian, Fedora, etc.)
+- macOS (10.15+)
+- Windows (WSL2 recommended)
+
+---
+
+## Development
+
+### Install from Source
+
+```bash
+git clone https://github.com/your-username/ai-coding-assistant.git
+cd ai-coding-assistant
+
+# Install with Poetry
+poetry install
+
+# Or with pip
+pip install -e .
+```
+
+### Run Tests
+
+```bash
+poetry run pytest
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+## Support
+
+- **GitHub Issues**: https://github.com/your-username/ai-coding-assistant/issues
+- **Discussions**: https://github.com/your-username/ai-coding-assistant/discussions
+
+---
+
+**Start coding smarter with AI assistance!**
+
+```bash
+pip install ai-coding-assistant
+assistant index
+assistant ask "Let's build something amazing!"
+```
+

ai_coding_assistant-0.5.0.dist-info/RECORD

@@ -0,0 +1,89 @@
+coding_assistant/__init__.py,sha256=XlLkU4F57q5koXLpv5ArBt_qKNAL8JSCFDpUKW6Cp2k,67
+coding_assistant/__main__.py,sha256=Lm5N53nzaAVt4oBDjiyk0MoYqhX5dKpAJKo6QqE6Y_4,367
+coding_assistant/cli/__init__.py,sha256=-0lnM5JscIGl6AJSysMeIOU6qFs0M9tsHyAWXY90ZKA,43
+coding_assistant/cli/app.py,sha256=l72BP2bXzIazDnGzgu6nHAQIK1a_Z5RqK6GRoYSDpFc,4957
+coding_assistant/cli/commands/__init__.py,sha256=LWcvrEQ9xP8D7zs3qsB99yqWYrn3lUI3DHV5Yn9J664,651
+coding_assistant/cli/commands/ask.py,sha256=nwjLiybZ9sHiOt9qX08nhnrSMito58uvD19za5T-g1E,6602
+coding_assistant/cli/commands/config.py,sha256=LmaXL-IKQxii-44fVrWCZnXl51Nh-hECLOVIc44f4Sk,15034
+coding_assistant/cli/commands/diagram.py,sha256=VkJDKWs2slQkXS85eP_ugeSnH06pcZ6pxFLes9v8As8,9240
+coding_assistant/cli/commands/document.py,sha256=trTt3bv0a_HjbumhN0fIhypbNYIO81VdmZbyYwSRNNY,14910
+coding_assistant/cli/commands/explain.py,sha256=TXqD9OR4KJhGuvUNp-OlU8nsNePis7qcTNKYa4Fmlnc,6795
+coding_assistant/cli/commands/fix.py,sha256=4vc_VE-W4qDNxJLMelYgMWwmo3vnBs6scKKhhrWtTko,8629
+coding_assistant/cli/commands/index.py,sha256=gEC-_VNd7-C2ZSLQDghxJ1HvmFlxdmsYeVy-aIjBpHY,5799
+coding_assistant/cli/commands/refactor.py,sha256=ApmXFPemGD8IoGJDb-AjCwHVW3Zv1msM3ao7nABfNu4,8443
+coding_assistant/cli/commands/search.py,sha256=6gv8pCT87eWhCknqt09P8ZsP5Tz24jH3JRFZm5lAcTc,6215
+coding_assistant/cli/commands/serve_docs.py,sha256=WLOWMsIeSDQFEFfcWDZNlWmRVbR29u-UjR7whrT_w2o,3759
+coding_assistant/cli/repl.py,sha256=7GbAV0kH_X2aYkEzCNwLlP5exCsMW4Q0sShy-RamvoM,13458
+coding_assistant/cli/theme.py,sha256=czqHlZ22AKicpCwOtkj6wpJE0hkKZMX3AN_FByLM7_g,2219
+coding_assistant/codebase/__init__.py,sha256=-ej31kkGAd4qJA32glMIfjklNW0lDH57CPacL_5y7PU,36
+coding_assistant/codebase/crawler.py,sha256=R7V4lqoiNfB_UlrmXJkCxvaCw1f_GSu-JTKYw4245QU,2862
+coding_assistant/codebase/parser.py,sha256=xNmmDfYrgOcaSJKh1EnDLv2jAU9L-TY0GI4QM5nizmU,9527
+coding_assistant/config/__init__.py,sha256=vwp8IUywFQgLrKo93OPdHJ15DoCzBvUq39UB9TOL_ww,424
+coding_assistant/config/config_manager.py,sha256=vFiHEyCEbU0KYbwGodNy_WIyW1J71m-cmmVxrUGvbVM,18573
+coding_assistant/config/settings.py,sha256=YOFR7kqEeDwYP-yiCCvLjTmobSiE3pbkiUmZ5Jpa8Qc,3070
+coding_assistant/context/__init__.py,sha256=sIdg--tVYlys7Lk0lZQaasYqIvWErhTAdzqQ0rXYHjk,644
+coding_assistant/context/chunker.py,sha256=klKkrJxEOQpHcSeMuWY2rzPtx22SZefFyx8GCF4oCfA,15169
+coding_assistant/context/enhanced_retriever.py,sha256=LTD05I9MaXx3IPIuj52tFxI1ZDSuwCTzb9k8SiemoAY,11756
+coding_assistant/context/hybrid_search.py,sha256=EBfXIqLWdqZgz1k91KNdA35FzgKQz3T_xw_0HAn96no,10326
+coding_assistant/context/ranker.py,sha256=-j47MLMPhk2hvEI1TpNhd-nc4ww0H5OcVEMe7bKXJZ0,12656
+coding_assistant/context/retriever.py,sha256=s1mstZg0LrZ9HTRlyP75JRRpNrAbgzZQ4g8kGEm93VE,4079
+coding_assistant/context/window.py,sha256=Oco7uWq0vwLfdcriNAJVwQFK56-9glls8kXK3vfcWHQ,10787
+coding_assistant/documentation/__init__.py,sha256=pW8m7-TcR2xMt57azZyFK_A4E0lILnQmtyasaIh0s20,661
+coding_assistant/documentation/agents/__init__.py,sha256=dIhll7-0CQfVe-o36Wg7vw9mL76PxblT58jQe5ZeJrM,733
+coding_assistant/documentation/agents/coordinator.py,sha256=ijCtUSK03X2WMszdqHDDVLu6J9OMkMH8B1wve3ue6PM,18810
+coding_assistant/documentation/agents/module_documenter.py,sha256=c1D5VjNtToM2i3-Ui2PVYf0ElSLDDpc5nSAPZ1Dc-c0,3543
+coding_assistant/documentation/agents/synthesizer.py,sha256=h_mmnuU_Nu9KIGESgca2swZArUfWclPK8kC3RRfGm-s,4855
+coding_assistant/documentation/agents/task_delegator.py,sha256=EXHWVLtsfDTmeVdKNfKJKCTbc4xTQQjPP7f8efx9H-s,3017
+coding_assistant/documentation/decomposition/__init__.py,sha256=vQ9ODhFuvLGGMkmbv_Ko9-A9dddaGVDOf6REOUx6sHY,534
+coding_assistant/documentation/decomposition/context_preserver.py,sha256=80XjXt2kTe1NaO_A2p93GJw11jWI7pzUA-JHXm0F1dk,17350
+coding_assistant/documentation/decomposition/module_detector.py,sha256=GEMLvM_63CwlBxj2lCXqq4sACg2NfFB-rMOfzsPna5s,9382
+coding_assistant/documentation/decomposition/partitioner.py,sha256=xG6jKhklcs5oa2w21HrN7_noj7VDcGkc3Zn77VRQ_VM,21834
+coding_assistant/documentation/generators/__init__.py,sha256=ne27chxXjb4h2jcEw34SaWlWp8TqBpDQK8_A4mjHK3A,407
+coding_assistant/documentation/generators/dataflow_generator.py,sha256=29FyuYAVAwVUX3tiHrU8YklIGibPNO4wqSdX1qhI4H4,17049
+coding_assistant/documentation/generators/diagram_generator.py,sha256=0SkG_pj1lDR0qo_B_Rlu_adD7asGhNMvT4CVQVoNS54,19254
+coding_assistant/documentation/graph/__init__.py,sha256=zlsMzyiqUkXmXoMvKMRDbOwmTJGrQ1u2z0sEag1gxIA,351
+coding_assistant/documentation/graph/dependency_builder.py,sha256=3v3UII1fZBi9uOPYes9VMVD_AoGcMGhgmwzb3ZhoFMI,15862
+coding_assistant/documentation/graph/module_analyzer.py,sha256=2SWWdLoKEOzs2otb5V5BnSXTnJkzv21YEur7-T2FRtQ,15680
+coding_assistant/documentation/writers/__init__.py,sha256=2g4rMKvDDQkdgrQbZQkXfNs29fcvOqWUZJwlv09FWR0,273
+coding_assistant/documentation/writers/markdown_writer.py,sha256=xl5qEqM0DkBush-JCMoOWEV9kveOY4XIGfL4DXJG1YE,10860
+coding_assistant/embeddings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+coding_assistant/embeddings/generator.py,sha256=UHUt3qHaTbYVTYQkHWSR1OgSZDUOMLa4vghctcVb6sY,2703
+coding_assistant/embeddings/store.py,sha256=VbDnXC7SE9vMbkx2bqZqzSDWz3rKmPbQrOj_57I1Buc,5874
+coding_assistant/exceptions/__init__.py,sha256=EqBOL1pdXiEAXJVIK9QGjKeSv_74yDUqn-_-UPVtqdE,1034
+coding_assistant/exceptions/base.py,sha256=LlG_lr8yk52t2q9wZbVzuuoTrVAvm9vinTrOb7L7MMw,3372
+coding_assistant/exceptions/llm.py,sha256=ZRs9B5ISONnQT9picGuHqlbmLnozxXYeLGi2wgz8MTs,7883
+coding_assistant/exceptions/recovery.py,sha256=bzs8R_NhFhL631BYkG4v3SM0QheNVejViyAXt4yF-yQ,8086
+coding_assistant/exceptions/storage.py,sha256=9p8UGUQbxlZ6Gcy7byy9ikU6C13RmrcFZRS78O8cRcQ,5573
+coding_assistant/exceptions/validation.py,sha256=kLP-Wg1K4NiI9xUKpa7Uc53LhHTZOMM7w7pe_KOcZFc,5641
+coding_assistant/llm/__init__.py,sha256=vbjVwz8760-mRUYNZEtXVW5ttjr6EvONTj63DCs17JA,30
+coding_assistant/llm/client.py,sha256=lbmys4Iwml5L3qwmpXwgH_2NWcc6OSO6T_bTlCEpxBE,11395
+coding_assistant/llm/gemini_client.py,sha256=VptZEPKISM0CWxrWQF7SdJQwCrnHp8Vdeh2me8qmOKk,6555
+coding_assistant/llm/groq_client.py,sha256=aB1v64dqhJO9DzQ2cW3QhgdrQHsMkqiSlqTFYxO7ft4,5417
+coding_assistant/llm/prompts.py,sha256=uIgvGByz-56Bhafn2emv1VmjMKYBKfhZHMJBdvEp6aw,4011
+coding_assistant/llm/together_client.py,sha256=E_h_Scu7ZzGDlisph8b8uPdz0jsh3YzcPDlwzodL_Kg,5500
+coding_assistant/operations/__init__.py,sha256=VmwIDx0fkNLvnFGaPosix7Ok0_GPwBhtJmBH1IESnB8,437
+coding_assistant/operations/differ.py,sha256=jxreiFRr_keUeNTQ_T31taQ5BgY0Vvr5QHmfYnHHL5I,12133
+coding_assistant/operations/generator.py,sha256=K9sNHXhIMrvyOsYYeYkAbdotLtzz0wqZRu8qaNTl_Ko,11382
+coding_assistant/operations/linter.py,sha256=dLgxPgKriFq3CzNL-xTvUxcOKreB_VEGZKY-JOSFCgc,14386
+coding_assistant/operations/validator.py,sha256=OtfDRG72Aj45M52UPF7Ue-aOd2UjPr6DGW3MTBytW-s,13639
+coding_assistant/storage/__init__.py,sha256=NJIUH-daWIz3eBnlnvmbi3zE801AJRnGTxds-8c5wvw,215
+coding_assistant/storage/database.py,sha256=QBFnQ3bfwBO4kkL2ryTrVJtIzeVMi2_Yq_QudsNDheM,12209
+coding_assistant/storage/session.py,sha256=hS-hAz_K5wn-7WJdUimltm1XAZm0RdYdJZkf3qJbd3k,6649
+coding_assistant/utils/__init__.py,sha256=v6lBZKkibOTBBOZTlHigLCJ8dgoJtYbhgqQiDszf1lA,588
+coding_assistant/utils/cache.py,sha256=R6et9MF6JZf-FFmecQuGPp1NKm91dCuztjnUPKb3cEo,13915
+coding_assistant/utils/hardware.py,sha256=HuyWJWGTAjL5mTElc_mSd1mAnGf7vf63EO2eGhP1m5k,4816
+coding_assistant/utils/keystore.py,sha256=cgtSzIKkf_RI_7K3-tdaI159CfTfxadjZ6JqENPnYdw,5514
+coding_assistant/utils/logger.py,sha256=MGiHn2gjhVBUiwN6jDZ0cKTe4t3i8upLSuqHorVFMTw,830
+coding_assistant/utils/progress.py,sha256=tJF5xWR4S4UwCSJrLPZxZDVgObsfhx6-WiqJt6KryJ0,8587
+coding_assistant/validation/__init__.py,sha256=ThnFwC8M4ntfypdTE7GcRIw4a9z0W3ZhcmUiJyScufs,395
+coding_assistant/validation/files.py,sha256=RFOmhR-ZjKhQl2MaLaAU-JrRBkgvN594BRfBZz89HvU,8798
+coding_assistant/validation/inputs.py,sha256=pMNj5SI11hk3faH7L0neUciNbAoQfxr58s6Qdppvd_4,8459
+coding_assistant/validation/params.py,sha256=ldYtuAX_Pgcx2zReGl1x-XDfusytdnc-L4ArmQCIb-U,7111
+coding_assistant/validation/sanitizers.py,sha256=eLMjdXagPbeUnl7_qkcva9NyLIL8vKoLslPsQeKZisE,5721
+coding_assistant/vcs/__init__.py,sha256=2KfQ_1J1pdp9G0Uj6NKUaDcBm44W_A0eXjNwSq8QlyA,125
+coding_assistant/vcs/git.py,sha256=fwDAK7_3TfNxqyvVLhjaK7dAjXKwWo4JrxKtkMEJUz4,7921
+ai_coding_assistant-0.5.0.dist-info/METADATA,sha256=qhGK__VHQmH_2xpkvzFkE7tr7B_ci5zJ81ihM2TshJo,5845
+ai_coding_assistant-0.5.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+ai_coding_assistant-0.5.0.dist-info/entry_points.txt,sha256=ueiY29PtyUiucGdxiWAzOw5EDxLy1F-z088W6TU4gaE,60
+ai_coding_assistant-0.5.0.dist-info/licenses/LICENSE,sha256=wGzmS0uCVluC6RzjBZpJTvSPtQy5dX1gZ9CWvxkUVdo,1068
+ai_coding_assistant-0.5.0.dist-info/RECORD,,

ai_coding_assistant-0.5.0.dist-info/WHEEL

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

ai_coding_assistant-0.5.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+assistant=coding_assistant.__main__:main
+

ai_coding_assistant-0.5.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Shreyyyas22
+
+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.

coding_assistant/__init__.py

@@ -0,0 +1,3 @@
+"""AI-powered terminal coding assistant."""
+
+__version__ = "0.1.0"

coding_assistant/__main__.py

@@ -0,0 +1,19 @@
+"""Entry point for the AI coding assistant."""
+import sys
+from coding_assistant.cli.app import app
+
+
+def main():
+    """Run the CLI application."""
+    try:
+        app()
+    except KeyboardInterrupt:
+        print("\n\nGoodbye!")
+        sys.exit(0)
+    except Exception as e:
+        print(f"Error: {e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

coding_assistant/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI module for the coding assistant."""

coding_assistant/cli/app.py

@@ -0,0 +1,158 @@
+"""Main CLI application using Typer."""
+import typer
+from rich.console import Console
+from pathlib import Path
+from typing import Optional
+
+from coding_assistant.config.settings import settings
+from coding_assistant.cli.commands import (
+    ask_command,
+    index_command,
+    explain_command,
+    search_command,
+    refactor_command,
+    fix_command,
+    config_command,
+)
+from coding_assistant.cli.commands.document import document_app
+from coding_assistant.cli.commands.diagram import diagram_app
+from coding_assistant.cli.commands.serve_docs import serve_docs_app
+
+app = typer.Typer(
+    name="assistant",
+    help="AI-powered coding assistant for your terminal",
+    add_completion=False,
+    rich_markup_mode="rich",
+)
+
+console = Console()
+
+
+@app.callback()
+def callback(
+    project_path: Optional[Path] = typer.Option(
+        None,
+        "--project",
+        "-p",
+        help="Path to the project directory (defaults to current directory)"
+    ),
+    verbose: bool = typer.Option(
+        False,
+        "--verbose",
+        "-v",
+        help="Enable verbose output"
+    ),
+    llm_provider: Optional[str] = typer.Option(
+        None,
+        "--llm",
+        help="LLM provider to use (ollama, groq, gemini, together, mock)"
+    ),
+):
+    """AI coding assistant - understand and improve your codebase.
+
+    Phase 4: Advanced Features
+    - Intelligent code explanations
+    - Hybrid semantic + keyword search
+    - AI-powered refactoring with validation
+    - Automated bug fixing and linting
+    """
+    if project_path:
+        settings.set_project_path(project_path)
+    settings.verbose = verbose
+    if llm_provider:
+        settings.llm_provider = llm_provider
+
+
+# Register commands
+app.command(name="ask", help="Ask questions about your codebase")(ask_command)
+app.command(name="index", help="Index codebase for semantic search")(index_command)
+app.command(name="explain", help="Explain how code works")(explain_command)
+app.command(name="search", help="Search codebase with hybrid search")(search_command)
+app.command(name="refactor", help="Refactor code with AI assistance")(refactor_command)
+app.command(name="fix", help="Fix linting issues and bugs")(fix_command)
+app.add_typer(config_command, name="config", help="Manage configuration and API keys")
+
+# CodeWiki integration commands
+app.add_typer(document_app, name="document", help="Generate comprehensive documentation")
+app.add_typer(diagram_app, name="diagram", help="Generate visual diagrams")
+app.add_typer(serve_docs_app, name="serve-docs", help="Serve documentation locally")
+
+
+@app.command()
+def version():
+    """Show version information."""
+    from rich.panel import Panel
+    from rich.table import Table
+
+    # Version info
+    version_text = """[bold cyan]AI Coding Assistant[/bold cyan]
+[bold]Version:[/bold] 0.4.0
+[bold]Phase:[/bold] 4 - Advanced Features
+
+[dim]A local-first, AI-powered coding assistant[/dim]"""
+
+    console.print(Panel(version_text, border_style="cyan"))
+
+    # Features table
+    table = Table(title="Features", show_header=True, header_style="bold magenta")
+    table.add_column("Feature", style="cyan")
+    table.add_column("Status", justify="center")
+
+    features = [
+        ("Semantic Code Search", "✓"),
+        ("Hybrid Search (Vector + BM25)", "✓"),
+        ("Smart Code Chunking", "✓"),
+        ("Context-Aware Ranking", "✓"),
+        ("Code Validation", "✓"),
+        ("Linter Integration", "✓"),
+        ("AI-Powered Refactoring", "✓"),
+        ("Automated Bug Fixing", "✓"),
+        ("Diff Preview", "✓"),
+        ("Local LLM Support (Ollama)", "✓"),
+    ]
+
+    for feature, status in features:
+        table.add_row(feature, f"[green]{status}[/green]")
+
+    console.print(table)
+
+    # Commands info
+    console.print("\n[bold]Available Commands:[/bold]")
+    commands_info = [
+        ("ask", "Ask questions about your codebase"),
+        ("search", "Search code with hybrid search"),
+        ("explain", "Explain how code works"),
+        ("index", "Index codebase for search"),
+        ("refactor", "Refactor code with AI"),
+        ("fix", "Fix linting issues and bugs"),
+        ("config", "Manage configuration and API keys"),
+    ]
+
+    for cmd, desc in commands_info:
+        console.print(f"  [cyan]{cmd:12}[/cyan] {desc}")
+
+    console.print("\n[dim]Run 'assistant <command> --help' for more information[/dim]\n")
+
+
+@app.command()
+def chat():
+    """Start interactive chat mode (REPL).
+
+    Interactive mode allows multi-turn conversations with context awareness.
+    The assistant remembers your previous questions and can provide
+    more contextual and helpful responses.
+
+    Features:
+    - Multi-turn conversations
+    - Context-aware responses
+    - Code search and retrieval
+    - Special commands (/help, /history, etc.)
+
+    Press Ctrl+D to exit.
+    """
+    from coding_assistant.cli.repl import start_repl
+    start_repl(settings.project_path)
+
+
+if __name__ == "__main__":
+    app()

coding_assistant/cli/commands/__init__.py

@@ -0,0 +1,19 @@
+"""CLI commands for the coding assistant."""
+
+from coding_assistant.cli.commands.ask import ask_command
+from coding_assistant.cli.commands.index import index_command
+from coding_assistant.cli.commands.explain import explain_command
+from coding_assistant.cli.commands.search import search_command
+from coding_assistant.cli.commands.refactor import refactor_command
+from coding_assistant.cli.commands.fix import fix_command
+from coding_assistant.cli.commands.config import config_command
+
+__all__ = [
+    'ask_command',
+    'index_command',
+    'explain_command',
+    'search_command',
+    'refactor_command',
+    'fix_command',
+    'config_command',
+]