Skip to content

0.4.0 - 2026-10-22

Choose a tag to compare

@github-actions github-actions released this 21 Oct 20:29
a1bed64

Release Notes

One address is enough: itda setup looks at a page, or watches you use the
site in your own browser, names what agents will be able to do in plain words,
tries every read, and connects an agent. Any website, not only the ones with an
API description.

Added

  • itda setup <url> sets a site up in one go: it looks at the page, or
    opens your browser and records when the page refuses, needs a sign-in or
    is drawn by scripts; shows what agents will be able to do in plain words;
    tries every read once and keeps the ones that work; saves the site; and
    connects an agent. It asks before each step; --record/--no-record,
    --client and --yes answer for scripts. ITDA_LANG=ko (or a Korean
    LANG) makes it, and the drafted descriptions, speak Korean.
  • Drafted actions carry a description a person would say (List what Notices shows, 공지사항 목록 읽기), taken from the page's title or the
    call's name, in English or Korean.
  • itda record <url> opens your own browser in a fresh window and records
    what the pages ask the server for while you use the site, then drafts a
    definition the same way itda draft har does. The recording stays in
    memory; --save keeps it as a HAR file. itda never clicks, types or
    navigates in the window. ITDA_DEBUG_CDP=1 prints the browser messages.
  • itda record --install offers to keep the token and the browser session
    the recording signed in with, each after a yes in the terminal, so a site
    that sends a bearer token from its scripts works without pasting it.
  • A recorded GraphQL call becomes one action per operation (exploreProjects
    is explore-projects): queries are reads, mutations are changes, and the
    variables are the typed inputs, rendered through a json_template.
  • itda record and itda draft har also draft the pages the recording
    holds, as itda draft page does, so a site that renders its lists and
    forms on the server gets actions even when its pages call no API.
  • itda draft page <url>... drafts a site definition from the pages you
    use, fetched with the honest client: a table or a list of records becomes
    html fields, data a page embeds for its scripts becomes ssr_json, a
    search form becomes a read, a post form becomes a change with its token
    read through a preflight step, page links become a page input, and RSS or
    Atom feeds come along. Every read gets a response check, so itda check
    notices when a page changes. Lists are found by their shape, not only by
    known class names: any run of three or more siblings outside navigation
    that each hold a link at the same place, with the title and link read
    from that link's own path. When a page embeds its data for its scripts,
    the draft points extract_pointer at the list inside the payload and
    checks the keys every record shares.
  • itda draft har also handles a token sent as a header, such as
    X-CSRF-Token: a preflight step reads it from the page's
    <meta name="csrf-token"> tag before each call.
  • itda add also takes an https URL, or the name of a ready-made site
    (itda add github); the four definitions in sites/ are built in.

Changed

  • itda setup names the agent app it connects ("Adding itda to Claude
    Desktop..."), shows the settings file it wrote with ~ for your home
    folder, says so in Korean too, lines the action names up only as wide as
    they need, and writes its example request mid-sentence.
  • The README and the landing page open with a recording of itda setup as
    it ran on Hacker News (assets/setup.gif, Korean in assets/setup.ko.gif,
    rebuilt from assets/src/setup.*.tape with vhs).
  • A new key visual, a hand passing a website card to an agent
    (assets/handoff.png), on the README banners and the link preview
    (assets/hero.png, assets/hero.ko.png, assets/social.png, rendered from
    assets/src/banner.html), and the docs introduction says the same thing the
    README does.

Install itda-cli 0.4.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/brnyxx/itda-cli/releases/download/v0.4.0/itda-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/brnyxx/itda-cli/releases/download/v0.4.0/itda-cli-installer.ps1 | iex"

Download itda-cli 0.4.0

File Platform Checksum
itda-cli-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
itda-cli-x86_64-apple-darwin.tar.xz Intel macOS checksum
itda-cli-x86_64-pc-windows-msvc.zip x64 Windows checksum
itda-cli-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
itda-cli-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum