mcpField
B
bookmarker

bookmarker

github.com/primeappleDevelopment050 installsUpdated 6w ago
Repository

About bookmarker

bookmarker is a skill that helps agents select a relevant working directory from named bookmarks before continuing a task. It uses ordered matching and asks for a choice when candidates remain ambiguous.

Key features

  1. 01Checks whether the current directory fits
  2. 02Looks up named bookmarks
  3. 03Ranks fallback matches by relevance
  4. 04Inspects plausible candidates
  5. 05Continues work from the selected path

Use cases

  1. 01Choosing a project directory from a bookmark
  2. 02Resolving multiple possible repository locations

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/primeapple/bookmarker --skill bookmarker

After installing, type/bookmarkerin Claude Code to confirm it loaded.

Details

From the project README

Bookmarker

Use this skill for a non-exact location only. First decide whether the current working directory already fits the user's request. Stay there when it does.

When another location is needed:

  1. Set LOCATION to the user's named location. Run bm get LOCATION.

  2. Use the result when bm get LOCATION returns exactly one path.

  3. Otherwise run bm list --porcelain. Each record is bookmark<TAB>path; the separator is a literal tab. Parse bookmark and path as separate fields so paths containing spaces remain intact.

  4. Rank fallback matches in this order:

    • exact bookmark name;
    • exact path basename;
    • LOCATION as a path component;
    • a contextually related bookmark name.

    Prefer basename matches over path-component matches. For example, foo selects /Users/toni/foo over /Users/toni/src/foo/design-system. For related names, use the task's meaning: backend-repo is more relevant to backend work than frontend-for-backend. Do not choose by substring matching alone.

  5. If one path is clearly the best match, select it. If multiple paths remain plausible, inspect each for task relevance. Check its directory, repository status and remote when applicable, and read README.md or AGENTS.md when present. Continue when one candidate is clearly relevant; otherwise show the candidates and ask the user to choose.

  6. If no match exists, tell the user what was tried and ask for a bookmark name or path. Do not search the entire drive.

  7. Run every following operation from the selected path. Set tool cwd when supported; otherwise use cd -- "$path" && ....

  8. Continue the user's task there. Do not merely report the path or ask the user to change directory.

Completion: the user's task runs from the selected relevant path. If selection remains unclear, stop after showing candidates and asking the user.

Comments

Markdown supported