Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 14 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
<a href="go.mod"><img alt="Go version" src="https://img.shields.io/github/go-mod/go-version/DavidGodefroid/lockhttp?color=575146&logo=go&logoColor=white"></a>
</p>

<p align="center"><b>Let any AI agent use the web: reads of trusted hosts pass,<br>
<p align="center"><b>Let an AI agent running in lea use the web: reads of trusted hosts pass,<br>
anything that sends data or reaches an unknown host waits for you.</b></p>

<p align="center">
Expand All @@ -32,10 +32,17 @@ anything that sends data or reaches an unknown host waits for you.</b></p>

lockhttp is a Lock of the [Lock Family](https://github.com/DavidGodefroid/lockfamily),
harness security for AI agents. It is the proxy every outbound HTTP(S)
request of your agent goes through. Reads of hosts you trust pass; anything
else waits for **your** approval on
request of an agent running in [lea](https://github.com/DavidGodefroid/lea)
goes through. Reads of hosts you trust pass; anything else waits for
**your** approval on
[lockhub](https://github.com/DavidGodefroid/lockhub), where the agent cannot reach it.

> [!IMPORTANT]
> **The agent must run inside lea.** lockhttp guards only the containers lea
> starts with `LEA_LOCKHTTP=1`, whose only way out is lea's proxy. An agent
> you start directly on your machine (outside lea) does not go through the
> gate: lockhttp sees none of its requests and protects nothing there.

> [!NOTE]
> **0.x**: the policy format may still change between minor versions. Built on [lockkit](https://github.com/DavidGodefroid/lockkit) v0.14.1.
> Command names are fixed; flags may still move. Design decisions: [docs/decisions.md](docs/decisions.md).
Expand Down Expand Up @@ -113,9 +120,9 @@ commands and the setup by hand: [docs/install.md](docs/install.md).
4. Ask your agent to read the docs of a trusted site: it goes through. Ask
it to post somewhere: the request waits for your `y`.

lockhttp is a proxy, so it works with any agent and any HTTP client inside
lea's containers (lea runs Claude Code today). The contract with lea:
[docs/lea.md](docs/lea.md).
lockhttp is a proxy, so inside lea's containers it works with any agent and
any HTTP client (lea runs Claude Code today). Outside lea it is not on the
path at all. The contract with lea: [docs/lea.md](docs/lea.md).

## Highlights

Expand Down Expand Up @@ -234,7 +241,7 @@ The site, [lockhttp.com](https://lockhttp.com), is built from [`site/`](site/).
| [locksql](https://github.com/DavidGodefroid/locksql) | SQL databases: the agent queries, PII comes back masked; connections and writes wait for you. |
| [lockmq](https://github.com/DavidGodefroid/lockmq) | RabbitMQ: masked queue inspection; connections, peeks and unmasked reads wait for you. |
| [lockfile](https://github.com/DavidGodefroid/lockfile) | Files (S3, SFTP, disk): the agent asks yes/no questions about files it never reads. |
| [lockhttp](https://github.com/DavidGodefroid/lockhttp) | Outbound HTTP(S): reads of trusted hosts pass; anything that sends data or reaches an unknown host waits for you. |
| [lockhttp](https://github.com/DavidGodefroid/lockhttp) | Outbound HTTP(S) of agents in lea: reads of trusted hosts pass; anything that sends data or reaches an unknown host waits for you. |
| [locklog](https://github.com/DavidGodefroid/locklog) | Logs: masked, bounded log search; the agent reads the logs, not the people in them. |
| [lockssh](https://github.com/DavidGodefroid/lockssh) | Commands over SSH: allow-listed commands run at once, the rest waits for you; the key never leaves the console. |
| [lockhub](https://github.com/DavidGodefroid/lockhub) | The approval hub and its `lox` CLI: `lox run` approves outside the agent's harness and never sees values in clear. |
Expand Down
8 changes: 6 additions & 2 deletions docs/security-model.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# LockHTTP security model

LockHTTP puts every outbound HTTP(S) request of an AI agent through a gate
LockHTTP puts every outbound HTTP(S) request of an AI agent running in
[lea](https://github.com/DavidGodefroid/lea) through a gate
that decides it with a policy only a human loosens, and holds what needs a
human until that human answers in a console the agent cannot reach. This
document says what it protects, how, and where it stops. It describes
Expand Down Expand Up @@ -34,7 +35,10 @@ image, through the launcher.
dependency it runs), and hostile web content that steers it.
- **Out of scope:** a compromised host or console account, root, any
account that may run `docker` on the host (see
[Docker](#what-docker-does-and-does-not-separate)), Anthropic itself, an attacker on the network upstream of the proxy container.
[Docker](#what-docker-does-and-does-not-separate)), Anthropic itself, an attacker on the network upstream of the proxy container,
and any agent that does not run inside lea: an agent started directly on
the host never goes through the gate, so LockHTTP sees and protects none
of its requests.

## Boundaries

Expand Down
4 changes: 2 additions & 2 deletions site/faq/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -65,8 +65,8 @@ <h2 id="ready">Is lockhttp ready to use?</h2>
</section>
<section aria-labelledby="agents">
<h2 id="agents">Which AI agents does it work with?</h2>
<p>Any agent and any HTTP client: lockhttp is a proxy, not an agent plugin. It sees requests, whatever tool sent them.</p>
<p>The agent must run in <a href="https://github.com/DavidGodefroid/lea">lea</a>, which runs Claude Code in containers today.</p>
<p>Any agent and any HTTP client inside <a href="https://github.com/DavidGodefroid/lea">lea</a>: lockhttp is a proxy, not an agent plugin. It sees the requests of lea’s containers, whatever tool sent them.</p>
<p>The agent must run in lea, which runs Claude Code in containers today. An agent run directly on your machine, outside lea, does not go through lockhttp: the gate never sees its requests and does not protect it.</p>
</section>
<section aria-labelledby="lea">
<h2 id="lea">Do I need lea?</h2>
Expand Down
10 changes: 5 additions & 5 deletions site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>lockhttp: your agent browses, you hold the key</title>
<meta name="description" content="lockhttp is the proxy every outbound HTTP(S) request of an AI agent goes through: reads of trusted hosts pass, and anything that sends data or reaches an unknown host waits for your approval.">
<meta name="description" content="lockhttp is the proxy every outbound HTTP(S) request of an AI agent running in lea goes through: reads of trusted hosts pass, and anything that sends data or reaches an unknown host waits for your approval.">
<meta name="color-scheme" content="light dark">
<meta name="theme-color" content="#f4efe4" media="(prefers-color-scheme: light)">
<meta name="theme-color" content="#16140f" media="(prefers-color-scheme: dark)">
<link rel="canonical" href="https://lockhttp.com/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="lockhttp">
<meta property="og:title" content="lockhttp: your agent browses, you hold the key">
<meta property="og:description" content="lockhttp is the proxy every outbound HTTP(S) request of an AI agent goes through: reads of trusted hosts pass, and anything that sends data or reaches an unknown host waits for your approval.">
<meta property="og:description" content="lockhttp is the proxy every outbound HTTP(S) request of an AI agent running in lea goes through: reads of trusted hosts pass, and anything that sends data or reaches an unknown host waits for your approval.">
<meta property="og:url" content="https://lockhttp.com/">
<meta property="og:image" content="https://lockhttp.com/assets/og.png">
<meta property="og:image:type" content="image/png">
Expand All @@ -22,7 +22,7 @@
<meta property="og:locale" content="en_US">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="lockhttp: your agent browses, you hold the key">
<meta name="twitter:description" content="lockhttp is the proxy every outbound HTTP(S) request of an AI agent goes through: reads of trusted hosts pass, and anything that sends data or reaches an unknown host waits for your approval.">
<meta name="twitter:description" content="lockhttp is the proxy every outbound HTTP(S) request of an AI agent running in lea goes through: reads of trusted hosts pass, and anything that sends data or reaches an unknown host waits for your approval.">
<meta name="twitter:image" content="https://lockhttp.com/assets/og.png">
<meta name="twitter:image:alt" content="lockhttp: your agent browses, you hold the key.">
<link rel="icon" href="assets/logo.svg" type="image/svg+xml">
Expand Down Expand Up @@ -58,7 +58,7 @@
<div class="hero-text">
<p class="eyebrow"><span class="badge">v0.9</span>A Lock of the Lock&nbsp;Family · open&nbsp;source · Apache&nbsp;2.0</p>
<h1 id="hero-title">Your agent browses. <span class="key">You hold the key.</span></h1>
<p class="lead">Every outbound HTTP(S) request of your AI agent goes through lockhttp. Reads of trusted hosts pass; anything that sends data or reaches an unknown host waits for you.</p>
<p class="lead">Every outbound HTTP(S) request of your AI agent running in <a href="https://github.com/DavidGodefroid/lea">lea</a> goes through lockhttp. Reads of trusted hosts pass; anything that sends data or reaches an unknown host waits for you.</p>
<div class="install">
<div class="install-head"><span>Install with Homebrew</span></div>
<pre tabindex="0" aria-label="Install commands"><code><span class="cmd">brew trust davidgodefroid/tap</span>
Expand Down Expand Up @@ -161,7 +161,7 @@ <h2 id="highlights">Highlights</h2>

<section aria-labelledby="quick-start">
<h2 id="quick-start">Quick start</h2>
<p class="prose">lockhttp is a proxy, so it works with any agent and any HTTP client. It needs <a href="https://github.com/DavidGodefroid/lea">lea</a>, which runs agents (Claude Code) in containers whose only way out is its proxy.</p>
<p class="prose">lockhttp is a proxy, so it works with any agent and any HTTP client, as long as they run inside <a href="https://github.com/DavidGodefroid/lea">lea</a>, which runs agents (Claude Code) in containers whose only way out is its proxy. An agent started directly on your machine, outside lea, does not go through lockhttp, and lockhttp does not protect it.</p>
<ol class="steps prose">
<li><p>Install with Homebrew (the box above). Docker must be running.</p></li>
<li><p>In lea’s projects directory, <code>lox add lockhttp</code> asks for the lock’s name, writes the policy and starts its console.</p>
Expand Down
2 changes: 1 addition & 1 deletion site/security/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ <h2 id="scope">What it protects</h2>
<div class="prose">
<p><strong>Assets:</strong> the project’s and the host’s data, credentials, and actions taken online in your name.</p>
<p><strong>Attackers:</strong> the agent itself (prompt injection, drift) and hostile web content.</p>
<p><strong>Out of scope:</strong> a compromised host or console account, any account that may run <code>docker</code> on the host, the model provider itself (Anthropic), a network attacker upstream.</p>
<p><strong>Out of scope:</strong> a compromised host or console account, any account that may run <code>docker</code> on the host, the model provider itself (Anthropic), a network attacker upstream, and any agent not run inside lea: an agent started directly on the host never goes through the gate.</p>
</div>
</section>

Expand Down
Loading