change-journal

Category: Tools & Productivity | Uploader: agentika-labs | Downloads: 0 | Version: v1.0（Latest）

Query the change journal for cross-session and cross-workspace change history. Use when you need to understand what other agents changed, what happened in prior sessions, or to investigate changes to specific files. Invoke when the user says "what changed", "show changes", "change history", "what did agent X do", "what was modified", "change journal", "change log", "recent changes", or "who changed [file]".

Changelog: Source: GitHub https://github.com/agentika-labs/agentika-plugin-marketplace

Directory Structure

Current level: plugins/change-journal/skills/change-journal/

📁 scripts/
- 📄 common.sh 3.6 KB
- 📄 journal-cleanup.sh 4.3 KB
- 📄 on-file-change.sh 2.7 KB
- 📄 on-session-start.sh 1.3 KB
- 📄 on-stop.sh 2.6 KB
- 📄 on-subagent-start.sh 1.2 KB
- 📄 on-subagent-stop.sh 937 B
📄 SKILL.md 2.7 KB

SKILL.md

---
name: change-journal
description: |
  Query the change journal for cross-session and cross-workspace change history.
  Use when you need to understand what other agents changed, what happened in prior
  sessions, or to investigate changes to specific files.
  Invoke when the user says "what changed", "show changes", "change history",
  "what did agent X do", "what was modified", "change journal", "change log",
  "recent changes", or "who changed [file]".
version: 0.2.0
compatibility: "Requires bash and jq. macOS or Linux."
allowed-tools:
  - Bash
  - Read
  - Grep
---

# Change Journal

Query the project's change journal for cross-session and cross-workspace awareness.

## Journal Location

Journal data lives in `~/.claude/projects/<slug>/journal/` (outside the project tree):
- **`JOURNAL.md`** — Human-readable rolling summary (quick overview)
- **`entries.jsonl`** — Structured entries (one JSON per line, for filtering)
- **`summary.txt`** — Compact summary (auto-injected into subagents)

The `$CHANGE_JOURNAL_DIR` environment variable points to this directory (exported by the SessionStart hook).

## Quick Start

Read the journal summary for a quick overview:

```bash
cat "$CHANGE_JOURNAL_DIR/JOURNAL.md"
```

## Query Patterns

### Filter by workspace
```bash
jq 'select(.workspace == "agent-1")' "$CHANGE_JOURNAL_DIR/entries.jsonl"
```

### Filter by file path
```bash
jq 'select(.file_path | contains("auth"))' "$CHANGE_JOURNAL_DIR/entries.jsonl"
```

### Filter by time range
```bash
jq 'select(.timestamp >= "2026-02-12")' "$CHANGE_JOURNAL_DIR/entries.jsonl"
```

### Most frequently changed files
```bash
grep file_change "$CHANGE_JOURNAL_DIR/entries.jsonl" | jq -r .file_path | sort | uniq -c | sort -rn
```

### Full diff for a specific session
```bash
jq -r 'select(.session_id == "SESSION_ID" and .type == "session_summary") | .diff_preview' "$CHANGE_JOURNAL_DIR/entries.jsonl"
```

### What are other agents/workspaces working on?
```bash
jq 'select(.type == "session_summary")' "$CHANGE_JOURNAL_DIR/entries.jsonl" | jq -r '"\(.workspace): \(.intent)"'
```

### Changes from a specific workspace
```bash
jq 'select(.workspace == "WORKSPACE" and .type == "file_change")' "$CHANGE_JOURNAL_DIR/entries.jsonl"
```

## Entry Types

### file_change
Recorded per Edit/Write operation. Fields: `timestamp`, `session_id`, `workspace`, `vcs`, `file_path`, `action` (edit/write), `change_preview`, `lines_added`, `lines_removed`.

### session_summary
One per session (on stop). Fields: `timestamp`, `session_id`, `workspace`, `vcs`, `intent` (extracted from user's first message), `file_count`, `files_changed`, `diff_stat`, `diff_preview`.

### subagent_work
Tracks subagent completions. Fields: `timestamp`, `session_id`, `agent_id`, `agent_type`, `workspace`.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

change-journal

Directory Structure

SKILL.md

Report

Notice