{"id":19658600,"url":"https://github.com/alexis-moins/pm","last_synced_at":"2025-04-28T20:31:23.424Z","repository":{"id":205681492,"uuid":"665705514","full_name":"alexis-moins/pm","owner":"alexis-moins","description":"Manage your projects the easy way 📦","archived":false,"fork":false,"pushed_at":"2025-01-22T18:32:23.000Z","size":185,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T10:33:29.963Z","etag":null,"topics":["bash","cli","gum","projects","tmux","vscode"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexis-moins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-12T20:06:53.000Z","updated_at":"2025-01-22T18:30:15.000Z","dependencies_parsed_at":"2024-11-11T15:40:27.992Z","dependency_job_id":"1fbdfb2f-cce7-489d-b915-8c5d5409e366","html_url":"https://github.com/alexis-moins/pm","commit_stats":null,"previous_names":["alexis-moins/pm"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fpm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fpm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fpm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexis-moins%2Fpm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexis-moins","download_url":"https://codeload.github.com/alexis-moins/pm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251383690,"owners_count":21580922,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","cli","gum","projects","tmux","vscode"],"created_at":"2024-11-11T15:38:15.353Z","updated_at":"2025-04-28T20:31:23.416Z","avatar_url":"https://github.com/alexis-moins.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align='center'\u003e\n\n![Version](https://img.shields.io/badge/version-1.8.4-blue.svg)\n\n\u003c/div\u003e\n\n`pm` is a bash script allowing users to rapidly list, create and navigate between your projects. It integrate with different backends (tmux, vscode) for convenience.\n\n## Prerequisites\n\n- bash 4.0 or higher\n- [gum](https://github.com/charmbracelet/gum)\n- tmux (optional)\n- git\n\n\n## 🧰 Installation\n\nClone the repository\n```bash\ngit clone git@github.com:alexis-moins/pm.git ~/.pm\n```\n\nGo into the install directory and execute the [install](install.sh) script:\n```bash\n./install.sh\n```\n\nThe install script copies the `pm` script in the `~/.local/bin` directory (you can also change the destination by passing it as an argument to the install script).\n\n## 🌱 Quick Start\n\nAfter installing, you can follow these steps to quickly see how it works:\n\n```bash\n# Add a new space\npm space add personal\n\n# You can then create new projects in this space\npm new personal/react-app\n\n# pm supports project creation using templates\npm new personal/react-app --template=vite\n\n# But also creating your own one\npm template new python-poetry\n\n# Opening a project is simple\npm open personal/react-app\n\n# But using a different backend is also possible\npm open personal/react-app --backend=vscode\n\n# You can even clone github repositories directly\npm clone git@github.com:alexis-moins/dot.git --space=work --name=dot\n```\n\n## 🚦 Usage\n\n```\n$ pm\n\npm - manage your projects the easy way\n\nUsage:\n  pm COMMAND\n  pm [COMMAND] --help | -h\n  pm --version | -v\n\nProject Commands:\n  new        Create a new empty project\n  clone      Clone a remote git repository\n  open       Open a project\n  filter     Filter projects\n  list       List projects\n\nCommands:\n  space      Add, list and filter spaces\n  template   Template related commands\n  backend    Backend related commands\n\nOptions:\n  --help, -h\n    Show this help\n\n  --version, -v\n    Show version number\n\nEnvironment Variables:\n  PM_HOME\n    Directory where the projects will be managed\n    Default: ~/dev\n\n  PM_BACKEND_SHOW_CMD\n    Command used to show backends\n    Default: cat\n\n  PM_TEMPLATE_SHOW_CMD\n    Command used to show templates\n    Default: cat\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexis-moins%2Fpm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexis-moins%2Fpm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexis-moins%2Fpm/lists"}