shifft-cli
v1.1.10
Published
Mobile and Web client for Claude Code and Codex
Readme
Shifft
Code on the go — control AI coding agents from your phone, browser, or terminal.
Free. Open source. Code anywhere.
Installation
npm install -g shifftMigrated from the
happy-coderpackage. Thanks to @franciscop for donating theshifftpackage name!
Usage
Claude Code (default)
shifft
# or
shifft claudeThis will:
- Start a Claude Code session
- Display a QR code to connect from your mobile device or browser
- Allow real-time session control — all communication is end-to-end encrypted
- Start new sessions directly from your phone or web while your computer is online
More agents
shifft codex
shifft gemini
shifft openclaw
# or any ACP-compatible CLI
shifft acp opencode
shifft acp -- custom-agent --flagDaemon
The daemon is a background service that stays running on your machine. It lets you spawn and manage coding sessions remotely — from your phone or the web app — without needing an open terminal.
shifft daemon start
shifft daemon stop
shifft daemon status
shifft daemon listThe daemon starts automatically when you run shifft, so you usually don't need to manage it manually.
Keeping the daemon running across reboots
If you want the daemon to come back automatically after a reboot — without opening a shifft session first — start it from your shell profile so it inherits your normal user session context (PATH, keychain access, OAuth credentials):
# ~/.zshrc or ~/.bashrc
if [[ -o interactive ]] && [[ -z "$SHIFFT_DAEMON_CHECKED" ]]; then
export SHIFFT_DAEMON_CHECKED=1
() {
local state=$HOME/.shifft/daemon.state.json
local pid=$(grep -oE '"pid"[[:space:]]*:[[:space:]]*[0-9]+' "$state" 2>/dev/null | grep -oE '[0-9]+')
if [[ -z "$pid" ]] || ! kill -0 "$pid" 2>/dev/null; then
shifft daemon start >/dev/null 2>&1
fi
} &!
fiThe first interactive shell after a reboot triggers the start; subsequent shells short-circuit because the daemon is already running.
macOS users: prefer this shell-init approach over a
launchdLaunchAgent. A LaunchAgent runs in an agent domain that is detached from your GUI/Aqua login session, which means the bundledclaude-agent-sdkcannot reach the macOS keychain and silently fails authentication ("Failed to authenticate. API Error: 401 terminated",duration_api_ms: 0). If you must use launchd, your wrapper has to read the OAuth access token from~/.claude/.credentials.jsonand export it asCLAUDE_CODE_OAUTH_TOKENbefore exec'ing the daemon — and you'll need to handle token rotation yourself.
Authentication
shifft auth login
shifft auth logoutShifft uses cryptographic key pairs for authentication — your private key stays on your machine. All session data is end-to-end encrypted before leaving your device.
To connect third-party agent APIs:
shifft connect gemini
shifft connect claude
shifft connect codex
shifft connect statusCommands
| Command | Description |
|---------|-------------|
| shifft | Start Claude Code session (default) |
| shifft codex | Start Codex mode |
| shifft gemini | Start Gemini CLI session |
| shifft openclaw | Start OpenClaw session |
| shifft acp | Start any ACP-compatible agent |
| shifft resume <id> | Resume a previous session |
| shifft notify | Send push notification to your devices |
| shifft doctor | Diagnostics & troubleshooting |
Advanced
Environment Variables
| Variable | Description |
|----------|-------------|
| SHIFFT_SERVER_URL | Custom server URL (default: http://localhost:3005) |
| SHIFFT_WEBAPP_URL | Custom web app URL (default: https://app.shifft.app) |
| SHIFFT_HOME_DIR | Custom home directory for Shifft data (default: ~/.shifft) |
| SHIFFT_DISABLE_CAFFEINATE | Disable macOS sleep prevention |
| SHIFFT_EXPERIMENTAL | Enable experimental features |
Sandbox (experimental)
Shifft can run agents inside an OS-level sandbox to restrict file system and network access.
shifft sandbox configure
shifft sandbox status
shifft sandbox disableBuilding from source
git clone https://github.com/Saif-09/shifft
cd shifft-cli
yarn install
yarn workspace shifft cli --helpRequirements
- Node.js >= 20.0.0
- For Claude:
claudeCLI installed & logged in - For Codex:
codexCLI installed & logged in - For Gemini:
npm install -g @google/gemini-cli+shifft connect gemini
License
MIT
