llms.txt
+47
+ - They want their coding agent to run website feedback end to end: set up the project for a repository, invite the client, wait for their feedback and fix it, with people leaving feedback, approving the agent’s access, answering its questions, reviewing its fixes and paying.+ ## Run it from your agent+ Install the extension and connect Claude Code or Codex, and almost everything else can happen from your terminal. A few steps stay with people, on purpose.+ - Set up the project: Ask for a project for this repository. The agent reads the git remote and the dev server’s port and, once you agree, creates the project with its URL rules.+ - Invite the client: It emails the client an invitation, or makes a reporter link for you to share. Every invitation it sends shows up in your notifications, where you can revoke it.+ - Wait for their feedback: Tell it to keep going. It waits for new items, answers to its questions and reopened fixes, and picks each one up within seconds.+ - Fix it and report back: It claims the item, changes the code, asks if something is unclear, and submits what it changed and how it checked it.+ What still needs a person:+ - Leaving the feedback: you or your client, in the browser with the extension+ - Approving the agent’s access, and ticking the permissions to manage projects and invite people+ - Answering its questions, and accepting or reopening each fix+ - Choosing and paying for a plan+ Setting up projects and inviting people need an agent signed in with OAuth; a personal access token works through feedback only. An agent you connected earlier is not offered these permissions: revoke it under Integrations → Connected apps and connect it again. Details: https://tweakthis.io/docs/mcp#almost-everything-from-the-agent+ - Projects and invitations from your agent: Claude Code or Codex can wait for the client’s feedback to arrive and, connected with OAuth and the permissions you tick, also set up a project for the repository and invite the client. You approve its access and pay for the plan; you or the client answer its questions and review its fixes.+ ## Let your agent set it up+ Ask your coding agent to set up TweakThis for the repository you are in. Claude Code adds the server with this command:+ ```sh+ claude mcp add --transport http --client-id a8ded99a-8371-4488-8b63-ffa170c933a9 --callback-port 38501 tweakthis https://tweakthis.io/mcp+ ```+ Codex adds the block from the [Codex guide](https://tweakthis.io/guides/codex) to its configuration.+ There is no account to create from the agent: three steps stay with you, in your browser.+ 1. **Sign up or sign in.** Signing the agent in (`/mcp` → **tweakthis** → **Authenticate** in Claude Code, `codex mcp login tweakthis` in Codex) opens TweakThis, where the page names the agent asking. New here: your name and email. Have an account: sign in from the link under the form, or enter the same email.+ 2. **Enter the emailed code.** Six digits, or open the link in the same email in the same browser.+ 3. **Approve access.** Choose the workspace and what the agent may do. To let it set up the project and invite your client, also tick *Manage projects* and *Invite people*. Your browser then returns to the agent.+ After that the agent does the rest from the terminal:+ - `create_project`: it reads the git remote and the dev server’s port, tells you what it will create, and creates the project once you agree.+ - `manage_environments` and `manage_url_rules`: the localhost address of your dev server is added with the project; a staging or preview address you name becomes another environment.+ - `invite_reporter`: it emails an invitation to a client address you typed, or makes a reporter link with `create_reporter_link`.+ - Then it waits for your client’s feedback and fixes it.+ Installing the browser extension stays with you, and with each client you invite: the agent gives you the link.+ ## On a remote machine+ Signing in ends with your browser sent to a local address where the agent waits for it: port 38501 for Claude Code, port 38502 for Codex. When the agent runs on a server or over SSH and your browser on your own computer, that address is your computer, and the browser shows a connection error. Before you sign in, choose one of these:+ - **Paste the address back.** Claude Code (2.1.63 or later): approve access, then copy the full address from the browser’s address bar, starting `http://localhost:38501/callback?code=`, into the prompt Claude Code shows. From a terminal, `claude mcp login tweakthis --no-browser` prints the sign-in link and waits for that address; it needs an interactive terminal, so connect with `ssh -t`. Codex (0.156 or later): `codex mcp login tweakthis --no-browser` prints the link; approve access, then paste+ - **Forward the port.** The callback port is fixed, so an SSH tunnel carries the browser’s redirect to the agent: connect with `ssh -L 38501:localhost:38501 you@host` for Claude Code or `ssh -L 38502:localhost:38502 you@host` for Codex, then sign in as usual.+ - **Use a personal access token.** Create one under Integrations → Access tokens and add the server with it, with no browser involved:+ ```sh+ claude mcp add --transport http tweakthis https://tweakthis.io/mcp --header "Authorization: Bearer <token>"+ ```+ For Codex, put the token in the `TWEAKTHIS_TOKEN` environment variable and configure:+ ```toml