Working sub command and better outputs

Author: snichme

AGENTS.md

@@ -5,25 +5,23 @@ This document provides a comprehensive reference for AI agents using the CloudAM
 ## Configuration
 
 ### API Key Setup
-The CLI uses API keys in this priority order:
-1. `CLOUDAMQP_APIKEY` environment variable (for main API)
-2. `~/.cloudamqprc` JSON config file
+The CLI uses a single API key for all operations in this priority order:
+1. `CLOUDAMQP_APIKEY` environment variable
+2. `~/.cloudamqprc` plain text config file
 3. Interactive prompt
 
-For instance-specific operations, use:
-- `CLOUDAMQP_INSTANCE_{ID}_APIKEY` environment variable
-- Stored in `~/.cloudamqprc` under `instance_keys`
-
 ### Base URL
-Default: `https://customer.cloudamqp.com/api` (can be changed for development)
+Default: `https://customer.cloudamqp.com/api` (unified API endpoint)
 
 ## Command Structure
 
 ```
-cloudamqp <category> <action> [arguments] [flags]
+cloudamqp <category> <action> [--id <instance_id>] [other flags]
 ```
 
-## Main API Commands (using main API key)
+All instance-specific operations use the `--id` flag to specify the instance.
+
+## Main API Commands
 
 ### Instance Management
 
@@ -35,9 +33,8 @@ cloudamqp instance list
 
 #### Get Instance Details
 ```bash
-cloudamqp instance get <id>
+cloudamqp instance get --id <id>
 ```
-- Automatically saves instance API key for later use
 - Returns: Full instance details including API key, URLs, hostnames
 
 #### Create Instance
