This is a personal dotfiles repository for macOS, automating the setup of a developer environment. It is not a traditional application but a configuration management system using dotbot to symlink config files and Homebrew to install software. The repository manages shell configuration (zsh with oh-my-zsh and zplug), editor settings (VS Code, nano, hyper), browser hardening (Firefox/Zen with arkenfox user.js), macOS system preferences, and a curated set of CLI tools and applications. The core entry point is a bash install script that runs dotbot pipelines. The codebase is well-organized, follows minimalism and security principles, and is actively maintained by a single developer. It demonstrates thoughtful patterns for fzf integration, Docker-based AI agent runners, and peripheral auto-launching, though it remains a personal configuration rather than a reusable library.
Amber is a Rust-based compiler that transpiles a high-level, statically-typed programming language into shell scripts (Bash, Zsh, Ksh). It provides a modern language with features like functions, type inference, generics, optional arguments, failable types, imports, loops, range expressions, array operations, and a standard library for file system, text, HTTP, math, and environment operations. The compiler architecture is modular: a CLI entry point (src/main.rs) dispatches to subcommands (build, run, eval, check, docs, test). The compilation pipeline (src/compiler.rs) orchestrates tokenization via heraclitus-compiler, parsing into a typed AST, type checking with control-flow analysis, translation to an intermediate fragment AST, optimization passes (unused variable removal, ephemeral variable elimination), and final shell code generation with post-processing (e.g., shell syntax checking). The system supports multiple shell targets and generates version-specific code. The codebase is well-structured with procedural macros (meta crate) for keyword registration and context management, and a comprehensive test suite using snapshot testing (insta). While alpha quality, the engineering is serious and the architecture shows thoughtful design patterns.
x-cmd is a modular POSIX shell command framework providing 300+ modules and 600+ curated CLI tools behind a unified `x` dispatcher. In production it functions as a cross-platform developer toolkit: it wraps package managers (apt, brew, scoop, winget, pixi, asdf), provides AI/LLM client integrations (OpenAI, Gemini, Claude, DeepSeek, Ollama, Kimi), wraps git-forge APIs (GitHub, GitLab, Gitea, Gitee, Codeberg), and offers system utilities (process/disk/network/GPU monitoring, DNS, routing, file operations). The core is a shell bootstrap (`X`) that sources module entry points (`mod/<name>/latest`), with lazy-loading via the `xrc:mod:lib` DSL and a metadata layer (`adv/*.jso`) driving shell completions, help text, and TLDR examples. The framework explicitly targets bash, zsh, dash, fish, nushell, xonsh, and PowerShell with per-shell code paths, and supports Linux, macOS, Windows (Git Bash/WSL), and Termux. Architecturally this is a monolith of loosely-coupled shell modules rather than a single binary. Each module follows a consistent pattern: a `latest` manifest declaring the main function, subcommand dispatch via `case` statements, and AWK scripts for data transformation. Configuration flows through a YAML profile system (`cfgy`), command output caching via `ccmd`, and on-demand binary provisioning through `pkg`/`pixi`/`snap` fallbacks. The most impressive craftsmanship lives in the AWK libraries: a pure-AWK JSON parser, a QR encoder with GF(256) Reed-Solomon error correction, a Chinese lunar calendar converter, and a TSV-based ontology engine. These are genuinely reusable, self-contained data-processing components. However, the codebase also contains many stub modules, duplicated AI-provider wrappers, hardcoded version pins, and heavy `eval` usage — the breadth of scope (300+ modules) trades completeness for coverage. The repo has a hybrid character: while dominantly an application, it embeds data-oriented subsystems (ondb ontology database, CVE/OSV/KEV vulnerability data, agent token-cost analytics) that could be extracted independently.
This is a Zsh plugin that reminds users to use defined aliases when they type a command that has an alias. It hooks into Zsh's preexec and precmd mechanisms to intercept commands, expand them, and compare against all defined normal, global, and git aliases. If a match is found and the user did not use the alias, it prints a configurable reminder message (before or after command execution). It also supports a 'hardcore' mode that prevents command execution if an alias exists, forcing the user to use it. The plugin is a single Zsh script sourced into the user's shell, with no external dependencies other than Zsh 5.1+ and optionally `tput` for colored output. It provides toggle functions (`disable_you_should_use`/`enable_you_should_use`) and a report function (`check_alias_usage`) to analyze history and show alias usage counts. The code is well-structured, includes a comprehensive test suite using zunit, and handles edge cases like sudo commands, alias chains with cycle detection, ignored aliases, and multiple display modes.
ffs is a FUSE-based filesystem that mounts semi-structured data formats (JSON, TOML, YAML) as a Unix directory tree, enabling interactive editing with standard shell commands (cat, echo, mv, rm, mkdir). It includes companion tools pack (directory tree → data format) and unpack (data format → directory tree). The system is implemented in Rust with a modular architecture: the nodelike crate provides a generic trait and Node enum for format-agnostic representation, while ffs handles FUSE mount logic and pack/unpack handle batch conversion. Key features include lazy/eager loading strategies, name munging for special characters, extended attribute support, and format conversion (e.g., JSON to YAML). The repository also contains an extensive benchmark suite using real-world datasets (FDA, GitHub, NOAA, etc.) to compare loading strategies. While the core functionality is complete and well-tested with over 60 integration test scripts, the project appears to be in a stale maintenance state with no recent commits (last significant activity in 2021) and several open issues. The codebase demonstrates good software engineering practices (modular design, comprehensive tests, performance instrumentation) but has limited reuse potential beyond its specific domain of semi-structured data manipulation via filesystem semantics.
This repository provides a configuration setup for a modern terminal environment on macOS, comprising the Ghostty terminal emulator, Starship prompt, and Zsh shell with plugins (autosuggestions, syntax highlighting, completions) and additional CLI tools (fzf, zoxide, eza, bat, yazi). The included install.sh script automates the installation of dependencies via Homebrew, backs up existing configurations, and deploys the new configuration files. The configuration files are well-documented and customized for a cohesive, visually appealing terminal experience with features like a rainbow prompt, glassmorphism, and enhanced productivity tools. Note: This repository is primarily a collection of configuration files and an installation script, and does not contain application logic beyond the setup process.
This is a personal configuration repository (dotfiles) for macOS, containing settings for Sublime Text, Terminal, oh-my-zsh, Git, and various shell scripts. It is not a software application but rather a collection of user environment configurations and utility scripts. The repository is well-organized with categorized directories for different tools (Sublime, Terminal, Archive). It includes a custom terminal theme 'GuoFeng', shell aliases and functions, git configuration, and Sublime Text snippets. The most notable reusable component is a bash script to rewrite Git commit author information across all branches. While not a production application, the configurations reflect a thoughtful, minimalist approach to tooling, with emphasis on native macOS apps and open-source alternatives.
Termux-OS is a menu-driven shell customization tool for Termux that enables users to install and configure shells (zsh, fish, bash) with themes, fonts, and security features. The core functionality is implemented in a single bash script (os.sh) that presents an interactive menu for installing shells, applying color themes, setting up a cyber lock (password protection via SHA-256 hashing), configuring terminal behavior, and updating the script. The architecture is monolithic but modularized into functions for each major task. Key external dependencies include git, curl, pkg, and various fonts/shell frameworks. The script writes configuration files to user directories (e.g., ~/.bashrc, ~/.zshrc, ~/.termux/properties) and downloads resources from GitHub.