journal

journal is a Claude Code mod by mako-code that project memory across sessions: every few turns haiku writes what was done, decided and left open to .claude/journal.md, and new conversations start with the latest entries.

Updated 2026-10-04

What is journal?

journal is a Claude Code mod by mako-code that project memory across sessions: every few turns haiku writes what was done, decided and left open to .claude/journal.md, and new conversations start with the latest entries. It is listed under Context & memory and has 2 GitHub stars.

TypeClaude code mod
Authormako-code
Repositorymako-code/gobworks
Popularity2 GitHub stars
CategoryContext & memory
SecurityReview before installing (68/100)
Rank#1,285 of 5,272 Claude Code mods; #134 in Context & memory
LicenseMIT
Last commit2026-10-04
Hooks8 events
SeesEdit|Write|NotebookEdit calls, the system prompt
Draws onPane

Is journal safe to install?

journal scores 68/100 on the MCPMods security check: Review before installing. Things to review: writes files or config; reads environment variables. It passed 4 of 8 checks.

Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.

CheckResult
No network accessPass
Starts no processesPass
Writes files or configReview
Reads environment variablesReview
Only sees the events it hooksPass
Drives Claude (model calls, prompts)Note
Validator reported problemsNote
Has an open-source licensePass

API calls in its code

CallWhat it means
$.clock.now
$.command.register
$.env.getreads env vars
$.fs.existsreads files
$.fs.readreads files
$.fs.statreads files
$.fs.writewrites files
$.model.completedrives Claude
$.session.id
$.session.messagesreads the transcript
$.session.root
$.state.get
$.state.set
$.ui.closedraws interface
$.ui.logdraws interface
$.ui.opendraws interface
$.ui.resolvedraws interface
$.ui.toastdraws interface

How do I install journal?

  1. Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
    claude --version
  2. Read its footprint. This lists every event it hooks and every API call it makes, without running it.
    git clone https://github.com/mako-code/gobworks
    claude plugin validate ./gobworks/mods/memory/journal
  3. Install it. Run this in your terminal, then /reload-plugins in an open session.
    claude plugin marketplace add mako-code/gobworks && claude plugin install journal@gobworks

Or ask Claude to set it up

Paste this into Claude Code and it installs journal for you:

Install the "journal" Claude Code mod from https://github.com/mako-code/gobworks/tree/main/mods/memory/journal. Run claude plugin validate on it first and show me what it can access before you enable it.

More from mako-code/gobworks

This repository has at least 9 Claude Code mods on MCPMods.

  • bench: Measures a command: warmup and timed runs, median/p95/stddev and outliers, two commands compared or a saved baseline per (Review before installing)
  • best-of-n: Runs 2-4 attempts at a task in parallel git worktrees, each with a different approach; compare their diffs and adopt the (Review before installing)
  • bisect: Finds the commit that broke something: git bisect with your test command in a temporary worktree (your working tree is n (High risk)
  • canvas: Gives Claude a screen to draw on: SVG diagrams and Markdown reports in a Canvas pane with history. (Review before installing)
  • council: More than one mind: ask several models at once and get a synthesis, critique the last answer, and let Claude consult ano (High risk)
  • data-peek: Look into CSV, TSV, JSON and JSON Lines files without dumping them into context: schema, stats, rows, filters, group cou (Low risk)
  • gh-inbox: GitHub issues and pull requests in a pane — one press to have Claude work on an issue or review a PR — plus the current (Review before installing)
  • http-lab: An HTTP tool for API work: status, timing, trimmed headers and a body shaped to fit; localhost runs freely, other hosts (High risk)