Skip to content

[FEAT] Expose subagent status reporting via tool/API #1539

@SHINE-six

Description

@SHINE-six

Feature Request

The picoclaw project supports spawning subagents for async/background tasks, but currently has no agent/user-accessible way to query their status.

Proposal

Add a new tool (e.g., spawn_status or similar) and/or a web/API endpoint that returns a status report of all currently spawned subagents:

  • How many subagents have been spawned
  • Their status (running, completed, failed, canceled)
  • Optionally: Task label, creation time, result summary

This would leverage the existing SubagentManager methods (ListTasks, GetTask) and expose them via a tool or endpoint for agents and users to query.

Motivation

This capability is important for monitoring running/queued background tasks, debugging stuck jobs, and generally improving observability of autonomous agent activity.

I have already forked the repo and will open a PR for this feature.


Related:

  • Current internal tracking in pkg/tools/subagent.go
  • No status reporting tool or endpoint yet

/cc @SHINE-six

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions