{"id":21905073,"url":"https://github.com/kenjyco/kenjyco","last_synced_at":"2026-04-29T23:03:52.886Z","repository":{"id":145905243,"uuid":"313372903","full_name":"kenjyco/kenjyco","owner":"kenjyco","description":"README for github profile and some markdown files containing setup instructions for different operating systems","archived":false,"fork":false,"pushed_at":"2025-07-09T17:43:41.000Z","size":70,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-10T02:15:38.023Z","etag":null,"topics":["readme","setup-guide"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kenjyco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-16T17:10:39.000Z","updated_at":"2025-07-09T17:43:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"8e15a467-b258-4a95-a0fa-61cdc19a52b9","html_url":"https://github.com/kenjyco/kenjyco","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kenjyco/kenjyco","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenjyco%2Fkenjyco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenjyco%2Fkenjyco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenjyco%2Fkenjyco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenjyco%2Fkenjyco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kenjyco","download_url":"https://codeload.github.com/kenjyco/kenjyco/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenjyco%2Fkenjyco/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32447312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"ssl_error","status_checked_at":"2026-04-29T22:10:49.234Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["readme","setup-guide"],"created_at":"2024-11-28T16:28:44.133Z","updated_at":"2026-04-29T23:03:52.881Z","avatar_url":"https://github.com/kenjyco.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# CLI Development Ecosystem \u0026 Python Libraries\n\nBuilding tools that **trust developers** and **amplify productivity** through transparent, composable interfaces.\n\n## What I've Built\n\nA comprehensive ecosystem of 15+ interconnected CLI tools and Python libraries that transform how developers interact with databases, APIs, shell operations, and development workflows. Instead of hiding complexity behind abstractions, these tools illuminate it through **operational transparency** and **human-centric design**.\n\n### Core Philosophy\n- **Trust-based architecture** - Assumes developer competence rather than defending against it\n- **Operational transparency** - Always shows what's happening under the hood\n- **Cognitive ergonomics** - Reduces mental burden through consistent, intuitive interfaces\n- **Graceful degradation** - Works reliably across diverse environments\n\n### Key Components\n\n**Shell Environment** ([base](https://github.com/kenjyco/base))\n- 900+ shell functions, scripts, and aliases for comprehensive development workflows\n- Conditionally defined functions only available when tools they wrap are installed\n- Git repository management, Docker orchestration, and environment setup\n- Tab completion and vi keybindings for efficient terminal interaction\n\n**Development Environment** ([dotfiles](https://github.com/kenjyco/dotfiles))\n- Cross-platform setup script with intelligent backup and symbolic linking\n- Vim configuration with Vundle plugin management and vim-tmux-navigator integration\n- Tmux configuration with vi keybindings and seamless pane navigation\n- Git integration with vimdiff and IPython vi mode for consistent editing experience\n- Linux-focused development with macOS compatibility\n\n**Core Libraries**\n- [**input-helper**](https://github.com/kenjyco/input-helper) - Data transformations, user interaction patterns, and pre-defined regex\n- [**bg-helper**](https://github.com/kenjyco/bg-helper) - CLI orchestration and background task management (git/docker/pyenv)\n- [**fs-helper**](https://github.com/kenjyco/fs-helper) - Filesystem operations and production-ready logging\n- [**settings-helper**](https://github.com/kenjyco/settings-helper) - Environment-aware configuration management with INI files\n\nThese core libraries follow Unix philosophy principles, reinforcing usage of decades-old core utilities (grep, find, xargs, sort, cut, tr) while seamlessly blending with Python. They leverage Python's built-in features extensively and minimize external dependencies, creating a composable foundation that enhances rather than replaces traditional shell workflows.\n\n**Data Management**\n- [**dt-helper**](https://github.com/kenjyco/dt-helper) - Human-readable timestamp operations and temporal analysis\n- [**redis-helper**](https://github.com/kenjyco/redis-helper) - Redis collections for rapid prototyping and analytics\n- [**sql-helper**](https://github.com/kenjyco/sql-helper) - SQLAlchemy wrapper for exploring SQLite, PostgreSQL, and MySQL\n- [**mongo-helper**](https://github.com/kenjyco/mongo-helper) - MongoDB wrapper for data analysis and aggregate reporting\n- [**webclient-helper**](https://github.com/kenjyco/webclient-helper) - HTTP client with embedded debugging and history tracking\n\n**Specialized Tools**\n- [**aws-info-helper**](https://github.com/kenjyco/aws-info-helper) - AWS resource information with three-tier data access\n- [**chloop**](https://github.com/kenjyco/chloop) - Character-driven REPL framework backed by Redis\n- [**mocp-cli**](https://github.com/kenjyco/mocp-cli) - Interactive music player built on MOC (Music on Console) and chloop\n- [**vlc-helper**](https://github.com/kenjyco/vlc-helper) - CLI for precise video control and screenshot capture with VLC media player built on chloop\n\n**Meta-Package** ([libs](https://github.com/kenjyco/libs))\n- Flexible installation options: `kenjyco-libs`, `kenjyco-libs[data]`, `kenjyco-libs[full]`, etc.\n  - *does not include mocp-cli or vlc-helper*\n- `kenjyco-dev-setup` command for local development that clones all repositories and installs them in editable mode\n- Enables dogfooding in-progress changes across all repositories within the same environment\n- `kenjyco-ipython` command that auto-imports all installed packages, minimizing history clutter from repetitive import statements during testing and experimentation\n\n### How They Work Together\n\n**Consistent Integration Patterns:**\n- 2-character imports (`import redis_helper as rh`) create transferable muscle memory\n- Universal parameter conventions (`debug=False, timeout=None, exception=False, show=False`)\n- Cross-library dependencies that create functional composition\n- Docker integration that eliminates infrastructure friction\n\n### Multiplicative Value\n\nLearning one library accelerates learning all others due to consistent patterns. A developer who masters redis-helper's string-based query interface can immediately apply similar patterns across the entire ecosystem.\n\n**Key Advantages:**\n- **Compound learning effect** - Knowledge transfers between tools\n- **Reduced cognitive load** - Consistent interfaces minimize context switching\n- **Operational resilience** - Graceful degradation ensures reliability\n- **Human-centric design** - Adapts to developer patterns rather than forcing conformity\n\n### What Makes This Unique\n\nUnlike traditional CLI tools that each require learning unique interfaces, or modern frameworks that hide complexity behind abstractions, this ecosystem:\n\n- **Shows rather than hides** - Complete operational transparency\n- **Trusts rather than protects** - Assumes developer competence\n- **Composes naturally** - Tools amplify each other's capabilities\n- **Evolves gracefully** - New functionality is additive, not disruptive\n\n### Educational Impact\n\n**[Learning Python 3 Notebook](https://gist.github.com/kenjyco/69eeb503125035f21a9d)** - A comprehensive, interactive Python tutorial that has become my most-starred GitHub contribution. This Jupyter notebook provides a systematic progression from basic concepts to advanced topics, emphasizing hands-on learning through executable examples. Available on MyBinder for immediate experimentation, it demonstrates the same philosophy as my CLI ecosystem: making complex concepts accessible through clear, transparent instruction.\n\n### Coming Soon\n\n- **YouTube videos** demonstrating CLI workflows and tool integration\n- **Book on shell scripting and Python programming** for beginners, showcasing practical development patterns\n\n### Technologies \u0026 Skills\n\n**Languages:** Python, Shell Scripting (Bash/Zsh), SQL\n**Databases:** Redis, MongoDB, PostgreSQL, MySQL, SQLite\n**Infrastructure:** Docker, AWS, Git\n**Specialties:** CLI tool development, Database operations, API integration, Development workflows\n\n### Impact\n\nThis ecosystem transforms how developers work with:\n- **Database exploration** - Consistent interfaces across Redis, MongoDB, SQL\n- **API development** - Transparent HTTP client with debugging capabilities\n- **Development workflows** - Comprehensive shell environment with 900+ functions\n- **Infrastructure management** - Automatic Docker provisioning and AWS integration\n- **Team productivity** - Transferable knowledge and consistent patterns\n\n---\n\n*Building tools that make complex operations naturally composable and immediately transparent.*\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkenjyco%2Fkenjyco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkenjyco%2Fkenjyco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkenjyco%2Fkenjyco/lists"}