{"id":13523957,"url":"https://github.com/hugows/hf","last_synced_at":"2026-03-12T06:39:45.570Z","repository":{"id":33488341,"uuid":"37134132","full_name":"hugows/hf","owner":"hugows","description":"(another) Fuzzy file finder for the command line","archived":false,"fork":false,"pushed_at":"2024-11-11T13:02:37.000Z","size":78,"stargazers_count":334,"open_issues_count":3,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-01-13T03:32:01.616Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","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/hugows.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":null,"dco":null,"cla":null}},"created_at":"2015-06-09T13:36:08.000Z","updated_at":"2025-07-02T16:48:36.000Z","dependencies_parsed_at":"2024-11-02T08:31:24.751Z","dependency_job_id":"e985a3e1-610e-4da5-909d-480cc7c1a19d","html_url":"https://github.com/hugows/hf","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hugows/hf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugows%2Fhf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugows%2Fhf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugows%2Fhf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugows%2Fhf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hugows","download_url":"https://codeload.github.com/hugows/hf/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugows%2Fhf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30417531,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-12T04:41:02.746Z","status":"ssl_error","status_checked_at":"2026-03-12T04:40:12.571Z","response_time":114,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":[],"created_at":"2024-08-01T06:01:05.477Z","updated_at":"2026-03-12T06:39:45.554Z","avatar_url":"https://github.com/hugows.png","language":"Go","funding_links":[],"categories":["Files and Directories","Command Line","Go","Command Line Tools","others","命令行工具","\u003ca name=\"find\"\u003e\u003c/a\u003eFile finding (alternatives to find)"],"sub_categories":["Search","Dependency Management","OS X"],"readme":"# happyfinder [![Build Status](https://travis-ci.org/hugows/hf.svg?branch=master)](https://travis-ci.org/hugows/hf)\n\nhf is a command line utility to quickly find files and execute a command - something like Helm/Anything/CtrlP for the terminal. It tries to find the best match, like other fuzzy finders (Sublime, ido, Helm).\n\nHere is it in action:\n\n![happyfinder on osx](http://g.recordit.co/bWae8XRKMV.gif)\n\nIf you have any suggestions, please open an issue.\n\n## Similar projects\n\nThis project wasn't implemented as an improvement to any of the projects below - I only knew about the text editor plugins (Anything, Helm, CtrlP, Sublime's native matching...). I wanted something similar to that for the command line, and a reason to use termbox-go, a great library for creating terminal-based apps.\n\n- [fzf is a blazing fast command-line fuzzy finder written in Go](https://github.com/junegunn/fzf)\n- [Selecta is a fuzzy text selector for files and anything else you need to select](https://github.com/garybernhardt/selecta/)\n- [Pick is \"just like Selecta, but faster\"](https://robots.thoughtbot.com/announcing-pick)\n- [icepick is a reimplementation of Selecta in Rust](https://github.com/felipesere/icepick)\n\nThose projects take the elegant route - the Unix way - in the sense they don't reimplement the \"find files recursively\" part. I didn't consider that route because I wanted hf to work in the Windows prompt as well.\n\n## Installation\n\nIf you have Go configured in your system, you should be able to install \n(and update) happyfinder with the command:\n\n```\ngo install github.com/hugows/hf@latest\n```\n\n## Usage\n\n```\nThe basic command is:\n\n  hf [path] [command]\n\nThe default path is the current folder.\nThe default command is the first valid of $GIT_EDITOR, $EDITOR, or vim \n(subl on Windows).\n\nTo find in your git project, use:\n\n  hf -git [command]\n\n (if -git is provided, then next argument (optional) is assumed to be a command)\n\nIf the binary name is 'hfg', the -git option is assumed.\nThis was done because Windows users have no easy way of creating command aliases.\n\nA -cmd=\u003cyourcmd\u003e option is provided to simplify aliases. For example, I defined \niga (interactive git add) like this:\n\nalias iga='hf -cmd=\"git add\"'\n\nExamples:\n    hf\n    hf -git\n    hf -git vim\n    hf ~/go/src/\n    hfg rm\n    hf . rm\n\nInside the app:\n    a-z0-9      Edit input string (those also work: backspace/C-a/C-e/C-k/Home/End)\n    Up/down     Move cursor to next file\n    Space       Toggle mark for current file and move to next\n    C-t         Toggle mark for all files \n    C-s         Toggle \"run command in shell\"\n    TAB         Jump to edit command (and back)\n    RET         Run command\n    ESC         Quit\n\nWhen editing the command, the string $FILES is special and will\nreplaced by the select (or marked) files, properly quoted.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugows%2Fhf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhugows%2Fhf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugows%2Fhf/lists"}