Downcity
CommandsService

city service command

Forward custom action commands to a service

city service command

Forward any action command to a target service.

Usage

city service command <serviceName> <command> [--payload <json>] [--agent <name> | --path <path>] [--host <host>] [--port <port>]

Key options

  • --payload <json>: action input payload; JSON string is supported, non-JSON is passed as plain string
  • --agent <name> / --path <path>: target agent resolution

Examples

city service command task list --payload '{"status":"enabled"}' --agent my-agent
city service command memory search --payload '{"query":"release decision"}' --path /abs/path/to/agent

Example Output (Based on Current Implementation)

The examples below are aligned with current command implementations in package/src (including default output mode and field structure). Placeholder values are used for environment-specific fields.

$ city service command task list --payload '{"status":"enabled"}' --agent <agentName>
{
  "success": true,
  "service": "task",
  "data": {
    "success": true,
    "tasks": []
  }
}
$ city service command task list --agent missing-agent
{
  "success": false,
  "error": "Agent not found in console registry: missing-agent. Run \"city console agents\" to inspect names."
}

Table of Contents