molecule-session-context — Session Start Context Loader

molecule-session-context is a session-initialisation hook plugin that auto-loads recent cron-learnings and repo PR/issue counts at SessionStart. Pairs with molecule-cron-learnings.

Version: 1.0.0 Runtime: claude_code

Repository Layout

molecule-session-context/
├── plugin.yaml              — Plugin manifest
├── hooks/
│   └── session-start-context/
│       └── hook.json        — SessionStart hook definition
└── adapters/               — Harness adaptors

What It Does

At the start of every session, this hook:

Reads the last N lines of ~/.claude/projects/<project>/cron-learnings.jsonl
Loads current PR/issue counts for the workspace repo
Surfaces this context to the agent in the first response

This means the agent enters every session already knowing:

What went wrong last time (from cron-learnings)
How many open PRs and issues exist (context before acting)

SessionStart Hook

The hook fires on every new session for a workspace. Configure how many learnings to load via workspace settings:

{
  "session_context": {
    "learnings_lines": 20,
    "include_pr_counts": true,
    "include_issue_counts": true
  }
}

Development

Prerequisites

Python 3.11+
gh CLI authenticated
Write access to Molecule-AI/molecule-ai-plugin-molecule-session-context

Setup

git clone https://git.moleculesai.app/molecule-ai/molecule-ai-plugin-molecule-session-context.git
cd molecule-ai-plugin-molecule-session-context

# YAML validation
python3 -c "import yaml; yaml.safe_load(open('plugin.yaml'))"

Pre-Commit Checklist

# YAML structure
python3 -c "import yaml; yaml.safe_load(open('plugin.yaml'))"

# Credential scan
python3 -c "
import re, sys
with open('plugin.yaml') as f:
    content = f.read()
patterns = [r'sk.ant', r'ghp.', r'AKIA[A-Z0-9]']
if any(re.search(p, content) for p in patterns):
    print('FAIL: possible credentials found')
    sys.exit(1)
print('No credentials: OK')
"

Release Process

Review changes: git log origin/main..HEAD --oneline
Bump version in plugin.yaml (semver)
Commit: chore: bump version to X.Y.Z
Tag and push: git tag vX.Y.Z && git push origin main --tags
Create GitHub Release with changelog

Known Issues

See known-issues.md at the repo root.

2.4 KiB Raw Permalink Blame History