flightdesk 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +96 -0
- package/package.json +3 -6
package/README.md
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# FlightDesk CLI
|
|
2
|
+
|
|
3
|
+
The command-line interface for [FlightDesk](https://flightdesk.dev) — AI task management for Claude Code sessions.
|
|
4
|
+
|
|
5
|
+
## What is FlightDesk?
|
|
6
|
+
|
|
7
|
+
FlightDesk helps development teams track and manage work performed by Claude Code remote sessions. It provides:
|
|
8
|
+
|
|
9
|
+
- Task lifecycle tracking from dispatch to merged PR
|
|
10
|
+
- Automated session monitoring and status detection
|
|
11
|
+
- Multi-organization support for developers working across clients
|
|
12
|
+
- Integration with GitHub, SonarQube, and other review tools
|
|
13
|
+
|
|
14
|
+
Learn more at **[flightdesk.dev](https://flightdesk.dev)**
|
|
15
|
+
|
|
16
|
+
## Installation
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm install -g flightdesk
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Security Notice
|
|
23
|
+
|
|
24
|
+
**This CLI uses Playwright to monitor Claude Code sessions in a headless browser.**
|
|
25
|
+
|
|
26
|
+
This means:
|
|
27
|
+
- The CLI runs a Chromium browser instance on your machine
|
|
28
|
+
- It authenticates to claude.ai using your stored browser session
|
|
29
|
+
- It reads session UI to detect branch names and PR status
|
|
30
|
+
- It can automatically click "Create PR" buttons when detected
|
|
31
|
+
|
|
32
|
+
**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.
|
|
33
|
+
|
|
34
|
+
We recommend:
|
|
35
|
+
- Reviewing the source code if you have concerns
|
|
36
|
+
- Running `flightdesk watch` only on trusted machines
|
|
37
|
+
- Using `flightdesk auth` to set up authentication in a visible browser first
|
|
38
|
+
|
|
39
|
+
## Quick Start
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
# Configure your FlightDesk API credentials
|
|
43
|
+
flightdesk init
|
|
44
|
+
|
|
45
|
+
# Authenticate with Claude (opens a browser for login)
|
|
46
|
+
flightdesk auth
|
|
47
|
+
|
|
48
|
+
# Register a Claude Code session with a task
|
|
49
|
+
claude --remote "Fix the auth bug" | flightdesk register <project-id>
|
|
50
|
+
|
|
51
|
+
# Start the monitoring daemon
|
|
52
|
+
flightdesk watch
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Commands
|
|
56
|
+
|
|
57
|
+
| Command | Description |
|
|
58
|
+
|---------|-------------|
|
|
59
|
+
| `flightdesk init` | Configure API credentials |
|
|
60
|
+
| `flightdesk auth` | Log in to Claude for session monitoring |
|
|
61
|
+
| `flightdesk register` | Register a session with a task |
|
|
62
|
+
| `flightdesk task` | Create, list, and manage tasks |
|
|
63
|
+
| `flightdesk status` | Show status of all active tasks |
|
|
64
|
+
| `flightdesk watch` | Start the session monitoring daemon |
|
|
65
|
+
| `flightdesk prompt` | Get prompts ready to paste into Claude |
|
|
66
|
+
| `flightdesk org` | Manage organization connections |
|
|
67
|
+
| `flightdesk context` | Show current repo/org mapping |
|
|
68
|
+
| `flightdesk sync` | Refresh project-to-repo mappings |
|
|
69
|
+
|
|
70
|
+
## Multi-Organization Support
|
|
71
|
+
|
|
72
|
+
Developers working across multiple clients can connect multiple FlightDesk organizations:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# Add organizations
|
|
76
|
+
flightdesk org add
|
|
77
|
+
|
|
78
|
+
# List connected organizations
|
|
79
|
+
flightdesk org list
|
|
80
|
+
|
|
81
|
+
# Set default organization
|
|
82
|
+
flightdesk org default <org-id>
|
|
83
|
+
|
|
84
|
+
# Check which org maps to current repo
|
|
85
|
+
flightdesk context
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
The CLI automatically routes tasks to the correct organization based on the Git repository you're working in.
|
|
89
|
+
|
|
90
|
+
## Documentation
|
|
91
|
+
|
|
92
|
+
Full documentation available at **[flightdesk.dev/docs](https://flightdesk.dev/docs)**
|
|
93
|
+
|
|
94
|
+
## License
|
|
95
|
+
|
|
96
|
+
This software is proprietary. See [flightdesk.dev](https://flightdesk.dev) for licensing information.
|
package/package.json
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "flightdesk",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "FlightDesk CLI - AI task management for Claude Code sessions",
|
|
5
|
+
"homepage": "https://flightdesk.dev",
|
|
5
6
|
"main": "main.js",
|
|
6
7
|
"bin": {
|
|
7
8
|
"flightdesk": "./main.js",
|
|
@@ -16,11 +17,7 @@
|
|
|
16
17
|
"cli"
|
|
17
18
|
],
|
|
18
19
|
"author": "FlightDesk",
|
|
19
|
-
"license": "
|
|
20
|
-
"repository": {
|
|
21
|
-
"type": "git",
|
|
22
|
-
"url": "https://github.com/flightdesk/flightdesk"
|
|
23
|
-
},
|
|
20
|
+
"license": "UNLICENSED",
|
|
24
21
|
"engines": {
|
|
25
22
|
"node": ">=18.0.0"
|
|
26
23
|
},
|