📔 Gournal

A Developer's Command-Line Journal with Git Integration

Gournal is a CLI tool that helps developers:

• Log daily work in context of Git projects
• Generate standup reports automatically

✨ Features

• Git-Aware Logging: Auto-tag entries with project names
• Standup Reports: gournal standup generates daily, weekly, or monthly summaries
• Work Log: gournal log shows a chronological, by-day view (daily/weekly/monthly), unlike standup's per-project grouping
• Stats: gournal stats shows entry counts by project/tag and your current daily streak
• Undo: gournal undo removes the most recently added entry
• Lookup: gournal tags / gournal projects list distinct values with counts
• Project Filtering: Scope standup/export/find output to a single project with --project
• Export: gournal export writes entries to Markdown or CSV
• MCP Server: gournal mcp exposes your journal to AI agents like Claude Code

🚀 Quick Start

Prerequisites

• Node.js v18+
• Git (for project detection)

Installation

npm install -g gournal
# or
yarn global add gournal

Usage

# Log an entry
gournal add "Fixed the flaky auth test" --tags bug,testing

# Daily / weekly / monthly standup
gournal standup
gournal standup --week
gournal standup --month

# Scope any report to one project
gournal standup --week --project gournal

# Chronological work log
gournal log --week
gournal log --month --tags bug,testing

# Undo the last entry
gournal undo

# Stats and lookups
gournal stats
gournal tags
gournal projects

# Find entries in a date range
gournal find "auth" --from 2026-07-01 --to 2026-07-15

# Export entries
gournal export --format md
gournal export --format csv --project gournal --output entries.csv

🤖 MCP Server

gournal mcp starts an MCP server (stdio transport) that exposes your journal to AI agents like Claude Code. It reuses the same storage/report/export logic as the CLI, so agents see exactly what you'd see.

Tools exposed:

• list_entries — list entries newest-first, filterable by project, from, to, capped by limit (default 50, max 500)
• get_standup — generate a standup report (yesterday / week / month, filterable by project)
• export_entries — export entries to md or csv
• get_work_log — generate a chronological work log grouped by day (yesterday / week / month, filterable by project/tags)
• list_tags — distinct tags with counts, filterable by project
• list_projects — distinct projects with counts

Using with Claude Code

Register it as an MCP server, e.g. with the Claude Code CLI:

claude mcp add gournal -- gournal mcp

Or add it directly to your MCP client config (e.g. .mcp.json):

{
  "mcpServers": {
    "gournal": {
      "command": "gournal",
      "args": ["mcp"]
    }
  }
}

Once registered, you can ask your agent things like "summarize what I worked on this week" or "export my gournal entries for the api project to markdown."