Open Source • MIT License • Local First

The shadow of you.

Shadow Link learns how you react to AI coding agents, retrieves relevant past responses, and predicts what you are likely to say next.

SQLiteLocal Corpus
MCPServer Native
100%Runs On-Device
// process

How it works

A closed loop between your behavior and the agent — observed, weighted, and reflected back.

01
Learn

Capture situation → reply pairs from your real AI conversations.

Every exchange with your coding agent becomes a structured memory of context and your authentic response.

corpus.ingest
02
Match

Find related reactions using lexical memory, optional embeddings, and time-decayed weights.

Relevance is scored across language, semantics, and recency so the freshest, closest moments surface first.

memory.retrieve
03
Predict

Surface an editable ghost reply shaped by how you actually communicate.

A draft in your own voice appears inline — accept it, edit it, or reject it. Every choice trains the mirror.

ghost.suggest
// capabilities

Built like an instrument.

Terminal-native components engineered for memory, reflection, and reinforcement.

01

Local memory graph

A connected store of situations, reactions, and outcomes — queried entirely on your machine.

02

Claude Code live-session mirror

Observes your active coding session in real time and reflects your patterns back as they happen.

03

Editable ghost replies

Drafts in your voice you can accept, rewrite, or dismiss inline.

04

Feedback & reinforcement loop

Every accept or edit reweights the corpus toward how you really respond.

05

Temporal memory decay

Recent reactions carry more weight; stale habits gracefully fade.

06

MCP server integration

Exposes memory and prediction as Model Context Protocol tools any compatible agent can call.

07

Optional Claude Code proxy

Route sessions through a local proxy to capture richer context — bound to localhost by design.

08

Local LLM & embedding support

Plug in on-device models for inference and embeddings — nothing leaves your hardware.

// the interface

Your workflow.
Your memory.
Your voice.

A terminal-native TUI that lives where you already work — no browser, no tab, no telemetry leaving the box.

  • Animated command palette in pure green-on-black
  • Live telemetry: corpus size, latency, decay window
  • Session picker across every captured conversation
  • Ghost-confidence meter before you accept a reply
▸ install from source
$ git clone https://github.com/ThatReid23/Shadow-Link-v3.git
$ cd Shadow-Link-v3
$ python -m venv .venv
$ .\.venv\Scripts\Activate.ps1
$ pip install -e .
$ shadow-link daemon
$ shadow-link ui
// get started

Install in
under a minute.

Clone the repository, create a virtual environment, install the package, then launch the daemon and the terminal UI. No accounts, no cloud setup.

View full documentation →
// trust model

Local by default.

Your reaction corpus stays in a local SQLite database. Embeddings and chat inference remain local unless you explicitly configure remote endpoints.

Proxy mode uses mitmproxy to observe sessions and should remain bound to localhost. Nothing is exposed to the network unless you deliberately change that.
Shadow Link symbol

Build an AI that remembers you.