moshi-best-practices

The moshi-best-practices skill prepares or verifies a host so it is easy to use for remote coding from the Moshi iOS client. It supports both fresh setup and verification of an existing setup, and follows the rules to inspect before editing, prefer direct config edits, and verify every outcome.

It covers host readiness (preferring Easy Pair via moshi-hook, with Mosh plus tmux as the preferred transport and SSH plus tmux as fallback, and concrete checks for tmux and mosh-server), recommended tmux defaults, and the MOSHI_CLIENT environment signal that lets shell rc files, prompts, and tmux configs detect a Moshi-launched session and adapt (for example clearing the status bar so swipe gestures work). It also sets up a tmux project session via the packaged launcher and installs agent hooks using the moshi-hook daemon, which holds a persistent WebSocket so tool-call approvals can be made bidirectionally from the iOS Live Activity or Apple Watch, covering Claude Code, Codex CLI, and OpenCode. It calls out security boundaries, such as the Easy Pair QR granting SSH access and the file secret store writing outside Keychain.

It is most useful for developers setting up a host for Moshi remote coding who want reliable SSH/Mosh, tmux, and agent-hook configuration with verification.