{"id":51465105,"url":"https://github.com/dundas/thinkrun","last_synced_at":"2026-07-06T10:01:14.608Z","repository":{"id":346269814,"uuid":"1180764331","full_name":"dundas/thinkrun","owner":"dundas","description":"ThinkRun — screen recorder for AI coding agents. Record a bug or session once and hand Claude Code or Cursor structured context it can act on. Real Chrome, your sessions. MCP + CLI.","archived":false,"fork":false,"pushed_at":"2026-06-13T18:17:02.000Z","size":3187,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-13T20:15:35.384Z","etag":null,"topics":["ai-agent","ai-coding-agent","ai-screen-recorder","ai-testing","browser-automation","bug-reporting","chrome-extension","claude-code","cursor","mcp","mcp-server","real-browser-mcp","screen-recorder","screen-recording"],"latest_commit_sha":null,"homepage":"https://thinkrun.ai","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dundas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-13T11:39:49.000Z","updated_at":"2026-06-13T18:17:04.000Z","dependencies_parsed_at":"2026-03-24T00:03:05.714Z","dependency_job_id":null,"html_url":"https://github.com/dundas/thinkrun","commit_stats":null,"previous_names":["dundas/thinkbrowse","dundas/thinkrun"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/dundas/thinkrun","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dundas%2Fthinkrun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dundas%2Fthinkrun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dundas%2Fthinkrun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dundas%2Fthinkrun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dundas","download_url":"https://codeload.github.com/dundas/thinkrun/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dundas%2Fthinkrun/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35185688,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","ai-coding-agent","ai-screen-recorder","ai-testing","browser-automation","bug-reporting","chrome-extension","claude-code","cursor","mcp","mcp-server","real-browser-mcp","screen-recorder","screen-recording"],"created_at":"2026-07-06T10:01:13.894Z","updated_at":"2026-07-06T10:01:14.596Z","avatar_url":"https://github.com/dundas.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# ThinkRun — Screen Recorder for AI Coding Agents\n\nStop screenshotting bugs and typing paragraphs to explain them. ThinkRun records any browser session — or lets your agent record what it built — and turns it into **structured context your AI coding agent can act on**: every click, the console, network requests, your voice narration, and screenshots, all time-synced. Not just a screenshot. Not just a video.\n\nWorks with **Claude Code**, **Cursor**, **Cline**, **Windsurf**, and any MCP client.\n\n## Install\n\n```bash\nnpx @thinkrun/mcp\n```\n\nOr install the CLI globally:\n\n```bash\nnpm install -g @thinkrun/cli\n```\n\nThe CLI automatically installs the native host binary, which lets AI tools control Chrome.\n\n## Add to your MCP config\n\n```json\n{\n  \"mcpServers\": {\n    \"thinkrun\": {\n      \"command\": \"npx\",\n      \"args\": [\"@thinkrun/mcp\"]\n    }\n  }\n}\n```\n\nConfig location:\n- **Claude Code**: `~/.claude/settings.json`\n- **Cursor**: `.cursor/mcp.json`\n- **Cline**: VS Code settings → Cline MCP Servers\n\nThen ask your agent: *\"navigate to localhost:3000 and screenshot the checkout page\"* — or record the bug yourself and hand the agent the result.\n\n## Why ThinkRun\n\nOther tools give your agent eyes. ThinkRun gives it **structured sight** — context it can parse in one pass instead of you re-explaining the page.\n\n| | ThinkRun | Playwright MCP |\n|---|---|---|\n| Records a session into structured, replayable context | ✅ | ❌ drive-only |\n| Turns a recording into an AI-ready report (clicks, console, network) | ✅ | ❌ |\n| Shareable link, also as LLM-ready Markdown / JSON | ✅ | ❌ |\n| Uses your real Chrome — your cookies \u0026 sessions | ✅ | ❌ headless only |\n| Runs alongside your browser, no profile conflict | ✅ | ❌ fights for Chrome profile |\n\n## Agent skills\n\nSkills for Claude Code, Cursor, Codex, and Gemini CLI are in `.claude/skills/`, `.cursor/skills/`, `.codex/skills/`, and `.gemini/skills/`.\n\n## Manual binary install\n\nIf you need to install the native host without the CLI, download the binary for your platform from the [latest release](https://github.com/dundas/thinkrun/releases/latest) and run:\n\n```bash\nchmod +x thinkbrowse-host-* \u0026\u0026 ./thinkbrowse-host-* --install\n```\n\n\u003e The native host binary keeps the `thinkbrowse-host` filename for now — it's the same signed binary, unchanged by the rename.\n\n## FAQ\n\n### How do I give Claude Code (or Cursor) access to my browser?\nAdd ThinkRun as an MCP server — `npx @thinkrun/mcp` — and your agent can drive and read a real Chrome session, your cookies and logins included. See \"Add to your MCP config\" above.\n\n### How do I show Cursor a UI bug instead of pasting a screenshot?\nRecord the bug with ThinkRun. Instead of a flat image, your agent gets a structured artifact — the steps you took, the console errors, the failing network requests, and the DOM state at the moment it broke — so it fixes the actual problem instead of guessing from a picture.\n\n### Is there an MCP server that uses my real Chrome cookies and sessions?\nYes. ThinkRun runs against your real Chrome via a native host, so authenticated pages just work — no headless re-login, no separate profile, no fighting your browser for the Chrome profile.\n\n### How do I record a browser session for an AI coding agent?\nRun `npx @thinkrun/mcp` (or `npm i -g @thinkrun/cli`) and record any session — or let the agent record what it built. ThinkRun turns it into an AI-ready report (clicks, console, network, narration, screenshots, all time-synced), available as a shareable link and as LLM-ready Markdown/JSON.\n\n### How do I give my AI coding agent context about what went wrong?\nHand it a ThinkRun recording. The structured \"what happened\" — actions, first bad signal, expected vs actual, and the element state — is exactly the context an agent needs to land a fix on the first try.\n\n## More\n\n- [thinkrun.ai](https://thinkrun.ai)\n- [Privacy Policy](https://thinkrun.ai/privacy)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdundas%2Fthinkrun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdundas%2Fthinkrun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdundas%2Fthinkrun/lists"}