---
title: "coding.sh tree · coding.sh docs"
description: "Show a whole multi-agent run as one tree, with rolled-up totals. Every option of coding.sh tree, from its own --help."
canonical: https://coding.sh/docs/cli/tree
human_url: https://coding.sh/docs/cli/tree
markdown_url: https://coding.sh/docs/cli/tree.md
agents_url: https://coding.sh/agents.md
llms_url: https://coding.sh/llms.txt
updated: 2026-11-11
---

# coding.sh tree

Show a whole multi-agent run as one tree, with rolled-up totals. Every option of coding.sh tree, from its own --help.

coding.sh tree --help

```
coding.sh tree <SESSION|RUN> [options]

  Show a whole multi-agent run as one tree, with rolled-up totals

Arguments
  session|run   A session id or prefix (its whole tree, from the top-level agent down), or a run id (every agent of the fan-out)

Options
      --run              Read the argument as a run id (CODING_SH_RUN_ID), not a session
  -n, --limit <N>        With --json: most nodes in one page (default: 50)
      --cursor <CURSOR>  With --json: the nextCursor of the last page
      --fresh            Wait for every pending capture to be ingested (default: answer after 1.5 s)

Examples
  coding.sh tree latest
  coding.sh tree 9f1c2e
  coding.sh tree my-fanout-123 --run

Notes
  From any session, the tree is its top-level agent and every subagent under it, with per-node model, cost, tokens, duration and tool calls, and the run's totals and worst flag.
  With --json the tree comes a page at a time: 50 nodes, depth-first, with nextCursor and truncated: true when more are left. totals and worst cover the whole tree on every page. A node whose parent was on an earlier page is at the top level of its page; depth and parentSessionId say where it hangs. Nodes are session digests, as in sessions --json.
  Separate agent processes group into one run when they share a run id: set CODING_SH_RUN_ID on the orchestrator that launches your fan-out, then pass that id.
```

[All commands](https://coding.sh/docs/cli) · [Global options](https://coding.sh/docs/cli#global)

To set coding.sh up for a user, follow the agent workflow at [/agents.md](https://coding.sh/agents.md).