Skip to content

lockelee1015/project-man

BranchesTags

Repository files navigation

Project Man (p)

Stop losing track of your Git repositories. Start organizing them.

中文说明 | English

English

The Problem

As a developer, you probably have this frustrating experience:

  • "Where did I put that project?" - Repositories scattered across ~/Desktop, ~/Downloads, ~/dev, ~/projects...
  • "Was it called awesome-tool or awesome_tool?" - Spending minutes just finding the right directory
  • "Which version is this?" - Multiple copies of the same project in different folders
  • "I need to update all my repos..." - Manually checking each project one by one

Sound familiar? You're not alone.

The Solution

Project Man (p) transforms chaos into order with one simple principle: organize by source, navigate by memory.

# Your scattered projects become organized:
~/workspace/
├── github.com/rust-lang/rust/     # Clear ownership
├── github.com/microsoft/vscode/   # No confusion
└── gitlab.com/your-company/api/   # Multiple hosts, one place

# Navigate instantly without remembering exact names:
p go rust           # → ~/workspace/github.com/rust-lang/rust/
p go vscode         # → ~/workspace/github.com/microsoft/vscode/
p go api            # → ~/workspace/gitlab.com/your-company/api/

See It In Action

From chaos to organized in seconds:

# 1. Initialize your organized workspace
p init ~/workspace

# 2. Add projects from anywhere - they get organized automatically
p add rust-lang/rust                    # GitHub shorthand
p add https://github.com/microsoft/vscode
p add git@gitlab.com:company/secret-api

# 3. Navigate instantly with fuzzy search
p go rust        # Takes you to rust-lang/rust immediately
p go vs          # Finds and navigates to vscode
p go secret      # Jumps to your company's API project

# 4. Keep everything up to date
p sync           # Updates all repositories
p list           # See status of all projects at a glance

Result: No more hunting through folders. No more "where did I put that?" Just type a few letters and you're there.

Core Features

  • 🚀 Quick Repository Management: Clone, sync, and organize repositories with simple commands
  • 🔍 Fuzzy Search Navigation: Instantly navigate between repositories using fuzzy matching
  • 📁 Organized Directory Structure: Automatic organization as workspace/github.com/user/repo
  • 🔄 Batch Operations: Sync multiple repositories or search across all at once
  • 🛠️ Shell Integration: Seamless directory changing with shell functions
  • ⚙️ Flexible Configuration: Support for multiple Git hosts and protocols
  • 🎯 Interactive Selection: User-friendly interactive menus for multiple matches

Installation

Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/lockelee1015/project-man/main/scripts/quick-install.sh | bash

Manual Installation

  1. Download the latest release:

    • Go to Releases
    • Download the appropriate archive for your platform:
      • project-man-x86_64-unknown-linux-gnu.tar.gz (Linux x86_64)
      • project-man-aarch64-unknown-linux-gnu.tar.gz (Linux ARM64)
      • project-man-x86_64-apple-darwin.tar.gz (macOS Intel)
      • project-man-aarch64-apple-darwin.tar.gz (macOS Apple Silicon)

  2. Extract and install:

    tar -xzf project-man-*.tar.gz
cd project-man-*
./install.sh

From Source (Development)

# Clone the repository
git clone https://github.com/lockelee1015/project-man.git
cd project-man

# Build and install
cargo build --release
./install.sh

Quick Start

# Initialize a workspace
p init ~/workspace

# Add repositories (supports various formats)
p add rust-lang/rust                              # GitHub shorthand
p add git@github.com:user/repo.git               # SSH URL
p add https://github.com/user/repo.git           # HTTPS URL

# Navigate to repositories
p go rust                                         # Fuzzy search
p go SuperClaude                                  # Direct match

# List all repositories with status
p list

# Sync repositories
p sync                                            # Sync all
p sync rust                                       # Sync matching pattern

# Search across repositories
p grep "TODO"                                     # Search all repos
p grep "async" rust                               # Search in specific repos

