Skip to content

v0.2.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Sep 21:43
· 10 commits to main since this release
v0.2.0
963122b

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

Assets 22
Loading