{"id":29821046,"url":"https://github.com/cod-e-codes/parsec","last_synced_at":"2025-10-30T20:40:06.333Z","repository":{"id":306306072,"uuid":"1025735424","full_name":"Cod-e-Codes/parsec","owner":"Cod-e-Codes","description":"A fast terminal-based file inspector with live preview, fuzzy search, and multi-language support. Built for developers who need rapid code browsing.","archived":false,"fork":false,"pushed_at":"2025-09-22T10:25:10.000Z","size":413,"stargazers_count":15,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-17T06:46:54.311Z","etag":null,"topics":["bubbletea","cli-app","code-analysis","developer-tools","file-explorer","file-inspector","fuzzy-search","golang","lipgloss","markdown-viewer","source-code-analysis","terminal-application","terminal-ui","tui"],"latest_commit_sha":null,"homepage":"https://github.com/Cod-e-Codes/parsec","language":"Go","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/Cod-e-Codes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-24T18:01:51.000Z","updated_at":"2025-09-22T10:25:08.000Z","dependencies_parsed_at":"2025-10-17T02:05:31.665Z","dependency_job_id":"bd1c43de-7b2d-4e76-aaaa-9d528de42cd4","html_url":"https://github.com/Cod-e-Codes/parsec","commit_stats":null,"previous_names":["cod-e-codes/parsec"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Cod-e-Codes/parsec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fparsec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fparsec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fparsec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fparsec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cod-e-Codes","download_url":"https://codeload.github.com/Cod-e-Codes/parsec/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fparsec/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281178831,"owners_count":26456678,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-26T02:00:06.575Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["bubbletea","cli-app","code-analysis","developer-tools","file-explorer","file-inspector","fuzzy-search","golang","lipgloss","markdown-viewer","source-code-analysis","terminal-application","terminal-ui","tui"],"created_at":"2025-07-28T23:39:24.303Z","updated_at":"2025-10-30T20:40:06.285Z","avatar_url":"https://github.com/Cod-e-Codes.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Parsec: Terminal-Based File Summarizer TUI\r\n\r\nParsec 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.\r\n\r\n## Demo\r\n\r\n![Demo](demo.gif)\r\n\r\n*Parsec's split-screen interface showing file summaries and executable help display*\r\n\r\n## Features\r\n\r\n- Split-screen interface with file tree and detailed summary view\r\n- Directory navigation with live content preview\r\n- Real-time fuzzy search capabilities\r\n- Multi-language support: Go, Python, JavaScript, TypeScript, Rust, Java, C/C++\r\n- Enhanced file parsing:\r\n  - Markdown rendering with syntax highlighting\r\n  - Configuration file parsing (JSON, YAML, INI, ENV)\r\n  - Text file preview with line counts\r\n  - Executable help text extraction\r\n- Intelligent parsing of functions, imports, types, and structs\r\n- Responsive design with terminal resize handling\r\n- Keyboard-driven interface with vim-style bindings\r\n- Asynchronous operations for smooth performance\r\n\r\n## Installation\r\n\r\n### From Binary Release (Recommended)\r\n\r\n1. Download the appropriate zip file for your platform from the [Releases](#releases) section\r\n2. Extract the executable from the zip file\r\n3. Make it executable (Linux/macOS only):\r\n   ```bash\r\n   chmod +x parsec\r\n   ```\r\n4. Run the application:\r\n   ```bash\r\n   ./parsec [directory]\r\n   ```\r\n\r\n### From Source\r\n\r\n```bash\r\ngit clone https://github.com/Cod-e-Codes/parsec.git\r\ncd parsec\r\ngo build .\r\n```\r\n\r\n## Usage\r\n\r\n```bash\r\n# Scan current directory\r\n./parsec\r\n\r\n# Scan specific directory\r\n./parsec /path/to/project\r\n\r\n# Windows paths\r\n./parsec \"C:\\Users\\username\\Projects\"\r\n\r\n# Unix paths\r\n./parsec /home/user/code\r\n\r\n# Show help\r\n./parsec -h\r\n```\r\n\r\n## Keyboard Controls\r\n\r\n| Key | Action |\r\n|-----|--------|\r\n| `↑/↓` or `k/j` | Navigate file list |\r\n| `Enter` | Enter directory or open file |\r\n| `/` | Start fuzzy search |\r\n| `PgUp/PgDn` | Scroll summary content |\r\n| `Home/End` | Jump to first/last file |\r\n| `t` | Toggle directory visibility |\r\n| `r` | Refresh current directory |\r\n| `q` or `Ctrl+C` | Quit |\r\n\r\n## Supported File Types\r\n\r\n| Category | Extensions | Features |\r\n|----------|------------|-----------|\r\n| Programming | `.go` `.py` `.js` `.ts` `.rs` `.java` `.c` `.cpp` `.cc` | Functions, types, imports |\r\n| Documentation | `.md` `.markdown` `.rst` | Headers, links, rendered content |\r\n| Configuration | `.json` `.yaml` `.ini` `.env` | Keys, structure |\r\n| Data | `.xml` `.csv` `.log` | Content preview |\r\n| Executables | `.exe` `.bin` | Help text extraction |\r\n\r\n## Project Structure\r\n\r\n```\r\nparsec/\r\n├── main.go             # Application entrypoint\r\n├── ui/                 # Interface components\r\n├── core/               # Analysis engine\r\n├── utils/              # Utilities\r\n└── docs/              # Documentation\r\n```\r\n\r\n## Contributing\r\n\r\nParsec welcomes contributions from the community. Please review our contribution guidelines before getting started:\r\n\r\n- [Code of Conduct](CODE_OF_CONDUCT.md)\r\n- [Contributing Guidelines](CONTRIBUTING.md)\r\n- [Security Policy](SECURITY.md)\r\n\r\n### Development Process\r\n\r\n1. Fork the repository\r\n2. Create a feature branch\r\n3. Make your changes\r\n4. Test thoroughly\r\n5. Submit a pull request\r\n\r\n### Reporting Issues\r\n\r\nWhen reporting bugs, please include:\r\n- Operating system details\r\n- Steps to reproduce\r\n- Expected vs actual behavior\r\n- Error messages if applicable\r\n\r\n## Security\r\n\r\nFor security concerns, please review our [Security Policy](SECURITY.md) before submitting a report.\r\n\r\n## Dependencies\r\n\r\nDependencies are managed through Go modules and automatically updated via Dependabot. Major version updates are handled manually to ensure stability.\r\n\r\n## License\r\n\r\nMIT License - see [LICENSE](LICENSE) file for details.\r\n\r\n## Releases\r\n\r\n### v0.2.0 (13 Aug 2025)\r\n**Commit:** 146795a\r\n\r\n**Key Changes:**\r\n- **UI Fix**: Resolved left-hand file tree width misalignment for entries missing icons or spaces\r\n- **Code Quality**: Eliminated duplicate `getFileIcon` functions by moving to shared `utils/ui.go`\r\n- **Maintainability**: Improved code organization and reduced duplication by ~100 lines\r\n\r\n**Assets:**\r\n- [parsec-v0.2.0-linux-amd64.zip](releases/parsec-v0.2.0-linux-amd64.zip) (6.8 MB)\r\n- [parsec-v0.2.0-darwin-amd64.zip](releases/parsec-v0.2.0-darwin-amd64.zip) (6.7 MB)\r\n- [parsec-v0.2.0-windows-amd64.zip](releases/parsec-v0.2.0-windows-amd64.zip) (7.1 MB)\r\n\r\n### v0.1.0-alpha\r\nInitial alpha release with core functionality.\r\n\r\n## Versioning\r\n\r\nParsec follows semantic versioning. The first stable release will be tagged as v1.0.0 once all core features are thoroughly tested. \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcod-e-codes%2Fparsec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcod-e-codes%2Fparsec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcod-e-codes%2Fparsec/lists"}