zyphor 0.1.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +365 -0
- package/package.json +6 -1
package/README.md
ADDED
|
@@ -0,0 +1,365 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
<picture>
|
|
3
|
+
<img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/assets/logo.svg" alt="ZYPHOR Logo" width="700">
|
|
4
|
+
</picture>
|
|
5
|
+
|
|
6
|
+
<p align="center">
|
|
7
|
+
<strong>A mercilessly optimized, zero-allocation native systems observatory, real-time diagnostic engine, and process profiler.</strong>
|
|
8
|
+
</p>
|
|
9
|
+
|
|
10
|
+
[](https://github.com/miyaniakshar1234/Zyphor/actions)
|
|
11
|
+
[](https://ziglang.org)
|
|
12
|
+
[](https://github.com/miyaniakshar1234/Zyphor/releases)
|
|
13
|
+
[](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/architecture.md)
|
|
14
|
+
[](https://github.com/miyaniakshar1234/Zyphor/blob/master/LICENSE)
|
|
15
|
+
|
|
16
|
+
<p align="center">
|
|
17
|
+
<a href="#-why-zyphor-the-manifesto">The Manifesto</a> •
|
|
18
|
+
<a href="#-interface-gallery--subsystems">Interface Gallery</a> •
|
|
19
|
+
<a href="#-feature-matrix--comparison">Comparison</a> •
|
|
20
|
+
<a href="#-core-architecture--systems-design">Architecture</a> •
|
|
21
|
+
<a href="#-cli-toolchain--automation">CLI Suite</a> •
|
|
22
|
+
<a href="#-keyboard-controls--navigation">Keybinds</a> •
|
|
23
|
+
<a href="#-installation--getting-started">Installation</a> •
|
|
24
|
+
<a href="#-about-the-developer">Author</a> •
|
|
25
|
+
<a href="https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/user-manual.md">User Manual</a>
|
|
26
|
+
</p>
|
|
27
|
+
|
|
28
|
+
<br>
|
|
29
|
+
|
|
30
|
+
<!-- Primary Hero Live Dashboard -->
|
|
31
|
+
<picture>
|
|
32
|
+
<img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/01-overview.png" alt="Zyphor Overview Dashboard" width="920">
|
|
33
|
+
</picture>
|
|
34
|
+
</div>
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 🛑 Why Zyphor? (The Manifesto)
|
|
39
|
+
|
|
40
|
+
Modern system monitoring software has lost its way.
|
|
41
|
+
|
|
42
|
+
On one side, we have **bloated GUI applications and Electron wrappers** that consume hundreds of megabytes of RAM, take seconds to boot, and spin up entire Chromium browser instances just to display a CPU percentage. On the other side, we have **legacy terminal monitors** that write raw ANSI streams directly to `stdout`, causing severe visual tearing, flickering at high frame rates, and dropping frames when rendering complex graphs.
|
|
43
|
+
|
|
44
|
+
**Zyphor was designed and engineered by Akshar Miyani to eliminate this compromise.**
|
|
45
|
+
|
|
46
|
+
Built from bare metal in **Zig**, Zyphor operates on pure systems-programming principles:
|
|
47
|
+
1. **Direct Kernel Interfacing:** Bypasses slow management abstraction layers (like Windows WMI) in favor of raw ring-0 telemetry via `ntdll.dll` (`NtQuerySystemInformation`) on Windows and zero-copy `/proc` parsing on Linux.
|
|
48
|
+
2. **Zero-Allocation Render Loop:** The entire rendering pipeline runs with **zero general-purpose heap allocations** in the hot path. All frame allocations utilize dual swapping `ArenaAllocators` with instantaneous pointer resets.
|
|
49
|
+
3. **Double-Buffered Differential ANSI Engine:** Frames are rendered to an off-screen virtual framebuffer and diffed against the previous frame at the cell level. Only modified screen cells emit ANSI escape codes, yielding absolute zero flicker and rock-solid 30–60 FPS rendering at less than **0.1% CPU overhead**.
|
|
50
|
+
4. **Autonomous Root-Cause Diagnostics:** Zyphor does not simply dump numbers; an embedded heuristic engine mathematically correlates telemetry (thermal velocity, VMM swap thrashing, I/O wait) to provide actionable English playbooks for resolving system bottlenecks.
|
|
51
|
+
5. **Standalone 1.1 MB Single-File Executable:** Statically linked with zero runtime dependencies. No DLLs, no Python virtual environments, no node_modules.
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## 📸 Interface Gallery & Subsystems
|
|
56
|
+
|
|
57
|
+
Zyphor provides 7 dedicated observatory panels alongside interactive profilers, command palettes, and custom themes.
|
|
58
|
+
|
|
59
|
+
### 1. Process Explorer & Storage Fabric
|
|
60
|
+
| Process Explorer & Lineage Trees (`2`) | Storage Fabric & Disk I/O (`3`) |
|
|
61
|
+
| :--- | :--- |
|
|
62
|
+
| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/02-processes.png" width="450" alt="Process Explorer"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/03-storage.png" width="450" alt="Storage Analyzer"> |
|
|
63
|
+
| Recursive DFS parent/child tree hierarchy (`t`), live sorting (`c`, `m`, `p`, `n`), real-time search (`/`), deep inspector (`Enter`), and process termination (`x`, `s`, `u`). | Real-time partition space distribution across all mounted drives (`NTFS`, `ext4`, `apfs`, `btrfs`), transfer throughput (MB/s), and storage IOPS. |
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
### 2. Network Observability & AI Root-Cause Diagnostics
|
|
68
|
+
| Network Observability & Active Sockets (`4`) | Autonomous Health & AI Diagnostics (`5`) |
|
|
69
|
+
| :--- | :--- |
|
|
70
|
+
| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/04-network.png" width="450" alt="Network Dashboard"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/05-health-diagnostics.png" width="450" alt="AI Diagnostics"> |
|
|
71
|
+
| Sub-cell Unicode Braille throughput curves, NIC adapter status cards, active TCP/UDP socket process mapping, and broadband speed testing (`s`, `S`). | 5-subsystem health radar (0–100 score), deterministic anomaly detection, explainable root-cause insights, and defensive action playbooks. |
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
### 3. Background Services & Container Observatory
|
|
76
|
+
| System Services & Background Daemons (`6`) | Container Observatory (Docker/OCI) (`7`) |
|
|
77
|
+
| :--- | :--- |
|
|
78
|
+
| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/06-services.png" width="450" alt="System Services"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/07-containers.png" width="450" alt="Containers"> |
|
|
79
|
+
| Real-time OS background service monitoring (Windows Services / systemd units), status tracking, startup modes, and binary inspector cards. | Direct cgroup telemetry, container RAM usage vs hard memory quota limits, CPU utilization, image tags, and isolated network I/O. |
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
### 4. Interactive Profiler & Fast Command Launcher
|
|
84
|
+
| Microsecond Process Profiler (`P`) | Quick Action Command Palette (`:` / `Ctrl+P`) |
|
|
85
|
+
| :--- | :--- |
|
|
86
|
+
| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/09-profiler.png" width="450" alt="Process Profiler"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/08-command-palette.png" width="450" alt="Command Palette"> |
|
|
87
|
+
| 10-second high-frequency rolling telemetry trace on any selected PID. Computes Peak Jitter, Rolling Averages, and Memory Leaks. | Floating keyboard launcher for instant jumps, theme cycling, hardware benchmarks, telemetry freezing, and instant state exports. |
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
### 5. Hand-Tuned 24-Bit TrueColor Theme Catalog
|
|
92
|
+
| Anthropic (Default Warm Aesthetic) | Cyber (High-Contrast Neon Cyberpunk) |
|
|
93
|
+
| :--- | :--- |
|
|
94
|
+
| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/10-theme-anthropic.png" width="450" alt="Anthropic Theme"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/11-theme-cyber.png" width="450" alt="Cyber Theme"> |
|
|
95
|
+
| Warm dark charcoal (`#1F1D1C`), terracotta accents (`#D97757`), sand highlights, and sage green nominal meters. | High-contrast synthwave palette featuring electric cyan (`#00F0FF`) and vibrant neon magenta (`#FF0080`). |
|
|
96
|
+
|
|
97
|
+
*Zyphor includes 10 built-in palettes (Anthropic, Cyber, Tokyo Night, Hacker, Midnight, Aurora, Nord, Solarized Dark, Gruvbox, High Contrast). Hot-swap instantly with <kbd>]</kbd> or <kbd>Shift+T</kbd>.*
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## 📊 Feature Matrix & Comparison
|
|
102
|
+
|
|
103
|
+
| Feature / Metric | **Zyphor** | **btop++** | **htop** | **Glances** | **Windows Task Mgr** |
|
|
104
|
+
| :--- | :---: | :---: | :---: | :---: | :---: |
|
|
105
|
+
| **Implementation Language** | **Zig (Native)** | C++ | C | Python | C++ / WinUI |
|
|
106
|
+
| **Binary Size** | **1.1 MB** | ~8.2 MB | ~3.5 MB | ~45 MB (deps) | System Native |
|
|
107
|
+
| **Memory Usage (RAM)** | **< 3 MB** | ~25 MB | ~5 MB | ~90 MB | ~60 MB |
|
|
108
|
+
| **Zero-Allocation Render Path** | **Yes (Dual Arena)** | No | No | No | No |
|
|
109
|
+
| **Double-Buffered Diff Engine** | **Yes (Zero Flicker)** | Partial | No (Flickers) | No | N/A |
|
|
110
|
+
| **Autonomous AI Diagnostics** | **Yes (Deterministic)**| No | No | Basic Alerts | No |
|
|
111
|
+
| **Time-Bound Process Profiler** | **Yes (Hotkey `P`)** | No | No | No | No |
|
|
112
|
+
| **Remote HTTP / TCP JSON Daemon**| **Yes (`zyphor daemon`)**| No | No | Yes (Web UI) | No |
|
|
113
|
+
| **Instant Telemetry Snapshot (`E`)**| **Yes (`.json`)** | No | No | Export flags | No |
|
|
114
|
+
| **Container Engine Telemetry** | **Yes (Docker/OCI)** | No | No | Yes | No |
|
|
115
|
+
| **Parent-Child Lineage Tree** | **Yes (`t` DFS)** | Yes | Yes | No | Partial |
|
|
116
|
+
| **Command Palette (`Ctrl+P`)** | **Yes** | No | No | No | No |
|
|
117
|
+
| **24-Bit TrueColor Palettes** | **10 Built-in** | Custom RGB | 16-color | 16-color | OS Theme |
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## 🧠 Core Architecture & Systems Design
|
|
122
|
+
|
|
123
|
+
Zyphor's extreme performance is achieved through strict adherence to **Data-Oriented Design (DOD)** and cache-locality principles.
|
|
124
|
+
|
|
125
|
+
```
|
|
126
|
+
┌──────────────────────────────────────────────┐
|
|
127
|
+
│ OPERATING SYSTEM │
|
|
128
|
+
│ Windows (ntdll) / Linux (/proc) │
|
|
129
|
+
└──────────────────────┬───────────────────────┘
|
|
130
|
+
│ Direct Syscalls / Zero-Copy Reads
|
|
131
|
+
▼
|
|
132
|
+
┌──────────────────────────────────────────────┐
|
|
133
|
+
│ CORE TELEMETRY ENGINE │
|
|
134
|
+
│ CPU • RAM • Disks • Network • Services │
|
|
135
|
+
└──────────────────────┬───────────────────────┘
|
|
136
|
+
│
|
|
137
|
+
├──────────────────────────┐
|
|
138
|
+
│ Snapshot Data │
|
|
139
|
+
▼ ▼
|
|
140
|
+
┌──────────────────────────────────────────────┐ ┌────────────────────────┐
|
|
141
|
+
│ DOUBLE ARENA ALLOCATION MODEL │ │ HEURISTIC AI ENGINE │
|
|
142
|
+
│ [FrameArenaA] ──swap──> [FrameArenaB] │ │ Thermal / Thrashing │
|
|
143
|
+
│ (Zero heap mallocs in critical loop) │ │ Anomaly Correlator │
|
|
144
|
+
└──────────────────────┬───────────────────────┘ └──────────┬─────────────┘
|
|
145
|
+
│ │
|
|
146
|
+
▼ ▼
|
|
147
|
+
┌───────────────────────────────────────────────────────────────────────────┐
|
|
148
|
+
│ DOUBLE-BUFFERED DIFFERENTIAL RENDERER │
|
|
149
|
+
│ │
|
|
150
|
+
│ [Current Virtual Framebuffer] <───diff───> [Previous Screen Framebuffer]│
|
|
151
|
+
│ │
|
|
152
|
+
│ Compute Cell Mutex Deltas: │
|
|
153
|
+
│ dirty_cells = (curr[i] != prev[i]) │
|
|
154
|
+
└──────────────────────────────────────┬────────────────────────────────────┘
|
|
155
|
+
│
|
|
156
|
+
▼ Only modified ANSI sequences emitted
|
|
157
|
+
┌──────────────────────────────┐
|
|
158
|
+
│ TERMINAL EMULATOR │
|
|
159
|
+
│ Zero Tearing • 30–60 FPS │
|
|
160
|
+
└──────────────────────────────┘
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### Key Architectural Invariants:
|
|
164
|
+
1. **The Double-Arena Memory Model:** Two static arenas (`ArenaAllocator`) alternate every frame. Dynamic process lists and strings are allocated into the active arena. At the start of the next cycle, the inactive arena is completely cleared via an `O(1)` pointer reset, preventing heap fragmentation and memory leaks entirely.
|
|
165
|
+
2. **Cell-Level Differential Rendering:** The screen is maintained as an array of `Cell` structures containing glyphs and 24-bit RGB values. The rendering pass updates an off-screen buffer. The diffing pass compares `current_cells[i]` against `prev_cells[i]` and generates an optimized ANSI sequence that positions the cursor only where data has changed.
|
|
166
|
+
3. **Low-Latency Platform Probes:**
|
|
167
|
+
* On **Windows**, Zyphor links dynamically against `ntdll.dll` to invoke `NtQuerySystemInformation(SystemProcessInformation)`, retrieving global thread and process states in a single atomic kernel transition.
|
|
168
|
+
* On **Linux**, Zyphor performs zero-copy parsing of `/proc/stat`, `/proc/meminfo`, `/proc/net/dev`, and `/proc/[pid]/stat` using pre-allocated stack buffers without regular expression engines.
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## 🛠️ CLI Toolchain & Automation
|
|
173
|
+
|
|
174
|
+
Zyphor is designed for both interactive monitoring and automated headless scripting in CI/CD pipelines.
|
|
175
|
+
|
|
176
|
+
```bash
|
|
177
|
+
# 1. Start the interactive Zero-Flicker TUI
|
|
178
|
+
zyphor
|
|
179
|
+
|
|
180
|
+
# 2. Start TUI with a specific TrueColor theme (e.g., cyber, tokyo_night, hacker, nord)
|
|
181
|
+
zyphor --theme cyber
|
|
182
|
+
|
|
183
|
+
# 3. Plain ASCII mode for minimal or legacy terminals
|
|
184
|
+
zyphor --plain
|
|
185
|
+
|
|
186
|
+
# 4. Run an automated environment audit (Kernel probes, permissions, sensors)
|
|
187
|
+
zyphor doctor
|
|
188
|
+
|
|
189
|
+
# 5. Run native CPU compute (Integer MOP/s) and RAM bandwidth (GB/s) benchmarks
|
|
190
|
+
zyphor bench
|
|
191
|
+
|
|
192
|
+
# 6. Prove Zyphor's lightweight nature (Measures telemetry sampling latency & RAM footprint)
|
|
193
|
+
zyphor overhead
|
|
194
|
+
|
|
195
|
+
# 7. Start the headless TCP daemon streaming live JSON telemetry on port 7777
|
|
196
|
+
zyphor daemon
|
|
197
|
+
|
|
198
|
+
# 8. Export an instantaneous, comprehensive system telemetry snapshot to JSON
|
|
199
|
+
zyphor snapshot -o system-state.json
|
|
200
|
+
|
|
201
|
+
# 9. Query top processes from the CLI without launching the TUI
|
|
202
|
+
zyphor process --sort cpu --limit 10
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
---
|
|
206
|
+
|
|
207
|
+
## 🎮 Keyboard Controls & Navigation
|
|
208
|
+
|
|
209
|
+
Zyphor supports standard navigation keys, arrow keys, and full **Vim-style navigation** (`h`, `j`, `k`, `l`, `g`, `G`).
|
|
210
|
+
|
|
211
|
+
### Viewport Navigation
|
|
212
|
+
| Hotkey | Action | Description |
|
|
213
|
+
| :--- | :---: | :--- |
|
|
214
|
+
| <kbd>1</kbd> .. <kbd>7</kbd> | Direct Jump | Switch to Overview, Processes, Disks, Network, Health, Services, or Containers. |
|
|
215
|
+
| <kbd>Tab</kbd> / <kbd>Shift+Tab</kbd> | Next / Prev Tab | Advance viewport sequentially across panels. |
|
|
216
|
+
| <kbd>:</kbd> or <kbd>Ctrl+P</kbd> | Command Palette | Open floating quick-action command launcher. |
|
|
217
|
+
| <kbd>?</kbd> | Help Overlay | Display full modal cheatsheet of all keyboard shortcuts. |
|
|
218
|
+
| <kbd>q</kbd> or <kbd>Ctrl+C</kbd> | Clean Exit | Restore terminal cursor state and exit cleanly. |
|
|
219
|
+
|
|
220
|
+
### Process & List Manipulation
|
|
221
|
+
| Hotkey | Action | Description |
|
|
222
|
+
| :--- | :---: | :--- |
|
|
223
|
+
| <kbd>j</kbd> / <kbd>k</kbd> or <kbd>↓</kbd> / <kbd>↑</kbd> | Navigate Cursor | Move process / service selection down or up. |
|
|
224
|
+
| <kbd>g</kbd> / <kbd>G</kbd> | Top / Bottom | Jump cursor to the top or bottom of the list. |
|
|
225
|
+
| <kbd>PgUp</kbd> / <kbd>PgDn</kbd> | Page Scroll | Scroll list by 10 items at a time. |
|
|
226
|
+
| <kbd>/</kbd> | Global Search | Enter live search filter mode (filters active panel in real time). |
|
|
227
|
+
| <kbd>Esc</kbd> | Clear / Close | Clear active search query or close the open modal. |
|
|
228
|
+
| <kbd>Enter</kbd> | Deep Inspector | Toggle side-pane telemetry inspector for selected item. |
|
|
229
|
+
| <kbd>t</kbd> | Lineage Tree | Toggle hierarchical DFS process parent/child tree mode. |
|
|
230
|
+
| <kbd>c</kbd> / <kbd>m</kbd> / <kbd>p</kbd> / <kbd>n</kbd> | Sort Modes | Instantly sort by CPU%, Memory (RSS), PID, or Name. |
|
|
231
|
+
| <kbd>x</kbd> | Terminate (Kill) | Send `SIGKILL` / `TerminateProcess` to highlighted process. |
|
|
232
|
+
| <kbd>s</kbd> | Suspend | Send `SIGSTOP` to pause execution of target process. |
|
|
233
|
+
| <kbd>u</kbd> | Resume | Send `SIGCONT` to unpause execution of target process. |
|
|
234
|
+
|
|
235
|
+
### Telemetry & Diagnostics Control
|
|
236
|
+
| Hotkey | Action | Description |
|
|
237
|
+
| :--- | :---: | :--- |
|
|
238
|
+
| <kbd>P</kbd> | Process Profiler | Launch 10-second high-frequency telemetry trace on selected PID. |
|
|
239
|
+
| <kbd>E</kbd> | Export Snapshot | Dump instantaneous machine state to `zyphor-export-[timestamp].json`. |
|
|
240
|
+
| <kbd>Space</kbd> | Freeze Telemetry | Pause live sampling loop to freeze screen metrics for inspection. |
|
|
241
|
+
| <kbd>]</kbd> or <kbd>Shift+T</kbd> | Cycle Theme | Hot-swap between all 10 built-in 24-bit TrueColor palettes. |
|
|
242
|
+
|
|
243
|
+
---
|
|
244
|
+
|
|
245
|
+
## 📦 Installation & Getting Started
|
|
246
|
+
|
|
247
|
+
Zyphor compiles to a single, standalone `1.1 MB` static executable.
|
|
248
|
+
|
|
249
|
+
### 1. One-Line Universal Installers
|
|
250
|
+
|
|
251
|
+
#### Linux & macOS (Bash / Zsh):
|
|
252
|
+
```bash
|
|
253
|
+
curl -fsSL https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/install.sh | bash
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
#### Windows (PowerShell):
|
|
257
|
+
```powershell
|
|
258
|
+
irm https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/install.ps1 | iex
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
---
|
|
262
|
+
|
|
263
|
+
### 2. JavaScript & Web Toolchains (NPM, Bun, PNPM)
|
|
264
|
+
|
|
265
|
+
```bash
|
|
266
|
+
# Execute immediately via npx
|
|
267
|
+
npx zyphor
|
|
268
|
+
|
|
269
|
+
# Or install globally
|
|
270
|
+
npm install -g zyphor
|
|
271
|
+
bun install -g zyphor
|
|
272
|
+
pnpm add -g zyphor
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
---
|
|
276
|
+
|
|
277
|
+
### 3. Rust Ecosystem (Cargo / Crates.io)
|
|
278
|
+
|
|
279
|
+
```bash
|
|
280
|
+
cargo install zyphor
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
---
|
|
284
|
+
|
|
285
|
+
### 4. Native Package Managers
|
|
286
|
+
|
|
287
|
+
#### macOS & Linux (Homebrew):
|
|
288
|
+
```bash
|
|
289
|
+
brew tap miyaniakshar1234/zyphor
|
|
290
|
+
brew install zyphor
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
#### Windows (Winget):
|
|
294
|
+
```powershell
|
|
295
|
+
winget install miyaniakshar1234.Zyphor
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
#### Windows (Scoop):
|
|
299
|
+
```powershell
|
|
300
|
+
scoop bucket add zyphor https://github.com/miyaniakshar1234/scoop-zyphor
|
|
301
|
+
scoop install zyphor
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
#### Arch Linux (AUR):
|
|
305
|
+
```bash
|
|
306
|
+
yay -S zyphor-bin
|
|
307
|
+
# or
|
|
308
|
+
paru -S zyphor-bin
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
---
|
|
312
|
+
|
|
313
|
+
### 5. Build from Source
|
|
314
|
+
|
|
315
|
+
Building Zyphor requires [Zig 0.15.2+](https://ziglang.org/download/):
|
|
316
|
+
|
|
317
|
+
```bash
|
|
318
|
+
# Clone the repository
|
|
319
|
+
git clone https://github.com/miyaniakshar1234/Zyphor.git
|
|
320
|
+
cd Zyphor
|
|
321
|
+
|
|
322
|
+
# Compile with ReleaseFast optimizations
|
|
323
|
+
zig build -Doptimize=ReleaseFast
|
|
324
|
+
|
|
325
|
+
# The optimized static binary is generated at:
|
|
326
|
+
./zig-out/bin/zyphor
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
---
|
|
330
|
+
|
|
331
|
+
## 📚 Exhaustive Documentation Index
|
|
332
|
+
|
|
333
|
+
For in-depth operational and engineering guides, explore the dedicated documentation suite:
|
|
334
|
+
|
|
335
|
+
| Document | Focus Area |
|
|
336
|
+
| :--- | :--- |
|
|
337
|
+
| 📖 [**Observatory User Manual**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/user-manual.md) | Complete guide to all 7 panels, process trees, inspector cards, profiling workflows, and metrics. |
|
|
338
|
+
| 🧠 [**Internal Systems Architecture**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/architecture.md) | Low-level design, memory models, double arenas, differential rendering, and zero-allocation invariants. |
|
|
339
|
+
| 🚨 [**Alerts & Diagnostics Engine**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/alerts-and-diagnostics.md) | Heuristic algorithms, 0–100 health scoring formulas, anomaly detection, and remediation playbooks. |
|
|
340
|
+
| 🧬 [**Platform Internals & Probes**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/platform-internals.md) | Kernel telemetry implementations: Windows NT direct syscalls, Linux `/proc` zero-copy, and macOS Mach probes. |
|
|
341
|
+
| 🤖 [**CLI & Automation Reference**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/cli-reference.md) | Comprehensive subcommand reference, JSON export schemas, Prometheus exporter integration, and scripting recipes. |
|
|
342
|
+
| 🎨 [**Theming & Customization**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/theming-and-customization.md) | 24-bit TrueColor tokens, custom palette configuration, and visual overrides. |
|
|
343
|
+
| 🔧 [**Troubleshooting & FAQ**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/troubleshooting.md) | Terminal compatibility, Windows console modes, Linux capability permissions (`CAP_SYS_PTRACE`), and FAQ. |
|
|
344
|
+
| 🤝 [**Contributing Guide**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/contributing.md) | Coding standards, memory safety invariants, testing harness, benchmarking requirements, and PR workflows. |
|
|
345
|
+
|
|
346
|
+
---
|
|
347
|
+
|
|
348
|
+
## 👨💻 About the Developer
|
|
349
|
+
|
|
350
|
+
Zyphor was architected, designed, and built by **Akshar Miyani**.
|
|
351
|
+
|
|
352
|
+
* **Philosophy:** Software should treat hardware with absolute respect. A diagnostic tool should never impose a significant burden on the system it is tasked with observing.
|
|
353
|
+
* **Focus:** Low-level systems engineering, cache-friendly data-oriented design, kernel telemetry, compiler-level optimizations, and modern terminal user experiences.
|
|
354
|
+
* **GitHub:** [@miyaniakshar1234](https://github.com/miyaniakshar1234)
|
|
355
|
+
* **Repository:** [https://github.com/miyaniakshar1234/Zyphor](https://github.com/miyaniakshar1234/Zyphor)
|
|
356
|
+
|
|
357
|
+
---
|
|
358
|
+
|
|
359
|
+
## 📄 License
|
|
360
|
+
|
|
361
|
+
Zyphor is open-source software licensed under the **MIT License**. See the [LICENSE](https://github.com/miyaniakshar1234/Zyphor/blob/master/LICENSE) file for details.
|
|
362
|
+
|
|
363
|
+
<div align="center">
|
|
364
|
+
<sub>Engineered with precision for the global systems community by <b>Akshar Miyani</b>.</sub>
|
|
365
|
+
</div>
|
package/package.json
CHANGED
|
@@ -1,11 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "zyphor",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "1.0.0",
|
|
4
4
|
"description": "Next-generation native terminal system observatory written in pure Zig",
|
|
5
5
|
"main": "bin/zyphor.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"zyphor": "bin/zyphor.js"
|
|
8
8
|
},
|
|
9
|
+
"files": [
|
|
10
|
+
"bin",
|
|
11
|
+
"scripts",
|
|
12
|
+
"README.md"
|
|
13
|
+
],
|
|
9
14
|
"scripts": {
|
|
10
15
|
"postinstall": "node scripts/install.js"
|
|
11
16
|
},
|