{"slug": "hermeneutic-turns-your-ai-corrections-into-context-for-the-next-task", "title": "Hermeneutic turns your AI corrections into context for the next task", "summary": "Hermes Labs has released Hermeneutic, an open-source tool that mines user corrections from coding-agent conversations and surfaces relevant guidance when similar tasks arise. Hermeneutic reads Claude Code, Codex, and OpenAI-format logs, records the exchange around each correction into a local corpus, and uses Ollama embeddings to match new prompts against earlier ones, emitting a compact guidance preamble with citations to supporting correction records. It requires Python 3.10+ and Ollama, and offers an optional Claude Code hook to inject retrieved guidance as prompt context.", "body_md": "You ask a coding agent to review a function. It starts refactoring. You steer it back to the review you requested.\n\nThat exchange contains useful information about your intended scope.\n\n**[Hermeneutic](https://github.com/hermes-labs-ai/hermeneutic), built by Hermes Labs, mines corrections from agent conversations and surfaces relevant guidance when similar tasks come up.** In this example, a later code-review request could receive guidance about staying within the requested scope—drawn from your earlier corrections.\n\nYour conversation history becomes a source of context for new work.\n\nHermeneutic reads supported Claude Code, Codex, and OpenAI-format logs. It recognizes correction-shaped user turns and records the surrounding exchange when available:\n\n```\nyour request → agent response → your correction → repaired response\n```\n\nThe resulting local corpus preserves the episode around each correction. The `bucket` command lets you inspect recurring categories, including missed constraints, wrong targets, unnecessary confirmation, and scope expansion.\n\nRetrieval makes those records useful during another task. Using Ollama embeddings, Hermeneutic matches a new prompt against earlier prompts in the corpus. Relevant matches supply correction categories, which become a compact guidance preamble through category templates. Each advice bullet cites its supporting correction records.\n\nFor a release task, that might surface your prior guidance to cite command output when reporting completion. For a similar review task, it might surface guidance about respecting the requested scope.\n\nWith Python 3.10+ and Ollama available:\n\n```\npython -m pip install hermeneutic==0.1.12\n\nhermeneutic mine ~/.claude/projects \\\n  --format claude-code \\\n  --glob '**/*.jsonl' \\\n  --out ~/.hermeneutic/triples.jsonl\n\nhermeneutic bucket ~/.hermeneutic/triples.jsonl\n\nollama pull nomic-embed-text\nhermeneutic compile-index --triples ~/.hermeneutic/triples.jsonl\n\nhermeneutic compile 'Review this function and report your findings.'\n```\n\nWhen matching corrections meet the relevance threshold, the final command emits guidance for that prompt. Use it directly in your workflow, or install the optional Claude Code hook to supply retrieved guidance as prompt context:\n\n```\nhermeneutic install-compile-hook\n```\n\n**Start with the corrections you already made. [Try Hermeneutic on GitHub](https://github.com/hermes-labs-ai/hermeneutic), follow the [memory setup](https://github.com/hermes-labs-ai/hermeneutic#hermeneutic-memory), and star the repository to follow its development.**\n\nWhat correction do you keep repeating to your coding agent?\n\n*Built by [Hermes Labs](https://hermes-labs.ai). Prepared by our agent infrastructure from the project README and documentation.*", "url": "https://wpnews.pro/news/hermeneutic-turns-your-ai-corrections-into-context-for-the-next-task", "canonical_source": "https://dev.to/hermeslabsai/hermeneutic-turns-your-ai-corrections-into-context-for-the-next-task-2o8o", "published_at": "2026-09-27 05:33:58+00:00", "updated_at": "2026-09-27 06:00:45.951441+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "large-language-models", "ai-infrastructure"], "entities": ["Hermes Labs", "Hermeneutic", "Claude Code", "Codex", "OpenAI", "Ollama", "nomic-embed-text", "GitHub"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/hermeneutic-turns-your-ai-corrections-into-context-for-the-next-task", "markdown": "https://wpnews.pro/news/hermeneutic-turns-your-ai-corrections-into-context-for-the-next-task.md", "text": "https://wpnews.pro/news/hermeneutic-turns-your-ai-corrections-into-context-for-the-next-task.txt", "jsonld": "https://wpnews.pro/news/hermeneutic-turns-your-ai-corrections-into-context-for-the-next-task.jsonld"}}