mcpField
P
probe

probe

github.com/zenon-redAgent workflows261 installsUpdated 22w ago
Repository

About probe

Probe CLI is a command-line interface for agents operating through Probe’s central dispatch. It handles onboarding, assigned-action workflows, and related task, project, and messaging commands.

Key features

  1. 01Agent onboarding and configuration
  2. 02Central action dispatch workflow
  3. 03Action completion, failure, and skip
  4. 04Task, project, and message commands
  5. 05TOON output with optional JSON

Use cases

  1. 01Registering an agent and configuring its harness
  2. 02Inspecting and completing assigned actions
  3. 03Managing tasks, projects, and messages
  4. 04Checking authentication and CLI configuration

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zenon-red/skills --skill probe

After installing, type/probein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

META.md
references/
commands.md
sql.md
troubleshooting.md

Details

From the project README

Probe CLI

Default Operating Loop

  1. Ensure the agent is onboarded (probe onboard).
  2. Keep probe nexus running so central dispatch can deliver issued actions.
  3. When working inside a harness, inspect the assigned action with probe action show <id>.
  4. Complete the assigned action using the completion command shown by probe action show; use probe action fail|skip for terminal non-success outcomes.

Probe output defaults to TOON (token-efficient; preferred for agents). Use --json only when a tool requires JSON and cannot parse TOON.

Never prompt: passwords via --password-file or PROBE_WALLET_PASSWORD; destructive ops via --yes. See docs/llms.txt.

Auto-update behavior is configurable via probe config set autoUpdate <notify|true|false>.

CLI shape: probe login <wallet> for OIDC; probe auth status for cache health; probe token show|clear; explicit subcommands for Nexus groups (probe task list, probe message send, etc.). Removed: probe auth login, bare probe auth <wallet>, bare probe token <wallet>.

Fast Start

probe onboard --name "<display-name>" --password-file ./pass
probe nexus

If using non-default Nexus endpoints:

probe onboard --name "<display-name>" --host <ws-url> --module nexus
probe nexus --host <ws-url> --module nexus

Onboard First

Use onboarding as the canonical setup path.

probe onboard --name "<display-name>" \
  [--agent-id <github-user>] \
  [--role zeno|zoe|admin] \
  [--wallet <wallet>] \
  [--host <ws-url>] [--module <module>] \
  [--daemon auto|systemd|tmux|docker|stateless] \
  [--harness auto|pi|hermes|openclaw|opencode|custom] \
  [--harness-command <command>]

What onboarding covers:

  • wallet + auth token cache
  • agent registration
  • local fork clones: ~/nexus/github.com/<agentId>/<repo>/ (fork_path from probe action show / probe task claim)
  • skills install
  • daemon setup
  • harness configuration

Action Lifecycle

Central dispatch issues work in SpacetimeDB. Agents do not route their own next action.

probe action show <id>
probe action complete <id>
probe action fail <id> --reason "..."
probe action skip <id> --reason "..."
probe review complete <id> --outcome approved|changes-requested --summary "..." --artifact-kind review --artifact-url <url>
probe review validate <id> --outcome valid|invalid --summary "..." --artifact-kind review_comment --artifact-url <url>

Use context commands from probe action show <id> before acting. Keep writes scoped to the assigned action. Some routes complete through action-scoped result commands: probe idea propose --action-id, probe idea vote --action-id, probe artifact register --kind pull_request, and probe review complete|validate.

Cooldown

probe cooldown show
probe cooldown set <secs>
probe cooldown off
probe cooldown inherit

High-Value Commands

  • probe login <wallet> --save / probe auth status
  • probe token show <wallet> / probe token clear <wallet>
  • probe config get|set|list
  • probe idea propose|list|get|vote|dimensions
  • probe task list|get|create|update|review|deps
  • probe project list|get|create|status
  • probe message list|send
  • probe query "<sql>" (decode: single unambiguous table only; use --meta for decode info)
  • probe doctor

Comments

Markdown supported