ABDUCO(1)

✨ ABDUCO(1) — the session-manager girlie 🦋

Hiii bestie, okay so this is the manual page for abduco, the terminal session manager. It's giving main character energy 💅🎀

---

🌸 NAME

abduco — terminal session manager 💖

---

🧚 SYNOPSIS

abduco [-e detachkey] [-r] [-f] -c name command [args ...]
abduco [-e detachkey] [-r] [-f] -n name command [args ...]
abduco [-e detachkey] [-r] [-f] [-l] -A name command [args ...]
abduco [-e detachkey] [-r] [-l] -a name

---

🦋 DESCRIPTION

Okay so abduco lets you unhook a given app from its controlling terminal, so it's basically the same attach/detach vibe as screen(1), tmux(1) or dtach(1). Iconic behavior, no cap 🔥

If you don't specify the command to run, abduco checks the environment variable $ABDUCO_CMD. If that isn't set either, it runs dvtm(1) instead 💜

All your session info gets stored in these directories, and the first one that works is the one used (in this order) 📂✨:

$ABDUCO_SOCKET_DIR/abduco
$HOME/.abduco
$TMPDIR/abduco/$USER
/tmp/abduco/$USER

Lowkey, if your session name is a relative or absolute path, abduco uses it exactly as you typed it 🫶

If for some reason the unix(7) domain socket representing a session gets deleted, sending SIGUSR1 to the server process will recreate it 😭

---

👑 OPTIONS

If you run abduco with no arguments, you get a list of all the currently active sessions, sorted by creation date. A * in front means at least one client is connected 🌈 A + means the command already finished while nobody was connected, so attach to see its exit status 💀

• -v — Prints the version info to standard output and exits. Quick flex 💅
• -r — Readonly session, so user input gets ignored 🙈
• -e detachkey — Sets the detach key. By default it's CTRL+\ (aka ^\) 🦋
• -f — Forces creation of a session even if there's already a terminated session with the same name. It shows you that session's exit status first 💖
• -c — Creates a new session and attaches to it right away ✨
• -n — Creates a new session but does not attach to it 🧚
• -A — Tries to connect to an existing session. If that fails, it creates the session and attaches immediately 🎀
• -a — Attaches to an existing session 🌸
• -l — Attaches with the lowest priority, which means this client is the last one to control the size 🍓

---

🍓 EXAMPLE

Start a new session (assuming dvtm(1) is in $PATH) with:

abduco -c my-session

Then do some work, detach by pressing CTRL+, and later reattach with:

abduco -a my-session

---

💜 AUTHOR

abduco is written by Marc André Tanner <mat at brain-dump.org> 🫶

---

Bestie, that's the whole page 🌈 abduco-0.6 (ABDUCO(1)) — the manual you just read, stay iconic, periodt 💅✨