@@ -50,20 +47,20 @@ cloudamqp instance create --name=<name> --plan=<plan> --region=<region> [--tags=
 
 #### Update Instance
 ```bash
-cloudamqp instance update <id> --name=<new_name> --plan=<new_plan>
+cloudamqp instance update --id <id> --name=<new_name> --plan=<new_plan>
 ```
 - Updates instance name and/or plan
 - Use for upgrading/downgrading plans
 
 #### Delete Instance
 ```bash
-cloudamqp instance delete <id>
+cloudamqp instance delete --id <id>
 ```
 - Permanently deletes the instance
 
 #### Resize Instance Disk
 ```bash
-cloudamqp instance resize <id> --disk-size=<gb> [--allow-downtime]
+cloudamqp instance resize --id <id> --disk-size=<gb> [--allow-downtime]
 ```
 - Required: disk-size (in GB)
 - Optional: allow-downtime flag
@@ -77,7 +74,7 @@ cloudamqp vpc list
 
 #### Get VPC Details
 ```bash
-cloudamqp vpc get <id>
+cloudamqp vpc get --id <id>
 ```
 
 #### Create VPC
@@ -87,12 +84,12 @@ cloudamqp vpc create --name=<name> --region=<region> --subnet=<subnet> [--tags=<
 
 #### Update VPC
 ```bash
-cloudamqp vpc update <id> --name=<new_name>
+cloudamqp vpc update --id <id> --name=<new_name>
 ```
 
 #### Delete VPC
 ```bash
-cloudamqp vpc delete <id>
+cloudamqp vpc delete --id <id>
 ```
 
 ### Team Management
@@ -109,101 +106,122 @@ cloudamqp team invite --email=<email> [--role=<role>] [--tags=<tag>]
 
 #### Update Team Member
 ```bash
-cloudamqp team update <id> --role=<role>
+cloudamqp team update --user-id <id> --role=<role>
 ```
 
 #### Remove Team Member
 ```bash
-cloudamqp team remove <id>
+cloudamqp team remove --email=<email>
 ```
 
 ### Billing & Plans
 
 #### List Available Plans
 ```bash
-cloudamqp plans
+cloudamqp plans [--backend=<rabbitmq|lavinmq>]
 ```
 - Returns: Array of plans with name, price, backend, shared status
 
 #### List Available Regions
 ```bash
-cloudamqp regions
+cloudamqp regions [--provider=<provider>]
 ```
 
-
 ### Audit & Security
 
-#### List Audit Logs
+#### Export Audit Logs
 ```bash
-cloudamqp audit
+cloudamqp audit [--timestamp=<timestamp>]
 ```
 
 #### Rotate API Key
 ```bash
 cloudamqp rotate-key
 ```
 
-## Instance-Specific API Commands (using instance API key)
+## Instance-Specific Operations
 
-These commands use the pattern: `cloudamqp instance manage <instance_id> <category> <action>`
+All instance-specific commands use the unified API and `--id` flag pattern.
 
 ### Node Management
 
 #### List Nodes
 ```bash
-cloudamqp instance manage <id> nodes
+cloudamqp instance nodes list --id <id>
+```
+
+#### Get Available Versions
+```bash
+cloudamqp instance nodes versions --id <id>
 ```
 
 ### Plugin Management
 
 #### List Plugins
 ```bash
-cloudamqp instance manage <id> plugins list
+cloudamqp instance plugins list --id <id>
 ```
 - Returns: Array of plugins with name, version, description, enabled status
 
+### RabbitMQ Configuration
+
+#### List All Configuration Settings
+```bash
+cloudamqp instance config list --id <id>
+```
+
+#### Get Specific Configuration Setting
+```bash
+cloudamqp instance config get --id <id> --key <config_key>
+```
+
+#### Set Configuration Setting
+```bash
+cloudamqp instance config set --id <id> --key <config_key> --value <config_value>
+```
+
 ### Account Operations
 
 #### Rotate Instance Password
 ```bash
-cloudamqp instance manage <id> account rotate-password
+cloudamqp instance account rotate-password --id <id>
 ```
 
 #### Rotate Instance API Key
 ```bash
-cloudamqp instance manage <id> account rotate-apikey
+cloudamqp instance account rotate-apikey --id <id>
 ```
 
 ### Instance Actions
 
 #### Restart Operations
 ```bash
-cloudamqp instance manage <id> actions restart-rabbitmq [--nodes=node1,node2]
-cloudamqp instance manage <id> actions restart-cluster
-cloudamqp instance manage <id> actions restart-management [--nodes=node1,node2]
+cloudamqp instance actions restart-rabbitmq --id <id> [--nodes=node1,node2]
+cloudamqp instance actions restart-cluster --id <id>
+cloudamqp instance actions restart-management --id <id> [--nodes=node1,node2]
 ```
 
 #### Start/Stop Operations
 ```bash
-cloudamqp instance manage <id> actions start [--nodes=node1,node2]
-cloudamqp instance manage <id> actions stop [--nodes=node1,node2]
-cloudamqp instance manage <id> actions reboot [--nodes=node1,node2]
-cloudamqp instance manage <id> actions start-cluster
-cloudamqp instance manage <id> actions stop-cluster
+cloudamqp instance actions start --id <id> [--nodes=node1,node2]
+cloudamqp instance actions stop --id <id> [--nodes=node1,node2]
+cloudamqp instance actions reboot --id <id> [--nodes=node1,node2]
+cloudamqp instance actions start-cluster --id <id>
+cloudamqp instance actions stop-cluster --id <id>
 ```
 
 #### Upgrade Operations
 ```bash
-cloudamqp instance manage <id> actions upgrade-erlang
-cloudamqp instance manage <id> actions upgrade-rabbitmq --version=<version>
-cloudamqp instance manage <id> actions upgrade-all
-cloudamqp instance manage <id> actions upgrade-versions  # Check available versions
+cloudamqp instance actions upgrade-erlang --id <id>
+cloudamqp instance actions upgrade-rabbitmq --id <id> --version=<version>
+cloudamqp instance actions upgrade-all --id <id>
+cloudamqp instance actions upgrade-versions --id <id>  # Check available versions
 ```
 
 #### Feature Toggle Operations
 ```bash
-cloudamqp instance manage <id> actions toggle-hipe --enable=true/false [--nodes=node1,node2]
-cloudamqp instance manage <id> actions toggle-firehose --enable=true/false --vhost=<vhost>
+cloudamqp instance actions toggle-hipe --id <id> --enable=true/false [--nodes=node1,node2]
+cloudamqp instance actions toggle-firehose --id <id> --enable=true/false --vhost=<vhost>
 ```
 
 ## Common Usage Patterns
@@ -215,25 +233,40 @@ cloudamqp instance create --name="my-instance" --plan="bunny-1" --region="amazon
 
 # Poll until ready
 while true; do
-  cloudamqp instance get <id> | grep '"ready": true' && break
+  cloudamqp instance get --id <id> | grep '"ready": true' && break
   sleep 30
 done
 ```
 
 ### 2. Upgrade Instance Plan
 ```bash
-cloudamqp instance update <id> --plan="rabbit-3"
+cloudamqp instance update --id <id> --plan="rabbit-3"
 ```
 
-### 3. Instance Management Workflow
+### 3. Complete Instance Management Workflow
 ```bash
-# Get instance details (saves API key automatically)
-cloudamqp instance get <id>
+# Get instance details
+cloudamqp instance get --id <id>
 
-# Now you can use instance-specific commands
-cloudamqp instance manage <id> nodes
-cloudamqp instance manage <id> plugins list
-cloudamqp instance manage <id> actions restart-rabbitmq
+# Check nodes and configuration
+cloudamqp instance nodes list --id <id>
+cloudamqp instance config list --id <id>
+
+# Perform maintenance
+cloudamqp instance actions restart-rabbitmq --id <id>
+cloudamqp instance actions upgrade-all --id <id>
+```
+
+### 4. Configuration Management
+```bash
+# List all configuration
+cloudamqp instance config list --id <id>
+
+# Get specific setting
+cloudamqp instance config get --id <id> --key tcp_listen_options
+
+# Update configuration
+cloudamqp instance config set --id <id> --key tcp_listen_options --value '[{"port": 5672}]'
 ```
 
 ## Common Plans
@@ -270,10 +303,21 @@ cloudamqp instance manage <id> actions restart-rabbitmq
 
 ## Notes for AI Agents
 
-1. Always use `cloudamqp instance get <id>` before instance-specific operations to ensure the instance API key is saved
-2. Instance creation is async - poll with `get` until `ready: true`
-3. Plan upgrades are immediate but may cause brief downtime
-4. Some actions (upgrades, restarts) are asynchronous - they return immediately but run in background
-5. The `--tags` flag can be used multiple times: `--tags=prod --tags=web`
-6. VPC operations require the instance to be in the same region as the VPC
-7. When asked for the openapi spec there are make targets `make openapi.yaml` and `make openapi-instance.yaml` to download the latest version.
+1. **Unified API**: All operations now use a single API key and the unified customer API endpoint
+2. **Flag-based Commands**: All instance-specific operations use `--id <instance_id>` instead of positional arguments
+3. **Instance Creation**: Instance creation is async - poll with `get --id <id>` until `ready: true`
+4. **Plan Upgrades**: Plan upgrades are immediate but may cause brief downtime
+5. **Async Operations**: Some actions (upgrades, restarts) are asynchronous - they return immediately but run in background
+6. **Multiple Tags**: The `--tags` flag can be used multiple times: `--tags=prod --tags=web`
+7. **VPC Requirements**: VPC operations require the instance to be in the same region as the VPC
+8. **Configuration Management**: Use the config commands to manage RabbitMQ settings directly
+9. **OpenAPI Specs**: When asked for OpenAPI specs, use make targets `make openapi.yaml` and `make openapi-instance.yaml` to download the latest versions
+
+## Configuration File Format
+
+The `~/.cloudamqprc` file contains only your API key in plain text:
+```
+your-api-key-here
+```
+
+No JSON formatting or multiple keys are needed - the unified API handles all operations with a single key.