Hapsland — realtime semantic agentic feedback

IMMEDIATE CODE REVIEW for coding agents

and make invalid states unrepresentable™

Catch questionable decisions while your coding agent is still working. Hapsland reviews changed types and functions against your rules and catches mistakes before they waste tokens and time. Stop context poisoning before it starts

Or install with Homebrew

brew install dearlordylord/tap/hapsland

Read this stage

Agent editDIFF

   title: string;
+  coverWidth: number;
   public: boolean;

The agent adds a field for the cover image’s width. The diff shows the new line and the lines around it.

FROM EDIT TO FEEDBACK

Review the decision before more code depends on it.

Your agent makes an edit
Hapsland selects eligible changed declarations using your file settings.
Your rules get code context
Related definitions enrich the diff. Jev classifies the supplied code against your questions.
Your agent gets feedback
Hapsland prepares a message from the result and your settings, so the agent can reconsider its approach.

FILE SETTINGS

Choose which files can enter the review.

Sending source to another service is a data-sharing decision. Retention after submission depends on the review service’s policy. Set includes, exclusions and privacy exclusions to choose which files can be used. Supporting files pass the same checks before reading; a project’s include cannot restore your exclusion.

{
  "version": 1,
  "includes": ["src/**"],
  "privacyExcludes": ["src/private/**"]
}

Selected definitions contain source code. With credentials and no file settings, all otherwise eligible files are selected. The current recipient is Jev; there is no per-request approval prompt. The integration is designed for other classifiers too.

Explore file settings ↗

RULES

Built-in questions. Room for your own.

Hapsland’s default rules ask about data and code design. Type rules examine what values a type permits. The built-in function rule asks whether a body uses structure its declaration does not reveal.

Can this type store the same fact twice, with copies that disagree?

Jev classifies code against the questions; Hapsland uses the result and your settings to choose the feedback message. Add local rules for your team's concerns. Choose their scope, thresholds and feedback messages. Rules run only when the supplied code meets their evidence needs. No feedback does not mean every check passed: a check may be skipped or fail to run.

See custom rules ↗

SETUP

Install and set up Hapsland.

Ready-made packages for macOS arm64 and Linux arm64. Runtime included; no source build required.

macOS arm64 · Linux arm64 · Archives and checksums

2. Set up your agent

Copy this instruction into your agent’s conversation. Setup previews hook changes and asks before applying them.

Install Hapsland for my coding agent using https://github.com/dearlordylord/hapsland/blob/master/docs/installation-workflows.md. Let me review and approve the setup changes interactively. Ask me to enter any Jev key in the masked setup prompt, not in chat.

Run setup manually after installing

Run setup in your Git repository

hapsland setup

Homebrew installs the runtime and commands. Setup previews changes to your agent hooks before applying them.

Choose Claude Code, Codex CLI, or both. Setup previews the hooks, asks before applying them, and requests your Jev key if needed. Restart the selected client and complete its trust prompts.

The integration applies to your client profile. File settings determine which repositories and files can be reviewed. Setup itself sends no review request.

Installation details and development builds ↗

3. Check a new edit

Restart the selected agent and complete its trust prompts. To inspect a review, enable local recording, make a new supported edit, then run:

hapsland dashboard

Recording is opt-in and contains source code and review messages. It does not backfill earlier edits. Opening the dashboard does not enable it.

Enable recording and inspect a review ↗