MyNav is a terminal-based workspace navigator and session manager. This powerful tool streamlines the management of multiple projects through a user-friendly interface and integrates seamlessly with tmux sessions.

Key Features

Smart Workspace Organization

• Efficiently group projects into topics for better organization.
• Automatically detects git repositories and displays their status.
• Enables quick workspace creation and navigation with a customizable hierarchy.

Advanced Session Management

• Effortlessly create and switch between tmux sessions.
• View live session previews that include window and pane information.
• Perform bulk operations on sessions, such as kill or detach.

Modern Interface

• Offers a clean and intuitive terminal user interface.
• Supports Vim-style navigation for enhanced usability.
• Provides quick updates and notifications for an optimized workflow.
• Features fuzzy search functionality for fast access to projects.

Developer Experience

• Includes git integration to keep track of repository statuses.
• Built with tmux for robust session management.
• Supports cross-platform usage on both macOS and Linux.
• Comes equipped with extensive keyboard shortcuts to improve productivity.

Usage Examples

Basic Operations

To launch MyNav in the current directory:

mynav

To specify a directory:

mynav -path /your/project/path

To check the current version:

mynav -version

Common Workflows

Creating a New Workspace and Session

• Start MyNav and navigate through the interface:
  1. Press 'a' to create a new topic.
  2. Enter the topic name and press 'a' again to create a workspace.
  3. Enter the workspace session by pressing 'Enter'.

Managing Sessions

• Access MyNav and follow these steps:
  1. Navigate to the workspaces and press 'Enter' to create or attach to a session.
  2. Move to the sessions area and hit 'X' to kill a session.

Key Bindings

Navigation Keys

Action Commands

Configuration

MyNav supports a configuration system that manages multiple independent workspaces, which can be initialized in the current or any parent directory. Note that the home directory cannot serve as a MyNav workspace, and nested configurations are not allowed.

MyNav provides a compelling solution for developers needing efficient workspace and session management within a terminal environment, enhancing productivity and organization.