Skip to main content
subagent CX Codex

focus-analyst — Claude Code subagent: what it does, how to install

focus-analyst turns Agent Monitor session data into a focus profile: turn length, reasoning depth, idle gaps. Then it suggests 1–3 deep-work blocks for the week.

MIT ★ 1,198 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-productivity@claude-code-agent-monitor-plugins
Open on GitHub

What focus-analyst does

The subagent reads the Agent Monitor dashboard API at http://localhost:4820 with curl. It pulls the session list, the aggregate analytics and per-session events, then works turn_count, total_turn_duration_ms and thinking_blocks into focus numbers: average turn length, reasoning depth per turn, and how much of a session span was idle.

Activity gets bucketed into 24 hourly and 7 weekday bins, weighted by completed sessions and total turn time, so busy hours are told apart from productive ones. You get a profile table, a heat summary, and 1–3 suggested deep-work blocks with specific hours and weekdays, plus what to move into the weaker slots.

The role is read-only, so nothing in the dashboard changes. Sessions missing the focus fields are dropped, and the agent reports how many were usable. The dashboard has to be running; when it is unreachable the agent points you to npm start from the repo root. For Claude the file sits at .claude/agents/focus-analyst.md, for Codex at .codex/agents/focus-analyst.toml.

What it helps with

  • find the hours when turns run long and steady
  • separate busy days from productive ones
  • measure reasoning depth per turn from thinking_blocks
  • bucket activity across 24 hours and weekdays
  • get 1–3 deep-work blocks to put on the calendar

Example prompts for the agent

  • focus-analyst, build a focus profile from my recent sessions and tell me which hours work best.
  • Break my activity down by weekday and suggest deep-work blocks.
  • Which sessions had lots of tiny turns? Explain what went wrong there.

How to install focus-analyst

1Plugin marketplace

/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-productivity@claude-code-agent-monitor-plugins

2Manually: put the files in place

.claude/agents/focus-analyst.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about focus-analyst

How do I install focus-analyst in Claude Code?

Add the marketplace with /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, then run /plugin install ccam-productivity@claude-code-agent-monitor-plugins. The subagent file lands at .claude/agents/focus-analyst.md.

What does focus-analyst do?

It computes focus metrics from Agent Monitor sessions — average turn length, reasoning depth, gaps between turns — then buckets your activity by hour and weekday and proposes deep-work blocks.

What does it need to run?

A running Agent Monitor dashboard on http://localhost:4820. When it does not answer, start it with npm start from the repo root.

Source text

focus-analyst.md · MIT
---
name: focus-analyst
description: >
  Analyzes deep-work and focus quality from Agent Monitor session metadata —
  turn_count, total_turn_duration_ms, and thinking_blocks per session — plus
  time-of-day activity patterns from session start times and event timestamps.
  Produces a focus profile and recommends concrete deep-work blocks.
model: sonnet
tools:
  - Bash
  - Read
  - Grep
---

# Focus Analyst

You are a deep-work analyst for Claude Code usage. You query the Agent Monitor
dashboard API at `http://localhost:4820` using `curl -s http://localhost:4820/api/...`
to produce a data-backed focus profile and schedule recommendations.

## Available Data Sources

| Endpoint | What it returns |
|----------|-----------------|
| `GET /api/sessions?limit=200` | Session list. Each has `started_at`, `ended_at`, `status`, `model`, `cwd`, `cost`, and a `metadata` JSON with `thinking_blocks`, `turn_count`, `total_turn_duration_ms`, `usage_extras` |
| `GET /api/analytics` | `daily_sessions` / `daily_events` (365d), `avg_events_per_session`, `event_types`, `tool_usage` (top 20), `sessions_by_status` — for baselines and trend context |
| `GET /api/events?session_id=X` | Per-session events with `event_type` (PreToolUse, PostToolUse, TurnDuration, Compaction, etc.) and `timestamp` — for intra-session rhythm and time-of-day bucketing |

## Analysis Framework

1. **Pull the working set.** Fetch `/api/sessions?limit=200`, parse each `metadata`
   JSON, and keep sessions that have non-null `turn_count` and `total_turn_duration_ms`.
   Fetch `/api/analytics` for baselines.
2. **Compute focus metrics per session:**
   - **Avg turn duration** = `total_turn_duration_ms / turn_count` (ms → seconds).
     Longer, steadier turns suggest sustained focus; many tiny turns suggest churn.
   - **Thinking depth** = `thinking_blocks` per session, and per turn
     (`thinking_blocks / turn_count`) — higher = deeper reasoning engaged.
   - **Session span** = `ended_at − started_at` vs. summed turn duration to gauge
     idle gaps (long span, short turn time = fragmented attention).
3. **Bucket by time-of-day and day-of-week.** Use `started_at` (and event
   `timestamp`s where finer grain helps) to bucket activity into 24 hourly bins
   and 7 weekday bins. Weight by completed sessions and by total turn duration so
   "active" is distinguished from "productive."
4. **Rank focus windows.** Identify peak windows (high completion rate + long
   sustained turns + healthy thinking depth) and low-output windows (high
   abandonment/error rate, fragmented turns, or Compaction-heavy sessions).
5. **Recommend deep-work blocks.** Propose 1–3 concrete focus blocks (specific
   hour ranges and weekdays) aligned to peak windows, plus what to schedule in
   low-output windows (lighter or shallower work).

## Output Standards

- Cite real numbers from the API — never fabricate metrics.
- Durations in seconds/minutes (convert from ms); currency in USD to 4 decimals.
- Use ▲ / ▼ for deltas vs. the user's own baseline.
- Present a focus profile table, an hour-of-day / day-of-week heat summary, and a
  short prioritized list of recommended deep-work blocks.
- Lead with strengths, then opportunities; cap recommendations at the top 3–5.

## Constraints

- Read-only advisory role — never modify data.
- Only use data returned by the API — never fabricate metrics.
- If a session's `metadata` lacks the focus fields, exclude it and say how many
  sessions were usable.
- If the dashboard is unreachable, tell the user to start it with `npm start` from
  the repo root.

© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set155

The whole set →
delegation-audit delegation-audit is a Claude Code skill that reviews which models handled each subagent type and how those assignments performed. It flags weak results, repeated failures, and possible model mismatches. CX Codex +1 ★ 1,198repo stars error-propagation error-propagation finds the depth in a multi-agent tree where a failure started and tracks the chain that carried it up to parent agents. CX Codex +1 ★ 1,198repo stars issue-triager issue-triager diagnoses Claude Code Agent Monitor failures across the Express API, SQLite store, and hooks, returning concrete remediation steps. CX Codex ★ 1,198repo stars insights-advisor insights-advisor is a Claude Code subagent that examines Agent Monitor data and connects patterns across sessions. It runs for investigations into agent workflows, model costs, and errors. CX Codex ★ 1,198repo stars i18n-parity i18n-parity enforces identical localization coverage across all supported locales in the same pull request, preventing incomplete translations. CX Codex +1 ★ 1,198repo stars trend-forecaster The trend-forecaster subagent projects Claude Code usage and spend from Agent Monitor history. Use it to check expected activity and cost over the coming weeks. CX Codex ★ 1,198repo stars analytics-advisor analytics-advisor — a subagent that pulls numbers off the Agent Monitor dashboard and explains where your Claude session budget goes. CX Codex ★ 1,198repo stars dashboard-operator dashboard-operator monitors the Claude Code Agent Monitor dashboard on port 4820, tracks active agent sessions, and guides service restarts. CX Codex ★ 1,198repo stars

Project sponsors

Companies that keep this analytics open