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

``bash
npm install -g flockbay
`

Usage

`bash
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 - Claude model to use (default: sonnet)
- -p, --permission-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 eventsource-parser@3.0.5, 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)

Windows UX note

- Codex MCP child processes are started with hidden console windows to prevent blank cmd.exe` popups during session startup.

License

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