FAQ
Redock FAQ
Answers about ChatView, Agent notifications, setup, data storage, speech input, and remote terminal workflows.
Is Redock free?
Yes. Redock is free to use, and the free version covers most everyday workflows. To support ongoing development, Redock also offers a Pro version that unlocks advanced features. Current reference prices in the US App Store are $4.99/month, $29.99/year, and $69.99 lifetime, but the actual price should be checked in the applicable App Store or Google Play purchase screen.
Which mobile platforms does Redock support?
Redock supports iOS, iPadOS, and Android. You can download it from the App Store or Google Play.
Does Redock run Codex, Claude Code, or OpenCode on my phone?
Claude Code, Codex, OpenCode, Git, tmux, package managers, and project tools run in your development environment. Redock connects over SSH or Mosh and gives you mobile controls for launching, steering, and resuming that work.
What is ChatView, and when should I use Terminal View?
ChatView presents the Agent conversation already running in your terminal as readable messages, with follow-up input and compact tool activity. It uses the same conversation, model settings, and Agent login on your host. Switch to Terminal View for permission prompts, interactive menus, slash commands, and full TUI controls; switching views does not start another Agent or create a new conversation.
How do I set up ChatView and Agent notifications?
Open Agent Settings, choose a saved SSH host under Install & Pair, and follow the steps to install Redock Hook and pair the host. Then start or restart a supported Agent in your terminal and use the view-switch button beside the composer to open ChatView. For notifications, enable Agent notifications in settings and allow system notifications; iOS also offers Live Activities. Available capabilities depend on the Agent and the installed App and Hook versions.
What data do Redock Hook and Relay handle?
Hook observes supported Agent events on your host. If you enable notifications or usage sync, Relay stores pairing identifiers, recent Agent states and short summaries, and the latest usage snapshot. Notifications travel through Apple or Google push services, and summaries may contain excerpts from prompts, replies, or errors. Full ChatView conversations travel over SSH, not Relay. SSH credentials use platform-protected storage, while saved usage-source keys stay on the host. See the Privacy Policy for retention and deletion details.
What data does Redock store?
Redock stores product configuration such as Hosts, Projects, Actions, terminal snippets, preferences, and related metadata. It also keeps local runtime history such as Runs and recent connection context so Activity can show recent work.
Where are SSH passwords, private keys, and speech API keys stored?
Secrets use platform-protected credential storage and are not written into the regular app data snapshot. On Apple platforms, Redock uses Keychain and can use synchronizable iCloud Keychain items when Pro iCloud sync is enabled. Platform-specific storage and sync availability may differ on Android.
What does iCloud sync include?
On Apple platforms, enabling iCloud sync can save supported configuration such as Hosts, Projects, Actions, snippets, preferences, and metadata to your private CloudKit database. Local runtime history such as recent connections and Runs remains device-local and does not sync through CloudKit. iCloud and CloudKit do not apply to Android.
How does speech transcription work?
Speech input is optional. Redock records audio, sends it to the speech provider you choose, then puts the transcript into the editable staged input area before you send it to the terminal or agent TUI.
Do I need my own OpenAI API key for speech?
For OpenAI speech transcription, yes. Add the key in My / Speech. Redock stores it using platform-protected credential storage and uses OpenAI transcription models such as gpt-4o-mini-transcribe, gpt-4o-transcribe, or gpt-4o-transcribe-diarize. Redock does not require Assistant, Realtime, TTS, or fine-tuning setup for speech input.
What should I enter for Doubao or Volcengine speech?
Choose the Doubao speech provider, enter the Resource ID for the speech recognition service, and enter the APP Key from the Volcengine console. The common default Resource ID is volc.bigasr.auc_turbo. Endpoint IDs such as ep-... are not used for this speech field.
Why does Redock ask for Local Network permission?
Local Network permission lets Redock discover SSH devices on the same LAN and prefill Host and Port while you are setting up a Mac or server. If you deny it, you can still enter the host address manually.
Can I use Mosh?
Yes. A Host can use SSH or Mosh. Mosh still uses SSH for preflight and mosh-server bootstrap, then uses UDP for the interactive shell when available. If Mosh startup cannot complete in a recoverable path, Redock can fall back to a standard SSH shell.
Why does tmux matter?
Phones disconnect, switch networks, and go to the background. tmux keeps sessions and long tasks alive on the remote host. Redock gives you entry points to create, attach, and resume tmux sessions without typing tmux commands every time.
What is the difference between Actions and Runs?
Actions are reusable commands or agent entry points. A quick task or background task creates a Run, which records command status, output, timing, and background task metadata. Runs appear in Activity and do not become normal terminal connections unless you open a live tmux session from them.
What should I set up first?
Start with macOS Remote Login or a reachable SSH server on the same Wi-Fi. After the basic connection works, use Tailscale for a safer daily remote-access path.