{"id":22900411,"url":"https://github.com/kapitanluffy/sublime-compass","last_synced_at":"2025-05-08T01:12:24.188Z","repository":{"id":189538507,"uuid":"680859043","full_name":"kapitanluffy/sublime-compass","owner":"kapitanluffy","description":"🧭 Never get lost again navigating your code with Compass! Filter your list of open MRU tabs / files easily!","archived":false,"fork":false,"pushed_at":"2024-11-26T20:06:09.000Z","size":7713,"stargazers_count":9,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-08T01:12:17.464Z","etag":null,"topics":["code-navigation","sublime-text","sublime-text-plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","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/kapitanluffy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-20T16:31:18.000Z","updated_at":"2025-01-13T13:56:03.000Z","dependencies_parsed_at":"2024-11-27T00:01:35.812Z","dependency_job_id":null,"html_url":"https://github.com/kapitanluffy/sublime-compass","commit_stats":null,"previous_names":["kapitanluffy/sublime-context-keeper","kapitanluffy/sublime-compass"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kapitanluffy%2Fsublime-compass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kapitanluffy%2Fsublime-compass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kapitanluffy%2Fsublime-compass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kapitanluffy%2Fsublime-compass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kapitanluffy","download_url":"https://codeload.github.com/kapitanluffy/sublime-compass/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252978779,"owners_count":21834917,"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":["code-navigation","sublime-text","sublime-text-plugin"],"created_at":"2024-12-14T01:19:49.424Z","updated_at":"2025-05-08T01:12:24.169Z","avatar_url":"https://github.com/kapitanluffy.png","language":"Python","funding_links":["https://github.com/sponsors/kapitanluffy","https://patreon.com/kapitanluffy","https://ko-fi.com/kapitanluffy"],"categories":[],"sub_categories":[],"readme":"### 🧭 Compass - Better Code Navigation\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://www.sublimetext.com/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Made%20For-Sublime-ff9800?logo=sublime%20text\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://packagecontrol.io/packages/Compass%20Navigator\"\u003e \n    \u003cimg src=\"https://img.shields.io/packagecontrol/dt/Compass%20Navigator\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/kapitanluffy/sublime-compass/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/tag/kapitanluffy/sublime-compass?label=release\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/sponsors/kapitanluffy\"\u003e\n    \u003cimg alt=\"GitHub Sponsors\" src=\"https://img.shields.io/github/sponsors/kapitanluffy\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nLost? Tired of endlessly scrolling through tabs just to find the previous file you were working on?\n\nCompass provides you the list of most-recently used tabs. It also helps you filter them by special tags!\n\nBy default, `ctrl+tab` jumps you to the next view in the MRU stack without showing the stack.\nCompass provides you a visual guide of where you have been.\n\n---\n\n### Installation\n\n1. In your package directory, clone the repo\n```\ngit clone git@github.com:kapitanluffy/sublime-compass.git \"Compass Navigator\"\n```\n\n2. Run `Preferences: Compass Keybindings` and copy pre-commented the keybindings (or you can set it to your preferred keybinds)\n\n3. Press `ctrl+tab` to show the Compass 🧭\n\n### Contents\n- [Opening Compass](#opening-compass)\n- [Quick Switching](#quick-switching)\n- [Selecting an Item](#selecting-an-item)\n- [Closing Compass](#closing-compass)\n- [Filtering Items](#filtering-items)\n- [Opening Files](#opening-files)\n- [Auto Closing Tabs](#auto-close-tabs)\n- [Caching Items](#caching-items)\n\n### Support ☕\n\nLike my Sublime plugins? Keep the updates coming by supporting me on GitHub Sponsors, Ko-fi, or Patreon.\nYour support will help fuel my coffee for my next coding session!\n\n- https://github.com/sponsors/kapitanluffy\n- https://patreon.com/kapitanluffy\n- https://ko-fi.com/kapitanluffy\n\n---\n\n#### Opening Compass\n\n\u003e `ctrl+tab`\n\nOpen the quick panel. Displays most-recently used tabs by default.\n\n![Opening Compass](./previews/open-compass.gif)\n\n#### Quick switching\n\nYou can do this by pressing `ctrl+tab` on the first and second items\n\n![Quick Switching](./previews/quick-switching.gif)\n\n#### Selecting an Item\n\n\u003e `ctrl+ctrl` (or press `enter`)\n\nSelect the current highlight and close the quick panel\n\n\n#### Closing Compass\n\n\u003e `alt+alt` (or press `escape`)\n\nGo back to the initial tab and close the quick panel\n\n![Closing Compass](./previews/close-compass.gif)\n\n#### Filtering Items\n\nTo enable filters, you need to set `enable_tags` to `True`.\nAfter that, you can filter items by typing `#`\n\n![Filtering Items](./previews/filtering-items.gif)\n\n#### Opening files\n\nIf you have [ripgrep](https://github.com/BurntSushi/ripgrep) set in the settings, you can enable this feature.\nPlease note that this will be slow in large projects!\n\n![Opening Files](./previews/opening-files.gif)\n\n#### Auto Close Tabs\nCompass will automatically close the least used tab when you open the 1001th tab.\nYou can manage this limit by changing `max_open_tabs` or disable it by setting to `0`\n\n#### Caching Items\nInternally, Compass caches the MRU tabs. Reopening Sublime Text will not rebuild the MRU stack\n\nThe \"Files\" plugin which allows you to navigate to unopened files does not do this unfortunately.\nBy default, each time you open compass, the Files plugin will always refetch your file list\n\nThis sucks when you have a very large project. Enabling caching helps with showing \ncompass immediately. The downside of this is that it won't see newly created files. \nI am currently working on fixing this with the help of another plugin called [FileWatcher](https://packagecontrol.io/packages/FileWatcher). \nFor now, you can run `Compass: Reindex` to recognize new files.\n\nIf your Compass does not show up immediately, try enabling the cache under `plugins.files.enable_cache` in the settings\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkapitanluffy%2Fsublime-compass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkapitanluffy%2Fsublime-compass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkapitanluffy%2Fsublime-compass/lists"}