Skip to content

Navigation Marks #23

@mkh-user

Description

@mkh-user

Feature Summary

Introduce "Navigation Marks" to allow users to set temporary bookmarks within a file and quickly jump between them. This feature enhances navigation in large or complex files.

Motivation

In large files, especially during debugging or refactoring, users often need to jump between multiple non-contiguous locations. Scrolling or searching manually is inefficient. Navigation Marks would provide a lightweight way to mark and revisit important lines without relying on external tools or comments.

Proposed Design

  • Allow users to set a mark at the current cursor position (e.g., via shortcut or menus).
  • Provide a panel showing all active marks with line numbers and labels (default labels: line number).
  • Enable quick navigation between marks (next/previous mark and jump to specific mark).
  • Marks should be temporary and session-based by default, with an option to persist them in data based on file path.

Acceptance Criteria

  • Users can set and remove marks at any line.
  • Users can navigate between marks using keyboard shortcuts or UI.
  • Marks are visible in the UI (panel list).
  • Marks persist during the session; optional persistence across sessions.
  • No interference with version control or file content.

Related Issues / Discussions

  • Bookmark #26: This feature is simpler than bookmarks and we can change bookmarks feature state to not planned.

Implementation Notes (Optional)

  • Store marks in memory (session-based marks) or lightweight metadata files.
  • Consider integration with existing outline or symbol navigation features.
  • Allow optional labels for marks to improve clarity.

Localization & Accessibility

  • Ensure mark-related actions are accessible via keyboard.
  • Localize any UI labels or tooltips related to marks.

Community Feedback (Optional)

Nothing

Metadata

Metadata

Assignees

No one assigned

    Labels

    action scriptsOfficial action scripts or action scripts featuresfeature: NavigationImproves movement across UI sections, files, or project structurehelp wantedOpen for community input, suggestions, or implementation help

    Projects

    Status

    Accepted

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions