lwis docs

Start / 201 · Pair your agent

201 · Pair your agent

Ten minutes. At the end, you capture on your phone or in your browser, pick your agent's session, and the capture lands on its next prompt. There's nothing to paste.

You need a Linux x86_64 machine where your agent runs, either your laptop or a remote server you reach over SSH. The agent can be Claude Code, Codex, opencode or another MCP agent. You also need an Android phone or a browser.

1. Install lwis where the agent runs

On that machine (in your SSH session for a remote server):

curl -fsSL https://lookwhatisee.xyz/install.sh | sh   # checks the signature and the release key in DNS
lwis setup claude                                      # the Claude Code plugin, for every project
lwis install-service --enable                          # keep the daemon running across logins

For Codex, opencode or another MCP agent, skip lwis setup claude. Add lwis as an MCP server instead, for example in ~/.codex/config.toml:

[mcp_servers.lwis]
command = "lwis"
args = ["mcp", "--agent", "codex"]
env = { LWIS_ATTACH = "1" }

Details: Install lwis on your machine, Codex, opencode and MCP agents. On a server, in a root shell or in a container, see Remote machines and containers.

2. Pair your phone or browser

Check that both screens show the same 6-digit code, then answer y in the terminal. If lwis pair isn't running in a terminal (for example, your agent runs it), confirm with lwis devices confirm <code> once you've compared the codes yourself.

The first pairing does a one-time proof of work, from a few seconds to a few minutes. The link works once and expires after 10 minutes.

Never paste a pairing link into a chat, an issue or a log. It's a one-time secret for your own device.

3. Attach the session

No session is reachable until you attach it.

4. Send a capture

  1. Open lwis on your phone and tap Camera (or Choose an image).
  2. Circle what you mean, then tap Continue on the preview.
  3. Pick an intent such as "Fix this", or add a note, and choose your session: it's listed under the machine's label.
  4. The capture reaches the session on your next prompt, and a desktop notification tells you it's there.

Captures from the hosted web app at /capture/ wait for lwis accept <cid> by default, because its code comes from the server on every visit. See trust levels.

5. Check that it works

lwis doctor      # the daemon, pairings, and how captures reach each session
lwis sessions    # sessions lwis knows about, attached or not
lwis log         # every delivery

Next