███╗ ██╗██╗ ██╗██╗ ██╗
████╗ ██║╚██╗ ██╔╝╚██╗██╔╝
██╔██╗ ██║ ╚████╔╝ ╚███╔╝
██║╚██╗██║ ╚██╔╝ ██╔██╗
██║ ╚████║ ██║ ██╔╝ ██╗
╚═╝ ╚═══╝ ╚═╝ ╚═╝ ╚═╝
The minimalist command-line nexus for productivity and system intelligence.
"In the silence of the void, efficiency thrives."
NYX is a lightweight, high-performance command-line interface designed to streamline your development workflow. Built with the speed of Python and the beauty of the Rich library, NYX provides a unified set of tools for note-taking, file organization, system statistics, and script execution.
Inspired by the primordial goddess of the night, NYX operates in the shadows of your terminal, providing powerful capabilities without the bloat of traditional GUI applications. It is designed for developers who value keyboard-centric workflows and terminal-based productivity.
A built-in note management system that lives in your home directory. Add thoughts, search through history, and edit your notes directly in your favorite editor.
nyx notes add "New idea"nyx notes search "bugfix"nyx notes edit
Get deep insights into your file system. NYX analyzes directory structures, calculates sizes, and breaks down file types with beautiful tabular formatting.
nyx stats folder .nyx stats size ./data
Quickly navigate and audit your project structures. NYX identifies directories and files with clear visual cues, making directory traversal seamless.
nyx organize files .
Execute Python scripts with zero friction. NYX handles the execution environment and provides clean error reporting through its internal runner.
nyx run script.py
One command to open your Nyx configuration and workspace folder.
nyx ..
NYX is designed for the terminal enthusiast who appreciates a dark, cosmic aesthetic.
Theme: Neo-Minimalism × Void Violet × Cosmic Shadows
Primary: #1A1A2E — deep space black
Accent: #6A0DAD → #A020F0 — dark violet to neon purple
Output: Rich-enhanced tables, panels, and syntax highlighting
Typography: JetBrains Mono / Fira Code (recommended)
| Layer | Technology |
|---|---|
| Language | Python 3.10+ |
| CLI Framework | Typer |
| Formatting | Rich |
| File System | Pathlib |
| Metadata | importlib.metadata |
Phase 1 — Core CLI & Toolset [ RELEASED ]
Phase 2 — AI Integration (Inference & Training) [ IN PROGRESS ]
Phase 3 — Advanced File Automation & Sorting [ COMING SOON ]
Phase 4 — System Monitoring Dashboard [ COMING SOON ]
Phase 5 — Plugin & Extension API [ COMING SOON ]
On the horizon:
- 🤖 Neural Engine: Integrated local model inference for code analysis.
- 🧹 Auto-Organize: Rule-based file sorting and cleanup.
- 📈 Telemetry: Real-time resource usage graphs in the terminal.
- 🕸️ Nyx Web: A minimal web interface to sync notes across devices.
| The Old Way | The NYX Way |
|---|---|
Scattered .txt files everywhere |
Centralized, searchable note system |
Manual du -sh and complex grep |
Beautiful, formatted folder statistics |
| Opening Explorer to find config files | Instant access with nyx .. |
| Bloated task managers | Lightweight, terminal-native utilities |
# Install Nyx locally
pip install -e .
# Check version
nyx --version
# Add your first note
nyx notes add "Nyx is successfully installed."MIT — Licensed under the stars.
「 Command the night. Execute with precision. 」
NYX is watching.
Embrace the void. Streamline the workflow.
Built for speed. Styled for the dark.