Hopsule

Your team's decisions, enforced where you code.

Hopsule brings decision-first memory to your IDE. Browse your project's decisions, memories, and tasks — and get real-time warnings when your code contradicts an accepted decision.

Stop forgetting what you already decided. Hopsule remembers for you.

Why Hopsule?

Every team makes architectural decisions — but they get buried in Slack threads, PRs, and meeting notes. Months later, someone unknowingly reverses a decision that was carefully made.

Hopsule fixes this by:

• Capturing decisions as first-class, versioned entities
• Surfacing them in your IDE right where you write code
• Warning you in real-time when code contradicts an accepted decision
• Preserving context so future-you (or your teammates) understand why

Features

Sidebar Panel

A dedicated sidebar with organized views:

• Dashboard — Quick overview of your project's status
• Decisions — Browse all decisions (draft, pending, accepted, deprecated)
• Memories — Access persistent context and reasoning behind past choices
• Tasks — Track work items tied to your project
• Context & MCP — Manage context packs and MCP server integration

Decision Enforcement

When you save a file, Hopsule checks it against your project's accepted decisions:

• Violations appear as diagnostic warnings in the editor
• Hover to see which decision is being contradicted
• All warnings show up in VS Code's Problems panel

Enforcement is framed as remembrance, not control: "You already decided this. This contradicts that decision."

Create & Manage

Create new decisions, memories, and tasks directly from the sidebar — no need to switch to the browser.

MCP Server Integration

Hopsule includes an MCP (Model Context Protocol) server, so AI assistants like Cursor and Copilot can access your project's decisions and memories as context.

Device Authentication

Secure login via browser-based device flow. No passwords stored in your editor.

Quick Start

1. Install the extension from the marketplace
2. Sign in — Run Hopsule: Login from the Command Palette or click "Sign in" in the sidebar
3. Open your project — The extension auto-detects projects with a .hopsule configuration file
4. Browse your decisions — Expand the Hopsule sidebar to see decisions, memories, and tasks
5. Code with confidence — Enforcement warnings will appear automatically when you save

If your project doesn't have a .hopsule file yet, run hopsule init using the Hopsule CLI.

Commands

All commands are available via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

You can also right-click any file in the editor or explorer to check it against decisions.

Configuration

Configure via VS Code settings (Ctrl+, / Cmd+,) — search for "Hopsule":

For self-hosted deployments, update hopsule.apiUrl and hopsule.webUrl to point to your instance.

How It Works

Hopsule connects to the central decision-api service — the single source of truth for your project's decisions and memories.

The extension:

• Fetches accepted decisions from the API
• Monitors your code for contradictions on save
• Surfaces warnings as IDE diagnostics
• Syncs new decisions and memories you create back to the API

The extension never makes decisions on its own. All authority lives in the decision-api. The IDE is a constraint and reminder surface — it reflects what your team has decided, not what it thinks you should do.

Requirements

• VS Code 1.80.0 or later (also works with Cursor, Windsurf, and other VS Code forks)
• A Hopsule account — Sign up at hopsule.com
• A project initialized with hopsule init (creates a .hopsule config file)

Links

• Hopsule Web App
• CLI Tool
• MCP Server
• API Documentation

License

MIT — see LICENSE for details.