{"id":16199362,"url":"https://github.com/j6k4m8/bkm","last_synced_at":"2025-03-19T05:30:49.015Z","repository":{"id":73813635,"uuid":"45769938","full_name":"j6k4m8/bkm","owner":"j6k4m8","description":"Simple terminal-command bookmarking tool for quick cd'ing","archived":false,"fork":false,"pushed_at":"2023-01-11T16:20:05.000Z","size":11,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-28T16:04:16.035Z","etag":null,"topics":["bash","bkm","bookmark","ohp","shell","terminal","zsh"],"latest_commit_sha":null,"homepage":"","language":"Python","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/j6k4m8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2015-11-08T06:39:15.000Z","updated_at":"2023-03-02T23:52:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"f564c4ea-7a66-4355-8d32-89eb91644def","html_url":"https://github.com/j6k4m8/bkm","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fbkm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fbkm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fbkm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fbkm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j6k4m8","download_url":"https://codeload.github.com/j6k4m8/bkm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243971192,"owners_count":20376784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bash","bkm","bookmark","ohp","shell","terminal","zsh"],"created_at":"2024-10-10T09:25:10.331Z","updated_at":"2025-03-19T05:30:49.009Z","avatar_url":"https://github.com/j6k4m8.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bkm\n\nCrazy-simple quick-bookmark terminal script for OSX and Linux. Bookmark the current directory with the `bkm my-folder` command. Navigate back to it by simply typing `my-folder`.\n\nNote: There's nothing to stop you from saying `bkm ls` and borking your `ls` command. Don't do the dumb thing!\n\n# Commands\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| **`bkm list`** | List all current bookmarks. | `bkm list` |\n| **`bkm rm [nickname]`** or **`bkm remove [nickname]`** | Remove the bookmark for the given nickname. | `bkm rm projects` |\n| **`bkm [nickname]`** | Nickname the current directory `nickname` | `bkm projects` |\n| **`bkm [nickname] [directory]`** | Nickname the `directory` `nickname` | `bkm projects ~/Documents/Projects` |\n\n# Setup\n\n## Auto-Install\nIf you trust me (and literally it's like five lines of code so why not) simply run this from your terminal:\n\n```\ncurl https://raw.githubusercontent.com/j6k4m8/bkm/master/bkm_setup.sh | sh\n```\n\nIf you use zsh, you can use:\n\n```\ncurl https://raw.githubusercontent.com/j6k4m8/bkm/master/bkm_setup_zsh.sh | sh\n```\n\n## Manual Install\n\nAdd the following line to your `~/.bashrc` or `~/.zshrc` or whatever:\n\n\n```\nsource ~/.bkm\n```\n\nI put the `bkm` executable in my `~` directory and renamed it `._bkm`.\n\nThen I can reference it from anywhere by adding this line to my rc-file:\n\n```\nalias bkm=\"~/._bkm\"\n```\n\n# Usage\nNavigate to a directory, and then simply type `bkm [nickname]`, where `nickname` is the name you want to use to get to this directory from anywhere. For instance,\n\n```\ncd ~/Documents/CuteGoldfishPictures/Favorites\nbkm gfish\n```\n\n**Re-source your rc (`source ~/.bashrc`)** and then you can type `gfish` from any directory to immediately navigate back to that directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj6k4m8%2Fbkm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj6k4m8%2Fbkm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj6k4m8%2Fbkm/lists"}