tmux-code

README

tmux-code

Run OpenCode via Tmux — locally or on remote machines over SSH.

Features

• Local mode: Launch OpenCode in a local Tmux session
• Remote mode: Launch OpenCode on a remote machine via SSH + Tmux
• First-run setup: Interactive wizard to configure SSH connection details
• Cross-platform: Linux and macOS (amd64/arm64)

Requirements

• Go 1.22+
• Tmux 3.0+
• OpenCode installed on the target machine
• SSH access (for remote mode)

Installation

go install github.com/haribote-lab/tmux-code/cmd/tmux-code@latest

Or download a binary from Releases.

Quick Start

# First run — interactive setup
tmux-code

# Local mode
tmux-code start --local

# Remote mode (uses saved SSH config)
tmux-code start --remote

Configuration

Config is stored at ~/.config/tmux-code/config.yaml.

ssh:
  host: dev-server.example.com
  port: 22
  user: dev
  key_path: ~/.ssh/id_ed25519

Development

make test       # Run tests with race detector
make lint       # Run linters
make build      # Build binary
make coverage   # Generate coverage report

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT