{"id":17151943,"url":"https://github.com/dancardin/warp-dir","last_synced_at":"2026-03-03T18:31:04.954Z","repository":{"id":187506700,"uuid":"677130737","full_name":"DanCardin/warp-dir","owner":"DanCardin","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-10T18:57:55.000Z","size":17,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-23T02:24:06.733Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DanCardin.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}},"created_at":"2023-08-10T20:17:01.000Z","updated_at":"2024-11-01T20:23:02.000Z","dependencies_parsed_at":"2025-04-13T12:43:19.342Z","dependency_job_id":"b28e283e-2c0e-4d5f-93be-b9a77d0110d5","html_url":"https://github.com/DanCardin/warp-dir","commit_stats":null,"previous_names":["dancardin/warp-dir"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/DanCardin/warp-dir","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanCardin%2Fwarp-dir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanCardin%2Fwarp-dir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanCardin%2Fwarp-dir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanCardin%2Fwarp-dir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DanCardin","download_url":"https://codeload.github.com/DanCardin/warp-dir/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanCardin%2Fwarp-dir/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30054561,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T18:21:05.932Z","status":"ssl_error","status_checked_at":"2026-03-03T18:20:59.341Z","response_time":61,"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":[],"created_at":"2024-10-14T21:42:25.850Z","updated_at":"2026-03-03T18:31:04.909Z","avatar_url":"https://github.com/DanCardin.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Warp Directory\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/crates/l/warp-dir.svg\" alt=\"license\"\u003e\n\u003ca href=\"https://crates.io/crates/warp-dir\"\u003e\n\u003cimg src=\"https://img.shields.io/crates/v/warp-dir.svg?colorB=319e8c\" alt=\"Version info\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/DanCardin/warp-dir/actions?query=workflow%3ATest\"\u003e\n\u003cimg src=\"https://github.com/DanCardin/warp-dir/workflows/Test/badge.svg\" alt=\"Build Status\"\u003e\n\u003c/a\u003e \u003ca href=\"https://codecov.io/gh/DanCardin/warp-dir\"\u003e\n\u003cimg src=\"https://codecov.io/gh/DanCardin/warp-dir/branch/main/graph/badge.svg?token=U7NQIWXWKW\"/\u003e\n\u003c/a\u003e\u003cbr\u003e\n\u003c/p\u003e\n\nA [warp-dir](https://github.com/kigster/warp-dir)-like tool, written in Rust.\n\n\u003e Think of this as a folder-navigation super-charge tool that you’d use on a\n\u003e most frequently-used set of folders. This becomes really useful if you are\n\u003e often finding yourself going into a small number of deeply nested folders with\n\u003e a long path prefix.\n\n## Usage\n\n```bash\n/home/me/a/b/c/d/\u003e wd add foo\n/home/me\u003e cd\n/home/me\u003e z foo\n/home/me/a/b/c/d/\u003e # Huzzah!\n/home/me/a/b/c/d/\u003e wd help\n\nUsage: wd [OPTIONS] [target] [PATH] [COMMAND]\n\nCommands:\n  add     Adds the current working directory to your warp points\n  remove  Removes the given warp point\n  list    Print all stored warp points\n  show    Show the path to given warp point (pwd)\n  clean   Remove points warping to nonexistent directories\n  shell   Subcommands for hooking into the shell\n  help    Print this message or the help of the given subcommand(s)\n\nArguments:\n  [target]\n          Warps to the directory specified by the warp point\n\n          Possible values:\n          - foo:       /home/me/a/b/c/d\n```\n\n## Why?\n\nWhy rewrite it in Rust?\n\n- for fun!\n- I encountered some issues, semiregularly, where it would fail to load/execute\n  correctly until opening a new shell (presumably due to it being written in\n  bash).\n- Additional shell support\n\n### Differences\n\nEssentially, this tool should act like a drop-in replacement for\n[warp-dir](https://github.com/kigster/warp-dir) in most cases.\n\nAt time of writing, most commands are implemented, although the CLI options will\nnot work identically.\n\nNotably, the default config lookup location is different! By default it will\nlook at `$XDG_DATA_HOME/wd/config`. This can be configured with the `$WD_CONFIG`\nenvironment variable, which is also respected by the original warp-dir project.\n\n## Shell Support\n\nCurrently explicitly supported shells include: `zsh`, `bash`, and `fish`. The\nscaffolding exists to support other shells, which should make supporting other\ncommon shells that might require `\"$SHELL\"` specific behavior.\n\nChanging the shell's directory requires a minimal amount of shell code to be\nexecuted, so after installing the binary (suggestion below), you will need to\nadd add a hook to your bashrc/zshrc/config.fish, etc.\n\n- bash `eval \"$(wd --shell bash shell init)\"`\n- zsh `eval \"$(wd --shell zsh shell init)\"`\n- fish `wd --shell fish shell init | source`\n\nDepending on the level of similarity to the above shells, you may be able to get\naway with using one of the above `shell init` hooks until explicit support is\nadded\n\n### Completions\n\nAdditionally, you can generate CLI completions with `wd shell completion`, and\nwrite them to the appropriate location for your shell.\n\nThis should enable autocompletion of the warp directory target names!\n\n## Installation\n\n### With Cargo\n\n```bash\ncargo install warp-dir\n```\n\n### Download Release\n\n- Download a pre-built binary from\n  [Releases](https://github.com/DanCardin/warp-dir/releases)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdancardin%2Fwarp-dir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdancardin%2Fwarp-dir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdancardin%2Fwarp-dir/lists"}