Skip to content

Latest commit

 

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Project Manager

A simple python-based CLI tool for rapidly navigating multiple project directories.

What does it do?

pm provides a command line method of easily maintaining aliases for project directories and allowing the user to spawn a new shell or terminal at that project path using that alias.

USAGE

To view full options, run pm help

USAGE:
$ pm <sub-command|project-name> [args]

SUB COMMANDS:
  add <name> <path> ............. Add a project to the db
  ls ............................ List all projects in db
  rm <name> ..................... Remove project <name>
  chdir <name> <path> ........... Change a project's path
  rename <old-name> <new-name> .. Rename a project
  help .......................... Display this menu

CONFIG

The project manager config file is, by default, located at ~/.config/pm/. There are two files in this directory: config.json, which stores the project manager config settings, and projects.json, which is the "db" of projects.

Customization

Currently, the terminal which is launched can be set by the user. To do this, the key "term" must be set in the config file. Two values will be automatically filled in by the project manager:

  1. TNAME: Will be filled in with the name of the project.
  2. TWD: Will be set to the project's associated directory (terminal working directory).

Example: Gnome Terminal

"term":[
    "/usr/bin/gnome-terminal",
    "--title", "TNAME",
    "--working-directory", "TWD",
    "--tab"
]

Example: Konsole

"term":[
    "/usr/bin/konsole",
    "--workdir", "TWD",
    "--new-tab"
]

Example: Windows Terminal

"term":[
    "wt.exe",
    "new-tab",
    "--title", "TNAME",
    "--startingDirectory", "TWD",
    "wsl"
]

Example: Git Bash on Windows

"term":[
    "C:\\Program Files\\Git\\git-bash.exe",
    "--cd=TWD"
]

About

Simple utility to quickly open project directories

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Contributors

Languages