Skip to content
This repository has been archived by the owner on Nov 21, 2023. It is now read-only.

mfulz/zsh-penmux

Repository files navigation

zsh-penmux

!!! This repo is dead as it was a dead end way: Check out tmux-penmux for it's successor!!!

zsh-penmux is a session manager plugin for zsh. It is meant to be used for penetration testing sessions and tracking the terminal sessions to be used in reports.

Features:

  • Managing tmux sessions for logging purpose (sessions, tasks, actions)
  • Layouts for session creation
  • Easy session logging by using tmux-logging-extended

Demo

gif

Getting Started

Requirements

Installation

oh-my-zsh

Clone this repositoy into the oh-my-zsh plugins folder:

cd ~/.oh-my-zsh/custom/plugins
git clone https://github.com/mfulz/tmux-logging-extended

Then add the following to your zshrc:

plugins+=(zsh-penmux)

Manual

TODO

Usage

1. Commands for penmux

Command Description
session Managing penmux sessions
task Managing penmux tasks
action Managing penmux actions
logger Managing logging

1.1 Commands for session

Command Description Options
create Will create a new penmux session --session,--work_dir,--no_log,--action,--task,--layout
attach Will attach to a penmux session --session
destroy Will end a penmux session --session
list List existing penmux sessions (None)

1.2 Commands for task

Command Description Options
create Will create a new task --session,--task,--action
rename Will rename a task --session,--task,--task_id,--new_name

1.3 Commands for action

Command Description Options
create Will create a new action --session,--task,--action
rename Will rename a task --session,--task,--task_id,--new_name,--no_log,-b,-d,-f,-h,-v

1.4 Commands for logger

Command Description Options
add Will add an action to the logger --session,--task,--task_id,--action,--action_id
remove Will remove an action from the logger --session,--task,--task_id,--action,--action_id
start Will start logging --session
stop Will stop logging --session
toggle Will toggle logging --session

About

zsh plugin for pentesting session tracking (dependend on tmux and tmux-logging-extended)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages