Parsec is a fast, terminal-based file inspector that provides immediate summaries of source code files. Built for developers who need rapid context-aware code browsing.

Parsec's split-screen interface showing file summaries and executable help display

• Split-screen interface with file tree and detailed summary view
• Directory navigation with live content preview
• Real-time fuzzy search capabilities
• Multi-language support: Go, Python, JavaScript, TypeScript, Rust, Java, C/C++
• Enhanced file parsing:
  • Markdown rendering with syntax highlighting
  • Configuration file parsing (JSON, YAML, INI, ENV)
  • Text file preview with line counts
  • Executable help text extraction
• Intelligent parsing of functions, imports, types, and structs
• Responsive design with terminal resize handling
• Keyboard-driven interface with vim-style bindings
• Asynchronous operations for smooth performance

1. Download the appropriate zip file for your platform from the Releases section
2. Extract the executable from the zip file
3. Make it executable (Linux/macOS only):

   chmod +x parsec

4. Run the application:

   ./parsec [directory]

git clone https://github.com/Cod-e-Codes/parsec.git cd parsec go build .

# Scan current directory ./parsec # Scan specific directory ./parsec /path/to/project # Windows paths ./parsec "C:\Users\username\Projects" # Unix paths ./parsec /home/user/code # Show help ./parsec -h

parsec/ ├── main.go # Application entrypoint ├── ui/ # Interface components ├── core/ # Analysis engine ├── utils/ # Utilities └── docs/ # Documentation 

Parsec welcomes contributions from the community. Please review our contribution guidelines before getting started:

• Code of Conduct
• Contributing Guidelines
• Security Policy

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

When reporting bugs, please include:

• Operating system details
• Steps to reproduce
• Expected vs actual behavior
• Error messages if applicable

For security concerns, please review our Security Policy before submitting a report.

Dependencies are managed through Go modules and automatically updated via Dependabot. Major version updates are handled manually to ensure stability.

MIT License - see LICENSE file for details.

Commit: 146795a

Key Changes:

• UI Fix: Resolved left-hand file tree width misalignment for entries missing icons or spaces
• Code Quality: Eliminated duplicate getFileIcon functions by moving to shared utils/ui.go
• Maintainability: Improved code organization and reduced duplication by ~100 lines

Assets:

• parsec-v0.2.0-linux-amd64.zip (6.8 MB)
• parsec-v0.2.0-darwin-amd64.zip (6.7 MB)
• parsec-v0.2.0-windows-amd64.zip (7.1 MB)

Initial alpha release with core functionality.

Parsec follows semantic versioning. The first stable release will be tagged as v1.0.0 once all core features are thoroughly tested.