Skip to content

Commit d3539a1

Browse files
Michael Borckclaude
andcommitted
Enhance README with plaintext productivity benefits, hybrid setup variants, additional TUI/CLI tools, and expanded philosophy.
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent f29a927 commit d3539a1

1 file changed

Lines changed: 40 additions & 4 deletions

File tree

README.md

Lines changed: 40 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,14 @@ To define a modern, minimalist computing environment that prioritizes speed, foc
2222

2323
5. **Composition over Integration:** Following the Unix philosophy, the environment is built from simple, independent tools that work together. The user composes their ideal workflow rather than accepting a monolithic, pre-integrated desktop.
2424

25+
### Plain Text Productivity
26+
27+
Plain text is foundational to Kern, enabling focused, efficient workflows in development, writing, and productivity. By prioritizing human-readable formats like Markdown, Kern leverages Unix principles for simplicity and composability. Key benefits include:
28+
29+
- **Speed and Simplicity:** Lightweight files edit quickly without formatting distractions, boosting focus on content.
30+
- **Compatibility and Future-Proofing:** Universal across devices/OS, easy to version with Git, backup, and automate with scripts/tools.
31+
- **Efficiency Across Workflows:** Supports distraction-free writing, dev (human-readable code), and organization; convert seamlessly (e.g., to HTML/PDF via pandoc).
32+
2533
---
2634

2735
## Why Kern? Why Not Alternatives?
@@ -84,15 +92,17 @@ The Kern environment is composed of five distinct layers, building from the base
8492
- **Application Launcher:** A custom script combining a system-wide file index with `fzf` (fuzzy finder), bound to a key within `zellij` to provide a "Spotlight/Alfred-like" pop-up launcher
8593

8694
- **Core Applications:** A curated set of TUI/CLI tools to replace traditional GUI applications
87-
- **File Management:** `ranger` or `nnn`
95+
- **File Management:** `ranger` or `nnn`; `lf` (lightweight alternative); `zoxide` (intelligent directory jumping based on usage)
8896
- **Text Editing:** `neovim` or `helix`
8997
- **Web Browsing:** `browsh` (for modern sites), `lynx` (for text-only)
98+
- **Development:** `lazygit` (TUI for Git operations like staging/branching)
9099
- **Productivity:** `taskwarrior` (tasks), `khal` (calendar), `neomutt` (email)
91-
- **System Monitoring:** `btop` or `bottom`
100+
- **System Monitoring:** `btop` or `bottom`; `gdu` (disk usage analyzer)
92101
- **Media Management:**
93102
- **Music:** `cmus` or `ncmpcpp` with `mpd`
94103
- **Podcast Client:** `castero` or `podboat`
95104
- **eBook Reader:** `epy` or `termpub`
105+
- **Community Extensions:** Explore more in the upcoming `kern-apps` repository, including `lazydocker` (Docker TUI) and `Harlequin` (SQL IDE).
96106

97107
### Layer 4: The Graphics & Multimedia Bridge
98108

@@ -107,6 +117,30 @@ The Kern environment is composed of five distinct layers, building from the base
107117

108118
---
109119

120+
## Variants & Hybrid Setups
121+
122+
Kern extends beyond Linux framebuffer setups, enabling keyboard-driven, text-focused workflows in GUI terminals or SSH. This "hybrid" mode uses Zellij (or tmux) as a session manager in a maximized terminal, with seamless switching to the host OS for graphics (e.g., browser/video).
123+
124+
### GUI Terminals on macOS/Windows/Ubuntu
125+
- Full-screen terminals: iTerm2, Kitty, Ghostty, or Alacritty.
126+
- Install tools via managers: Homebrew (macOS: `brew install zellij ranger neovim zoxide lazygit`), APT (Ubuntu: `sudo apt install ...`), Chocolatey/WSL (Windows).
127+
- Run `kern-hybrid.sh` to configure layouts, keybindings, and launchers for a Kern-like experience.
128+
129+
### SSH Sessions
130+
- Attach remotely: `zellij attach` for persistent TUI sessions.
131+
- Full CLI/TUI support; framebuffer apps (e.g., video) limited to local use.
132+
133+
Example `kern-hybrid.sh` (download via curl or Git):
134+
```bash
135+
#!/bin/bash
136+
# Core setup: Install/configure Zellij, fzf launcher, dotfiles.
137+
# Example: zellij setup --layout default && ln -s ~/.config/kern ~/.zshrc
138+
echo "Kern hybrid ready. Maximize terminal and run 'zellij'."
139+
```
140+
This variant makes Kern accessible on existing systems, preserving minimalist productivity.
141+
142+
---
143+
110144
## Implementation & Distribution
111145

112146
### Delivery Model
@@ -236,8 +270,10 @@ The TTY login screen is controlled by `/etc/issue`. You can customize it with:
236270

237271
## Philosophy
238272

239-
Kern represents a return to computing fundamentals: direct hardware access, composable tools, and user control. It's not about rejecting graphical interfaces entirely, but about questioning whether they're necessary for every task. For text-heavy workflows—coding, writing, system administration, research—the console provides a faster, lighter, and more focused environment than any desktop.
273+
Kern represents a return to computing fundamentals: direct hardware access, composable tools, and user control, anchored in plaintext for future-proof productivity—human-readable, portable, and automation-friendly across environments.
274+
275+
It rejects unnecessary graphical overhead, offering a spectrum from extreme framebuffer console (on Linux) to hybrid setups in GUI terminals or SSH, enabling keyboard-driven text workflows on macOS, Windows, Ubuntu, or beyond. For coding, writing, sysadmin, and research, this delivers unmatched speed, focus, and efficiency.
240276

241-
By building on proven Unix principles and modern TUI applications, Kern creates a computing experience that is simultaneously retro and cutting-edge: the simplicity of 1980s terminals meets the power of 2020s tooling.
277+
By blending Unix principles with modern TUIs/CLIs, Kern fuses retro terminal simplicity with 2020s tooling power, adaptable without compromise.
242278

243279
**Fast. Focused. Foundational.**

0 commit comments

Comments
 (0)