Inspect the Mesh (Java)¶

🐍 Looking for Python? See Python Inspect Mesh | 📘 Looking for TypeScript? See TypeScript Inspect Mesh

View agents, tools, and dependencies with meshctl list and meshctl status

These commands are language-agnostic -- they work the same regardless of whether your agents are Java, Python, or TypeScript.

List Agents¶

# Show healthy agents (default)
meshctl list

# Show all agents including unhealthy
meshctl list --all

# Filter by name pattern
meshctl list --filter greeter

# Show additional columns (endpoints, tool counts)
meshctl list --wide

Example output:

NAME                    STATUS    DEPS     UPTIME
greeter-5395c5e4        healthy   2/2      5m
system-agent-a1b2c3d4   healthy   0/0      5m
weather-agent-x9y8z7    healthy   1/1      2m

List Tools¶

# List all tools across all agents
meshctl list --tools
meshctl list -t

# Show details for a specific tool (schema, call spec)
meshctl list --tools=greeting

# Show tool from specific agent
meshctl list --tools=greeter:greeting

Example output:

TOOL                 AGENT                   CAPABILITY
greeting             greeter-5395c5e4        greeting
agent_info           greeter-5395c5e4        agent_info
get_weather          weather-agent-x9y8z7    weather_service

Agent Status¶

# Show wiring details for all agents
meshctl status

# Show details for specific agent
meshctl status greeter-5395c5e4

Shows:

Agent metadata (name, version, capabilities)
Resolved dependencies (which agents provide them)
HTTP endpoint
Health status

JSON Output¶

For scripting and automation:

meshctl list --json
meshctl status --json
meshctl list --tools --json

Remote Registry¶

Inspect agents on a remote registry:

meshctl list --registry-url http://remote:8000
meshctl status --registry-url http://remote:8000

Quick Reference¶

Command	Description
`meshctl list`	List healthy agents
`meshctl list --all`	List all agents
`meshctl list -t`	List all tools
`meshctl list -t=<tool>`	Show tool details
`meshctl status`	Show agent wiring
`meshctl status <agent>`	Show specific agent

Next Steps¶

Continue to Call & Debug Tools ->