agentuity-cli-cloud-keyvalue-search
Search for keys matching a keyword in a keyvalue namespace. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-keyvalue-search skill enables users to efficiently query and locate keys within specific key-value namespaces on the Agentuity cloud platform. By integrating directly with the Agentuity CLI, this tool streamlines cloud data management, allowing developers and SREs to quickly retrieve configuration, session, or user-related data across various environments like production and staging.
Use Cases
- Production Troubleshooting: Quickly find specific user-related keys or metadata within a production namespace to diagnose account issues.
- Configuration Auditing: Search and verify configuration keys across staging and production environments to ensure environment parity.
- Cache Management: Identify active session keys or cached items within a specific namespace to monitor system performance or clear specific data.
- DevOps Automation: Integrate key-value searching into automated scripts for cloud resource discovery and infrastructure validation.
| name | agentuity-cli-cloud-keyvalue-search |
|---|---|
| description | Search for keys matching a keyword in a keyvalue namespace. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.104" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| argument-hint | "<name> <keyword>" |
| command | "agentuity cloud keyvalue search" |
| tags | "read-only slow requires-auth" |
Cloud Keyvalue Search
Search for keys matching a keyword in a keyvalue namespace
Prerequisites
- Authenticated with
agentuity auth login - Project context required (run from project directory or use
--project-id)
Usage
agentuity cloud keyvalue search <name> <keyword>
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<name> |
string | Yes | - |
<keyword> |
string | Yes | - |
Examples
Find all user-related keys:
bunx @agentuity/cli kv search production user
Find all session keys in cache:
bunx @agentuity/cli kv search cache session
Find all config keys:
bunx @agentuity/cli kv search staging config
Output
Returns JSON object:
{
"namespace": "string",
"keyword": "string",
"results": "array"
}
| Field | Type | Description |
|---|---|---|
namespace |
string | Namespace name |
keyword |
string | Search keyword used |
results |
array | - |