https://github.com/alexis-moins/domo
Manage your projects the easy way 🎏
https://github.com/alexis-moins/domo
bash cli gum projects tmux vscode
Last synced: 3 months ago
JSON representation
Manage your projects the easy way 🎏
- Host: GitHub
- URL: https://github.com/alexis-moins/domo
- Owner: alexis-moins
- License: mit
- Created: 2023-07-12T20:06:53.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-07T19:09:10.000Z (12 months ago)
- Last Synced: 2026-01-14T16:25:30.099Z (5 months ago)
- Topics: bash, cli, gum, projects, tmux, vscode
- Language: Shell
- Homepage:
- Size: 217 KB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
`domo` is a bash script allowing users to rapidly list, create and navigate between your projects. It integrate with different backends (tmux, vscode) for convenience.
## Prerequisites
- bash 4.0 or higher
- [gum](https://github.com/charmbracelet/gum)
- tmux (optional)
- git
## 🧰 Installation
Clone the repository
```bash
git clone git@github.com:alexis-moins/domo.git ~/.domo
```
Go into the install directory and execute the [install](install.sh) script:
```bash
./install.sh
```
The install script copies the `domo` script in the `~/.local/bin` directory (you can also change the destination by passing it as an argument to the install script).
## 🌱 Quick Start
After installing, you can follow these steps to quickly see how it works:
```bash
# Add a new space
domo space add personal
# You can then create new projects in this space
domo create work/react-app
# domo supports project creation using templates
domo create work/react-app --template=vite
# But also creating your own one
domo template add python-poetry
# Opening a project is simple
domo open work/react-app
# But using a different backend is also possible
domo open work/react-app --backend=vscode
# You can even clone github repositories directly
domo clone git@github.com:alexis-moins/dotfiles.git work/dotfiles
```
## 🚦 Usage
```
$ domo
domo - manage your projects the easy way
Usage:
domo COMMAND
domo [COMMAND] --help | -h
domo --version | -v
Project Commands:
create Create a new project
clone Clone a remote git repository
open Open a project
list List projects
exec Execute a command in a project
Commands:
space Space related commands
template Template related commands
backend Backend related commands
Options:
--help, -h
Show this help
--version, -v
Show version number
Environment Variables:
DOMO_HOME
Directory where the projects will be managed
Default: ~/dev
DOMO_SHOW_CMD
Command used to show backends & templates
Default: cat
```