A powerful terminal-based workspace navigator and session manager built in Go. MyNav helps developers organize and manage multiple projects through an intuitive interface, seamlessly integrating with tmux sessions.

MyNav addresses the common challenge of managing multiple development projects in a terminal environment. While tmux provides excellent session management, it lacks robust workspace organization capabilities. MyNav bridges this gap by combining tmux's powerful features with an intuitive workspace management system, enabling developers to efficiently navigate between projects and maintain organized development workflows.

• Topic-based organization: Group related workspaces into logical topics
• Rapid workspace creation: Quick setup and navigation between projects
• Filesystem-based storage: Direct integration with your existing directory structure

• Comprehensive session control: Create, modify, delete, and enter sessions seamlessly
• Live session preview: Real-time display of window and pane information
• Instant session switching: Fast navigation between active development sessions

• Fuzzy search: Intelligent search across workspaces and sessions
• tmux integration: Built on top of tmux for maximum compatibility
• Extensive shortcuts: Comprehensive keyboard navigation and shortcuts
• Git awareness: Integration with Git repositories and status
• Modern UI: Clean, intuitive terminal interface inspired by Lazygit
• Vim-style navigation: Familiar navigation patterns for power users

Install mynav with a single command:

curl -fsSL https://raw.githubusercontent.com/GianlucaP106/mynav/main/install.bash | bash

For users who prefer manual installation:

# Clone the repository
git clone https://github.com/GianlucaP106/mynav.git

# Navigate to project directory
cd mynav

# Build the project
go build

• tmux 3.0+: Required for session management
• Terminal: UTF-8 support required for proper display

MyNav operates within a designated root directory. You can initialize multiple independent directories, but nested configurations are not supported.

Launch MyNav from any location:

mynav

Note: MyNav automatically detects existing configurations in the current directory or any parent directory.

Specify a custom root directory:

mynav -path /your/root/path

Press ? within the interface to view all available keyboard shortcuts for your current context.

MyNav seamlessly integrates with tmux to provide robust session management. When creating a session from a workspace, MyNav uses the workspace's directory path as the tmux session name, maintaining transparency and familiarity.

• Full tmux compatibility: All standard tmux features remain available
• Session detachment: Press Leader + D to detach and return to MyNav
• State synchronization: MyNav stays in sync with your development workflow

MyNav employs a flexible configuration system designed for multi-project development:

• Multiple workspace support: Initialize independent workspaces in different directories
• Automatic configuration detection: Searches current and parent directories for existing configurations
• Non-nested architecture: Nested configurations are not allowed; MyNav will use the parent configuration
• Home directory protection: The home directory cannot be initialized as a MyNav workspace

MyNav is designed for minimal configuration requirements. To begin development:

1. Ensure Go runtime is installed
2. Clone the repository
3. Run go build to compile

The project structure is straightforward and requires no additional dependencies beyond the Go standard library.

We welcome contributions from the community! Please ensure your commits follow the Conventional Commits specification.

This project is licensed under the MIT License. See the LICENSE file for complete details.