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

Go to file

Molecule AI Plugin-Dev e9e6c8c501 Some checks failed CI / validate (push) Failing after 2s Details CI / validate (pull_request) Failing after 1s Details docs(tests): add rationale README for session-context tests Commit `f874929` added comprehensive test coverage (test_lib.py + test_session_start_context.py) but omitted tests/README.md. This fills that gap. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>		2026-05-10 15:09:52 +00:00
.github/workflows	fix(ci): lowercase 'molecule-ai/' in cross-repo workflow refs	2026-05-07 00:59:23 -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): use get_repo_root() to fix __file__ overshoot bug	2026-05-10 15:07:43 +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	docs(tests): add rationale README for session-context tests	2026-05-10 15:09:52 +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