Skip to content

feat: add MonkeyProof remote-session service #44

Description

@rodaddy

Goal

Add a first-class monkeyproof service to mcp2cli so agents can control remote MonkeyProof sessions without hand-rolled curl/WebSocket code.

Context

MonkeyProof is the remote coding-agent session manager for the Herdr/A2A orchestration plan. It exposes REST + WebSocket endpoints, but Codex agents should use a stable mcp2cli service surface for routine operations.

Proposed Tools

  • health
  • create_session
  • list_sessions
  • get_session
  • send_input
  • kill_session
  • read_transcript
  • stream_session if mcp2cli can support the streaming UX cleanly; otherwise document the fallback.

Requirements

  • Service config supports base URL and token via existing mcp2cli secret/config patterns.
  • Do not hardcode production tokens.
  • Return structured JSON with session id, status, cwd, command/preset, recent output, and exit metadata where available.
  • Fail closed on missing credentials or non-2xx responses.
  • Include examples for Codex and Claude presets.
  • Include at least one read-only smoke test against a dev or documented local MonkeyProof instance.

Acceptance Criteria

  • mcp2cli monkeyproof --help lists the tools.
  • mcp2cli schema monkeyproof.create_session documents parameters.
  • Agent can create, inspect, send input to, and kill a session using only mcp2cli.
  • Errors are actionable and do not expose secrets.
  • Tests or smoke evidence are included in the PR.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions