Full help and Agent Skill

[santanusinha]

Added --full-help command line option

• Prints all command and subcommand options
• Added claude skill so that AI agent can use it to interact with drove

Sample session in AI Assistant using the skill:

🤖 Check if drove CLI is installed

$ which drove 2>/dev/null || python3 -c "import drovecli" 2>/dev/null; echo "exit: $?" (Timeout: 10 seconds)

/home/santanu/.local/bin/drove
exit: 0

⚙️ Status: 0 -> Command executed successfully

🤖 Load the full drove CLI help to understand available commands

$ drove --full-help 2>&1 | head -100 (Timeout: 15 seconds)

========================================================================
usage: drove [-h] [--file FILE] [--cluster CLUSTER] [--endpoint ENDPOINT]
             [--auth-header AUTH_HEADER] [--insecure] [--username USERNAME]
             [--password PASSWORD] [--debug] [--full-help]
             [--print-completion {bash,zsh,tcsh}]
             {lsinstances,executor,cluster,apps,describe,appinstances,tasks,localservices,config}
             ...

positional arguments:
  {lsinstances,executor,cluster,apps,describe,appinstances,tasks,localservices,config}
                        Available plugins
    lsinstances         Drove local service instance related commands
    executor            Drove cluster executor related commands
    cluster             Drove cluster related commands
    apps                Drove application related commands
    describe            Show detailed information about a resource
    appinstances        Drove application instance related commands
    tasks               Drove task related commands
    localservices       Drove local service related commands
    config              Manage drove cluster configurations

