Installation

1. Requirements
2. Install
3. Where memory lives
4. Verify
5. Update
6. Uninstall

Requirements

Tool	Why
Claude Code	the host
Node.js 18+ (npm, npx)	Hindsight’s installer and the Context+ server
git	worktrees for parallel workers, global ignore for Context+’s cache
uv	Hindsight’s local daemon (not needed for self-hosted or cloud)
Ollama	Context+ embeddings. Without it, the structure tools still work but semantic search doesn’t

Install

git clone https://github.com/codicovibes/devstack.git
cd devstack
./install.sh

Run the installer from your own terminal. Claude Code refuses plugin installs from inside a session.

The installer runs six steps, all safe to re-run:

1. Hindsight. Runs npx @vectorize-io/hindsight-coding-agents install claude-code --server <mode>. This adds three hooks, an MCP entry and a companion skill.
2. Context+. Installs a pinned release into ~/.local/share/devstack/contextplus, deletes its bundled agent-instructions.md, and pulls nomic-embed-text and llama3.2 into Ollama.
3. The plugin. Adds this folder as a local marketplace (devstack-local) and installs devstack at user scope.
4. Overlap removal. Adds 11 deny rules to ~/.claude/settings.json and merges devstack’s keys into ~/.hindsight/coding-agent.json. Each file is backed up once as <file>.devstack-backup.
5. Git ignore. Adds .mcp_data/ (Context+’s embedding cache) to your global git excludes.
6. Duplicate check. Warns about a standalone contextplus server, a separate graph-engineering skill copy or an omo binary left from earlier installs.

Where memory lives

HINDSIGHT_SERVER	Runs	Needs
daemon (default)	a local hindsight-embed on 127.0.0.1:9077	uv. Fact extraction uses the first LLM key it finds, or else the Claude Code CLI
self-hosted	your own Hindsight server	HINDSIGHT_API_URL
cloud	Hindsight Cloud	HINDSIGHT_API_TOKEN

HINDSIGHT_SERVER=self-hosted HINDSIGHT_API_URL=http://localhost:8888 ./install.sh

Verify

Start a new Claude Code session and check:

• /mcp shows plugin:devstack:contextplus with 6 tools. If it shows 17, the deny rules didn’t load.
• /mcp shows hindsight connected.
• ulw <some small task> makes the agent load the ultrawork skill.

Update

Pull and run the installer again:

git pull && ./install.sh

Hindsight also updates itself once a day unless you set autoUpdate: false in ~/.hindsight/coding-agent.json.

Uninstall

./uninstall.sh                     # plugin, deny rules, devstack's Hindsight keys, Context+
./uninstall.sh --purge-hindsight   # also Hindsight's hooks and MCP entry

Your Hindsight memory banks, the .mcp_data/ line in your git excludes and any .mcp_data/ folders stay in place.