Skip to main content

Get started in three steps

Bring decision-first governance to your team by connecting your codebase to your architectural constraints.

Step 1: Set up your workspace

  1. Head over to app.hopsule.com and create your account.
  2. Set up your Organization and create your first Project.
  1. In your project settings, connect your GitHub account.
  2. Select the repository you want to manage.
  3. Hopsule will automatically scan your codebase, chunk the files, and begin building your Project Brain (knowledge graph).
The initial import might take a few minutes depending on your repository size. Hopsule processes files in parallel for maximum speed.

Step 2: Connect your AI Assistant

To get real-time enforcement and context, connect Hopsule to your AI editor:
  1. Open Cursor.
  2. Install the hopsule extension to enable the MCP server integration.
  3. Authenticate using the secure device code flow.
Capsules bundle your decisions and memories into portable context packs.
  1. In Cursor, select your active Capsule from the Hopsule extension tree view.
  2. Click Load in AI to inject your project’s context pack directly into the editor.

Step 3: Start enforcing decisions

Now that Cursor has your Capsule, it understands your architectural history:
  1. Generate Code: Ask the AI to build a feature. It will strictly follow your ACCEPTED decisions.
  2. Real-time Warnings: If you write code that violates an architectural rule, the IDE will show an inline diagnostic warning you of the conflict.
  3. Understand the “Why”: The AI uses your project’s memories to explain the rationale behind every enforced constraint.

Next steps

Now that your environment is connected, explore how to build your organizational memory:

Manage Decisions

Learn the lifecycle of a decision from DRAFT to ACCEPTED.

Capture Memories

Document the “why” behind your choices so context never decays.

Explore the Brain

Visualize the relationships between decisions, tasks, and code.

Team Collaboration

Set up approval workflows and role-based access for your team.
Need help? Chat with Hopper directly in your project dashboard or check out our Architecture Guide.