MyNav 🧭

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.

Overview

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.

Features

🏢 Workspace Management

• 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

💻 Session Management

• 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

🛠️ Developer Experience

• 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

Installation

Install mynav with a single command:

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

Manual Installation

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

Prerequisites

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

Usage

Getting Started

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

Navigation

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

tmux Integration

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.

Key Integration Features

• 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

Keyboard Shortcuts

Navigation Controls

Key	Action	Context
h / ←	Focus left panel	Global
l / →	Focus right panel	Global
j / ↓	Move down	List views
k / ↑	Move up	List views
Tab	Toggle focus	Search dialog
Esc	Close/cancel	Dialogs

Action Commands

Key	Action	Context
Enter	Open/select item	Global
a	Create new topic/workspace	Topics/Workspaces view
D	Delete item	Topics/Workspaces/Sessions view
r	Rename item	Topics/Workspaces view
X	Kill session	Workspaces/Sessions view
s	Search workspaces	Global
?	Toggle help menu	Global
q	Quit application	Global
<	Cycle preview left	Global
>	Cycle preview right	Global
Ctrl+C	Quit application	Global

Configuration

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

Development

Environment Setup

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.

Contributing

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

License

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

---