deploi

Multi-server file sync and deploy tool — push, pull, sync files across SSH/SFTP/rsync targets with git-aware file selection.

Like propq (multi-server SQL executor) but for files.

Features

• 7 file selection methods: git-diff, git-commit, git-branch, fzf, editor, all, path
• Interactive server picker: select target servers via fzf with -S/--pick-server
• Pre/Post hooks: run SSH commands before/after deploy on each server
• Diff preview: shows changes and asks for confirmation before transferring (default)
• Exclude patterns: auto-respects .gitignore, configurable in config.toml
• Deploy profiles: predefined file selection sets in config
• Deploy history: every deploy logged, view with deploi history
• Rollback: restore previous deploy state with deploi rollback
• Watch mode: auto-deploy on file changes (deploi watch)
• Concurrent: send files to many servers at once (goroutine + semaphore)
• SSH agent support: hooks use native Go SSH client with agent and key file auth (ed25519/ecdsa/rsa)
• Exit code reflects errors: deploy failures return non-zero exit code (CI-safe)
• Config-driven: TOML config with server definitions, tags for filtering

Quick Start

# Generate default config
deploi config generate

# List configured servers
deploi servers

# Push changed files (git-diff) to production servers
deploi push -s prod

# Push specific files
deploi push -s prod config/app.php

# Push files from a commit (interactive commit pick)
deploi push -s prod -m git-commit

# Push with fzf interactive file selection
deploi push -s prod -m fzf

# Push using a profile
deploi push -s staging --profile assets

# Pick servers interactively via fzf
deploi push -S -t prod

# Pull files from a server
deploi pull -s staging -m all remote/path/

# Sync (dry-run) to see what would change
deploi sync -s prod

# Run SSH commands
deploi run -s prod "systemctl reload nginx"

# Watch for changes and auto-deploy
deploi watch -s staging ./

# View deploy history
deploi history

# Create a project config interactively
deploi config init

# Test SSH connectivity
deploi check -v

Config

Config search order:

1. -c PATH explicit path
2. ./deploi.toml (current directory)
3. ~/.config/deploi/config.toml (Linux/macOS — XDG)
4. %APPDATA%/deploi/config.toml (Windows)
5. ~/.deploi/config.toml (home subdirectory)
6. ~/.deploi.toml (home file — fallback)

[defaults]
timeout = 300
concurrency = 5
editor = "vim"
remote_path = "/home/deploy/www/"
no_preview = false
confirm_without_filter = true
exclude = [".git", "node_modules"]
respect_gitignore = true

# Predefined deploy profiles
[profiles.full]
method = "git-diff"
remote_path = "/var/www/project/"

[profiles.assets]
method = "all"
paths = ["public/build/", "public/assets/"]

[servers.prod-web-1]
host = "web1.example.com"
port = 22
user = "deploy"
method = "rsync"
tags = ["prod", "web"]
remote_path = "/var/www/project/"
rsync_options = "-avz --delete"

# Pre/post deploy hooks
[servers.prod-web-1.hooks]
pre = ["php artisan down", "rm -rf var/cache/*"]
post = ["php artisan migrate --force", "php artisan up"]

[servers.staging]
host = "staging.example.com"
user = "deploy"
tags = ["staging"]

See config.toml.example for a full reference.

File Selection

Use -m/--method to choose how files are selected:

Method	Description	Example
git-diff (default)	Changed files in working tree	deploi push
git-commit	Files in a commit (interactive pick)	deploi push -m git-commit
git-branch	Files changed between branches	deploi push -m git-branch --branch main
fzf	Interactive file browser	deploi push -m fzf
editor	Editor-based selection	deploi push -m editor
all	All files in current directory	deploi push -m all
path	Explicit file paths	deploi push config/app.php

Commands

Command	Description
push	Upload files to remote servers (with diff preview)
pull	Download files from remote servers
sync	Dry-run comparison (what would change)
run	Execute SSH commands on remote servers
watch	Watch files and auto-deploy on changes
history [id]	Show deploy history
rollback [id]	Rollback to a previous deploy
servers	List configured servers
check	Test SSH connectivity with latency
config generate	Create a default config file
config validate	Validate config syntax
config init	Create a project-level deploi.toml interactively

Flags

Flag	Description
-s, --server	Glob/name filter for servers
-t, --tags	Filter by tags (comma-separated, OR)
-S, --pick-server	Pick servers interactively via fzf (also works with -t)
-c, --config	Config file path
-m, --method	File selection method: git-diff (default), git-commit, git-branch, fzf, editor, all, path
-P, --pick	Interactive commit pick via fzf
--profile	Use a named profile from config
--dry-run	Preview changes without transferring
--no-preview	Skip diff preview confirmation
--no-gitignore	Disable .gitignore auto-detection
--no-staged	Exclude staged files from git-diff
-v, --verbose	Show detailed rsync output and command
--json	JSON output
-q, --quiet	Suppress progress and banners
--force	Skip all confirmations and previews
--no-confirm	Skip "deploy to all servers?" confirmation
--rsync-opts	Extra rsync options

Install

# From source
cd ~/Belgeler/deploi
make install

# Build only
make build    # ./build/deploi

# Cross-platform build (all 7 platforms)
make build-all

GitHub Actions

On tag push (v*), CI builds for 7 platforms and creates a release: linux-amd64, linux-x86, linux-arm64, macos-amd64, macos-arm64, windows-amd64.exe, windows-x86.exe

See .github/workflows/release.yml.

AI Agent Integration

deploi skill install   # Install Hermes skill
deploi skill show      # View embedded skill

Contributing

Contributions are welcome! See CONTRIBUTING.md for setup, commit conventions, and the PR process. This project is released under the MIT License — see SECURITY.md for reporting vulnerabilities and CHANGELOG.md for release notes.