Connect to a remote Linux host via SSH and create a named session.

If a session with the same name exists, it will be disconnected first. Credentials are automatically cached for future reconnection.

Args: host: Linux server IP address or hostname username: SSH username (default: root) password: SSH password (leave empty if using key_path) key_path: Path to SSH private key file (alternative to password) port: SSH port number (default: 22) session_name: Name for this session, e.g. 'prod', 'staging' (default: 'default')

Disconnect a specific SSH session.

Args: session_name: Name of the session to disconnect (default: 'default')

Disconnect all active SSH sessions.

List all active SSH sessions with connection details.

Shows session name, host, username, uptime, and command count.

Save SSH credentials for a session name (persisted to disk for future use).

Saved credentials are used for auto-reconnect and future sessions.

Args: session_name: Name to save these credentials under host: Linux server hostname or IP username: SSH username password: SSH password (leave empty if using key) key_path: Path to SSH private key port: SSH port

List all saved SSH credentials (passwords are masked for security).

Shows credentials from environment variables and cached sessions.

Execute a shell command on the remote Linux machine.

Returns stdout, stderr, and exit code. Output is truncated if too large.

Args: command: Shell command to execute (e.g., 'ls -la /var/log') session_name: SSH session to use (default: 'default') timeout: Command timeout in seconds (default: 30, max: 300)

Execute a multi-line bash script on the remote machine.

The script is passed to bash via stdin. Use this for complex operations.

Args: script: Multi-line bash script content session_name: SSH session to use (default: 'default') timeout: Script timeout in seconds (default: 60, max: 300)

Run a command in the background using nohup.

The command will continue running even after the SSH session ends. Output is redirected to a log file.

Args: command: Command to run in background log_file: Path for output log (default: /tmp/bg_command_.log) session_name: SSH session to use (default: 'default')

List directory contents with details (permissions, owner, size, date).

Args: path: Directory path to list (default: '/') session_name: SSH session to use show_hidden: Include hidden files (default: True)

Create a directory (and parent directories if needed).

Args: path: Directory path to create (uses mkdir -p) session_name: SSH session to use

Read the contents of a file on the remote machine.

Args: path: Absolute path to the file session_name: SSH session to use max_lines: Maximum number of lines to read (0 = all lines)

Write content to a file on the remote machine.

Args: path: Absolute path to the file content: Content to write session_name: SSH session to use append: If True, append to file instead of overwriting

Delete a file or directory on the remote machine.

Args: path: Path to delete session_name: SSH session to use recursive: If True, delete directories recursively (rm -rf)

Move or rename a file/directory.

Args: source: Source path destination: Destination path session_name: SSH session to use

Copy a file or directory.

Args: source: Source path destination: Destination path session_name: SSH session to use recursive: If True, copy directories recursively

Get detailed information about a file (size, type, permissions, owner, timestamps).

Args: path: Path to the file session_name: SSH session to use

Change file permissions (chmod).

Args: path: Path to file/directory permissions: Permission string (e.g., '755', '644', 'u+x') session_name: SSH session to use recursive: Apply recursively to directories

Change file ownership (chown).

Args: path: Path to file/directory owner: New owner username group: New group name (optional) session_name: SSH session to use recursive: Apply recursively

Find files and directories using the 'find' command with filters.

Args: path: Base directory to search in name: File name pattern (supports wildcards, e.g., '*.log') file_type: Type filter — 'f' for files, 'd' for directories, 'l' for symlinks size: Size filter (e.g., '+10M' for >10MB, '-1k' for <1KB) modified_within: Time filter (e.g., '7' for modified in last 7 days) session_name: SSH session to use

Check disk usage of a file or directory (du -sh).

Args: path: Path to check session_name: SSH session to use

Search for a pattern in files using grep.

Args: pattern: Search pattern (text or regex) path: File or directory to search in session_name: SSH session to use case_insensitive: Case-insensitive search recursive: Search recursively in directories

Get the last N lines of a file (useful for logs).

Args: path: Path to the file lines: Number of lines from the end (default: 50) session_name: SSH session to use

Get the first N lines of a file.

Args: path: Path to the file lines: Number of lines from the beginning (default: 50) session_name: SSH session to use

Search system logs using journalctl or grep.

Args: pattern: Search pattern log_path: Specific log file path (if empty, uses journalctl) session_name: SSH session to use since: Time filter for journalctl (e.g., '1 hour ago', '2024-01-01', 'today')

Find and replace text in a file using sed.

