2026-05-10 08:33:00 +00:00

molecule-session-context

Auto-loads recent learnings and workspace activity at session start. Pairs with molecule-skill-cron-learnings — together they give the agent a running summary of past decisions and current state before beginning work.

What it loads

  1. Recent learnings — reads the last 10 entries from ~/.molecule/cron-learnings.jsonl (written by molecule-skill-cron-learnings)
  2. Repo activity — runs git log --oneline -10 to surface recent commits
  3. Issue counts — runs gh issue list --state open to show open items

All output is emitted as additionalContext on SessionStart.

Install

In org template (org.yaml)

plugins:
  - molecule-session-context

Recommended: Also install molecule-skill-cron-learnings to populate the learnings file.

From URL (community install)

github://Molecule-AI/molecule-ai-plugin-molecule-session-context

Usage

No configuration needed. Install to activate — the hook fires on every session start.

Hooks

  • SessionStart — reads learnings + git log + issue counts, emits as context

Architecture

hooks/
  session-start-context.py   # Reads learnings, git, gh; emits additionalContext
  session-start-context.sh   # Shell wrapper
  _lib.py                     # Shared helpers
adapters/
  claude_code.py              # Registers hook
settings-fragment.json        # Declares SessionStart hook binding

Runtime

  • claude_code — primary

Known issues

See known-issues.md.

License

Business Source License 1.1 — © Molecule AI.

S
Description
No description provided
Readme 103 KiB
Languages
Python 99.8%
Shell 0.2%