Flockbay CLI

Code on the go controlling Claude/Codex sessions from your mobile device.

Code anywhere.

Flockbay CLI is the command-line tool for running and controlling Flockbay sessions (including daemon and Codex mode).

Installation

npm install -g flockbay-cli

Usage

flockbay

This will:

1. Start a Claude Code session
2. Display a QR code to connect from your mobile device
3. Allow real-time session sharing between Claude Code and your mobile app

Commands

• flockbay auth – Manage authentication
• flockbay codex – Start Codex mode
• flockbay connect – Store AI vendor API keys in Flockbay
• flockbay notify – Send a push notification to your devices
• flockbay daemon – Manage background service
• flockbay doctor – System diagnostics & troubleshooting

Options

• -h, --help - Show help
• -v, --version - Show version
• -m, --model <model> - Claude model to use (default: sonnet)
• -p, --permission-mode <mode> - Permission mode: auto, default, or plan
• --claude-env KEY=VALUE - Set environment variable for Claude Code (e.g., for claude-code-router)
• --claude-arg ARG - Pass additional argument to Claude CLI

Run flockbay --help for the complete list of options.

Requirements

• Node.js >= 20.0.0
  • Required by [email protected], which is required by @modelcontextprotocol/sdk, which we used to implement permission forwarding to mobile app
• Claude CLI installed & logged in (claude command available in PATH)

License

Proprietary. Copyright (c) 2024-2026 Flockbay. All rights reserved.