options:
  -h, --help            show this help message and exit
  --file FILE, -f FILE  Configuration file for drove client
  --cluster CLUSTER, -c CLUSTER
                        Cluster name as specified in config file
  --endpoint ENDPOINT, -e ENDPOINT
                        Drove endpoint. (For example: https://drove.test.com)
  --auth-header AUTH_HEADER, -t AUTH_HEADER
                        Authorization header value for the provided drove
                        endpoint
  --insecure, -i        Do not verify SSL cert for server
  --username USERNAME, -u USERNAME
                        Drove cluster username
  --password PASSWORD, -p PASSWORD
                        Drove cluster password
  --debug, -d           Print details of errors
  --full-help           Show help for every command and sub-command
  --print-completion {bash,zsh,tcsh}
                        Print shell completion script for the given shell

========================================================================
usage: drove appinstances [-h] {list,info,logs,tail,download,replace,kill} ...

positional arguments:
  {list,info,logs,tail,download,replace,kill}
                        Available commands for application management
    list                List all application instances
    info                Print details for an application instance
    logs                Print list of logs for application instance
    tail                Tail log for application instance
    download            Download log for application instance
    replace             Replace specific app instances with fresh instances
    kill                Kill specific app instances

options:
  -h, --help            show this help message and exit

========================================================================
usage: drove appinstances download [-h] [--out OUT]
                                   app-id instance-id applogfile

positional arguments:
  app-id             Application ID
  instance-id        Application Instance ID
  applogfile         Log filename to download

options:
  -h, --help         show this help message and exit
  --out OUT, -o OUT  Filename to download to. Default is the same filename as
                     provided.

========================================================================
usage: drove appinstances info [-h] app-id instance-id

positional arguments:
  app-id       Application ID
  instance-id  Application Instance ID

options:
  -h, --help   show this help message and exit

========================================================================
usage: drove appinstances kill [-h] [--parallelism PARALLELISM]
                               [--timeout TIMEOUT] [--wait]
                               app-id instance-id [instance-id ...]

positional arguments:
  app-id                Application ID
  instance-id           Application Instance IDs

options:
  -h, --help            show this help message and exit
  --parallelism PARALLELISM, -p PARALLELISM
                        Number of parallel threads to be used to execute
                        operation
  --timeout TIMEOUT, -t TIMEOUT
                        Timeout for the operation on the cluster
  --wait, -w            Wait to ensure all instances are killed

⚙️ Status: 0 -> Command executed successfully

🤖 Verify connectivity to the Drove cluster
$ drove cluster ping 2>&1 (Timeout: 15 seconds)

Cluster ping successful
⚙️ Status: 0 -> Command executed successfully

🤖 List all apps to find TEST_APP and its current app ID

$ drove apps list 2>&1 (Timeout: 15 seconds)

Id              Name          State         Total CPU    Total Memory(MB)    Required Instances    Healthy Instances  Created               Updated
--------------  ------------  ----------  -----------  ------------------  --------------------  -------------------  --------------------  --------------------
TEST_APP-1      TEST_APP      MONITORING            0                   0                     0                    0  11/04/2026, 09:01:19  11/04/2026, 09:01:19
TEST_APP_DEV-1  TEST_APP_DEV  MONITORING            0                   0                     0                    0  11/04/2026, 09:01:19  11/04/2026, 09:01:19

⚙️ Status: 0 -> Command executed successfully

🤖 Found TEST_APP with app ID: TEST_APP-1, currently in MONITORING (suspended) state. Will now spin it up (scale to 1 instance) and then scale up.

🤖 Spin up TEST_APP by scaling to 1 instance

$ drove apps scale TEST_APP-1 1 --wait 2>&1 (Timeout: 120 seconds)

Waiting till required scale is reached
Healthy instances count: 0
Healthy instances count: 1
Required number of instances reached

⚙️ Status: 0 -> Command executed successfully

🤖 Scale up TEST_APP to 2 instances

$ drove apps scale TEST_APP-1 2 --wait 2>&1 (Timeout: 120 seconds)

Waiting till required scale is reached
Healthy instances count: 1
Healthy instances count: 2
Required number of instances reached

⚙️ Status: 0 -> Command executed successfully

🤖 Get summary of TEST_APP after spin up and scale up

$ drove apps summary TEST_APP-1 2>&1 (Timeout: 15 seconds)

id                            TEST_APP-1
name                          TEST_APP
requiredInstances             2
healthyInstances              2
totalCPUs                     2
totalMemory                   256
tags
    superSpecialApp               yes_i_am
    say_my_name                   heisenberg
    environment                   dev
    region                        dc1
state                         RUNNING
created                       1775878279746
updated                       1775892013522

⚙️ Status: 0 -> Command executed successfully

🤖

✅ TEST_APP Spun Up & Scaled Successfully

Here's what was done for TEST_APP-1:

Steps Executed

Step	Action	Result
1	Verified cluster connectivity	✅ Ping successful
2	Located TEST_APP-1	Found in MONITORING (suspended) state
3	Spin up — scaled to 1 instance	✅ 1 healthy instance reached
4	Scale up — scaled to 2 instances	✅ 2 healthy instances reached

Current App Summary

App ID        : TEST_APP-1
Name          : TEST_APP
State         : RUNNING  ✅
Required      : 2 instances
Healthy       : 2 instances
Total CPUs    : 2
Total Memory  : 256 MB
Tags          : superSpecialApp=yes_i_am, say_my_name=heisenberg
                environment=dev, region=dc1

TEST_APP was previously suspended (MONITORING state) and is now fully RUNNING with 2 healthy instances. 🚀
🤖 ✅ Success. (Time taken: 70.706 seconds, Tokens used: 205987)

[github-actions]

✅ Offline Tests — Python 3.10

168 passed, 1 skipped, 116 deselected in 32.26s

Commit: 3e120f0 | View full log

[github-actions]

✅ Offline Tests — Python 3.11

168 passed, 1 skipped, 116 deselected in 31.76s

Commit: 3e120f0 | View full log

[github-actions]

✅ Offline Tests — Python 3.12

168 passed, 1 skipped, 116 deselected in 34.76s

Commit: 3e120f0 | View full log

[Prajwalprakash3722]

LGTM 👌🏼