Cline
⚠️ Superseded by the Coding Agents plugin
The Cline integration is superseded by the Coding Agents plugin — one package covering Claude Code, Codex, opencode, Kilo, Cursor, Copilot, Grok, Antigravity, Devin and Cline and other CLI agents, with a per-repo memory bank they all share instead of one bank per agent.
This page and the published package still work; they are no longer developed. To switch:
cd /path/to/your/repo
npx @vectorize-io/hindsight-coding-agents install cline-cliMemory does not move automatically — the banks are scoped differently and this agent's history cannot be imported (it is kept in an internal database). See Migrating from the per-agent plugins. View Changelog →
Persistent memory for Cline using Hindsight — without MCP. Cline's lifecycle hooks run small scripts that automatically recall relevant context before each task and retain what happened when a task ends. Because it runs on hooks, memory is deterministic — it doesn't depend on the model deciding to call a tool.
Quick Start
💡 Recommended: Hindsight Cloud
Sign up free for a Hindsight Cloud API key — no self-hosting required. Install the CLI, then run the installer from your project directory with your Hindsight URL and key:
pip install hindsight-cline
hindsight-cline install \
--api-url https://api.hindsight.vectorize.io --api-token YOUR_KEYUse hindsight-cline install --global to install for all projects, or hindsight-cline uninstall to remove it.
Then enable hooks in Cline: Settings → Features → Hooks.
📝 Platform
Cline hooks run on macOS and Linux only (no Windows) and require Python 3.
How It Works
| Cline hook | What Hindsight does |
|---|---|
TaskStart |
Recall context for the new task and inject it. |
UserPromptSubmit |
Recall memories for your message; record the prompt for later retain. |
TaskComplete |
Retain the task's transcript and summary. |
TaskCancel |
Retain the partial transcript of a cancelled task. |
Recalled memories are injected as a <hindsight_memories> context block. Cline doesn't hand hooks a transcript, so the integration accumulates each task's prompts locally and retains them at task end. Memories land in a single bank (cline by default).
Configuration
Defaults live in the installed settings.json; put personal overrides in ~/.hindsight/cline.json (stable across reinstalls), or use HINDSIGHT_* environment variables. Common keys: hindsightApiUrl, hindsightApiToken, bankId, autoRecall, autoRetain, recallBudget, dynamicBankId, debug.
Self-Hosting
pip install hindsight-all
export HINDSIGHT_API_LLM_API_KEY=your-openai-key
hindsight-api # http://localhost:8888Point the installer at it: --api-url http://localhost:8888.
See the integration source for full details.