{"id":29810236,"url":"https://github.com/kelp/vibeutils","last_synced_at":"2026-04-06T01:12:55.309Z","repository":{"id":306855770,"uuid":"1026535918","full_name":"kelp/vibeutils","owner":"kelp","description":"Modern Unix coreutils in Zig — git-aware ls, colored output, Nerd Font icons, memory-safe","archived":false,"fork":false,"pushed_at":"2026-03-29T00:56:37.000Z","size":10386,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-29T01:49:47.501Z","etag":null,"topics":["cli","command-line","coreutils","gnu-coreutils","linux","macos","terminal","unix-utilities","zig"],"latest_commit_sha":null,"homepage":null,"language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kelp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-07-26T04:54:24.000Z","updated_at":"2026-03-28T14:54:02.000Z","dependencies_parsed_at":"2025-07-28T04:15:51.764Z","dependency_job_id":"8b13f512-ea1b-49e8-ab17-d05d1d0a5a11","html_url":"https://github.com/kelp/vibeutils","commit_stats":null,"previous_names":["kelp/vibeutils"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/kelp/vibeutils","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelp%2Fvibeutils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelp%2Fvibeutils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelp%2Fvibeutils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelp%2Fvibeutils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kelp","download_url":"https://codeload.github.com/kelp/vibeutils/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelp%2Fvibeutils/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31309271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["cli","command-line","coreutils","gnu-coreutils","linux","macos","terminal","unix-utilities","zig"],"created_at":"2025-07-28T16:35:26.514Z","updated_at":"2026-04-02T15:45:18.017Z","avatar_url":"https://github.com/kelp.png","language":"Zig","readme":"# vibeutils\n\nMemory-safe Unix utilities written in Zig, inspired by GNU coreutils and OpenBSD.\n\n**MIT Licensed** • **Linux** • **macOS** • **BSD**\n\n## What's Different\n\nvibeutils covers the 80% of GNU coreutils you actually use,\nwith modern terminal enhancements that activate\nautomatically.\n\n**ls** gains the most:\n- `--icons` — Nerd Font file type icons\n- `--git` — inline git status per file\n- `--time-style=relative` — \"2 hours ago\" instead of\n  timestamps (default in long format)\n\n![ls with icons, git status, and relative timestamps](docs/images/ls-icons.png)\n\n![Colored help output with syntax highlighting](docs/images/cp-help.png)\n\n**Across all utilities:**\n- Colored `--help` with syntax-highlighted flags\n- Smart terminal detection (NO_COLOR, 256-color, truecolor)\n- Graceful degradation to plain text in pipes and dumb\n  terminals\n\n## Project Status\n\n**Pre-1.0 (v0.8.0)**: 47 utilities with 100% POSIX flag\ncoverage (288 MUST + 220 SHOULD). Expect breaking changes\nas we refine the design.\n\n### Implemented Utilities\n\n**File Operations**\n`cat` `cp` `dd` `ln` `mkdir` `mktemp` `mv` `rm` `rmdir`\n`touch`\n\n**File Information**\n`df` `du` `find` `ls` `readlink` `realpath` `stat`\n\n**Text Processing**\n`cut` `grep` `head` `nl` `sort` `tac` `tail` `tee` `tr`\n`uniq` `wc`\n\n**Path \u0026 Names**\n`basename` `dirname` `pwd`\n\n**User \u0026 Permissions**\n`chmod` `chown` `id` `whoami`\n\n**System \u0026 Process**\n`date` `env` `free` `seq` `sleep` `timeout`\n\n**Output \u0026 Control**\n`echo` `false` `printf` `test` `true` `yes`\n\n## Installation\n\n### Homebrew (macOS/Linux)\n\n```bash\nbrew install kelp/tap/vibeutils\n```\n\nCommands install with a `v` prefix (vls, vcp, vmv) to avoid\nconflicts with system utilities. To use without prefix:\n\n```bash\nexport PATH=\"$(brew --prefix)/opt/vibeutils/libexec/vibebin:$PATH\"\n```\n\n### Nix\n\n```bash\n# Try it out\nnix shell github:kelp/vibeutils\n\n# Build locally\nnix build github:kelp/vibeutils\n```\n\nPrebuilt binaries are available via Cachix. Without\nthis, Nix builds from source (requires Zig):\n\n```bash\ncachix use vibeutils\n```\n\n#### Persistent install (nix-darwin / home-manager)\n\nAdd vibeutils as a flake input. Do **not** use\n`inputs.nixpkgs.follows` — that changes the derivation\nhash and forces a build from source instead of pulling\nprebuilt binaries from Cachix.\n\n```nix\n# flake.nix\ninputs.vibeutils.url = \"github:kelp/vibeutils\";\n```\n\n```nix\n# home.nix\nhome.packages = [ inputs.vibeutils.packages.${pkgs.system}.default ];\n```\n\nThe vibeutils flake lock is updated weekly via CI, so\nits nixpkgs stays current.\n\nNix installs use original names (no prefix) since Nix\nenvironments are isolated.\n\n### Build from source\n\nRequirements: Zig 0.15.2 or later\n\n```bash\ngit clone https://github.com/kelp/vibeutils.git\ncd vibeutils\nzig build -Doptimize=ReleaseSafe\n```\n\nFind binaries in `zig-out/bin/`.\n\n## Development\n\n```bash\njust build          # Build all utilities\njust test           # Run unit tests\njust it             # Run integration tests\njust coverage       # Coverage report\njust fmt            # Format code\njust                # List all recipes\n\n# Single utility\njust build-util grep\njust test-util grep\njust run grep -- -r TODO src/\n```\n\n### Testing\n\n- Unit tests embedded in each source file\n- Integration tests in `tests/utilities/`\n- Privileged tests via fakeroot\n- Target: 90%+ coverage\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkelp%2Fvibeutils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkelp%2Fvibeutils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkelp%2Fvibeutils/lists"}