A CLI tool that analyzes character and sequence frequencies in your project to guide key remapping, with table/JSON/CSV outputs and a filter-rich TUI.
CLI tool with a text-based UI (TUI) and multi-format outputs (table, JSON, CSV)
2025-08-26
- Website
Highlight 1
It provides actionable, data-driven insights into character usage and sequences across a project, which can inform keyboard remapping decisions.
Highlight 2
terminal table views plus machine-friendly formats (JSON/CSV), plus an interactive TUI with filters for targeted exploration.
Highlight 3
Language-agnostic analysis supports multi-language projects, enabling consistent decision-making across diverse codebases.
Improvement 1
Documentation and onboarding could be enhanced with quick-start guides, example workflows, and a few remapping strategy recommendations tied to the data.
Improvement 2
Performance and scalability for very large repositories could be improved (e.g., parallel processing, incremental scans, and better handling of large binary-heavy directories).
Improvement 3
Robustness in edge cases (ignore node_modules/vendor, handle symlinks, detect and skip binary files) and clearer error messaging would improve reliability and user satisfaction.
Product Functionality
• Add a quick-start wizard and example remapping scenarios tied to the analyzed data. • Support comparing multiple projects or branches side-by-side. • Introduce incremental or cached analysis to speed up repeated runs. • Implement ignore rules (e.g., skip node_modules, build outputs) and extensible language/file-type profiling. • Provide preset profiles (ergonomic, frequency-based, language-specific) to guide remapping decisions.
UI & UX
• Improve TUI accessibility (keyboard shortcuts, consistent color themes, focus indicators). • Add a concise help panel and inline hints for filters and exports. • Provide export previews (e.g., a sample of JSON/CSV output) before saving. • Enhance visual readability (line height, font handling, high-contrast modes) for long analysis sessions.
SEO or Marketing
• Strengthen README with a clear value proposition, usage examples, and a short video/demo. • Add installation badges (build status, license, version) and a quickstart section. • Create targeted content around keywords like 'character frequency analysis', 'keyboard remapping', and 'typing pattern analysis' to improve discoverability. • Consider blog posts or case studies showing how Symbolista informs remapping decisions in real projects.
MultiLanguage Support
• Localize CLI help text, prompts, and UI strings into multiple languages. • Provide translated README and docs to broaden appeal. • Consider community-driven translations and an in-app language switch for the TUI. • Include accessibility-focused translations and ensure font rendering works well across locales.
- 1
What is Symbolista and what problem does it solve?
Symbolista is a CLI tool that analyzes a codebase to quantify character usage and sequences. It helps users decide which keys to remap for more efficient or ergonomic typing by providing data-driven insights about typing patterns in a project.
- 2
What outputs does Symbolista provide and how can I view them?
Symbolista can display results as a terminal table and export data as JSON or CSV. It also includes a text-based UI (TUI) with interactive filters to explore results by language, file type, and directory structure.
- 3
How do I install and run Symbolista?
Refer to the repository README for installation steps. Typical usage involves cloning the repo, building the binary according to the project’s build instructions, and running the tool with the path to your project directory plus optional flags to control output formats and filters.