abduco

# macOS (Homebrew)
brew install abduco

# Ubuntu/Debian
apt install abduco

# Arch Linux
pacman -S abduco

# From source
git clone https://www.brain-dump.org/projects/abduco/
cd abduco
make
sudo make install

# Check if abduco is installed
abduco -v

# Show help
abduco -h

# Create a new session named "mysession" running bash
abduco -c mysession

# Create a session with a specific program
abduco -c dev dvtm
abduco -c work vim
abduco -c python python3

# Attach to an existing session
abduco -a mysession

# Create and attach if doesn't exist, or attach if it does
abduco -A mysession

# List all sessions
abduco -l

# While in a session, detach with Ctrl+# Press Ctrl+Backslash to detach

# After detaching, you can close your terminal safely
# The session continues running

# Later, reattach to the same session
abduco -a mysession

# List sessions to find which ones exist
abduco -l

# Attach to session "work"
abduco -a work

# Create a persistent dvtm session
abduco -c main dvtm

# Inside dvtm, use Ctrl+g for window management
# Use Ctrl+ to detach from the session

# Detaching from abduco session
# Inside dvtm, press Ctrl+ to exit dvtm
# This detaches you from the abduco session

# Later, reattach to continue
abduco -a main

# Inside dvtm again, continue with your windows
Ctrl+g n  # Next window
Ctrl+g c  # Create new window

# Persistent bash shell
abduco -c shell

# Persistent vim session
abduco -c editor vim file.txt

# Persistent Python interpreter
abduco -c py python3

# Persistent SSH session with command
abduco -c remote ssh user@host

# Watch a long-running build
abduco -c build ./build.sh
# Later check on it
abduco -a build

/* In config.h, find and modify the detach key */
#define DETACH_KEY '\' /* Ctrl+ */

/* Change to your preferred key, for example: */
#define DETACH_KEY 'd' /* Would be Ctrl+d */

/* Then rebuild */
make clean
make
sudo make install

# ABDUCO_DETACH_KEY - Override detach key (if compiled with support)
# DVTM - Path to dvtm executable (if using abduco + dvtm integration)

# Set environment variables for your session
export DVTM=/usr/bin/dvtm
abduco -c main

# Or use in one line
DVTM=/usr/local/bin/dvtm abduco -c work dvtm

# Add to your shell config for easy access

# Create quick session launch functions
function work() {
  abduco -A work dvtm
}

function dev() {
  abduco -A dev dvtm
}

function ses() {
  abduco -l  # List all sessions
}

# Or create a quick launcher
function abduco_new() {
  abduco -A "$1" "${2:-$SHELL}"
}

# Usage: abduco_new mysession
# Usage: abduco_new build ./build.sh