Skip to content

anshul-kh/zep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zep

Zep is a lightweight process manager written in Go.

It is designed to easily run and manage background processes, services, cron jobs, shell commands, and APIs with minimal setup.

⚠️ Note: Zep is currently supported only on Unix-based systems (e.g. Linux, macOS). Windows support is not available.


✨ Features

  • 🧠 Simple CLI interface
  • 🚀 Run and manage background services or shell commands
  • 🧩 Support for naming and watching processes
  • 📊 View process stats
  • 🛑 Stop processes by ID or name
  • 🐚 Shell autocompletion support

📦 Installation

Follow these steps to install Zep from source.

1. Clone the Repository

git clone https://github.com/anshul-kh/zep.git
cd zep

2. Install Dependencies

Run the dependency installation script:

bash ./scripts/install-deps.sh

3. Build and Install

Use the provided Makefile to build the CLI and install the system service:

make install-service build-cli

This will:

  • Install the Zep systemd service (or equivalent)
  • Build the zep CLI binary

⚙️ Usage

zep [command] [flags]

📋 Available Commands

Command Description
completion Generate autocompletion script for your shell
help Help about any command
list List all running or registered processes
run Run and manage a binary using the binary path
stats Show stats for a process by ID or --name
stop Stop a running process by ID or --name
watch Watch live output from a process by ID or --name

🌐 Global Flags

  • -h, --help — Show help for Zep.
  • --name string — Assign or filter by name for a process.

🚀 Examples

Run a Process

zep run my-binary --name my-service

Run a Shell Command

zep run "ls -l" --name my-service --shell-cmd

List Running Processes

zep list

Get Process Stats

zep stats --name my-service

Stop a Process

zep stop --name my-service

Watch Process Output

zep watch --name my-service

🧪 Test / Demo

Build Test Binary

make build-test

Run Test Binary

zep run ./bin/test --name my-service

🛠️ Requirements

  • Go 1.18+
  • make installed
  • systemd (for service installation on Linux)

Zep makes managing background processes fast, simple, and reliable.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors