{"id":13831942,"url":"https://github.com/dkaslovsky/nav","last_synced_at":"2026-03-12T19:17:06.807Z","repository":{"id":190655103,"uuid":"682835111","full_name":"dkaslovsky/nav","owner":"dkaslovsky","description":"Terminal navigator for interactive ls workflows.","archived":false,"fork":false,"pushed_at":"2025-07-02T21:33:18.000Z","size":449,"stargazers_count":131,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-17T12:19:24.410Z","etag":null,"topics":["cd","command-line","filesystem","interactive","ls","navigation","terminal","tui"],"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/dkaslovsky.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}},"created_at":"2023-08-25T01:49:53.000Z","updated_at":"2025-07-28T19:25:13.000Z","dependencies_parsed_at":"2024-06-21T14:29:55.435Z","dependency_job_id":null,"html_url":"https://github.com/dkaslovsky/nav","commit_stats":null,"previous_names":["dkaslovsky/nav"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/dkaslovsky/nav","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaslovsky%2Fnav","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaslovsky%2Fnav/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaslovsky%2Fnav/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaslovsky%2Fnav/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dkaslovsky","download_url":"https://codeload.github.com/dkaslovsky/nav/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkaslovsky%2Fnav/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30439658,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-12T14:34:45.044Z","status":"ssl_error","status_checked_at":"2026-03-12T14:09:33.793Z","response_time":114,"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":["cd","command-line","filesystem","interactive","ls","navigation","terminal","tui"],"created_at":"2024-08-04T10:01:45.034Z","updated_at":"2026-03-12T19:17:06.781Z","avatar_url":"https://github.com/dkaslovsky.png","language":"Go","readme":"# nav\nTerminal navigator for interactive `ls` workflows.\n\n\n![alt text](./examples/nav_example.png)\n\n\u003cbr/\u003e\n\n## Overview\n\n`nav` is a terminal filesystem explorer built for interactive `ls` workflows.\nIt can be used as a standalone TUI or in bash/zsh functions such as\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n```bash\n# interactive ls + cd\nfunction nv {\n\tcd \"$(nav --pipe \"$@\")\"\n}\n```\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n```bash\n# interactive ls + clipboard\nfunction nvcp {\n\tnav --pipe \"$@\" | pbcopy\n}\n```\n\n\u003c/td\u003e\n\n\u003ctd\u003e\n\n```bash\n# interactive ls + multi cat\nfunction nvcat {\n\tnav --pipe \"$@\" | xargs cat\n}\n```\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\n`nav` is intended to be an interactive replacement for `ls` and currently supports some of the most common `ls` options:\n\u003ctable\u003e\n\n\u003ctr\u003e\n\u003ctd\u003e\n\nlong list with full details\n\n\u003c/td\u003e\n\n\u003ctd\u003e\n\n`ls -l`\n\n\u003c/td\u003e\n\n\u003ctd\u003e\n\n`nav --list` / `nav -l`\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\n\u003ctr\u003e\n\u003ctd\u003e\n\nshow hidden files\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n`ls -a`\n\n\u003c/td\u003e\n\n\u003ctd\u003e\n\n`nav --hidden` / `nav -a`\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\n\u003ctr\u003e\n\u003ctd\u003e\n\nfollow symlinks\n\n\u003c/td\u003e\n\n\u003ctd\u003e\n\u003c/td\u003e\n\n\u003ctd\u003e\n\n`nav --follow` / `nav -f`\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\n\u003c/table\u003e\n\nThese options are available as interactive toggles and can also be invoked on start with the appropriate command line flag ([see below](#full-list-of-commands)).\n\nHuman readable file sizes (`ls -lh`), color output (`ls --color`), and a custom sort order are on by default and cannot currently be configured.\n\nIn the future, `nav` might support a wider range of `ls` options and configuration.\n\n\u003cbr/\u003e\n\n### Full list of commands\n\n\tArrow keys are used to move the cursor.\n\tVim navigation is available using \"h\" (left), \"j\" (down) \"k\" (up), and \"l\" (right).\n\n\t\"enter\":       navigates into the directory or returns the\n\t               path to the entry under the cursor\n\t\"backspace\":   navigates back to the previous directory\n\n\t\"ctrl+x\":      returns the path(s) to the current entry or all marked entries\n\t\"ctrl+d\":      returns the path to the current directory\n\n\t\"i\":           enters search mode (insert into the path)\n\t\"d\":           enters debug mode  (view error details)\n\t\"H\":           enters help mode\n\t\"esc\":         switches back to normal mode or clears search filter in normal mode\n\n\t\"ctrl+v\":      (un)marks an entry for multiselect return\n\t\"ctrl+a\":      (un)marks all entries for multiselect return\n\n\t\"a\":           toggles showing hidden files (ls -a)\n\t\"L\":           toggles listing full file information (ls -l)\n\t\"f\":           toggles following symlinks\n\n\t\"e\":           dismisses errors\n\t\"ctrl+c\":      quits the application with no return value\n\n\u003cbr/\u003e\n\n### Command line flags\n\n\t--help, -h, -H:           display help\n\t--version, -v:            display version\n\n\t--search, -s:             start in search mode\n\n\t--pipe:                   return output suitable for pipe and subshell usage\n\n\t--follow, -f:             toggle on following symlinks at startup\n\t--hidden, -a:             toggle on showing hidden files at startup\n\t--list, -l:               toggle on list mode at startup\n\n\t--no-color:               toggle off color output\n\t--no-status-bar:          toggle off bottom status bar menu\n\t--no-trailing:            toggle off trailing annotators\n\n\t--remap-esc:              remap the escape key to the following value, using\n\t                          repeated values to require multiple presses\n\u003cbr/\u003e\n\n## Installation\nThe recommended installation method is downloading the latest released binary.\nDownload the appropriate binary for your operating system and architecture from this repository's [releases](https://github.com/dkaslovsky/nav/releases/latest) page or via `curl`:\n\nmacOS / amd64\n```bash\ncurl -o nav -L https://github.com/dkaslovsky/nav/releases/latest/download/nav_darwin_amd64\n```\n\nmacOS / arm64\n```bash\ncurl -o nav -L https://github.com/dkaslovsky/nav/releases/latest/download/nav_darwin_arm64\n```\n\nLinux / amd64\n```bash\ncurl -o nav -L https://github.com/dkaslovsky/nav/releases/latest/download/nav_linux_amd64\n```\n\nLinux / arm64\n```bash\ncurl -o nav -L https://github.com/dkaslovsky/nav/releases/latest/download/nav_linux_arm64\n```\n\nWindows\n```bash\ncurl.exe -o nav.exe -L https://github.com/dkaslovsky/nav/releases/latest/download/nav_windows_amd64.exe\n```\n\n\n\u003cbr/\u003e\n\n## License\n`nav` is released under the [MIT License](./LICENSE).\nDependency licenses are available in this repository's [CREDITS](./CREDITS) file.\n\n\u003cbr/\u003e\n\n## Acknowledgements\n`nav` was originally inspired by the excellent https://github.com/antonmedv/walk tool but has deviated significantly and has been written from the ground up to support the current feature set.\n","funding_links":[],"categories":["Go","tui","\u003ca name=\"cd\"\u003e\u003c/a\u003eDirectory changers (alternatives to cd)"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkaslovsky%2Fnav","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdkaslovsky%2Fnav","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkaslovsky%2Fnav/lists"}