Quick Start

The fastest way to try Redock is to connect your iPhone or iPad to a Mac on the same Wi-Fi. This path avoids public networking and lets you verify SSH, projects, AI coding agents, and tmux recovery first.

What You Need

A Mac that you can sign in to.
Redock installed on your iPhone or iPad.
Both devices connected to the same Wi-Fi.
Your macOS username and password.
Optional remote tools: tmux, claude, codex, or opencode.

Redock connects to your remote host. Claude Code, Codex, opencode, Node, Python, and other tools must be installed on the Mac or server, not on the iPhone.

Once the Host is connected, you can control Codex CLI from iPhone over SSH, resume Claude Code in a tmux session, and keep each repository organized as a mobile Project workspace for AI coding agents.

Enable Remote Login

Open System Settings on the Mac.
Go to General > Sharing.
Turn on Remote Login.
Prefer Only these users and allow only your development account.
Keep the Mac awake and connected to Wi-Fi while testing.

Screenshot **Remote Login enabled in macOS Sharing settings** Enable Remote Login and restrict access to the development accounts that need it.

You can confirm your username in Terminal:

whoami

If local discovery does not find the Mac, check the Wi-Fi address:

ipconfig getifaddr en0

Add the Host in Redock

Open Redock and go to Launch.
Add a Host.
Tap Discover Local Devices. Allow Local Network permission if iOS asks.
Select the discovered Mac, or enter the LAN IP manually.
Use Port 22.
Enter your macOS username.
Start with Password authentication.
Save and connect.

Host configuration for a typical local Mac:

Host: 192.168.1.23
Port: 22
Username: your-mac-username
Auth: Password
Connection Mode: SSH

Screenshot **Redock Host form for a local Mac** A local Mac Host uses its LAN address, port 22, the macOS username, and an authentication method.

demo.mp4 00:10

Video walkthrough Connect Redock to a Mac for the first time Enable Remote Login, add the Mac as a Host, and confirm the terminal connection.

Try the Core Workflow

After the terminal opens, enter a project directory:

cd ~/Projects/your-project

Start the AI coding agent installed on the remote host:

claude
codex
opencode

Screenshot **Redock terminal connected successfully to a Mac** A successful terminal connection confirms that the Host, username, and authentication are working.

If tmux is installed on the Mac, enable Redock tmux in the Host settings. Redock can then create and restore sessions so long-running work survives brief network changes or app backgrounding.

Next Steps

Switch from Password to SSH Key once the local connection works.
Add a Project in Redock for your common working directory.
Create Actions for repeatable commands such as tests, status checks, or agent launch commands.
Configure Tailscale if you want to connect outside the same Wi-Fi.

Troubleshooting

Connection refused: Remote Login is off, or the Port is not 22.
Connection timed out: the devices are not on the same network, the IP changed, or Wi-Fi blocks local traffic.
Authentication failed: check that Username is your macOS account name, not your Apple ID.
AI agent command not found: install the tool on the remote Mac and confirm it is in PATH.