hindsight-copilot

Long-term memory for GitHub Copilot in VS Code, powered by Hindsight.

hindsight-copilot init wires the Hindsight MCP server into VS Code's .vscode/mcp.json and adds a recall/retain rule to .github/copilot-instructions.md. Copilot's agent mode then has recall / retain / reflect tools and — guided by the rule — recalls relevant memory at the start of a task and retains durable facts as it works.

How it works

VS Code Copilot supports two things this integration uses:

  • MCP servers in .vscode/mcp.json (agent mode), including HTTP servers with headers — so the Hindsight MCP endpoint connects directly:

    {
  "servers": {
    "hindsight": {
      "type": "http",
      "url": "https://api.hindsight.vectorize.io/mcp/my-project/",
      "headers": { "Authorization": "Bearer hsk_..." }
    }
  }
}

  • .github/copilot-instructions.md, which Copilot applies to every chat in the workspace — that's where the recall/retain rule lives.

Install

pip install hindsight-copilot
cd your-project
hindsight-copilot init --api-token YOUR_HINDSIGHT_API_KEY --bank-id my-project

init merges the servers entry into ./.vscode/mcp.json and writes the rule into ./.github/copilot-instructions.md. Reload VS Code, open Copilot Chat in agent mode, and start the hindsight MCP server from the chat's tools menu.

Use a Hindsight Cloud key, or a self-hosted server with --api-url http://localhost:8888 (no token needed for an open local server). If mcp.json has comments, init prints the snippet to paste instead of touching the file — or run hindsight-copilot init --print-only anytime.

Commands

Command Description
hindsight-copilot init Add the MCP server + recall/retain rule
hindsight-copilot status Show whether the server + rule are configured
hindsight-copilot uninstall Remove the server + rule

Configuration

Setting Env var Default
API URL HINDSIGHT_API_URL https://api.hindsight.vectorize.io
API token HINDSIGHT_API_TOKEN (none; required for Cloud)
Bank id HINDSIGHT_COPILOT_BANK_ID copilot

Development

uv sync
uv run pytest tests -v -m 'not requires_real_llm'   # deterministic suite
uv run pytest tests -v -m requires_real_llm          # gated MCP-endpoint check

License

MIT

Project links

Data verified by PyPI on Aug 11, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for vectorize-io from gravatar.com vectorize-io

Credits

Author: Vectorize

GitHub Statistics

Data verified by PyPI on Aug 11, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Tags

agents ai copilot github-copilot hindsight mcp memory vscode

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hindsight_copilot-0.1.0.tar.gz (19.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hindsight_copilot-0.1.0-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file hindsight_copilot-0.1.0.tar.gz.

File metadata

  • Download URL: hindsight_copilot-0.1.0.tar.gz
  • Upload date:
  • Size: 19.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hindsight_copilot-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f3708c1193390e3753eacd96378d0bc2ddda71b522b79c2975b463609a125bed
MD5 f55832d6bf542665d0eea5eabccaa4dd
BLAKE2b-256 04bec2606a4feb4aed485da52be1070ce47b4fb46551718756e519bedf69f326

See more details on using hashes here.

Provenance

The following attestation bundles were made for hindsight_copilot-0.1.0.tar.gz:

Publisher: release-integration.yml on vectorize-io/hindsight

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file hindsight_copilot-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for hindsight_copilot-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a66aa22086da1a931c826cba5fed409c969e9602bdcec9bd56d2efd1aa199898
MD5 7738a243b44d82f9641a7614b6f1eed7
BLAKE2b-256 921401f69d5571b20b822c4bbbf6c4b8ea7215542b4acdf5f40de88620ca5139

See more details on using hashes here.

Provenance

The following attestation bundles were made for hindsight_copilot-0.1.0-py3-none-any.whl:

Publisher: release-integration.yml on vectorize-io/hindsight

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page