agnt

Give your AI coding agent browser superpowers.

agnt is a new kind of tool designed for the age of AI-assisted development. It acts as a bridge between your AI coding agent and the browser, extending what's possible during vibe coding sessions.

What Does It Do?

When you're in the flow with Claude Code, Cursor, or other AI tools, agnt lets your agent:

See what you see - Screenshots, DOM inspection, visual debugging
Hear from you directly - Send messages from browser to agent
Sketch ideas together - Draw wireframes directly on your UI
Debug in real-time - Capture errors, network traffic, performance
Extend its thinking window - Structured data uses fewer tokens than descriptions

Installation

pip install agnt
# or
uv pip install agnt
# or
pipx install agnt

Quick Start

As MCP Server (Claude Code, Cursor, etc.)

Add to your MCP configuration:

{
  "mcpServers": {
    "agnt": {
      "command": "agnt",
      "args": ["mcp"]
    }
  }
}

Or with uvx:

{
  "mcpServers": {
    "agnt": {
      "command": "uvx",
      "args": ["agnt", "mcp"]
    }
  }
}

As PTY Wrapper

Wrap your AI coding tool with overlay features:

agnt run claude --dangerously-skip-permissions
agnt run cursor
agnt run aider

This adds a terminal overlay menu (Ctrl+P) and enables browser-to-terminal messaging.

Core Features

Browser Superpowers

Start a proxy and your agent gains eyes into the browser:

proxy {action: "start", id: "app", target_url: "http://localhost:3000"}

Now your agent can:

Take screenshots
Inspect any element
Audit accessibility
See what you clicked

Floating Indicator

Every proxied page gets a floating bug icon. Click to:

Send messages to your agent
Take area screenshots
Select elements to log
Open sketch mode

Sketch Mode

Draw directly on your UI:

Shapes: rectangles, circles, arrows, freehand
Wireframes: buttons, inputs, sticky notes
Save and send to agent instantly

Real-Time Error Capture

JavaScript errors automatically captured and available to your agent - no more forgetting to mention them.

MCP Tools

Tool	Description
`detect`	Auto-detect project type and scripts
`run`	Run scripts or commands
`proc`	Manage processes
`proxy`	Reverse proxy with instrumentation
`proxylog`	Query traffic logs
`currentpage`	View page sessions
`daemon`	Manage background service

Browser API

The proxy injects window.__devtool with 50+ diagnostic functions:

__devtool.screenshot('name')              // Capture screenshot
__devtool.inspect('#element')             // Full element analysis
__devtool.auditAccessibility()            // A11y audit
__devtool.sketch.open()                   // Enter sketch mode
__devtool.interactions.getLastClick()     // Last click details

Configuration

Create .agnt.kdl in your project:

scripts {
    dev {
        command "npm"
        args "run" "dev"
        autostart true
    }
}

proxies {
    frontend {
        target "http://localhost:3000"
        autostart true
    }
}

Documentation

License

MIT

Metadata

Release files for agnt 0.16.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agnt 0.16.0
File	Size	Uploaded
agnt-0.16.0.tar.gz	5.9 kB	Sep 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for agnt 0.16.0
File	Interpreter	ABI	Platform	Reset
agnt-0.16.0-py3-none-any.whl 5.9 kB Sep 29, 2026	Python 3	none	any	Details

Total release size: 11.7 kB

Release files / agnt-0.16.0.tar.gz

Download URL	agnt-0.16.0.tar.gz
Size	5.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`0c76b40b507dc47e9fef4d2faf5695535aee588f0c094bfe50790e934669ea0b`
BLAKE2b-256 checksum How to use checksums	`669555abebb9c98d436c9dab339a753a633a04d7fb810be42b92ebfed055f6ce`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/standardbeagle/agnt
Publishing commit: github.com/standardbeagle/agnt/tree/a296e7928778bf178be8546acac869c6d2a4372f

Workflow

Publishing configuration: github.com/standardbeagle/agnt/blob/a296e7928778bf178be8546acac869c6d2a4372f/.github/workflows/release.yml
Publishing logs: github.com/standardbeagle/agnt/actions/runs/36506559727/attempts/1

Artifact

Subject: agnt-0.16.0.tar.gz
SHA-256 checksum: 0c76b40b507dc47e9fef4d2faf5695535aee588f0c094bfe50790e934669ea0b Verifying attestations

Release files / agnt-0.16.0-py3-none-any.whl

Download URL	agnt-0.16.0-py3-none-any.whl
Size	5.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ef046cd5783e64e9b88e56c62fc2ff682607b47862b2c3372cb16107f9b631c3`
BLAKE2b-256 checksum How to use checksums	`60658e9afe9b7c768734249fd16c95ac10ff28340e6cc4a26dc152667704eccd`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/standardbeagle/agnt
Publishing commit: github.com/standardbeagle/agnt/tree/a296e7928778bf178be8546acac869c6d2a4372f

Workflow

Publishing configuration: github.com/standardbeagle/agnt/blob/a296e7928778bf178be8546acac869c6d2a4372f/.github/workflows/release.yml
Publishing logs: github.com/standardbeagle/agnt/actions/runs/36506559727/attempts/1

Artifact

Subject: agnt-0.16.0-py3-none-any.whl
SHA-256 checksum: ef046cd5783e64e9b88e56c62fc2ff682607b47862b2c3372cb16107f9b631c3 Verifying attestations