Args: file_path: Path to the file find: Text pattern to find replace: Replacement text session_name: SSH session to use backup: Create a .bak backup before modifying (default: True)

Get comprehensive system information (OS, kernel, CPU, RAM, uptime, hostname).

Args: session_name: SSH session to use

Show disk usage across all mounted filesystems (df -h).

Args: session_name: SSH session to use

Show detailed memory and swap usage.

Args: session_name: SSH session to use

Show CPU information, core count, and current load averages.

Args: session_name: SSH session to use

List running processes with optional filtering and sorting.

Args: session_name: SSH session to use filter_pattern: Filter processes by name/pattern (grep) sort_by: Sort by 'cpu' or 'mem' (default: no sorting)

Show top N processes by CPU or memory usage.

Args: session_name: SSH session to use count: Number of processes to show (default: 10) sort_by: Sort by 'cpu' or 'mem' (default: 'cpu')

Kill a process by its PID.

Args: pid: Process ID to kill session_name: SSH session to use signal: Signal to send (default: TERM, options: KILL, HUP, INT, etc.)

Show system load averages (1, 5, 15 minutes) and running process count.

Args: session_name: SSH session to use

Show network interfaces, IP addresses, and basic network configuration.

Args: session_name: SSH session to use

List all listening (open) ports and the processes using them.

Args: session_name: SSH session to use

Test if a specific port is reachable from the remote machine.

Args: host: Target hostname or IP port: Target port number session_name: SSH session to use

Ping a host from the remote machine.

Args: target: Hostname or IP to ping count: Number of ping packets (default: 4) session_name: SSH session to use

Perform DNS lookup for a domain.

Args: domain: Domain name to look up session_name: SSH session to use

List Docker containers (running or all).

Args: session_name: SSH session to use all: If True, show all containers including stopped ones

Get Docker container logs.

Args: container: Container name or ID session_name: SSH session to use lines: Number of log lines to retrieve (default: 100)

Execute a command inside a running Docker container.

Args: container: Container name or ID command: Command to execute inside the container session_name: SSH session to use

List Docker images on the remote machine.

Args: session_name: SSH session to use

Show Docker container resource usage statistics (CPU, memory, network).

Args: session_name: SSH session to use

Run docker compose commands.

Args: action: Compose action — 'up', 'down', 'restart', 'ps', 'logs', 'build', 'pull' path: Path to the directory containing docker-compose.yml session_name: SSH session to use

Inspect a Docker container (detailed configuration and state).

Args: container: Container name or ID session_name: SSH session to use

Install a package (auto-detects apt/yum/dnf/pacman).

Args: package: Package name to install session_name: SSH session to use

Remove/uninstall a package.

Args: package: Package name to remove session_name: SSH session to use

List installed packages with optional filter.

Args: filter_pattern: Filter packages by name pattern session_name: SSH session to use

Check for available package updates.

Args: session_name: SSH session to use

List system users (human accounts with login shells).

Args: session_name: SSH session to use

Get detailed information about a specific user.

Args: username: Username to look up session_name: SSH session to use

Show current user, groups, and environment info.

Args: session_name: SSH session to use

Show recent login history.

Args: session_name: SSH session to use count: Number of recent logins to show (default: 20)

List cron jobs for the current or specified user.

Args: user: Username (empty = current user) session_name: SSH session to use

Add a new cron job for the current user.

Args: schedule: Cron schedule expression (e.g., '0 2 * * *' for daily at 2am) command: Command to run session_name: SSH session to use

Remove cron jobs matching a pattern.

Args: pattern: Pattern to match (lines containing this will be removed) session_name: SSH session to use

Compress files or directories into an archive.

Args: source: Path to file/directory to compress destination: Output archive path (auto-generated if empty) session_name: SSH session to use format: Archive format — 'tar.gz' (default), 'tar.bz2', 'zip'

Extract an archive file.

Supports: .tar.gz, .tgz, .tar.bz2, .tar, .zip, .gz, .bz2

Args: archive: Path to the archive file destination: Directory to extract to (default: current directory) session_name: SSH session to use

Check the status of a systemd service.

Args: service: Service name (e.g., 'nginx', 'docker', 'sshd') session_name: SSH session to use

Manage a systemd service (start, stop, restart, enable, disable).

Args: service: Service name (e.g., 'nginx', 'docker') action: Action — 'start', 'stop', 'restart', 'enable', 'disable', 'reload' session_name: SSH session to use

Show recent failed login attempts (from auth.log or journalctl).

Args: session_name: SSH session to use count: Number of entries to show (default: 30)