GBrain is a personal knowledge management system designed as an AI agent memory layer. It provides a persistent knowledge base that runs as a 24/7 daemon for continuous ingestion, enrichment, and consolidation of information from various sources. The system features a CLI-first architecture with MCP (Model Context Protocol) support for AI agent integration, a web admin interface, and extensibility through skill packs. It uses a hybrid storage approach with PGLite for local/single-user deployments and Postgres+pgvector for shared/scale deployments, incorporating vector search, full-text search, and a self-wiring knowledge graph with typed edges. The system includes evaluation frameworks (BrainBench, takes-quality assessment), an advisor system for health recommendations, and automated maintenance cycles.
Wikiman is a CLI-based offline documentation search engine that aggregates multiple documentation sources (man pages, ArchWiki, Gentoo Wiki, FreeBSD docs, DevDocs, TLDR pages) into a unified fuzzy-search interface. The architecture is a monolithic shell script with a modular source handler pattern - each documentation source is implemented as an independent shell script in the sources/ directory that implements a consistent interface (available, describe, info, list, search functions). The main script (wikiman.sh) orchestrates parallel searches across sources, combines results, and presents them through a fuzzy finder (fzf/skim) with preview capability. Shell integration is provided via key-binding widgets for bash, fish, and zsh. The codebase demonstrates solid shell engineering practices: POSIX compatibility checks, clear function separation, proper error handling, and a clean extensible architecture for adding new documentation sources. The source module pattern is particularly well-designed - any new documentation source can be added by implementing the standard interface. The Makefile handles comprehensive packaging for multiple distributions (Arch, Debian, RPM, FreeBSD) and manages source database downloads. CI/CD pipelines automate package building and source database updates. The heavy reliance on awk for text processing is a double-edged sword - it enables powerful data manipulation in pure shell but creates maintenance complexity. The main script is monolithic (~500 lines) and could benefit from further modularization. However, the code is functional, well-structured, and demonstrates genuine craftsmanship in shell scripting.