# Remove repositories
p remove old-project

# Show workspace status
p status

# Migrate existing repositories
p migrate ~/old-projects

Directory Structure

Project Man organizes repositories in a clear, hierarchical structure:

workspace/
├── github.com/
│   ├── rust-lang/
│   │   └── rust/
│   ├── user/
│   │   └── project/
├── gitlab.com/
│   └── user/
│       └── project/
└── project-man.yml          # Workspace registry

Configuration

Global Configuration

Location: ~/.config/project-man/config.toml

[workspace]
path = "/Users/john/workspace"

[git]
default_host = "github.com"
default_protocol = "ssh"       # or "https"

[search]
fuzzy_threshold = 0.6
max_results = 10

[ui]
use_colors = true
confirm_destructive_actions = true

Workspace Registry

Location: <workspace>/project-man.yml

Contains metadata for all repositories in the workspace, including paths, URLs, tags, and sync timestamps.

Shell Integration

The shell integration enables automatic directory changing:

# Add to ~/.bashrc or ~/.zshrc
source /path/to/project-man/shell-integration.sh

# Now these commands will change your directory:
p go rust-lang    # Changes to the rust-lang repository
p add new/repo    # Clones and changes to the new repository

Command Reference

Command Description
p init <path> Initialize a new workspace
p add <repo> Clone and add a repository
p go <pattern> Navigate to a repository (fuzzy search)
p list List all repositories with status
p remove <pattern> Remove a repository from workspace
p sync [pattern] Synchronize repositories
p grep <pattern> [repo] Search across repositories
p migrate <source> Import existing repositories
p config show/set/get Manage configuration
p status Show workspace status

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for detailed development guidelines, testing procedures, and submission process.

License

This project is licensed under the MIT License - see the LICENSE file for details.

中文说明

痛点场景

作为开发者，你是否也有这样的困扰：

  • "那个项目放哪儿了？" - 代码仓库散落在 ~/Desktop、~/Downloads、~/dev、~/projects 各个角落
  • "叫什么名字来着？" - 为了找到正确的目录，花费好几分钟回忆项目名称
  • "这是哪个版本？" - 同一个项目在不同文件夹有多个副本
  • "需要更新所有项目..." - 一个个手动检查每个项目的状态

这些场景是不是很熟悉？你并不孤单。

解决方案

Project Man (p) 用一个简单的原则将混乱变为有序：按来源组织，凭记忆导航。

# 散乱的项目变得井然有序：
~/workspace/
├── github.com/rust-lang/rust/      # 清晰的归属
├── github.com/microsoft/vscode/    # 不再困惑
└── gitlab.com/your-company/api/    # 多个主机，统一管理

# 无需记住确切名称，即时导航：
p go rust           # → ~/workspace/github.com/rust-lang/rust/
p go vscode         # → ~/workspace/github.com/microsoft/vscode/
p go api            # → ~/workspace/gitlab.com/your-company/api/

实际效果

几秒钟从混乱到有序：

# 1. 初始化有序的工作区
p init ~/workspace

# 2. 从任何地方添加项目 - 自动组织
p add rust-lang/rust                    # GitHub 简写
p add https://github.com/microsoft/vscode
p add git@gitlab.com:company/secret-api

# 3. 模糊搜索即时导航
p go rust        # 立即跳转到 rust-lang/rust
p go vs          # 找到并导航到 vscode
p go secret      # 跳转到公司的 API 项目

# 4. 保持所有项目最新
p sync           # 更新所有仓库
p list           # 一览所有项目状态

结果： 不再在文件夹中寻找。不再有"放哪儿了？"的困扰。只需输入几个字母就能到达目的地。

特性

  • 🚀 快速仓库管理: 通过简单命令克隆、同步和组织仓库
  • 🔍 模糊搜索导航: 使用模糊匹配即时在仓库间导航
  • 📁 有序目录结构: 自动组织为 workspace/github.com/user/repo 结构
  • 🔄 批量操作: 一次性同步多个仓库或跨所有仓库搜索
  • 🛠️ Shell 集成: 通过 shell 函数实现无缝目录切换
  • ⚙️ 灵活配置: 支持多个 Git 主机和协议
  • 🎯 交互式选择: 对于多个匹配结果提供用户友好的交互菜单

