# Meridian:report

> Use when you need Meridian to session Report.

- Skill: `mattjaikaran/meridian-report` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mattjaikaran/meridian-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mattjaikaran/meridian-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: mattjaikaran (https://skillmd.com/u/mattjaikaran)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mattjaikaran/meridian-report

---


# /meridian:report — Session Report

Generate an end-of-session summary with work done, token estimate, and next action.

## Arguments

- `--since <timestamp>` — Report from this ISO timestamp (default: last 24h).

## Keywords

report, session, summary, token usage, work done, progress

## Procedure

```bash
PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
import json
from scripts.db import open_project
from scripts.session_reports import (
    generate_session_report,
    estimate_token_usage,
    format_session_report,
)
with open_project('.') as conn:
    report = generate_session_report(conn)
    tokens = estimate_token_usage(report['events'])
    print(format_session_report(report, tokens))
"
```

## Output

Formatted markdown with summary stats, event timeline, token usage estimate, and suggested next action.