v0.2.0

What's new in 0.2.0

telemaco install / telemaco uninstall

Wire Telemaco into the coding agents on your machine in one command: the MCP server, an instructions block in the agent's memory file, and a prompt hook that reminds the model to use Telemaco when a prompt looks web-bound.

Supported agents: Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, Google Antigravity, Codeium Windsurf, OpenCode, Roo Code / Cline, Pi Coding Agent, DeepSeek Harness, Qwen Code, Factory Droid, Poolside Agent, Kiro, Hermes Agent.

telemaco install                                     # interactive, detects installed agents
telemaco install --yes                               # non-interactive, accepts the defaults
telemaco install --folder ./my-project               # configure one project directory
telemaco install --target claude,cursor              # pick agents explicitly
telemaco install --dry-run                           # show what would change, write nothing
telemaco uninstall                                    # remove everything a global install added

Run interactively it asks before each part that changes how an agent already behaves: the prompt hook, whether the MCP server should tell the agent to reach the web through Telemaco, auto-approving Telemaco's tools, and refusing the agent's own web search. Every config file is backed up before the first rewrite; a config that does not parse is reported and left untouched.

One-line installer and Homebrew

curl -fsSL https://raw.githubusercontent.com/AlbertoBarrago/telemaco/main/install.sh | bash

install.sh installs the prebuilt binary for your platform (or builds from source if none is published yet), adds it to PATH, then offers to run telemaco install. Options: --prefix, --from-source, --yes, --uninstall.

macOS can now use Homebrew:

brew tap albertobarrago/telemaco
brew install telemaco          # render-enabled build
brew install telemaco-stealth  # stealth variant, coexists with the above

Bottles are published for Apple Silicon and Intel macOS.

MCP --agent-directives

telemaco mcp --agent-directives makes the server tell the agent, on connect, that Telemaco is how it should reach the web. telemaco install adds the flag when you accept it; a server you wire up by hand answers with plain capabilities and stays neutral.

Robustness

• Bound box-tree depth so a pathological deep DOM cannot overflow the thread stack and abort the whole serve process. A stack overflow is not a panic, so catch_unwind, the V8 watchdog and the process deadline all failed to contain it; the new budget (128 generated boxes) stays far above the ~60 levels real documents reach.
• Give frame realms the context state deno_core's callbacks expect, fixing a promise-rejection crash in iframes.

Site and tooling

• New landing page: agent grid, live badges, interactive terminal, animated benchmarks, contributors; Obscura credited as upstream.
• scripts/release.sh cuts a release in one step (bump, checks, tag, push).

Full changelog: v0.1.3...v0.2.0

v0.1.3

telemaco 0.1.3

update refuses to replace cargo build output. A symlink from
~/.local/bin into a checkout used to be followed all the way to
target/release, where the next cargo build silently reverts the
downloaded binary. A directory named target counts as build output only
when a Cargo.toml sits beside it, so an ordinary install into a
directory of that name still updates.

Following a symlink is now reported before anything is replaced.

This is also the first release that can be updated from: 0.1.2 was the
first to carry the update command, so 0.1.2 to 0.1.3 is the first
version-to-version upgrade the path has ever been able to make.

v0.1.2

telemaco 0.1.2

New:
- telemaco update, with --check and --force. It keeps the build variant
  you installed, replaces both binaries together, and verifies the
  download by running it before anything is swapped.
- An update hint on interactive runs only: never when stderr is not a
  terminal, so scripts, CI, and MCP clients see nothing. Off with
  TELEMACO_NO_UPDATE_CHECK=1.
- An acceptance gate under acceptance/: 41 stages against local
  fixtures, wired into CI to block a pull request that regresses one.
- install.sh, which installs the binaries and offers to register the MCP
  server with the agents it finds.

Fixed:
- telemaco mcp explains that it is waiting for JSON-RPC instead of
  looking like a hang.
- --dump links and --dump assets resolve relative URLs against the
  document base URL, so a page with <base href> reports the right
  targets.
- Docker images build on native runners per architecture: nine minutes
  instead of over an hour under emulation.

The getting-started guide is now in English, at GETTING-STARTED.md.

v0.1.1

telemaco 0.1.1

Adds the acceptance gate: 40 stages run against local fixtures, wired into
CI so a pull request that regresses one is blocked.

Fixes:
- --dump links and --dump assets resolve relative URLs against the
  document base URL, so a page with <base href> reports the right targets.
- Every crate manifest carries the Apache-2.0 license again.
- The CI comparison jobs stage telemaco-worker alongside telemaco, so the
  parallel scrape path is actually exercised.

Also ships install.sh, which installs the binary and offers to register it
as an MCP server with the agents it finds.

v0.1.0

telemaco 0.1.0

First tagged release. Headless browser engine in Rust: real JavaScript
through V8, a real DOM, its own layout and paint pipeline, and the Chrome
DevTools Protocol.

Ships four build variants per platform: with and without rendering, each
with and without the stealth transport.