https://github.com/hua1995116/mmt
A tool that automatically opens multiple panes to execute multiple commands in MacOS + iTerm2
https://github.com/hua1995116/mmt
command-line iterm2 nodejs
Last synced: 7 months ago
JSON representation
A tool that automatically opens multiple panes to execute multiple commands in MacOS + iTerm2
- Host: GitHub
- URL: https://github.com/hua1995116/mmt
- Owner: hua1995116
- License: mit
- Created: 2022-02-21T13:43:53.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-05-17T11:02:22.000Z (over 3 years ago)
- Last Synced: 2024-10-12T04:14:01.949Z (12 months ago)
- Topics: command-line, iterm2, nodejs
- Language: TypeScript
- Homepage: https://mmt.run
- Size: 1.21 MB
- Stars: 64
- Watchers: 4
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Read this in other languages: [简体中文](./README_zh.md) | English
# Introduction
MMT (Manage Multiple Task) is a tool that automatically opens multiple panes to execute multiple commands in MacOS + iTerm2. It only needs to be defined once and run permanently.
# Installation
```
npm i -g mmt
```
## Use
### Case1: Single project with multiple repositories
When your project has two projects, front and back, you always need to remember multiple commands or multiple directories, and opening multiple windows will always be troublesome.
your front end project：case1-front, launch command: `npm run start`
your backend project: case1-backend, launch command: `npm run dev`
Declaration using mmt:
```
> cd path/case1-front
> mmt add case1 start
> cd path/case1-backend
> mmt add case1 dev
```
In any command window:
```
> mmt run case1
```
The effect is the following(Automatically open multiple windows and execute commands in the corresponding windows):
### Case2: Multiple projects and multiple repositories
When you maintain a project with multiple technology stacks alone, you can't remember all the startup command. The start command for a Vue project may be `npm run serve`, while for a React project it is `npm run start`, and some projects may also be `npm run dev`. Using mmt can smooth out this difference and you don't have to memorize your project path.
your project1: projec1-vue, launch command `npm run serve`
your project2: projec2-react, launch command `npm run start`
Declaration using mmt:
```
> cd path/projec1-vue
> mmt add project1 serve
> cd path/projec2-react
> mmt add project2 start
```
In any command window:
```
> mmt run project1
> mmt run project2
```
The effect is the following:
### Case3: Script alias
When you want to run some pipeline work synchronously, you can use the `add-sync`. For example, one of my local projects needs to depend on two container environments e8a47b8aed91 and e0d433a26388. At this time, running mmt will automatically execute the command。
```
> mmt add-sync project1-dep "docker restart e8a47b8aed91"
> mmt add-sync project1-dep "docker restart e0d433a26388"
```
In any command window:
```
> mmt run project1-dep
```
## API
### add
Support platform: Mac/Linux
Add an asynchronous task, the task will start with a new tab page.
Common scenarios:
When we have a full stack service, we need to start the frontend and backend. At this time, we need to switch tab pages every time, and then start two services.
For example, my other project "Mujicv" is a full-stack project. At this time, I can do this if I want to quickly start the front-end and back-end.
```
mmt add muji "cd frontend/path && npm run start";
mmt add muji "cd server/path && npm run dev";
mmt run muji
```
At this point, two new tab pages will be opened to run the front-end and back-end services.
### add-sync
Add a synchronization task, the task will be executed directly on the current page.
Common scenarios:
For example, whenever we need to switch projects, there are some pre-made environments and mmt can help us handle those situations. For example, one of my local projects needs to depend on two container environments e8a47b8aed91 and e0d433a26388. At this time, running mmt will automatically execute the command.
```
mmt add-sync start-docker "docker restart e8a47b8aed91";
mmt add-sync start-docker "docker restart e0d433a26388";
mmt run start-docker
> docker restart e8a47b8aed91
> docker restart e0d433a26388
```
### ls
List what commands the current task has.
```
mmt ls muji
> cd frontend/path && npm run start
> cd server/path && npm run dev
```
### rm
Delete a task.
`mmt rm `
```
mmt rm muji
> delete muji task success!
```
### run
Run a task.
`mmt run `
```
mmt run muji
```
### export
`mmt export `
Export all configurations.
```
mmt export all
```
Export a single configuration.
```
mmt export muji
```
## License
MIT
Copyright (c) 2022- 蓝色的秋风