Skip to content

Add agent activity timeline view #54577

Open
Open
Add agent activity timeline view#54577
Labels
P2Normal backlog priority with limited blast radius.clawsweeper:needs-maintainer-reviewClawSweeper marked this issue as needing maintainer review before automation.clawsweeper:needs-product-decisionClawSweeper marked this issue as needing a product or behavior decision.clawsweeper:needs-security-reviewClawSweeper marked this issue as needing security-sensitive review.clawsweeper:no-new-fix-prClawSweeper does not recommend queueing a new automated fix PR for this issue.impact:securitySecurity boundary, credential, authz, sandbox, or sensitive-data risk.impact:session-stateSession, memory, transcript, context, or agent state can drift or corrupt.issue-rating: 🌊 off-meta tidepoolIssue quality rating does not apply to this item.
@AmolDerickSoans

Description

@AmolDerickSoans
AmolDerickSoans
opened on Mar 25, 2026

Description

Building on the tree view command, add an interactive timeline view that shows agent activity over time. This would help visualize:

  • When agents were spawned/completed
  • Task durations
  • Idle periods
  • Error events

Proposed Command

openclaw timeline [options]

Options

  • --since <duration> - Show events from last N hours/minutes
  • --agent <id> - Filter to specific agent
  • --type <type> - Filter by event type (spawn, complete, error)

Example Output

Agent Activity Timeline (last 1h)

22:00 ──────────────────────────────────────────────── now
  │
  ├─● main spawned
  │
  ├─● subagent-1 spawned (task: code review)
  │   └── ✓ completed (3m 42s)
  │
  ├─● subagent-2 spawned (task: run tests)
  │   └── ● running...
  │
  └─✗ subagent-3 error: timeout

Summary: 4 agents | 2 completed | 1 running | 1 error

Integration Points

  • /timeline slash command in chat
  • TUI panel for real-time monitoring
  • Export to JSON for CI/CD dashboards

Related

  • Builds on # for session hierarchy

Implementation Notes

  • Store agent lifecycle events in session metadata
  • Consider using a ring buffer for recent events
  • Could integrate with OpenTelemetry for observability

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Normal backlog priority with limited blast radius.clawsweeper:needs-maintainer-reviewClawSweeper marked this issue as needing maintainer review before automation.clawsweeper:needs-product-decisionClawSweeper marked this issue as needing a product or behavior decision.clawsweeper:needs-security-reviewClawSweeper marked this issue as needing security-sensitive review.clawsweeper:no-new-fix-prClawSweeper does not recommend queueing a new automated fix PR for this issue.impact:securitySecurity boundary, credential, authz, sandbox, or sensitive-data risk.impact:session-stateSession, memory, transcript, context, or agent state can drift or corrupt.issue-rating: 🌊 off-meta tidepoolIssue quality rating does not apply to this item.

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions