molecule-ai/molecule-ai-plugin-molecule-session-context

Go to file

Molecule AI · sdk-lead 6c094a6be2 All checks were successful CI / validate (push) Successful in 1m11s Details Merge pull request 'ci: rename .github/workflows -> .gitea/workflows (post-suspension sweep)' (#5 ) from ci-rename-github-to-gitea into main		2026-05-10 21:18:36 +00:00
.gitea/workflows	ci: rename .github/workflows -> .gitea/workflows (post-suspension sweep)	2026-05-10 14:13:45 -07:00
.molecule-ci/scripts	import from local vendored copy (2026-05-06)	2026-05-06 13:53:31 -07:00
adapters	import from local vendored copy (2026-05-06)	2026-05-06 13:53:31 -07:00
hooks	fix(hooks): correct get_repo_root() layout detection via relpath	2026-05-10 15:20:54 +00:00
runbooks	docs(install): migrate git clone URL to git.moleculesai.app (#37 )\n\nAnonymous git-clone refs in CLAUDE.md, runbooks/local-dev-setup.md migrated github.com/Molecule-AI \u2192 git.moleculesai.app/molecule-ai. Public repo, no auth-shape change. Same pattern as the other plugin-* sweeps in the #37 series.\n\nRefs: molecule-ai/internal#37 , molecule-ai/internal#38 , molecule-ai/internal#42	2026-05-07 00:01:13 -07:00
tests	fix(hooks): correct get_repo_root() layout detection via relpath	2026-05-10 15:20:54 +00:00
.gitattributes	import from local vendored copy (2026-05-06)	2026-05-06 13:53:31 -07:00
.gitignore	fix(hooks): use get_repo_root() to fix __file__ overshoot bug	2026-05-10 15:07:43 +00:00
CLAUDE.md	docs(install): migrate git clone URL to git.moleculesai.app (#37 )\n\nAnonymous git-clone refs in CLAUDE.md, runbooks/local-dev-setup.md migrated github.com/Molecule-AI \u2192 git.moleculesai.app/molecule-ai. Public repo, no auth-shape change. Same pattern as the other plugin-* sweeps in the #37 series.\n\nRefs: molecule-ai/internal#37 , molecule-ai/internal#38 , molecule-ai/internal#42	2026-05-07 00:01:13 -07:00
known-issues.md	import from local vendored copy (2026-05-06)	2026-05-06 13:53:31 -07:00
plugin.yaml	import from local vendored copy (2026-05-06)	2026-05-06 13:53:31 -07:00
pytest.ini	Add test coverage for session-start-context hook (#3 )	2026-05-10 11:38:58 +00:00
README.md	docs: write substantive README.md	2026-05-10 08:33:00 +00:00
settings-fragment.json	import from local vendored copy (2026-05-06)	2026-05-06 13:53:31 -07:00

README.md

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

Recent learnings — reads the last 10 entries from ~/.molecule/cron-learnings.jsonl (written by molecule-skill-cron-learnings)
Repo activity — runs git log --oneline -10 to surface recent commits
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