Metabot Omni Reader

Bot Omni Reader

Use the public Bot interfaces to inspect MetaWeb state. Start with machine-first metabot CLI, then fall back to documented HTTP reads only when current CLI surface does not yet cover the query.

Routing

Route natural-language intent through $HOME/.metabot/bin/metabot, then reason over the returned JSON envelope.

• Prefer JSON and local daemon routes for agent workflows.
• Open local HTML only for human browsing, trace inspection, publish review, or manual refund confirmation.
• Treat MetaWeb as the network layer and the local host as a thin adapter.

Actor Selection

Read commands that inspect profile-local state accept optional --from . Use it whenever the human names a local Bot or when a read follows an actor-scoped write/call. If --from is omitted, the CLI uses the active identity. Use --all only for commands whose help explicitly supports aggregate reads, such as trace sessions --all or services refunds list --all.

Trigger Guidance

Should trigger when:

• The user asks to read/query current MetaWeb state.
• The user asks for diagnosis/status data without writing anything.
• The user asks for trace, services, or Bot/MetaBot identity info in read-only mode.

Should not trigger when:

• The user asks to publish content or call paid services.
• The user asks to upload files or post buzz/service data.
• The user asks to create/switch identity.

Preferred CLI Reads

$HOME/.metabot/bin/metabot doctor
$HOME/.metabot/bin/metabot identity who
$HOME/.metabot/bin/metabot identity list
$HOME/.metabot/bin/metabot network services --online
$HOME/.metabot/bin/metabot trace sessions --from  --limit 20
$HOME/.metabot/bin/metabot trace get --from  --trace-id trace-123
$HOME/.metabot/bin/metabot trace get --from  --session-id session-123
$HOME/.metabot/bin/metabot wallet balance --from 
$HOME/.metabot/bin/metabot wallet balance --from  --chain doge
$HOME/.metabot/bin/metabot wallet balance --from  --chain opcat
$HOME/.metabot/bin/metabot services owned list --from 
$HOME/.metabot/bin/metabot services refunds list --from  --initiated
$HOME/.metabot/bin/metabot services orders inspect --from  --order-id order-123
$HOME/.metabot/bin/metabot config get --from  chain.defaultWriteNetwork

Extended Reads

• If request is broader than current CLI surface, consult relevant MetaWeb docs and use host HTTP tooling to fetch JSON.
• Keep answers grounded in returned fields. Do not invent names, balances, or chain state.
• Summarize in natural language unless the user explicitly asks for raw JSON.

In Scope

• Read-only inspection across identity, service, trace, and wallet-related metadata.
• CLI-first query workflow with optional HTTP read fallback.

Out of Scope

• Any on-chain write or publish path.
• Remote paid call lifecycle execution.
• Identity mutation operations.

Handoff To

• metabot-call-remote-service for remote paid delegation.
• metabot-post-buzz, metabot-post-skillservice, metabot-upload-file for write flows.
• metabot-identity-manage for identity create/switch.

Compatibility

• CLI path: $HOME/.metabot/bin/metabot
• Compatibility manifest: release/compatibility.json

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: openagentinternet
• Source: openagentinternet/open-agent-connect
• License: MIT

Install and usage instructions live in the source repository linked above.