goose-session-report - GitLite

KO | EN

gitlite — search

#terminal #gemini #machine-learning #redis #graphql #codex #sql #editor #golang #animation

goose-session-report

(★ 18)

Turn Goose session logs into a clean, readable summary report.

파일 탐색기

ZIP 다운로드

- sample-session.jsonl
- - __init__.py
  - cli.py
  - parse.py
  - report.py
- test_report.py
LICENSE
pyproject.toml
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`pip install`

설명 보기 ▼

Install Python packages.

pip install {{package1 package2 ...}}

Install one or more packages:

pip install {{package1 package2 ...}} {{[-U|--upgrade]}}

Upgrade all specified packages to the latest version, installing any that are not already present:

pip install {{package}}=={{version}}

Install a specific version of a package:

🔍

`pytest`

설명 보기 ▼

Python 테스트 실행.
더 많은 정보: <https://docs.pytest.org/en/latest/how-to/usage.html>.

pytest {{path/to/test_file1.py path/to/test_file2.py ...}}

특정 파일에서 테스트 실행:

pytest -k {{expression}}

특정 [k]eyword 표현식과 일치하는 테스트 실행:

pytest {{[-x|--exitfirst]}}

테스트가 실패하거나 오류가 발생하면 즉시 종료:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Turn Goose session logs into a clean, readable summary report.**

[Goose](https://github.com/block/goose) records each session as a line-delimited
JSON log. Those files are great for the machine but hard for a human to skim.
`goose-session-report` reads a session and produces a tidy **Markdown** or **HTML**
summary: how many messages, who sent them, which tools were used, how often, and
how many tool calls failed.

Handy for reviewing what an agent actually did, sharing a run with a teammate, or
attaching evidence to a report.

Part of the AAIF (Agentic AI Innovation Foundation) open-source toolset for the
agentic AI ecosystem.

## Highlights

- Summarizes messages by role and tool usage with failure counts.
- Tolerant parser: skips unreadable lines and copes with field-name differences
  across Goose versions instead of crashing.
- Markdown or self-contained HTML output.
- Standard library only. No pip dependencies.

## Install

```bash
pip install -e .
```

Requires Python 3.9 or newer.

## Usage

```bash
goose-session-report examples/sample-session.jsonl
```

Write an HTML report:

```bash
goose-session-report examples/sample-session.jsonl --format html -o report.html
```

Goose session files usually live under your Goose data directory (for example
`~/.local/share/goose/sessions/` on Linux). Point the tool at any `.jsonl`
session file.

## Example output

```markdown
# Goose session report

**Messages:** 8
**Tool calls:** 3

## Messages by role

| Role | Count |
|------|-------|
| assistant | 3 |
| tool | 3 |
| user | 2 |

## Tools used

| Tool | Calls | Failures |
|------|-------|----------|
| `shell` | 2 | 1 |
| `text_editor` | 1 | 0 |
```

## Notes on formats

Goose has evolved its log schema over time. This tool normalizes several known
shapes for message content and tool calls (`toolRequest`/`tool_request`/`toolCall`
and their response counterparts). If your session uses a field this parser does
not recognize, it will skip that detail rather than fail. Contributions to widen
coverage are welcome.

## Development

```bash
pip install -e .
pytest
```

## License

MIT. See [LICENSE](LICENSE).