安装

快速安装（推荐）

curl -fsSL https://raw.githubusercontent.com/lockelee1015/project-man/main/scripts/quick-install.sh | bash

手动安装

  1. 下载最新版本:

    • 访问 Releases
    • 下载适合你平台的压缩包:
      • project-man-x86_64-unknown-linux-gnu.tar.gz (Linux x86_64)
      • project-man-aarch64-unknown-linux-gnu.tar.gz (Linux ARM64)
      • project-man-x86_64-apple-darwin.tar.gz (macOS Intel)
      • project-man-aarch64-apple-darwin.tar.gz (macOS Apple Silicon)

  2. 解压并安装:

    tar -xzf project-man-*.tar.gz
cd project-man-*
./install.sh

从源码安装（开发用）

# 克隆仓库
git clone https://github.com/lockelee1015/project-man.git
cd project-man

# 构建并安装
cargo build --release
./install.sh

快速开始

# 初始化工作区
p init ~/workspace

# 添加仓库（支持多种格式）
p add rust-lang/rust                              # GitHub 简写
p add git@github.com:user/repo.git               # SSH URL
p add https://github.com/user/repo.git           # HTTPS URL

# 导航到仓库
p go rust                                         # 模糊搜索
p go SuperClaude                                  # 直接匹配

# 列出所有仓库及状态
p list

# 同步仓库
p sync                                            # 同步所有
p sync rust                                       # 同步匹配模式的仓库

# 跨仓库搜索
p grep "TODO"                                     # 搜索所有仓库
p grep "async" rust                               # 在特定仓库中搜索

# 移除仓库
p remove old-project

# 显示工作区状态
p status

# 迁移现有仓库
p migrate ~/old-projects

目录结构

Project Man 将仓库组织成清晰的层次结构：

workspace/
├── github.com/
│   ├── rust-lang/
│   │   └── rust/
│   ├── user/
│   │   └── project/
├── gitlab.com/
│   └── user/
│       └── project/
└── project-man.yml          # 工作区注册表

配置

全局配置

位置: ~/.config/project-man/config.toml

[workspace]
path = "/Users/john/workspace"

[git]
default_host = "github.com"
default_protocol = "ssh"       # 或 "https"

[search]
fuzzy_threshold = 0.6
max_results = 10

[ui]
use_colors = true
confirm_destructive_actions = true

工作区注册表

位置: <workspace>/project-man.yml

包含工作区中所有仓库的元数据，包括路径、URL、标签和同步时间戳。

Shell 集成

Shell 集成支持自动目录切换：

# 添加到 ~/.bashrc 或 ~/.zshrc
source /path/to/project-man/shell-integration.sh

# 现在这些命令将切换你的目录：
p go rust-lang    # 切换到 rust-lang 仓库
p add new/repo    # 克隆并切换到新仓库

命令参考

命令 描述
p init <path> 初始化新工作区
p add <repo> 克隆并添加仓库
p go <pattern> 导航到仓库（模糊搜索）
p list 列出所有仓库及状态
p remove <pattern> 从工作区移除仓库
p sync [pattern] 同步仓库
p grep <pattern> [repo] 跨仓库搜索
p migrate <source> 导入现有仓库
p config show/set/get 管理配置
p status 显示工作区状态

贡献

欢迎贡献！请查看 CONTRIBUTING.md 了解详细的开发指南、测试流程和提交规范。

许可证

本项目采用 MIT 许可证 - 详情请见 LICENSE 文件。

About

No description, website, or topics provided.

Resources

Readme

Contributing

Contributing
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases 6

Project Man v0.1.5 Latest
Jul 12, 2025
+ 5 releases

Packages

No packages published

Languages