FlightDesk CLI

The command-line interface for FlightDesk — AI task management for Claude Code sessions.

What is FlightDesk?

FlightDesk helps development teams track and manage work performed by Claude Code remote sessions. It provides:

• Task lifecycle tracking from dispatch to merged PR
• Automated session monitoring and status detection
• Multi-organization support for developers working across clients
• Integration with GitHub, SonarQube, and other review tools

Learn more at flightdesk.dev

Installation

npm install -g flightdesk

Security Notice

This CLI uses Playwright to monitor Claude Code sessions in a headless browser.

This means:

• The CLI runs a Chromium browser instance on your machine
• It authenticates to claude.ai using your stored browser session
• It reads session UI to detect branch names and PR status
• It can automatically click "Create PR" buttons when detected

You should understand what this tool does before running it. The flightdesk watch command operates a browser automation daemon that interacts with live web sessions. While the CLI only reads status information and clicks PR creation buttons, browser automation tools are inherently powerful.

We recommend:

• Reviewing the source code if you have concerns
• Running flightdesk watch only on trusted machines
• Using flightdesk auth to set up authentication in a visible browser first

Quick Start

# Configure your FlightDesk API credentials
flightdesk init

# Authenticate with Claude (opens a browser for login)
flightdesk auth

# Register a Claude Code session with a task
claude --remote "Fix the auth bug" | flightdesk register <project-id>

# Start the monitoring daemon
flightdesk watch

Commands

| Command | Description | |---------|-------------| | flightdesk init | Configure API credentials | | flightdesk auth | Log in to Claude for session monitoring | | flightdesk register | Register a session with a task | | flightdesk task | Create, list, and manage tasks | | flightdesk status | Show status of all active tasks | | flightdesk watch | Start the session monitoring daemon | | flightdesk prompt | Get prompts ready to paste into Claude | | flightdesk org | Manage organization connections | | flightdesk context | Show current repo/org mapping | | flightdesk sync | Refresh project-to-repo mappings |

Multi-Organization Support

Developers working across multiple clients can connect multiple FlightDesk organizations:

# Add organizations
flightdesk org add

# List connected organizations
flightdesk org list

# Set default organization
flightdesk org default <org-id>

# Check which org maps to current repo
flightdesk context

The CLI automatically routes tasks to the correct organization based on the Git repository you're working in.

Documentation

Full documentation available at flightdesk.dev/docs

License

This software is proprietary. See flightdesk.dev for licensing information.