prompt-diary 0.1.0a2

Review user prompts for evidence-backed improvement in AI coding collaboration.

Prompt Diary

Prompt Diary prepares bounded workspaces from local assistant session history and generates evidenced prompt diary reports that help users review and improve how they collaborate with AI coding agents.

The tool targets Python 3.10 and newer. The package exposes report and prompt-diary console commands after installation.

Usage

Install Prompt Diary from PyPI as an isolated uv tool:

uv tool install prompt-diary

Then run:

report --help
prompt-diary --help
report prepare --date 2026-05-12 --timezone Asia/Shanghai

Generation runs an external report-writing model command inside the prepared workspace. The command must read the generated prompt from standard input and create report.md in its current working directory. Configure it before running generate; for example, with Codex CLI:

export PROMPT_DIARY_REPORT_WRITER_COMMAND="codex exec -"
report generate --date 2026-05-12 --timezone Asia/Shanghai

Set PROMPT_DIARY_REPORT_WRITER_TIMEOUT_SECONDS to override the default 600-second writer timeout.

Development

This project uses uv for Python version, environment, dependency, build, and release workflows.

Read docs/src/product.md before designing new features, changing report content, or modifying the generation pipeline. It defines the tool's purposes and principles that downstream design must satisfy.

For environment setup, build commands, type checking, testing, coverage, linting, and pre-submit checks, see the Development Guide. For codebase architecture and API design, see Architecture.