https://github.com/mrtc0/appman
https://github.com/mrtc0/appman
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/mrtc0/appman
- Owner: mrtc0
- License: mit
- Created: 2022-12-19T02:12:09.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-08T06:03:41.000Z (over 1 year ago)
- Last Synced: 2025-03-24T04:15:33.799Z (3 months ago)
- Language: Go
- Size: 167 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# appman
A TUI tools that simple process manager for developers.
# Install
```shell
$ go install github.com/mrtc0/appman
```
# Configuration
### Example
```yaml
- name: "frontend"
path: "/path/to/frontend"
startCommand: ["npm", "run", "start"]
port: 3000
url: "http://localhost:3000"
- name: "api"
path: "/path/to/backend"
startCommand: ["go", "run", "main.go"]
port: 5600
url: "http://localhost:5600"
- name: "database"
path: "/path/to/backend"
startCommand: ["docker", "compose", "up"]
stopCommand: ["docker", "compose", "down"]
```
### `name` (required)
`name` is application name.
### `path` (required)
`path` is the directory from which to run the application.
### `startCommand` (required)
`startCommand` is a command to start an application.
### `stopCommand` (optional)
`startCommand` is a command to stop an application.
If `stopCommand` is not specified, appman will send SIGTERM to the process when it stops the application.
### `port` (optional)
`port` is application port number.
### `url` (optional)
`url` is application URL.
# Command
- `Tab`: Switching focus.
- `Enter`: Item selection.
- `Ctrl + C` or `ESC`: Exit appman. All applications are automatically stopped.