{"id":42746659,"url":"https://github.com/zidniryi/navix","last_synced_at":"2026-01-29T19:22:21.181Z","repository":{"id":306301470,"uuid":"1025722144","full_name":"zidniryi/navix","owner":"zidniryi","description":"NAVIX is a blazing-fast, cross-platform code navigation and indexing tool. Designed for offline use with lightning-fast symbol lookup, file jumping, and project-wide search — ideal for developers who crave performance without bloated IDEs.","archived":false,"fork":false,"pushed_at":"2025-07-24T18:09:46.000Z","size":1296,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-24T23:03:25.200Z","etag":null,"topics":["cli","developer-tools","developer-tools-detector","fast","navix","offline-tool","offline-tools","open-source","open-source-project"],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zidniryi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-24T17:36:06.000Z","updated_at":"2025-07-24T18:09:50.000Z","dependencies_parsed_at":"2025-07-24T23:03:29.561Z","dependency_job_id":"295d8f98-bfbf-4040-b96e-dffd9ff88dfb","html_url":"https://github.com/zidniryi/navix","commit_stats":null,"previous_names":["zidniryi/navix"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zidniryi/navix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidniryi%2Fnavix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidniryi%2Fnavix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidniryi%2Fnavix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidniryi%2Fnavix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zidniryi","download_url":"https://codeload.github.com/zidniryi/navix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidniryi%2Fnavix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28883087,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-29T16:41:59.663Z","status":"ssl_error","status_checked_at":"2026-01-29T16:39:39.641Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","developer-tools","developer-tools-detector","fast","navix","offline-tool","offline-tools","open-source","open-source-project"],"created_at":"2026-01-29T19:22:20.378Z","updated_at":"2026-01-29T19:22:21.173Z","avatar_url":"https://github.com/zidniryi.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 NAVIX - Navigate \u0026 Index\n\n**Lightning-fast for your navigation**\n\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen)](https://github.com/your-repo/navix)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![ncurses](https://img.shields.io/badge/TUI-ncurses-green.svg)](https://invisible-island.net/ncurses/)\n\nA powerful C++ file navigator with symbol indexing and autocomplete capabilities.\n\n![Navix Screenshot](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgQxYHkuUiIny9-VGPJLDEtCclT_597S87Hk4OS3gT6aC0-vaDbp-cbnl_PPG3DKnji02mH8KNn6RVASpD8xFZfZb4LcWz3N9aZtx4RoH67PvDwXoqjxY7s28jcPBO9xP2cnSoPTp-jhZ8NEBDrP_QPGrInik3Nvo1M_kzykg2F-i-NKurir-3JDNMuTRea/w640-h386/Screenshot%202025-07-26%20at%2014.00.05.png)\n\n## 📥 Download\n\n**Latest Release: v0.1** - Ready-to-use binaries for all platforms\n\n[![Download](https://img.shields.io/badge/Download-v0.1-blue.svg)](https://github.com/zidniryi/navix/releases/tag/v0.1)\n\n### Platform Downloads\n\n| Platform | Download | Description |\n|----------|----------|-------------|\n| 🐧 **Linux** | [navix-linux](https://github.com/zidniryi/navix/releases/tag/v0.1) | Native Linux binary with ncurses |\n| 🍎 **macOS** | [navix-macos](https://github.com/zidniryi/navix/releases/tag/v0.1) | Native macOS binary with ncurses |\n| 🪟 **Windows** | [navix-windows.exe](https://github.com/zidniryi/navix/releases/tag/v0.1) | Windows executable with Console API |\n| 📦 **All Platforms** | [View All Assets](https://github.com/zidniryi/navix/releases/tag/v0.1) | Complete release with all binaries |\n\n### Quick Start\n\n```bash\n# Linux/macOS - Download and run\nwget https://github.com/zidniryi/navix/releases/download/v0.1/navix-native\nchmod +x navix-native\n./navix-native /path/to/your/project\n\n# Windows - Download and run\n# Download navix-windows.exe from releases\nnavix-windows.exe C:\\path\\to\\your\\project\n```\n\n### Installation Options\n\n- **Direct Download**: Ready-to-use binaries (recommended)\n- **Package Managers**: Debian (.deb), macOS (.pkg) installers\n- **Build from Source**: Full compilation guide below\n\n## Features\n\n- **Fast File Navigation**: TUI-based interface for quick file browsing\n- **Symbol Indexing**: Parse and index symbols from various programming languages\n- **Autocomplete Engine**: Intelligent code completion suggestions\n- **Cross-Platform**: Runs on Unix/Linux/macOS and Windows\n- **Performance Monitoring**: Built-in performance profiling\n- **LSP Server**: Language Server Protocol integration\n- **File Watching**: Real-time file system monitoring\n\n## Cross-Platform Compilation\n\nNavix supports both Unix/Linux/macOS (using ncurses) and Windows (using Windows Console API).\n\n### Quick Build\n\nUse the provided build script for easy compilation:\n\n```bash\n# Build for all platforms\n./build.sh all\n\n# Build for current platform only\n./build.sh native\n\n# Build for Windows only (cross-compilation)\n./build.sh windows\n\n# Create macOS package installer (macOS only)\n./build.sh pkg\n\n# Create Debian package for Linux\n./build_deb.sh\n\n# Clean build artifacts\n./build.sh clean\n```\n\n### Manual Compilation\n\n#### Unix/Linux/macOS (Native)\n```bash\n# Install dependencies\n# macOS: brew install ncurses\n# Ubuntu/Debian: sudo apt install libncurses5-dev\n# Fedora: sudo dnf install ncurses-devel\n\n# Compile\ng++ -std=c++17 -o navix-native src/*.cpp $(pkg-config --cflags --libs ncurses)\n```\n\n#### Windows (Cross-compilation)\n```bash\n# Install MinGW-w64\n# macOS: brew install mingw-w64\n# Ubuntu: sudo apt install mingw-w64\n\n# Cross-compile for Windows\nx86_64-w64-mingw32-g++ -std=c++17 -D_WIN32 -o navix-windows.exe src/*.cpp -static-libgcc -static-libstdc++\n```\n\n### Platform-Specific Notes\n\n#### Windows\n- Uses Windows Console API instead of ncurses\n- Simplified TUI interface optimized for Windows terminal\n- All core functionality is preserved\n- Executable is statically linked for easy distribution\n\n#### Unix/Linux/macOS\n- Full ncurses-based TUI with rich interface\n- Advanced color support and window management\n- Requires ncurses development headers\n\n## Resolving the ncurses Issue\n\nIf you encounter the error:\n```\nfatal error: ncurses.h: No such file or directory\n```\n\nThis happens when trying to compile for Windows, which doesn't have ncurses. The project now includes:\n\n1. **Conditional compilation**: Uses ncurses on Unix/Linux/macOS, Windows Console API on Windows\n2. **Cross-platform abstractions**: Unified interface for both platforms\n3. **Automatic platform detection**: CMake and manual builds detect the target platform\n4. **Build scripts**: Automated building for both platforms\n\n## CMake Build (Alternative)\n\n```bash\n# Create build directory\nmkdir build \u0026\u0026 cd build\n\n# Configure for native platform\ncmake ..\nmake\n\n# Configure for Windows cross-compilation\ncmake -DCMAKE_TOOLCHAIN_FILE=../cmake/mingw-w64-toolchain.cmake ..\nmake\n```\n\n## Dependencies\n\n### Runtime Dependencies\n- **Unix/Linux/macOS**: ncurses library\n- **Windows**: No external dependencies (statically linked)\n\n### Build Dependencies\n- **All platforms**: C++17 compatible compiler\n- **Unix/Linux/macOS**: ncurses development headers, pkg-config\n- **Windows cross-compilation**: MinGW-w64 toolchain\n\n## Installation\n\n### Option 1: Linux Debian Package (Recommended for Ubuntu/Debian)\n\n```bash\n# Build and create .deb package\ngit clone https://github.com/zidniryi/navix.git\ncd navix\n./build_deb.sh\n\n# Install the package\nsudo dpkg -i navix_1.0.0_amd64.deb\n\n# If dependencies are missing, fix them with:\nsudo apt-get install -f\n\n# Verify installation\nnavix --version\n```\n\n### Option 2: macOS Package Installer (Recommended for macOS)\n\n```bash\n# Build and create package installer\ngit clone https://github.com/zidniryi/navix.git\ncd navix\n./build.sh pkg\n\n# Install the package\nsudo installer -pkg navix-installer.pkg -target /\n# Or double-click navix-installer.pkg in Finder\n\n# Verify installation\nnavix --version\n```\n\n### Option 3: Windows Executable (Recommended for Windows)\n\n```bash\n# Build and create Windows executable\ngit clone https://github.com/zidniryi/navix.git\ncd navix\n./build.sh windows\n\n# The navix-windows.exe file is ready to use\n# Copy to desired location or add to PATH\n\n# Verify\nnavix-windows.exe --version\n```\n\n### Option 4: Manual Build\n\n1. Clone the repository\n2. Install platform-specific dependencies\n3. Run the build script: `./build.sh all`\n4. Copy the appropriate executable to your desired location\n\n### Option 5: Direct Binary Usage\n\n```bash\n# Build without installation\n./build.sh native\n./navix-native /path/to/project\n```\n\n## Usage\n\n```bash\n# Unix/Linux/macOS\n./navix-native /path/to/your/project\n\n# Windows\nnavix-windows.exe C:\\path\\to\\your\\project\n```\n\n## Platform Support Matrix\n\n| Platform | TUI Interface | Symbol Indexing | Autocomplete | File Watching | Package Installer |\n|----------|---------------|-----------------|--------------|---------------|-------------------|\n| Linux    | ✅ (ncurses)   | ✅              | ✅           | ✅            | ✅ (.deb)         |\n| macOS    | ✅ (ncurses)   | ✅              | ✅           | ✅            | ✅ (.pkg)         |\n| Windows  | ✅ (Console)   | ✅              | ✅           | ✅            | ✅ (.exe)         |\n\n## Package Installer Features\n\n### Linux Debian Package (.deb)\n\nThe Debian package provides:\n\n- **System-wide installation**: Installs to `/usr/local/bin/navix`\n- **Automatic dependency management**: Handles ncurses dependencies\n- **Package manager integration**: Install/remove with `dpkg` or `apt`\n- **Clean uninstall**: `sudo dpkg -r navix`\n\n### macOS Package Installer (.pkg)\n\nThe macOS package installer provides:\n\n- **System-wide installation**: Installs to `/usr/local/bin/navix`\n- **Automatic PATH setup**: Available from any terminal\n- **Man page integration**: Access help with `man navix`\n- **Clean uninstall**: Proper removal of previous versions\n- **Documentation**: Includes README, LICENSE, and CONTRIBUTING files\n- **Installer scripts**: Pre/post-install automation\n- **Metadata**: Proper package identification and versioning\n\n### Windows Executable (.exe)\n\nThe Windows executable provides:\n\n- **Portable binary**: No installation required\n- **Static linking**: All dependencies included\n- **Console interface**: Windows-native TUI experience\n- **Easy distribution**: Single executable file\n\n### Package Contents\n\n#### Linux (.deb)\n```\n/usr/local/bin/navix                    # Main executable\n```\n\n#### macOS (.pkg)\n```\n/usr/local/bin/navix                    # Main executable\n/usr/local/share/man/man1/navix.1       # Man page\n/usr/local/share/doc/navix/README.md    # Documentation\n/usr/local/share/doc/navix/LICENSE      # License\n/usr/local/share/doc/navix/CONTRIBUTING.md  # Contributing guide\n```\n\n#### Windows (.exe)\n```\nnavix-windows.exe                       # Portable executable\n```\n\n## Documentation\n\n📚 **Complete Documentation Available!**\n\nFor comprehensive documentation including API reference, development guides, troubleshooting, and advanced usage examples, see:\n\n**[📖 DOCUMENTATION.md](https://zidniryi.xyz/navix.html)**\n\n### Documentation Sections:\n\n- **📋 Overview** - Project features and supported languages\n- **🏗️ Architecture** - Core components and class hierarchy  \n- **⚙️ Installation** - Platform-specific setup instructions\n- **🚀 Usage Guide** - Basic and advanced commands\n- **📖 API Reference** - Complete class and method documentation\n- **🔧 Development Guide** - Building from source and extending\n- **🛠️ Troubleshooting** - Common issues and solutions\n- **💡 Examples** - Practical usage and integration examples\n- **🤝 Contributing** - Guidelines for contributors\n\n### Quick Links:\n\n- **[Installation Guide](DOCUMENTATION.md#installation)** - Get started quickly\n- **[API Reference](DOCUMENTATION.md#api-reference)** - Complete API documentation\n- **[Usage Examples](DOCUMENTATION.md#examples)** - Practical examples\n- **[Troubleshooting](DOCUMENTATION.md#troubleshooting)** - Solve common issues\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on contributing to this project.\n\n## License\n\nThis project is licensed under the terms specified in [LICENSE](LICENSE).\n\n---\n\n**Note**: The cross-platform support ensures that Navix works seamlessly across different operating systems while maintaining full functionality. The Windows version uses a simplified but fully functional console interface that provides the same core navigation and indexing capabilities. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzidniryi%2Fnavix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzidniryi%2Fnavix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzidniryi%2Fnavix/lists"}